@wix/auto_sdk_ecom_draft-orders 1.0.23 → 1.0.25

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

@@ -139,9 +139,13 @@ var DiscountReason;
 })(DiscountReason || (exports.DiscountReason = DiscountReason = {}));
 var EditingStatus;
 (function (EditingStatus) {
-    /** Draft order can be modified and committed. */
+    /** Draft order is being edited. */
     EditingStatus["DRAFT"] = "DRAFT";
-    /** Draft order is already committed. No further modifications allowed. */
+    /**
+     * Draft order has been committed - No further modifications allowed.
+     *
+     * Draft orders with status 'COMMITTED' cannot be deleted.
+     */
     EditingStatus["COMMITTED"] = "COMMITTED";
 })(EditingStatus || (exports.EditingStatus = EditingStatus = {}));
 var WeightUnit;
@@ -156,9 +160,9 @@ var WeightUnit;
 var PickupMethod;
 (function (PickupMethod) {
     PickupMethod["UNKNOWN_METHOD"] = "UNKNOWN_METHOD";
-    /** Pickup is from the merchant's brick and mortar store. */
+    /** Store pickup. */
     PickupMethod["STORE_PICKUP"] = "STORE_PICKUP";
-    /** Item is shipped to a specified pickup point. */
+    /** Pickup point. */
     PickupMethod["PICKUP_POINT"] = "PICKUP_POINT";
 })(PickupMethod || (exports.PickupMethod = PickupMethod = {}));
 var RuleType;
