# Importar Planilha Contas a Pagar

#### **Pré requisitos**

- Habilitar a L.U. Importação planilha contas a pagar (Funcionalidade REVOPs)
- Cliente estar com versão atualizada (Recurso disponibilizado versão 21.0)
- <span style="color: rgb(68, 68, 68); background-color: rgb(255, 255, 255);">Microsoft Excel ou WPS Office instalado</span>

#### **Funcionamento**

- <span style="color: rgb(0, 0, 0); white-space: pre-wrap;">Acessos no ERPx e ERP em Financas &gt; </span>**"Importar planilha de contas a pagar"** <span style="white-space: pre-wrap;"> com objetivo de automatizar a criação de títulos a pagar a partir de planilha.</span>

<span style="color: rgb(224, 62, 45);">Atualmente a funcionalidade importa SOMENTE contas a pagar para COLABORADORES! (Estava para sair em versão a opção para gerar CP para CliForEmp)</span>

<span style="white-space: pre-wrap;">O Assistente é uma nova operação acessível em </span>**Finanças &gt; Operações &gt; Importar planilha de contas a pagar**<span style="white-space: pre-wrap;">. Ele permite a importação de títulos a pagar a partir de arquivos nos formatos </span>**.xls**<span style="white-space: pre-wrap;">, </span>**.xlsx**<span style="white-space: pre-wrap;"> ou </span>**.csv**, oferecendo configurações flexíveis para mapeamento de colunas e definição de parâmetros padrão.

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/ITpk9j1GmVMCtH4a-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2025-11/ITpk9j1GmVMCtH4a-image.png)

##### Funcionamento do Assistente

**A tela do assistente é dividida em duas abas principais, que guiam o processo de importação:**

##### <span style="white-space: pre-wrap;">1. Aba </span>**Parâmetros**

<span style="white-space: pre-wrap;">Nesta primeira etapa, o usuário define o </span>**arquivo de origem**<span style="white-space: pre-wrap;"> e </span>**mapeia**<span style="white-space: pre-wrap;"> as colunas-chave da planilha, além de configurar os </span>**valores padrão**<span style="white-space: pre-wrap;"> para os títulos a serem gerados.</span>

- **Configurações do Arquivo e Colunas:**
    - **Caminho do arquivo:**<span style="white-space: pre-wrap;"> Define o local do arquivo (</span>`<span class="editor-theme-code">.xls</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">.xlsx</span>`<span style="white-space: pre-wrap;">, ou </span>`<span class="editor-theme-code">.csv</span>`) a ser importado.
    - **Nomes das colunas:**<span style="white-space: pre-wrap;"> O usuário deve informar os nomes exatos das colunas no arquivo que representam:</span>
        - **CNPJ da filial**<span style="white-space: pre-wrap;"> (Exemplo: </span>`<span class="editor-theme-code">cp_cgce_emp</span>`)
        - **CPF/CNPJ do colaborador**<span style="white-space: pre-wrap;"> (Exemplo: </span>`<span class="editor-theme-code">documento_cpf</span>`)
        - **Valor líquido**<span style="white-space: pre-wrap;"> (Exemplo: </span>`<span class="editor-theme-code">cp_valor</span>`)
    - **Outros campos:**<span style="white-space: pre-wrap;"> Os demais campos da aba definem os </span>**valores padrão**<span style="white-space: pre-wrap;"> que serão aplicados a </span>**todos**<span style="white-space: pre-wrap;"> os títulos importados (ex: Transação, Título, Forma de Pagamento, etc.).</span>
- **Gravação de Configuração:**
    - <span style="white-space: pre-wrap;">O sistema grava a </span>**última configuração**<span style="white-space: pre-wrap;"> utilizada por usuário para </span>**todos os campos**<span style="white-space: pre-wrap;">, </span>  
        <span style="white-space: pre-wrap;">exceto: </span>**Caminho**<span style="white-space: pre-wrap;">, </span>**Data emissão**<span style="white-space: pre-wrap;"> e </span>**Vencimento**.
