Sistema/Estoque

Estoque

O Mecanismo de Estoque do Backchannel fornece uma visão de alta fidelidade e em tempo real dos níveis de estoque em redes logísticas globais, sincronizada com seu ERP.

Ciclo de Vida de Sincronização

01

Ingestão

Os níveis de estoque brutos são extraídos do ERP (SAP, Linx, Totvs) a cada 60 segundos.

02

Resolução

O estoque é reconciliado com pedidos ativos e realocações pendentes.

03

Propagação

Os números finais de 'Disponível para Promessa' (ATP) são transmitidos para todos os canais de vendas.

O Item de Estoque

A unidade atômica de gerenciamento de estoque. Cada SKU exclusivo em um local exclusivo é um Item de Estoque.

Identificadores Globais

FieldTypeDescription
skuRequired
string

Unidade de Manutenção de Estoque. Deve corresponder ao identificador em seu ERP.

Example: WRA-TEX-001
brand_idRequired
string

A marca proprietária do estoque.

Example: brand_01JGK9
barcode
string

UPC/EAN associado ao SKU.

Métricas de Estoque

FieldTypeDescription
physical_stock
integer

Quantidade total presente na prateleira do armazém.

reserved_stock
integer

Quantidade já alocada para processamento de pedidos.

available_stockRequired
integer

Estoque disponível líquido (Físico - Reservado). Este é o valor enviado para as vitrines.

safety_stock_buffer
integer

Nível mínimo de estoque mantido antes de mostrar a bandeira 'Fora de Estoque'.

Consultar Estoque

GET /v1/inventory

Parâmetros de Solicitação

FieldTypeDescription
brand_idRequired
string

Filtrar estoque pelo proprietário da marca.

warehouse_id
string

Filtrar por nó logístico específico.

sku
string

Alvo um identificador de produto específico.

Acionar Realocação

POST /v1/inventory/reallocate

Mova programaticamente o estoque virtual entre os nós de atendimento. Isso é normalmente usado pelo Rebalanceador Agêntico, mas pode ser acionado manualmente.

{
  "sku": "WRA-TEX-001",
  "from_node": "WH_SP_01",
  "to_node": "WH_RJ_02",
  "quantity": 500
}

Operações em Massa

Para marcas corporativas com grandes catálogos, use os endpoints em massa para atualizar os níveis de estoque em vários SKUs e locais em uma única chamada.

Mapeamento Multi-Armazém

O BackchannelOS mapeia seus `warehouse_ids` internos do ERP para nossos `fulfillment_nodes`. Isso permite uma lógica de roteamento complexa como "Ship-from-Store" ou priorização de "Regional Hub".

ID do ERP
CD_SP_001
Nó do Backchannel
SAO-PAULO-HUB