Item Upsert

Modelo para la inserción de activos. Todos los campos alineados con el schema ETLConnectionsFracttal.json.

---

Información general:

Module	Category
Items	Update and Create

---

ItemUpInsert

Parámetros:

• code: str (requerido) Código único del activo.
• id_type_item: str (requerido) Tipo de activo.
• field_1: str (requerido) Nombre o descripción principal del activo.
• field_2: str, opcional Campo adicional 2.
• field_3: str, opcional Campo adicional 3.
• field_4: str, opcional Campo adicional 4.
• field_5: str, opcional Campo adicional 5.
• field_6: str, opcional Campo adicional 6.
• active: str, opcional Estado del activo.
• barcode: str, opcional Código de barras.
• notes: str, opcional Notas o comentarios.
• weight: str, opcional Peso del activo.
• is_serial_control: str, opcional Control de seriales.
• group: str, opcional Grupo principal.
• group_1: str, opcional Subgrupo 1.
• group_2: str, opcional Subgrupo 2.
• id_priority: str, opcional Prioridad.
• code_parent_location: str, opcional Código de ubicación padre.
• latitude: str, opcional Latitud.
• longitud: str, opcional Longitud.
• unit_code: str, opcional Código de unidad.
• unit_description: str, opcional Descripción de la unidad.
• visible_to_all: str, opcional Visibilidad global.
• purchase_date: str, opcional Fecha de compra.
• total_cost: str, opcional Costo total.
• startup_date: str, opcional Fecha de puesta en marcha.
• costs_center: str, opcional Centro de costos.
• budgets: str, opcional Presupuesto asociado.
• id_custom_field_group: str, opcional ID de grupo de campos personalizados.

Parámetros de entrada:

Campo	Tipo	Obligatorio	Descripción	Default Value	Examples
code	str	✅	Código único del activo.	PydanticUndefined	None
id_type_item	str	✅	Tipo de activo.	PydanticUndefined	None
field_1	str	✅	Nombre o descripción principal del activo.	PydanticUndefined	None
field_2	Optional[str]	❌	Campo adicional 2.	None	None
field_3	Optional[str]	❌	Campo adicional 3.	None	None
field_4	Optional[str]	❌	Campo adicional 4.	None	None
field_5	Optional[str]	❌	Campo adicional 5.	None	None
field_6	Optional[str]	❌	Campo adicional 6.	None	None
active	Optional[str]	❌	Estado del activo.	None	None
barcode	Optional[str]	❌	Código de barras.	None	None
notes	Optional[str]	❌	Notas o comentarios.	None	None
weight	Optional[str]	❌	Peso del activo.	None	None
purchase_date	Optional[str]	❌	Fecha de compra.	None	None
is_serial_control	Optional[str]	❌	Control de seriales.	None	None
group	Optional[str]	❌	Grupo principal.	None	None
group_1	Optional[str]	❌	Subgrupo 1.	None	None
group_2	Optional[str]	❌	Subgrupo 2.	None	None
priorities	Optional[str]	❌	Descripción de la prioridad.	None	None
id_priority	Optional[str]	❌	Prioridad.	None	None
code_parent_location	Optional[str]	❌	Código de ubicación padre.	None	None
latitude	Optional[str]	❌	Latitud.	None	None
longitud	Optional[str]	❌	Longitud.	None	None
unit_code	Optional[str]	❌	Código de unidad.	None	None
unit_description	Optional[str]	❌	Descripción de la unidad.	None	None
visible_to_all	Optional[str]	❌	Visibilidad global.	None	None
total_cost	Optional[str]	❌	Costo total del activo.	None	None
startup_date	Optional[str]	❌	Fecha de puesta en marcha.	None	None
costs_center	Optional[str]	❌	Centro de costos.	None	None
budgets	Optional[str]	❌	Presupuesto asociado.	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

Ejemplo de uso:

{
  "code": "A12345",
  "id_type_item": 2,
  "field_1": "Motor principal",
  "active": true,
  "barcode": "1234567890",
  "notes": "Activo en operación",
  "weight": "120kg",
  "is_serial_control": false,
  "group": "Motores",
  "group_1": "Industriales",
  "group_2": "Alta potencia",
  "id_priority": "2",
  "code_parent_location": "LOC001",
  "latitude": "-33.4489",
  "longitud": "-70.6693",
  "unit_code": "U001",
  "unit_description": "Unidad estándar",
  "visible_to_all": true,
  "purchase_date": "2023-01-01T00:00:00-03",
  "total_cost": "10000.00",
  "startup_date": "2023-01-10T00:00:00-03",
  "costs_center": "CC001",
  "budgets": "15000.00",
  "id_custom_field_group": 1
}

Notas:

Todos los campos son opcionales salvo los requeridos por el schema. Utiliza este modelo para insertar activos de forma estructurada y alineada con Fracttal ETL.

Relacionado: