Map MCF Order to Sales Order
POST/api/amazon/unified/fulfillment-orders/:fulfillmentOrder/map
Attributes the MCF order to the given sales order through its fulfillment order; the shipment is recorded when Amazon reports it. Requires the sales_orders.fulfill permission. Returns 409 when the order was mapped concurrently, and 422 with an explanatory message when the link is rejected — an FNSKU not mapped to a product, a product that is not a line on the order, or a quantity larger than the order carries. Mapping an archived order unarchives it.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
The same 422 is returned when the stock the MCF order ships cannot be reserved or deducted against the sales order (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 — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
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.