Atualização de estoque

Modelo padrão para registro e atualização de estoque em Fracttal ETL. Permite definir, validar e automatizar a gestão de produtos, peças de reposição ou materiais armazenados, integrando dados mínimos e opcionais para uso técnico e operacional.

Informação geral:

Module	Category
`Inventário`	`Atualização e Inserção`

InventoryUpInsert

Parâmetros:

código: str, obrigatório Código único que identifica o estoque da empresa.
equivalência: str, opcional Código de equivalência de estoque, se aplicável.
id_type_item: str, opcional Tipo de ativo ou estoque (exemplo: peça de reposição, equipamento, ferramenta).
campo_1: str, obrigatório Nome, descrição ou título principal do inventário.
campo_2: str, opcional Campo adicional para informações complementares (exemplo: marca).
campo_3: str, opcional Campo adicional para informações complementares (exemplo: modelo).
campo_4: str, opcional Campo adicional para informações complementares (exemplo: serial).
campo_5: str, opcional Campo adicional para status, condição ou outra classificação.
campo_6: str, opcional Campo adicional para país, origem ou outras informações relevantes.
código de barras: str, opcional Código de barras associado ao inventário para rápida identificação.
notas: str, opcional Notas, comentários ou avisos sobre o inventário.
localização: str, opcional Localização física dentro do armazém (exemplo: estante, área).
max_stock_level: str, opcional Quantidade máxima permitida em estoque para estoque.
min_stock_level: str, opcional Quantidade mínima permitida em estoque para estoque.
estoque: str, opcional Quantidade atual disponível no armazém.
unit_cost_stock: str, opcional Custo unitário do estoque no armazém.
unit_code: str, opcional Código da unidade de medida (exemplo: UN, KG, LT).
unit_description: str, opcional Descrição da unidade de medida.
visible_to_all: bool, opcional Indica se o inventário está visível para todos os usuários da empresa.
code_parent_location: str, opcional Código do local pai, útil para inventários que dependem de outro local.

Parâmetros de entrada:

Campo	Tipo	Obrigatório	Descrição	Default Value	Examples
`code`	str	✅	Código de inventário exclusivo.	`PydanticUndefined`	None
`id_type_item`	Optional[str]	❌	Tipo de ativo/estoque.	`None`	None
`field_1`	str	✅	Nome ou descrição principal do inventário.	`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 se o ativo está ativo ou não. Valores: Verdadeiro, Falso	`None`	None
`barcode`	Optional[str]	❌	Código de barras do inventário.	`None`	None
`notes`	Optional[str]	❌	Notas ou comentários.	`None`	None
`weight`	Optional[str]	❌	Peso do ativo (apenas para peças sobressalentes e ferramentas)	`None`	None
`purchase_date`	Optional[str]	❌	Data de compra. Formato: 'AAAA-MM-DDTHH:MM:SS-UTC'	`None`	None
`is_serial_control`	Optional[bool]	❌	verdadeiro se o item for controlado por serial; caso contrário, falso. Valores: Verdadeiro, Falso	`None`	None
`group`	Optional[str]	❌	Tipo de ativo.	`None`	None
`group_1`	Optional[str]	❌	Classificação 1.	`None`	None
`group_2`	Optional[str]	❌	Classificação 2.	`None`	None
`priorities`	Optional[str]	❌	Descrição da prioridade.	`None`	None
`id_priority`	Optional[Priority]	❌	ID de prioridade: 1: Muito Alta, 2: Alta, 3: Média, 4: Baixa, 5: Muito Baixa	`None`	None
`code_parent_location`	Optional[str]	❌	Código de localização pai.	`None`	None
`latitude`	Optional[str]	❌	Latitude.	`None`	None
`longitud`	Optional[str]	❌	Comprimento.	`None`	None
`unit_code`	Optional[str]	❌	Código da unidade.	`None`	None
`unit_description`	Optional[str]	❌	Descrição da unidade.	`None`	None
`visible_to_all`	Optional[bool]	❌	Visibilidade global.	`None`	None
`total_cost`	Optional[str]	❌	Custo total do ativo.	`None`	None
`startup_date`	Optional[str]	❌	Data de início da depreciação. Formato: 'AAAA-MM-DDTHH:MM:SS-UTC'	`None`	None
`costs_center`	Optional[str]	❌	Descrição do centro de custo.	`None`	None
`budgets`	Optional[str]	❌	Custo total da depreciação linear.	`None`	None
`id_custom_field_group`	Optional[int]	❌	ID do grupo de campos personalizados.	`None`	None
`hours_average_daily_use`	Optional[int]	❌	Média diária de horas de uso (segundos, entre 0 e 86.400)	`None`	None
`equivalence`	Optional[str]	❌	Código de equivalência de estoque.	`None`	None
`location`	Optional[str]	❌	Localização física dentro do armazém.	`None`	None
`max_stock_level`	Optional[str]	❌	Estoque máximo permitido.	`None`	None
`min_stock_level`	Optional[str]	❌	Estoque mínimo permitido.	`None`	None
`stock`	Optional[str]	❌	Quantidade de estoque disponível.	`None`	None
`unit_cost_stock`	Optional[str]	❌	Custo unitário do estoque.	`None`	None

Exemplo 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:

Os campos obrigatórios são code e field_1. Os demais são opcionais e podem ser omitidos caso não sejam aplicáveis. Para inventários com dependências ou locais hierárquicos, use code_parent_location. A correta definição de estoque mínimo e máximo ajuda a evitar rupturas ou excesso de estoque na operação logística.