ERP Integration / Fulfillment Sync

Fulfillment Lifecycle

Once an order is captured by BackchannelOS and synced to your ERP, the final step is reporting back fulfillment status, tracking numbers, and invoice data.

Acknowledgment

ERP confirms receipt of order and assigns internal document IDs.

Picking

Warehouse staff reserves physical stock and begins preparation.

Shipping

Carrier pickup occurs. Tracking number and Invoice (NF-e) are generated.

Reporting Fulfillment

Primary Pattern

Your ERP or WMS should call this endpoint as soon as a shipment is dispatched.

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 }
  ]
}

Handling Backorders

If your ERP discovers a stock discrepancy during picking, you MUST report a partial fulfillment or cancellation. Failing to do so will leave the order in a "Zombie State" within BackchannelOS, impacting customer SLAs.

Partial Fulfillment Rule

Items not included in the `items` array of a fulfill request are assumed to be "Backordered" and will remain in the `processing` status until a second fulfill call is made or the order is cancelled.