Importación masiva

El importador masivo carga en lazyit un inventario de activos existente desde un único archivo CSV o JSON. Está pensado para el primer día de una instancia nueva, cuando tu inventario todavía vive en una hoja de cálculo o en una herramienta heredada. Se accede desde Configuración → Importación masiva (es una acción de administrador ocasional, así que vive en Configuración y no en la barra lateral principal).

El importador es solo para administradores — requiere el permiso import:run, que los administradores tienen por defecto. Si no lo ves, pídele a un administrador que haga la importación.

Qué puedes importar hoy. Activos, las personas a las que está asignado cada uno, y esa asignación. Cuando tu archivo tiene una columna de “asignado a”, el importador crea la persona y le entrega el activo (consulta Asignar activos a personas más abajo). La importación de consumibles e historial aún no está disponible a propósito, y se indica como próximamente en el asistente.

El flujo de un vistazo

El importador es un asistente guiado. No se escribe nada en tus datos hasta el paso final de confirmación, e incluso entonces cada fila se vuelve a comprobar antes de guardarse.

1. Subir — elige qué vas a importar (Activos) y selecciona tu archivo.
2. Resumen — confirma el número de registros, la codificación y las columnas detectadas.
3. Mapeo — ve columna por columna: envía cada una a un campo de lazyit, guárdala como campo personalizado, o ignórala.
4. Vista previa — una simulación que valida cada fila sin escribir nada.
5. Conflictos — resuelve las referencias que coincidieron (o no) con registros existentes.
6. Confirmar — la importación se ejecuta y obtienes un informe de resultados.

Puedes volver Atrás en cualquier paso antes de confirmar para cambiar tus respuestas.

1. Sube tu archivo

Exporta tu hoja de cálculo como CSV (UTF-8), o proporciona un arreglo JSON de objetos. Cada fila (u objeto) se convierte en un activo.

• Los archivos .xlsx no se aceptan — expórtalos a CSV primero.
• El archivo se analiza en segundo plano; suele tardar unos segundos.
• Las columnas de solo fecha y cualquier columna de marca temporal created/updated/deleted se rechazan — esta primera fase importa el estado actual de un activo, no su historial.

2. Confirma el resumen

Tras el análisis, el importador muestra el número de registros, la codificación detectada, el delimitador y la lista de columnas que encontró. Úsalo para confirmar que el archivo se analizó como esperabas antes de dedicar tiempo al mapeo. Si encontró cero filas, vuelve y revisa el archivo.

3. Mapea tus columnas

El mapeo es por columna: el importador lista todas las columnas de tu archivo, cada una como su propia tarjeta que muestra el nombre de la columna y algunos valores de ejemplo tomados de tu archivo, para que sepas siempre qué estás viendo antes de decidir a dónde va.

Atención — esta pantalla muestra tus datos reales. Los valores de ejemplo se toman directamente del archivo, así que pueden incluir datos de empleados como nombres y correos. No se escribe nada en ningún sitio hasta la confirmación final; los valores solo se te muestran a ti, el operador que ejecuta la importación.

Para cada columna, ábrela y elige un destino en el desplegable:

• Un campo de lazyit, agrupado por entidad:
  • Activo — Nombre (obligatorio), Estado (obligatorio), Número de serie, Etiqueta de activo, Empresa, Fecha de compra, Fin de garantía, Modelo y Ubicación.
  • Modelo — Fabricante y Categoría para los modelos de activo que cree la importación (consulta Marca y categoría del modelo más abajo).
  • Persona — la persona a la que está asignado el activo: Nombre, Correo, Legajo, Usuario, Cargo, Departamento y Supervisor (consulta Asignar activos a personas más abajo).
• Crear un campo personalizado… — para una columna sin hogar nativo (RAM, IMEI, pulgadas, costo, una URL externa…). Le das un nombre y su valor se guarda en los detalles del activo (specs). Un campo personalizado se guarda solo en las filas que realmente tienen un valor — las celdas vacías no añaden nada.
• Ignorar — descartar la columna. Las columnas vacías e irrelevantes quedan en Ignorar por defecto, así que una exportación ancha con decenas de columnas sin uso no es un muro de trabajo; solo tocas las que importan.

