Pular para o conteúdo principal

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 → pílula Importar, na própria listagem.

Sem nenhuma conta cadastrada ainda, a listagem mostra o quadro vazio com o botão Importar ao lado de Nova conta a pagar, que abre o mesmo painel.

É 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​

ColunaObrigatórioDescriçã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 do fornecedor (se ainda não existir, a prévia pergunta se cria)
category_name—Nome da categoria (se ainda não existir, a prévia pergunta se cria)
cost_center_name—Nome do centro de classificação (se ainda não existir, a prévia pergunta se cria)
payment_method—Método: boleto, concessionaria, tributo, ted, pix, cartao_credito, cartao_debito, dinheiro, cheque, debito_automatico, outro ou nenhum (os literais em inglês do produto também valem)
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, icms, iss, iptu, itbi ou dare
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. Planilhas de outros sistemas também funcionam para fornecedor, centro de classificação e categoria: contraparte vale como person_name; centro_de_receita, centro_de_classificacao, centro_de_resultado, centro, cost_center valem como cost_center_name, e plano_de_contas, categoria_financeira, category como category_name. Se o espaço tiver um classificador com o mesmo nome de uma dessas colunas (ex.: Centro de Resultado), a coluna vai para o classificador. Se a planilha tiver mais de uma coluna para o mesmo campo (ex.: Centro de Custo e Centro de Receita), cada linha usa a primeira que estiver preenchida. Além desses nomes, um cabeçalho com a palavra centro é lido como centro de classificação; um com categoria ou plano de contas, como categoria (por exemplo, Centro de Lucro, Categoria DRE); e um com pessoa, cliente ou fornecedor acompanhada só de palavras de nome, como pessoa (por exemplo, Nome do Fornecedor, Cliente / Fornecedor — mas não CNPJ do Fornecedor). 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​

Fornecedores, categorias e centros de classificação aparecem na prévia, cada um com o que vai acontecer na importação: os que já existem são ligados; os que ainda não existem vêm marcados para criar (ou para deixar em branco, se você não tiver permissão de criar); um nome quase igual a um existente — só muda acento, maiúscula ou espaço — vem marcado para usar o existente; e um centro de classificação que só existe do outro lado (ex.: um do tipo Receita numa conta a pagar) vem marcado para deixar em branco. O fornecedor é procurado só pelo nome: uma pessoa já cadastrada como cliente também serve, e passa a ser fornecedor também. Grafias do mesmo nome que só mudam acento, maiúscula ou espaço (ex.: Água e Luz e agua e luz) contam como um nome só. Dá para trocar qualquer escolha antes de importar.

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​

Contas a pagar importadas entram sob o portão de aprovação de pagamentos: nascem aguardando aprovação e não aparecem na lista oficial (nem em totais/fluxo de caixa) até serem aprovadas por uma pessoa em Aprovar pagamentos. Só depois de aprovadas 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.