Skip to main content

Approve Order

POST 

/api/portal/approvals/:approval/approve

Approve the current level of an approval request. When the final level approves, the request converts to a draft order (its id is returned) and the originating cart is emptied. Only an entitled approver for the current level may act.

Buyer portal token

Called by a B2B portal buyer with the bearer token POST /api/portal/auth/login returns (or the buyer's feed key) — not with a staff Personal Access Token.

Held dropship orders. Final approval of a held dropship order re-checks the account before placing it, and places it atomically: the order, its dropship details and the approval's final state are written together, and approving an already-finalised request returns 422 already_finalized without creating a second order. These checks return 422 and leave the request pending (it can be approved once fixed, or rejected): dropship_not_enabled (dropship was turned off for the account, or for the order's intake route), duplicate_retailer_order (an open order already carries the retailer order number), credit_hold, exceeds_credit_limit (the order's goods, dropship fee and shipping are checked against available credit at approval time).

Request​

Responses​

OK

Response Headers
    Content-Type