@wix/auto_sdk_ecom_draft-orders 1.0.23 → 1.0.25

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

@@ -1,4 +1,7 @@
-/** 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.
@@ -39,12 +42,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
      */
@@ -122,11 +127,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;
@@ -136,7 +143,8 @@ export interface DraftOrder {
      */
     billingDetails?: BillingDetails;
     /**
-     * Order business location
+     * Order business location.
+     *
      * Includes details about changes when relevant.
      */
     businessLocationDetails?: BusinessLocationDetails;
@@ -634,6 +642,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 {
     /**
@@ -771,6 +784,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.
@@ -1108,7 +1178,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. */
@@ -1154,10 +1224,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;
@@ -1178,7 +1248,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. */
@@ -1333,9 +1403,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 {
@@ -1369,7 +1443,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;
@@ -1609,31 +1683,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;
@@ -1649,37 +1725,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;
@@ -1808,7 +1888,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 {
@@ -1823,7 +1903,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[];
@@ -1872,7 +1954,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;
@@ -1947,7 +2031,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 {
@@ -1970,20 +2054,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 {
@@ -1993,8 +2083,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
      */
@@ -2002,15 +2093,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 {
@@ -2020,17 +2113,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 }
      */
@@ -2058,8 +2153,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;
     /**
@@ -2070,10 +2166,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 }
      */
@@ -2081,15 +2177,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 {
@@ -2099,7 +2195,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
@@ -2107,7 +2203,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 {
@@ -2117,15 +2213,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 {
@@ -2135,7 +2232,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
      */
@@ -2143,28 +2242,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
@@ -2172,7 +2273,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 {
@@ -2182,7 +2283,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
@@ -2190,7 +2291,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 {
@@ -2199,11 +2300,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 {
@@ -2212,11 +2317,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 {
@@ -2225,11 +2334,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 {
@@ -2238,11 +2351,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 */
@@ -2257,7 +2374,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 {
@@ -2268,26 +2385,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[];
@@ -2324,7 +2445,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;
@@ -3395,7 +3516,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;
@@ -3421,7 +3542,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;
@@ -3547,14 +3668,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 {
@@ -3567,7 +3688,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 {