@gofynd/fdk-client-javascript 3.18.0 → 3.20.0

package/sdk/platform/Cart/CartPlatformModel.js

@@ -1020,6 +1020,8 @@ const Joi = require("joi");
  * @property {string} [earn_title] - Title to show how many earn points are
  *   gained for this order.
  * @property {string} [title] - Unique title for loyalty program applicable.
+ * @property {number} [discount_amount] - Engage discount amount applied on the
+ *   cart as payment mode
  */
 
 /**
@@ -1036,12 +1038,13 @@ const Joi = require("joi");
  * @property {number} [cod_charge] - Cod charge value applied to cart. This is
  *   applied when user select payment mode as COD
  * @property {number} [total] - Total payable amount by the customer
- * @property {number} [discount] - Discount amount recieved on cart
+ * @property {number} [discount] - Discount amount received on cart
  * @property {number} [delivery_charge] - Delivery charge applied to cart
  * @property {number} [you_saved] - Total amount will be saved if customer
  *   places the order
  * @property {number} [subtotal] - Selling price amount of all products in cart
  * @property {number} [convenience_fee] - Convenience fee amount applied to cart
+ * @property {number} [store_credit] - Store credit redeemed on the cart
  */
 
 /**
@@ -1207,7 +1210,7 @@ const Joi = require("joi");
  * @property {string[]} [product_group_tags] - List fot the unique identifier
  *   for the product grouping.
  * @property {boolean} [force_new_line_item] - Flag to indicate the item as a
- *   seperate article in cart
+ *   separate article in cart
  * @property {Object} [identifier] - Unique identifier of the article
  * @property {number} [mto_quantity] - Quantity of the product which will
  *   specially manufactured as not available in stock
@@ -1777,7 +1780,7 @@ const Joi = require("joi");
  * @property {Object} [_custom_json] - Field to add custom json at article level
  *   while add items to cart
  * @property {boolean} [force_new_line_item] - Field used to decide the product
- *   add as a seperate product in cart
+ *   add as a separate product in cart
  * @property {Object} [meta] - Field to add meta data at article level
  * @property {boolean} [pos] - Filed to determine whether user is making request
  *   from pos or not
@@ -1830,7 +1833,7 @@ const Joi = require("joi");
  * @property {Object} [extra_meta] - Field to update extra meta of the product in cart
  * @property {Object} [_custom_json] - Field to update custom json of the product in cart
  * @property {boolean} [force_new_line_item] - Field used to decide the product
- *   add as a seperate product in cart
+ *   add as a separate product in cart
  * @property {number} [item_id] - Item id of the product that needs to be updated
  * @property {number} [item_index] - Item index determines on which index the
  *   product falls to be updated
@@ -2503,12 +2506,16 @@ const Joi = require("joi");
  *   checkout API payload
  */
 
