Inventory Upsert

Modelo estándar para registrar y actualizar inventario en Fracttal ETL. Permite definir, validar y automatizar la gestión de productos, repuestos o materiales almacenados, integrando datos mínimos y opcionales para uso técnico y operativo.

Información general:

Module	Category
`Inventory`	`Update and Insertion`

InventoryUpInsert

Parámetros:

code : str, obligatorio Código único que identifica el inventario en la compañía.
equivalence : str, opcional Código de equivalencia del inventario, si aplica.
id_type_item : str, opcional Tipo de activo o inventario (ejemplo: repuesto, equipo, herramienta).
field_1 : str, obligatorio Nombre, descripción o título principal del inventario.
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.
barcode : str, opcional Código de barras asociado al inventario para identificación rápida.
notes : str, opcional Notas, comentarios o advertencias sobre el inventario.
location : str, opcional Ubicación física dentro del almacén (ejemplo: estante, zona).
max_stock_level : str, opcional Cantidad máxima permitida en stock para el inventario.
min_stock_level : str, opcional Cantidad mínima permitida en stock para el inventario.
stock : str, opcional Cantidad actual disponible en el almacén.
unit_cost_stock : str, opcional Costo unitario del inventario en el almacén.
unit_code : str, opcional Código de la unidad de medida (ejemplo: UN, KG, LT).
unit_description : str, opcional Descripción de la unidad de medida.
visible_to_all : bool, opcional Indica si el inventario es visible para todos los usuarios de la compañía.
code_parent_location : str, opcional Código de la ubicación padre, útil para inventarios que dependen de otra ubicación.

Parámetros de entrada:

Campo	Tipo	Obligatorio	Descripción	Default Value	Examples
`code`	str	✅	Código único del inventario.	`PydanticUndefined`	None
`id_type_item`	Optional[str]	❌	Tipo de activo/inventario.	`None`	None
`field_1`	str	✅	Nombre o descripción principal del inventario.	`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[bool]	❌	Indica si el activo está activo o no. Valores: True, False	`None`	None
`barcode`	Optional[str]	❌	Código de barras del inventario.	`None`	None
`notes`	Optional[str]	❌	Notas o comentarios.	`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 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[bool]	❌	Visibilidad global.	`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
`equivalence`	Optional[str]	❌	Código de equivalencia del inventario.	`None`	None
`location`	Optional[str]	❌	Ubicación física dentro del almacén.	`None`	None
`max_stock_level`	Optional[str]	❌	Stock máximo permitido.	`None`	None
`min_stock_level`	Optional[str]	❌	Stock mínimo permitido.	`None`	None
`stock`	Optional[str]	❌	Cantidad de stock disponible.	`None`	None
`unit_cost_stock`	Optional[str]	❌	Costo unitario del stock.	`None`	None

Ejemplo de uso:

{
  "code": "testCode",
  "equivalence": "test",
  "id_type_item": "4",
  "field_1": "Repuesto A",
  "field_2": "Marca X",
  "field_3": "Modelo Y",
  "field_4": "Serial Z",
  "field_5": "Estado Nuevo",
  "field_6": "País Chile",
  "barcode": "1234567890",
  "notes": "Inventarimo en almacén principal",
  "location": "Estante 5",
  "max_stock_level": "500",
  "min_stock_level": "10",
  "stock": "100",
  "unit_cost_stock": "50.00",
  "unit_code": "U001",
  "unit_description": "Unidad estándar",
  "visible_to_all": true,
  "code_parent_location": "ACT.LOC-008",
  "id_warehouse": 1,
  "code_warehouse": "WH-001"
}

Notas:

Los campos obligatorios son code y field_1. Los demás son opcionales y pueden omitirse si no aplican. Para inventarios con dependencias o ubicaciones jerárquicas, utilice code_parent_location. La correcta definición de stock mínimo y máximo ayuda a prevenir quiebres o sobrestock en la operación logística.