Create drop-ship purchase orders from sales-order lines
Creates one draft drop-ship purchase order per vendor for the supplied sales-order
lines. This is the API surface of the SO-side drop-ship creation wizard: it flips the
chosen lines to drop-ship, releases any confirm-time inventory reservation / backorder
for the drop-shipped quantity (so the units are not double-committed), splits a line
when only part of its quantity is drop-shipped, resolves a non-null purchase cost per
line (vendor purchase policy, then catalog cost, then the caller-supplied unit_cost),
and creates the draft POs through the same canonical handler the automatic
confirm-time cascade uses. Each created PO carries source_order_id back to this order
and is left in DRAFT / unsent state so it can be reviewed and sent (or cancelled) before
the vendor sees it. Kit-component, service, box, and already-linked lines are rejected
with a specific code. Requires purchasing:write scope. Idempotent via
Idempotency-Key header.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.
255Path Parameters
Body
The sales-order lines to source via a drop-ship vendor.
1Response
Draft drop-ship PO(s) created