@@ -197,11 +201,11 @@ var FileType;
 var DiscountType;
 (function (DiscountType) {
     DiscountType["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
-    /** Discount applies to entire order. */
+    /** Discount applies to the entire order. */
     DiscountType["GLOBAL"] = "GLOBAL";
-    /** Discount applies to specific items. */
+    /** Discount applies to a specific item. */
     DiscountType["SPECIFIC_ITEMS"] = "SPECIFIC_ITEMS";
-    /** Discount applies to shipping. For example, free shipping. */
+    /** Discount applies to shipping fee. */
     DiscountType["SHIPPING"] = "SHIPPING";
 })(DiscountType || (exports.DiscountType = DiscountType = {}));
 var NonDraftableReason;
@@ -407,11 +411,11 @@ var WebhookIdentityType;
     WebhookIdentityType["APP"] = "APP";
 })(WebhookIdentityType || (exports.WebhookIdentityType = WebhookIdentityType = {}));
 /**
- * Creates or gets a draft order.
+ * Creates or retrieves a draft order based on the specified order ID.
  *
- * When passing the ID of an order that is already in draft, the existing draft order will be returned.
- * To complete a draft and update the order, call Commit Draft Order([REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/draft-orders/commit-draft-order) | [SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/commit-draft-order)).
- * @param orderId - Existing order ID to create draft from.
+ * When passing the ID of an order that is already in draft, the existing draft order is returned.
+ * To complete a draft and update the original order, call Commit Draft Order.
+ * @param orderId - ID of the order to create a draft for.
  * @public
  * @documentationMaturity preview
  * @requiredField orderId
@@ -420,6 +424,8 @@ var WebhookIdentityType;
  * @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
@@ -493,6 +499,8 @@ async function createDraftOrder(orderId) {
 exports.createDraftOrder = createDraftOrder;
 /**
  * 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
@@ -500,6 +508,8 @@ exports.createDraftOrder = createDraftOrder;
  * @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
@@ -572,7 +582,7 @@ async function createEmptyDraftOrder() {
 }
 exports.createEmptyDraftOrder = createEmptyDraftOrder;
 /**
- * Adds line items to a draft order.
+ * Adds catalog or custom line items to a draft order.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -581,6 +591,8 @@ exports.createEmptyDraftOrder = createEmptyDraftOrder;
  * @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
@@ -672,11 +684,11 @@ exports.addLineItemsToDraftOrder = addLineItemsToDraftOrder;
 /**
  * Updates a draft order's line items.
  *
- * Using this API, you can update a line item's quantity, price, and description.
+ * You can update a line item's quantity, price, and description.
  * > **Notes:**
- * > + Passing a quantity of `0` will remove the line item.
+ * > + Specifying a quantity of `0` will remove the line item.
  * > + Price cannot be updated for line items with `paymentOption: MEMBERSHIP`.
- * > + Quantity cannot be decreased fulfilled line items. To get fulfillment information, pass the order ID to [List Fulfillments For Single Order](https://dev.wix.com/docs/rest/api-reference/wix-e-commerce/order-fulfillments/list-fulfillments-for-single-order).
+ * > + Quantity cannot be decreased for fulfilled line items. To retrieve fulfillment information, specify the order ID when calling List Fulfillments For Single Order ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/order-fulfillments/list-fulfillments-for-single-order) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/order-fulfillments/list-fulfillments-for-single-order)).
  * @param draftOrderId - Draft order ID.
  * @param lineItemChanges - Details of changes to apply per line item.
  * @public
@@ -687,6 +699,8 @@ exports.addLineItemsToDraftOrder = addLineItemsToDraftOrder;
  * @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
@@ -767,11 +781,12 @@ exports.updateLineItems = updateLineItems;
 /**
  * Applies or unapplies discounts on a draft order.
  *
- * Unapplied discounts are still part of draft order, but do not affect balance.
- * Existing discounts, not mentioned in request, will keep their current state.
+ * Unapplied discounts are still part of the draft order, but do not affect balance.
+ * Existing discounts that are not passed in the request will keep their current state.
  * @param draftOrderId - Draft order ID.
- * @param discounts - Discount IDs to apply/unapply.
- * Existing discounts, not mentioned in request, will keep their current state.
+ * @param discounts - Discounts to set on the draft order.
+ *
+ * Any existing discounts that are not passed will not change.
  * @public
  * @documentationMaturity preview
  * @requiredField discounts
@@ -781,6 +796,8 @@ exports.updateLineItems = updateLineItems;
  * @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
@@ -856,10 +873,10 @@ async function setDiscounts(draftOrderId, discounts) {
 }
 exports.setDiscounts = setDiscounts;
 /**
- * Create custom discounts on a draft order.
+ * Creates custom discounts.
  *
- * Newly added discounts are unapplied by default.
- * To apply them, use Set Discounts ([REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/draft-orders/set-discounts) | [SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/set-discounts)).
+ * Newly created discounts are unapplied by default.
+ * To apply them, use Set Discounts.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -870,6 +887,8 @@ exports.setDiscounts = setDiscounts;
  * @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
@@ -948,9 +967,9 @@ async function createCustomDiscounts(draftOrderId, options) {
 }
 exports.createCustomDiscounts = createCustomDiscounts;
 /**
- * Remove custom discounts from the order.
+ * Removes custom discounts from a draft order.
  * @param draftOrderId - Draft order ID.
- * @param discountIds - Ids of discounts to remove.
+ * @param discountIds - IDs of the discounts to remove from the draft order.
  * @public
  * @documentationMaturity preview
  * @requiredField discountIds
@@ -958,6 +977,8 @@ exports.createCustomDiscounts = createCustomDiscounts;
  * @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
@@ -1035,11 +1056,12 @@ exports.deleteCustomDiscounts = deleteCustomDiscounts;
 /**
  * Applies or unapplies additional fees on a draft order.
  *
- * Unapplied fees are still part of draft order, but do not affect balance.
- * Existing additional fees, not mentioned in request, will keep their current state.
+ * Additional fees that are not applied are still part of the draft order, but do not affect balance.
+ * Existing additional fees that are not passed in the request will keep their current state.
  * @param draftOrderId - Draft order ID.
- * @param additionalFees - Additional fee IDs to apply/unapply.
- * Existing additional fees, not mentioned in this list, will keep their current state.
+ * @param additionalFees - Additional fees to set on the draft order.
+ *
+ * Any existing additional fees that are not passed will not change.
  * @public
  * @documentationMaturity preview
  * @requiredField additionalFees
@@ -1049,6 +1071,8 @@ exports.deleteCustomDiscounts = deleteCustomDiscounts;
  * @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
@@ -1129,8 +1153,8 @@ exports.setAdditionalFees = setAdditionalFees;
 /**
  * Creates custom additional fees on a draft order.
  *
- * Newly added additional fees are unapplied by default.
- * To apply them, use Set Additional Fees ([REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/draft-orders/set-additional-fees) | [SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/draft-orders/set-additional-fees)).
+ * Newly created additional fees are not applied by default.
+ * To apply them, use Set Additional Fees.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -1141,6 +1165,8 @@ exports.setAdditionalFees = setAdditionalFees;
  * @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
@@ -1219,9 +1245,9 @@ async function createCustomAdditionalFees(draftOrderId, options) {
 }
 exports.createCustomAdditionalFees = createCustomAdditionalFees;
 /**
- * Remove custom additional fees from the order.
+ * Removes custom additional fees from a draft order.
  * @param draftOrderId - Draft order ID.
- * @param customAdditionalFees - Ids of additional fees to remove.
+ * @param customAdditionalFees - IDs of the additional fees to remove from the draft order.
  * @public
  * @documentationMaturity preview
  * @requiredField customAdditionalFees
@@ -1229,6 +1255,8 @@ exports.createCustomAdditionalFees = createCustomAdditionalFees;
  * @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
@@ -1315,6 +1343,8 @@ exports.deleteCustomAdditionalFees = deleteCustomAdditionalFees;
  * @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
@@ -1409,6 +1439,8 @@ exports.setShippingInfo = setShippingInfo;
  * @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
@@ -1495,6 +1527,8 @@ exports.setBuyerInfo = setBuyerInfo;
  * @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
@@ -1586,6 +1620,8 @@ exports.setRecipientInfo = setRecipientInfo;
  * @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
@@ -1669,12 +1705,14 @@ async function setBillingInfo(draftOrderId, options) {
 }
 exports.setBillingInfo = setBillingInfo;
 /**
- * Gets a draft order.
+ * Retrieves a draft order.
  *
- * Draft order is recalculated and contains latest tax and totals (unless already committed).
- * Automatic discounts and automatic additional fees will reflect the latest prices and eligibility.
- * Calculation will be based on current draft order content - items, shipping info and eligible discounts and additional fees.
- * When retrieving an already committed draft, it's not recalculated and contains data calculated during commit.
+ * The retrieved draft order contains the latest calculations:
+ * + Line items, shipping details, and buyer information.
+ * + Tax details and price totals.
+ * + Automatic discounts and automatic additional fees, along with updated eligibility.
+ *
+ * > **Note:** When retrieving a committed draft order, it **is not recalculated**.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -1683,6 +1721,8 @@ exports.setBillingInfo = setBillingInfo;
  * @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
@@ -1757,14 +1797,16 @@ async function getDraftOrder(draftOrderId) {
 }
 exports.getDraftOrder = getDraftOrder;
 /**
- * Checks whether a draft can be created for this order.
- * @param orderId - Order Id.
+ * Checks whether a draft can be created for an order.
+ * @param orderId - Order ID.
  * @public
  * @documentationMaturity preview
  * @requiredField orderId
  * @permissionId ECOM.DRAFT_ORDERS_READ
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -1795,10 +1837,13 @@ async function getOrderDraftabilityStatus(orderId) {
 }
 exports.getOrderDraftabilityStatus = getOrderDraftabilityStatus;
 /**
- * Commit latest changes to the baseline order and control which side-effects are executed.
+ * Finalizes a draft order and applies its modifications to the associated order.
+ * You can also control which side-effects are executed on commit.
  *
- * Commit cannot be undone or reverted.
- * Committed draft will become closed for further modifications, however it's kept for reference and can be retrieved.
+ * > **Notes:**
+ * > + The draft order's status is set to `COMMITTED`.
+ * > + Commiting a draft order cannot be undone or reverted.
+ * > + A committed draft order does not allow for further modifications. However, it is kept for reference and can be retrieved.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -1807,6 +1852,8 @@ exports.getOrderDraftabilityStatus = getOrderDraftabilityStatus;
  * @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
@@ -1887,10 +1934,12 @@ async function commitDraftOrder(draftOrderId, options) {
 }
 exports.commitDraftOrder = commitDraftOrder;
 /**
- * Creates a new order while specifying which side-effects are executed.
+ * Creates a new order from a draft, while specifying which side-effects are executed.
  *
- * Commit cannot be undone or reverted.
- * Committed draft will become closed for further modifications, however it's kept for reference and can be retrieved.
+ * > **Notes:**
+ * > + The draft order's status is set to `COMMITTED`.
+ * > + Commiting a draft order cannot be undone or reverted.
+ * > + A committed draft order does not allow for further modifications. However, it is kept for reference and can be retrieved.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -1899,6 +1948,8 @@ exports.commitDraftOrder = commitDraftOrder;
  * @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
@@ -1983,7 +2034,7 @@ exports.createOrderFromDraft = createOrderFromDraft;
 /**
  * Deletes a draft order along with all its pending changes.
  *
- * Draft orders in status 'COMMITTED' cannot be deleted.
+ * Draft orders with status 'COMMITTED' cannot be deleted.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -1992,6 +2043,8 @@ exports.createOrderFromDraft = createOrderFromDraft;
  * @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
@@ -2032,11 +2085,14 @@ exports.deleteDraftOrder = deleteDraftOrder;
  * | `_updatedDate` | `eq()`, `ne()`, `exists()`, `in()`, `hasSome()`, `lt()`, `le()`, `gt()`, `ge()` | Sortable     |
  * | `status`       | `eq()`, `ne()`, `exists()`, `in()`, `hasSome()`                                 | Sortable     |
  * | `orderId`      | `eq()`, `ne()`, `exists()`, `in()`, `hasSome()`, `startsWith()`                 |              |
+ *
  * To learn how to query draft orders, see [API Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language).
  * @public
  * @documentationMaturity preview
  * @permissionScope Manage Stores - all permissions
  * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
  * @permissionScope Manage Restaurants - all permissions
  * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Manage eCommerce - all permissions
@@ -2134,12 +2190,16 @@ exports.queryDraftOrders = queryDraftOrders;
  * @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
@@ -2211,7 +2271,9 @@ async function updateExtendedFields(_id, namespace, options) {
 }
 exports.updateExtendedFields = updateExtendedFields;
 /**
- * Sets tax exemption on a draft order.
+ * Sets whether a draft order is tax-exempt.
+ *
+ * A tax exempted draft order ignores taxes during calculation. Tax information will return empty.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -2221,6 +2283,8 @@ exports.updateExtendedFields = updateExtendedFields;
  * @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
@@ -2300,6 +2364,8 @@ async function setTaxExemption(draftOrderId, options) {
 exports.setTaxExemption = setTaxExemption;
 /**
  * Sets business location on a draft order.
+ *
+ * When committed, the order will become associated to a specific business location. This affects who can see and manage this order, and how it is calculated in reports.
  * @param draftOrderId - Draft order ID.
  * @public
  * @documentationMaturity preview
@@ -2308,6 +2374,8 @@ exports.setTaxExemption = setTaxExemption;
  * @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