Create Fulfillment
POST/api/amazon/:integrationInstance/outbound/create-fulfillment/:amazonFulfillmentOrder/:salesOrder
Links an Amazon MCF (outbound) order to its SKU sales order's FulfillmentOrder.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
deferred-shipment model: this no longer creates a SalesOrderFulfillment up front. The AmazonFulfillmentOrder is linked to its FulfillmentOrder, and the shipment SOF is minted by the canonical ship-time recorder when Amazon reports a shipment. If Amazon has already shipped, the endpoint returns the resulting fulfilled SalesOrderFulfillment; otherwise it returns a confirmation message that the order was linked and is awaiting Amazon's ship signal.
Requires a Bearer token.
Returns 409 when the MCF order was mapped to a sales order concurrently (by another operator or the automatic linking sweep) — refresh and retry only if it is still unmapped.
The MCF order must belong to the Amazon connection in the URL; an order from a different connection returns 404.
Returns 404 when the MCF order belongs to a different Amazon account than the one in the URL.
Returns 422 with an explanatory message when the MCF order cannot be reconciled against the chosen sales order — an FNSKU not mapped to a product, a product that is not a line on the order, a quantity mismatch, or stock that cannot be reserved or deducted (not enough On Hand).
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Conflict
Response Headers
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.