Integração ERP / Sincronização de Fulfillment

Ciclo de Vida de Fluxo

Uma vez que um pedido é capturado pelo BackchannelOS e sincronizado com o seu ERP, a etapa final é relatar o status de fulfillment, números de rastreamento e dados de faturamento.

Agradecimento

O ERP confirma o recebimento do pedido e atribui IDs de documentos internos.

Separação (Picking)

A equipe do armazém reserva o estoque físico e inicia a preparação.

Envio

A coleta pela transportadora ocorre. O número de rastreamento e a Nota Fiscal (NF-e) são gerados.

Relatando Fulfillment

Padrão Primário

Seu ERP ou WMS deve chamar este endpoint assim que um envio for despachado.

POST /v1/orders/{order_id}/fulfill

{
  "tracking_number": "1Z999AA10123456784",
  "carrier": "fedex",
  "invoice": {
    "id": "BR-99812-NFE",
    "url": "https://erp.com/invoices/99812.pdf"
  },
  "items": [
    { "sku": "TSHIRT-BLUE-L", "quantity": 1 }
  ]
}

Lidando com Backorders

Se o seu ERP descobrir uma discrepância de estoque durante a separação, você DEVE relatar um fulfillment parcial ou cancelamento. Não fazer isso deixará o pedido em um "Estado Zumbi" dentro do BackchannelOS, impactando os SLAs do cliente.

Regra de Fulfillment Parcial

Os itens não incluídos na matriz `items` de uma solicitação de fulfillment são presumidos como "Backordered" e permanecerão no status `processing` até que uma segunda chamada de fulfillment seja feita ou o pedido seja cancelado.