Skip to main content

Submit Tracking to Faire (FBM)

POST 
/api/faire/orders/:order/submit-tracking

Manually retry tracking submission for an FBM Faire order.

Dispatches SubmitFaireTrackingJob for the most recent fulfilled SalesOrderFulfillment that has a tracking number. The job calls Faire's per-line-item fulfillment endpoint (POST /api/v2/brand/orders/{order_id}/items/{item_id}/fulfillments) for each item in the shipment, with the carrier, tracking code, shipped-at timestamp, and quantity.

Useful when an automatic submission failed and the user wants to retry. Job retries up to 3 times with exponential backoff (1m / 5m / 15m). Final status is reflected in tracking_submission_status on the order (pending, submitted, or failed) along with tracking_submission_error and tracking_submission_attempts.

Errors:

  • 422 — Instance is FBF (tracking is owned by Faire), no SKU sales order linked, or no fulfilled shipment with a tracking number found.

Request​

Responses​

Successful response