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 (el campo Documento del formulario)
document_date	—	Fecha de emisión (dd/MM/yyyy)
document_number	—	Número de la factura (el campo Número de documento)
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, bank_billet, ted, credit_card, debit_card, cash, check, direct_debit, other o none (los alias en portugués — boleto, dinheiro, … — también valen) — aceptado y guardado en el título, aunque el formulario de cuentas por cobrar no expone el campo
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, 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.
• Importes — 1234.56, 1.234,56, 1234,56, con o sin R$. 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.

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: 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" ("Faltan columnas obligatorias: amount"). En esos casos no hay vista previa: el problema es del archivo, no de una línea.

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 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 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 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ó.

Aprobación

nota

Las cuentas por cobrar importadas no pasan por aprobación. La puerta de aprobació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.