Importação CSV — Contas a receber

Importe lotes de contas a receber via arquivo CSV.

Onde fica

Não existe "Importação" no menu, nem uma tela de importação. O caminho é:

Contas a receber → pílula Importar, na própria listagem.

É preciso ter uma empresa específica selecionada no cabeçalho. Em "todas as empresas", o painel só avisa: "Selecione uma empresa específica para importar contas a receber."

O botão Baixar modelo entrega um CSV de exemplo com o cabeçalho correto — é o ponto de partida mais seguro, porque já vem no encoding certo.

Colunas do CSV

Coluna	Obrigatório	Descrição
description	✅	Descrição da conta a receber
amount	✅	Valor em reais (ex.: 299,00)
due_date	✅	Data de vencimento (dd/MM/yyyy)
competence_date	—	Data de competência (dd/MM/yyyy)
document	—	Identificador do documento (o campo Documento do formulário)
document_date	—	Data de emissão (dd/MM/yyyy)
document_number	—	Número da nota fiscal (o campo Nº de documento)
person_name	—	Nome do cliente (cria se não existir)
category_name	—	Nome da categoria (deve já existir — não é criada; nome sem correspondência é ignorado)
cost_center_name	—	Nome do centro de classificação (deve já existir — não é criado; nome sem correspondência é ignorado)
payment_method	—	Método: pix, boleto, ted, cartao_credito, cartao_debito, dinheiro, cheque, debito_automatico, outro ou nenhum — aceito e gravado no título, embora o formulário de contas a receber não exponha o campo
notes	—	Observações
ir_relevant	—	true ou false

Os nomes acima são os canônicos, mas todo cabeçalho aceita o equivalente em português — descricao, valor, vencimento, cliente, categoria, observacao e assim por diante. Colunas que o sistema não conhece são ignoradas em silêncio.

O arquivo de contas a receber aceita as mesmas colunas de pagar, exceto as de pagamento (código de barras, Pix, dados bancários, tributo, agendamento) — elas existem só no lado de pagar, que é quem envia dinheiro ao banco.

Formato

O parser é mais tolerante do que parece. Você não precisa normalizar o arquivo antes:

• Cabeçalho — maiúsculas, acentos e espaços não importam: Descrição, DESCRICAO e descricao são a mesma coluna.
• Separador — , ou ;, detectado pela linha de cabeçalho. Em caso de empate, ;.
• Datas — 31/12/2026, 31-12-2026 ou 2026-12-31.
• Valores — 1234.56, 1.234,56, 1234,56, com ou sem R$. O valor precisa ser maior que zero.
• ir_relevant — true/false, sim/nao, yes/no, 1/0, s/y/n. Sem acento, maiúscula ou minúscula. Vazio deixa o campo em branco.

aviso

A codificação precisa ser UTF-8, e é aqui que a maioria dos arquivos tropeça. O Excel em português salva CSV em Windows-1252 por padrão, e o sistema recusa: "Arquivo não está em UTF-8. Salve novamente em UTF-8 e tente novamente." No Excel, use Salvar como → CSV UTF-8; ou parta do modelo baixado.

Outras recusas do arquivo inteiro: extensão diferente de .csv, tamanho acima de 5 MB, arquivo vazio, e coluna obrigatória ausente — "Colunas obrigatórias ausentes: amount". Nesses casos não há preview: o problema é do arquivo, não de uma linha.

Importar

1. Envie o arquivo. O sistema lê e mostra o preview.
2. As linhas válidas já vêm marcadas. Clique numa linha para desmarcá-la.
3. Clique em Importar N linhas.

Linhas com erro

Linhas inválidas aparecem no preview com um marcador vermelho, e não podem ser selecionadas nem editadas ali. Não há correção dentro do sistema. A própria tela diz o caminho: "Desmarque as linhas com erro ou corrija-as no arquivo e envie novamente."

O número em Linha N é o número da linha no arquivo, contando o cabeçalho — a primeira linha de dados é a 2.

A gravação roda em segundo plano

Ao confirmar, você recebe "Importação iniciada em segundo plano" e um diálogo de progresso. Pode fechar o diálogo — a importação continua, e o progresso fica visível no canto inferior direito.

Vínculos

O cliente é criado automaticamente quando o nome não existe. Categoria e centro de classificação não são criados: nome sem correspondência deixa o campo em branco, sem erro e sem aviso.

As regras automáticas são aplicadas aos registros importados.

Histórico

Abaixo do painel, a seção Histórico lista as importações com data, arquivo, status (Na fila, Processando, Concluído, Falha, Cancelado), quantas linhas entraram do total e quem pediu.

Aprovação

observação

Contas a receber importadas não passam por aprovação. O portão de aprovação de pagamentos existe só no lado de pagar, porque é lá que dinheiro sai. Um recebimento importado já entra na lista normal e nos totais.