Saltar a contenido

Fracttal ETL Hub Documentation

Update Item Custom Fields

Update Item Custom Fields

Modelo para actualizar los campos personalizados de un item. Permite actualizar por id_custom_field o por label_name.

Información general:

Module	Category
`Items`	`Update`

UpdateItemCustomFields

Parámetros:

code: str, requerido Código del item.
id_custom_field: int, opcional ID del campo personalizado.
label_name: str, opcional Nombre del campo personalizado.
value: Any, requerido Valor a actualizar.
id_type_item: str, opcional Tipo de item.

Parámetros de entrada:

Campo	Tipo	Obligatorio	Descripción	Default Value	Examples
`code`	str	✅	Código del item.	`PydanticUndefined`	None
`id_type_item`	Optional[str]	❌	Tipo de item.	`None`	None
`field_1`	str	✅	Nombre del activo.	`PydanticUndefined`	None
`field_2`	Optional[str]	❌	Dirección / Fabricante / Número de parte / Número de parte / Fabricante (según tipo de activo)	`None`	None
`field_3`	Optional[str]	❌	Ciudad / Modelo / Fabricante / Fabricante / Número de serial (según tipo de activo)	`None`	None
`field_4`	Optional[str]	❌	Código de área / Número de serial / Modelo / Modelo / Versión (según tipo de activo)	`None`	None
`field_5`	Optional[str]	❌	Departamento / Estado / Región / Otro 1 / Otro 1 / Otro 1	`None`	None
`field_6`	Optional[str]	❌	País / Otro 2 / Otro 2 / Otro 2	`None`	None
`active`	Optional[bool]	❌	Indica si el activo está activo o no. Valores: True, False	`None`	None
`barcode`	Optional[str]	❌	Código de barras.	`None`	None
`notes`	Optional[str]	❌	Notas del activo.	`None`	None
`weight`	Optional[str]	❌	Peso del activo (solo para repuestos y herramientas)	`None`	None
`purchase_date`	Optional[str]	❌	Fecha de compra. Formato: 'YYYY-MM-DDTHH:MM:SS-UTC'	`None`	None
`is_serial_control`	Optional[bool]	❌	true si el item es controlado por serial, false en caso contrario. Valores: True, False	`None`	None
`group`	Optional[str]	❌	Tipo de activo.	`None`	None
`group_1`	Optional[str]	❌	Clasificación 1.	`None`	None
`group_2`	Optional[str]	❌	Clasificación 2.	`None`	None
`priorities`	Optional[str]	❌	Descripción de la prioridad.	`None`	None
`id_priority`	Optional[Priority]	❌	Id de la prioridad: 1: Muy Alta, 2: Alta, 3: Media, 4: Baja, 5: Muy baja	`None`	None
`code_parent_location`	Optional[str]	❌	Código del activo donde está ubicado o es parte de (POST/PUT)	`None`	None
`latitude`	Optional[str]	❌	Latitud.	`None`	None
`longitud`	Optional[str]	❌	Longitud.	`None`	None
`unit_code`	Optional[str]	❌	Código de la unidad (obligatorio si es Herramienta o Repuesto)	`None`	None
`unit_description`	Optional[str]	❌	Descripción de la unidad (obligatorio si es Herramienta o Repuesto)	`None`	None
`visible_to_all`	Optional[bool]	❌	Indica si el activo será visible para todos en la compañía. Valores: True, False	`None`	None
`total_cost`	Optional[str]	❌	Costo total del activo.	`None`	None
`startup_date`	Optional[str]	❌	Fecha de inicio para la depreciación. Formato: 'YYYY-MM-DDTHH:MM:SS-UTC'	`None`	None
`costs_center`	Optional[str]	❌	Descripción del centro de costos.	`None`	None
`budgets`	Optional[str]	❌	Costo total de la depreciación lineal.	`None`	None
`id_custom_field_group`	Optional[int]	❌	Id de grupo de campos personalizados.	`None`	None
`hours_average_daily_use`	Optional[int]	❌	Horas de uso promedio diario (segundos, entre 0 y 86400)	`None`	None
`id_custom_field`	Optional[int]	❌	ID del campo personalizado.	`None`	None
`label_name`	Optional[str]	❌	Nombre del campo personalizado.	`None`	None
`value`	Any	✅	Valor a actualizar.	`PydanticUndefined`	None

Ejemplo de uso:

[
  {
    "code": "A12345",
    "id_custom_field": 1,
    "value": "Nuevo valor"
  }
]

Notas:

Si se incluyen ambos, se dará prioridad a id_custom_field. Si label_name tiene más de una coincidencia, retorna error 409.

Relacionado: