Developers
Guias · WMS

O que integrar no WMS

Como o WMS do BIX e o seu ERP dividem o trabalho, o que o ERP envia e o que lê de volta.

O WMS do BIX controla o estoque por endereço dentro de cada loja: depósito, zona, rua, prédio, nível. Ele sabe onde está cada produto, coisa que o ERP normalmente não sabe.

A divisão de trabalho:

Quem Faz
ERP Registra o que entra e sai da loja: nota de compra, transferência, venda, perda
BIX (operação na loja) Guarda o que entrou nos endereços, repõe a área de venda, conta e acerta o saldo 
sequenceDiagram
    participant ERP as Seu ERP
    participant BIX as WMS do BIX
    participant Loja as Operação na loja
    ERP->>BIX: entrada (nota) → "A endereçar"
    Loja->>BIX: guarda nos endereços, repõe, conta
    ERP->>BIX: vendas e saídas
    BIX-->>ERP: livro de movimentações (ajustes de inventário)
    BIX-->>ERP: saldo por loja e por endereço

O que o ERP envia

O quê Recurso Escopo
Entradas, saídas e vendas POST/wms/movements wms.movements.write

A entrada sem endereço cai na zona "A endereçar" do depósito e fica lá até a operação guardar na prateleira. Transferência entre endereços, reposição e ajuste não vêm do ERP: são da operação no BIX, que é quem sabe onde o produto está.

O que o ERP lê

O quê Recurso Para quê
Saldo por loja GET/wms/stock-balances O total disponível de cada produto em cada loja
Saldo por endereço GET/wms/bin-stocks Onde está o estoque, por lote e validade
Livro de movimentações GET/wms/movements Replicar no ERP o que a operação fez (o acerto de um inventário, por exemplo)
Depósitos, endereços e motivos GET/wms/storage-locations, GET/wms/bins, GET/wms/reasons Os códigos que os envios usam

Antes de começar

  • O cliente precisa ter o módulo WMS.
  • Os depósitos de cada loja precisam estar cadastrados no WMS, e os cadastros base (produtos, lojas com código de integração) já enviados: O que integrar.
  • Peça os escopos de WMS de que a integração precisa:
Escopo Libera
wms.stock.read Saldo por loja e por endereço
wms.structure.read Depósitos, endereços e motivos
wms.movements.read O livro de movimentações
wms.movements.write Enviar entradas, saídas e vendas

Guias