Importación y exportación de materiales

La importación y la exportación de materiales son por proveedor. Cada archivo se procesa sobre el proveedor seleccionado y respeta la unicidad de matrícula dentro de ese proveedor. Las categorías que el archivo consulta o crea pertenecen a la organización del proveedor seleccionado.

Dónde se inicia una importación

1. Ir a Materiales.
2. Abrir Más acciones y elegir Importar Excel.
3. Seleccionar el proveedor.
4. Elegir Ir a importación.
5. Subir el archivo .csv, .xls o .xlsx.
6. Elegir el modo de importación.

También se puede iniciar desde el detalle de un proveedor con la acción Importar Materiales.

Tutorial: importar materiales desde Excel

Exportar el catálogo de un proveedor

1. Ir a Materiales.
2. Abrir Más acciones y elegir Exportar Excel.
3. Seleccionar el proveedor.
4. Elegir el uso del archivo:
   • Actualizar este proveedor incluye los IDs de catálogo y de material.
   • Copiar a otro proveedor conserva el ID del material y omite el ID del catálogo de origen.
5. Elegir Exportar Excel para descargar el catálogo.

El archivo incluye un título, la fecha de exportación, una nota de uso y luego el encabezado de datos. Sólo incluye materiales del proveedor seleccionado. Los archivos portables agregan _para_copiar en su nombre para distinguirlos.

Tutorial: exportar el catálogo de materiales de un proveedor

Elegir el modo de importación

Actualizar este proveedor

Es el modo predeterminado:

• si una fila conserva id_catalogo, actualiza exactamente esa asociación del proveedor seleccionado;
• id_material identifica los datos técnicos compartidos y debe corresponder a un material ya asociado al proveedor;
• si la fila no tiene IDs, crea el material y su asociación inicial;
• si esa matrícula pertenecía a un material eliminado y está libre, crea un material nuevo; el anterior permanece en el historial y no se recupera por coincidencia de matrícula;
• si un ID no corresponde al proveedor o a la organización seleccionados, rechaza la fila;
• si la matrícula ya existe y la fila no tiene IDs, rechaza la fila para evitar una actualización accidental.

Copiar catálogo desde otro proveedor

Usá Copiar a otro proveedor al exportar el catálogo del proveedor A. Luego importá ese archivo en el proveedor B con Copiar catálogo desde otro proveedor, sin modificar el Excel:

• conserva id_material para asociar al proveedor destino el mismo material técnico;
• ignora el ID del catálogo de origen;
• crea una asociación por fila válida no omitida, con la matrícula y disponibilidad indicadas;
• omite las matrículas que ya existen en el proveedor destino y los materiales que ya están asociados a él.
• no copia stock, lotes, precios, números de serie ni movimientos.

La misma matrícula puede existir en proveedores diferentes porque su unicidad se controla dentro de cada proveedor.

Columnas del archivo

Las columnas numero_matricula y nombre son requeridas para reconocer el archivo. Además, para crear o actualizar un material, cada fila debe resolver una categoría mediante categoria o id_categoria. Copiar un material existente por id_material no modifica su categoría ni sus demás datos técnicos.

Columna	Estado	Alias soportados	Regla
numero_matricula	Requerida	registration_number, matricula	Debe ser única dentro del proveedor
id_catalogo	Opcional	material_provider_id	En Actualizar, identifica la asociación exacta del proveedor. Se omite en el archivo para copiar
id_material	Opcional	material_id, id	Identifica el material técnico compartido. En Copiar catálogo, permite asociar el mismo material al proveedor destino
nombre	Requerida	name	Nombre del material
rotacion	Opcional	turnover_rate	Acepta alta/media/baja y también high/medium/low
categoria	Alternativa a id_categoria	material_category	Puede ser ID existente, nombre exacto o ruta jerárquica de la organización del proveedor; el nombre simple crea raíz si no existe
id_categoria	Alternativa a categoria	material_category_id, categoria_id	Si se informa junto con categoria, ambos deben identificar la misma categoría
unidad	Opcional	unit	Si no existe, se crea automáticamente con Admite decimales desactivado
tipo	Opcional	kind	Acepta regular, serialized, bulk o consumible
catalogo_activo	Opcional	catalog_active, active, activo	Define si la asociación está disponible para nuevas operaciones. Acepta Sí/No, True/False o 1/0
material_activo	Opcional	material_active	Define el estado general del material. Acepta Sí/No, True/False o 1/0

info

Las filas completamente vacías se omiten. Si una fila trae datos, se valida y puede generar error.

Reglas de validación

• Si falta una columna requerida, la importación falla.
• Si una matrícula aparece duplicada dentro del mismo archivo, se reporta con número de filas.
• En Actualizar, si la fila conserva los IDs exportados, se actualizan la asociación y los datos técnicos correspondientes.
• En Actualizar, omitir unidad o rotacion, o dejar sus valores vacíos, borra esos datos del material compartido; no conserva los anteriores. Para mantenerlos, conservá las columnas y sus valores del archivo exportado.
• En Actualizar, si una fila sin IDs usa una matrícula existente, se informa el error y se indica que deben conservarse los IDs para actualizar.
• En Actualizar, un id_catalogo de otro proveedor o un id_material no asociado se rechaza sin modificar registros ajenos.
• En Copiar catálogo, id_material se conserva e id_catalogo se ignora. Las matrículas existentes y los materiales ya asociados al proveedor destino se contabilizan como omitidos, no como errores.
• Si categoria es un nombre simple y no existe, se crea como categoría raíz.
• Si categoria es ambigua, se debe informar la ruta completa o el ID.
• Si categoria viene como ruta, se resuelve nivel por nivel y puede crear categorías faltantes. El separador recomendado es /; también se acepta >.
• Resolver una categoría por nombre o ruta puede restaurarla si fue eliminada y reactivarla si está inactiva. Las referencias por ID no aplican esa misma restauración y reactivación.
• Si una fila crea una unidad nueva, queda configurada sin admitir decimales. Para habilitarlos hay que editar la unidad después de la importación; una unidad existente conserva su configuración.
• Si el proveedor no existe o el archivo no tiene formato válido, la importación falla.

Ejemplos de categoría

• 15: usa la categoría con ID 15 si pertenece a la organización del proveedor seleccionado.
• Transformadores: si no existe, crea una categoría raíz con ese nombre.
• Destornilladores: usa esa categoría sólo si no hay otra con el mismo nombre en otra rama.
• Materiales Eléctricos/Accesorios/Empalmes/Terminales: reutiliza los nodos existentes y crea los faltantes en orden.

Procesamiento e historial

Cada carga se procesa en segundo plano y queda en historial con:

• estado (Pendiente, Procesando, Terminado, Fallido),
• archivo original,
• modo elegido (Actualizar proveedor o Copiar catálogo),
• cantidad importada,
• cantidad omitida,
• cantidad de errores,
• mensajes detallados.

Esto permite auditar qué se cargó y corregir archivos en iteraciones sucesivas sin perder trazabilidad.