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:

Módulo	Categoria
Inventário	Atualização e Inserção

---

Detalhes da molécula

Parâmetros de entrada:

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

Esquema de entrada:

Campo	Tipo	Obrigatório	Descrição	Valor padrão	Exemplos
code	str	✅	Código de inventário exclusivo.	PydanticUndefined	INV001, ITM-12345
id_type_item	Optional[str]	❌	Tipo de ativo/estoque.	None	1, 2
field_1	str	✅	Nome ou descrição principal do inventário.	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 se o ativo está ativo ou não. Valores: Verdadeiro, Falso	None	-
barcode	Optional[str]	❌	Código de barras do inventário.	None	1234567890, 0987654321
notes	Optional[str]	❌	Notas ou comentários.	None	Inventario en almacén principal, Requiere revisión periódica
weight	Optional[str]	❌	Peso do ativo (apenas para peças sobressalentes e ferramentas)	None	-
purchase_date	Optional[str]	❌	Data de compra. Formato: 'AAAA-MM-DDTHH:MM:SS-UTC'	None	-
is_serial_control	Optional[bool]	❌	verdadeiro se o item for controlado por serial; caso contrário, falso. Valores: Verdadeiro, Falso	None	-
group	Optional[str]	❌	Tipo de ativo.	None	-
group_1	Optional[str]	❌	Classificação 1.	None	-
group_2	Optional[str]	❌	Classificação 2.	None	-
priorities	Optional[str]	❌	Descrição da prioridade.	None	-
id_priority	Optional[Priority]	❌	ID de prioridade: 1: Muito Alta, 2: Alta, 3: Média, 4: Baixa, 5: Muito Baixa	None	-
code_parent_location	Optional[str]	❌	Código de localização pai.	None	ACT.LOC-008, LOC-123
latitude	Optional[str]	❌	Latitude.	None	-
longitud	Optional[str]	❌	Comprimento.	None	-
unit_code	Optional[str]	❌	Código da unidade.	None	U001, KG
unit_description	Optional[str]	❌	Descrição da unidade.	None	Unidad estándar, Kilogramos
visible_to_all	Optional[bool]	❌	Visibilidade global.	None	True, False
total_cost	Optional[str]	❌	Custo total do ativo.	None	-
startup_date	Optional[str]	❌	Data de início da depreciação. Formato: 'AAAA-MM-DDTHH:MM:SS-UTC'	None	-
costs_center	Optional[str]	❌	Descrição do centro de custo.	None	-
budgets	Optional[str]	❌	Custo total da depreciação linear.	None	-
id_custom_field_group	Optional[int]	❌	ID do grupo de campos personalizados.	None	-
hours_average_daily_use	Optional[int]	❌	Média diária de horas de uso (segundos, entre 0 e 86.400)	None	-
equivalence	Optional[str]	❌	Código de equivalência de estoque.	None	EQ-98765, EQ-001
location	Optional[str]	❌	Localização física dentro do armazém.	None	Estante 5, Zona A
max_stock_level	Optional[str]	❌	Estoque máximo permitido.	None	500, 1000
min_stock_level	Optional[str]	❌	Estoque mínimo permitido.	None	10, 20
stock	Optional[str]	❌	Quantidade de estoque disponível.	0	100, 250
unit_cost_stock	Optional[str]	❌	Custo unitário do estoque.	None	50.00, 75.25

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.

Relacionado: