Importar vendedores
Cómo cargar tu equipo de vendedores desde un archivo CSV - descargar la plantilla, validar y confirmar la importación.
Importar vendedores
Si estás configurando Mosce ERP con un equipo de ventas ya formado o necesitas cargar el directorio de vendedores desde otro sistema, el botón Importar te permite añadirlos todos de un solo paso. Mosce ERP valida el archivo antes de guardar nada.
Antes de empezar
- Necesitas el permiso
sales-agents:bulk-import. Si no aparece el botón Importar en la barra de herramientas de la lista de vendedores, 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 Vendedores, 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:
| Columna | Obligatorio | Descripción |
|---|---|---|
name | Sí | Nombre completo del vendedor. |
email | No | Correo electrónico del vendedor. Es la clave principal para identificar duplicados en modo Crear nuevos y actualizar existentes. Si se omite, cada fila creará un vendedor nuevo - no podemos detectar si ya existe. |
taxId | No | Cédula o RNC del vendedor (para retenciones o informes fiscales). Opcional. |
phone | No | Teléfono de contacto del vendedor. |
commissionType | No | Tipo de comisión: PERCENT para porcentaje sobre la venta, FIXED para monto fijo por venta. |
defaultCommissionRate | No | Tasa o monto de comisión predeterminado (número). Si commissionType es PERCENT, este valor es el porcentaje (ej. 5 para 5%). Si es FIXED, es el monto en la moneda base de tu cuenta. |
isActive | No | true para activo, false para inactivo. Por defecto true. |
Importante: los nombres de las columnas deben estar exactamente como aparecen en la plantilla. 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.
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, el campo problemático y el motivo. Puedes descargar el reporte completo con el botón Descargar errores.csv, corregir el archivo y volver a subirlo.
Paso 3 - Confirmar la importación
Antes de cargar los datos, elige un modo:
- Crear registros nuevos solamente - si una fila tiene el mismo correo electrónico que un vendedor que ya existe, se descarta sin error.
- Crear nuevos y actualizar existentes - si una fila tiene el mismo correo que un vendedor existente, sus datos se actualizan. Si no hay coincidencia, se crea un vendedor nuevo.
Haz clic en Importar para comenzar. Al terminar, verás un resumen con la cantidad de vendedores creados y 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 vendedores duplicados?
Mosce ERP usa el correo electrónico (email) como clave única de identificación. Si el correo de una fila coincide con el de un vendedor existente, se considera el mismo vendedor.
Límites
| Plan | Filas por archivo | Archivos por mes |
|---|---|---|
| Gratis | 1 000 | 3 |
| Inicial | 10 000 | 20 |
| Profesional | 100 000 | ilimitado |
| Empresarial | ilimitado | ilimitado |
Los contadores de archivos por mes 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 CSV (delimitado por comas) o CSV UTF-8 (delimitado por comas).
¿Qué pasa con los acentos y la ñ? Asegúrate de guardar el archivo en codificación UTF-8. Si los caracteres especiales se ven mal después de importar, guarda el CSV como UTF-8 y vuelve a intentarlo.
¿Se les notifica a los vendedores por correo cuando son importados? No. La importación crea el registro del vendedor en Mosce ERP (nombre, correo, comisión, etc.), pero no envía ninguna invitación ni correo de bienvenida. Si el vendedor necesita acceder a Mosce ERP, su cuenta de usuario debe configurarse por separado desde Configuración → Usuarios.
¿Puedo cambiar el tipo de comisión después de importar? Sí. Una vez creado el vendedor, puedes editar todos sus datos - incluyendo el tipo y la tasa de comisión - desde su ficha individual.
¿Puedo importar columnas que no están en la plantilla? No. Mosce ERP solo lee las columnas de la plantilla. Cualquier columna extra es ignorada sin causar error.
Relacionados
Última actualización: 2026-05-11