Importación CSV — Cuentas por pagar

Importa lotes de cuentas por pagar mediante un archivo CSV.

Dónde está

No existe "Importación" en el menú, ni una pantalla de importación. El camino es:

Cuentas por Pagar → píldora Importar, en la propia lista.

Hace falta tener una empresa específica seleccionada en el encabezado. En "todas las empresas", el panel solo avisa: "Selecciona una empresa específica para importar cuentas por pagar."

El botón Descargar plantilla entrega un CSV de ejemplo con el encabezado correcto — es el punto de partida más seguro, porque ya viene en la codificación adecuada.

Columnas del CSV

Columna	Obligatorio	Descripción
description	✅	Descripción de la cuenta por pagar
amount	✅	Monto en reales (ej.: 3500,00)
due_date	✅	Fecha de vencimiento (dd/MM/yyyy)
competence_date	—	Fecha de competencia (dd/MM/yyyy)
document	—	Identificador del documento
document_date	—	Fecha de emisión (dd/MM/yyyy)
document_number	—	Número de la factura
person_name	—	Nombre de la persona/proveedor (se crea si no existe)
category_name	—	Nombre de la categoría (debe existir ya — no se crea; un nombre sin correspondencia se ignora)
cost_center_name	—	Nombre del centro de clasificación (debe existir ya — no se crea; un nombre sin correspondencia se ignora)
payment_method	—	Método: bank_billet, utility, tribute, ted, pix, credit_card, debit_card, cash, check, direct_debit, other o none (los alias en portugués — boleto, dinheiro, … — también valen)
notes	—	Notas
ir_relevant	—	true o false
operation_kind	—	pagamento o transferencia
barcode	—	Código de barras (boleto o factura de servicios)
pix_copia_e_cola	—	Payload PIX Copia e Cola
pix_key	—	Clave PIX
pix_key_type	—	Tipo de clave: cpf, cnpj, email, phone, random
bank_code	—	Código COMPE del banco (TED)
bank_ispb	—	ISPB del banco (TED)
agency	—	Agencia bancaria
agency_digit	—	Dígito de la agencia
account_number	—	Número de cuenta
account_digit	—	Dígito de la cuenta
transfer_purpose	—	Propósito de la transferencia (TED)
tax_kind	—	Tipo de tributo: darf, gru, gps, fgts, icms, iss, iptu, itbi o dare
beneficiary_name	—	Nombre del beneficiario (envío al banco)
beneficiary_document	—	CPF o CNPJ del beneficiario
scheduled_to	—	Fecha/hora de programación del envío al banco

Los nombres de arriba son los canónicos, pero todo encabezado acepta su equivalente en portugués — descricao, valor, vencimento, fornecedor, categoria, observacao y así sucesivamente. Las columnas que el sistema no conoce se ignoran en silencio.

Formato

El parser es más tolerante de lo que parece. No hace falta normalizar el archivo de antemano:

• Encabezado — mayúsculas, acentos y espacios no importan: Descrição, DESCRICAO y descricao son la misma columna.
• Separador — , o ;, detectado por la línea de encabezado. En caso de empate, ;.
• Fechas — 31/12/2026, 31-12-2026 o 2026-12-31.
• Montos — 1234.56, 1.234,56, 1234,56, con o sin R$. El monto tiene que ser mayor que cero.
• ir_relevant — true/false, sim/nao, yes/no, 1/0, s/y/n. Sin acento, en mayúscula o minúscula. Vacío deja el campo en blanco.

aviso

La codificación tiene que ser UTF-8, y es aquí donde tropieza la mayoría de los archivos. Excel en portugués guarda el CSV en Windows-1252 por defecto, y el sistema lo rechaza con un mensaje que permanece en portugués: "Arquivo não está em UTF-8. Salve novamente em UTF-8 e tente novamente." ("El archivo no está en UTF-8. Guárdalo de nuevo en UTF-8 e inténtalo otra vez.") En Excel, usa Guardar como → CSV UTF-8; o parte de la plantilla descargada.

Otros rechazos del archivo entero: extensión distinta de .csv, tamaño superior a 5 MB, archivo vacío, y columna obligatoria ausente — "Colunas obrigatórias ausentes: amount" ("Faltan columnas obligatorias: amount"). En esos casos no hay vista previa: el problema es del archivo, no de una fila.

Importar

1. Sube el archivo. El sistema lo lee y muestra la vista previa.
2. Las filas válidas ya vienen marcadas. Haz clic en una fila para desmarcarla.
3. Haz clic en Importar N líneas.

Filas con error

Las filas inválidas aparecen en la vista previa con un marcador rojo, y no pueden seleccionarse ni editarse ahí. No hay corrección dentro del sistema. La propia pantalla indica el camino: "Desmarca las filas con errores o corrígelas en el archivo y vuelve a subirlo."

El número en Fila N es el número de la línea en el archivo, contando el encabezado — la primera línea de datos es la 2.

La grabación corre en segundo plano

Al confirmar, recibes "Importación iniciada en segundo plano" y un diálogo de progreso. Puedes cerrar el diálogo — la importación continúa, y el progreso queda visible en la esquina inferior derecha.

Vínculos

El proveedor se crea automáticamente cuando el nombre no existe. La categoría y el centro de clasificación no se crean: un nombre sin correspondencia deja el campo en blanco, sin error y sin aviso.

Las reglas automáticas se aplican a los registros importados.

Historial

Debajo del panel, la sección Historial lista las importaciones con fecha, archivo, estado (En cola, En progreso, Completado, Fallido, Cancelado), cuántas filas entraron del total y quién la pidió.

Aprobación

Las cuentas por pagar importadas entran bajo la puerta de aprobación de pagos: nacen esperando aprobación y no aparecen en la lista oficial (ni en totales/flujo de caja) hasta ser aprobadas por una persona en Aprobar pagos. Solo después de aprobadas pueden enviarse al banco. Esto aplica con la puerta activada (el valor por defecto); desactivada, las filas importadas entran ya oficiales. Ver Ciclo de vida.