Activos e inventario

Importación masiva

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.
  • Un archivo exportado por lazyit lleva una pequeña línea # lazyit vX.Y.Z … al inicio que registra la versión que lo generó. Si esa versión es de una versión mayor más nueva que el servidor en el que importas, la subida se rechaza con un mensaje claro — actualiza este servidor (o re-exporta desde una versión compatible) antes de importar. Las hojas de cálculo o archivos de terceros habituales no tienen esa línea y se importan con normalidad.
  • Si el análisis en segundo plano no puede terminar — normalmente un archivo demasiado grande o complejo para procesar — la subida se marca como fallida con un mensaje en lugar de quedarse esperando; divide o simplifica el archivo y vuelve a subirlo. También se rechaza una columna llamada literalmente __proto__: renómbrala antes.

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.

Si alguna fila de tu archivo tuvo una cantidad de columnas distinta a la del encabezado — lo más común es un delimitador sin escapar dentro de una celda de texto (por ejemplo un ; dentro de un valor de Notas en un archivo delimitado por ;) — esta pantalla muestra una advertencia con cuántas filas se vieron afectadas. Es informativa, no bloqueante: el importador igual tolera el desajuste (las filas cortas reciben celdas vacías, las celdas de más se descartan), pero un delimitador corrido puede empujar en silencio un valor posterior — como el número de serie — al campo equivocado. Si ves esta advertencia, revisá las filas señaladas en tu archivo de origen en busca de delimitadores sueltos o comillas desbalanceadas antes de continuar.

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, Notas, Fecha de compra, Fin de garantía, Costo de compra, Vida útil (meses), Valor residual, Modelo y Ubicación.
    • Modelo — Fabricante, Categoría y SKU / número de modelo para los modelos de activo que cree la importación (consulta Marca, categoría y SKU 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.

¿Cambiaste de idea sobre una columna ignorada? Abre su tarjeta y hacé clic en Usar el nombre de la columna como campo personalizado — se convierte en un campo personalizado con el nombre de la columna, sin escribir nada (el nombre queda editable después). Si varias columnas valen la pena, el aviso arriba de la lista ofrece Usar nombres de columna en todas las ignoradas para convertir de una vez todas las columnas que sigan ignoradas.

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 —incluidas las etiquetas de estado de Snipe-IT como Deployed, Ready to Deploy, Archived, Broken y etiquetas personalizadas como Nueva (deployed) (se lee la palabra meta entre paréntesis)—; cambia cualquiera. Lo que siga sin reconocerse se marca en la vista previa, nunca se descarta en silencio.
  • 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 — un Modelo con SKU se asocia primero por SKU y luego 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.
  • Notas es texto libre opcional, tomado tal cual (una columna Notas / Notes / Observaciones se reconoce automáticamente).
  • Costo de compra y Valor residual son montos, cargados en tu archivo en moneda entera (dólares, pesos…), no en centavos — la importación los convierte a las unidades menores almacenadas. Lee los formatos habituales: símbolo de moneda, separadores de miles y cualquiera de los dos estilos decimales — 1,234.56, 1.234,56 y $1,000.00 funcionan. Las celdas en blanco quedan sin valor (no en cero); un valor que no puede leer como número se marca en la previsualización, nunca se adivina.
  • Vida útil (meses) es el período de depreciación lineal, como número entero de meses.
  • Fecha de compra y Fin de garantía son fechas, y cada columna de fecha lleva su propio selector de formato de fecha en su tarjeta — Automático, DMY (día / mes / año), MDY (mes / día / año) o ISO (AAAA-MM-DD). Importa porque 03/04/2024 es el 3 de abril en algunos países y el 4 de marzo en otros. Automático lee la columna y decide: si algún primer número es mayor que 12 solo puede ser un día, así que la columna se lee día primero (DMY); una columna AAAA-MM-DD pura se lee como ISO; una columna ambigua por lo demás recae en DMY (el caso común de las migraciones). La tarjeta muestra el formato detectado y una vista previa en vivo de cómo se interpreta el primer valor, para que puedas cambiarlo antes de continuar. Un valor que no coincide con el formato elegido se marca en la vista previa — nunca se desplaza al día equivocado.

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, categoría y SKU 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, Categoría o SKU / número de modelo no crea un modelo — esos tres 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, puede tomar un fabricante, una categoría y un SKU / número de modelo (por ejemplo, la columna “Model No.” de Snipe-IT: Latitude 5520 como Modelo, P108F como su SKU). Fabricante y categoría tienen un valor por defecto de fase 1 (ver abajo); el SKU es opcional y queda vacío si no lo mapeas ni lo fijas. Puedes definir cada uno de dos maneras:

  • Por fila — mapea una columna a Fabricante, Categoría o SKU / número de modelo 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 comparten marca, categoría o SKU), fija un único Fabricante, Categoría y/o SKU en el recuadro Marca, categoría y SKU 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 y el SKU son texto libre (no hay una lista para elegir), así que siempre son una constante.
  • Mapear una columna de SKU refuerza el emparejamiento. Un modelo con SKU se empareja primero por SKU en futuras importaciones y ediciones — es la clave natural más confiable del modelo, por delante de su nombre.

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 de acceso. 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.
  • Con tu propio proveedor OIDC, 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 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 darle una cuenta ahora. Con cuentas locales, un administrador puede abrir la página de la persona y elegir Dar de alta con una contraseña temporal: crea su acceso al momento y muestra una contraseña de un solo uso para entregar — no hace falta correo. Con tu propio proveedor OIDC, lazyit no puede crear cuentas allí: crea a la persona en tu proveedor con un correo real y verificado, asegúrate de que ese mismo correo figure en su registro de lazyit, y su primer inicio de sesión vincula ambas.

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.
  • Un resumen «Por qué se excluyeron filas» que agrupa las filas inválidas por el campo que falló (por ejemplo «12 filas — campo status» con el valor problemático), para que no puedas confirmar sin notar que se descartó toda una clase de filas.
  • Resultados por fila, con el error de validación exacto de cada fila inválida (para que corrijas el archivo).
  • Activos que ya existen — cuando el número de serie de una fila coincide con un activo que ya está en lazyit, la vista previa la marca como una actualización: ese activo se sobrescribe con los valores del archivo en vez de crearse de nuevo (consulta Reimportar actualiza los activos existentes más abajo). El recuento te dice de antemano cuántos activos vigentes cambiaría una confirmación.
  • 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.
  • Si el propio trabajo en segundo plano sufre un error transitorio (por ejemplo, una caída breve de la base de datos), reintenta automáticamente y continúa después de las filas ya guardadas. La importación se marca como fallida solo cuando se agotan los reintentos.

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 (consulta Reimportar actualiza los activos existentes más abajo).

