@wix/auto_sdk_ecom_draft-orders 1.0.0 → 1.0.2

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

@@ -2,14 +2,20 @@
 export interface DraftOrder {
     /**
      * Draft order ID.
+     * @format GUID
      * @readonly
      */
     _id?: string | null;
-    /** ID of the order this draft commits to. */
+    /**
+     * ID of the order this draft commits to.
+     * @format GUID
+     */
     orderId?: string | null;
     /**
      * Line items.
      * Includes details about changes when relevant.
+     * @minSize 1
+     * @maxSize 300
      */
     lineItems?: ItemDetails[];
     /**
@@ -34,11 +40,13 @@ export interface DraftOrder {
     /**
      * 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
      */
     discounts?: DiscountDetails[];
     /**
@@ -63,7 +71,10 @@ export interface DraftOrder {
     status?: EditingStatus;
     /** Weight measurement unit. Defaults to the site's weight unit. */
     weightUnit?: WeightUnit;
-    /** Currency used for pricing. */
+    /**
+     * Currency used for pricing.
+     * @format CURRENCY
+     */
     currency?: string | null;
     /**
      * Price summary.
@@ -89,9 +100,15 @@ export interface DraftOrder {
     balanceSummary?: BalanceSummary;
     /** Side effects to perform on commit. */
     commitSettings?: DraftOrderCommitSettings;
-    /** Member ID (if order created by a member). */
+    /**
+     * Member ID (if order created by a member).
+     * @format GUID
+     */
     memberId?: string | null;
-    /** Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order. */
+    /**
+     * Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order.
+     * @format GUID
+     */
     purchaseFlowId?: string | null;
     recipientInfo?: RecipientInfoDetails;
     /**
@@ -111,6 +128,11 @@ export interface DraftOrder {
      * @internal
      */
     billingDetails?: BillingDetails;
+    /**
+     * Order business location
+     * Includes details about changes when relevant.
+     */
+    businessLocationDetails?: BusinessLocationDetails;
 }
 export interface ItemDetails extends ItemDetailsChangeTypeOneOf {
     /** Whether the line item was added as part of the draft. */
@@ -132,7 +154,10 @@ export interface ItemDetailsChangeTypeOneOf {
     removed?: boolean;
 }
 export interface Price {
-    /** Amount. */
+    /**
+     * Amount.
+     * @decimalValue options { gte:0, lte:1000000000000000 }
+     */
     amount?: string;
     /**
      * Amount formatted with currency symbol.
@@ -141,17 +166,26 @@ export interface Price {
     formattedAmount?: string;
 }
 export interface PriceDescription {
-    /** __Required.__ Price description 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). */
+    /**
+     * __Required.__ Price description 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).
+     * @minLength 1
+     * @maxLength 100
+     */
     original?: string;
     /**
      * Price description translated into the buyer's language.
      *
      * Default: Same as `original`.
+     * @minLength 1
+     * @maxLength 100
      */
     translated?: string | null;
 }
 export interface OrderLineItem {
-    /** Line item ID. */
+    /**
+     * Line item ID.
+     * @immutable
+     */
     _id?: string;
     /**
      * Item name.
@@ -165,14 +199,21 @@ export interface OrderLineItem {
      * This field may be empty in the case of a custom line item.
      */
     catalogReference?: CatalogReference;
-    /** Line item quantity. */
+    /**
+     * Line item quantity.
+     * @min 1
+     * @max 100000
+     */
     quantity?: number;
     /**
      * Total discount for this line item's entire quantity.
      * @readonly
      */
     totalDiscount?: Price;
-    /** Line item description lines. Used for display purposes for the cart, checkout and order. */
+    /**
+     * Line item description lines. Used for display purposes for the cart, checkout and order.
+     * @maxSize 20
+     */
     descriptionLines?: DescriptionLine[];
     /** Line item image. */
     image?: string;
@@ -183,11 +224,18 @@ export interface OrderLineItem {
     /**
      * Fulfiller ID. Field is empty when the line item is self-fulfilled.
      * 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).
+     * @format GUID
      */
     fulfillerId?: string | null;
-    /** Number of items that were refunded. */
+    /**
+     * Number of items that were refunded.
+     * @max 100000
+     */
     refundQuantity?: number | null;
-    /** Number of items restocked. */
+    /**
+     * Number of items restocked.
+     * @max 100000
+     */
     restockQuantity?: number | null;
     /** Line item price after line item discounts for display purposes. */
     price?: Price;
@@ -207,11 +255,9 @@ export interface OrderLineItem {
      */
     totalPriceAfterTax?: Price;
     /**
-     * Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
-     * + `FULL_PAYMENT_ONLINE` - The entire payment for this item happens as part of the checkout.
-     * + `FULL_PAYMENT_OFFLINE` - The entire payment for this item happens after the checkout. For example, when using cash, check, or other offline payment methods.
-     * + `MEMBERSHIP` - Payment for this item is done by charging a membership. When this option is used, `lineItem.price.amount` is 0.
-     * + `DEPOSIT_ONLINE` - Partial payment for the given item to be paid upfront during the checkout. Eligible for catalog items with type `DEPOSIT_ONLINE` only.
+     * Type of selected payment option for current item.
+     *
+     * Default: `FULL_PAYMENT_ONLINE`
      */
     paymentOption?: PaymentOptionType;
     /**
@@ -246,6 +292,7 @@ export interface OrderLineItem {
     /**
      * ID of the app managing the inventory.
      * @internal
+     * @format GUID
      */
     inventoryAppId?: string | null;
     /**
@@ -261,6 +308,8 @@ export interface ProductName {
      *
      * Min: 1 character.
      * Max: 200 characters.
+     * @minLength 1
+     * @maxLength 200
      */
     original?: string;
     /**
@@ -269,12 +318,18 @@ export interface ProductName {
      * Min: 1 character.
      * Max: 400 characters.
      * Default: Same as `original`.
+     * @minLength 1
+     * @maxLength 400
      */
     translated?: string | null;
 }
 /** Used for grouping line items. Sent when an item is added to a cart, checkout, or order. */
 export interface CatalogReference {
-    /** ID of the item within the catalog it belongs to. */
+    /**
+     * ID of the item within the catalog it belongs to.
+     * @minLength 1
+     * @maxLength 36
+     */
     catalogItemId?: string;
     /**
      * ID of the app providing the catalog.
@@ -285,6 +340,7 @@ export interface CatalogReference {
      * + Wix Stores: `"215238eb-22a5-4c36-9e7b-e7c08025e04e"`
      * + Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"`
      * + Wix Restaurants: `"9a5d83fd-8570-482e-81ab-cfa88942ee60"`
+     * @minLength 1
      */
     appId?: string;
     /**
@@ -313,32 +369,44 @@ export interface DescriptionLineValueOneOf {
 export interface DescriptionLineDescriptionLineValueOneOf {
 }
 export interface DescriptionLineName {
-    /** Description line name 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). */
+    /**
+     * Description line name 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).
+     * @maxLength 100
+     */
     original?: string;
     /**
      * Description line name translated into the buyer's language.
      *
      * Default: Same as `original`.
+     * @maxLength 200
      */
     translated?: string | null;
 }
 export interface PlainTextValue {
-    /** Description line plain text value 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). */
+    /**
+     * Description line plain text value 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).
+     * @maxLength 600
+     */
     original?: string;
     /**
      * Description line plain text value translated into the buyer's language.
      *
      * Default: Same as `original`.
+     * @maxLength 600
      */
     translated?: string | null;
 }
 export interface Color {
-    /** Description line color name 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). */
+    /**
+     * Description line color name 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).
+     * @maxLength 500
+     */
     original?: string;
     /**
      * Description line color name translated into the buyer's language.
      *
      * Default: Same as `original`.
+     * @maxLength 500
      */
     translated?: string | null;
     /** HEX or RGB color code for display. */
@@ -365,7 +433,10 @@ export interface FocalPoint {
 export interface PhysicalProperties {
     /** Line item weight. Measurement unit matches the weight unit specified in `weightUnit` in the request. */
     weight?: number | null;
-    /** Stock-keeping unit. Learn more about [SKUs](https://www.wix.com/encyclopedia/definition/stock-keeping-unit-sku). */
+    /**
+     * Stock-keeping unit. Learn more about [SKUs](https://www.wix.com/encyclopedia/definition/stock-keeping-unit-sku).
+     * @maxLength 40
+     */
     sku?: string | null;
     /** Whether this line item is shippable. */
     shippable?: boolean;
@@ -406,7 +477,10 @@ export declare enum PaymentOptionType {
 export interface ItemTaxFullDetails {
     /** Taxable amount of this line item. */
     taxableAmount?: Price;
-    /** Tax rate percentage, as a decimal numeral between 0 and 1. For example, `"0.13"`. */
+    /**
+     * Tax rate percentage, as a decimal numeral between 0 and 1. For example, `"0.13"`.
+     * @decimalValue options { gte:0, maxScale:6 }
+     */
     taxRate?: string;
     /** The calculated tax, based on the `taxableAmount` and `taxRate`. */
     totalTax?: Price;
@@ -416,16 +490,24 @@ export interface LineItemTaxInfo {
     taxAmount?: Price;
     /** Amount for which tax is calculated. */
     taxableAmount?: Price;
-    /** Tax rate %, as a decimal point. */
+    /**
+     * Tax rate %, as a decimal point.
+     * @format DECIMAL_VALUE
+     * @decimalValue options { gte:0, maxScale:6 }
+     */
     taxRate?: string | null;
     /**
      * Tax group ID.
      * Learn more about [Tax Groups](https://dev.wix.com/docs/rest/business-management/payments/tax/tax-groups/introduction).
+     * @format GUID
      */
     taxGroupId?: string | null;
     /** Indicates whether the price already includes tax. */
     taxIncludedInPrice?: boolean;
-    /** Tax information for a line item. */
+    /**
+     * Tax information for a line item.
+     * @maxSize 7
+     */
     taxBreakdown?: LineItemTaxBreakdown[];
 }
 /**
@@ -433,17 +515,28 @@ export interface LineItemTaxInfo {
  * It holds the tax amount and the tax rate for each tax authority that apply on the line item.
  */
 export interface LineItemTaxBreakdown {
-    /** Jurisdiction that taxes were calculated for. For example, "New York", or "Quebec". */
+    /**
+     * Jurisdiction that taxes were calculated for. For example, "New York", or "Quebec".
+     * @maxLength 200
+     */
     jurisdiction?: string | null;
-    /** Tax rate used for this jurisdiction, as a decimal. For example, 10% tax is 0.1000. */
+    /**
+     * Tax rate used for this jurisdiction, as a decimal. For example, 10% tax is 0.1000.
+     * @format DECIMAL_VALUE
+     * @decimalValue options { gte:0, maxScale:6 }
+     */
     rate?: string | null;
     /** Amount of tax calculated for this line item. */
     taxAmount?: Price;
-    /** The type of tax that was calculated. Depends on the jurisdiction's tax laws. For example, "Sales Tax", "Income Tax", "Value Added Tax", etc. */
+    /**
+     * The type of tax that was calculated. Depends on the jurisdiction's tax laws. For example, "Sales Tax", "Income Tax", "Value Added Tax", etc.
+     * @maxLength 200
+     */
     taxType?: string | null;
     /**
      * The name of the tax against which this tax amount was calculated. For example, "NY State Sales Tax", "Quebec GST", etc.
      * This name should be explicit enough to allow the merchant to understand what tax was calculated.
+     * @maxLength 200
      */
     taxName?: string | null;
     /** Type of jurisdiction that taxes were calculated for. */
@@ -463,9 +556,18 @@ export declare enum JurisdictionType {
     SPECIAL = "SPECIAL"
 }
 export interface DigitalFile {
-    /** ID of the secure file in media. */
+    /**
+     * ID of the secure file in media.
+     * @minLength 1
+     * @maxLength 100
+     */
     fileId?: string;
-    /** Link will exist after the digital links have been generated on the order. */
+    /**
+     * Link will exist after the digital links have been generated on the order.
+     * @format WEB_URL
+     * @minLength 1
+     * @maxLength 2000
+     */
     link?: string | null;
     /**
      * Link expiration time and date.
@@ -474,25 +576,54 @@ export interface DigitalFile {
     expirationDate?: Date | null;
 }
 export interface SubscriptionInfo {
-    /** Subscription ID. */
+    /**
+     * Subscription ID.
+     * @format GUID
+     */
     _id?: string | null;
-    /** Subscription cycle. For example, if this order is for the 3rd cycle of a subscription, value will be `3`. */
+    /**
+     * Subscription cycle. For example, if this order is for the 3rd cycle of a subscription, value will be `3`.
+     * @min 1
+     */
     cycleNumber?: number;
-    /** Subscription option title. For example, `"Monthly coffee Subscription"`. */
+    /**
+     * Subscription option title. For example, `"Monthly coffee Subscription"`.
+     * @minLength 1
+     * @maxLength 20
+     */
     subscriptionOptionTitle?: string;
-    /** Subscription option description. For example, `"1kg of selected coffee, once a month"`. */
+    /**
+     * Subscription option description. For example, `"1kg of selected coffee, once a month"`.
+     * @maxLength 60
+     */
     subscriptionOptionDescription?: string | null;
-    /** Subscription detailed information. */
+    /**
+     * Subscription detailed information.
+     * @immutable
+     */
     subscriptionSettings?: SubscriptionSettings;
+    /**
+     * Description of the charges that will be applied for subscription.
+     * @internal
+     * @maxLength 1000
+     */
+    chargesDescription?: string | null;
 }
 export interface SubscriptionSettings {
     /** Frequency of recurring payment. */
     frequency?: SubscriptionFrequency;
-    /** Interval of recurring payment. */
+    /**
+     * Interval of recurring payment.
+     * @min 1
+     * @max 50
+     */
     interval?: number | null;
     /** Whether subscription is renewed automatically at the end of each period. */
     autoRenewal?: boolean;
-    /** Number of billing cycles before subscription ends. Ignored if `autoRenewal: true`. */
+    /**
+     * Number of billing cycles before subscription ends. Ignored if `autoRenewal: true`.
+     * @min 1
+     */
     billingCycles?: number | null;
     /**
      * Whether to allow the customer to cancel the subscription.
@@ -521,23 +652,36 @@ export declare enum SubscriptionFrequency {
 export interface FreeTrialPeriod {
     /** Frequency of priod. Values: DAY, WEEK, MONTH, YEAR */
     frequency?: SubscriptionFrequency;
-    /** interval of period */
+    /**
+     * interval of period
+     * @min 1
+     * @max 50
+     */
     interval?: number;
 }
 export interface LocationAndQuantity {
-    /** Location id in the associated owner app. */
+    /**
+     * Location id in the associated owner app.
+     * @format GUID
+     */
     _id?: string;
     /**
      * Location owner app, if not provided then the site business info locations will be used.
+     * @format GUID
      * @deprecated Location owner app, if not provided then the site business info locations will be used.
      * @targetRemovalDate 2025-03-01
      */
     appId?: string | null;
-    /** Quantity for specific location. */
+    /**
+     * Quantity for specific location.
+     * @min 1
+     * @max 100000
+     */
     quantity?: number;
     /**
      * Location name.
      * @internal
+     * @maxLength 500
      * @readonly
      */
     name?: string | null;
@@ -569,7 +713,11 @@ export interface ExtendedFields {
     namespaces?: Record<string, Record<string, any>>;
 }
 export interface ItemChangedDetails {
-    /** Line item quantity before change. */
+    /**
+     * Line item quantity before change.
+     * @min 1
+     * @max 1000000
+     */
     quantityBeforeChange?: number | null;
     /** Line item price before change. */
     priceBeforeChange?: Price;
@@ -596,13 +744,22 @@ export interface ShippingDetailsChangeTypeOneOf {
     removed?: boolean;
 }
 export interface V1ShippingInformation {
-    /** App Def Id of external provider which was a source of shipping info */
+    /**
+     * App Def Id of external provider which was a source of shipping info
+     * @minLength 1
+     * @maxLength 100
+     */
     carrierId?: string | null;
-    /** Unique code (or ID) of selected shipping option. For example, `"usps_std_overnight"`. */
+    /**
+     * Unique code (or ID) of selected shipping option. For example, `"usps_std_overnight"`.
+     * @minLength 1
+     * @maxLength 100
+     */
     code?: string | null;
     /**
      * Shipping option title.
      * For example, `"USPS Standard Overnight Delivery"`, `"Standard"` or `"First-Class Package International"`.
+     * @maxLength 250
      */
     title?: string;
     /** Shipping logistics. */
@@ -617,9 +774,15 @@ export interface V1DeliveryLogistics extends V1DeliveryLogisticsAddressOneOf {
     shippingDestination?: AddressWithContact;
     /** Pickup details. */
     pickupDetails?: V1PickupDetails;
-    /** Expected delivery time in free text. For example, `"3-5 business days"`. */
+    /**
+     * Expected delivery time in free text. For example, `"3-5 business days"`.
+     * @maxLength 500
+     */
     deliveryTime?: string | null;
-    /** Instructions for carrier. For example, `"Please knock on the door. If unanswered, please call contact number. Thanks."`. */
+    /**
+     * Instructions for carrier. For example, `"Please knock on the door. If unanswered, please call contact number. Thanks."`.
+     * @maxLength 1000
+     */
     instructions?: string | null;
     /**
      * Deprecated - Latest expected delivery date and time in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format.
@@ -645,19 +808,37 @@ export interface AddressWithContact {
 }
 /** Physical address */
 export interface Address {
-    /** Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format. */
+    /**
+     * Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
+     * @format COUNTRY
+     */
     country?: string | null;
-    /** Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format. */
+    /**
+     * Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format.
+     * @maxLength 50
+     */
     subdivision?: string | null;
-    /** City name. */
+    /**
+     * City name.
+     * @maxLength 50
+     */
     city?: string | null;
-    /** Postal or zip code. */
+    /**
+     * Postal or zip code.
+     * @maxLength 50
+     */
     postalCode?: string | null;
     /** Street address. */
     streetAddress?: StreetAddress;
-    /** Main address line (usually street name and number). */
+    /**
+     * Main address line (usually street name and number).
+     * @maxLength 150
+     */
     addressLine1?: string | null;
-    /** Free text providing more detailed address info. Usually contains apt, suite, floor. */
+    /**
+     * Free text providing more detailed address info. Usually contains apt, suite, floor.
+     * @maxLength 100
+     */
     addressLine2?: string | null;
     /**
      * Country's full name.
@@ -684,13 +865,25 @@ export interface AddressLocation {
 }
 /** Full contact details for an address */
 export interface FullAddressContactDetails {
-    /** First name. */
+    /**
+     * First name.
+     * @maxLength 100
+     */
     firstName?: string | null;
-    /** Last name. */
+    /**
+     * Last name.
+     * @maxLength 100
+     */
     lastName?: string | null;
-    /** Phone number. */
+    /**
+     * Phone number.
+     * @format PHONE
+     */
     phone?: string | null;
-    /** Company name. */
+    /**
+     * Company name.
+     * @maxLength 1000
+     */
     company?: string | null;
     /** Tax information (for Brazil only). If ID is provided, `vatId.type` must also be set, `UNSPECIFIED` is not allowed. */
     vatId?: VatId;
@@ -723,19 +916,37 @@ export interface V1PickupDetails {
 }
 /** Physical address */
 export interface PickupAddress {
-    /** Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format. */
+    /**
+     * Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
+     * @format COUNTRY
+     */
     country?: string | null;
-    /** Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format. */
+    /**
+     * Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format.
+     * @maxLength 50
+     */
     subdivision?: string | null;
-    /** City name. */
+    /**
+     * City name.
+     * @maxLength 1000
+     */
     city?: string | null;
-    /** Postal or zip code. */
+    /**
+     * Postal or zip code.
+     * @maxLength 1000
+     */
     postalCode?: string | null;
     /** Street address object, with number, name, and apartment number in separate fields. */
     streetAddress?: StreetAddress;
-    /** Main address line (usually street name and number). */
+    /**
+     * Main address line (usually street name and number).
+     * @maxLength 1000
+     */
     addressLine1?: string | null;
-    /** Free text providing more detailed address info. Usually contains apt, suite, floor. */
+    /**
+     * Free text providing more detailed address info. Usually contains apt, suite, floor.
+     * @maxLength 1000
+     */
     addressLine2?: string | null;
     /**
      * Country's full name.
@@ -781,7 +992,10 @@ export interface V1ShippingPrice {
     discount?: Price;
 }
 export interface ShippingRegion {
-    /** Name of shipping region. For example, `"Metropolitan London"`, or `"Outer Melbourne suburbs"`. */
+    /**
+     * Name of shipping region. For example, `"Metropolitan London"`, or `"Outer Melbourne suburbs"`.
+     * @maxLength 100
+     */
     name?: string | null;
 }
 export interface ShippingChangedDetails {
@@ -790,20 +1004,38 @@ export interface ShippingChangedDetails {
 }
 /** Buyer Info */
 export interface BuyerInfo extends BuyerInfoIdOneOf {
-    /** Visitor ID (if site visitor is not a member). */
+    /**
+     * Visitor ID (if site visitor is not a member).
+     * @format GUID
+     */
     visitorId?: string;
-    /** Member ID (if site visitor is a site member). */
+    /**
+     * Member ID (if site visitor is a site member).
+     * @format GUID
+     */
     memberId?: string;
-    /** Contact ID. Auto-created if one does not yet exist. For more information, see [Contacts API](https://dev.wix.com/api/rest/contacts/contacts/introduction). */
+    /**
+     * Contact ID. Auto-created if one does not yet exist. For more information, see [Contacts API](https://dev.wix.com/api/rest/contacts/contacts/introduction).
+     * @format GUID
+     */
     contactId?: string | null;
-    /** Buyer email address. */
+    /**
+     * Buyer email address.
+     * @format EMAIL
+     */
     email?: string | null;
 }
 /** @oneof */
 export interface BuyerInfoIdOneOf {
-    /** Visitor ID (if site visitor is not a member). */
+    /**
+     * Visitor ID (if site visitor is not a member).
+     * @format GUID
+     */
     visitorId?: string;
-    /** Member ID (if site visitor is a site member). */
+    /**
+     * Member ID (if site visitor is a site member).
+     * @format GUID
+     */
     memberId?: string;
 }
 export interface AdditionalFeeDetails {
@@ -823,38 +1055,59 @@ export interface AdditionalFeeDetails {
     applied?: boolean;
 }
 export interface AdditionalFee {
-    /** Additional fee's unique code for future processing. */
+    /**
+     * Additional fee's unique code for future processing.
+     * @minLength 1
+     * @maxLength 100
+     */
     code?: string | null;
-    /** Name of additional fee. */
+    /**
+     * Name of additional fee.
+     * @minLength 1
+     * @maxLength 50
+     */
     name?: string;
     /** Additional fee's price. */
     price?: Price;
     /** Tax details. */
     taxDetails?: ItemTaxFullDetails;
-    /** SPI implementer's `appId`. */
+    /**
+     * SPI implementer's `appId`.
+     * @format GUID
+     */
     providerAppId?: string | null;
     /** Additional fee's price before tax. */
     priceBeforeTax?: Price;
     /** Additional fee's price after tax. */
     priceAfterTax?: Price;
-    /** Additional fee's id. */
+    /**
+     * Additional fee's id.
+     * @format GUID
+     * @immutable
+     */
     _id?: string;
     /**
      * Optional - Line items associated with this additional fee.
      * If no `lineItemIds` are provided, the fee will be associated with the whole cart/checkout/order.
+     * @format GUID
      */
     lineItemIds?: string[];
     /**
      * Number of subscription billing cycles the additional fee applies to.
      * If None and additional fee is linked to subscription line item, it applies to all cycles.
      * @internal
+     * @min 1
+     * @max 999
      */
     subscriptionCycles?: number | null;
 }
 export interface TaxDetails {
     /** Indication if additional fee is taxable or not */
     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;
 }
 export declare enum SourceType {
@@ -896,18 +1149,26 @@ export interface AppliedDiscount extends AppliedDiscountDiscountSourceOneOf {
     /**
      * IDs of line items discount applies to.
      * Deprecated. Use `line_item_discounts` instead.
+     * @format GUID
+     * @maxSize 1
      * @deprecated IDs of line items discount applies to.
      * Deprecated. Use `line_item_discounts` instead.
      * @replacedBy line_item_discounts
      * @targetRemovalDate 2024-10-30
      */
     lineItemIds?: string[];
-    /** Discount id. */
+    /**
+     * Discount id.
+     * @format GUID
+     * @immutable
+     */
     _id?: string | null;
     /**
      * Number of subscription billing cycles the discount applies to.
      * If None and discount is linked to subscription line item, it applies to all cycles.
      * @internal
+     * @min 1
+     * @max 999
      */
     subscriptionCycles?: number | null;
 }
@@ -942,13 +1203,18 @@ export interface MerchantDiscount extends MerchantDiscountMerchantDiscountReason
      * * `"ITEMS_EXCHANGE"` - exchange balance acquired as a result of items exchange.
      */
     discountReason?: DiscountReason;
-    /** Discount description as free text (optional). */
+    /**
+     * Discount description as free text (optional).
+     * @maxLength 200
+     */
     description?: string | null;
     /** Discount amount. */
     amount?: Price;
     /**
      * Discount percentage.
      * @internal
+     * @format DECIMAL_VALUE
+     * @decimalValue options { gte:0, lte:100, maxScale:2 }
      */
     percentage?: string | null;
 }
@@ -959,7 +1225,10 @@ export interface MerchantDiscountMerchantDiscountReasonOneOf {
      * * `"ITEMS_EXCHANGE"` - exchange balance acquired as a result of items exchange.
      */
     discountReason?: DiscountReason;
-    /** Discount description as free text (optional). */
+    /**
+     * Discount description as free text (optional).
+     * @maxLength 200
+     */
     description?: string | null;
 }
 export declare enum DiscountReason {
@@ -967,7 +1236,10 @@ export declare enum DiscountReason {
     EXCHANGED_ITEMS = "EXCHANGED_ITEMS"
 }
 export interface DiscountRule {
-    /** Discount rule ID */
+    /**
+     * Discount rule ID
+     * @format GUID
+     */
     _id?: string;
     /** Discount rule name */
     name?: DiscountRuleName;
@@ -975,28 +1247,51 @@ export interface DiscountRule {
     amount?: Price;
 }
 export interface DiscountRuleName {
-    /** Original discount rule name (in site's default language). */
+    /**
+     * Original discount rule name (in site's default language).
+     * @minLength 1
+     * @maxLength 256
+     */
     original?: string;
-    /** Translated discount rule name according to buyer language. Defaults to `original` when not provided. */
+    /**
+     * Translated discount rule name according to buyer language. Defaults to `original` when not provided.
+     * @minLength 1
+     * @maxLength 500
+     */
     translated?: string | null;
 }
 export interface LineItemDiscount {
-    /** ID of line item the discount applies to. */
+    /**
+     * ID of line item the discount applies to.
+     * @format GUID
+     */
     _id?: string;
     /** Total discount for this line item. */
     totalDiscount?: Price;
 }
 export interface CreatedBy extends CreatedByStringOneOf {
-    /** User ID. When the draft order was created by a Wix user. */
+    /**
+     * User ID. When the draft order was created by a Wix user.
+     * @format GUID
+     */
     userId?: string;
-    /** App ID. When the draft order was created by an app. */
+    /**
+     * App ID. When the draft order was created by an app.
+     * @format GUID
+     */
     appId?: string;
 }
 /** @oneof */
 export interface CreatedByStringOneOf {
-    /** User ID. When the draft order was created by a Wix user. */
+    /**
+     * User ID. When the draft order was created by a Wix user.
+     * @format GUID
+     */
     userId?: string;
-    /** App ID. When the draft order was created by an app. */
+    /**
+     * App ID. When the draft order was created by an app.
+     * @format GUID
+     */
     appId?: string;
 }
 export declare enum EditingStatus {
@@ -1058,6 +1353,7 @@ export interface Balance {
      * Balance amount.
      *
      * A negative `amount` represents the amount to be refunded. This can happen due to overcharging or the order being modified after a payment has been made.
+     * @decimalValue options { }
      * @readonly
      */
     amount?: string;
@@ -1096,11 +1392,15 @@ export interface DraftOrderCommitSettings {
     /**
      * Line item IDs for which to perform an inventory change.
      * When not provided, inventory will not change.
+     * @maxSize 300
      */
     updateInventory?: InventoryUpdate[];
 }
 export interface InventoryUpdate {
-    /** Line item ID. */
+    /**
+     * Line item ID.
+     * @format GUID
+     */
     lineItemId?: string;
 }
 export interface RecipientInfoDetails extends RecipientInfoDetailsChangeTypeOneOf {
@@ -1129,7 +1429,10 @@ export interface RecipientInfoChangedDetails {
 export interface OrderTaxInfo {
     /** Calculated tax, added from line items. */
     totalTax?: Price;
-    /** The summary of the tax breakdown for all the line items. It will hold for each tax name, the aggregated tax amount paid for it and the tax rate. */
+    /**
+     * The summary of the tax breakdown for all the line items. It will hold for each tax name, the aggregated tax amount paid for it and the tax rate.
+     * @maxSize 50
+     */
     taxBreakdown?: OrderTaxBreakdown[];
     /**
      * Whether the order is exempt from tax calculations.
@@ -1144,15 +1447,28 @@ export interface OrderTaxInfo {
  * Tax breakdown is the tax amount split to the tax authorities that applied on the line item.
  */
 export interface OrderTaxBreakdown {
-    /** The name of the tax against which this tax amount was calculated. */
+    /**
+     * The name of the tax against which this tax amount was calculated.
+     * @maxLength 200
+     */
     taxName?: string;
-    /** The type of tax that was calculated. Depends on the company's nexus settings as well as the jurisdiction's tax laws. */
+    /**
+     * The type of tax that was calculated. Depends on the company's nexus settings as well as the jurisdiction's tax laws.
+     * @maxLength 200
+     */
     taxType?: string;
-    /** The name of the jurisdiction in which this tax detail applies. */
+    /**
+     * The name of the jurisdiction in which this tax detail applies.
+     * @maxLength 200
+     */
     jurisdiction?: string;
     /** The type of the jurisdiction in which this tax detail applies (e.g. Country,State,County,City,Special). */
     jurisdictionType?: JurisdictionType;
-    /** The rate at which this tax detail was calculated. */
+    /**
+     * The rate at which this tax detail was calculated.
+     * @format DECIMAL_VALUE
+     * @decimalValue options { gte:0, maxScale:6 }
+     */
     rate?: string;
     /** The sum of all the tax from line items that calculated by the tax identifiers. */
     aggregatedTaxAmount?: Price;
@@ -1252,66 +1568,48 @@ export interface BillingChangedDetails {
     billingInfoBeforeChange?: AddressWithContact;
 }
 export interface BusinessLocationDetails extends BusinessLocationDetailsChangeTypeOneOf {
-    /**
-     * Indicates that business location was added during draft.
-     * @internal
-     */
+    /** Indicates that business location was added during draft. */
     added?: boolean;
-    /**
-     * Indicates that business location was changed. Contains business location before draft.
-     * @internal
-     */
+    /** Indicates that business location was changed. Contains business location before draft. */
     changedDetails?: BusinessLocationChangedDetails;
-    /**
-     * Indicates that business location was removed during draft.
-     * @internal
-     */
+    /** Indicates that business location was removed during draft. */
     removed?: boolean;
-    /**
-     * Business location.
-     * @internal
-     */
+    /** Business location. */
     businessLocation?: Location;
 }
 /** @oneof */
 export interface BusinessLocationDetailsChangeTypeOneOf {
-    /**
-     * Indicates that business location was added during draft.
-     * @internal
-     */
+    /** Indicates that business location was added during draft. */
     added?: boolean;
-    /**
-     * Indicates that business location was changed. Contains business location before draft.
-     * @internal
-     */
+    /** Indicates that business location was changed. Contains business location before draft. */
     changedDetails?: BusinessLocationChangedDetails;
-    /**
-     * Indicates that business location was removed during draft.
-     * @internal
-     */
+    /** Indicates that business location was removed during draft. */
     removed?: boolean;
 }
 export interface Location {
     /**
      * Location ID.
      * Learn more about the [Wix Locations API](https://dev.wix.com/docs/rest/business-management/locations/introduction).
+     * @format GUID
      */
     _id?: string;
     /**
      * Location name.
+     * @minLength 1
+     * @maxLength 500
      * @readonly
      */
     name?: string;
 }
 export interface BusinessLocationChangedDetails {
-    /**
-     * Business location before draft.
-     * @internal
-     */
+    /** Business location before draft. */
     businessLocationBeforeChange?: Location;
 }
 export interface CreateDraftOrderRequest {
-    /** To create a draft from existing order, provide its id. Otherwise, an empty draft will be created. */
+    /**
+     * To create a draft from existing order, provide its id. Otherwise, an empty draft will be created.
+     * @format GUID
+     */
     orderId: string | null;
 }
 export interface CreateDraftOrderResponse {
@@ -1335,7 +1633,10 @@ export interface CalculatedDraftOrder {
     calculationErrors?: CalculationErrors;
 }
 export interface ShippingOption {
-    /** This carrier's unique ID */
+    /**
+     * This carrier's unique ID
+     * @format GUID
+     */
     carrierId?: string | null;
     /** Unique code that acts as an ID for a shipping rate. For example, `"usps_std_overnight"`. */
     code?: string;
@@ -1382,7 +1683,10 @@ export interface DeliveryTimeSlot {
 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). */
     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 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.
+     * @format CURRENCY
+     */
     currency?: string;
 }
 export interface CalculationErrors extends CalculationErrorsShippingCalculationErrorOneOf {
@@ -1481,7 +1785,8 @@ export declare enum RuleType {
     FIELD_NOT_ALLOWED = "FIELD_NOT_ALLOWED",
     ONE_OF_ALIGNMENT = "ONE_OF_ALIGNMENT",
     EXACT_LENGTH = "EXACT_LENGTH",
-    EXACT_SIZE = "EXACT_SIZE"
+    EXACT_SIZE = "EXACT_SIZE",
+    REQUIRED_ONE_OF_FIELD = "REQUIRED_ONE_OF_FIELD"
 }
 export interface FieldViolation {
     field?: string;
@@ -1512,29 +1817,47 @@ export interface CreateEmptyDraftOrderResponse {
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface AddLineItemsToDraftOrderRequest {
-    /** The draft order id */
+    /**
+     * The draft order id
+     * @format GUID
+     */
     draftOrderId: string;
-    /** Catalog line items to add to draft order. */
+    /**
+     * Catalog line items to add to draft order.
+     * @maxSize 300
+     */
     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 don't trigger the Catalog service plugin.
+     * @maxSize 300
+     */
     customLineItems?: CustomLineItem[];
 }
 export interface CatalogReferenceLineItem {
     /** Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info. Optional for custom line items, which don't trigger the Catalog service plugin. */
     catalogReference?: CatalogReference;
-    /** Item quantity. */
+    /**
+     * Item quantity.
+     * @min 1
+     * @max 100000
+     */
     quantity?: number;
     /** Item price override. */
     price?: Price;
 }
 export interface CustomLineItem {
-    /** Line item ID. */
+    /**
+     * Line item ID.
+     * @format GUID
+     */
     _id?: string | null;
     /**
      * Item quantity.
      *
      * Min: `"1"`
      * Max: `"100000"`
+     * @min 1
+     * @max 100000
      */
     quantity?: number;
     /** Catalog and item reference. Includes IDs for the item and the catalog it came from, as well as further optional info. Optional for custom line items, which don't trigger the Catalog service plugin. */
@@ -1566,13 +1889,24 @@ export interface CustomLineItem {
     itemType?: ItemType;
     /** Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67". */
     priceDescription?: PriceDescription;
-    /** Delivery Profile Id for the product */
+    /**
+     * Delivery Profile Id for the product
+     * @format GUID
+     */
     deliveryProfileId?: string | null;
 }
 export interface SecuredMedia {
-    /** Media ID in Wix Media Manager. */
+    /**
+     * Media ID in Wix Media Manager.
+     * @minLength 1
+     * @maxLength 100
+     */
     _id?: string;
-    /** Original filename. */
+    /**
+     * Original filename.
+     * @minLength 1
+     * @maxLength 1000
+     */
     fileName?: string;
     /** File type. */
     fileType?: FileType;
@@ -1590,17 +1924,33 @@ export interface AddLineItemsToDraftOrderResponse {
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface UpdateLineItemsRequest {
-    /** The draft order id */
+    /**
+     * The draft order id
+     * @format GUID
+     */
     draftOrderId: string;
-    /** Details of changes to apply per line item */
+    /**
+     * Details of changes to apply per line item
+     * @minSize 1
+     * @maxSize 300
+     */
     lineItemChanges?: LineItemChangeDetails[];
 }
 export interface LineItemChangeDetails {
-    /** The line item id to change */
+    /**
+     * The line item id to change
+     * @format GUID
+     */
     lineItemId?: string;
-    /** The new quantity for the line item. quantity zero means to remove the line item. */
+    /**
+     * The new quantity for the line item. quantity zero means to remove the line item.
+     * @max 1000000
+     */
     newQuantity?: number | null;
-    /** The new price for 1 unit of the line item */
+    /**
+     * The new price for 1 unit of the line item
+     * @decimalValue options { gte:0, lte:1000000000000000 }
+     */
     newPrice?: string | null;
     /** Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67". */
     newPriceDescription?: PriceDescription;
@@ -1610,9 +1960,15 @@ export interface UpdateLineItemsResponse {
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetDiscountsRequest {
-    /** The draft order id */
+    /**
+     * The draft order id
+     * @format GUID
+     */
     draftOrderId: string;
-    /** The discount ids to opt-in. all existing discounts not listed are to be opted-out. */
+    /**
+     * The discount ids to opt-in. all existing discounts not listed are to be opted-out.
+     * @minSize 1
+     */
     discounts: IdAndApplied[];
 }
 export interface IdAndApplied {
@@ -1626,9 +1982,16 @@ export interface SetDiscountsResponse {
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface CreateCustomDiscountsRequest {
-    /** The draft order id */
+    /**
+     * The draft order id
+     * @format GUID
+     */
     draftOrderId: string;
-    /** The discounts to add. */
+    /**
+     * The discounts to add.
+     * @minSize 1
+     * @maxSize 100
+     */
     discounts?: DiscountOption[];
 }
 export interface DiscountOption extends DiscountOptionDiscountAmountOneOf {
@@ -1640,6 +2003,8 @@ export interface DiscountOption extends DiscountOptionDiscountAmountOneOf {
     /**
      * Discount percentage amount.
      * @internal
+     * @format DECIMAL_VALUE
+     * @decimalValue options { gte:0, lte:100, maxScale:2 }
      */
     percentage?: string | null;
     /**
@@ -1651,6 +2016,7 @@ export interface DiscountOption extends DiscountOptionDiscountAmountOneOf {
     discountType?: DiscountType;
     /**
      * ID of line item discount applies to.
+     * @format GUID
      * @deprecated ID of line item discount applies to.
      * @replacedBy line_item_discounts
      * @targetRemovalDate 2024-10-30
@@ -1663,7 +2029,10 @@ export interface DiscountOption extends DiscountOptionDiscountAmountOneOf {
      * @targetRemovalDate 2024-08-30
      */
     amount?: Price;
-    /** Discount description as free text (optional). */
+    /**
+     * Discount description as free text (optional).
+     * @maxLength 200
+     */
     description?: string | null;
     /**
      * Should opt-in the added discount. default = false.
@@ -1681,6 +2050,8 @@ export interface DiscountOptionDiscountAmountOneOf {
     /**
      * Discount percentage amount.
      * @internal
+     * @format DECIMAL_VALUE
+     * @decimalValue options { gte:0, lte:100, maxScale:2 }
      */
     percentage?: string | null;
 }
@@ -1695,9 +2066,17 @@ export interface CreateCustomDiscountsResponse {
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface DeleteCustomDiscountsRequest {
-    /** The draft order id */
+    /**
+     * The draft order id
+     * @format GUID
+     */
     draftOrderId: string;
-    /** The discounts to remove */
+    /**
+     * The discounts to remove
+     * @format GUID
+     * @minSize 1
+     * @maxSize 100
+     */
     discountIds: string[];
 }
 export interface DeleteCustomDiscountsResponse {
@@ -1705,9 +2084,16 @@ export interface DeleteCustomDiscountsResponse {
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface SetAdditionalFeesRequest {
-    /** The draft order id */
+    /**
+     * The draft order id
+     * @format GUID
+     */
     draftOrderId: string;
-    /** The additional fees ids to opt-in. all existing additional fees not listed are to be opted-out */
+    /**
+     * The additional fees ids to opt-in. all existing additional fees not listed are to be opted-out
+     * @minSize 1
+     * @maxSize 100
+     */
     additionalFees: IdAndApplied[];
 }
 export interface SetAdditionalFeesResponse {
@@ -1715,13 +2101,24 @@ export interface SetAdditionalFeesResponse {
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface CreateCustomAdditionalFeesRequest {
-    /** The draft order id */
+    /**
+     * The draft order id
+     * @format GUID
+     */
     draftOrderId: string;
-    /** The additional fees to add. added with opted-out setting */
+    /**
+     * The additional fees to add. added with opted-out setting
+     * @minSize 1
+     * @maxSize 100
+     */
     customAdditionalFees?: AdditionalFeeOption[];
 }
 export interface AdditionalFeeOption {
-    /** Translated additional fee's name */
+    /**
+     * Translated additional fee's name
+     * @minLength 1
+     * @maxLength 50
+     */
     name?: string;
     /** Additional fee's price */
     price?: Price;
@@ -1732,7 +2129,11 @@ export interface AdditionalFeeOption {
      * if not set or false, then to apply them, please call ApplyAdditionalFees with the added additional fee ids
      */
     applyToDraftOrder?: boolean | null;
-    /** Additional fee's unique code (or ID) for future processing */
+    /**
+     * Additional fee's unique code (or ID) for future processing
+     * @minLength 1
+     * @maxLength 100
+     */
     code?: string | null;
 }
 export interface CreateCustomAdditionalFeesResponse {
@@ -1740,9 +2141,17 @@ export interface CreateCustomAdditionalFeesResponse {
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface DeleteCustomAdditionalFeesRequest {
-    /** The draft order id */
+    /**
+     * The draft order id
+     * @format GUID
+     */
     draftOrderId: string;
-    /** The additional fees to remove */
+    /**
+     * The additional fees to remove
+     * @format GUID
+     * @minSize 1
+     * @maxSize 100
+     */
     customAdditionalFees: string[];
 }
 export interface DeleteCustomAdditionalFeesResponse {
@@ -1753,6 +2162,7 @@ export interface SetShippingInfoRequest {
     /**
      * The draft order id
      * @internal
+     * @format GUID
      */
     draftOrderId: string;
     /**
@@ -1772,6 +2182,7 @@ export interface SetBuyerInfoRequest {
     /**
      * The draft order id
      * @internal
+     * @format GUID
      */
     draftOrderId: string;
     /**
@@ -1791,6 +2202,7 @@ export interface SetRecipientInfoRequest {
     /**
      * The draft order id
      * @internal
+     * @format GUID
      */
     draftOrderId: string;
     /**
@@ -1810,6 +2222,7 @@ export interface SetBillingInfoRequest {
     /**
      * The draft order id
      * @internal
+     * @format GUID
      */
     draftOrderId: string;
     /**
@@ -1826,7 +2239,10 @@ export interface SetBillingInfoResponse {
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface UpdateShippingInfoRequest {
-    /** The draft order id */
+    /**
+     * The draft order id
+     * @format GUID
+     */
     draftOrderId?: string;
     /** update the shipping option on the order. if not set then the selected shipping is removed */
     shippingOption?: ShippingOption;
@@ -1836,7 +2252,10 @@ export interface UpdateShippingInfoResponse {
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface GetDraftOrderRequest {
-    /** The draft order id */
+    /**
+     * The draft order id
+     * @format GUID
+     */
     draftOrderId: string;
 }
 export interface GetDraftOrderResponse {
@@ -1844,15 +2263,26 @@ export interface GetDraftOrderResponse {
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface GetOrderDraftabilityStatusRequest {
-    /** Order ID. */
+    /**
+     * Order ID.
+     * @minLength 1
+     * @maxLength 100
+     */
     orderId: string;
 }
 export interface GetOrderDraftabilityStatusResponse {
-    /** Order ID. */
+    /**
+     * Order ID.
+     * @minLength 1
+     * @maxLength 100
+     */
     orderId?: string;
     /** Whether a draft can be created from this order */
     orderDraftable?: boolean;
-    /** Reasons why the order is not draftable */
+    /**
+     * Reasons why the order is not draftable
+     * @maxSize 5
+     */
     nonDraftableReasons?: NonDraftableReason[];
 }
 export declare enum NonDraftableReason {
@@ -1870,11 +2300,17 @@ export declare enum NonDraftableReason {
     TAXABLE_EXISTING_ADDITIONAL_FEE = "TAXABLE_EXISTING_ADDITIONAL_FEE"
 }
 export interface CommitDraftOrderRequest {
-    /** The draft order id */
+    /**
+     * The draft order id
+     * @format GUID
+     */
     draftOrderId: string;
     /** Optional side effects to trigger */
     commitSettings?: DraftOrderCommitSettings;
-    /** Reason for edit, given by user (optional). */
+    /**
+     * Reason for edit, given by user (optional).
+     * @maxLength 200
+     */
     reason?: string | null;
 }
 export interface CommitDraftOrderResponse {
@@ -1886,6 +2322,7 @@ export interface CommitDraftOrderResponse {
 export interface Order {
     /**
      * Order ID.
+     * @format GUID
      * @readonly
      */
     _id?: string | null;
@@ -1897,6 +2334,7 @@ export interface Order {
     /**
      * Date and time the order was created in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format.
      * @readonly
+     * @immutable
      */
     _createdDate?: Date | null;
     /**
@@ -1906,6 +2344,8 @@ export interface Order {
     _updatedDate?: Date | null;
     /**
      * Order line items.
+     * @minSize 1
+     * @maxSize 300
      * @readonly
      */
     lineItems?: OrderLineItem[];
@@ -1925,13 +2365,20 @@ export interface Order {
     buyerLanguage?: string | null;
     /** Weight measurement unit - defaults to site's weight unit. */
     weightUnit?: WeightUnit;
-    /** Currency used for the pricing of this order in [ISO-4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes) format. */
+    /**
+     * Currency used for the pricing of this order in [ISO-4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes) format.
+     * @format CURRENCY
+     */
     currency?: string | null;
-    /** Whether tax is included in line item prices. */
+    /**
+     * Whether tax is included in line item prices.
+     * @immutable
+     */
     taxIncludedInPrices?: boolean;
     /**
      * Site language in which original values are shown.
      * @readonly
+     * @immutable
      */
     siteLanguage?: string | null;
     /**
@@ -1943,7 +2390,10 @@ export interface Order {
     billingInfo?: AddressWithContact;
     /** Shipping info and selected shipping option details. */
     shippingInfo?: V1ShippingInformation;
-    /** [Buyer note](https://support.wix.com/en/article/wix-stores-viewing-buyer-notes) left by the customer. */
+    /**
+     * [Buyer note](https://support.wix.com/en/article/wix-stores-viewing-buyer-notes) left by the customer.
+     * @maxLength 1000
+     */
     buyerNote?: string | null;
     /** Order status. */
     status?: OrderStatus;
@@ -1962,11 +2412,15 @@ export interface Order {
     taxSummary?: TaxSummary;
     /** Tax information. */
     taxInfo?: OrderTaxInfo;
-    /** Applied discounts. */
+    /**
+     * Applied discounts.
+     * @maxSize 320
+     */
     appliedDiscounts?: AppliedDiscount[];
     /**
      * Order activities.
      * @readonly
+     * @maxSize 1000
      */
     activities?: Activity[];
     /** Order attribution source. */
@@ -1980,7 +2434,10 @@ export interface Order {
     channelInfo?: ChannelInfo;
     /** Whether a human has seen the order. Set when an order is clicked on in the dashboard. */
     seenByAHuman?: boolean | null;
-    /** Checkout ID. */
+    /**
+     * Checkout ID.
+     * @format GUID
+     */
     checkoutId?: string | null;
     /** Custom fields. */
     customFields?: CustomField[];
@@ -1989,7 +2446,10 @@ export interface Order {
      * @readonly
      */
     balanceSummary?: V1BalanceSummary;
-    /** Additional fees applied to the order. */
+    /**
+     * Additional fees applied to the order.
+     * @maxSize 100
+     */
     additionalFees?: AdditionalFee[];
     /**
      * Custom field data for the order object.
@@ -1997,7 +2457,10 @@ export interface Order {
      * [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the app dashboard before they can be accessed with API calls.
      */
     extendedFields?: ExtendedFields;
-    /** Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order. */
+    /**
+     * Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order.
+     * @format GUID
+     */
     purchaseFlowId?: string | null;
     /**
      * Order recipient address and contact details.
@@ -2010,8 +2473,11 @@ export interface Order {
     /**
      * Date and time the order was originally purchased in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format.
      * Used for migration from external systems.
+     * @immutable
      */
     purchasedDate?: Date | null;
+    /** Order Location */
+    businessLocation?: Location;
     /**
      * Pay after free trial price summary. Price summary that should be paid for subscriptions after free trial period.
      * @internal
@@ -2159,11 +2625,13 @@ export interface Activity extends ActivityContentOneOf {
     receiptSent?: ReceiptSent;
     /**
      * Activity ID.
+     * @format GUID
      * @readonly
      */
     _id?: string | null;
     /**
      * Activity author's email.
+     * @format EMAIL
      * @readonly
      */
     authorEmail?: string | null;
@@ -2239,16 +2707,26 @@ export interface ActivityContentOneOf {
     receiptSent?: ReceiptSent;
 }
 export interface CustomActivity {
-    /** ID of the app that created the custom activity. */
+    /**
+     * ID of the app that created the custom activity.
+     * @format GUID
+     */
     appId?: string;
-    /** Custom activity type. For example, `"Ticket number set"`. */
+    /**
+     * Custom activity type. For example, `"Ticket number set"`.
+     * @maxLength 100
+     */
     type?: string;
     /** Additional data in key-value form. For example, `{ "Ticket number": "123456" }`. */
     additionalData?: Record<string, string>;
 }
 /** Store owner added a comment */
 export interface MerchantComment {
-    /** Merchant comment message. */
+    /**
+     * Merchant comment message.
+     * @minLength 1
+     * @maxLength 5000
+     */
     message?: string;
 }
 export interface OrderRefunded {
@@ -2256,29 +2734,52 @@ export interface OrderRefunded {
     manual?: boolean;
     /** Refund amount. */
     amount?: Price;
-    /** Reason for refund. */
+    /**
+     * Reason for refund.
+     * @maxLength 200
+     */
     reason?: string;
 }
 export interface OrderCreatedFromExchange {
-    /** ID of the original order for which the exchange happened. */
+    /**
+     * ID of the original order for which the exchange happened.
+     * @format GUID
+     */
     originalOrderId?: string;
 }
 export interface NewExchangeOrderCreated {
-    /** ID of the new order created as a result of an exchange of items. */
+    /**
+     * ID of the new order created as a result of an exchange of items.
+     * @format GUID
+     */
     exchangeOrderId?: string;
-    /** IDs of the items that were exchanged. */
+    /**
+     * IDs of the items that were exchanged.
+     * @minSize 1
+     * @maxSize 300
+     */
     lineItems?: LineItemExchangeData[];
 }
 export interface LineItemExchangeData {
-    /** ID of the exchanged line item. */
+    /**
+     * ID of the exchanged line item.
+     * @format GUID
+     */
     lineItemId?: string;
-    /** Line item quantity being exchanged. */
+    /**
+     * Line item quantity being exchanged.
+     * @min 1
+     * @max 100000
+     */
     quantity?: number;
 }
 export interface DraftOrderChangesApplied {
     /** Draft order id. */
     draftOrderId?: string;
-    /** Reason for edit, given by user (optional). */
+    /**
+     * Reason for edit, given by user (optional).
+     * @maxLength 200
+     */
     reason?: string | null;
     /** Changes applied to order. */
     changes?: OrderChange[];
@@ -2307,7 +2808,10 @@ export interface OrderChangeValueOneOf {
     shippingInformationChanged?: ShippingInformationChange;
 }
 export interface LineItemChanges {
-    /** Line item ID. */
+    /**
+     * Line item ID.
+     * @format GUID
+     */
     _id?: string;
     /** Item name. */
     name?: ProductName;
@@ -2317,11 +2821,21 @@ export interface LineItemChanges {
     price?: LineItemPriceChange;
 }
 export interface LineItemQuantityChange {
-    /** Item quantity before update. */
+    /**
+     * Item quantity before update.
+     * @max 1000000
+     */
     originalQuantity?: number;
-    /** Item quantity after update. */
+    /**
+     * Item quantity after update.
+     * @max 1000000
+     */
     newQuantity?: number;
-    /** Difference between original and new quantity. Absolute value. */
+    /**
+     * Difference between original and new quantity. Absolute value.
+     * @min 1
+     * @max 1000000
+     */
     diff?: number;
     /** Type of quantity change: increase or decrease. */
     deltaType?: LineItemQuantityChangeType;
@@ -2339,15 +2853,25 @@ export interface LineItemPriceChange {
     newPrice?: Price;
 }
 export interface ManagedLineItem {
-    /** Line item ID. */
+    /**
+     * Line item ID.
+     * @format GUID
+     */
     _id?: string;
     /** Item name. */
     name?: ProductName;
-    /** Added or removed item quantity. */
+    /**
+     * Added or removed item quantity.
+     * @min 1
+     * @max 1000000
+     */
     quantity?: number;
 }
 export interface ManagedDiscount {
-    /** Discount id. */
+    /**
+     * Discount id.
+     * @format GUID
+     */
     _id?: string;
     /** Discount name: coupon name / discount rule name / merchant discount description. */
     name?: TranslatedValue;
@@ -2357,13 +2881,22 @@ export interface ManagedDiscount {
     totalAmount?: Price;
 }
 export interface TranslatedValue {
-    /** Value in site default language. */
+    /**
+     * Value in site default language.
+     * @minLength 1
+     */
     original?: string;
-    /** Translated value. */
+    /**
+     * Translated value.
+     * @minLength 1
+     */
     translated?: string | null;
 }
 export interface LineItemAmount {
-    /** Order line item id */
+    /**
+     * Order line item id
+     * @format GUID
+     */
     _id?: string;
     /** Item name. */
     name?: ProductName;
@@ -2371,7 +2904,10 @@ export interface LineItemAmount {
     amount?: Price;
 }
 export interface ManagedAdditionalFee {
-    /** Additional fee id. */
+    /**
+     * Additional fee id.
+     * @format GUID
+     */
     _id?: string;
     /** Additional fee name. */
     name?: TranslatedValue;
@@ -2395,54 +2931,102 @@ export interface ShippingInformationChange {
 export interface ShippingInformation {
     /** Order’s shipping price. */
     total?: Price;
-    /** Order’s shipping title. */
+    /**
+     * Order’s shipping title.
+     * @maxLength 250
+     */
     shippingTitle?: string;
 }
 /** Payment method is saved for order */
 export interface SavedPaymentMethod {
-    /** Payment method name */
+    /**
+     * Payment method name
+     * @minLength 1
+     * @maxLength 100
+     */
     name?: string;
-    /** Payment method description */
+    /**
+     * Payment method description
+     * @minLength 1
+     * @maxLength 100
+     */
     description?: string | null;
 }
 export interface AuthorizedPaymentCreated {
-    /** Payment ID of payment associated with this activity */
+    /**
+     * Payment ID of payment associated with this activity
+     * @format GUID
+     */
     paymentId?: string;
     /** Payment amount */
     amount?: Price;
-    /** The last 4 digits of the card number. */
+    /**
+     * The last 4 digits of the card number.
+     * @maxLength 4
+     */
     lastFourDigits?: string | null;
-    /** Card issuer's brand. */
+    /**
+     * Card issuer's brand.
+     * @maxLength 100
+     */
     brand?: string | null;
 }
 export interface AuthorizedPaymentCaptured {
-    /** Payment ID of payment associated with this activity */
+    /**
+     * Payment ID of payment associated with this activity
+     * @format GUID
+     */
     paymentId?: string;
     /** Payment amount */
     amount?: Price;
-    /** The last 4 digits of the card number. */
+    /**
+     * The last 4 digits of the card number.
+     * @maxLength 4
+     */
     lastFourDigits?: string | null;
-    /** Card issuer's brand. */
+    /**
+     * Card issuer's brand.
+     * @maxLength 100
+     */
     brand?: string | null;
 }
 export interface AuthorizedPaymentVoided {
-    /** Payment ID of payment associated with this activity */
+    /**
+     * Payment ID of payment associated with this activity
+     * @format GUID
+     */
     paymentId?: string;
     /** Payment amount */
     amount?: Price;
-    /** The last 4 digits of the card number. */
+    /**
+     * The last 4 digits of the card number.
+     * @maxLength 4
+     */
     lastFourDigits?: string | null;
-    /** Card issuer's brand. */
+    /**
+     * Card issuer's brand.
+     * @maxLength 100
+     */
     brand?: string | null;
 }
 export interface RefundInitiated {
-    /** Refund ID. */
+    /**
+     * Refund ID.
+     * @format GUID
+     */
     refundId?: string;
     /** Refund amount. */
     amount?: Price;
-    /** Details about the payments being refunded. */
+    /**
+     * Details about the payments being refunded.
+     * @minSize 1
+     * @maxSize 50
+     */
     payments?: RefundedPayment[];
-    /** Reason for refund. */
+    /**
+     * Reason for refund.
+     * @maxLength 100
+     */
     reason?: string | null;
 }
 export interface RefundedPayment extends RefundedPaymentKindOneOf {
@@ -2452,7 +3036,10 @@ export interface RefundedPayment extends RefundedPaymentKindOneOf {
     giftCard?: GiftCardPaymentRefund;
     /** Membership payment refund. */
     membership?: MembershipPaymentRefund;
-    /** Payment ID. */
+    /**
+     * Payment ID.
+     * @format GUID
+     */
     paymentId?: string;
     /** Whether refund was made externally and manually on the payment provider's side. */
     externalRefund?: boolean;
@@ -2469,29 +3056,49 @@ export interface RefundedPaymentKindOneOf {
 export interface RegularPaymentRefund {
     /** Refund amount */
     amount?: Price;
-    /** The last 4 digits of the card number. */
+    /**
+     * The last 4 digits of the card number.
+     * @maxLength 4
+     */
     lastFourDigits?: string | null;
-    /** Card issuer's brand. */
+    /**
+     * Card issuer's brand.
+     * @maxLength 100
+     */
     brand?: string | null;
 }
 export interface GiftCardPaymentRefund {
-    /** Gift card payment ID */
+    /**
+     * Gift card payment ID
+     * @minLength 1
+     * @maxLength 100
+     */
     giftCardPaymentId?: string | null;
     /** Refund amount */
     amount?: Price;
 }
 export interface MembershipPaymentRefund {
-    /** Membership ID */
+    /**
+     * Membership ID
+     * @minLength 1
+     * @maxLength 100
+     */
     membershipId?: string | null;
 }
 export interface PaymentRefunded {
-    /** Refund ID. */
+    /**
+     * Refund ID.
+     * @format GUID
+     */
     refundId?: string;
     /** Details about the refunded payment. */
     payment?: RefundedPayment;
 }
 export interface PaymentRefundFailed {
-    /** Refund ID. */
+    /**
+     * Refund ID.
+     * @format GUID
+     */
     refundId?: string;
     /** Details about the failed payment refund. */
     payment?: RefundedPayment;
@@ -2499,13 +3106,19 @@ export interface PaymentRefundFailed {
 export interface RefundedAsStoreCredit {
     /** Refund amount */
     amount?: Price;
-    /** Reason for refund */
+    /**
+     * Reason for refund
+     * @maxLength 100
+     */
     reason?: string | null;
 }
 export interface PaymentPending extends PaymentPendingPaymentDetailsOneOf {
     /** Regular payment. */
     regular?: RegularPayment;
-    /** Payment ID of payment associated with this activity */
+    /**
+     * Payment ID of payment associated with this activity
+     * @format GUID
+     */
     paymentId?: string;
 }
 /** @oneof */
@@ -2525,15 +3138,24 @@ export interface RegularPaymentPaymentMethodDetailsOneOf {
     creditCardDetails?: CreditCardDetails;
 }
 export interface CreditCardDetails {
-    /** The last 4 digits of the card number. */
+    /**
+     * The last 4 digits of the card number.
+     * @maxLength 4
+     */
     lastFourDigits?: string | null;
-    /** Card issuer's brand. */
+    /**
+     * Card issuer's brand.
+     * @maxLength 100
+     */
     brand?: string | null;
 }
 export interface PaymentCanceled extends PaymentCanceledPaymentDetailsOneOf {
     /** Regular payment. */
     regular?: RegularPayment;
-    /** Payment ID of payment associated with this activity */
+    /**
+     * Payment ID of payment associated with this activity
+     * @format GUID
+     */
     paymentId?: string;
 }
 /** @oneof */
@@ -2544,7 +3166,10 @@ export interface PaymentCanceledPaymentDetailsOneOf {
 export interface PaymentDeclined extends PaymentDeclinedPaymentDetailsOneOf {
     /** Regular payment. */
     regular?: RegularPayment;
-    /** Payment ID of payment associated with this activity */
+    /**
+     * Payment ID of payment associated with this activity
+     * @format GUID
+     */
     paymentId?: string;
 }
 /** @oneof */
@@ -2557,7 +3182,10 @@ export interface ReceiptCreated extends ReceiptCreatedReceiptInfoOneOf {
     wixReceipt?: WixReceipt;
     /** Receipt created by an external system. */
     externalReceipt?: ExternalReceipt;
-    /** Payment ID of payment associated with this activity */
+    /**
+     * Payment ID of payment associated with this activity
+     * @format GUID
+     */
     paymentId?: string;
 }
 /** @oneof */
@@ -2568,15 +3196,29 @@ export interface ReceiptCreatedReceiptInfoOneOf {
     externalReceipt?: ExternalReceipt;
 }
 export interface WixReceipt {
-    /** Receipt ID */
+    /**
+     * Receipt ID
+     * @format GUID
+     */
     receiptId?: string;
-    /** Display number of receipt */
+    /**
+     * Display number of receipt
+     * @minLength 1
+     * @maxLength 40
+     */
     displayNumber?: string | null;
 }
 export interface ExternalReceipt {
-    /** Receipt ID */
+    /**
+     * Receipt ID
+     * @maxLength 100
+     */
     receiptId?: string | null;
-    /** Display number of receipt */
+    /**
+     * Display number of receipt
+     * @minLength 1
+     * @maxLength 40
+     */
     displayNumber?: string | null;
 }
 export interface ReceiptSent extends ReceiptSentReceiptInfoOneOf {
@@ -2584,7 +3226,10 @@ export interface ReceiptSent extends ReceiptSentReceiptInfoOneOf {
     wixReceipt?: WixReceipt;
     /** Receipt created by an external system. */
     externalReceipt?: ExternalReceipt;
-    /** Payment ID of payment associated with this activity */
+    /**
+     * Payment ID of payment associated with this activity
+     * @format GUID
+     */
     paymentId?: string;
 }
 /** @oneof */
@@ -2639,13 +3284,23 @@ export interface V1CreatedBy extends V1CreatedByStringOneOf {
     /**
      * User ID - when the order was created by a Wix user on behalf of a buyer.
      * For example, via POS (point of service).
+     * @format GUID
      */
     userId?: string;
-    /** Member ID - when the order was created by a **logged in** site visitor. */
+    /**
+     * Member ID - when the order was created by a **logged in** site visitor.
+     * @format GUID
+     */
     memberId?: string;
-    /** Visitor ID - when the order was created by a site visitor that was **not** logged in. */
+    /**
+     * Visitor ID - when the order was created by a site visitor that was **not** logged in.
+     * @format GUID
+     */
     visitorId?: string;
-    /** App ID - when the order was created by an external application. */
+    /**
+     * App ID - when the order was created by an external application.
+     * @format GUID
+     */
     appId?: string;
 }
 /** @oneof */
@@ -2653,21 +3308,37 @@ export interface V1CreatedByStringOneOf {
     /**
      * User ID - when the order was created by a Wix user on behalf of a buyer.
      * For example, via POS (point of service).
+     * @format GUID
      */
     userId?: string;
-    /** Member ID - when the order was created by a **logged in** site visitor. */
+    /**
+     * Member ID - when the order was created by a **logged in** site visitor.
+     * @format GUID
+     */
     memberId?: string;
-    /** Visitor ID - when the order was created by a site visitor that was **not** logged in. */
+    /**
+     * Visitor ID - when the order was created by a site visitor that was **not** logged in.
+     * @format GUID
+     */
     visitorId?: string;
-    /** App ID - when the order was created by an external application. */
+    /**
+     * App ID - when the order was created by an external application.
+     * @format GUID
+     */
     appId?: string;
 }
 export interface ChannelInfo {
     /** Sales channel that submitted the order. */
     type?: ChannelType;
-    /** Reference to an order ID from an external system. */
+    /**
+     * Reference to an order ID from an external system.
+     * @maxLength 100
+     */
     externalOrderId?: string | null;
-    /** URL to the order in the external system. */
+    /**
+     * URL to the order in the external system.
+     * @maxLength 300
+     */
     externalOrderUrl?: string | null;
 }
 export declare enum ChannelType {
@@ -2707,9 +3378,17 @@ export declare enum ChannelType {
 export interface CustomField {
     /** Custom field value. */
     value?: any;
-    /** Custom field title. */
+    /**
+     * Custom field title.
+     * @minLength 1
+     * @maxLength 500
+     */
     title?: string;
-    /** Translated custom field title. */
+    /**
+     * Translated custom field title.
+     * @minLength 1
+     * @maxLength 500
+     */
     translatedTitle?: string | null;
 }
 export interface V1BalanceSummary {
@@ -2780,13 +3459,18 @@ export interface Tags {
     tags?: TagList;
 }
 export interface TagList {
-    /** List of tag IDs */
+    /**
+     * List of tag IDs
+     * @maxSize 100
+     * @maxLength 5
+     */
     tagIds?: string[];
 }
 export interface CreateOrderFromDraftRequest {
     /**
      * The draft order id
      * @internal
+     * @format GUID
      */
     draftOrderId: string;
     /**
@@ -2797,6 +3481,7 @@ export interface CreateOrderFromDraftRequest {
     /**
      * Reason for order creation, given by user (optional).
      * @internal
+     * @maxLength 200
      */
     reason?: string | null;
     /**
@@ -2841,7 +3526,10 @@ export interface CreateOrderFromDraftResponse {
     createdOrder?: Order;
 }
 export interface DeleteDraftOrderRequest {
-    /** The draft order id */
+    /**
+     * The draft order id
+     * @format GUID
+     */
     draftOrderId: string;
 }
 export interface DeleteDraftOrderResponse {
@@ -2867,6 +3555,7 @@ export interface CursorQuery extends CursorQueryPagingMethodOneOf {
      * Sort object.
      *
      * Learn more about the [sort section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section).
+     * @maxSize 5
      */
     sort?: Sorting[];
 }
@@ -2880,7 +3569,10 @@ export interface CursorQueryPagingMethodOneOf {
     cursorPaging?: CursorPaging;
 }
 export interface Sorting {
-    /** Name of the field to sort by. */
+    /**
+     * Name of the field to sort by.
+     * @maxLength 512
+     */
     fieldName?: string;
     /** Sort order. */
     order?: SortOrder;
@@ -2890,13 +3582,17 @@ export declare enum SortOrder {
     DESC = "DESC"
 }
 export interface CursorPaging {
-    /** Maximum number of items to return in the results. */
+    /**
+     * Maximum number of items to return in the results.
+     * @max 100
+     */
     limit?: number | null;
     /**
      * Pointer to the next or previous page in the list of results.
      *
      * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
      * Not relevant for the first request.
+     * @maxLength 16000
      */
     cursor?: string | null;
 }
@@ -2920,9 +3616,15 @@ export interface CursorPagingMetadata {
     hasNext?: boolean | null;
 }
 export interface Cursors {
-    /** Cursor string pointing to the next page in the list of results. */
+    /**
+     * Cursor string pointing to the next page in the list of results.
+     * @maxLength 16000
+     */
     next?: string | null;
-    /** Cursor pointing to the previous page in the list of results. */
+    /**
+     * Cursor pointing to the previous page in the list of results.
+     * @maxLength 16000
+     */
     prev?: string | null;
 }
 export interface UpdateExtendedFieldsRequest {
@@ -2941,6 +3643,7 @@ export interface SetTaxExemptionRequest {
     /**
      * Draft order ID.
      * @internal
+     * @format GUID
      */
     draftOrderId: string;
     /**
@@ -2959,11 +3662,17 @@ export interface SetTaxExemptionResponse {
     calculatedDraftOrder?: CalculatedDraftOrder;
 }
 export interface GetDraftEditabilityStatusRequest {
-    /** Draft order ID. */
+    /**
+     * Draft order ID.
+     * @format GUID
+     */
     draftOrderId?: string | null;
 }
 export interface GetDraftEditabilityStatusResponse {
-    /** Draft order ID. */
+    /**
+     * Draft order ID.
+     * @format GUID
+     */
     draftOrderId?: string | null;
     /**
      * Draft order status.
@@ -2975,6 +3684,7 @@ export interface SetBusinessLocationRequest {
     /**
      * Draft order ID.
      * @internal
+     * @format GUID
      */
     draftOrderId: string;
     /**
@@ -3061,9 +3771,15 @@ export interface ActionEvent {
     body?: string;
 }
 export interface MessageEnvelope {
-    /** App instance ID. */
+    /**
+     * App instance ID.
+     * @format GUID
+     */
     instanceId?: string | null;
-    /** Event type. */
+    /**
+     * Event type.
+     * @maxLength 150
+     */
     eventType?: string;
     /** The identification type and identity data. */
     identity?: IdentificationData;
@@ -3071,26 +3787,50 @@ export interface MessageEnvelope {
     data?: string;
 }
 export interface IdentificationData extends IdentificationDataIdOneOf {
-    /** ID of a site visitor that has not logged in to the site. */
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
     anonymousVisitorId?: string;
-    /** ID of a site visitor that has logged in to the site. */
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
     memberId?: string;
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
     wixUserId?: string;
-    /** ID of an app. */
+    /**
+     * ID of an app.
+     * @format GUID
+     */
     appId?: string;
     /** @readonly */
     identityType?: WebhookIdentityType;
 }
 /** @oneof */
 export interface IdentificationDataIdOneOf {
-    /** ID of a site visitor that has not logged in to the site. */
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
     anonymousVisitorId?: string;
-    /** ID of a site visitor that has logged in to the site. */
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
     memberId?: string;
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
     wixUserId?: string;
-    /** ID of an app. */
+    /**
+     * ID of an app.
+     * @format GUID
+     */
     appId?: string;
 }
 export declare enum WebhookIdentityType {
@@ -3421,17 +4161,12 @@ interface LocationNonNullableFields {
     name: string;
 }
 interface BusinessLocationChangedDetailsNonNullableFields {
-    /** @internal */
     businessLocationBeforeChange?: LocationNonNullableFields;
 }
 interface BusinessLocationDetailsNonNullableFields {
-    /** @internal */
     added: boolean;
-    /** @internal */
     changedDetails?: BusinessLocationChangedDetailsNonNullableFields;
-    /** @internal */
     removed: boolean;
-    /** @internal */
     businessLocation?: LocationNonNullableFields;
 }
 interface DraftOrderNonNullableFields {
@@ -3455,7 +4190,6 @@ interface DraftOrderNonNullableFields {
     buyerDetails?: BuyerDetailsNonNullableFields;
     /** @internal */
     billingDetails?: BillingDetailsNonNullableFields;
-    /** @internal */
     businessLocationDetails?: BusinessLocationDetailsNonNullableFields;
 }
 interface PickupDetailsNonNullableFields {
@@ -3814,7 +4548,6 @@ interface OrderNonNullableFields {
     recipientInfo?: AddressWithContactNonNullableFields;
     /** @internal */
     tags?: TagsNonNullableFields;
-    /** @internal */
     businessLocation?: LocationNonNullableFields;
     /** @internal */
     payAfterFreeTrial?: PriceSummaryNonNullableFields;
@@ -3854,6 +4587,8 @@ export interface SetBusinessLocationResponseNonNullableFields {
  * @permissionId DRAFT_ORDER_WRITE_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -3869,6 +4604,8 @@ export declare function createDraftOrder(orderId: string | null): Promise<Create
  * @permissionId DRAFT_ORDER_WRITE_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -3885,6 +4622,8 @@ export declare function createEmptyDraftOrder(): Promise<CreateEmptyDraftOrderRe
  * @permissionId ECOM.DRAFT_ORDERS_ADD_LINE_ITEMS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -3892,9 +4631,15 @@ export declare function createEmptyDraftOrder(): Promise<CreateEmptyDraftOrderRe
  */
 export declare function addLineItemsToDraftOrder(draftOrderId: string, options?: AddLineItemsToDraftOrderOptions): Promise<AddLineItemsToDraftOrderResponse & AddLineItemsToDraftOrderResponseNonNullableFields>;
 export interface AddLineItemsToDraftOrderOptions {
-    /** Catalog line items to add to draft order. */
+    /**
+     * Catalog line items to add to draft order.
+     * @maxSize 300
+     */
     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 don't trigger the Catalog service plugin.
+     * @maxSize 300
+     */
     customLineItems?: CustomLineItem[];
 }
 /**
@@ -3912,6 +4657,8 @@ export interface AddLineItemsToDraftOrderOptions {
  * @permissionId ECOM.DRAFT_ORDERS_MODIFY_ITEMS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -3919,7 +4666,11 @@ export interface AddLineItemsToDraftOrderOptions {
  */
 export declare function updateLineItems(draftOrderId: string, options?: UpdateLineItemsOptions): Promise<UpdateLineItemsResponse & UpdateLineItemsResponseNonNullableFields>;
 export interface UpdateLineItemsOptions {
-    /** Details of changes to apply per line item */
+    /**
+     * Details of changes to apply per line item
+     * @minSize 1
+     * @maxSize 300
+     */
     lineItemChanges?: LineItemChangeDetails[];
 }
 /**
@@ -3935,6 +4686,8 @@ export interface UpdateLineItemsOptions {
  * @permissionId ECOM.DRAFT_ORDERS_SET_DISCOUNTS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -3953,6 +4706,8 @@ export declare function setDiscounts(draftOrderId: string, discounts: IdAndAppli
  * @permissionId ECOM.DRAFT_ORDERS_ADD_DISCOUNTS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -3960,7 +4715,11 @@ export declare function setDiscounts(draftOrderId: string, discounts: IdAndAppli
  */
 export declare function createCustomDiscounts(draftOrderId: string, options?: CreateCustomDiscountsOptions): Promise<CreateCustomDiscountsResponse & CreateCustomDiscountsResponseNonNullableFields>;
 export interface CreateCustomDiscountsOptions {
-    /** The discounts to add. */
+    /**
+     * The discounts to add.
+     * @minSize 1
+     * @maxSize 100
+     */
     discounts?: DiscountOption[];
 }
 /**
@@ -3974,6 +4733,8 @@ export interface CreateCustomDiscountsOptions {
  * @permissionId ECOM.DRAFT_ORDERS_DELETE_DISCOUNTS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -3992,6 +4753,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 Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -4012,6 +4775,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 Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -4019,7 +4784,11 @@ export declare function setAdditionalFees(draftOrderId: string, additionalFees:
  */
 export declare function createCustomAdditionalFees(draftOrderId: string, options?: CreateCustomAdditionalFeesOptions): Promise<CreateCustomAdditionalFeesResponse & CreateCustomAdditionalFeesResponseNonNullableFields>;
 export interface CreateCustomAdditionalFeesOptions {
-    /** The additional fees to add. added with opted-out setting */
+    /**
+     * The additional fees to add. added with opted-out setting
+     * @minSize 1
+     * @maxSize 100
+     */
     customAdditionalFees?: AdditionalFeeOption[];
 }
 /**
@@ -4033,6 +4802,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 Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -4046,6 +4817,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 Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -4059,6 +4832,8 @@ export declare function setShippingInfo(): Promise<void>;
  * @permissionId ECOM.DRAFT_ORDER_SET_BUYER_INFO
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -4072,6 +4847,8 @@ export declare function setBuyerInfo(): Promise<void>;
  * @permissionId ECOM.DRAFT_ORDER_SET_RECIPIENT_INFO
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -4085,6 +4862,8 @@ export declare function setRecipientInfo(): Promise<void>;
  * @permissionId ECOM.DRAFT_ORDER_SET_BILLING_INFO
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -4105,6 +4884,8 @@ export declare function setBillingInfo(): Promise<void>;
  * @permissionId ECOM.DRAFT_ORDER_READ_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -4120,6 +4901,8 @@ export declare function getDraftOrder(draftOrderId: string): Promise<GetDraftOrd
  * @permissionId ECOM.DRAFT_ORDERS_READ
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -4138,6 +4921,8 @@ export declare function getOrderDraftabilityStatus(orderId: string): Promise<Get
  * @permissionId ECOM.DRAFT_ORDER_READ_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -4147,7 +4932,10 @@ export declare function commitDraftOrder(draftOrderId: string, options?: CommitD
 export interface CommitDraftOrderOptions {
     /** Optional side effects to trigger */
     commitSettings?: DraftOrderCommitSettings;
-    /** Reason for edit, given by user (optional). */
+    /**
+     * Reason for edit, given by user (optional).
+     * @maxLength 200
+     */
     reason?: string | null;
 }
 /**
@@ -4160,6 +4948,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 Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -4177,6 +4967,8 @@ export declare function createOrderFromDraft(): Promise<void>;
  * @permissionId ECOM.DRAFT_ORDERS_ADMIN_DELETE
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -4198,6 +4990,8 @@ export declare function deleteDraftOrder(draftOrderId: string): Promise<void>;
  * @documentationMaturity preview
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.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
@@ -4289,6 +5083,8 @@ export interface DraftOrdersQueryBuilder {
  * @permissionId ECOM.DRAFT_ORDER_SET_TAX_EXEMPTION
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP
@@ -4302,6 +5098,8 @@ export declare function setTaxExemption(): Promise<void>;
  * @permissionId ECOM.DRAFT_ORDER_SET_BUSINESS_LOCATION
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @applicableIdentity APP