Draft Order Object


A temporary, editable version of an order. Use draft orders to modify pricing, line items, or discounts on an existing order before committing the changes.

When committed, the draft order's changes are applied to the original order.

Properties
additionalFeesArray <AdditionalFeeDetails>maxItems 100

Additional fees.

Includes details about the source, and whether the additional fee is applied to the order.


balanceSummaryBalanceSummaryRead-only

Balance summary.


billingDetailsBillingDetails

Billing address and contact details. Includes details about changes when relevant.


billingInfoAddressWithContactdeprecated - use billingDetails instead

Billing address and contact details.


businessLocationDetailsBusinessLocationDetails

Order business location.

Includes details about changes when relevant.


buyerDetailsBuyerDetails

Buyer information.

Includes details about changes when relevant.


buyerInfoBuyerInfodeprecated - use buyerDetails instead

Buyer information.


commitSettingsDraftOrderCommitSettings

Side effects to perform on commit.


createdByCreatedByRead-only

Identity of the draft order's initiator.


createdDatestringRead-onlyformat date-time

Date and time the draft order was created.


currencystringformat CURRENCY

Currency used for pricing.


discountsArray <DiscountDetails>maxItems 320

Discounts.

Includes details about the source, and whether the discount is applied to the order.


extendedFieldsExtendedFields

Custom field data for the draft order object.

Extended fields must be configured in the app dashboard before they can be accessed with API calls.


idstringRead-onlyformat GUID

Draft order ID.


lineItemsArray <ItemDetails>minItems 1maxItems 300

Line items. Includes details about changes when relevant.


memberIdstringformat GUID

Member ID (if order created by a member).


orderIdstringformat GUID

ID of the order this draft commits to.


priceSummaryPriceSummaryRead-only

Price summary.


purchaseFlowIdstringformat GUID

Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order.


recipientInfoRecipientInfoDetails

Order recipient address and contact details.

This field may differ from the address in shippingInfo.logistics when:

  • The chosen shipping option is pickup point or store pickup.
  • No shipping option is selected.

shippingInfoShippingDetails

Shipping info. Includes details about changes when relevant.


statusstringRead-only

Draft order status.


taxInfoOrderTaxInfo

Tax information.


taxSummaryTaxSummaryRead-onlydeprecated - use taxInfo instead

Deprecated. Use taxInfo instead. This field will be removed on September 30, 2024. Tax summary.


updatedDatestringRead-onlyformat date-time

Date and time the draft order was updated.


weightUnitstring

Weight measurement unit. Defaults to the site's weight unit.

Did this help?