Skip to main content

Preview Provider Cutover

GET 

/api/integration-instances/:integration_instance/cutover/preview

Dry run: every open, not-yet-sent fulfillment order on the cutover's sales channel routed to this provider, with the outcome the cutover would produce. Nothing is written.

Required scope: integrations:read

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

Outcomes: stays_with_provider_link (before the boundary, the provider's own order exists — will link), stays_with_provider_waiting (before the boundary, waiting for the provider's order to appear), sku_will_send (after the boundary, no match), held_possible_duplicate (after the boundary, the provider already holds an order with the same number), blocked (outbound order sync off, warehouse not mapped, or unmapped order lines — see blocked_reason).

Standard pagination (default 10 per page, max 100), newest order first. meta.outcome_counts gives the count per outcome across all pages.

Errors: 422 when no sales channel is planned or filter[outcome] is invalid.

Required permission: integrations.show. A token also needs its integrations scope.

Request​

Responses​

OK

Response Headers
    Content-Type