Importar clientes

Si estás empezando con Mosce ERP o necesitas actualizar varios clientes de una sola vez - migración desde otro sistema, lista entregada por tu contador, base de datos exportada de una hoja de cálculo - el botón Importar te permite subir un archivo CSV y cargar todos los registros en un solo paso. Mosce ERP valida el archivo antes de guardar nada, así puedes corregir errores sin consecuencias.

Antes de empezar

• Necesitas el permiso clients:bulk-import. Si no aparece el botón Importar en la barra de herramientas de la lista de clientes, pídele a quien administra la cuenta que te lo asigne.
• El archivo debe estar en formato CSV (valores separados por comas), codificado en UTF-8.
• Hay un límite de filas por archivo y de archivos por mes según tu plan (ver "Límites" más abajo).

Paso 1 - Descargar la plantilla

En la página Clientes, haz clic en el botón Importar de la barra de herramientas. En la primera pantalla del asistente, descarga la plantilla con el botón Descargar plantilla CSV.

La plantilla incluye dos filas de ejemplo y todos los encabezados que Mosce ERP espera. Las columnas son:

Importante: los nombres de las columnas deben estar exactamente como aparecen en la plantilla - en inglés, sin espacios adicionales. No los traduzcas ni los renombres.

Paso 2 - Validar tu archivo

Con tu archivo listo, arrástralo a la ventana o selecciónalo con el explorador de archivos. Mosce ERP lo revisa sin guardar nada todavía - esta validación detecta errores antes de que se carguen.

Si todo está bien, verás una vista previa de las primeras filas y el botón Continuar se habilita.

Si hay errores, aparece una tabla con:

• El número de fila donde ocurrió el problema.
• El campo que no pasó la validación.
• El motivo del error (por ejemplo, "Correo electrónico inválido" o "El nombre es obligatorio").

Puedes descargar el reporte completo con el botón Descargar errores.csv, corregir el archivo original, y volver a subirlo desde el inicio.

Paso 3 - Confirmar la importación

Antes de cargar los datos, elige un modo:

• Crear registros nuevos solamente - si una fila coincide con un cliente que ya existe (por RNC/cédula o email), se descarta sin error. Útil para cargas iniciales cuando no quieres tocar lo que ya tienes en Mosce ERP.
• Crear nuevos y actualizar existentes - si una fila coincide con un cliente existente, sus datos se actualizan con los valores del CSV. Si no hay coincidencia, se crea un cliente nuevo.

Haz clic en Importar para comenzar. Al terminar, verás un resumen con la cantidad de clientes creados y la cantidad de clientes actualizados.

Si tu archivo es muy grande, Mosce ERP lo procesa en segundo plano y te avisa con una notificación cuando termine. Puedes cerrar el asistente y seguir trabajando normalmente.

¿Cómo identifica Mosce ERP clientes duplicados?

Mosce ERP compara cada fila de tu CSV con los clientes existentes de tu cuenta usando la siguiente lógica, en orden de prioridad:

1. RNC o cédula + tipo de identificación (taxId + taxIdType): si ambos coinciden con un cliente existente, se considera el mismo cliente.
2. Correo electrónico (email): si no hay RNC/cédula en la fila, Mosce ERP busca por email.
3. Si no hay coincidencia por ninguno de los dos, se crea un cliente nuevo (modo Crear nuevos y actualizar existentes) o se descarta (modo Crear registros nuevos solamente).

Límites

Si superas el límite de filas por archivo, Mosce ERP te pedirá dividirlo en archivos más pequeños y subirlos uno a uno.

Si superas el límite de archivos del mes, el botón Importar mostrará un aviso indicando que has alcanzado el límite. Los contadores se reinician el primer día de cada mes.

Preguntas frecuentes

¿Qué pasa si Excel me guarda el CSV con punto y coma en vez de coma? Mosce ERP solo acepta comas como delimitador. Al guardar desde Excel, elige la opción CSV (delimitado por comas) o CSV UTF-8 (delimitado por comas) - no la opción genérica de CSV que algunos sistemas configuran con punto y coma.

¿Qué pasa con los acentos y la ñ? Asegúrate de guardar el archivo con codificación UTF-8. Si los caracteres especiales se ven como símbolos extraños después de importar, vuelve a guardar el archivo como UTF-8 desde tu hoja de cálculo y vuelve a intentarlo.

¿Puedo importar la dirección y el teléfono del cliente? Sí. Las columnas address, city, province y phone son opcionales pero aceptadas en la importación.

¿Puedo importar el límite de crédito del cliente? Sí. La columna creditLimit acepta números enteros en pesos dominicanos. Si un cliente no tiene límite de crédito, deja la celda vacía o ponle 0.

¿Y los datos de condición de crédito (días de crédito, tasa de descuento)? Las condiciones de crédito no forman parte del CSV de importación. Una vez importado el cliente, puedes asignarle una condición de crédito desde su ficha individual en Mosce ERP.

¿Puedo importar clientes de más de una vez? Sí. Cada importación es independiente. Si usas el modo Crear nuevos y actualizar existentes, las importaciones posteriores actualizan los datos existentes sin duplicar registros.

¿Puedo importar columnas adicionales que no están en la plantilla? No. Mosce ERP solo lee las columnas de la plantilla. Cualquier columna extra es ignorada - no causa un error pero tampoco se importa.

Relacionados

• Importar productos
• Importar suplidores

---

Última actualización: 2026-05-11