Importación personalizada
Asistente de 4 pasos para importar cualquier entidad desde un CSV propio: mapeo de columnas, validación con resaltado de errores por celda y elección del modo de importación.
Importación personalizada
Cuando tienes un CSV exportado de otro sistema - con encabezados en español, columnas en un orden diferente o campos extra que no existen en la plantilla - el botón Importar de cada sección puede rechazarlo. El Asistente de importación del Centro de datos resuelve ese problema: puedes usar cualquier CSV como punto de partida y mapear tus columnas a los campos de Mosce ERP sin tener que reformatear el archivo desde cero.
También es la única forma de importar entidades que no tienen un botón Importar propio en su sección de lista.
Antes de empezar
- Necesitas los permisos
data-tools:readydata-tools:import. - Para importar una entidad específica también necesitas el permiso de importación masiva de esa entidad (por ejemplo,
clients:bulk-importpara importar clientes). - El plan Profesional o Empresarial es obligatorio. Si ves el mensaje "Tu plan no incluye importaciones personalizadas", actualiza tu plan para continuar.
- El archivo debe estar en formato CSV (valores separados por comas), codificado en UTF-8. Mosce ERP no acepta archivos XLSX ni CSV con punto y coma como delimitador.
- Hay un límite de filas por archivo según tu plan (ver "Límites" al final de este artículo).
Cómo llegar al Asistente de importación
En el menú lateral, haz clic en Herramientas → Centro de datos. En la página de inicio, selecciona la tarjeta Importar datos.
Los 4 pasos del asistente
Paso 1 - Entidad
Selecciona el tipo de registro que deseas importar. La lista muestra solo las entidades que soportan importación en esta versión (datos maestros: clientes, productos, suplidores, vendedores, categorías de productos, cuentas bancarias y categorías de gastos).
Cada entidad muestra los modos disponibles:
- Solo crear - disponible en todas las entidades.
- Crear o actualizar - disponible en las entidades que soportan actualización por identificador.
Solo las entidades de datos maestros son importables en esta versión. Los documentos fiscales, las transacciones y los pagos no se pueden importar por CSV.
Descargar la plantilla de la entidad
Antes de continuar, puedes descargar la plantilla oficial CSV para la entidad seleccionada con el enlace Descargar plantilla CSV de [entidad]. La plantilla incluye todos los encabezados que Mosce ERP espera y dos filas de ejemplo. Si tu archivo ya usa los mismos encabezados, el asistente los detectará automáticamente en el Paso 3 y saltará el mapeo.
Haz clic en Continuar para avanzar.
Paso 2 - Archivo
Arrastra tu archivo CSV al área indicada, o haz clic en ella para abrirlo desde el explorador de archivos. El texto que verás en el área de carga es: "Arrastra un archivo CSV aquí o haz clic para seleccionarlo".
Mosce ERP valida el archivo de forma inmediata sin guardar nada todavía - revisa el formato, el encoding y el límite de filas de tu plan. Si el archivo supera el límite de filas, aparece un aviso antes de continuar.
Una vez que el archivo pasa la validación básica, el botón Validar y continuar se habilita. Haz clic para avanzar al Paso 3.
Paso 3 - Mapeo
Este paso solo aparece cuando es necesario: se muestra cuando Mosce ERP no pudo emparejar automáticamente todos los encabezados de tu CSV con los campos de la entidad. Si tus encabezados coinciden exactamente con los de la plantilla oficial, este paso se omite.
Verás una lista de las columnas de tu archivo que quedaron sin mapear. Para cada una, elige el campo de la entidad correspondiente en el menú desplegable. Mosce ERP incluye sugerencias automáticas - si reconoce que tu columna nombre_cliente probablemente corresponde al campo Nombre, lo indica junto al menú con la etiqueta Sugerido: Nombre.
Para aplicar todas las sugerencias de un solo clic, usa el botón Auto-asignar sugerencias.
Las columnas que Mosce ERP ya mapeó automáticamente aparecen agrupadas en un acordeón colapsable para que puedas confirmarlas o corregirlas si es necesario.
Si decides no mapear una columna, déjala en sin asignar - sus datos serán ignorados durante la importación.
Haz clic en Continuar cuando todas las columnas obligatorias estén mapeadas.
Paso 4 - Validación
Aquí puedes revisar los datos antes de importar definitivamente.
Vista previa con errores
La vista previa muestra hasta las primeras 10 filas de tu archivo con el estado de validación de cada celda:
- Las celdas con un problema de formato o valor aparecen resaltadas en rojo. Pasa el cursor sobre la celda para ver el mensaje de error específico (por ejemplo,
"Correo electrónico inválido"o"El precio unitario debe ser un número positivo"). - Las filas con un error que afecta toda la fila (no una celda específica) aparecen con el fondo rojo y el mensaje de error debajo de la fila.
El resumen arriba de la tabla muestra cuántas filas son válidas y cuántas tienen errores.
Si hay errores
Si hay filas con errores, el botón Importar queda deshabilitado hasta que corrijas los problemas. Descarga el listado completo de errores con el botón Descargar errores.csv - ese archivo incluye el número de fila, el campo problemático y el mensaje de error por cada fila fallida. Corrige tu CSV original y vuelve al Paso 2 para subirlo nuevamente.
Modo de importación
Antes de importar, elige cómo Mosce ERP manejará los registros que ya existen:
| Modo | Qué hace |
|---|---|
| Solo crear - omite registros que ya existen | Si una fila coincide con un registro existente (por su identificador único), esa fila se descarta sin error. Útil para una carga inicial cuando no quieres modificar lo que ya tienes. |
| Crear o actualizar - actualiza registros existentes por identificador | Si una fila coincide con un registro existente, sus datos se actualizan. Si no hay coincidencia, se crea un registro nuevo. |
(En el asistente de importación rápida de cada sección, estos modos aparecen como Crear registros nuevos solamente y Crear nuevos y actualizar existentes.)
Si el modo Crear o actualizar no está disponible para la entidad seleccionada, la opción aparece deshabilitada; al pasar el cursor sobre ella verás el mensaje Este modo no está disponible para esta entidad.
Haz clic en Importar para confirmar.
¿La importación es inmediata o en segundo plano?
Depende del tamaño del archivo:
- Archivos pequeños: la importación se procesa de forma inmediata dentro del asistente. Al terminar, verás una notificación con la cantidad de registros creados y actualizados, y serás redirigido al historial filtrado de trabajos.
- Archivos más grandes: el trabajo se encola en segundo plano y aparece en el historial de trabajos cuando termina. Puedes cerrar el asistente y seguir trabajando normalmente mientras tanto.
¿Por qué solo se pueden importar algunas entidades?
En esta versión, el Asistente de importación soporta únicamente entidades de datos maestros (catálogos y configuraciones base). Los documentos fiscales, las facturas, las órdenes, las compras y los pagos no son importables por CSV porque su creación involucra cálculos fiscales, secuencias reguladas y validaciones que deben ocurrir dentro del flujo normal de Mosce ERP.
Límites
| Plan | Filas por archivo | Archivos por mes |
|---|---|---|
| Gratis | No disponible | No disponible |
| Inicial | No disponible | No disponible |
| Profesional | 100 000 | ilimitado |
| Empresarial | ilimitado | ilimitado |
Los límites pueden variar por tipo de entidad - consulta el artículo de cada importador por sección para los valores específicos. Si superas el límite de filas, el Paso 2 mostrará un error antes de intentar procesar el archivo.
Relacionados
Última actualización: 2026-05-12
Exportación personalizada
Cómo usar el Constructor de exportación para descargar exactamente los campos que necesitas, con filtros avanzados y estimación de filas en tiempo real. Compatible con CSV y XLSX.
Exportaciones programadas
Cómo programar exportaciones recurrentes para que tus archivos se generen automáticamente - disponible en los planes Profesional y Empresarial.