Importación CSV — Cuentas por pagar
Importe 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 → pestaña 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: boleto, pix, ted, dinheiro, cartao_credito, etc. |
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, etc. |
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,DESCRICAOydescricaoson la misma columna. - Separador —
,o;, detectado por la línea de encabezado. En caso de empate,;. - Fechas —
31/12/2026,31-12-2026o2026-12-31. - Montos —
1234.56,1.234,56,1234,56, con o sinR$. 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.
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: "Arquivo não está em UTF-8. Salve novamente em UTF-8 e tente novamente." En Excel, use Guardar como → CSV UTF-8; o parta 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". En esos casos no hay vista previa: el problema es del archivo, no de una fila.
Importar
- Suba el archivo. El sistema lo lee y muestra la vista previa.
- Las filas válidas ya vienen marcadas. Haga clic en una fila para desmarcarla.
- Haga 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, usted recibe "Importación iniciada en segundo plano" y un diálogo de progreso. Puede 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ó.
Autorización
Las cuentas por pagar importadas entran bajo la puerta de autorización de pagos: nacen esperando autorización y no aparecen en la lista oficial (ni en totales/flujo de caja) hasta ser autorizadas por una persona en Autorizar pagos. Solo después de autorizadas 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.