Importar productos
Cómo cargar tu catálogo de productos desde un archivo CSV - descargar la plantilla, validar y confirmar la importación.
Importar productos
Si estás configurando Mosce ERP por primera vez o necesitas actualizar tu catálogo de forma masiva - precio de costo de toda la línea, lista de un distribuidor, base de datos exportada de otro sistema - el botón Importar te permite subir un archivo CSV y cargar todos los productos en un solo paso. Mosce ERP valida el archivo antes de guardar nada.
Antes de empezar
- Necesitas el permiso
products:bulk-import. Si no aparece el botón Importar en la barra de herramientas de la lista de productos, 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). Para productos, este límite es estricto - ver "Archivos grandes" más abajo.
Paso 1 - Descargar la plantilla
En la página Productos, 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 (un producto físico y un servicio) y todos los encabezados que Mosce ERP espera. Las columnas son:
| Columna | Obligatorio | Descripción |
|---|---|---|
name | Sí | Nombre del producto o servicio. |
sku | No | Código SKU interno. Clave principal de búsqueda de duplicados - se recomienda siempre incluirlo. |
reference | No | Referencia alternativa. Solo puede contener letras, números, guiones y guiones bajos. |
barcode | No | Código de barras (EAN-13, EAN-8 u otro). Si se deja vacío en un producto nuevo, Mosce ERP puede generarlo automáticamente. |
description | No | Descripción larga del producto. |
category | No | Nombre exacto de la categoría. Si la categoría no existe, la fila fallará la validación. |
unitPrice | Sí | Precio de venta (número decimal, por ejemplo 450.00). Debe ser mayor que cero. |
costPrice | No | Precio de costo (número decimal). Al crear un producto el costo es obligatorio en la ficha; en una importación que actualiza un producto existente, si dejas esta columna vacía se conserva el costo actual (la importación nunca borra un costo ya guardado). Solo se sobrescribe cuando indicas un valor. |
taxable | No | true si el producto está sujeto a impuestos, false si no. Por defecto true. |
type | No | PRODUCT para bien físico, SERVICE para servicio. Por defecto PRODUCT. |
unit | No | Unidad de medida (por ejemplo, UND, KG, LT, HR). |
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 del error (por ejemplo, "Precio de venta obligatorio", "Categoría no encontrada" o "Referencia con caracteres inválidos"). Puedes descargar el reporte completo con el botón Descargar errores.csv, corregir el archivo y volver a subirlo.
Los errores más comunes en importaciones de productos son:
unitPricevacío o con texto en vez de número.categorycon un nombre que no coincide exactamente con ninguna categoría existente (incluyendo mayúsculas/minúsculas).referencecon caracteres especiales no permitidos (espacios, puntos, comas).
Paso 3 - Confirmar la importación
Antes de cargar los datos, elige un modo:
- Crear registros nuevos solamente - si una fila coincide con un producto que ya existe (por SKU, código de barras o referencia), se descarta sin error. Útil para una carga inicial limpia.
- Crear nuevos y actualizar existentes - si una fila coincide con un producto existente, sus datos se actualizan. Si no hay coincidencia, se crea un producto nuevo.
Haz clic en Importar para comenzar. Al terminar, verás un resumen con la cantidad de productos creados y la cantidad de productos actualizados.
¿Cómo identifica Mosce ERP productos duplicados?
Mosce ERP compara cada fila de tu CSV con los productos existentes usando la siguiente lógica, en orden de prioridad:
- SKU (
sku): si el SKU coincide con un producto existente, se considera el mismo producto. - Código de barras (
barcode): si no hay SKU en la fila, Mosce ERP busca por código de barras. - Referencia (
reference): si tampoco hay código de barras, Mosce ERP busca por referencia interna. - Si no hay coincidencia por ninguno de los tres, el producto se crea como nuevo (modo Crear nuevos y actualizar existentes) o se descarta (modo Crear registros nuevos solamente).
Se recomienda siempre incluir el sku para evitar duplicados involuntarios.
Archivos grandes
Para productos, el límite de filas por archivo es estricto (ver tabla en "Límites"). Si tu archivo supera ese límite, Mosce ERP te mostrará un error y te pedirá dividirlo en archivos más pequeños y subirlos uno a uno. No es posible procesar archivos de productos en segundo plano por restricciones relacionadas con la generación automática de códigos.
Si tienes un catálogo muy grande, divide el CSV en lotes del tamaño máximo permitido por tu plan.
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).
¿Y los precios en otras monedas?
La importación de precios en múltiples monedas no está disponible por CSV. El campo unitPrice corresponde al precio base en la moneda principal configurada en tu cuenta. Los precios adicionales por moneda se configuran de forma individual desde la ficha de cada producto.
¿Puedo importar imágenes de productos? No. La importación por CSV no incluye imágenes. Para subir imágenes, abre la ficha individual de cada producto y usa el botón de carga de imagen.
¿Qué pasa con los acentos y la ñ en los nombres? 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.
¿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.
¿La categoría debe existir antes de importar?
Sí. El campo category acepta únicamente nombres de categorías que ya existen en tu cuenta. Si la categoría no existe, esa fila fallará en la validación. Crea primero las categorías (o importalas usando el asistente de importación de categorías) y luego importa los productos.
Relacionados
Última actualización: 2026-05-11