Get Item

Nota: Este átomo permite consultar activos en Fracttal vía API oficial.

Descripción

Integra la actualización de inventario con la API Fracttal.

Este átomo realiza la petición técnica al endpoint oficial y retorna el resultado. Para estructura de datos, parámetros y ejemplos actualizados, consulta: - https://api.fracttal.com/reference/consultar-un-activo

Endpoint API: GET https://app.fracttal.com/api/items/

Información general:

Módulo	Categoría
`Item`	`Read`

Detalles del átomo

Parámetros de entrada:

code : str, opcional Código único del activo a consultar.
id : int, opcional ID del activo en Fracttal.
item_type : str, opcional Tipo de activo (1: Ubicaciones, 2: Equipos, 3: Herramientas, 4: Repuestos y Suministros, 5: Digital).
active : bool, opcional Indica si el activo está activo o no. Valores: True, False
location_code : str, opcional Código de ubicación padre.
available : bool, opcional Indica si el activo está en servicio.
start : int, opcional Número de registro donde iniciará la consulta (paginación). Por defecto 0.
limit : int, opcional Cantidad de registros que mostrará la petición. Por defecto 100.
field_1 : str, opcional Nombre, descripción o título principal del activo.
field_2 : str, opcional Campo adicional para información complementaria (ejemplo: marca).
field_3 : str, opcional Campo adicional para información complementaria (ejemplo: modelo).
field_4 : str, opcional Campo adicional para información complementaria (ejemplo: serial).
field_5 : str, opcional Campo adicional para estado, condición u otra clasificación.
field_6 : str, opcional Campo adicional para país, origen u otra información relevante.

Esquema de entrada:

Campo	Tipo	Obligatorio	Descripción	Por defecto	Ejemplo
`code`	Optional[str]	❌	Código único del activo a consultar.	`None`	-
`id_type_item`	ItemType	✅	Tipo de activo.	`PydanticUndefined`	-
`field_1`	Optional[str]	❌	Nombre, descripción o título principal del activo.	`None`	-
`field_2`	Optional[str]	❌	Campo adicional para información complementaria (ejemplo: marca).	`None`	-
`field_3`	Optional[str]	❌	Campo adicional para información complementaria (ejemplo: modelo).	`None`	-
`field_4`	Optional[str]	❌	Campo adicional para información complementaria (ejemplo: serial).	`None`	-
`field_5`	Optional[str]	❌	Campo adicional para estado, condición u otra clasificación.	`None`	-
`field_6`	Optional[str]	❌	Campo adicional para país, origen u otra información relevante.	`None`	-
`active`	Optional[bool]	❌	Indica si el activo está activo o no.	`None`	-
`barcode`	Optional[str]	❌	Código de barras.	`None`	-
`notes`	Optional[str]	❌	Notas del activo.	`None`	-
`weight`	Optional[str]	❌	Peso del activo (solo para repuestos y herramientas)	`None`	-
`purchase_date`	Optional[str]	❌	Fecha de compra. Formato: 'YYYY-MM-DDTHH:MM:SS-UTC'	`None`	-
`is_serial_control`	Optional[bool]	❌	true si el item es controlado por serial, false en caso contrario. Valores: True, False	`None`	-
`group`	Optional[str]	❌	Tipo de activo.	`None`	-
`group_1`	Optional[str]	❌	Clasificación 1.	`None`	-
`group_2`	Optional[str]	❌	Clasificación 2.	`None`	-
`priorities`	Optional[str]	❌	Descripción de la prioridad.	`None`	-
`id_priority`	Optional[Priority]	❌	Id de la prioridad: 1: Muy Alta, 2: Alta, 3: Media, 4: Baja, 5: Muy baja	`None`	-
`code_parent_location`	Optional[str]	❌	Código del activo donde está ubicado o es parte de (POST/PUT)	`None`	-
`latitude`	Optional[str]	❌	Latitud.	`None`	-
`longitud`	Optional[str]	❌	Longitud.	`None`	-
`unit_code`	Optional[str]	❌	Código de la unidad (obligatorio si es Herramienta o Repuesto)	`None`	-
`unit_description`	Optional[str]	❌	Descripción de la unidad (obligatorio si es Herramienta o Repuesto)	`None`	-
`visible_to_all`	Optional[bool]	❌	Indica si el activo será visible para todos en la compañía. Valores: True, False	`None`	-
`total_cost`	Optional[str]	❌	Costo total del activo.	`None`	-
`startup_date`	Optional[str]	❌	Fecha de inicio para la depreciación. Formato: 'YYYY-MM-DDTHH:MM:SS-UTC'	`None`	-
`costs_center`	Optional[str]	❌	Descripción del centro de costos.	`None`	-
`budgets`	Optional[str]	❌	Costo total de la depreciación lineal.	`None`	-
`id_custom_field_group`	Optional[int]	❌	Id de grupo de campos personalizados.	`None`	-
`hours_average_daily_use`	Optional[int]	❌	Horas de uso promedio diario (segundos, entre 0 y 86400)	`None`	-
`id`	Optional[int]	❌	ID del activo en Fracttal.	`None`	-
`item_type`	Optional[str]	❌	Tipo de activo (1: Ubicaciones, 2: Equipos, 3: Herramientas, 4: Repuestos y Suministros, 5: Digital).	`None`	-
`location_code`	Optional[str]	❌	Código de ubicación padre.	`None`	-
`available`	Optional[bool]	❌	Indica si el activo está en servicio.	`None`	-
`start`	Optional[int]	❌	Número de registro donde iniciará la consulta (paginación). Por defecto 0.	`None`	-
`limit`	Optional[int]	❌	Cantidad de registros que mostrará la petición. Por defecto 100.	`None`	-

Detalles técnicos:

Soporta consultas individuales por código o búsquedas paginadas con filtros.
Utiliza los campos heredados de BaseAssetModel para filtros comunes.
La paginación se controla con los parámetros start y limit.