Reimportar actualiza los activos existentes

Volver a ejecutar una importación es idempotente cuando hay un número de serie mapeado: una fila cuyo serie coincide con un activo que ya está en lazyit actualiza ese activo en su lugar en vez de crear un duplicado. Los campos mapeados se sobrescriben con los valores del archivo, y el cambio queda registrado en el historial del activo como un evento Actualizado marcado como reimportación. El recuento «Algunos activos ya existen» de la vista previa te dice cuántas filas actualizarán activos vigentes antes de confirmar, así que nunca es una sorpresa.

Precaución — esto cambia datos vigentes. Una actualización sobrescribe los valores actuales del activo coincidente con los de tu archivo: un valor distinto reemplaza al vigente (una celda en blanco deja el campo intacto en vez de borrarlo). Revisa el recuento de actualizaciones de la vista previa y mantén tu archivo como la fuente autoritativa antes de confirmar. Las filas cuyo serie no coincide con nada se crean igualmente; las filas sin serie mapeado nunca se de-duplican, así que una nueva ejecución sin columna de serie crea duplicados.

Bueno saberlo

  • Es auditado, e idempotente por número de serie. El importador crea y vincula registros nuevos y, cuando el serie de una fila coincide con un activo existente, actualiza ese activo en su lugar (nunca elimina). Cada activo creado o actualizado recibe una entrada de historial atribuida a ti — consulta Reimportar actualiza los activos existentes más arriba.
  • 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, igual que la categoría que trae consigo un modelo nuevo; el importador lo comprueba antes de escribir nada.