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.

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.

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.

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 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, con la matrícula y disponibilidad indicadas;
• omite las matrículas que ya existen en el proveedor destino, sin sobrescribirlas ni reactivarlas;
• 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

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	Opcional	material_category	Puede ser ID existente, nombre exacto o ruta jerárquica; el nombre simple crea raíz si no existe
id_categoria	Opcional	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, 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, id_catalogo se ignora y las matrículas existentes se contabilizan como omitidas, 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 >.
• 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.
• 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.