Importação CSV — Contas a pagar

Importe lotes de contas a pagar via arquivo CSV.

Onde fica

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

Contas a pagar → pill 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 pagar."

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 pagar
amount	✅	Valor em reais (ex.: 3500,00)
due_date	✅	Data de vencimento (dd/MM/yyyy)
competence_date	—	Data de competência (dd/MM/yyyy)
document	—	Identificador do documento
document_date	—	Data de emissão (dd/MM/yyyy)
document_number	—	Número da nota fiscal
person_name	—	Nome da pessoa/fornecedor (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: boleto, pix, ted, dinheiro, cartao_credito, etc.
notes	—	Observações
ir_relevant	—	true ou false
operation_kind	—	pagamento ou transferencia
barcode	—	Código de barras (boleto ou conta de consumo)
pix_copia_e_cola	—	Payload PIX Copia e Cola
pix_key	—	Chave PIX
pix_key_type	—	Tipo da chave: cpf, cnpj, email, phone, random
bank_code	—	Código COMPE do banco (TED)
bank_ispb	—	ISPB do banco (TED)
agency	—	Agência bancária
agency_digit	—	Dígito da agência
account_number	—	Número da conta
account_digit	—	Dígito da conta
transfer_purpose	—	Finalidade da transferência (TED)
tax_kind	—	Tipo de tributo: darf, gru, gps, fgts, etc.
beneficiary_name	—	Nome do beneficiário (envio ao banco)
beneficiary_document	—	CPF ou CNPJ do beneficiário
scheduled_to	—	Data/hora de agendamento do envio ao banco

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

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 fornecedor é 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.

Autorização

Contas a pagar importadas entram sob o portão de autorização de pagamentos: nascem aguardando autorização e não aparecem na lista oficial (nem em totais/fluxo de caixa) até serem autorizadas por uma pessoa em Autorizar pagamentos. Só depois de autorizadas podem ser enviadas ao banco. Isso vale com o portão ligado (o padrão); desligado, as linhas importadas já entram oficiais. Ver Ciclo de vida.