@wix/auto_sdk_ecom_draft-orders 1.0.23 → 1.0.25

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

@@ -1,5 +1,8 @@
 import { NonNullablePaths } from '@wix/sdk-types';
-/** DraftOrder is the main entity of DraftOrders service. It represents a single edit order. */
+/**
+ * Draft Order main entity.
+ * A temporary version of an order, allowing modifications before finalization.
+ */
 export interface DraftOrder {
     /**
      * Draft order ID.
@@ -40,12 +43,14 @@ export interface DraftOrder {
     billingInfo?: AddressWithContact;
     /**
      * Additional fees.
+     *
      * Includes details about the source, and whether the additional fee is applied to the order.
      * @maxSize 100
      */
     additionalFees?: AdditionalFeeDetails[];
     /**
      * Discounts.
+     *
      * Includes details about the source, and whether the discount is applied to the order.
      * @maxSize 320
      */
@@ -123,11 +128,13 @@ export interface DraftOrder {
     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;
@@ -137,7 +144,8 @@ export interface DraftOrder {
      */
     billingDetails?: BillingDetails;
     /**
-     * Order business location
+     * Order business location.
+     *
      * Includes details about changes when relevant.
      */
     businessLocationDetails?: BusinessLocationDetails;
@@ -612,6 +620,11 @@ export interface SubscriptionInfo {
      * @immutable
      */
     subscriptionSettings?: SubscriptionSettings;
+    /**
+     * Description of the charges that will be applied for subscription.
+     * @maxLength 1000
+     */
+    chargesDescription?: string | null;
 }
 export interface SubscriptionTitle {
     /**
@@ -749,6 +762,63 @@ export interface ExtendedFields {
      */
     namespaces?: Record<string, Record<string, any>>;
 }
+export interface ModifierGroup {
+    /**
+     * Modifier group id.
+     * @minLength 1
+     * @maxLength 36
+     */
+    _id?: string;
+    /** Modifier group name. */
+    name?: TranslatableString;
+    /**
+     * List of modifiers in this group.
+     * @minSize 1
+     * @maxSize 10
+     */
+    modifiers?: ItemModifier[];
+}
+export interface TranslatableString {
+    /**
+     * __Required.__ String in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
+     *
+     * Min: 1 character.
+     * Max: 200 characters.
+     * @minLength 1
+     * @maxLength 200
+     */
+    original?: string;
+    /**
+     * String translated into the buyer's language.
+     *
+     * Min: 1 character.
+     * Max: 400 characters.
+     * Default: Same as `original`.
+     * @minLength 1
+     * @maxLength 400
+     */
+    translated?: string | null;
+}
+export interface ItemModifier {
+    /**
+     * Modifier ID.
+     * @minLength 1
+     * @maxLength 36
+     */
+    _id?: string;
+    /**
+     * The quantity of this modifier.
+     * @min 1
+     * @max 100000
+     */
+    quantity?: number | null;
+    /** Primary display label for the modifier. */
+    label?: TranslatableString;
+    /** Optional additional details or clarification for the modifier. */
+    details?: TranslatableString;
+    /** The price of the modifier. */
+    price?: Price;
+}
 export interface ItemChangedDetails {
     /**
      * Line item quantity before change.
@@ -1086,7 +1156,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.
+     * + `CUSTOM`: This additional fee was created by the Create Custom Additional Fees method.
      */
     source?: SourceType;
     /** Whether this additional fee is applied to the order. */
@@ -1132,10 +1202,10 @@ export interface AdditionalFee {
     lineItemIds?: string[];
 }
 export interface TaxDetails {
-    /** Indication if additional fee is taxable or not */
+    /** Whether the additional fee is taxable. */
     taxable?: boolean;
     /**
-     * Optional tax group ID to use when calculating tax for this additional fee
+     * Optional tax group ID to use when calculating tax for this additional fee.
      * @format GUID
      */
     taxGroupId?: string | null;
@@ -1156,7 +1226,7 @@ export interface DiscountDetails {
      *
      * Supported values:
      * + `ORIGINAL_ORDER`: This discount is part of the original order.
-     * + `CUSTOM`: This discount was created by the [Create Custom Discounts](https://dev.wix.com/docs/rest/api-reference/wix-e-commerce/draft-orders/create-custom-discounts) API.
+     * + `CUSTOM`: This discount was created by the Create Custom Discounts method.
      */
     source?: SourceType;
     /** Whether this discount is applied to the order. */
@@ -1311,9 +1381,13 @@ export interface CreatedByStringOneOf {
     appId?: string;
 }
 export declare enum EditingStatus {
-    /** Draft order can be modified and committed. */
+    /** Draft order is being edited. */
     DRAFT = "DRAFT",
-    /** Draft order is already committed. No further modifications allowed. */
+    /**
+     * Draft order has been committed - No further modifications allowed.
+     *
+     * Draft orders with status 'COMMITTED' cannot be deleted.
+     */
     COMMITTED = "COMMITTED"
 }
 export declare enum WeightUnit {
@@ -1347,7 +1421,7 @@ export interface TaxSummary {
 }
 export interface BalanceSummary {
     /**
-     * Amount left to pay for order to be considered paid.
+     * Amount left to pay for the order to be considered paid.
      * @readonly
      */
     balance?: Balance;
@@ -1587,31 +1661,33 @@ export interface BusinessLocationChangedDetails {
 }
 export interface CreateDraftOrderRequest {
     /**
-     * Existing order ID to create draft from.
+     * ID of the order to create a draft for.
      * @format GUID
      */
     orderId: string | null;
 }
 export interface CreateDraftOrderResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
     /**
-     * Flag indicating whether response contains draft order that existed before request.
-     * `False` - new draft order was created.
+     * Whether the response contains a draft order that existed before request.
+     *
+     * `true`: The draft order already exists and is updated.
+     * `false`: A new draft order is created.
      */
     preexistingDraftOrder?: boolean | null;
 }
 export interface CalculatedDraftOrder {
-    /** Draft order full details with calculations based on it's content. */
+    /** Draft order. */
     draftOrder?: DraftOrder;
-    /** Order shipping options. */
+    /** Shipping options. */
     shippingOptions?: ShippingOption[];
     /** Errors that occurred during calculation. */
     calculationErrors?: CalculationErrors;
 }
 export interface ShippingOption {
     /**
-     * This carrier's unique ID
+     * Carrier ID.
      * @format GUID
      */
     carrierId?: string | null;
@@ -1627,37 +1703,41 @@ export interface ShippingOption {
 export interface DeliveryLogistics {
     /** When the item is expected to be delivered in free text, e.g "3-5 business days" */
     deliveryTime?: string | null;
-    /** Instructions for caller, e.g for pickup: "Ensure to come during Opening Hours, and please don't park in disabled-spot" */
+    /**
+     * Instructions for delivery.
+     *
+     * For example, "Please arrive during business hours."
+     */
     instructions?: string | null;
-    /** Additional pickup details if it's a pickup */
+    /** Additional pickup details. */
     pickupDetails?: PickupDetails;
-    /** Expected delivery time slot (from and to time stamps representation) */
+    /** Expected delivery time slot. */
     deliveryTimeSlot?: DeliveryTimeSlot;
 }
 export interface PickupDetails {
-    /** Pickup address */
+    /** Pickup address. */
     address?: Address;
     /** 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 = "STORE_PICKUP",
-    /** Item is shipped to a specified pickup point. */
+    /** Pickup point. */
     PICKUP_POINT = "PICKUP_POINT"
 }
 export interface DeliveryTimeSlot {
-    /** starting time of the delivery time slot */
+    /** Delivery time slot start time. */
     from?: Date | null;
-    /** ending time of the delivery time slot */
+    /** Delivery time slot end time. */
     to?: Date | null;
 }
 export interface ShippingPrice {
-    /** The shipping rate's price. Must align with the [currency's decimal separator](https://en.wikipedia.org/wiki/ISO_4217#Active_codes). */
+    /** Shipping price. Must align with the [currency's decimal separator](https://en.wikipedia.org/wiki/ISO_4217#Active_codes). */
     price?: Price;
     /**
-     * Currency of the shipping rate price as a 3-letter [ISO-4217 currency code](https://en.wikipedia.org/wiki/ISO_4217). Must align with the `currency` passed to the function.
+     * Currency of the shipping price as a 3-letter [ISO-4217 currency code](https://en.wikipedia.org/wiki/ISO_4217). Must align with the `currency` passed to the method.
      * @format CURRENCY
      */
     currency?: string;
@@ -1786,7 +1866,7 @@ export interface CarrierError {
 export interface CreateEmptyDraftOrderRequest {
 }
 export interface CreateEmptyDraftOrderResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface AddLineItemsToDraftOrderRequest {
@@ -1801,7 +1881,9 @@ export interface AddLineItemsToDraftOrderRequest {
      */
     catalogLineItems?: CatalogReferenceLineItem[];
     /**
-     * Custom line items to add to draft order. Custom line items don't trigger the Catalog service plugin.
+     * Custom line items to add to draft order.
+     *
+     * Custom line items do not trigger the Catalog Service Plugin.
      * @maxSize 300
      */
     customLineItems?: CustomLineItem[];
@@ -1850,7 +1932,9 @@ export interface CustomLineItem {
      */
     quantity?: number;
     /**
-     * Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info.
+     * 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;
@@ -1919,7 +2003,7 @@ export declare enum FileType {
     SECURE_ARCHIVE = "SECURE_ARCHIVE"
 }
 export interface AddLineItemsToDraftOrderResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface UpdateLineItemsRequest {
@@ -1942,20 +2026,26 @@ export interface LineItemChangeDetails {
      */
     lineItemId?: string;
     /**
-     * The new quantity for the line item. Quantity zero removes the line item.
+     * The line item's new quantity.
+     *
+     * > **Note:** Passing `0` will remove the line item.
      * @max 1000000
      */
     newQuantity?: number | null;
     /**
-     * The new price for 1 unit of the line item.
+     * New price for 1 unit of the line item.
      * @decimalValue options { gte:0, lte:1000000000000000 }
      */
     newPrice?: string | null;
-    /** Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67". */
+    /**
+     * New description for the price.
+     *
+     * For example, when price is `0` but additional details about the actual price are needed - `"Starts at $67"`.
+     */
     newPriceDescription?: PriceDescription;
 }
 export interface UpdateLineItemsResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetDiscountsRequest {
@@ -1965,8 +2055,9 @@ export interface SetDiscountsRequest {
      */
     draftOrderId: string;
     /**
-     * Discount IDs to apply/unapply.
-     * Existing discounts, not mentioned in request, will keep their current state.
+     * Discounts to set on the draft order.
+     *
+     * Any existing discounts that are not passed will not change.
      * @minSize 1
      * @maxSize 320
      */
@@ -1974,15 +2065,17 @@ export interface SetDiscountsRequest {
 }
 export interface IdAndApplied {
     /**
-     * Entity ID. Depending on context, it's either discount or additional fee ID.
+     * Entity ID.
+     *
+     * Depending on the context, the value is either a discount ID or an additional fee ID.
      * @format GUID
      */
     _id?: string;
-    /** Flag indicating whether entity (discount/additional fee) should be applied to a draft order. */
+    /** Whether the discount or additional fee should be applied to the draft order. */
     applied?: boolean;
 }
 export interface SetDiscountsResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface CreateCustomDiscountsRequest {
@@ -1992,17 +2085,19 @@ export interface CreateCustomDiscountsRequest {
      */
     draftOrderId: string;
     /**
-     * Discounts to create. Created discounts are unapplied by default.
+     * Custom discounts to create.
+     *
+     * Created discounts are not applied by default.
      * @minSize 1
      * @maxSize 100
      */
     discounts?: DiscountOption[];
 }
 export interface DiscountOption extends DiscountOptionDiscountAmountOneOf {
-    /** Discount price amount. */
+    /** Amount to discount from the line item price. */
     priceAmount?: Price;
     /**
-     * Discount percentage amount.
+     * Percentage to discount from the line item price.
      * @format DECIMAL_VALUE
      * @decimalValue options { gte:0, lte:100, maxScale:2 }
      */
@@ -2030,8 +2125,9 @@ 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.
+     * Whether to apply the discount to the draft order.
+     *
+     * Default: `false`
      */
     applyToDraftOrder?: boolean | null;
     /**
@@ -2042,10 +2138,10 @@ export interface DiscountOption extends DiscountOptionDiscountAmountOneOf {
 }
 /** @oneof */
 export interface DiscountOptionDiscountAmountOneOf {
-    /** Discount price amount. */
+    /** Amount to discount from the line item price. */
     priceAmount?: Price;
     /**
-     * Discount percentage amount.
+     * Percentage to discount from the line item price.
      * @format DECIMAL_VALUE
      * @decimalValue options { gte:0, lte:100, maxScale:2 }
      */
@@ -2053,15 +2149,15 @@ export interface DiscountOptionDiscountAmountOneOf {
 }
 export declare enum DiscountType {
     UNKNOWN_TYPE = "UNKNOWN_TYPE",
-    /** Discount applies to entire order. */
+    /** Discount applies to the entire order. */
     GLOBAL = "GLOBAL",
-    /** Discount applies to specific items. */
+    /** Discount applies to a specific item. */
     SPECIFIC_ITEMS = "SPECIFIC_ITEMS",
-    /** Discount applies to shipping. For example, free shipping. */
+    /** Discount applies to shipping fee. */
     SHIPPING = "SHIPPING"
 }
 export interface CreateCustomDiscountsResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface DeleteCustomDiscountsRequest {
@@ -2071,7 +2167,7 @@ export interface DeleteCustomDiscountsRequest {
      */
     draftOrderId: string;
     /**
-     * Ids of discounts to remove.
+     * IDs of the discounts to remove from the draft order.
      * @format GUID
      * @minSize 1
      * @maxSize 100
@@ -2079,7 +2175,7 @@ export interface DeleteCustomDiscountsRequest {
     discountIds: string[];
 }
 export interface DeleteCustomDiscountsResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetAdditionalFeesRequest {
@@ -2089,15 +2185,16 @@ export interface SetAdditionalFeesRequest {
      */
     draftOrderId: string;
     /**
-     * Additional fee IDs to apply/unapply.
-     * Existing additional fees, not mentioned in this list, will keep their current state.
+     * Additional fees to set on the draft order.
+     *
+     * Any existing additional fees that are not passed will not change.
      * @minSize 1
      * @maxSize 100
      */
     additionalFees: IdAndApplied[];
 }
 export interface SetAdditionalFeesResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface CreateCustomAdditionalFeesRequest {
@@ -2107,7 +2204,9 @@ export interface CreateCustomAdditionalFeesRequest {
      */
     draftOrderId: string;
     /**
-     * The additional fees to create. Created fees are unapplied by default.
+     * Custom additional fees to create.
+     *
+     * Created additional fees are not applied by default.
      * @minSize 1
      * @maxSize 100
      */
@@ -2115,28 +2214,30 @@ export interface CreateCustomAdditionalFeesRequest {
 }
 export interface AdditionalFeeOption {
     /**
-     * Translated additional fee's name
+     * Name of the additional fee.
      * @minLength 1
      * @maxLength 50
      */
     name?: string;
-    /** Additional fee's price */
+    /** Price of the additional fee. */
     price?: Price;
-    /** Tax calculation details */
+    /** Tax calculation details. */
     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.
+     * Whether to apply the additional fee to the draft order.
+     *
+     * Default: `false`
      */
     applyToDraftOrder?: boolean | null;
     /**
-     * Additional fee's unique code (or ID) for future processing
+     * Additional fee unique code (or ID) for future processing.
      * @minLength 1
      * @maxLength 100
      */
     code?: string | null;
     /**
-     * Optional - Line items associated with this additional fee.
+     * IDs of the 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
@@ -2144,7 +2245,7 @@ export interface AdditionalFeeOption {
     lineItemIds?: string[];
 }
 export interface CreateCustomAdditionalFeesResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface DeleteCustomAdditionalFeesRequest {
@@ -2154,7 +2255,7 @@ export interface DeleteCustomAdditionalFeesRequest {
      */
     draftOrderId: string;
     /**
-     * Ids of additional fees to remove.
+     * IDs of the additional fees to remove from the draft order.
      * @format GUID
      * @minSize 1
      * @maxSize 100
@@ -2162,7 +2263,7 @@ export interface DeleteCustomAdditionalFeesRequest {
     customAdditionalFees: string[];
 }
 export interface DeleteCustomAdditionalFeesResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetShippingInfoRequest {
@@ -2171,11 +2272,15 @@ export interface SetShippingInfoRequest {
      * @format GUID
      */
     draftOrderId: string;
-    /** Shipping information. Empty value removes shipping information from draft. */
+    /**
+     * Shipping info to set on the draft order.
+     *
+     * > **Note:** Passing an empty object will remove the existing shipping info.
+     */
     shippingInfo?: V1ShippingInformation;
 }
 export interface SetShippingInfoResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetBuyerInfoRequest {
@@ -2184,11 +2289,15 @@ export interface SetBuyerInfoRequest {
      * @format GUID
      */
     draftOrderId: string;
-    /** Buyer information. Empty value removes buyer information from draft. */
+    /**
+     * Shipping info to set on the draft order.
+     *
+     * > **Note:** Passing an empty object will remove the existing shipping info.
+     */
     buyerInfo?: BuyerInfo;
 }
 export interface SetBuyerInfoResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetRecipientInfoRequest {
@@ -2197,11 +2306,15 @@ export interface SetRecipientInfoRequest {
      * @format GUID
      */
     draftOrderId: string;
-    /** Order recipient address and contact details. Empty value removes recipient information from draft. */
+    /**
+     * Recipient address and contact details.
+     *
+     * > **Note:** Passing an empty object will remove the existing recipient info.
+     */
     recipientInfo?: AddressWithContact;
 }
 export interface SetRecipientInfoResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetBillingInfoRequest {
@@ -2210,11 +2323,15 @@ export interface SetBillingInfoRequest {
      * @format GUID
      */
     draftOrderId: string;
-    /** Billing address and contact details. Empty value removes billing information from draft. */
+    /**
+     * Billing address and contact details.
+     *
+     * > **Note:** Passing an empty object will remove the existing billing info.
+     */
     billingInfo?: AddressWithContact;
 }
 export interface SetBillingInfoResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 /** Deprecated */
@@ -2229,7 +2346,7 @@ export interface UpdateShippingInfoRequest {
 }
 /** Deprecated */
 export interface UpdateShippingInfoResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface GetDraftOrderRequest {
@@ -2240,26 +2357,30 @@ export interface GetDraftOrderRequest {
     draftOrderId: string;
 }
 export interface GetDraftOrderResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface GetOrderDraftabilityStatusRequest {
     /**
-     * Order Id.
+     * Order ID.
      * @format GUID
      */
     orderId: string;
 }
 export interface GetOrderDraftabilityStatusResponse {
     /**
-     * Order Id.
+     * Order ID.
      * @format GUID
      */
     orderId?: string;
-    /** Flag, indicating whether a draft can be created from this order. */
+    /**
+     * Whether a draft can be created based on the order.
+     *
+     * Default: `false`
+     */
     orderDraftable?: boolean;
     /**
-     * Reasons why the order is not draftable.
+     * Reasons why a draft order cannot be created from the order.
      * @maxSize 5
      */
     nonDraftableReasons?: NonDraftableReason[];
@@ -2296,7 +2417,7 @@ export interface CommitDraftOrderRequest {
     /** Optional side effects to trigger. */
     commitSettings?: DraftOrderCommitSettings;
     /**
-     * Reason for edit, given by user (optional).
+     * Reason for edit, provided by user (optional).
      * @maxLength 200
      */
     reason?: string | null;
@@ -3367,7 +3488,7 @@ export interface CreateOrderFromDraftRequest {
     /** Optional side effects to trigger. */
     createSettings?: OrderCreateSettings;
     /**
-     * Reason for order creation, given by user (optional).
+     * Reason for order creation, provided by user (optional).
      * @maxLength 200
      */
     reason?: string | null;
@@ -3393,7 +3514,7 @@ export interface OrderCreateNotifications {
     sendNotificationsToBusiness?: boolean | null;
 }
 export interface CreateOrderFromDraftResponse {
-    /** The draft order after commit. */
+    /** Draft order after commit. */
     committedDraftOrder?: DraftOrder;
     /** Created order. */
     createdOrder?: Order;
@@ -3519,14 +3640,14 @@ export interface SetTaxExemptionRequest {
      */
     draftOrderId: string;
     /**
-     * Flag, indicating whether the draft order is exempt from tax calculations.
+     * Whether the draft order is exempt from tax calculations.
      *
      * Default: `false`
      */
     taxExempt: boolean | null;
 }
 export interface SetTaxExemptionResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetBusinessLocationRequest {
@@ -3539,7 +3660,7 @@ export interface SetBusinessLocationRequest {
     businessLocation?: Location;
 }
 export interface SetBusinessLocationResponse {
-    /** Draft order details calculated with latest content. */
+    /** Draft order calculated with the latest changes. */
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface DomainEvent extends DomainEventBodyOneOf {
@@ -3682,13 +3803,127 @@ export declare enum WebhookIdentityType {
     WIX_USER = "WIX_USER",
     APP = "APP"
 }
+export interface BaseEventMetadata {
+    /**
+     * App instance ID.
+     * @format GUID
+     */
+    instanceId?: string | null;
+    /**
+     * Event type.
+     * @maxLength 150
+     */
+    eventType?: string;
+    /** The identification type and identity data. */
+    identity?: IdentificationData;
+}
+export interface EventMetadata extends BaseEventMetadata {
+    /**
+     * Unique event ID.
+     * Allows clients to ignore duplicate webhooks.
+     */
+    _id?: string;
+    /**
+     * Assumes actions are also always typed to an entity_type
+     * Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction
+     */
+    entityFqdn?: string;
+    /**
+     * This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug)
+     * This is although the created/updated/deleted notion is duplication of the oneof types
+     * Example: created/updated/deleted/started/completed/email_opened
+     */
+    slug?: string;
+    /** ID of the entity associated with the event. */
+    entityId?: string;
+    /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z */
+    eventTime?: Date | null;
+    /**
+     * Whether the event was triggered as a result of a privacy regulation application
+     * (for example, GDPR).
+     */
+    triggeredByAnonymizeRequest?: boolean | null;
+    /** If present, indicates the action that triggered the event. */
+    originatedFrom?: string | null;
+    /**
+     * A sequence number defining the order of updates to the underlying entity.
+     * For example, given that some entity was updated at 16:00 and than again at 16:01,
+     * it is guaranteed that the sequence number of the second update is strictly higher than the first.
+     * As the consumer, you can use this value to ensure that you handle messages in the correct order.
+     * To do so, you will need to persist this number on your end, and compare the sequence number from the
+     * message against the one you have stored. Given that the stored number is higher, you should ignore the message.
+     */
+    entityEventSequence?: string | null;
+}
+export interface DraftOrderCreatedEnvelope {
+    entity: DraftOrder;
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when a draft order is created.
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Manage eCommerce - all permissions
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
+ * @permissionId ECOM.DRAFT_ORDERS_READ
+ * @webhook
+ * @eventType wix.ecom.v1.draft_order_created
+ * @slug created
+ * @documentationMaturity preview
+ */
+export declare function onDraftOrderCreated(handler: (event: DraftOrderCreatedEnvelope) => void | Promise<void>): void;
+export interface DraftOrderDeletedEnvelope {
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when a draft order is deleted.
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Manage eCommerce - all permissions
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
+ * @permissionId ECOM.DRAFT_ORDERS_READ
+ * @webhook
+ * @eventType wix.ecom.v1.draft_order_deleted
+ * @slug deleted
+ * @documentationMaturity preview
+ */
+export declare function onDraftOrderDeleted(handler: (event: DraftOrderDeletedEnvelope) => void | Promise<void>): void;
+export interface DraftOrderUpdatedEnvelope {
+    entity: DraftOrder;
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when a draft order is updated.
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Manage eCommerce - all permissions
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
+ * @permissionId ECOM.DRAFT_ORDERS_READ
+ * @webhook
+ * @eventType wix.ecom.v1.draft_order_updated
+ * @slug updated
+ * @documentationMaturity preview
+ */
+export declare function onDraftOrderUpdated(handler: (event: DraftOrderUpdatedEnvelope) => void | Promise<void>): void;
 type DraftOrderNonNullablePaths = `lineItems` | `lineItems.${number}.added` | `lineItems.${number}.changedDetails.priceBeforeChange.amount` | `lineItems.${number}.changedDetails.priceBeforeChange.formattedAmount` | `lineItems.${number}.changedDetails.priceDescriptionBeforeChange.original` | `lineItems.${number}.removed` | `lineItems.${number}.lineItem._id` | `lineItems.${number}.lineItem.productName.original` | `lineItems.${number}.lineItem.catalogReference.catalogItemId` | `lineItems.${number}.lineItem.catalogReference.appId` | `lineItems.${number}.lineItem.quantity` | `lineItems.${number}.lineItem.physicalProperties.shippable` | `lineItems.${number}.lineItem.itemType.preset` | `lineItems.${number}.lineItem.itemType.custom` | `lineItems.${number}.lineItem.paymentOption` | `lineItems.${number}.lineItem.taxDetails.taxRate` | `lineItems.${number}.lineItem.taxInfo.taxIncludedInPrice` | `lineItems.${number}.lineItem.digitalFile.fileId` | `lineItems.${number}.lineItem.subscriptionInfo.cycleNumber` | `lineItems.${number}.lineItem.subscriptionInfo.subscriptionOptionTitle` | `lineItems.${number}.lineItem.subscriptionInfo.subscriptionSettings.frequency` | `lineItems.${number}.lineItem.subscriptionInfo.subscriptionSettings.autoRenewal` | `lineItems.${number}.lineItem.taxableAddress.addressType` | `shippingInfo.added` | `shippingInfo.changedDetails.shippingInfoBeforeChange.title` | `shippingInfo.changedDetails.shippingInfoBeforeChange.logistics.shippingDestination.address.streetAddress.number` | `shippingInfo.changedDetails.shippingInfoBeforeChange.logistics.shippingDestination.address.streetAddress.name` | `shippingInfo.changedDetails.shippingInfoBeforeChange.logistics.shippingDestination.contactDetails.vatId._id` | `shippingInfo.changedDetails.shippingInfoBeforeChange.logistics.shippingDestination.contactDetails.vatId.type` | `shippingInfo.changedDetails.shippingInfoBeforeChange.logistics.pickupDetails.pickupMethod` | `shippingInfo.changedDetails.shippingInfoBeforeChange.cost.price.amount` | `shippingInfo.changedDetails.shippingInfoBeforeChange.cost.price.formattedAmount` | `shippingInfo.changedDetails.shippingInfoBeforeChange.cost.taxDetails.taxRate` | `shippingInfo.removed` | `buyerInfo.visitorId` | `buyerInfo.memberId` | `billingInfo.address.streetAddress.number` | `billingInfo.address.streetAddress.name` | `billingInfo.contactDetails.vatId._id` | `billingInfo.contactDetails.vatId.type` | `additionalFees` | `additionalFees.${number}.additionalFee.name` | `additionalFees.${number}.additionalFee.price.amount` | `additionalFees.${number}.additionalFee.price.formattedAmount` | `additionalFees.${number}.additionalFee.taxDetails.taxRate` | `additionalFees.${number}.additionalFee._id` | `additionalFees.${number}.taxDetails.taxable` | `additionalFees.${number}.source` | `additionalFees.${number}.applied` | `discounts` | `discounts.${number}.discount.coupon._id` | `discounts.${number}.discount.coupon.code` | `discounts.${number}.discount.coupon.name` | `discounts.${number}.discount.coupon.amount.amount` | `discounts.${number}.discount.coupon.amount.formattedAmount` | `discounts.${number}.discount.merchantDiscount.discountReason` | `discounts.${number}.discount.discountRule._id` | `discounts.${number}.discount.discountRule.name.original` | `discounts.${number}.discount.discountType` | `discounts.${number}.source` | `discounts.${number}.applied` | `createdBy.userId` | `createdBy.appId` | `status` | `weightUnit` | `priceSummary.subtotal.amount` | `priceSummary.subtotal.formattedAmount` | `taxSummary.totalTax.amount` | `taxSummary.totalTax.formattedAmount` | `balanceSummary.balance.amount` | `balanceSummary.balance.formattedAmount` | `balanceSummary.paid.amount` | `balanceSummary.paid.formattedAmount` | `commitSettings.updateInventory` | `commitSettings.updateInventory.${number}.lineItemId` | `recipientInfo.added` | `recipientInfo.changedDetails.recipientInfoBeforeChange.address.streetAddress.number` | `recipientInfo.changedDetails.recipientInfoBeforeChange.address.streetAddress.name` | `recipientInfo.changedDetails.recipientInfoBeforeChange.contactDetails.vatId._id` | `recipientInfo.changedDetails.recipientInfoBeforeChange.contactDetails.vatId.type` | `recipientInfo.removed` | `taxInfo.totalTax.amount` | `taxInfo.totalTax.formattedAmount` | `taxInfo.taxBreakdown` | `taxInfo.taxBreakdown.${number}.taxName` | `taxInfo.taxBreakdown.${number}.taxType` | `taxInfo.taxBreakdown.${number}.jurisdiction` | `taxInfo.taxBreakdown.${number}.jurisdictionType` | `taxInfo.taxBreakdown.${number}.rate` | `buyerDetails.added` | `buyerDetails.changedDetails.buyerInfoBeforeChange.visitorId` | `buyerDetails.changedDetails.buyerInfoBeforeChange.memberId` | `buyerDetails.removed` | `billingDetails.added` | `billingDetails.changedDetails.billingInfoBeforeChange.address.streetAddress.number` | `billingDetails.changedDetails.billingInfoBeforeChange.address.streetAddress.name` | `billingDetails.changedDetails.billingInfoBeforeChange.contactDetails.vatId._id` | `billingDetails.changedDetails.billingInfoBeforeChange.contactDetails.vatId.type` | `billingDetails.removed` | `businessLocationDetails.added` | `businessLocationDetails.changedDetails.businessLocationBeforeChange._id` | `businessLocationDetails.changedDetails.businessLocationBeforeChange.name` | `businessLocationDetails.removed`;
 /**
- * Creates or gets a draft order.
+ * Creates or retrieves a draft order based on the specified order ID.
  *
- * When passing the ID of an order that is already in draft, the existing draft order will be returned.
- * To complete a draft and update the order, call Commit Draft Order([REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/draft-orders/commit-draft-order) | [SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/commit-draft-order)).
- * @param orderId - Existing order ID to create draft from.
+ * When passing the ID of an order that is already in draft, the existing draft order is returned.
+ * To complete a draft and update the original order, call Commit Draft Order.
+ * @param orderId - ID of the order to create a draft for.
  * @public
  * @documentationMaturity preview
  * @requiredField orderId
@@ -3697,6 +3932,8 @@ type DraftOrderNonNullablePaths = `lineItems` | `lineItems.${number}.added` | `l
  * @permissionId DRAFT_ORDER_WRITE_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -3709,6 +3946,8 @@ export declare function createDraftOrder(orderId: string): Promise<NonNullablePa
 }[DraftOrderNonNullablePaths] | `calculatedDraftOrder.shippingOptions` | `calculatedDraftOrder.shippingOptions.${number}.code` | `calculatedDraftOrder.shippingOptions.${number}.title` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.number` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.name` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.pickupMethod` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.amount` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.formattedAmount` | `calculatedDraftOrder.shippingOptions.${number}.cost.currency` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.code` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.field` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.violatedRule` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors.${number}.carrierId` | `calculatedDraftOrder.calculationErrors.orderValidationErrors`>>;
 /**
  * Creates an empty draft order.
+ *
+ * After all relevant details are applied, call Create Order From Draft to convert the draft order to a regular order.
  * @public
  * @documentationMaturity preview
  * @permissionId ECOM.DRAFT_ORDERS_CREATE
@@ -3716,6 +3955,8 @@ export declare function createDraftOrder(orderId: string): Promise<NonNullablePa
  * @permissionId DRAFT_ORDER_WRITE_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -3727,7 +3968,7 @@ export declare function createEmptyDraftOrder(): Promise<NonNullablePaths<Create
     [P in DraftOrderNonNullablePaths]: `calculatedDraftOrder.draftOrder.${P}`;
 }[DraftOrderNonNullablePaths] | `calculatedDraftOrder.shippingOptions` | `calculatedDraftOrder.shippingOptions.${number}.code` | `calculatedDraftOrder.shippingOptions.${number}.title` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.number` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.name` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.pickupMethod` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.amount` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.formattedAmount` | `calculatedDraftOrder.shippingOptions.${number}.cost.currency` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.code` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.field` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.violatedRule` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors.${number}.carrierId` | `calculatedDraftOrder.calculationErrors.orderValidationErrors`>>;
 /**
- * Adds line items to a draft order.
+ * Adds catalog or custom line items to a draft order.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -3736,6 +3977,8 @@ export declare function createEmptyDraftOrder(): Promise<NonNullablePaths<Create
  * @permissionId ECOM.DRAFT_ORDERS_ADD_LINE_ITEMS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -3753,7 +3996,9 @@ export interface AddLineItemsToDraftOrderOptions {
      */
     catalogLineItems?: CatalogReferenceLineItem[];
     /**
-     * Custom line items to add to draft order. Custom line items don't trigger the Catalog service plugin.
+     * Custom line items to add to draft order.
+     *
+     * Custom line items do not trigger the Catalog Service Plugin.
      * @maxSize 300
      */
     customLineItems?: CustomLineItem[];
@@ -3761,11 +4006,11 @@ export interface AddLineItemsToDraftOrderOptions {
 /**
  * Updates a draft order's line items.
  *
- * Using this API, you can update a line item's quantity, price, and description.
+ * You can update a line item's quantity, price, and description.
  * > **Notes:**
- * > + Passing a quantity of `0` will remove the line item.
+ * > + Specifying a quantity of `0` will remove the line item.
  * > + Price cannot be updated for line items with `paymentOption: MEMBERSHIP`.
- * > + Quantity cannot be decreased fulfilled line items. To get fulfillment information, pass the order ID to [List Fulfillments For Single Order](https://dev.wix.com/docs/rest/api-reference/wix-e-commerce/order-fulfillments/list-fulfillments-for-single-order).
+ * > + Quantity cannot be decreased for fulfilled line items. To retrieve fulfillment information, specify the order ID when calling List Fulfillments For Single Order ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/order-fulfillments/list-fulfillments-for-single-order) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/order-fulfillments/list-fulfillments-for-single-order)).
  * @param draftOrderId - Draft order ID.
  * @param lineItemChanges - Details of changes to apply per line item.
  * @public
@@ -3776,6 +4021,8 @@ export interface AddLineItemsToDraftOrderOptions {
  * @permissionId ECOM.DRAFT_ORDERS_MODIFY_ITEMS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -3789,11 +4036,12 @@ export declare function updateLineItems(draftOrderId: string, lineItemChanges: N
 /**
  * Applies or unapplies discounts on a draft order.
  *
- * Unapplied discounts are still part of draft order, but do not affect balance.
- * Existing discounts, not mentioned in request, will keep their current state.
+ * Unapplied discounts are still part of the draft order, but do not affect balance.
+ * Existing discounts that are not passed in the request will keep their current state.
  * @param draftOrderId - Draft order ID.
- * @param discounts - Discount IDs to apply/unapply.
- * Existing discounts, not mentioned in request, will keep their current state.
+ * @param discounts - Discounts to set on the draft order.
+ *
+ * Any existing discounts that are not passed will not change.
  * @public
  * @documentationMaturity preview
  * @requiredField discounts
@@ -3803,6 +4051,8 @@ export declare function updateLineItems(draftOrderId: string, lineItemChanges: N
  * @permissionId ECOM.DRAFT_ORDERS_SET_DISCOUNTS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -3814,10 +4064,10 @@ export declare function setDiscounts(draftOrderId: string, discounts: NonNullabl
     [P in DraftOrderNonNullablePaths]: `calculatedDraftOrder.draftOrder.${P}`;
 }[DraftOrderNonNullablePaths] | `calculatedDraftOrder.shippingOptions` | `calculatedDraftOrder.shippingOptions.${number}.code` | `calculatedDraftOrder.shippingOptions.${number}.title` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.number` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.name` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.pickupMethod` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.amount` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.formattedAmount` | `calculatedDraftOrder.shippingOptions.${number}.cost.currency` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.code` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.field` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.violatedRule` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors.${number}.carrierId` | `calculatedDraftOrder.calculationErrors.orderValidationErrors`>>;
 /**
- * Create custom discounts on a draft order.
+ * Creates custom discounts.
  *
- * Newly added discounts are unapplied by default.
- * To apply them, use Set Discounts ([REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/draft-orders/set-discounts) | [SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/set-discounts)).
+ * Newly created discounts are unapplied by default.
+ * To apply them, use Set Discounts.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -3828,6 +4078,8 @@ export declare function setDiscounts(draftOrderId: string, discounts: NonNullabl
  * @permissionId ECOM.DRAFT_ORDERS_ADD_DISCOUNTS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -3840,16 +4092,18 @@ export declare function createCustomDiscounts(draftOrderId: string, options?: No
 }[DraftOrderNonNullablePaths] | `calculatedDraftOrder.shippingOptions` | `calculatedDraftOrder.shippingOptions.${number}.code` | `calculatedDraftOrder.shippingOptions.${number}.title` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.number` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.name` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.pickupMethod` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.amount` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.formattedAmount` | `calculatedDraftOrder.shippingOptions.${number}.cost.currency` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.code` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.field` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.violatedRule` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors.${number}.carrierId` | `calculatedDraftOrder.calculationErrors.orderValidationErrors`>>;
 export interface CreateCustomDiscountsOptions {
     /**
-     * Discounts to create. Created discounts are unapplied by default.
+     * Custom discounts to create.
+     *
+     * Created discounts are not applied by default.
      * @minSize 1
      * @maxSize 100
      */
     discounts?: DiscountOption[];
 }
 /**
- * Remove custom discounts from the order.
+ * Removes custom discounts from a draft order.
  * @param draftOrderId - Draft order ID.
- * @param discountIds - Ids of discounts to remove.
+ * @param discountIds - IDs of the discounts to remove from the draft order.
  * @public
  * @documentationMaturity preview
  * @requiredField discountIds
@@ -3857,6 +4111,8 @@ export interface CreateCustomDiscountsOptions {
  * @permissionId ECOM.DRAFT_ORDERS_DELETE_DISCOUNTS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -3870,11 +4126,12 @@ export declare function deleteCustomDiscounts(draftOrderId: string, discountIds:
 /**
  * Applies or unapplies additional fees on a draft order.
  *
- * Unapplied fees are still part of draft order, but do not affect balance.
- * Existing additional fees, not mentioned in request, will keep their current state.
+ * Additional fees that are not applied are still part of the draft order, but do not affect balance.
+ * Existing additional fees that are not passed in the request will keep their current state.
  * @param draftOrderId - Draft order ID.
- * @param additionalFees - Additional fee IDs to apply/unapply.
- * Existing additional fees, not mentioned in this list, will keep their current state.
+ * @param additionalFees - Additional fees to set on the draft order.
+ *
+ * Any existing additional fees that are not passed will not change.
  * @public
  * @documentationMaturity preview
  * @requiredField additionalFees
@@ -3884,6 +4141,8 @@ export declare function deleteCustomDiscounts(draftOrderId: string, discountIds:
  * @permissionId ECOM.DRAFT_ORDERS_SET_ADDITIONAL_FEES
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -3897,8 +4156,8 @@ export declare function setAdditionalFees(draftOrderId: string, additionalFees:
 /**
  * Creates custom additional fees on a draft order.
  *
- * Newly added additional fees are unapplied by default.
- * To apply them, use Set Additional Fees ([REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/draft-orders/set-additional-fees) | [SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/set-additional-fees)).
+ * Newly created additional fees are not applied by default.
+ * To apply them, use Set Additional Fees.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -3909,6 +4168,8 @@ export declare function setAdditionalFees(draftOrderId: string, additionalFees:
  * @permissionId ECOM.DRAFT_ORDERS_CREATE_ADDITIONAL_FEES
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -3921,16 +4182,18 @@ export declare function createCustomAdditionalFees(draftOrderId: string, options
 }[DraftOrderNonNullablePaths] | `calculatedDraftOrder.shippingOptions` | `calculatedDraftOrder.shippingOptions.${number}.code` | `calculatedDraftOrder.shippingOptions.${number}.title` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.number` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.name` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.pickupMethod` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.amount` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.formattedAmount` | `calculatedDraftOrder.shippingOptions.${number}.cost.currency` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.code` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.field` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.violatedRule` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors.${number}.carrierId` | `calculatedDraftOrder.calculationErrors.orderValidationErrors`>>;
 export interface CreateCustomAdditionalFeesOptions {
     /**
-     * The additional fees to create. Created fees are unapplied by default.
+     * Custom additional fees to create.
+     *
+     * Created additional fees are not applied by default.
      * @minSize 1
      * @maxSize 100
      */
     customAdditionalFees?: AdditionalFeeOption[];
 }
 /**
- * Remove custom additional fees from the order.
+ * Removes custom additional fees from a draft order.
  * @param draftOrderId - Draft order ID.
- * @param customAdditionalFees - Ids of additional fees to remove.
+ * @param customAdditionalFees - IDs of the additional fees to remove from the draft order.
  * @public
  * @documentationMaturity preview
  * @requiredField customAdditionalFees
@@ -3938,6 +4201,8 @@ export interface CreateCustomAdditionalFeesOptions {
  * @permissionId ECOM.DRAFT_ORDERS_DELETE_ADDITIONAL_FEES
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -3957,6 +4222,8 @@ export declare function deleteCustomAdditionalFees(draftOrderId: string, customA
  * @permissionId ECOM.DRAFT_ORDERS_SET_SHIPPING_INFO
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -3968,7 +4235,11 @@ export declare function setShippingInfo(draftOrderId: string, options?: SetShipp
     [P in DraftOrderNonNullablePaths]: `calculatedDraftOrder.draftOrder.${P}`;
 }[DraftOrderNonNullablePaths] | `calculatedDraftOrder.shippingOptions` | `calculatedDraftOrder.shippingOptions.${number}.code` | `calculatedDraftOrder.shippingOptions.${number}.title` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.number` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.name` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.pickupMethod` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.amount` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.formattedAmount` | `calculatedDraftOrder.shippingOptions.${number}.cost.currency` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.code` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.field` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.violatedRule` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors.${number}.carrierId` | `calculatedDraftOrder.calculationErrors.orderValidationErrors`>>;
 export interface SetShippingInfoOptions {
-    /** Shipping information. Empty value removes shipping information from draft. */
+    /**
+     * Shipping info to set on the draft order.
+     *
+     * > **Note:** Passing an empty object will remove the existing shipping info.
+     */
     shippingInfo?: V1ShippingInformation;
 }
 /**
@@ -3980,6 +4251,8 @@ export interface SetShippingInfoOptions {
  * @permissionId ECOM.DRAFT_ORDER_SET_BUYER_INFO
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -3991,7 +4264,11 @@ export declare function setBuyerInfo(draftOrderId: string, options?: SetBuyerInf
     [P in DraftOrderNonNullablePaths]: `calculatedDraftOrder.draftOrder.${P}`;
 }[DraftOrderNonNullablePaths] | `calculatedDraftOrder.shippingOptions` | `calculatedDraftOrder.shippingOptions.${number}.code` | `calculatedDraftOrder.shippingOptions.${number}.title` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.number` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.name` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.pickupMethod` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.amount` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.formattedAmount` | `calculatedDraftOrder.shippingOptions.${number}.cost.currency` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.code` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.field` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.violatedRule` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors.${number}.carrierId` | `calculatedDraftOrder.calculationErrors.orderValidationErrors`>>;
 export interface SetBuyerInfoOptions {
-    /** Buyer information. Empty value removes buyer information from draft. */
+    /**
+     * Shipping info to set on the draft order.
+     *
+     * > **Note:** Passing an empty object will remove the existing shipping info.
+     */
     buyerInfo?: BuyerInfo;
 }
 /**
@@ -4003,6 +4280,8 @@ export interface SetBuyerInfoOptions {
  * @permissionId ECOM.DRAFT_ORDER_SET_RECIPIENT_INFO
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4014,7 +4293,11 @@ export declare function setRecipientInfo(draftOrderId: string, options?: SetReci
     [P in DraftOrderNonNullablePaths]: `calculatedDraftOrder.draftOrder.${P}`;
 }[DraftOrderNonNullablePaths] | `calculatedDraftOrder.shippingOptions` | `calculatedDraftOrder.shippingOptions.${number}.code` | `calculatedDraftOrder.shippingOptions.${number}.title` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.number` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.name` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.pickupMethod` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.amount` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.formattedAmount` | `calculatedDraftOrder.shippingOptions.${number}.cost.currency` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.code` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.field` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.violatedRule` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors.${number}.carrierId` | `calculatedDraftOrder.calculationErrors.orderValidationErrors`>>;
 export interface SetRecipientInfoOptions {
-    /** Order recipient address and contact details. Empty value removes recipient information from draft. */
+    /**
+     * Recipient address and contact details.
+     *
+     * > **Note:** Passing an empty object will remove the existing recipient info.
+     */
     recipientInfo?: AddressWithContact;
 }
 /**
@@ -4026,6 +4309,8 @@ export interface SetRecipientInfoOptions {
  * @permissionId ECOM.DRAFT_ORDER_SET_BILLING_INFO
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4037,16 +4322,22 @@ export declare function setBillingInfo(draftOrderId: string, options?: SetBillin
     [P in DraftOrderNonNullablePaths]: `calculatedDraftOrder.draftOrder.${P}`;
 }[DraftOrderNonNullablePaths] | `calculatedDraftOrder.shippingOptions` | `calculatedDraftOrder.shippingOptions.${number}.code` | `calculatedDraftOrder.shippingOptions.${number}.title` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.number` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.name` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.pickupMethod` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.amount` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.formattedAmount` | `calculatedDraftOrder.shippingOptions.${number}.cost.currency` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.code` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.field` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.violatedRule` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors.${number}.carrierId` | `calculatedDraftOrder.calculationErrors.orderValidationErrors`>>;
 export interface SetBillingInfoOptions {
-    /** Billing address and contact details. Empty value removes billing information from draft. */
+    /**
+     * Billing address and contact details.
+     *
+     * > **Note:** Passing an empty object will remove the existing billing info.
+     */
     billingInfo?: AddressWithContact;
 }
 /**
- * Gets a draft order.
+ * Retrieves a draft order.
+ *
+ * The retrieved draft order contains the latest calculations:
+ * + Line items, shipping details, and buyer information.
+ * + Tax details and price totals.
+ * + Automatic discounts and automatic additional fees, along with updated eligibility.
  *
- * Draft order is recalculated and contains latest tax and totals (unless already committed).
- * Automatic discounts and automatic additional fees will reflect the latest prices and eligibility.
- * Calculation will be based on current draft order content - items, shipping info and eligible discounts and additional fees.
- * When retrieving an already committed draft, it's not recalculated and contains data calculated during commit.
+ * > **Note:** When retrieving a committed draft order, it **is not recalculated**.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -4055,6 +4346,8 @@ export interface SetBillingInfoOptions {
  * @permissionId ECOM.DRAFT_ORDER_READ_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4066,14 +4359,16 @@ export declare function getDraftOrder(draftOrderId: string): Promise<NonNullable
     [P in DraftOrderNonNullablePaths]: `calculatedDraftOrder.draftOrder.${P}`;
 }[DraftOrderNonNullablePaths] | `calculatedDraftOrder.shippingOptions` | `calculatedDraftOrder.shippingOptions.${number}.code` | `calculatedDraftOrder.shippingOptions.${number}.title` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.number` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.name` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.pickupMethod` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.amount` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.formattedAmount` | `calculatedDraftOrder.shippingOptions.${number}.cost.currency` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.code` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.field` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.violatedRule` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors.${number}.carrierId` | `calculatedDraftOrder.calculationErrors.orderValidationErrors`>>;
 /**
- * Checks whether a draft can be created for this order.
- * @param orderId - Order Id.
+ * Checks whether a draft can be created for an order.
+ * @param orderId - Order ID.
  * @public
  * @documentationMaturity preview
  * @requiredField orderId
  * @permissionId ECOM.DRAFT_ORDERS_READ
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4083,10 +4378,13 @@ export declare function getDraftOrder(draftOrderId: string): Promise<NonNullable
  */
 export declare function getOrderDraftabilityStatus(orderId: string): Promise<NonNullablePaths<GetOrderDraftabilityStatusResponse, `orderId` | `orderDraftable` | `nonDraftableReasons`>>;
 /**
- * Commit latest changes to the baseline order and control which side-effects are executed.
+ * Finalizes a draft order and applies its modifications to the associated order.
+ * You can also control which side-effects are executed on commit.
  *
- * Commit cannot be undone or reverted.
- * Committed draft will become closed for further modifications, however it's kept for reference and can be retrieved.
+ * > **Notes:**
+ * > + The draft order's status is set to `COMMITTED`.
+ * > + Commiting a draft order cannot be undone or reverted.
+ * > + A committed draft order does not allow for further modifications. However, it is kept for reference and can be retrieved.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -4095,6 +4393,8 @@ export declare function getOrderDraftabilityStatus(orderId: string): Promise<Non
  * @permissionId ECOM.DRAFT_ORDER_READ_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4109,16 +4409,18 @@ export interface CommitDraftOrderOptions {
     /** Optional side effects to trigger. */
     commitSettings?: DraftOrderCommitSettings;
     /**
-     * Reason for edit, given by user (optional).
+     * Reason for edit, provided by user (optional).
      * @maxLength 200
      */
     reason?: string | null;
 }
 /**
- * Creates a new order while specifying which side-effects are executed.
+ * Creates a new order from a draft, while specifying which side-effects are executed.
  *
- * Commit cannot be undone or reverted.
- * Committed draft will become closed for further modifications, however it's kept for reference and can be retrieved.
+ * > **Notes:**
+ * > + The draft order's status is set to `COMMITTED`.
+ * > + Commiting a draft order cannot be undone or reverted.
+ * > + A committed draft order does not allow for further modifications. However, it is kept for reference and can be retrieved.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -4127,6 +4429,8 @@ export interface CommitDraftOrderOptions {
  * @permissionId ECOM.DRAFT_ORDER_READ_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4141,7 +4445,7 @@ export interface CreateOrderFromDraftOptions {
     /** Optional side effects to trigger. */
     createSettings?: OrderCreateSettings;
     /**
-     * Reason for order creation, given by user (optional).
+     * Reason for order creation, provided by user (optional).
      * @maxLength 200
      */
     reason?: string | null;
@@ -4151,7 +4455,7 @@ export interface CreateOrderFromDraftOptions {
 /**
  * Deletes a draft order along with all its pending changes.
  *
- * Draft orders in status 'COMMITTED' cannot be deleted.
+ * Draft orders with status 'COMMITTED' cannot be deleted.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -4160,6 +4464,8 @@ export interface CreateOrderFromDraftOptions {
  * @permissionId ECOM.DRAFT_ORDERS_ADMIN_DELETE
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4178,11 +4484,14 @@ export declare function deleteDraftOrder(draftOrderId: string): Promise<void>;
  * | `_updatedDate` | `eq()`, `ne()`, `exists()`, `in()`, `hasSome()`, `lt()`, `le()`, `gt()`, `ge()` | Sortable     |
  * | `status`       | `eq()`, `ne()`, `exists()`, `in()`, `hasSome()`                                 | Sortable     |
  * | `orderId`      | `eq()`, `ne()`, `exists()`, `in()`, `hasSome()`, `startsWith()`                 |              |
+ *
  * To learn how to query draft orders, see [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language).
  * @public
  * @documentationMaturity preview
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4283,12 +4592,16 @@ export interface DraftOrdersQueryBuilder {
  * @permissionId ECOM.DRAFT_ORDER_WRITE_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4306,7 +4619,9 @@ export interface UpdateExtendedFieldsOptions {
     namespaceData: Record<string, any> | null;
 }
 /**
- * Sets tax exemption on a draft order.
+ * Sets whether a draft order is tax-exempt.
+ *
+ * A tax exempted draft order ignores taxes during calculation. Tax information will return empty.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -4316,6 +4631,8 @@ export interface UpdateExtendedFieldsOptions {
  * @permissionId ECOM.DRAFT_ORDER_SET_TAX_EXEMPTION
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4328,7 +4645,7 @@ export declare function setTaxExemption(draftOrderId: string, options: NonNullab
 }[DraftOrderNonNullablePaths] | `calculatedDraftOrder.shippingOptions` | `calculatedDraftOrder.shippingOptions.${number}.code` | `calculatedDraftOrder.shippingOptions.${number}.title` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.number` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.name` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.pickupMethod` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.amount` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.formattedAmount` | `calculatedDraftOrder.shippingOptions.${number}.cost.currency` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.code` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.field` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.violatedRule` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors.${number}.carrierId` | `calculatedDraftOrder.calculationErrors.orderValidationErrors`>>;
 export interface SetTaxExemptionOptions {
     /**
-     * Flag, indicating whether the draft order is exempt from tax calculations.
+     * Whether the draft order is exempt from tax calculations.
      *
      * Default: `false`
      */
@@ -4336,6 +4653,8 @@ export interface SetTaxExemptionOptions {
 }
 /**
  * Sets business location on a draft order.
+ *
+ * When committed, the order will become associated to a specific business location. This affects who can see and manage this order, and how it is calculated in reports.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -4344,6 +4663,8 @@ export interface SetTaxExemptionOptions {
  * @permissionId ECOM.DRAFT_ORDER_SET_BUSINESS_LOCATION
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions