Reconcile source reference
Bind an existing remote OMS order ID to a fulfillment order’s source_reference_identifier,
resolving push failures caused by duplicate-push errors (HTTP 409) or other desync states
where Luminous lost track of the remote order it already created.
Modes
- Auto (default) — omit or set
source_reference_identifiertonull. Luminous queries the remote OMS for orders matching this fulfillment order’s order number, validates line items, and binds the first match. - Manual — provide
source_reference_identifier. Luminous fetches that specific remote order, validates line items, and binds it. Add"force": trueto skip line-item validation when SKU mappings can’t be resolved.
After a successful bind the fulfillment order status is set to awaiting_fulfillment, its error
message is cleared, and a sales order refresh job is dispatched (unless trigger_order_refresh
is false or dry_run is true).
The push endpoint’s 422 response body includes a links.reconcile URL pointing directly here
when a push fails.
Supported integrations — currently TrackStar. Other OMS integrations return a 422 with
an app field naming the unsupported integration.
Authorizations
Authenticate using a bearer token. To create a token, navigate to /settings/api-tokens and click Create API Token.
Path Parameters
ID of the fulfillment order
Body
The remote OMS order ID to bind. Omit or pass null for auto mode.
Provide a value for manual mode.
255Manual mode only. When true, skip line-item quantity/SKU validation and bind
the remote order regardless. Has no effect in auto mode and returns a 422 if
used without source_reference_identifier.
When true, validate and return what would happen without writing to the database
or dispatching a refresh job.
When true (default), dispatch a sales order refresh job after a successful bind.
Ignored when dry_run is true.
When true, capture and return outbound OMS HTTP traffic in data.debug.
Response
Reconciliation succeeded (or was already reconciled / dry run). Check data.data.mode to
distinguish: "auto", "manual", "noop" (already reconciled), or the dry_run flag.