@wix/auto_sdk_ecom_draft-orders 1.0.24 → 1.0.26

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

@@ -1,5 +1,8 @@
 import { NonNullablePaths } from '@wix/sdk-types';
-/** Draft Orders main entity. */
+/**
+ * Draft Order main entity.
+ * A temporary version of an order, allowing modifications before finalization.
+ */
 export interface DraftOrder {
     /**
      * Draft order ID.
@@ -318,6 +321,13 @@ export interface OrderLineItem {
      * [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;
+    /**
+     * Modifier groups that were added to the item.
+     * @internal
+     * @readonly
+     * @maxSize 10
+     */
+    modifierGroups?: ModifierGroup[];
 }
 export interface ProductName {
     /**
@@ -635,7 +645,6 @@ export interface SubscriptionInfo {
     subscriptionSettings?: SubscriptionSettings;
     /**
      * Description of the charges that will be applied for subscription.
-     * @internal
      * @maxLength 1000
      */
     chargesDescription?: string | null;
@@ -796,6 +805,63 @@ export interface ExtendedFields {
      */
     namespaces?: Record<string, Record<string, any>>;
 }
+export interface ModifierGroup {
+    /**
+     * Modifier group id.
+     * @minLength 1
+     * @maxLength 36
+     */
+    _id?: string;
+    /** Modifier group name. */
+    name?: TranslatableString;
+    /**
+     * List of modifiers in this group.
+     * @minSize 1
+     * @maxSize 10
+     */
+    modifiers?: ItemModifier[];
+}
+export interface TranslatableString {
+    /**
+     * __Required.__ String in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
+     *
+     * Min: 1 character.
+     * Max: 200 characters.
+     * @minLength 1
+     * @maxLength 200
+     */
+    original?: string;
+    /**
+     * String translated into the buyer's language.
+     *
+     * Min: 1 character.
+     * Max: 400 characters.
+     * Default: Same as `original`.
+     * @minLength 1
+     * @maxLength 400
+     */
+    translated?: string | null;
+}
+export interface ItemModifier {
+    /**
+     * Modifier ID.
+     * @minLength 1
+     * @maxLength 36
+     */
+    _id?: string;
+    /**
+     * The quantity of this modifier.
+     * @min 1
+     * @max 100000
+     */
+    quantity?: number | null;
+    /** Primary display label for the modifier. */
+    label?: TranslatableString;
+    /** Optional additional details or clarification for the modifier. */
+    details?: TranslatableString;
+    /** The price of the modifier. */
+    price?: Price;
+}
 export interface ItemChangedDetails {
     /**
      * Line item quantity before change.
@@ -1133,7 +1199,7 @@ export interface AdditionalFeeDetails {
      * Supported values:
      * + `ORIGINAL_ORDER`: This additional fee is part of the original order.
      * + `AUTOMATIC`: User added a catalog item which is configured to have an additional fee.
-     * + `CUSTOM`: This additional fee was created by the [Create Custom Additional Fees](https://dev.wix.com/docs/rest/api-reference/wix-e-commerce/draft-orders/create-custom-additional-fees) API.
+     * + `CUSTOM`: This additional fee was created by the Create Custom Additional Fees method.
      */
     source?: SourceType;
     /** Whether this additional fee is applied to the order. */
@@ -1211,7 +1277,7 @@ export interface DiscountDetails {
      *
      * Supported values:
      * + `ORIGINAL_ORDER`: This discount is part of the original order.
-     * + `CUSTOM`: This discount was created by the [Create Custom Discounts](https://dev.wix.com/docs/rest/api-reference/wix-e-commerce/draft-orders/create-custom-discounts) API.
+     * + `CUSTOM`: This discount was created by the Create Custom Discounts method.
      */
     source?: SourceType;
     /** Whether this discount is applied to the order. */
@@ -1722,7 +1788,9 @@ export interface PickupDetails {
 }
 export declare enum PickupMethod {
     UNKNOWN_METHOD = "UNKNOWN_METHOD",
+    /** Store pickup. */
     STORE_PICKUP = "STORE_PICKUP",
+    /** Pickup point. */
     PICKUP_POINT = "PICKUP_POINT"
 }
 export interface DeliveryTimeSlot {
@@ -3921,12 +3989,126 @@ export declare enum WebhookIdentityType {
     WIX_USER = "WIX_USER",
     APP = "APP"
 }
+export interface BaseEventMetadata {
+    /**
+     * App instance ID.
+     * @format GUID
+     */
+    instanceId?: string | null;
+    /**
+     * Event type.
+     * @maxLength 150
+     */
+    eventType?: string;
+    /** The identification type and identity data. */
+    identity?: IdentificationData;
+}
+export interface EventMetadata extends BaseEventMetadata {
+    /**
+     * Unique event ID.
+     * Allows clients to ignore duplicate webhooks.
+     */
+    _id?: string;
+    /**
+     * Assumes actions are also always typed to an entity_type
+     * Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction
+     */
+    entityFqdn?: string;
+    /**
+     * This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug)
+     * This is although the created/updated/deleted notion is duplication of the oneof types
+     * Example: created/updated/deleted/started/completed/email_opened
+     */
+    slug?: string;
+    /** ID of the entity associated with the event. */
+    entityId?: string;
+    /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z */
+    eventTime?: Date | null;
+    /**
+     * Whether the event was triggered as a result of a privacy regulation application
+     * (for example, GDPR).
+     */
+    triggeredByAnonymizeRequest?: boolean | null;
+    /** If present, indicates the action that triggered the event. */
+    originatedFrom?: string | null;
+    /**
+     * A sequence number defining the order of updates to the underlying entity.
+     * For example, given that some entity was updated at 16:00 and than again at 16:01,
+     * it is guaranteed that the sequence number of the second update is strictly higher than the first.
+     * As the consumer, you can use this value to ensure that you handle messages in the correct order.
+     * To do so, you will need to persist this number on your end, and compare the sequence number from the
+     * message against the one you have stored. Given that the stored number is higher, you should ignore the message.
+     */
+    entityEventSequence?: string | null;
+}
+export interface DraftOrderCreatedEnvelope {
+    entity: DraftOrder;
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when a draft order is created.
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Manage eCommerce - all permissions
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
+ * @permissionId ECOM.DRAFT_ORDERS_READ
+ * @webhook
+ * @eventType wix.ecom.v1.draft_order_created
+ * @slug created
+ * @documentationMaturity preview
+ */
+export declare function onDraftOrderCreated(handler: (event: DraftOrderCreatedEnvelope) => void | Promise<void>): void;
+export interface DraftOrderDeletedEnvelope {
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when a draft order is deleted.
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Manage eCommerce - all permissions
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
+ * @permissionId ECOM.DRAFT_ORDERS_READ
+ * @webhook
+ * @eventType wix.ecom.v1.draft_order_deleted
+ * @slug deleted
+ * @documentationMaturity preview
+ */
+export declare function onDraftOrderDeleted(handler: (event: DraftOrderDeletedEnvelope) => void | Promise<void>): void;
+export interface DraftOrderUpdatedEnvelope {
+    entity: DraftOrder;
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when a draft order is updated.
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Manage eCommerce - all permissions
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
+ * @permissionId ECOM.DRAFT_ORDERS_READ
+ * @webhook
+ * @eventType wix.ecom.v1.draft_order_updated
+ * @slug updated
+ * @documentationMaturity preview
+ */
+export declare function onDraftOrderUpdated(handler: (event: DraftOrderUpdatedEnvelope) => void | Promise<void>): void;
 type DraftOrderNonNullablePaths = `lineItems` | `lineItems.${number}.added` | `lineItems.${number}.changedDetails.priceBeforeChange.amount` | `lineItems.${number}.changedDetails.priceBeforeChange.formattedAmount` | `lineItems.${number}.changedDetails.priceDescriptionBeforeChange.original` | `lineItems.${number}.removed` | `lineItems.${number}.lineItem._id` | `lineItems.${number}.lineItem.productName.original` | `lineItems.${number}.lineItem.catalogReference.catalogItemId` | `lineItems.${number}.lineItem.catalogReference.appId` | `lineItems.${number}.lineItem.quantity` | `lineItems.${number}.lineItem.physicalProperties.shippable` | `lineItems.${number}.lineItem.itemType.preset` | `lineItems.${number}.lineItem.itemType.custom` | `lineItems.${number}.lineItem.paymentOption` | `lineItems.${number}.lineItem.taxDetails.taxRate` | `lineItems.${number}.lineItem.taxInfo.taxIncludedInPrice` | `lineItems.${number}.lineItem.digitalFile.fileId` | `lineItems.${number}.lineItem.subscriptionInfo.cycleNumber` | `lineItems.${number}.lineItem.subscriptionInfo.subscriptionOptionTitle` | `lineItems.${number}.lineItem.subscriptionInfo.subscriptionSettings.frequency` | `lineItems.${number}.lineItem.subscriptionInfo.subscriptionSettings.autoRenewal` | `lineItems.${number}.lineItem.taxableAddress.addressType` | `shippingInfo.added` | `shippingInfo.changedDetails.shippingInfoBeforeChange.title` | `shippingInfo.changedDetails.shippingInfoBeforeChange.logistics.shippingDestination.address.streetAddress.number` | `shippingInfo.changedDetails.shippingInfoBeforeChange.logistics.shippingDestination.address.streetAddress.name` | `shippingInfo.changedDetails.shippingInfoBeforeChange.logistics.shippingDestination.contactDetails.vatId._id` | `shippingInfo.changedDetails.shippingInfoBeforeChange.logistics.shippingDestination.contactDetails.vatId.type` | `shippingInfo.changedDetails.shippingInfoBeforeChange.logistics.pickupDetails.pickupMethod` | `shippingInfo.changedDetails.shippingInfoBeforeChange.cost.price.amount` | `shippingInfo.changedDetails.shippingInfoBeforeChange.cost.price.formattedAmount` | `shippingInfo.changedDetails.shippingInfoBeforeChange.cost.taxDetails.taxRate` | `shippingInfo.removed` | `buyerInfo.visitorId` | `buyerInfo.memberId` | `billingInfo.address.streetAddress.number` | `billingInfo.address.streetAddress.name` | `billingInfo.contactDetails.vatId._id` | `billingInfo.contactDetails.vatId.type` | `additionalFees` | `additionalFees.${number}.additionalFee.name` | `additionalFees.${number}.additionalFee.price.amount` | `additionalFees.${number}.additionalFee.price.formattedAmount` | `additionalFees.${number}.additionalFee.taxDetails.taxRate` | `additionalFees.${number}.additionalFee._id` | `additionalFees.${number}.taxDetails.taxable` | `additionalFees.${number}.source` | `additionalFees.${number}.applied` | `discounts` | `discounts.${number}.discount.coupon._id` | `discounts.${number}.discount.coupon.code` | `discounts.${number}.discount.coupon.name` | `discounts.${number}.discount.coupon.amount.amount` | `discounts.${number}.discount.coupon.amount.formattedAmount` | `discounts.${number}.discount.merchantDiscount.discountReason` | `discounts.${number}.discount.discountRule._id` | `discounts.${number}.discount.discountRule.name.original` | `discounts.${number}.discount.discountType` | `discounts.${number}.source` | `discounts.${number}.applied` | `createdBy.userId` | `createdBy.appId` | `status` | `weightUnit` | `priceSummary.subtotal.amount` | `priceSummary.subtotal.formattedAmount` | `taxSummary.totalTax.amount` | `taxSummary.totalTax.formattedAmount` | `balanceSummary.balance.amount` | `balanceSummary.balance.formattedAmount` | `balanceSummary.paid.amount` | `balanceSummary.paid.formattedAmount` | `commitSettings.updateInventory` | `commitSettings.updateInventory.${number}.lineItemId` | `recipientInfo.added` | `recipientInfo.changedDetails.recipientInfoBeforeChange.address.streetAddress.number` | `recipientInfo.changedDetails.recipientInfoBeforeChange.address.streetAddress.name` | `recipientInfo.changedDetails.recipientInfoBeforeChange.contactDetails.vatId._id` | `recipientInfo.changedDetails.recipientInfoBeforeChange.contactDetails.vatId.type` | `recipientInfo.removed` | `taxInfo.totalTax.amount` | `taxInfo.totalTax.formattedAmount` | `taxInfo.taxBreakdown` | `taxInfo.taxBreakdown.${number}.taxName` | `taxInfo.taxBreakdown.${number}.taxType` | `taxInfo.taxBreakdown.${number}.jurisdiction` | `taxInfo.taxBreakdown.${number}.jurisdictionType` | `taxInfo.taxBreakdown.${number}.rate` | `buyerDetails.added` | `buyerDetails.changedDetails.buyerInfoBeforeChange.visitorId` | `buyerDetails.changedDetails.buyerInfoBeforeChange.memberId` | `buyerDetails.removed` | `billingDetails.added` | `billingDetails.changedDetails.billingInfoBeforeChange.address.streetAddress.number` | `billingDetails.changedDetails.billingInfoBeforeChange.address.streetAddress.name` | `billingDetails.changedDetails.billingInfoBeforeChange.contactDetails.vatId._id` | `billingDetails.changedDetails.billingInfoBeforeChange.contactDetails.vatId.type` | `billingDetails.removed` | `businessLocationDetails.added` | `businessLocationDetails.changedDetails.businessLocationBeforeChange._id` | `businessLocationDetails.changedDetails.businessLocationBeforeChange.name` | `businessLocationDetails.removed`;
 /**
- * Creates or gets a draft order.
+ * Creates or retrieves a draft order based on the specified order ID.
  *
- * When passing the ID of an order that is already in draft, the existing draft order will be returned.
- * To complete a draft and update the order, call Commit Draft Order([REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/draft-orders/commit-draft-order) | [SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/commit-draft-order)).
+ * When passing the ID of an order that is already in draft, the existing draft order is returned.
+ * To complete a draft and update the original order, call Commit Draft Order.
  * @param orderId - ID of the order to create a draft for.
  * @public
  * @documentationMaturity preview
@@ -3936,6 +4118,8 @@ type DraftOrderNonNullablePaths = `lineItems` | `lineItems.${number}.added` | `l
  * @permissionId DRAFT_ORDER_WRITE_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -3948,6 +4132,8 @@ export declare function createDraftOrder(orderId: string): Promise<NonNullablePa
 }[DraftOrderNonNullablePaths] | `calculatedDraftOrder.shippingOptions` | `calculatedDraftOrder.shippingOptions.${number}.code` | `calculatedDraftOrder.shippingOptions.${number}.title` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.number` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.address.streetAddress.name` | `calculatedDraftOrder.shippingOptions.${number}.logistics.pickupDetails.pickupMethod` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.amount` | `calculatedDraftOrder.shippingOptions.${number}.cost.price.formattedAmount` | `calculatedDraftOrder.shippingOptions.${number}.cost.currency` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.code` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.applicationError.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.field` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.description` | `calculatedDraftOrder.calculationErrors.generalShippingCalculationError.validationError.fieldViolations.${number}.violatedRule` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors` | `calculatedDraftOrder.calculationErrors.carrierErrors.errors.${number}.carrierId` | `calculatedDraftOrder.calculationErrors.orderValidationErrors`>>;
 /**
  * Creates an empty draft order.
+ *
+ * After all relevant details are applied, call Create Order From Draft to convert the draft order to a regular order.
  * @public
  * @documentationMaturity preview
  * @permissionId ECOM.DRAFT_ORDERS_CREATE
@@ -3955,6 +4141,8 @@ export declare function createDraftOrder(orderId: string): Promise<NonNullablePa
  * @permissionId DRAFT_ORDER_WRITE_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -3975,6 +4163,8 @@ export declare function createEmptyDraftOrder(): Promise<NonNullablePaths<Create
  * @permissionId ECOM.DRAFT_ORDERS_ADD_LINE_ITEMS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4002,11 +4192,11 @@ export interface AddLineItemsToDraftOrderOptions {
 /**
  * Updates a draft order's line items.
  *
- * Using this API, you can update a line item's quantity, price, and description.
+ * You can update a line item's quantity, price, and description.
  * > **Notes:**
- * > + Passing a quantity of `0` will remove the line item.
+ * > + Specifying a quantity of `0` will remove the line item.
  * > + Price cannot be updated for line items with `paymentOption: MEMBERSHIP`.
- * > + Quantity cannot be decreased fulfilled line items. To retrive fulfillment information, pass the order ID to [List Fulfillments For Single Order](https://dev.wix.com/docs/rest/api-reference/wix-e-commerce/order-fulfillments/list-fulfillments-for-single-order).
+ * > + Quantity cannot be decreased for fulfilled line items. To retrieve fulfillment information, specify the order ID when calling List Fulfillments For Single Order ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/order-fulfillments/list-fulfillments-for-single-order) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/order-fulfillments/list-fulfillments-for-single-order)).
  * @param draftOrderId - Draft order ID.
  * @param lineItemChanges - Details of changes to apply per line item.
  * @public
@@ -4017,6 +4207,8 @@ export interface AddLineItemsToDraftOrderOptions {
  * @permissionId ECOM.DRAFT_ORDERS_MODIFY_ITEMS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4045,6 +4237,8 @@ export declare function updateLineItems(draftOrderId: string, lineItemChanges: N
  * @permissionId ECOM.DRAFT_ORDERS_SET_DISCOUNTS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4059,7 +4253,7 @@ export declare function setDiscounts(draftOrderId: string, discounts: NonNullabl
  * Creates custom discounts.
  *
  * Newly created discounts are unapplied by default.
- * To apply them, use Set Discounts ([REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/draft-orders/set-discounts) | [SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/set-discounts)).
+ * To apply them, use Set Discounts.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -4070,6 +4264,8 @@ export declare function setDiscounts(draftOrderId: string, discounts: NonNullabl
  * @permissionId ECOM.DRAFT_ORDERS_ADD_DISCOUNTS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4101,6 +4297,8 @@ export interface CreateCustomDiscountsOptions {
  * @permissionId ECOM.DRAFT_ORDERS_DELETE_DISCOUNTS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4129,6 +4327,8 @@ export declare function deleteCustomDiscounts(draftOrderId: string, discountIds:
  * @permissionId ECOM.DRAFT_ORDERS_SET_ADDITIONAL_FEES
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4143,7 +4343,7 @@ export declare function setAdditionalFees(draftOrderId: string, additionalFees:
  * Creates custom additional fees on a draft order.
  *
  * Newly created additional fees are not applied by default.
- * To apply them, use Set Additional Fees ([REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/draft-orders/set-additional-fees) | [SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/set-additional-fees)).
+ * To apply them, use Set Additional Fees.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -4154,6 +4354,8 @@ export declare function setAdditionalFees(draftOrderId: string, additionalFees:
  * @permissionId ECOM.DRAFT_ORDERS_CREATE_ADDITIONAL_FEES
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4185,6 +4387,8 @@ export interface CreateCustomAdditionalFeesOptions {
  * @permissionId ECOM.DRAFT_ORDERS_DELETE_ADDITIONAL_FEES
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4204,6 +4408,8 @@ export declare function deleteCustomAdditionalFees(draftOrderId: string, customA
  * @permissionId ECOM.DRAFT_ORDERS_SET_SHIPPING_INFO
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4231,6 +4437,8 @@ export interface SetShippingInfoOptions {
  * @permissionId ECOM.DRAFT_ORDER_SET_BUYER_INFO
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4258,6 +4466,8 @@ export interface SetBuyerInfoOptions {
  * @permissionId ECOM.DRAFT_ORDER_SET_RECIPIENT_INFO
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4285,6 +4495,8 @@ export interface SetRecipientInfoOptions {
  * @permissionId ECOM.DRAFT_ORDER_SET_BILLING_INFO
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4320,6 +4532,8 @@ export interface SetBillingInfoOptions {
  * @permissionId ECOM.DRAFT_ORDER_READ_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4339,6 +4553,8 @@ export declare function getDraftOrder(draftOrderId: string): Promise<NonNullable
  * @permissionId ECOM.DRAFT_ORDERS_READ
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4363,6 +4579,8 @@ export declare function getOrderDraftabilityStatus(orderId: string): Promise<Non
  * @permissionId ECOM.DRAFT_ORDER_READ_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4397,6 +4615,8 @@ export interface CommitDraftOrderOptions {
  * @permissionId ECOM.DRAFT_ORDER_READ_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4430,6 +4650,8 @@ export interface CreateOrderFromDraftOptions {
  * @permissionId ECOM.DRAFT_ORDERS_ADMIN_DELETE
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4439,21 +4661,16 @@ export interface CreateOrderFromDraftOptions {
  */
 export declare function deleteDraftOrder(draftOrderId: string): Promise<void>;
 /**
- * Retrieves a list of draft orders given the provided paging, filtering, and sorting. Up to 100 draft orders can be returned per request.
- *
- * Refer to the table below for supported fields, filters, and sorting:
- * | **Property**   | **Supported Filters & Sorting**                                                 | **Sortable** |
- * |----------------|---------------------------------------------------------------------------------|--------------|
- * | `_createdDate` | `eq()`, `ne()`, `exists()`, `in()`, `hasSome()`, `lt()`, `le()`, `gt()`, `ge()` | Sortable     |
- * | `_updatedDate` | `eq()`, `ne()`, `exists()`, `in()`, `hasSome()`, `lt()`, `le()`, `gt()`, `ge()` | Sortable     |
- * | `status`       | `eq()`, `ne()`, `exists()`, `in()`, `hasSome()`                                 | Sortable     |
- * | `orderId`      | `eq()`, `ne()`, `exists()`, `in()`, `hasSome()`, `startsWith()`                 |              |
+ * Retrieves a list of up to 100 draft orders, given the provided paging, filtering, and sorting.
  *
+ * For field support, see [supported filters and sorting](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/draft-orders/supported-filters-and-sorting).
  * To learn how to query draft orders, see [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language).
  * @public
  * @documentationMaturity preview
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4554,12 +4771,16 @@ export interface DraftOrdersQueryBuilder {
  * @permissionId ECOM.DRAFT_ORDER_WRITE_ALL_EXTENDED_FIELDS
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
  * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4589,6 +4810,8 @@ export interface UpdateExtendedFieldsOptions {
  * @permissionId ECOM.DRAFT_ORDER_SET_TAX_EXEMPTION
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -4619,6 +4842,8 @@ export interface SetTaxExemptionOptions {
  * @permissionId ECOM.DRAFT_ORDER_SET_BUSINESS_LOCATION
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions