Skip to main content

Match Unmatched Export

POST 

/api/purple-dot/:instance/unmatched-exports/:row/match

Matches an open unmatched export to a pre-order by hand. The pre-order's reserved demand moves onto the order's lines (keeping its status, PO coverage and priority), any allocation the order holds beyond its open quantity is released (weakest first), the pre-order line is marked exported, and the order is tagged purple-dot with its Purple Dot reference and payment status.

Required scope: inventory:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Body fields:

  • purple_dot_preorder_id (integer, required): a pre-order of this connection.

Errors: 404 when the row or pre-order belongs to another connection; 422 conflict when the row is no longer open; 422 validation errors for a missing or unknown pre-order.

Authentication: Requires a Bearer token. Requires the integrations.update permission.

Request​

Responses​

OK

Response Headers
    Content-Type