Algunos campos se comportan de forma especial:

• Nombre y Estado son obligatorios: debes mapear una columna a cada uno antes de continuar.
• Los valores de Estado se concilian dentro de la tarjeta de esa columna — cada valor de estado distinto de tu archivo se asocia a un estado de lazyit (por ejemplo active → OPERATIONAL, retired → RETIRED). Los sinónimos comunes se completan por ti; cambia cualquiera.
• Número de serie es opcional pero importante: es la única clave natural del activo. Si lo mapeas, una nueva subida no creará duplicados de esas filas. Sin él, una nueva subida no se de-duplica.
• Etiqueta de activo — una etiqueta de tu archivo se usa tal cual; una en blanco se asigna automáticamente más tarde si tu instancia tiene un esquema de etiquetas activado.
• Modelo y Ubicación son referencias, asociadas a registros existentes por nombre (consulta Conflictos).
• Empresa es una etiqueta de agrupación opcional, tomada tal cual de tu archivo (una columna Empresa / Company se reconoce automáticamente). Agrupa y filtra activos — no es un control de acceso.

El importador pre-rellena una mejor suposición para cada columna, pero nunca decide por ti — confirmas cada columna, y nada se descarta en silencio. La suposición entiende más que los encabezados exactos en inglés: también reconoce nombres en español y estilo Snipe-IT (por ejemplo Nombre, Número de serie, Asignado a, Modelo), así que una exportación típica llega casi toda pre-mapeada. Aun así confirmas cada columna — la auto-detección solo propone el destino.

Marca y categoría del modelo

Un modelo se crea a partir de su nombre. Para que la importación cree modelos, mapea una columna a Modelo (dentro del grupo Activo). Mapear solo Fabricante o Categoría no crea un modelo — esos dos solo enriquecen un modelo que ya proviene de una columna Modelo mapeada. La categoría se vincula a través del modelo, no directamente al activo.

Cuando la importación crea un Modelo nuevo, necesita un fabricante y una categoría. Puedes definirlos de dos maneras:

• Por fila — mapea una columna a Fabricante o Categoría en el desplegable, y cada modelo toma su valor de esa fila.
• Para todos los modelos — si tu archivo no tiene esa columna (o todos tus activos son de la misma marca), fija un único Fabricante y/o Categoría en el recuadro Marca y categoría del modelo; se aplica a todos los modelos que cree la importación. Una columna mapeada siempre gana sobre un valor fijado.
  • Para Categoría, el recuadro viene en modo Existente: elige una categoría que ya exista para que todos los modelos se vinculen a ella — sin errores de tipeo ni categorías nuevas por accidente. Cambia el interruptor a Constante para escribir un valor libre (igual se busca-o-crea por nombre al importar).
  • El Fabricante es texto libre (no hay una lista de fabricantes para elegir), así que siempre es una constante.

Asignar activos a personas

Mapea cualquier campo de Persona y la importación, para cada fila, buscará o creará esa persona y le asignará el activo — la asignación se registra igual que se haría en la app, con historial.