+/**
+ * @typedef CartCheckoutDetailsData
+ * @property {string} [order_id] - Order id generated after placing order
+ */
+
 /**
  * @typedef CartCheckoutDetails
- * @property {string} [app_intercept_url] - App intercept url which is used to
+ * @property {string} [app_intercept_url] - App intercept URL which is used to
  *   redirect on app after payment in confirmed/failed
- * @property {Object} [data] - Data of the user cart checkout includes cart
- *   data, address, user id, order type etc
+ * @property {CartCheckoutDetailsData} [data]
  * @property {CheckCart} [cart]
  * @property {boolean} [success] - Success flag of cart checkout API response
  * @property {string} [callback_url] - Callback url to be redirected after
@@ -2612,7 +2619,7 @@ const Joi = require("joi");
 
 /**
  * @typedef PaymentMethod
- * @property {string} mode - Payment mode of payment method used to make payment
+ * @property {string} mode - Payment mode used for this payment method
  * @property {string} [payment] - Payment name of payment method used to make payment
  * @property {PaymentMeta} payment_meta
  * @property {number} [amount] - Amount of the payment mode to be paid
@@ -2623,8 +2630,8 @@ const Joi = require("joi");
 
 /**
  * @typedef PlatformCartCheckoutDetailV2Creation
- * @property {string} [address_id] - Address id of the user on which the order
- *   to be delivered
+ * @property {string} [address_id] - Identifier for the address where the order
+ *   will be delivered
  * @property {string} [payment_identifier] - Payment identifier of the payment
  *   mode selected to do the payment
  * @property {Object} [payment_params] - Payment params which includes payment
@@ -2633,22 +2640,23 @@ const Joi = require("joi");
  *   added in order
  * @property {boolean} [payment_auto_confirm] - Payment auto confirm flag if
  *   payment need not to be collected from user
- * @property {string} id - Cart id of the user cart
- * @property {boolean} [pos] - Filed to determine whether user is making request
- *   from pos or not
- * @property {string} [billing_address_id] - Billing address id of the customer
- *   on which the invoice to be generated after the order is placed
+ * @property {string} id - Cart identifier of the user cart
+ * @property {boolean} [pos] - Field indicating whether the user is making the
+ *   request from a POS
+ * @property {string} [billing_address_id] - Identifier for the customer's
+ *   billing address where the invoice will be generated after order placement
  * @property {string} [merchant_code] - Merchant code of the payment mode
  *   selected to do the payment
  * @property {string} [aggregator] - Aggregator name of the payment gateway
  * @property {number} [pick_at_store_uid] - Store id where we have to pick product
- * @property {string} [device_id] - Device id
- * @property {Object} [delivery_address] - Delivery address data which includes
- *   customer address, customer phone, customer email, customer pincode,
- *   customer landmark and customer name
+ * @property {string} [device_id] - Unique identifier for the device used during checkout
+ * @property {Object} [delivery_address] - Complete delivery address object
+ *   containing customer address details, phone number, email address, pincode,
+ *   landmark, and full name.
  * @property {string} [payment_mode] - Payment mode from which the payment to be
  *   done for the order
- * @property {string} [checkout_mode] - Mode of checkout used in cart
+ * @property {string} [checkout_mode] - Checkout mode for the cart, such as
+ *   guest and logged-in checkout
  * @property {CustomerDetails} [customer_details]
  * @property {Object} [meta] - Meta data to be added in order
  * @property {PaymentMethod[]} payment_methods - Payment methods list used to
@@ -2659,24 +2667,26 @@ const Joi = require("joi");
  * @property {Object} [billing_address] - Billing address json which includes
  *   customer address, customer phone, customer email, customer pincode,
  *   customer landmark and customer name
- * @property {string} [callback_url] - Callback url after payment received/failed
- * @property {string} [user_id] - The user id of user cart
+ * @property {string} [callback_url] - Callback URL to redirect the user after
+ *   payment is received or has failed
+ * @property {string} [user_id] - Unique identifier of the user associated with the cart
  * @property {Object} [extra_meta] - Extra meta to be added while checkout in order
- * @property {string} order_type - Order type of the order being placed like
- *   pickAtStore or HomeDelivery
+ * @property {string} order_type - Order type of the order being placed
  * @property {Files[]} [files] - List of file url
  * @property {number} [ordering_store] - Ordering store id of the store from
  *   which the order is getting placed
- * @property {string} [iin] - Issuer Identification Number number of card if
- *   payment mode is card to do the payment
- * @property {string} [network] - Network of card if payment mode is card to do
- *   the payment
- * @property {string} [type] - Type of cart if payment mode is card to do the payment
- * @property {string} [card_id] - Saved card id if payment mode is card to do the payment
- * @property {string} [success_callback_url] - Success callback url to be
- *   redirected after payment received
- * @property {string} [failure_callback_url] - Failure callback url to be
- *   redirected after payment failed
+ * @property {string} [iin] - Issuer Identification Number (IIN) of the card to
+ *   be used for payment. This field is applicable when the payment mode is set to card.
+ * @property {string} [network] - Card network to use for payment, relevant when
+ *   the selected payment mode is a card
+ * @property {string} [type] - Specifies the cart type, particularly when the
+ *   payment mode is a card
+ * @property {string} [card_id] - Identifier for the saved card to be used for
+ *   payment. This field is applicable when card payment mode has been selected.
+ * @property {string} [success_callback_url] - URL to which the user will be
+ *   redirected after successful payment completion
+ * @property {string} [failure_callback_url] - URL to which the user will be
+ *   redirected if the payment fails
  * @property {OrderTag[]} [order_tags] - Order tags used to identify specific
  *   type of order which is tagged using order tags
  */
@@ -4109,6 +4119,7 @@ class CartPlatformModel {
       earn_points_amount: Joi.number(),
       earn_title: Joi.string().allow(""),
       title: Joi.string().allow(""),
+      discount_amount: Joi.number(),
     });
   }
 