- **Validação:**
    - <span style="white-space: pre-wrap;">Ao clicar em </span>**"Próximo &gt;&gt;"**, o sistema executa a validação dos dados:
        - <span style="white-space: pre-wrap;">Verifica se todos os campos </span>**obrigatórios**<span style="white-space: pre-wrap;"> (\*) foram preenchidos.</span>
        - Valida se os valores informados são válidos (ex: se o método de pagamento selecionado realmente existe no sistema).  
              
            [![2x.png](https://kb.emasistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/zS4GaKnvZEii7JRM-2x.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/zS4GaKnvZEii7JRM-2x.png)
        
        ##### <span style="white-space: pre-wrap;">2. Aba </span>**Registros**
        
        Após a validação, o sistema exibe os dados extraídos do arquivo para conferência e permite o tratamento de eventuais pendências.
        - **Exibição dos Registros:**<span style="white-space: pre-wrap;"> O sistema carrega e exibe todos os registros encontrados no arquivo.</span>
        - **Identificação de Registros Inválidos:**
            - <span style="white-space: pre-wrap;">Registros exibidos em </span>**vermelho**<span style="white-space: pre-wrap;"> indicam que houve uma falha de correspondência, ou seja, o </span>**CNPJ da filial**<span style="white-space: pre-wrap;"> ou o </span>**CPF/CNPJ do colaborador**<span style="white-space: pre-wrap;"> informado no arquivo </span>**não foi encontrado**<span style="white-space: pre-wrap;"> no cadastro do sistema.</span>

##### [![3x.png](https://kb.emasistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/MJhsAhLAYNz0uixS-3x.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/MJhsAhLAYNz0uixS-3x.png)

##### <span style="white-space: pre-wrap;">3. Aba </span>**Registros**

- <span style="white-space: pre-wrap;">É possível </span>**excluir**<span style="white-space: pre-wrap;"> registros inválidos (os que estão em vermelho) utilizando o atalho </span>**`<strong class="editor-theme-bold editor-theme-code">Ctrl + Del</strong>`**.
- <span style="white-space: pre-wrap;">A exclusão do registro é registrada na tabela de log </span>**`<strong class="editor-theme-bold editor-theme-code">importacao_pagar_historico</strong>`**.

[![4x.png](https://kb.emasistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/rDD4eNxlbwwotuPj-4x.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/rDD4eNxlbwwotuPj-4x.png)

##### 4. Atualização da Grade:

- <span style="white-space: pre-wrap;">Se o usuário retornar à aba </span>**Parâmetros**<span style="white-space: pre-wrap;">, fizer ajustes e clicar novamente em </span>**"Próximo &gt;&gt;"**<span style="white-space: pre-wrap;">, o sistema perguntará se deseja </span>**atualizar a grade**<span style="white-space: pre-wrap;"> da aba Registros.</span>
    - **Sim:**<span style="white-space: pre-wrap;"> A grade é recarregada com base nos </span>**novos parâmetros**.
    - **Não:**<span style="white-space: pre-wrap;"> Os dados da grade são </span>**mantidos**.

[![5x.png](https://kb.emasistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/XZOqUuZ0fGpm10mF-5x.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/XZOqUuZ0fGpm10mF-5x.png)

##### 5. Finalização da Importação:

<span style="white-space: pre-wrap;">Ao clicar em </span>**"Finalizar"**, o sistema executa as seguintes etapas:  
  
[![6x.png](https://kb.emasistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/yCLLtlIGeKTZR20k-6x.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/yCLLtlIGeKTZR20k-6x.png)

1. **Bloqueio por Invalidade:**<span style="white-space: pre-wrap;"> O sistema verifica se há registros na grade e se </span>**existem registros inválidos**<span style="white-space: pre-wrap;"> (linhas em vermelho). Se houverem registros inválidos, a importação é </span>**bloqueada**<span style="white-space: pre-wrap;"> até que todos sejam excluídos.</span>
2. **Importação de Títulos:**
    - <span style="white-space: pre-wrap;">Os títulos dos registros </span>**válidos**<span style="white-space: pre-wrap;"> são importados no Contas a Pagar.</span>
    - <span style="white-space: pre-wrap;">Os títulos são gerados com o </span>**Status**<span style="white-space: pre-wrap;"> </span>**Aberto**<span style="white-space: pre-wrap;"> e </span>**Origem**<span style="white-space: pre-wrap;"> </span>**Manual**.
    - **Localização da Filial:**<span style="white-space: pre-wrap;"> O título a pagar será gerado na </span>**Filial**<span style="white-space: pre-wrap;"> cujo </span>**CNPJ**<span style="white-space: pre-wrap;"> corresponde ao </span>`<span class="editor-theme-code">CNPJ da filial</span>`<span style="white-space: pre-wrap;"> lido no arquivo.</span>
        - **Exemplo:**<span style="white-space: pre-wrap;"> Se o usuário estiver operando na Filial 1, mas o CNPJ do arquivo é da Filial 2, o título será gerado para a Filial 2.</span>
3. **Lançamentos Contábeis:**
    - <span style="white-space: pre-wrap;">Caso a </span>**Transação Pagar**<span style="white-space: pre-wrap;"> selecionada possua uma </span>**regra contábil vinculada**<span style="white-space: pre-wrap;">, o sistema </span>**automaticamente**<span style="white-space: pre-wrap;"> gera os lançamentos de </span>**Débito e Crédito**<span style="white-space: pre-wrap;"> correspondentes.</span>

##### 6. Registro de LOG:

- <span style="white-space: pre-wrap;">O sistema deve registrar um </span>**LOG**<span style="white-space: pre-wrap;"> de todos os títulos importados na tabela </span>`<span class="editor-theme-code">importacao_pagar_historico</span>`<span style="white-space: pre-wrap;"> (o log de exclusão manual também é gravado nesta tabela).</span>
- **Observação:**<span style="white-space: pre-wrap;"> O log é gerado </span>**sem o código do título gerado**, registrando apenas o fato da importação e os dados básicos.

##### ⚠️ Observação Técnica

- <span style="white-space: pre-wrap;">Em casos de uso de arquivos </span>**.xls**<span style="white-space: pre-wrap;"> ou </span>**.xlsx**<span style="white-space: pre-wrap;"> em que o sistema exibe a mensagem de erro:</span>

**`<strong class="editor-theme-bold editor-theme-code">"Classe não registrada ClassID: {00024500-0000-0000-C000-000000000046}"</strong>`**

<span style="white-space: pre-wrap;">É provável que haja uma falha de registro ou ausência de componentes necessários. </span>  
  
<span style="white-space: pre-wrap;">A solução é </span>**reinstalar**<span style="white-space: pre-wrap;"> o software de planilhas como </span>**Microsoft Excel**<span style="white-space: pre-wrap;"> ou </span>**WPS Office**.

- Se importar o arquivo e por ventura a planilha estiver aberta, vai dar mensagem 'Exceção' conforme ilustrado na imagem abaixo e não conseguirá realizar a operação.

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2025-12/scaled-1680-/FEHhljtplQ2I0xSQ-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2025-12/FEHhljtplQ2I0xSQ-image.png)

Neste caso, baixa fechar a planilha.

- <span style="white-space: pre-wrap;">Ao tentar importar o arquivo, caso retorne o erro "Interface not supported", identificamos incompatibilidade entre o formato da planilha (xls ou xlsx) com WPSOffice, a solução foi 'salvar como csv' dessa forma importou corretamente. </span>

##### **Conteudos adicionais**

<span style="white-space: pre-wrap;">Acesso ao ambiente demo com planilha para simular a importação, acesso </span>[aqui](https://kb.emasistemas.com.br/link/1#bkmrk-14.-importa%C3%A7%C3%A3o-plani)

<span style="white-space: pre-wrap;">RFP / Dicas de implantação disponivel </span>[aqui](https://portal.ema.net.br/v2/bpm/instancias/criar/398?Tl_classificacao=37.5.34&IDITEM=37&IDMODULO=5&IDOPERACAO=34)

<span style="color: rgb(68, 68, 68); background-color: rgb(255, 255, 255); white-space: pre-wrap;">Informações comerciais - </span><span style="color: rgb(53, 152, 219); background-color: rgb(255, 255, 255); white-space: pre-wrap;">Acesse o </span><span style="color: rgb(53, 152, 219);">APP Shop &gt; L.U. Importação planilha contas a pagar</span>

#####