Importación CSV — Transacciones

Importa transacciones en lote desde un archivo CSV.

Dónde está

No existe "Importación" en el menú, ni una pantalla de importación. Y, al contrario de lo que cabría esperar, la pantalla de Transacciones no importa — la importación vive dentro de la cuenta:

Cuentas financieras → abre la cuenta → píldora Importar.

nota

No hay selector de cuenta de destino. La cuenta es aquella en la que ya estás: todas las transacciones del archivo entran en ella. Para importar en dos cuentas, son dos importaciones.

Hace falta tener una empresa específica seleccionada en el encabezado, y la cuenta tiene que estar vinculada a una empresa. En los dos casos el panel avisa: "Selecciona una empresa específica para importar transacciones."

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 con la codificación correcta.

Columnas del CSV

Columna	Obligatorio	Descripción
data	✅	Fecha de la transacción
descricao	✅	Descripción de la transacción
valor	✅	Monto en reales, siempre positivo
tipo	✅	entrada (crédito) o saida (débito)
categoria	—	Nombre de la categoría (tiene que existir ya — no se crea; un nombre sin correspondencia queda en blanco)
pessoa	—	Nombre de la persona (se crea si no existe). Alias: cliente_fornecedor
centro_custo	—	Nombre del centro de clasificación (tiene que existir ya — no se crea). Alias: centro_de_custo
documento	—	Identificador del documento
observacao	—	Notas

aviso

El encabezado de este archivo es en portugués, y solo en portugués. A diferencia del CSV de cuentas por pagar y por cobrar — que acepta tanto description como descricao —, aquí los nombres canónicos ya son los portugueses y no hay equivalente en inglés. Un archivo con description, amount y date se rechaza entero, por falta de una columna obligatoria.

Las columnas que el sistema no conoce se ignoran en silencio.

Formato

• Encabezado — las mayúsculas, los acentos y los 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: quien decide si es entrada o salida es la columna tipo, nunca el signo del monto.

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: "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: tipo". 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 líneas válidas ya vienen marcadas. Haz clic en una línea para desmarcarla.
3. Haz clic en Importar N líneas.

Líneas con error

Las líneas inválidas aparecen en la vista previa con un marcador rojo, y no se pueden seleccionar ni editar 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

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