@@ -4130,6 +4141,7 @@ class CartPlatformModel {
       you_saved: Joi.number(),
       subtotal: Joi.number(),
       convenience_fee: Joi.number(),
+      store_credit: Joi.number(),
     });
   }
 
@@ -5630,11 +5642,18 @@ class CartPlatformModel {
     });
   }
 
+  /** @returns {CartCheckoutDetailsData} */
+  static CartCheckoutDetailsData() {
+    return Joi.object({
+      order_id: Joi.string().allow(""),
+    });
+  }
+
   /** @returns {CartCheckoutDetails} */
   static CartCheckoutDetails() {
     return Joi.object({
       app_intercept_url: Joi.string().allow(""),
-      data: Joi.object().pattern(/\S/, Joi.any()),
+      data: CartPlatformModel.CartCheckoutDetailsData(),
       cart: CartPlatformModel.CheckCart(),
       success: Joi.boolean(),
       callback_url: Joi.string().allow(""),

package/sdk/platform/Catalog/CatalogPlatformApplicationClient.d.ts

@@ -1076,7 +1076,7 @@ declare class Catalog {
      * @returns {Promise<CatalogPlatformModel.SuccessResponseObject>} - Success response
      * @name updateAppCategory
      * @summary: Update sales channel category
-     * @description: Modify category data related to the sales channel . - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/updateAppCategory/).
+     * @description: Modify category data related to the sales channel. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/updateAppCategory/).
      */
     updateAppCategory({ categoryUid, body, requestHeaders }?: CatalogPlatformApplicationValidator.UpdateAppCategoryParam, { responseHeaders }?: object): Promise<CatalogPlatformModel.SuccessResponseObject>;
     /**

package/sdk/platform/Catalog/CatalogPlatformApplicationClient.js

@@ -6045,7 +6045,7 @@ class Catalog {
    * @returns {Promise<CatalogPlatformModel.SuccessResponseObject>} - Success response
    * @name updateAppCategory
    * @summary: Update sales channel category
-   * @description: Modify category data related to the sales channel . - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/updateAppCategory/).
+   * @description: Modify category data related to the sales channel. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/updateAppCategory/).
    */
   async updateAppCategory(
     { categoryUid, body, requestHeaders } = { requestHeaders: {} },

package/sdk/platform/Catalog/CatalogPlatformClient.d.ts

@@ -69,7 +69,7 @@ declare class Catalog {
      * @returns {Promise<CatalogPlatformModel.HSCodeItem>} - Success response
      * @name createHsCode
      * @summary: Create HS/SAC code
-     * @description: Create HS/SAC code. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/createHsCode/).
+     * @description: Create a new Harmonized System (HS) or Service Accounting Code (SAC). These codes are used for product and service identification in taxation and compliance processes. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/createHsCode/).
      */
     createHsCode({ body, requestHeaders }?: CatalogPlatformValidator.CreateHsCodeParam, { responseHeaders }?: object): Promise<CatalogPlatformModel.HSCodeItem>;
     /**
@@ -165,7 +165,7 @@ declare class Catalog {
      * @returns {Promise<CatalogPlatformModel.CreateTax>} - Success response
      * @name createTax
      * @summary: Create Tax Rule
-     * @description: Create a tax rule and its version for under a specific company. This also creates a live version of the rule. The API now supports region-specific versions using optional region_type and areas along with the default country-level rule definition. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/createTax/).
+     * @description: Create a tax rule in a company, including its initial (live) version.  The API supports both default (country-level) and region-specific versions by using optional  parameters such as 'region_type' and 'areas'. This enables granular taxation rules scoped to  different geographic regions. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/createTax/).
      */
     createTax({ body, requestHeaders }?: CatalogPlatformValidator.CreateTaxParam, { responseHeaders }?: object): Promise<CatalogPlatformModel.CreateTax>;
     /**
@@ -252,7 +252,8 @@ declare class Catalog {
      * @returns {Promise<Object>} - Success response
      * @name deleteTaxRule
      * @summary: Delete a tax rule
-     * @description: Deletes a tax rule along with all its versions using the provided rule_id. You can not delete a rule if 1. it is the default tax rule 2. it is applied to any product. You will need to set any other tax rule as default or will need to attach a different tax rule to the products, then only you can delete the rule.
+     * @description: Deletes a tax rule and all its associated versions. Note: A rule cannot be deleted if it is set as the default or is currently assigned to any product.
+     * To proceed with deletion, ensure you first assign another rule as the default and unlink this rule from all products.
      *  - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/deleteTaxRule/).
      */
     deleteTaxRule({ ruleId, requestHeaders }?: CatalogPlatformValidator.DeleteTaxRuleParam, { responseHeaders }?: object): Promise<any>;
@@ -263,7 +264,7 @@ declare class Catalog {
      * @returns {Promise<Object>} - Success response
      * @name deleteTaxVersion
      * @summary: Delete a tax version
-     * @description: Deletes a tax rule using the provided rule_id. On future/scheduled version can be deleted. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/deleteTaxVersion/).
+     * @description: Deletes a tax rule using the provided rule_id. Only future/scheduled version can be deleted. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/deleteTaxVersion/).
      */
     deleteTaxVersion({ ruleId, versionId, requestHeaders }?: CatalogPlatformValidator.DeleteTaxVersionParam, { responseHeaders }?: object): Promise<any>;
     /**
@@ -329,7 +330,7 @@ declare class Catalog {
      * @returns {Promise<CatalogPlatformModel.TaxRules>} - Success response
      * @name getAllTaxRules
      * @summary: Get all tax rules of a company
-     * @description: Returns array of all tax rules of a company - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/getAllTaxRules/).
+     * @description: Retrieves a list of all tax rules defined for a company, along with their details. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/getAllTaxRules/).
      */
     getAllTaxRules({ q, statuses, page, limit, versionStatus, requestHeaders }?: CatalogPlatformValidator.GetAllTaxRulesParam, { responseHeaders }?: object): Promise<CatalogPlatformModel.TaxRules>;
     /**
@@ -402,8 +403,8 @@ declare class Catalog {
      * @returns {Promise<CatalogPlatformModel.HSCodes>} - Success response
      * @name getHsCodes
      * @summary: Get HS/SAC codes
-     * @description: Retrieve a list of HS (Harmonized System) or SAC (Service Accounting Code) codes for a company.
-     * HS codes are used for classifying goods in international trade, while SAC codes are used for classifying services for taxation purposes.
+     * @description: Retrieve a list of Harmonized System (HS)) or Service Accounting Code (SAC)) codes for a company.
+     * HS codes are used to classify goods in international trade, while SAC codes classify services for taxation purposes.
      * Supports optional filtering and pagination.
      *  - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/getHsCodes/).
      */
@@ -834,7 +835,7 @@ declare class Catalog {
      * @returns {Promise<CatalogPlatformModel.GetTaxComponents>} - Success response
      * @name getTaxComponentNames
      * @summary: Get component names
-     * @description: Get component names for a company. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/getTaxComponentNames/).
+     * @description: Retrieve the list of all tax component names for a company. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/getTaxComponentNames/).
      */
     getTaxComponentNames({ requestHeaders }?: any, { responseHeaders }?: object): Promise<CatalogPlatformModel.GetTaxComponents>;
     /**
@@ -844,7 +845,7 @@ declare class Catalog {
      * @returns {Promise<CatalogPlatformModel.TaxRuleVersion>} - Success response
      * @name getTaxVersionDetails
      * @summary: Get tax versions for a tax rule
-     * @description: Retrieve versions of a tax rule with support for filtering by status and text search on region names via the `q` parameter. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/getTaxVersionDetails/).
+     * @description: Retrieve the versions of a tax rule. You can filter results by version status. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/getTaxVersionDetails/).
      */
     getTaxVersionDetails({ ruleId, versionStatus, q, limit, page, requestHeaders }?: CatalogPlatformValidator.GetTaxVersionDetailsParam, { responseHeaders }?: object): Promise<CatalogPlatformModel.TaxRuleVersion>;
     /**
@@ -1109,7 +1110,7 @@ declare class Catalog {
      * @returns {Promise<CatalogPlatformModel.TaxRule>} - Success response
      * @name updateTaxRule
      * @summary: Update Tax Rule
-     * @description: Update an existing tax rule under a specific company. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/updateTaxRule/).
+     * @description: Update the details of an existing tax rule for a company. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/updateTaxRule/).
      */
     updateTaxRule({ ruleId, body, requestHeaders }?: CatalogPlatformValidator.UpdateTaxRuleParam, { responseHeaders }?: object): Promise<CatalogPlatformModel.TaxRule>;
     /**
@@ -1119,7 +1120,12 @@ declare class Catalog {
      * @returns {Promise<CatalogPlatformModel.TaxVersion>} - Success response
      * @name updateTaxVersion
      * @summary: Update a tax version
-     * @description: Updates a tax version using the provided rule_id. Scheduled versions support editing of components, applicable dates, and regional overrides while live versions allow limited updates. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/updateTaxVersion/).
+     * @description: When updating a tax version, the rules differ depending on whether it is a live version (that is, its applicable_date is now or in the past) or a scheduled version (with an applicable_date in the future).
+     * For live versions, only the component names may be modified and only when the corresponding _id also matches, while changes to fields such as applicable_date, scope, store_ids, areas, region_type, and any other properties are not allowed.
+     * In contrast, for scheduled (future) versions, you may change the applicable_date using an ISO datetime representing the date and time the version takes effect (at the start of the local day); to avoid changing it, simply pass the current applicable_date value.
+     * Components can be added, updated, or removed: new components may omit _id, and omitting a known _id from the request will remove that component. The scope (COUNTRY by default, or STORE or REGION) can be set; for STORE scope, store_ids are required—if not specified, the existing store_ids are used.
+     * For REGION scope, areas are required and region_type can be provided or will default to the current setting. In all cases, component names are validated, and only one version per rule may exist for each local day.
+     *  - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/updateTaxVersion/).
      */
     updateTaxVersion({ ruleId, versionId, body, requestHeaders }?: CatalogPlatformValidator.UpdateTaxVersionParam, { responseHeaders }?: object): Promise<CatalogPlatformModel.TaxVersion>;
     /**

package/sdk/platform/Catalog/CatalogPlatformClient.js

@@ -64,7 +64,7 @@ class Catalog {
     const response = await PlatformAPIClient.execute(
       this.config,
       "post",
-      `/service/platform/catalog/v2.0/company/${this.config.companyId}/products/${itemId}/sizes/${size}`,
+      `/service/platform/catalog/v1.0/company/${this.config.companyId}/products/${itemId}/sizes/${size}`,
       query_params,
       body,
       { ...xHeaders, ...requestHeaders },
@@ -501,7 +501,7 @@ class Catalog {
    * @returns {Promise<CatalogPlatformModel.HSCodeItem>} - Success response
    * @name createHsCode
    * @summary: Create HS/SAC code
-   * @description: Create HS/SAC code. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/createHsCode/).
+   * @description: Create a new Harmonized System (HS) or Service Accounting Code (SAC). These codes are used for product and service identification in taxation and compliance processes. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/createHsCode/).
    */
   async createHsCode(
     { body, requestHeaders } = { requestHeaders: {} },
@@ -1230,7 +1230,7 @@ class Catalog {
    * @returns {Promise<CatalogPlatformModel.CreateTax>} - Success response
    * @name createTax
    * @summary: Create Tax Rule
-   * @description: Create a tax rule and its version for under a specific company. This also creates a live version of the rule. The API now supports region-specific versions using optional region_type and areas along with the default country-level rule definition. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/createTax/).
+   * @description: Create a tax rule in a company, including its initial (live) version.  The API supports both default (country-level) and region-specific versions by using optional  parameters such as 'region_type' and 'areas'. This enables granular taxation rules scoped to  different geographic regions. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/createTax/).
    */
   async createTax(
     { body, requestHeaders } = { requestHeaders: {} },
@@ -1879,7 +1879,8 @@ class Catalog {
    * @returns {Promise<Object>} - Success response
    * @name deleteTaxRule
    * @summary: Delete a tax rule
-   * @description: Deletes a tax rule along with all its versions using the provided rule_id. You can not delete a rule if 1. it is the default tax rule 2. it is applied to any product. You will need to set any other tax rule as default or will need to attach a different tax rule to the products, then only you can delete the rule.
+   * @description: Deletes a tax rule and all its associated versions. Note: A rule cannot be deleted if it is set as the default or is currently assigned to any product.
+   * To proceed with deletion, ensure you first assign another rule as the default and unlink this rule from all products.
    *  - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/deleteTaxRule/).
    */
   async deleteTaxRule(
@@ -1953,7 +1954,7 @@ class Catalog {
    * @returns {Promise<Object>} - Success response
    * @name deleteTaxVersion
    * @summary: Delete a tax version
-   * @description: Deletes a tax rule using the provided rule_id. On future/scheduled version can be deleted. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/deleteTaxVersion/).
+   * @description: Deletes a tax rule using the provided rule_id. Only future/scheduled version can be deleted. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/deleteTaxVersion/).
    */
   async deleteTaxVersion(
     { ruleId, versionId, requestHeaders } = { requestHeaders: {} },
@@ -2446,7 +2447,7 @@ class Catalog {
    * @returns {Promise<CatalogPlatformModel.TaxRules>} - Success response
    * @name getAllTaxRules
    * @summary: Get all tax rules of a company
-   * @description: Returns array of all tax rules of a company - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/getAllTaxRules/).
+   * @description: Retrieves a list of all tax rules defined for a company, along with their details. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/getAllTaxRules/).
    */
   async getAllTaxRules(
     { q, statuses, page, limit, versionStatus, requestHeaders } = {
@@ -3024,8 +3025,8 @@ class Catalog {
    * @returns {Promise<CatalogPlatformModel.HSCodes>} - Success response
    * @name getHsCodes
    * @summary: Get HS/SAC codes
-   * @description: Retrieve a list of HS (Harmonized System) or SAC (Service Accounting Code) codes for a company.
-   * HS codes are used for classifying goods in international trade, while SAC codes are used for classifying services for taxation purposes.
+   * @description: Retrieve a list of Harmonized System (HS)) or Service Accounting Code (SAC)) codes for a company.
+   * HS codes are used to classify goods in international trade, while SAC codes classify services for taxation purposes.
    * Supports optional filtering and pagination.
    *  - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/getHsCodes/).
    */
@@ -5483,7 +5484,7 @@ class Catalog {
    * @returns {Promise<CatalogPlatformModel.GetTaxComponents>} - Success response
    * @name getTaxComponentNames
    * @summary: Get component names
-   * @description: Get component names for a company. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/getTaxComponentNames/).
+   * @description: Retrieve the list of all tax component names for a company. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/getTaxComponentNames/).
    */
   async getTaxComponentNames(
     { requestHeaders } = { requestHeaders: {} },
@@ -5558,7 +5559,7 @@ class Catalog {
    * @returns {Promise<CatalogPlatformModel.TaxRuleVersion>} - Success response
    * @name getTaxVersionDetails
    * @summary: Get tax versions for a tax rule
-   * @description: Retrieve versions of a tax rule with support for filtering by status and text search on region names via the `q` parameter. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/getTaxVersionDetails/).
+   * @description: Retrieve the versions of a tax rule. You can filter results by version status. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/getTaxVersionDetails/).
    */
   async getTaxVersionDetails(
     { ruleId, versionStatus, q, limit, page, requestHeaders } = {
@@ -7260,7 +7261,7 @@ class Catalog {
    * @returns {Promise<CatalogPlatformModel.TaxRule>} - Success response
    * @name updateTaxRule
    * @summary: Update Tax Rule
-   * @description: Update an existing tax rule under a specific company. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/updateTaxRule/).
+   * @description: Update the details of an existing tax rule for a company. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/updateTaxRule/).
    */
   async updateTaxRule(
     { ruleId, body, requestHeaders } = { requestHeaders: {} },
@@ -7341,7 +7342,12 @@ class Catalog {
    * @returns {Promise<CatalogPlatformModel.TaxVersion>} - Success response
    * @name updateTaxVersion
    * @summary: Update a tax version
-   * @description: Updates a tax version using the provided rule_id. Scheduled versions support editing of components, applicable dates, and regional overrides while live versions allow limited updates. - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/updateTaxVersion/).
+   * @description: When updating a tax version, the rules differ depending on whether it is a live version (that is, its applicable_date is now or in the past) or a scheduled version (with an applicable_date in the future).
+   * For live versions, only the component names may be modified and only when the corresponding _id also matches, while changes to fields such as applicable_date, scope, store_ids, areas, region_type, and any other properties are not allowed.
+   * In contrast, for scheduled (future) versions, you may change the applicable_date using an ISO datetime representing the date and time the version takes effect (at the start of the local day); to avoid changing it, simply pass the current applicable_date value.
+   * Components can be added, updated, or removed: new components may omit _id, and omitting a known _id from the request will remove that component. The scope (COUNTRY by default, or STORE or REGION) can be set; for STORE scope, store_ids are required—if not specified, the existing store_ids are used.
+   * For REGION scope, areas are required and region_type can be provided or will default to the current setting. In all cases, component names are validated, and only one version per rule may exist for each local day.
+   *  - Check out [method documentation](https://docs.fynd.com/partners/commerce/sdk/platform/catalog/updateTaxVersion/).
    */
   async updateTaxVersion(
     { ruleId, versionId, body, requestHeaders } = { requestHeaders: {} },