Cargar tus activos

Esta página está escrita sobre todo para el agente de IA que hace la carga. Si eres una persona, basta con que conectes tu agente, adjuntes tu Excel y le digas "Cárgame mi lista de activos en zensset".

La carga en lote (herramienta asset_upsert, operación bulk_load) la puede hacer un Propietario o un Administrador del sitio. Los activos quedan habilitados directamente, sin pasar por las reglas de aprobación, y el historial registra que fueron una carga inicial y quién la hizo.

Todas las herramientas de zensset reciben { operation, items: [ ... ] }: un ítem por cosa que leer o cambiar.

1. Qué pide zensset por activo

2. Clasificación y nivel

• Lee la lista real del sitio con reference_list_query (lista classification). No inventes clasificaciones.
• Elige por el nombre y la descripción de cada activo. Agrupa: "estas 40 son bombas centrífugas".
• Si hay dos candidatas razonables, pregunta al usuario.
• Si falta una clasificación que el usuario necesita, propón crearla con reference_list_upsert (lista classification).
• Nivel: equipment_unit para equipos completos; subunit o maintainable_item para los que tienen padre.

3. Jerarquía

El Excel puede traer la jerarquía de muchas formas: una columna "Pertenece a" con el nombre del padre, códigos con un prefijo común, filas indentadas u hojas separadas.

• Reconócela y resuelve cada padre a su código: el de otra fila del mismo Excel o el de un activo que ya existe en el sitio (asset_query, operaciones get_by_code o search).
• Muestra el árbol propuesto al usuario y pregunta por los padres que no encuentres o que sean ambiguos (dos activos con el mismo nombre).
• Pasa el código del padre en parent_code. Dentro de un lote no importa el orden: zensset crea los padres antes que los hijos. Entre lotes, carga primero los padres.
• El hijo cuelga del padre a través de un grupo funcional del padre: el que indiques en functional_group_code, o "Componentes" si no indicas ninguno.
• Un hijo toma la ubicación de su padre: no le pases location_id.
• Si un padre falla, sus hijos también fallan con parent_failed.

4. Columnas típicas

5. El protocolo, en este orden

1. Lee el Excel y resume qué trae: cuántas filas, qué columnas, la calidad de los datos.
2. Propón el mapeo columna → campo, y di qué columnas no se usan y por qué.
3. Recomienda columnas del Excel que conviene cargar aunque no sean obligatorias.
4. Propón la clasificación por grupo de activos y la jerarquía; pregunta lo dudoso.
5. Si el Excel trae áreas que no existen como ubicaciones, propón crearlas (location_upsert) y espera el visto bueno.
6. Corre asset_upsert con operation: "bulk_load" y un ítem { rows, dry_run } en modo de prueba (dry_run: true, que es el valor por defecto) y muéstrale al usuario el resultado: qué entraría (would_create), el árbol (tree), las marcas nuevas (brands_created) y los errores.
7. Corrige con el usuario y carga de verdad con dry_run: false, en lotes de hasta 100 filas. Si una carga real deja filas sin entrar, reenvía solo esas filas, no el archivo completo: las que ya entraron fallarían como duplicate_code y arrastrarían a sus hijos.
8. Reporta el total cargado y las filas que no entraron, con su motivo.

6. Duplicados

• Código repetido (duplicate_code): ya existe en el sitio o está dos veces en el lote. No se sobrescribe: pregunta al usuario qué hacer.
• Serie parecida (duplicate_serial): ya hay un activo con la misma marca, clasificación y serie. Muéstralo al usuario; si confirma que es otro equipo, reenvía la fila con duplicate_reason.

7. Errores y qué hacer

Cada fila que no entra trae un error_code y un mensaje en español. Las demás filas del lote entran igual.

8. Qué no hacer

• No inventes códigos ni clasificaciones.
• No cargues sin mostrar antes el resultado de dry_run.
• No elijas clasificación ni padre sin preguntar cuando hay ambigüedad.