Importación por hoja de cálculo
La página Importaciones sube tu cartera por archivo CSV: primero los clientes, después los cobros. El procesamiento corre en segundo plano, fila por fila — las filas con error no tumban el resto del archivo.
Formato del archivo
El formato es el CSV brasileño del día a día, sin exigencias exóticas:
- Separador: punto y coma (
;) o coma (,) — detectado automáticamente. - Montos: formato brasileño, como
1.234,56. - Fechas:
DD/MM/AAAAoAAAA-MM-DD. - Encabezado: obligatorio en la primera fila; los nombres de columna no distinguen mayúsculas de minúsculas. Las columnas extra se ignoran.
El botón Descargar modelo en la propia página genera un CSV de ejemplo ya en el formato correcto para el tipo seleccionado.
Columnas — clientes
| Columna | Obligatoria | Observación |
|---|---|---|
nome | sí | |
documento | no | CPF (11 dígitos) o CNPJ (14); la puntuación se ignora |
email | no | se convierte en el correo principal |
telefone | no | se convierte en el teléfono principal |
external_id | no | ID del cliente en tu sistema |
apelido, observacoes | no | |
tags | no | separadas por ; dentro de la celda |
Columnas — cobros
| Columna | Obligatoria | Observación |
|---|---|---|
valor | sí | formato brasileño (1.250,00) |
vencimento | sí | DD/MM/AAAA o AAAA-MM-DD |
documento_cliente o external_id_cliente | una de las dos | identifica al cliente dueño del cobro |
descricao, numero_documento, external_id | no | |
juros, multa, desconto | no | se suman/restan en el monto actual |
emissao | no | por defecto: fecha de la importación |
Importa clientes antes que cobros: la fila de cobro que referencia a un cliente inexistente se rechaza con el error "Cliente no encontrado — importa los clientes antes". Los cobros importados entran con origen planilha y ya con el estado correcto (Pendiente o Vencido, según el vencimiento).
Deduplicación
En la importación de clientes, el sistema nunca duplica registros. Para cada fila busca un cliente existente primero por el external_id; si no hay, por el documento. Si lo encuentra: la fila actualiza el registro existente (solo los campos completados). Si no lo encuentra: crea. Las filas repetidas dentro del propio archivo también se deduplican.
Seguimiento y errores por fila
Después de la subida, la importación aparece en la tabla con estado (En cola → Procesando → Completada o Falló) y el resultado: cuántos registros creados, cuántos actualizados y cuántos errores. La pantalla se actualiza sola mientras hay procesamiento en curso, y recibes una notificación en la campana cuando termina.
Si hay errores, el enlace Ver errores abre la lista completa, fila por fila, con el número de fila en el archivo original y el motivo ("Columna 'valor' inválida", "Columna 'nome' es obligatoria"...). Corrige solo las filas rechazadas e importa nuevamente solo esas — las demás ya entraron.
LGPD: el archivo no se retiene
El contenido del CSV contiene datos personales (nombres, documentos, contactos). Por eso, apenas termina el procesamiento — con éxito o falla — el contenido del archivo se borra del sistema. Quedan solo los metadatos de la importación (nombre del archivo, conteos, lista de errores por fila), que son lo que necesitas para auditar y corregir.