Importar categorías

Si tienes un catálogo con muchas categorías y subcategorías - de productos, de servicios, de artículos de inventario - el botón Importar te permite cargar toda la estructura de un solo paso en lugar de crearlas una a una. Mosce ERP valida el archivo antes de guardar nada.

Importar las categorías antes que los productos es especialmente útil: de esa forma, cuando importes el catálogo de productos, los nombres de categoría ya existen y la validación pasa sin problemas.

Antes de empezar

• Necesitas el permiso categories:bulk-import. Si no aparece el botón Importar en la barra de herramientas de la lista de categorías, 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 Categorías, 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 (una categoría raíz y una subcategoría) 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. 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 coincide con una categoría que ya existe (por nombre), se descarta sin error.
• Crear nuevos y actualizar existentes - si una fila coincide con una categoría existente, su descripción, orden y estado se actualizan.

Haz clic en Importar para comenzar. Al terminar, verás un resumen con la cantidad de categorías creadas y actualizadas.

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 categorías duplicadas?

Mosce ERP identifica categorías por su nombre. Internamente, deriva un identificador único a partir del nombre (sin acentos, en minúsculas, con guiones). Dos categorías con el mismo nombre - sin importar bajo qué categoría padre estén - se consideran el mismo registro. Si necesitas dos categorías con nombre idéntico en distintos niveles del árbol (ej. "Ropa" como categoría principal y "Ropa" como subcategoría de "Bebés"), tendrás que renombrar una de las dos antes de importar (ej. "Ropa" y "Ropa para bebés").

¿Cómo importo una categoría hija?

Para asignar una categoría padre debes conocer su ID - un identificador único que Mosce ERP genera cuando crea la categoría. La forma más confiable de obtenerlo es exportar tus categorías existentes y copiar el valor de la columna id del archivo resultante.

Pasos:

1. Desde la página Categorías, usa el botón Exportar para descargar tus categorías actuales en CSV.
2. Abre el archivo exportado y localiza la columna id de la categoría que quieres usar como padre.
3. Copia ese valor (tendrá un formato similar a clxyz123abc456def789ghi) y pégalo en la columna parentId de las filas que serán sus hijas.

Ejemplo:

name,description,parentId,sortOrder,isActive
Ropa,Prendas de vestir,,1,true
Camisetas,Camisetas de hombre y mujer,clxyz123abc456def789ghi,1,true

(Reemplaza clxyz123abc456def789ghi con un ID real exportado de Mosce ERP.)

La categoría padre debe existir en Mosce ERP antes de la importación - si no existe, esa fila fallará la validación.

Límites

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.

¿Hasta qué nivel de jerarquía puedo importar? Mosce ERP no impone un límite de niveles en la jerarquía de categorías. Puedes crear subcategorías de subcategorías usando la columna parentId encadenada. Asegúrate de que cada categoría padre esté definida antes (o ya exista en Mosce ERP) antes de referenciarla.

¿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

• Importar productos
• Importar categorías de gastos

Última actualización: 2026-05-11