Pular para o conteúdo
Acessar sistema

Importação de contas

Se você está migrando de outro sistema ou controla as contas em planilha, dá para trazer tudo de uma vez em vez de lançar conta por conta. A mesma tela atende Contas a Pagar e Contas a Receber: o que define o tipo é a tela em que você está.

É o mesmo arquivo oferecido na tela de importação, em Baixar modelo CSV.

  1. No menu lateral, abra Financeiro > Contas a Pagar (ou Contas a Receber).
  2. Clique em Opções > Importação de Contas.

O item aparece para quem tem a permissão Importação do grupo Financeiro/ContasReceber (ou Financeiro/ContasPagar); sem ela, o sistema também recusa a importação.

Menu Opções da listagem de Contas a Receber com o item Importação de Contas, numerados de 1 a 2

  1. Opções: abre o menu de ferramentas da listagem.
  2. Importação de Contas: abre a janela de importação.
  1. Baixe o modelo pelo botão da própria tela e preencha com os seus dados.
  2. Em Opções de importação, deixe Importar Contas marcado e escolha o que deve ser criado junto com as contas (já vêm marcados): Importar Pessoas, Importar Plano de Contas, Importar Centro de Custo. Importar Pessoas exige também a permissão Importação do grupo Pessoa: sem ela, a importação para com o aviso de permissão e nenhuma conta é gravada.
  3. Marque Atualizar registros existentes se quiser que uma conta que já está no sistema seja atualizada com os dados do arquivo. Uma linha conta como repetida quando uma conta trazida por importação antes tem o mesmo vencimento, valor, descrição, pessoa e CPF/CNPJ. Sem essa opção, ela não entra e aparece no relatório como “Registro já importado”.
  4. Anexe o arquivo (só .csv, de até 4,93 MB), marque Validar apenas e clique em Validar Arquivo.
  5. Se o resultado estiver correto, desmarque Validar apenas e clique em Enviar/Importar.
  6. Clique em Baixar Relatório HTML para conferir linha a linha o que entrou e o que falhou.

Janela Importação de Contas com o modelo, o arquivo escolhido, as opções de importação e o botão Validar Arquivo numerados de 1 a 7

  1. Baixar modelo CSV: baixa o arquivo modelo para você preencher.
  2. Selecionar arquivo: escolhe o arquivo CSV (também dá para soltar o arquivo na janela).
  3. Arquivo escolhido: mostra o nome e o tamanho do arquivo. Remover tira o arquivo para você escolher outro.
  4. Opções de importação: o que a importação cria junto com as contas.
  5. Atualizar registros existentes: atualiza a conta que já está no sistema com os dados do arquivo.
  6. Validar apenas: confere o arquivo sem gravar nada.
  7. Validar Arquivo: confere o arquivo. Com Validar apenas desmarcado, o botão vira Enviar/Importar e grava as contas.

Ao terminar, a janela mostra o resultado.

Resultado da importação com o total processado, o número de contas importadas e as falhas, numerado como 1

  1. Resultado: o total de linhas processadas, quantas entraram (Importados) e quantas falharam (Falhas).

NUMERO;PESSOA_NOME;PESSOA_CPFCNPJ;DESCRICAO;NUM_DOCUMENTO;PARCELA;VALOR;DATA_EMISSAO;DATA_VENCIMENTO;SITUACAO;PLANO_CONTAS;CENTRO_CUSTO;FORMA_PAGAMENTO;DATA_HORA_QUITACAO;TOTAL_PAGO;OBS

O separador é o ponto e vírgula (;) e os títulos das colunas ficam em letras maiúsculas. A ordem das colunas não importa, mas o nome precisa ser exatamente o do modelo.

CampoObrigatórioExemploObservações
NUMERONão1Identifica a conta dentro do arquivo. Cada conta precisa de um número diferente. Em branco, vale a posição da linha no arquivo.
PESSOA_NOMESimMARIA SILVA COMERCIO LTDACliente ou fornecedor da conta.
PESSOA_CPFCNPJNão12345678000195Ajuda a localizar a pessoa já cadastrada em vez de criar outra.
DESCRICAONãoVENDA DE MERCADORIASTexto que aparece na listagem.
NUM_DOCUMENTONãoNF 1001Número da nota, do boleto ou do contrato que originou a conta.
PARCELANão1/2Identificação da parcela.
VALORSim350,00Valor da parcela. Aceita vírgula ou ponto como separador decimal.
DATA_EMISSAONão05/01/2026Data em que a conta foi gerada. Formato DD/MM/AAAA.
DATA_VENCIMENTOSim10/02/2026Sem uma data válida aqui a linha é descartada.
SITUACAONãoPENDENTEVeja os valores aceitos abaixo.
PLANO_CONTASNãoRECEITAS.VENDASUse ponto para separar os níveis.
CENTRO_CUSTONãoCOMERCIAL
FORMA_PAGAMENTONãoPIXPreencha nas contas já quitadas: gera o pagamento junto com a conta.
DATA_HORA_QUITACAONão20/01/2026Data do pagamento.
TOTAL_PAGONão1200,00Valor já pago da conta.
OBSNãoPRIMEIRA PARCELAObservação livre.

O sistema entende variações comuns de outros sistemas:

O que você escreverComo fica no sistema
QUITADO, QUITADA, PAGO, PAGA, Q, RQuitado
CANCELADO, CANCELADA, CAN, CCancelado
Qualquer outro valor, ou em brancoPendente

Uma linha é ignorada quando:

  • não tem DATA_VENCIMENTO ou a data está em formato inválido;
  • não tem PESSOA_NOME e o VALOR é zero;
  • repete um NUMERO já usado por outra linha do arquivo: nesse caso vale a primeira;
  • não passa nas regras da conta (por exemplo, valor zero ou pagamento sem valor): aparece no relatório como “Falha na validação”, com o motivo.

Para trazer mais de um pagamento na mesma conta, inclua linhas extras preenchendo apenas:

  • CONTA_ID com o NUMERO da conta que já está no arquivo;
  • FORMA_PAGAMENTO_NOME, VALOR e DATA_HORA do pagamento.

Essas linhas não criam contas novas: entram como pagamentos da conta indicada.

SintomaCausa provávelComo corrigir
Nenhuma conta importadaCabeçalho em minúsculas ou separador diferente de ;Baixe o modelo de novo e copie os seus dados para dentro dele.
Faltaram contasVencimento em branco ou em formato diferente de DD/MM/AAAACorrija as datas e importe de novo apenas as linhas pendentes.
Duas parcelas viraram uma sóAs duas linhas com o mesmo NUMERODê um número diferente para cada parcela.
Conta quitada recusada com “Falha na validação”FORMA_PAGAMENTO preenchida e TOTAL_PAGO em brancoInforme em TOTAL_PAGO o valor pago.
Pessoa duplicada no cadastroNome escrito de formas diferentes entre as linhasPadronize o nome e informe o CPF/CNPJ.
  • Arquivo salvo em CSV com separador ;
  • Cabeçalho em maiúsculas, igual ao do modelo
  • NUMERO diferente em cada linha
  • DATA_VENCIMENTO preenchida em todas as linhas
  • Contas quitadas com TOTAL_PAGO e FORMA_PAGAMENTO
  • Primeira rodada feita com Validar apenas