@wix/auto_sdk_ecom_draft-orders 1.0.23 → 1.0.24

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

@@ -1,5 +1,5 @@
 import { NonNullablePaths } from '@wix/sdk-types';
-/** DraftOrder is the main entity of DraftOrders service. It represents a single edit order. */
+/** Draft Orders main entity. */
 export interface DraftOrder {
     /**
      * Draft order ID.
@@ -40,12 +40,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 +125,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 +141,8 @@ export interface DraftOrder {
      */
     billingDetails?: BillingDetails;
     /**
-     * Order business location
+     * Order business location.
+     *
      * Includes details about changes when relevant.
      */
     businessLocationDetails?: BusinessLocationDetails;
@@ -1132,10 +1137,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;
@@ -1311,9 +1316,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 +1356,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 +1596,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 +1638,39 @@ 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",
-    /** Item is shipped to a specified 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 +1799,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 +1814,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 +1865,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 +1936,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 +1959,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 +1988,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 +1998,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 +2018,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 +2058,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 +2071,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 +2082,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 +2100,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 +2108,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 +2118,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 +2137,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 +2147,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 +2178,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 +2188,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 +2196,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 +2205,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 +2222,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 +2239,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 +2256,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 +2279,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 +2290,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 +2350,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 +3421,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 +3447,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 +3573,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 +3593,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 {
@@ -3688,7 +3742,7 @@ type DraftOrderNonNullablePaths = `lineItems` | `lineItems.${number}.added` | `l
  *
  * 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.
+ * @param orderId - ID of the order to create a draft for.
  * @public
  * @documentationMaturity preview
  * @requiredField orderId
@@ -3727,7 +3781,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
@@ -3753,7 +3807,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[];
@@ -3765,7 +3821,7 @@ export interface AddLineItemsToDraftOrderOptions {
  * > **Notes:**
  * > + Passing 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 fulfilled line items. To retrive 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).
  * @param draftOrderId - Draft order ID.
  * @param lineItemChanges - Details of changes to apply per line item.
  * @public
@@ -3789,11 +3845,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
@@ -3814,9 +3871,9 @@ 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.
+ * Newly created 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)).
  * @param draftOrderId - Draft order ID.
  * @public
@@ -3840,16 +3897,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
@@ -3870,11 +3929,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
@@ -3897,7 +3957,7 @@ export declare function setAdditionalFees(draftOrderId: string, additionalFees:
 /**
  * Creates custom additional fees on a draft order.
  *
- * Newly added additional fees are unapplied by default.
+ * Newly created additional fees are not applied 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)).
  * @param draftOrderId - Draft order ID.
  * @public
@@ -3921,16 +3981,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
@@ -3968,7 +4030,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;
 }
 /**
@@ -3991,7 +4057,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;
 }
 /**
@@ -4014,7 +4084,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;
 }
 /**
@@ -4037,16 +4111,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
@@ -4066,8 +4146,8 @@ 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
@@ -4083,10 +4163,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
@@ -4109,16 +4192,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
@@ -4141,7 +4226,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 +4236,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
@@ -4178,6 +4263,7 @@ 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
@@ -4306,7 +4392,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
@@ -4328,7 +4416,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 +4424,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