Importación CSV — Cuentas por cobrar
Importa lotes de cuentas por cobrar vía archivo CSV.
Dónde está
No existe "Importación" en el menú, ni una pantalla de importación. El camino es:
Cuentas por Cobrar → 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 cobrar."
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 cobrar |
amount | ✅ | Importe en reales (ej.: 299,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 del cliente (lo 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: pix, boleto, dinheiro, cartao_credito, etc. |
notes | — | Observaciones |
ir_relevant | — | true o false |
Los nombres de arriba son los canónicos, pero todo encabezado acepta el equivalente en portugués — descricao, valor, vencimento, cliente, categoria, observacao y así sucesivamente. Las columnas que el sistema no conoce se ignoran en silencio.
El archivo de cuentas por cobrar acepta las mismas columnas que el de pagar, excepto las de pago (código de barras, PIX, datos bancarios, tributo, programación) — esas existen solo del lado de pagar, que es quien envía dinero al banco.
Formato
El parser es más tolerante de lo que parece. No necesitas normalizar el archivo antes:
- 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. - Importes —
1234.56,1.234,56,1234,56, con o sinR$. El importe 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, usa Guardar como → CSV UTF-8; o parte de la plantilla descargada.
Otros rechazos del archivo entero: una extensión distinta de .csv, un tamaño superior a 5 MB, un 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 línea.
Importar
- Sube el archivo. El sistema lo lee y muestra la vista previa.
- Las filas válidas ya vienen marcadas. Haz clic en una fila para desmarcarla.
- Haz clic en Importar 12 líneas (el botón trae el número de filas marcadas).
Filas con error
Las filas inválidas aparecen en la vista previa con un marcador rojo, y no se pueden seleccionar ni editar allí. No hay corrección dentro del sistema. La propia pantalla dice el camino: "Desmarca las filas con errores o corrígelas en el archivo y vuelve a subirlo."
El número en Fila 12 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 cliente 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 cobrar importadas no pasan por autorización. La puerta de autorización de pagos existe solo del lado de pagar, porque es allí donde sale dinero. Un cobro importado entra directamente en la lista normal y en los totales.