• Una persona importada no tiene acceso. Es una persona de directorio: una entrada real en tu lista de Usuarios (con la insignia Directorio), pero sin cuenta en tu proveedor de identidad. Existe para que el activo tenga un propietario registrado; no puede iniciar sesión hasta tener cuenta.
• Para asignar, mapea el Nombre de la persona y una clave de identidad. El Nombre (la columna Asignado a) es obligatorio para asignar un activo, además de al menos uno de Correo, Legajo o Usuario para saber de quién es una fila (y para no crear dos veces a la misma persona). Si mapeas cualquier campo de Persona, el asistente no te deja continuar hasta que mapees tanto el Nombre como una clave de identidad. Una fila a la que le falta el nombre se marca como fila inválida en la vista previa, para que la corrijas antes de confirmar — nunca falla en silencio al final. Una fila con nombre pero sin clave de identidad importa el activo sin asignar, con una advertencia.
• Se vinculan a una cuenta real automáticamente — solo con un correo que coincida. Cuando esa persona inicie sesión más tarde a través de tu proveedor de identidad (OIDC) usando el mismo correo verificado, lazyit vincula ambas: la entrada de directorio pasa a ser su cuenta y la insignia Directorio desaparece. Una persona importada sin un correo real nunca se vincula automáticamente — no hay correo con el que coincidir. Promuévela a mano (siguiente punto) cuando necesite iniciar sesión.
• Puedes crear su cuenta ahora. Un administrador puede abrir la página de la persona y elegir Crear cuenta OIDC para aprovisionarla en el proveedor de identidad de inmediato, en vez de esperar a un inicio de sesión. El proveedor de identidad exige un correo real, así que el botón está deshabilitado hasta que la persona tenga uno — edita la persona y agrega un correo real primero.

El activo siempre se importa de cualquier modo; solo la asignación depende de identificar a la persona.

4. Vista previa (la simulación)

La simulación valida, normaliza y resuelve todas las filas — sin escribir nada. Obtienes:

• Un recuento de filas válidas e inválidas.
• Resultados por fila, con el error de validación exacto de cada fila inválida (para que corrijas el archivo).
• Colisiones de etiqueta de activo — cualquier etiqueta de tu archivo que ya pertenezca a un activo vigente se marca aquí, nunca se descarta en silencio.

Como la vista previa ejecuta las mismas comprobaciones que la confirmación, lo que ves es lo que obtendrás.

5. Resuelve los conflictos

Cuando tu archivo referencia un modelo o una ubicación por nombre, el importador busca un registro existente. Para cada valor distinto te muestra las coincidencias que encontró, el alcance (cuántas filas usan ese valor, con algunos números de fila de ejemplo) y te pide elegir uno de cuatro resultados:

• Vincular a un registro existente (match) — usar un registro vigente que ya existe.
• Restaurar un registro archivado (restore) — recuperar un registro archivado (eliminado de forma reversible) y vincularlo.
• Crear un registro nuevo (create) — crear uno nuevo. Solo se ofrece cuando no existe una coincidencia vigente. El registro nuevo se crea con valores por defecto razonables que puedes editar después.
• Omitir — dejar sin vincular (skip) — importar las filas sin ese vínculo.

lazyit nunca adivina por ti. Cuando más de un registro coincide con un valor, el conflicto se marca como ambiguo y debes elegir el registro concreto — el importador no seleccionará uno por ti. Resuelves cada valor distinto una vez, y esa elección se aplica a todas las filas que lo comparten.

6. Confirma y el resultado

Cuando el plan está listo, la importación se ejecuta en segundo plano. Es por lotes y reanudable, y sigue una regla de conservar lo parcial:

• Las filas correctas se conservan — un problema en una fila nunca revierte las que ya tuvieron éxito.
• Si alguien tomó un valor entre la vista previa y la confirmación, esa fila se registra como un fallo (no se descarta en silencio), y el resto continúa.

El informe de resultados muestra cuántas filas se crearon, fallaron y se omitieron, además del id de la ejecución de importación para tu auditoría. Si algunas filas fallaron, corrígelas en tu archivo y ejecuta el importador de nuevo — las filas ya importadas se omiten en una nueva ejecución (cuando hay un número de serie mapeado).

Bueno saberlo

• Es aditivo y auditado. El importador solo crea y vincula; nunca elimina ni sobrescribe tus activos existentes. Cada activo creado recibe una entrada de historial atribuida a ti.
• Las sesiones expiran. Una sesión de importación en curso se conserva 24 horas y luego se descarta. El registro de auditoría de una importación completada es permanente.
• Los permisos siguen aplicándose al confirmar. Más allá de import:run, crear un modelo o una ubicación nuevos durante un conflicto requiere el permiso de escritura correspondiente; el importador lo comprueba antes de escribir nada.