Skip to main content

Assistente de Importação de Planilha para Contas a Pagar do Ema ERP

• Esta documentação descreve a funcionalidade "Assistente de importação de planilha de contas a pagar", implementada no módulo Finanças do Ema ERP para automatizar a criação de títulos a pagar a partir de arquivos externos.

• Disponível a partir da versão: 21.0

• Essa é uma funcionalidade RevOps.

1. Visão Geral

O Assistente é uma nova operação acessível em Finanças > Operações > Assistente de importação de planilha de contas a pagar. Ele permite a importação de títulos a pagar a partir de arquivos nos formatos .xls, .xlsx ou .csv, oferecendo configurações flexíveis para mapeamento de colunas e definição de parâmetros padrão.

1x.png

Funcionamento do Assistente

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

1. Aba Parâmetros

Nesta primeira etapa, o usuário define o arquivo de origem e mapeia as colunas-chave da planilha, além de configurar os valores padrão para os títulos a serem gerados.

  • Configurações do Arquivo e Colunas:
    • Caminho do arquivo: Define o local do arquivo (.xls, .xlsx, ou .csv) a ser importado.
    • Nomes das colunas: O usuário deve informar os nomes exatos das colunas no arquivo que representam:
      • CNPJ da filial (Exemplo: cp_cgce_emp)
      • CPF/CNPJ do colaborador (Exemplo: documento_cpf)
      • Valor líquido (Exemplo: cp_valor)
    • Outros campos: Os demais campos da aba definem os valores padrão que serão aplicados a todos os títulos importados (ex: Transação, Título, Forma de Pagamento, etc.).
  • Gravação de Configuração:
    • O sistema grava a última configuração utilizada por usuário para todos os campos,
      exceto: Caminho, Data emissão e Vencimento.
  • Validação:
    • Ao clicar em "Próximo >>", o sistema executa a validação dos dados:
      • Verifica se todos os campos obrigatórios (*) foram preenchidos.
      • Valida se os valores informados são válidos (ex: se o método de pagamento selecionado realmente existe no sistema).

        2x.png
      2. Aba 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: O sistema carrega e exibe todos os registros encontrados no arquivo.
      • Identificação de Registros Inválidos:
        • Registros exibidos em vermelho indicam que houve uma falha de correspondência, ou seja, o CNPJ da filial ou o CPF/CNPJ do colaborador informado no arquivo não foi encontrado no cadastro do sistema.
3x.png
3. Aba Registros
  • É possível excluir registros inválidos (os que estão em vermelho) utilizando o atalho Ctrl + Del.
  • A exclusão do registro é registrada na tabela de log importacao_pagar_historico.

4x.png

4. Atualização da Grade:
  • Se o usuário retornar à aba Parâmetros, fizer ajustes e clicar novamente em "Próximo >>", o sistema perguntará se deseja atualizar a grade da aba Registros.
    • Sim: A grade é recarregada com base nos novos parâmetros.
    • Não: Os dados da grade são mantidos.

5x.png

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

Ao clicar em "Finalizar", o sistema executa as seguintes etapas:

6x.png

  1. Bloqueio por Invalidade: O sistema verifica se há registros na grade e se existem registros inválidos (linhas em vermelho). Se houverem registros inválidos, a importação é bloqueada até que todos sejam excluídos.
  2. Importação de Títulos:
    • Os títulos dos registros válidos são importados no Contas a Pagar.
    • Os títulos são gerados com o Status Aberto e Origem Manual.
    • Localização da Filial: O título a pagar será gerado na Filial cujo CNPJ corresponde ao CNPJ da filial lido no arquivo.
      • Exemplo: 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.
  3. Lançamentos Contábeis:
    • Caso a Transação Pagar selecionada possua uma regra contábil vinculada, o sistema automaticamente gera os lançamentos de Débito e Crédito correspondentes.
6. Registro de LOG:
  • O sistema deve registrar um LOG de todos os títulos importados na tabela importacao_pagar_historico (o log de exclusão manual também é gravado nesta tabela).
  • Observação: O log é gerado sem o código do título gerado, registrando apenas o fato da importação e os dados básicos.
⚠️ Observação Técnica

Em casos de uso de arquivos .xls ou .xlsx em que o sistema exibe a mensagem de erro:

"Classe não registrada ClassID: {00024500-0000-0000-C000-000000000046}"

É provável que haja uma falha de registro ou ausência de componentes necessários.

✅ A solução é reinstalar o software de planilhas como Microsoft Excel ou WPS Office.


Back to top