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:

Módulo	Categoría
Inventory	Update and Insertion

---

Detalles de la molécula

Parámetros de entrada:

• 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.

Esquema de entrada:

Campo	Tipo	Obligatorio	Descripción	Valor por defecto	Ejemplos
code	str	✅	Código único del inventario.	PydanticUndefined	INV001, ITM-12345
id_type_item	Optional[str]	❌	Tipo de activo/inventario.	None	1, 2
field_1	str	✅	Nombre o descripción principal del inventario.	PydanticUndefined	Repuesto A, Material B
field_2	Optional[str]	❌	Campo adicional 2.	None	Marca X, Categoría Y
field_3	Optional[str]	❌	Campo adicional 3.	None	Modelo Y, Tipo Z
field_4	Optional[str]	❌	Campo adicional 4.	None	Serial Z, Versión 1.0
field_5	Optional[str]	❌	Campo adicional 5.	None	Estado Nuevo, Condición Usado
field_6	Optional[str]	❌	Campo adicional 6.	None	País Chile, Origen USA
active	Optional[bool]	❌	Indica si el activo está activo o no. Valores: True, False	None	-
barcode	Optional[str]	❌	Código de barras del inventario.	None	1234567890, 0987654321
notes	Optional[str]	❌	Notas o comentarios.	None	Inventario en almacén principal, Requiere revisión periódica
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 de ubicación padre.	None	ACT.LOC-008, LOC-123
latitude	Optional[str]	❌	Latitud.	None	-
longitud	Optional[str]	❌	Longitud.	None	-
unit_code	Optional[str]	❌	Código de unidad.	None	U001, KG
unit_description	Optional[str]	❌	Descripción de la unidad.	None	Unidad estándar, Kilogramos
visible_to_all	Optional[bool]	❌	Visibilidad global.	None	True, False
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	-
equivalence	Optional[str]	❌	Código de equivalencia del inventario.	None	EQ-98765, EQ-001
location	Optional[str]	❌	Ubicación física dentro del almacén.	None	Estante 5, Zona A
max_stock_level	Optional[str]	❌	Stock máximo permitido.	None	500, 1000
min_stock_level	Optional[str]	❌	Stock mínimo permitido.	None	10, 20
stock	Optional[str]	❌	Cantidad de stock disponible.	0	100, 250
unit_cost_stock	Optional[str]	❌	Costo unitario del stock.	None	50.00, 75.25

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.

Relacionado: