OMS ↔ WMS: estoque, push, retorno de envio e tracking

Como se comunicam: resolução de estoque, push idempotente, callbacks e tracking.

No modo wms_sync formam um ciclo fechado: OMS lê estoque, envia pedidos, WMS executa e retorna callbacks.

Resolução da fonte de estoque#

• A configuração define o padrão do tenant e exceções por armazém.
• No wms_sync o livro OMS é somente leitura; o ATP lê qty_available.

Push: pedido → saída WMS#

• Converte linhas em wms_order_lines sem mapeamento de SKU.
• A saída é criada em commit, bloqueando estoque; o pedido vai para released.
• Um pedido pode se dividir em várias saídas; o detalhe lista todas.

Retorno: WMS → OMS#

• Ao enviar, o hook acumula fulfilled_qty e preenche o tracking por linha.
• O status do pedido deriva das linhas: tudo enviado → fulfilled.
• Cada envio grava um evento shipped que alimenta a timeline e o tracking.

Tracking devolvido aos canais#

• Ao enviar, o tracking é sincronizado ao canal; falha não bloqueia a resposta.
• O status fica em tracking_sync_status; nova tentativa disponível.
• Apenas shipped dispara a sincronização; delivered não.