@wix/auto_sdk_ecom_draft-orders 1.0.21 → 1.0.22

package/build/cjs/src/ecom-v1-draft-order-draft-orders.types.d.ts

@@ -26,14 +26,14 @@ export interface DraftOrder {
     /**
      * Buyer information.
      * @deprecated Buyer information.
-     * @replacedBy buyer_info_details
+     * @replacedBy buyer_details
      * @targetRemovalDate 2024-08-30
      */
     buyerInfo?: BuyerInfo;
     /**
      * Billing address and contact details.
      * @deprecated Billing address and contact details.
-     * @replacedBy billing_info_details
+     * @replacedBy billing_details
      * @targetRemovalDate 2024-08-30
      */
     billingInfo?: AddressWithContact;
@@ -110,12 +110,31 @@ export interface DraftOrder {
      * @format GUID
      */
     purchaseFlowId?: string | null;
+    /**
+     * 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.
+     */
     recipientInfo?: RecipientInfoDetails;
+    /** Tax information. */
+    taxInfo?: OrderTaxInfo;
     /**
      * Custom field data for the draft order object.
      * [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the [app dashboard](https://dev.wix.com/dc3/my-apps/) before they can be accessed with API calls.
      */
     extendedFields?: ExtendedFields;
+    /**
+     * Buyer information.
+     * Includes details about changes when relevant.
+     */
+    buyerDetails?: BuyerDetails;
+    /**
+     * Billing address and contact details.
+     * Includes details about changes when relevant.
+     */
+    billingDetails?: BillingDetails;
     /**
      * Order business location
      * Includes details about changes when relevant.
@@ -1086,6 +1105,7 @@ export interface AdditionalFeeDetails {
      *
      * Supported values:
      * + `ORIGINAL_ORDER`: This additional fee is part of the original order.
+     * + `AUTOMATIC`: User added a catalog item which is configured to have an additional fee.
      * + `CUSTOM`: This additional fee was created by the [Create Custom Additional Fees](https://dev.wix.com/docs/rest/api-reference/wix-e-commerce/draft-orders/create-custom-additional-fees) API.
      */
     source?: SourceType;
@@ -1141,11 +1161,11 @@ export interface TaxDetails {
     taxGroupId?: string | null;
 }
 export declare enum SourceType {
-    /** Part of the original order */
+    /** Part of the original order. */
     ORIGINAL_ORDER = "ORIGINAL_ORDER",
-    /** Added by estimate * */
+    /** Added automatically, as the result of recalculation caused by changes in draft order. */
     AUTOMATIC = "AUTOMATIC",
-    /** Added manually to current draft order */
+    /** Added manually to draft order. */
     CUSTOM = "CUSTOM"
 }
 export interface DiscountDetails {
@@ -1311,9 +1331,9 @@ export interface CreatedByStringOneOf {
     appId?: string;
 }
 export declare enum EditingStatus {
-    /** DraftOrder is in draft state. */
+    /** Draft order can be modified and committed. */
     DRAFT = "DRAFT",
-    /** DraftOrder is in committed state. */
+    /** Draft order is already committed. No further modifications allowed. */
     COMMITTED = "COMMITTED"
 }
 export declare enum WeightUnit {
@@ -1351,6 +1371,18 @@ export interface BalanceSummary {
      * @readonly
      */
     balance?: Balance;
+    /**
+     * Sum of all approved and successful payments.
+     *
+     * The value includes payments that have subsequently been fully or partially refunded.
+     * @readonly
+     */
+    paid?: Price;
+    /**
+     * Sum of all successfully refunded payments.
+     * @readonly
+     */
+    refunded?: Price;
     /**
      * Sum of all authorized payments.
      * @readonly
@@ -1490,18 +1522,50 @@ export interface OrderTaxBreakdown {
     aggregatedTaxAmount?: Price;
 }
 export interface BuyerDetails extends BuyerDetailsChangeTypeOneOf {
+    /** Indicates that buyer information was added during draft. */
+    added?: boolean;
+    /** Indicates that buyer information was changed. Contains billing information before draft. */
+    changedDetails?: BuyerChangedDetails;
+    /** Indicates that buyer information was removed during draft. */
+    removed?: boolean;
+    /** Buyer information. */
+    buyerInfo?: BuyerInfo;
 }
 /** @oneof */
 export interface BuyerDetailsChangeTypeOneOf {
+    /** Indicates that buyer information was added during draft. */
+    added?: boolean;
+    /** Indicates that buyer information was changed. Contains billing information before draft. */
+    changedDetails?: BuyerChangedDetails;
+    /** Indicates that buyer information was removed during draft. */
+    removed?: boolean;
 }
 export interface BuyerChangedDetails {
+    /** Buyer information before draft. */
+    buyerInfoBeforeChange?: BuyerInfo;
 }
 export interface BillingDetails extends BillingDetailsChangeTypeOneOf {
+    /** Indicates that billing information was added during draft. */
+    added?: boolean;
+    /** Indicates that billing information was changed. Contains billing information before draft. */
+    changedDetails?: BillingChangedDetails;
+    /** Indicates that billing information was removed during draft. */
+    removed?: boolean;
+    /** Billing address and contact details. */
+    billingInfo?: AddressWithContact;
 }
 /** @oneof */
 export interface BillingDetailsChangeTypeOneOf {
+    /** Indicates that billing information was added during draft. */
+    added?: boolean;
+    /** Indicates that billing information was changed. Contains billing information before draft. */
+    changedDetails?: BillingChangedDetails;
+    /** Indicates that billing information was removed during draft. */
+    removed?: boolean;
 }
 export interface BillingChangedDetails {
+    /** Billing address and contact details before draft. */
+    billingInfoBeforeChange?: AddressWithContact;
 }
 export interface BusinessLocationDetails extends BusinessLocationDetailsChangeTypeOneOf {
     /** Indicates that business location was added during draft. */
@@ -1543,22 +1607,24 @@ export interface BusinessLocationChangedDetails {
 }
 export interface CreateDraftOrderRequest {
     /**
-     * To create a draft from existing order, provide its id. Otherwise, an empty draft will be created.
+     * Existing order ID to create draft from.
      * @format GUID
      */
     orderId: string | null;
 }
 export interface CreateDraftOrderResponse {
-    /** The draft order details calculated with latest content */
+    /** Draft order details calculated with latest content. */
     calculatedDraftOrder?: CalculatedDraftOrder;
-}
-export interface CalculatedDraftOrder {
     /**
-     * The draft order full details with calculations based on it's content.
-     * Discount and additional fee options are also included.
+     * Flag indicating whether response contains draft order that existed before request.
+     * `False` - new draft order was created.
      */
+    preexistingDraftOrder?: boolean | null;
+}
+export interface CalculatedDraftOrder {
+    /** Draft order full details with calculations based on it's content. */
     draftOrder?: DraftOrder;
-    /** Shipping options for the order. */
+    /** Order shipping options. */
     shippingOptions?: ShippingOption[];
     /** Errors that occurred during calculation. */
     calculationErrors?: CalculationErrors;
@@ -1591,18 +1657,14 @@ export interface DeliveryLogistics {
 export interface PickupDetails {
     /** Pickup address */
     address?: Address;
-    /**
-     * Pickup method.
-     *
-     * Supported values:
-     * + `"STORE_PICKUP"`
-     * + `"PICKUP_POINT"`
-     */
+    /** Pickup method. */
     pickupMethod?: PickupMethod;
 }
 export declare enum PickupMethod {
     UNKNOWN_METHOD = "UNKNOWN_METHOD",
+    /** Pickup is from the merchant's brick and mortar store. */
     STORE_PICKUP = "STORE_PICKUP",
+    /** Item is shipped to a specified pickup point. */
     PICKUP_POINT = "PICKUP_POINT"
 }
 export interface DeliveryTimeSlot {
@@ -1744,12 +1806,12 @@ export interface CarrierError {
 export interface CreateEmptyDraftOrderRequest {
 }
 export interface CreateEmptyDraftOrderResponse {
-    /** The draft order details calculated with latest content */
+    /** Draft order details calculated with latest content. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface AddLineItemsToDraftOrderRequest {
     /**
-     * The draft order id
+     * Draft order ID.
      * @format GUID
      */
     draftOrderId: string;
@@ -1765,7 +1827,10 @@ export interface AddLineItemsToDraftOrderRequest {
     customLineItems?: CustomLineItem[];
 }
 export interface CatalogReferenceLineItem {
-    /** Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info. Optional for custom line items, which don't trigger the Catalog service plugin. */
+    /**
+     * Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info.
+     * Optional for custom line items, which don't trigger the Catalog service plugin.
+     */
     catalogReference?: CatalogReference;
     /**
      * Item quantity.
@@ -1775,6 +1840,12 @@ export interface CatalogReferenceLineItem {
     quantity?: number;
     /** Item price override. */
     price?: Price;
+    /**
+     * Whether the price is not yet defined, and will be updated after the order is created.
+     *
+     * Default: `false`
+     */
+    priceUndetermined?: boolean;
     /**
      * Line item locations.
      *
@@ -1798,7 +1869,10 @@ export interface CustomLineItem {
      * @max 100000
      */
     quantity?: number;
-    /** Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info. Optional for custom line items, which don't trigger the Catalog service plugin. */
+    /**
+     * Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info.
+     * Optional for custom line items, which don't trigger the Catalog service plugin.
+     */
     catalogReference?: CatalogReference;
     /**
      * Item name.
@@ -1871,35 +1945,35 @@ export declare enum FileType {
     SECURE_ARCHIVE = "SECURE_ARCHIVE"
 }
 export interface AddLineItemsToDraftOrderResponse {
-    /** The draft order details calculated with latest content */
+    /** Draft order details calculated with latest content. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface UpdateLineItemsRequest {
     /**
-     * The draft order id
+     * Draft order ID.
      * @format GUID
      */
     draftOrderId: string;
     /**
-     * Details of changes to apply per line item
+     * Details of changes to apply per line item.
      * @minSize 1
      * @maxSize 300
      */
-    lineItemChanges?: LineItemChangeDetails[];
+    lineItemChanges: LineItemChangeDetails[];
 }
 export interface LineItemChangeDetails {
     /**
-     * The line item id to change
+     * Line item ID.
      * @format GUID
      */
     lineItemId?: string;
     /**
-     * The new quantity for the line item. quantity zero means to remove the line item.
+     * The new quantity for the line item. Quantity zero removes the line item.
      * @max 1000000
      */
     newQuantity?: number | null;
     /**
-     * The new price for 1 unit of the line item
+     * The new price for 1 unit of the line item.
      * @decimalValue options { gte:0, lte:1000000000000000 }
      */
     newPrice?: string | null;
@@ -1907,51 +1981,59 @@ export interface LineItemChangeDetails {
     newPriceDescription?: PriceDescription;
 }
 export interface UpdateLineItemsResponse {
-    /** The draft order details calculated with latest content */
+    /** Draft order details calculated with latest content. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetDiscountsRequest {
     /**
-     * The draft order id
+     * Draft order ID.
      * @format GUID
      */
     draftOrderId: string;
     /**
-     * The discount ids to opt-in. all existing discounts not listed are to be opted-out.
+     * Discount IDs to apply/unapply.
+     * Existing discounts, not mentioned in request, will keep their current state.
      * @minSize 1
+     * @maxSize 320
      */
     discounts: IdAndApplied[];
 }
 export interface IdAndApplied {
-    /** Discount ID. */
+    /**
+     * Entity ID. Depending on context, it's either discount or additional fee ID.
+     * @format GUID
+     */
     id?: string;
-    /** Whether to apply the discount to the draft order. */
+    /** Flag indicating whether entity (discount/additional fee) should be applied to a draft order. */
     applied?: boolean;
 }
 export interface SetDiscountsResponse {
-    /** The draft order details calculated with latest content */
+    /** Draft order details calculated with latest content. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface CreateCustomDiscountsRequest {
     /**
-     * The draft order id
+     * Draft order ID.
      * @format GUID
      */
     draftOrderId: string;
     /**
-     * The discounts to add.
+     * Discounts to create. Created discounts are unapplied by default.
      * @minSize 1
      * @maxSize 100
      */
     discounts?: DiscountOption[];
 }
 export interface DiscountOption extends DiscountOptionDiscountAmountOneOf {
+    /** Discount price amount. */
+    priceAmount?: Price;
     /**
-     * Discount type.
-     * * `"GLOBAL"` - discount applies to entire order.
-     * * `"SPECIFIC-ITEMS"` - discount applies to a specific item.
-     * * `"SHIPPING"` - discount applies to shipping. For example, free shipping.
+     * Discount percentage amount.
+     * @format DECIMAL_VALUE
+     * @decimalValue options { gte:0, lte:100, maxScale:2 }
      */
+    percentage?: string | null;
+    /** Discount type. */
     discountType?: DiscountType;
     /**
      * ID of line item discount applies to.
@@ -1975,31 +2057,47 @@ export interface DiscountOption extends DiscountOptionDiscountAmountOneOf {
     description?: string | null;
     /**
      * Should opt-in the added discount. default = false.
-     * if not set or false, then to opt-in them, please call SetDiscounts with the added discounts ids
+     * if not set or false, then to opt-in them, please call SetDiscounts with the added discounts IDs.
      */
     applyToDraftOrder?: boolean | null;
+    /**
+     * Line items the discount applies to.
+     * @maxSize 1
+     */
+    lineItemDiscounts?: LineItemDiscount[];
 }
 /** @oneof */
 export interface DiscountOptionDiscountAmountOneOf {
+    /** Discount price amount. */
+    priceAmount?: Price;
+    /**
+     * Discount percentage amount.
+     * @format DECIMAL_VALUE
+     * @decimalValue options { gte:0, lte:100, maxScale:2 }
+     */
+    percentage?: string | null;
 }
 export declare enum DiscountType {
     UNKNOWN_TYPE = "UNKNOWN_TYPE",
+    /** Discount applies to entire order. */
     GLOBAL = "GLOBAL",
+    /** Discount applies to specific items. */
     SPECIFIC_ITEMS = "SPECIFIC_ITEMS",
+    /** Discount applies to shipping. For example, free shipping. */
     SHIPPING = "SHIPPING"
 }
 export interface CreateCustomDiscountsResponse {
-    /** The draft order details with the added discounts */
+    /** Draft order details calculated with latest content. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface DeleteCustomDiscountsRequest {
     /**
-     * The draft order id
+     * Draft order ID.
      * @format GUID
      */
     draftOrderId: string;
     /**
-     * The discounts to remove
+     * Ids of discounts to remove.
      * @format GUID
      * @minSize 1
      * @maxSize 100
@@ -2007,34 +2105,35 @@ export interface DeleteCustomDiscountsRequest {
     discountIds: string[];
 }
 export interface DeleteCustomDiscountsResponse {
-    /** The draft order details calculated with latest content */
+    /** Draft order details calculated with latest content. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetAdditionalFeesRequest {
     /**
-     * The draft order id
+     * Draft order ID.
      * @format GUID
      */
     draftOrderId: string;
     /**
-     * The additional fees ids to opt-in. all existing additional fees not listed are to be opted-out
+     * Additional fee IDs to apply/unapply.
+     * Existing additional fees, not mentioned in this list, will keep their current state.
      * @minSize 1
      * @maxSize 100
      */
     additionalFees: IdAndApplied[];
 }
 export interface SetAdditionalFeesResponse {
-    /** The draft order details calculated with modified additional fees */
+    /** Draft order details calculated with latest content. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface CreateCustomAdditionalFeesRequest {
     /**
-     * The draft order id
+     * Draft order ID.
      * @format GUID
      */
     draftOrderId: string;
     /**
-     * The additional fees to add. added with opted-out setting
+     * The additional fees to create. Created fees are unapplied by default.
      * @minSize 1
      * @maxSize 100
      */
@@ -2053,7 +2152,7 @@ export interface AdditionalFeeOption {
     taxDetails?: TaxDetails;
     /**
      * Should apply the additional fee. default = false.
-     * if not set or false, then to apply them, please call ApplyAdditionalFees with the added additional fee ids
+     * if not set or false, then to apply them, please call ApplyAdditionalFees with the added additional fee IDs.
      */
     applyToDraftOrder?: boolean | null;
     /**
@@ -2062,19 +2161,26 @@ export interface AdditionalFeeOption {
      * @maxLength 100
      */
     code?: string | null;
+    /**
+     * Optional - Line items associated with this additional fee.
+     * If no `lineItemIds` are provided, the fee will be associated with the whole order.
+     * @format GUID
+     * @maxSize 300
+     */
+    lineItemIds?: string[];
 }
 export interface CreateCustomAdditionalFeesResponse {
-    /** The draft order details with added custom additional fees */
+    /** Draft order details calculated with latest content. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface DeleteCustomAdditionalFeesRequest {
     /**
-     * The draft order id
+     * Draft order ID.
      * @format GUID
      */
     draftOrderId: string;
     /**
-     * The additional fees to remove
+     * Ids of additional fees to remove.
      * @format GUID
      * @minSize 1
      * @maxSize 100
@@ -2082,93 +2188,138 @@ export interface DeleteCustomAdditionalFeesRequest {
     customAdditionalFees: string[];
 }
 export interface DeleteCustomAdditionalFeesResponse {
-    /** The draft order details calculated with latest content */
+    /** Draft order details calculated with latest content. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetShippingInfoRequest {
+    /**
+     * Draft order ID.
+     * @format GUID
+     */
+    draftOrderId: string;
+    /** Shipping information. Empty value removes shipping information from draft. */
+    shippingInfo?: V1ShippingInformation;
 }
 export interface SetShippingInfoResponse {
+    /** Draft order details calculated with latest content. */
+    calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetBuyerInfoRequest {
+    /**
+     * Draft order ID.
+     * @format GUID
+     */
+    draftOrderId: string;
+    /** Buyer information. Empty value removes buyer information from draft. */
+    buyerInfo?: BuyerInfo;
 }
 export interface SetBuyerInfoResponse {
+    /** Draft order details calculated with latest content. */
+    calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetRecipientInfoRequest {
+    /**
+     * Draft order ID.
+     * @format GUID
+     */
+    draftOrderId: string;
+    /** Order recipient address and contact details. Empty value removes recipient information from draft. */
+    recipientInfo?: AddressWithContact;
 }
 export interface SetRecipientInfoResponse {
+    /** Draft order details calculated with latest content. */
+    calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetBillingInfoRequest {
+    /**
+     * Draft order ID.
+     * @format GUID
+     */
+    draftOrderId: string;
+    /** Billing address and contact details. Empty value removes billing information from draft. */
+    billingInfo?: AddressWithContact;
 }
 export interface SetBillingInfoResponse {
+    /** Draft order details calculated with latest content. */
+    calculatedDraftOrder?: CalculatedDraftOrder;
 }
+/** Deprecated */
 export interface UpdateShippingInfoRequest {
     /**
-     * The draft order id
+     * Draft order ID.
      * @format GUID
      */
     draftOrderId?: string;
-    /** update the shipping option on the order. if not set then the selected shipping is removed */
+    /** Update the shipping option on the order. If not set then the selected shipping is removed. */
     shippingOption?: ShippingOption;
 }
+/** Deprecated */
 export interface UpdateShippingInfoResponse {
-    /** The draft order details calculated with de/selected shipping info */
+    /** Draft order details calculated with latest content. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface GetDraftOrderRequest {
     /**
-     * The draft order id
+     * Draft order ID.
      * @format GUID
      */
     draftOrderId: string;
 }
 export interface GetDraftOrderResponse {
-    /** The draft order details calculated with latest content */
+    /** Draft order details calculated with latest content. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface GetOrderDraftabilityStatusRequest {
     /**
-     * Order ID.
-     * @minLength 1
-     * @maxLength 100
+     * Order Id.
+     * @format GUID
      */
     orderId: string;
 }
 export interface GetOrderDraftabilityStatusResponse {
     /**
-     * Order ID.
-     * @minLength 1
-     * @maxLength 100
+     * Order Id.
+     * @format GUID
      */
     orderId?: string;
-    /** Whether a draft can be created from this order */
+    /** Flag, indicating whether a draft can be created from this order. */
     orderDraftable?: boolean;
     /**
-     * Reasons why the order is not draftable
+     * Reasons why the order is not draftable.
      * @maxSize 5
      */
     nonDraftableReasons?: NonDraftableReason[];
 }
 export declare enum NonDraftableReason {
     UNSPECIFIED = "UNSPECIFIED",
+    /** Modifications of refunded orders are not supported. */
     PARTIALLY_OR_FULLY_REFUNDED = "PARTIALLY_OR_FULLY_REFUNDED",
+    /**
+     * Original order must be created via one of the following channel types:
+     * + WEB
+     * + POS
+     * + BACKOFFICE_MERCHANT
+     * + WIX_APP_STORE
+     */
     UNSUPPORTED_CHANNEL_TYPE = "UNSUPPORTED_CHANNEL_TYPE",
+    /** Order status is not APPROVED. */
     ORDER_STATUS_IS_NOT_SUPPORTED = "ORDER_STATUS_IS_NOT_SUPPORTED",
+    /** Site and order currencies are different. */
     ORDER_AND_SITE_CURRENCIES_ARE_INCONSISTENT = "ORDER_AND_SITE_CURRENCIES_ARE_INCONSISTENT",
+    /** Site and order weight units are different. */
     ORDER_AND_SITE_WEIGHT_UNITS_ARE_INCONSISTENT = "ORDER_AND_SITE_WEIGHT_UNITS_ARE_INCONSISTENT",
-    AMOUNTS_DO_NOT_ADD_UP = "AMOUNTS_DO_NOT_ADD_UP",
-    /** remove - this is not a reason, it's an error */
+    /** Order not found. */
     ORDER_NOT_FOUND = "ORDER_NOT_FOUND",
-    SUBSCRIPTION_LINE_ITEM_EXISTS = "SUBSCRIPTION_LINE_ITEM_EXISTS",
-    UNSUPPORTED_CATALOG_ITEM = "UNSUPPORTED_CATALOG_ITEM",
-    TAXABLE_EXISTING_ADDITIONAL_FEE = "TAXABLE_EXISTING_ADDITIONAL_FEE"
+    /** Modifications of orders with subscription items are not supported. */
+    SUBSCRIPTION_LINE_ITEM_EXISTS = "SUBSCRIPTION_LINE_ITEM_EXISTS"
 }
 export interface CommitDraftOrderRequest {
     /**
-     * The draft order id
+     * Draft order ID.
      * @format GUID
      */
     draftOrderId: string;
-    /** Optional side effects to trigger */
+    /** Optional side effects to trigger. */
     commitSettings?: DraftOrderCommitSettings;
     /**
      * Reason for edit, given by user (optional).
@@ -2177,9 +2328,9 @@ export interface CommitDraftOrderRequest {
     reason?: string | null;
 }
 export interface CommitDraftOrderResponse {
-    /** The draft order after commit. */
+    /** Draft order after commit. */
     committedDraftOrder?: DraftOrder;
-    /** The updated order after commit. */
+    /** Updated order after commit. */
     orderAfterCommit?: Order;
 }
 export interface Order {
@@ -3234,16 +3385,48 @@ export interface TagList {
     tagIds?: string[];
 }
 export interface CreateOrderFromDraftRequest {
+    /**
+     * Draft order ID.
+     * @format GUID
+     */
+    draftOrderId: string;
+    /** Optional side effects to trigger. */
+    createSettings?: OrderCreateSettings;
+    /**
+     * Reason for order creation, given by user (optional).
+     * @maxLength 200
+     */
+    reason?: string | null;
+    /** Information about the sales channel that submitted this order. */
+    channelInfo?: ChannelInfo;
 }
 export interface OrderCreateSettings {
+    /** Notification settings to be applied on order creation */
+    notifications?: OrderCreateNotifications;
 }
 export interface OrderCreateNotifications {
+    /**
+     * Whether to send notification to the buyer.
+     *
+     * Default: `true`
+     */
+    sendNotificationToBuyer?: boolean | null;
+    /**
+     * Whether to send notifications to the business.
+     *
+     * Default: `true`
+     */
+    sendNotificationsToBusiness?: boolean | null;
 }
 export interface CreateOrderFromDraftResponse {
+    /** The draft order after commit. */
+    committedDraftOrder?: DraftOrder;
+    /** Created order. */
+    createdOrder?: Order;
 }
 export interface DeleteDraftOrderRequest {
     /**
-     * The draft order id
+     * Draft order ID.
      * @format GUID
      */
     draftOrderId: string;
@@ -3251,7 +3434,7 @@ export interface DeleteDraftOrderRequest {
 export interface DeleteDraftOrderResponse {
 }
 export interface QueryDraftOrdersRequest {
-    /** WQL expression */
+    /** Query options. */
     query?: CursorQuery;
 }
 export interface CursorQuery extends CursorQueryPagingMethodOneOf {
@@ -3313,7 +3496,7 @@ export interface CursorPaging {
     cursor?: string | null;
 }
 export interface QueryDraftOrdersResponse {
-    /** list of edits per order */
+    /** Draft orders, found by query. */
     draftOrders?: DraftOrder[];
     /** Paging metadata. */
     pagingMetadata?: CursorPagingMetadata;
@@ -3345,42 +3528,45 @@ export interface Cursors {
 }
 export interface UpdateExtendedFieldsRequest {
     /** ID of the entity to update. */
-    id?: string;
+    id: string;
     /** Identifier for the app whose extended fields are being updated. */
-    namespace?: string;
+    namespace: string;
     /** Data to update. Structured according to the [schema](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields#json-schema-for-extended-fields) defined when the extended fields were configured. */
-    namespaceData?: Record<string, any> | null;
+    namespaceData: Record<string, any> | null;
 }
 export interface UpdateExtendedFieldsResponse {
-    /** Updated DraftOrder */
+    /** Updated draft order. */
     draftOrder?: DraftOrder;
 }
 export interface SetTaxExemptionRequest {
-}
-export interface SetTaxExemptionResponse {
-}
-export interface GetDraftEditabilityStatusRequest {
     /**
      * Draft order ID.
      * @format GUID
      */
-    draftOrderId?: string | null;
+    draftOrderId: string;
+    /**
+     * Flag, indicating whether the draft order is exempt from tax calculations.
+     *
+     * Default: `false`
+     */
+    taxExempt: boolean | null;
 }
-export interface GetDraftEditabilityStatusResponse {
+export interface SetTaxExemptionResponse {
+    /** Draft order details calculated with latest content. */
+    calculatedDraftOrder?: CalculatedDraftOrder;
+}
+export interface SetBusinessLocationRequest {
     /**
      * Draft order ID.
      * @format GUID
      */
-    draftOrderId?: string | null;
-    /**
-     * Draft order status.
-     * @readonly
-     */
-    status?: EditingStatus;
-}
-export interface SetBusinessLocationRequest {
+    draftOrderId: string;
+    /** Business location. */
+    businessLocation?: Location;
 }
 export interface SetBusinessLocationResponse {
+    /** Draft order details calculated with latest content. */
+    calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface DomainEvent extends DomainEventBodyOneOf {
     createdEvent?: EntityCreatedEvent;