Draft orders

A draft order is an editable purchase created through the Admin API. Use it for assisted sales, phone orders, or a quote you want to prepare before placing an order. It is separate from a buyer’s Storefront cart.

Establish context before adding items

Choose the store, currency, price channel, and customer information first. Catalog lines resolve in that context. Add address data before expecting delivery choices and final tax amounts.

Use catalog lines for Thor variants. Use custom lines for items or charges that your application explicitly supplies outside the catalog. Keep administrative price overrides deliberate and record a useful business reason in your operational workflow.

Review the current draft

A line, price, address, discount, or shipping change can affect the total. Render the returned draft after each mutation. If a customer accepts a quote, verify the latest draft and amount before placing it; an old screenshot is not the current state.

Place or discard

Placement produces an order for subsequent payment and fulfillment work. Persist the returned order ID before triggering another system. Treat placement as a terminal action and reconcile an uncertain response before retrying it.

Discard a draft that should no longer be actionable. Use the returned draft status to keep placed and discarded records out of editable work queues.

Follow Create and place a draft order for operations and inputs.