Importar Clientes

Carga masiva de clientes desde Excel o CSV; la IA reconoce las columnas del archivo automáticamente

CL-016 Clientes → Importar Clientes consulta AY-100
Menú Ayuda

Enviarle este manual a un usuario

El enlace abre solo este manual, sin el menú del sistema. El usuario no necesita clave ni entrar a FactuPOS: se ve en cualquier navegador y en el celular.

El WhatsApp sale del número de Soporte Real y el correo de info@soportereal.com. Con Compartir desde este teléfono sale de su propio WhatsApp y elige el contacto de su lista, sin escribir el número.

Importar Clientes CL-016Permiso 311

Herramienta para cargar de una sola vez una lista de clientes desde un archivo de Excel (.xlsx, .xls) o CSV. Ideal cuando se migra desde otro sistema o cuando un vendedor entrega su cartera en una hoja de cálculo. La inteligencia artificial reconoce automáticamente qué columna del archivo corresponde a cada dato del cliente (cédula, nombre, correo, teléfono, zona, crédito…), aunque los títulos vengan con otros nombres.

Cómo se accede
  • Menú Clientes → Operaciones → Importar clientes
  • Es un módulo de escritorio (no disponible en celular)
  • El archivo puede tener hasta 5.000 filas y 20 MB

Paso 1 — Subir el archivo

Arrastre el archivo a la zona punteada o haga clic para elegirlo. No hace falta un formato especial: el sistema detecta solo la fila de títulos aunque el archivo tenga encabezados decorativos arriba. Antes de subir, elija qué hacer si el cliente ya existe:

  • Saltarlo (opción por defecto) — el cliente existente no se toca.
  • Actualizar sus datos — se sobrescriben los campos que vengan con valor en el archivo (requiere además el permiso 313 de editar clientes).
  • ☑ Detectar duplicados también por cédula — una cédula repetida cuenta como cliente existente, aunque el código sea distinto.
  • ☑ Usar cédula como código cuando falte — si la fila no trae código, se usa la cédula; si tampoco hay, se numera automáticamente.

Paso 2 — Revisar el mapeo

La IA propone a qué campo de FactuPOS va cada columna y muestra los datos de muestra de cada una para verificar. Usted puede corregir cualquier asignación con el selector, o marcar «Ignorar esta columna» para las que no interesen. Cada campo destino solo puede usarse una vez.

¿Y si la IA no está disponible? El módulo funciona igual: hace un reconocimiento básico por los títulos de las columnas y usted ajusta el resto a mano. El badge del encabezado indica si la IA está activa.

Paso 3 — Vista previa e importar

Se muestran las primeras filas tal como quedarán los clientes, con el total de filas a procesar. Al presionar Importar clientes el sistema crea (o actualiza) los registros y muestra el resultado: creados, actualizados, saltados y con error, con el detalle fila por fila de lo que no se pudo procesar.

Qué hace el sistema con los datos

  • El tipo de identificación (física, jurídica, DIMEX, NITE) se deduce solo de la cédula si no viene en el archivo.
  • Los correos inválidos se descartan con aviso (no frenan la importación).
  • Montos y fechas se aceptan en varios formatos (₡1.500,50 — 15/03/1980 — fechas de Excel).
  • Si viene un límite de crédito mayor a cero, el crédito del cliente queda activado.
  • Los clientes nuevos se crean activos, en colones, con plazo de 30 días si no se indica otro.
  • La importación queda registrada en la bitácora del sistema.
Recomendación Haga una primera prueba con un archivo pequeño (5-10 filas) para verificar el mapeo y el resultado, y luego importe la lista completa. Si algo salió mal con el modo «Saltar», puede corregir el archivo y volver a importarlo: los ya creados se saltan y solo entran los que faltaban.
Si dice «El archivo es muy pesado para subirlo» El archivo pasa del máximo permitido (20 MB). Normalmente pasa cuando el Excel trae imágenes, logos o muchas hojas extra: guárdelo con solo la hoja de clientes o expórtelo a CSV, que pesa mucho menos. Si la lista es muy grande, pártala en varios archivos y súbalos uno por uno.