@salesforce/b2c-tooling-sdk 1.16.0 → 1.17.0

package/data/script-api/dw.order.LineItem.md

@@ -26,6 +26,7 @@ Common line item base class.
 | [taxBasis](#taxbasis): [Money](dw.value.Money.md) `(read-only)` | Get the price used to calculate the tax for this line item. |
 | [taxClassID](#taxclassid): [String](TopLevel.String.md) | Returns the tax class ID for the line item or null if no tax class ID is associated with the line item. |
 | [taxRate](#taxrate): [Number](TopLevel.Number.md) | Returns the tax rate, which is the decimal tax rate to be applied to the product represented by this line item. |
+| [taxes](#taxes): [Collection](dw.util.Collection.md) | Returns the tax items for this line item. |
 
 ## Constructor Summary
 
@@ -45,6 +46,7 @@ This class does not have a constructor, so you cannot create it directly.
 | [getTaxBasis](dw.order.LineItem.md#gettaxbasis)() | Get the price used to calculate the tax for this line item. |
 | [getTaxClassID](dw.order.LineItem.md#gettaxclassid)() | Returns the tax class ID for the line item or null if no tax class ID is associated with the line item. |
 | [getTaxRate](dw.order.LineItem.md#gettaxrate)() | Returns the tax rate, which is the decimal tax rate to be applied to the product represented by this line item. |
+| [getTaxes](dw.order.LineItem.md#gettaxes)() | Returns the tax items for this line item. |
 | ~~[setBasePrice](dw.order.LineItem.md#setbasepricemoney)([Money](dw.value.Money.md))~~ | Sets the base price for the line item, which is the price of the unit before applying adjustments, in the  purchase currency. |
 | ~~[setGrossPrice](dw.order.LineItem.md#setgrosspricemoney)([Money](dw.value.Money.md))~~ | Sets the gross price for the line item, which is the Price of the unit before applying adjustments, in the  purchase currency, including tax. |
 | [setLineItemText](dw.order.LineItem.md#setlineitemtextstring)([String](TopLevel.String.md)) | Sets the display text for the line item. |
@@ -53,6 +55,7 @@ This class does not have a constructor, so you cannot create it directly.
 | [setTax](dw.order.LineItem.md#settaxmoney)([Money](dw.value.Money.md)) | Sets the value for the tax of the line item, which is the the tax of the unit before applying adjustments, in the  purchase currency. |
 | [setTaxClassID](dw.order.LineItem.md#settaxclassidstring)([String](TopLevel.String.md)) | Sets the tax class ID for the line item. |
 | [setTaxRate](dw.order.LineItem.md#settaxratenumber)([Number](TopLevel.Number.md)) | Sets the tax rate, which is the decimal tax rate to be applied to the product represented by this line item. |
+| [setTaxes](dw.order.LineItem.md#settaxescollection)([Collection](dw.util.Collection.md)) | Sets the tax items for this line item. |
 | ~~[updatePrice](dw.order.LineItem.md#updatepricemoney)([Money](dw.value.Money.md))~~ | Updates the price attributes of the line item based on the specified price. |
 | [updateTax](dw.order.LineItem.md#updatetaxnumber)([Number](TopLevel.Number.md)) | Updates the tax-related attributes of the line item based on the specified tax rate, a tax basis determined by  the system and the "Tax Rounding Mode" order preference. |
 | [updateTax](dw.order.LineItem.md#updatetaxnumber-money)([Number](TopLevel.Number.md), [Money](dw.value.Money.md)) | Updates the tax-related attributes of the line item based on the specified tax rate, the passed tax basis and the  "Tax Rounding Mode" order preference. |
@@ -161,6 +164,23 @@ This class does not have a constructor, so you cannot create it directly.
 
 
 
+---
+
+### taxes
+- taxes: [Collection](dw.util.Collection.md)
+  - : Returns the tax items for this line item. When taxes are set via [setTaxes(Collection)](dw.order.LineItem.md#settaxescollection), the line item's
+      tax amount and tax rate are updated as the sum and combined rate of all tax items. The tax items are preserved
+      after order creation and can be retrieved on both baskets and orders.
+      
+      
+      Access is currently restricted to select pilot customers and controlled via feature toggle.
+
+
+    **See Also:**
+    - [setTaxes(Collection)](dw.order.LineItem.md#settaxescollection)
+    - [LineItemTax](dw.order.LineItemTax.md)
+
+
 ---
 
 ## Method Details
@@ -292,6 +312,26 @@ This class does not have a constructor, so you cannot create it directly.
     - the value of the tax rate.
 
 
+---
+
+### getTaxes()
+- getTaxes(): [Collection](dw.util.Collection.md)
+  - : Returns the tax items for this line item. When taxes are set via [setTaxes(Collection)](dw.order.LineItem.md#settaxescollection), the line item's
+      tax amount and tax rate are updated as the sum and combined rate of all tax items. The tax items are preserved
+      after order creation and can be retrieved on both baskets and orders.
+      
+      
+      Access is currently restricted to select pilot customers and controlled via feature toggle.
+
+
+    **Returns:**
+    - collection of [LineItemTax](dw.order.LineItemTax.md); empty when no tax items are set
+
+    **See Also:**
+    - [setTaxes(Collection)](dw.order.LineItem.md#settaxescollection)
+    - [LineItemTax](dw.order.LineItemTax.md)
+
+
 ---
 
 ### setBasePrice(Money)
@@ -377,6 +417,9 @@ Use [updatePrice(Money)](dw.order.LineItem.md#updatepricemoney) which sets the b
 - setTax(aValue: [Money](dw.value.Money.md)): void
   - : Sets the value for the tax of the line item, which is the the tax of the unit before applying adjustments, in the
       purchase currency.
+      
+      
+      If tax items are already set (e.g. via [setTaxes(Collection)](dw.order.LineItem.md#settaxescollection)), calling this will clear them.
 
 
     **Parameters:**
@@ -399,12 +442,51 @@ Use [updatePrice(Money)](dw.order.LineItem.md#updatepricemoney) which sets the b
 - setTaxRate(taxRate: [Number](TopLevel.Number.md)): void
   - : Sets the tax rate, which is the decimal tax rate to be applied to the product represented by this line item. A
       value of 0.175 represents a percentage of 17.5%.
+      
+      
+      If tax items are already set (e.g. via [setTaxes(Collection)](dw.order.LineItem.md#settaxescollection)), calling this will clear them.
 
 
     **Parameters:**
     - taxRate - the new value for the tax rate.
 
 
+---
+
+### setTaxes(Collection)
+- setTaxes(taxItems: [Collection](dw.util.Collection.md)): void
+  - : Sets the tax items for this line item. The container must be a basket. Persists the given items, then aggregates
+      them (sum of tax values, combined tax rate) and updates this line item's tax amount and tax rate accordingly.
+      
+      
+      Each element in the collection must be a [LineItemTax](dw.order.LineItemTax.md), for example created via
+      [new LineItemTax(taxId, taxRate, taxValue)](dw.order.LineItemTax.md#lineitemtaxstring-number-money).
+      
+      
+      Use either multilevel tax items via [setTaxes(Collection)](dw.order.LineItem.md#settaxescollection) or
+      [setTax(Money)](dw.order.LineItem.md#settaxmoney)/[setTaxRate(Number)](dw.order.LineItem.md#settaxratenumber)/[updateTax(Number, Money)](dw.order.LineItem.md#updatetaxnumber-money)/[updateTaxAmount(Money)](dw.order.LineItem.md#updatetaxamountmoney),
+      not both.
+      
+      
+      Access is currently restricted to select pilot customers and controlled via feature toggle.
+      
+      
+      
+      
+      The maximum number of tax items allowed per line item is 10.
+
+
+    **Parameters:**
+    - taxItems - the tax items to set; each element must be a [LineItemTax](dw.order.LineItemTax.md). Maximum 10 items allowed.
+
+    **Throws:**
+    - IllegalArgumentException - if the container is not a basket, or if more than 10 tax items are provided
+
+    **See Also:**
+    - [getTaxes()](dw.order.LineItem.md#gettaxes)
+    - [LineItemTax](dw.order.LineItemTax.md)
+
+
 ---
 
 ### updatePrice(Money)
@@ -457,6 +539,9 @@ Use [setPriceValue(Number)](dw.order.LineItem.md#setpricevaluenumber) instead.
   - : Updates the tax-related attributes of the line item based on the specified tax rate, the passed tax basis and the
       "Tax Rounding Mode" order preference. If null is passed as tax rate or tax basis, tax-related attribute fields
       are set to N/A.
+      
+      
+      If tax items are already set (e.g. via [setTaxes(Collection)](dw.order.LineItem.md#settaxescollection)), calling this will clear them.
 
 
     **Parameters:**
@@ -478,6 +563,9 @@ Use [setPriceValue(Number)](dw.order.LineItem.md#setpricevaluenumber) instead.
       
       
       Note that tax rate is not calculated and it is not updated.
+      
+      
+      If tax items are already set (e.g. via [setTaxes(Collection)](dw.order.LineItem.md#settaxescollection)), calling this will clear them.
 
 
     **Parameters:**

package/data/script-api/dw.order.LineItemCtnr.md

@@ -45,9 +45,11 @@ certificates are not considered merchandise as they do not represent a product.
 | [BUSINESS_TYPE_B2B](#business_type_b2b): [Number](TopLevel.Number.md) = 2 | constant for Business Type B2B |
 | [BUSINESS_TYPE_B2C](#business_type_b2c): [Number](TopLevel.Number.md) = 1 | constant for Business Type B2C |
 | [CHANNEL_TYPE_CALLCENTER](#channel_type_callcenter): [Number](TopLevel.Number.md) = 2 | constant for Channel Type CallCenter |
+| [CHANNEL_TYPE_CHATGPT](#channel_type_chatgpt): [Number](TopLevel.Number.md) = 18 | constant for Channel Type ChatGPT |
 | [CHANNEL_TYPE_CUSTOMERSERVICECENTER](#channel_type_customerservicecenter): [Number](TopLevel.Number.md) = 11 | constant for Channel Type Customer Service Center |
 | [CHANNEL_TYPE_DSS](#channel_type_dss): [Number](TopLevel.Number.md) = 4 | constant for Channel Type DSS |
 | [CHANNEL_TYPE_FACEBOOKADS](#channel_type_facebookads): [Number](TopLevel.Number.md) = 8 | constant for Channel Type Facebook Ads |
+| [CHANNEL_TYPE_GEMINI](#channel_type_gemini): [Number](TopLevel.Number.md) = 19 | constant for Channel Type Gemini |
 | [CHANNEL_TYPE_GOOGLE](#channel_type_google): [Number](TopLevel.Number.md) = 13 | constant for Channel Type Google |
 | [CHANNEL_TYPE_INSTAGRAMCOMMERCE](#channel_type_instagramcommerce): [Number](TopLevel.Number.md) = 12 | constant for Channel Type Instagram Commerce |
 | [CHANNEL_TYPE_MARKETPLACE](#channel_type_marketplace): [Number](TopLevel.Number.md) = 3 | constant for Channel Type Marketplace |
@@ -261,6 +263,14 @@ This class does not have a constructor, so you cannot create it directly.
   - : constant for Channel Type CallCenter
 
 
+---
+
+### CHANNEL_TYPE_CHATGPT
+
+- CHANNEL_TYPE_CHATGPT: [Number](TopLevel.Number.md) = 18
+  - : constant for Channel Type ChatGPT
+
+
 ---
 
 ### CHANNEL_TYPE_CUSTOMERSERVICECENTER
@@ -285,6 +295,14 @@ This class does not have a constructor, so you cannot create it directly.
   - : constant for Channel Type Facebook Ads
 
 
+---
+
+### CHANNEL_TYPE_GEMINI
+
+- CHANNEL_TYPE_GEMINI: [Number](TopLevel.Number.md) = 19
+  - : constant for Channel Type Gemini
+
+
 ---
 
 ### CHANNEL_TYPE_GOOGLE
@@ -568,7 +586,8 @@ Use [getGiftCertificateLineItems()](dw.order.LineItemCtnr.md#getgiftcertificatel
       [CHANNEL_TYPE_SUBSCRIPTIONS](dw.order.LineItemCtnr.md#channel_type_subscriptions), [CHANNEL_TYPE_ONLINERESERVATION](dw.order.LineItemCtnr.md#channel_type_onlinereservation),
       [CHANNEL_TYPE_CUSTOMERSERVICECENTER](dw.order.LineItemCtnr.md#channel_type_customerservicecenter), [CHANNEL_TYPE_INSTAGRAMCOMMERCE](dw.order.LineItemCtnr.md#channel_type_instagramcommerce),
       [CHANNEL_TYPE_GOOGLE](dw.order.LineItemCtnr.md#channel_type_google), [CHANNEL_TYPE_YOUTUBE](dw.order.LineItemCtnr.md#channel_type_youtube), [CHANNEL_TYPE_TIKTOK](dw.order.LineItemCtnr.md#channel_type_tiktok),
-      [CHANNEL_TYPE_SNAPCHAT](dw.order.LineItemCtnr.md#channel_type_snapchat), [CHANNEL_TYPE_WHATSAPP](dw.order.LineItemCtnr.md#channel_type_whatsapp)
+      [CHANNEL_TYPE_SNAPCHAT](dw.order.LineItemCtnr.md#channel_type_snapchat), [CHANNEL_TYPE_WHATSAPP](dw.order.LineItemCtnr.md#channel_type_whatsapp), [CHANNEL_TYPE_CHATGPT](dw.order.LineItemCtnr.md#channel_type_chatgpt),
+      [CHANNEL_TYPE_GEMINI](dw.order.LineItemCtnr.md#channel_type_gemini)
 
 
 
@@ -623,10 +642,15 @@ Use [getGiftCertificateLineItems()](dw.order.LineItemCtnr.md#getgiftcertificatel
 
 ### defaultShipment
 - defaultShipment: [Shipment](dw.order.Shipment.md) `(read-only)`
-  - : Returns the default shipment of the line item container. Every basket and order has a default shipment with the
-      id "me". If you call a process that accesses a shipment, and you don't specify the shipment, then the process
-      uses the default shipment. You can't remove a default shipment. Calling [removeShipment(Shipment)](dw.order.LineItemCtnr.md#removeshipmentshipment) on it
-      throws an exception.
+  - : Returns the default shipment of the line item container. Baskets always have a default shipment with ID "me".
+      For orders, this can differ, for example: [OrderMgr.createOrder(Basket)](dw.order.OrderMgr.md#createorderbasket) removes empty
+      shipments, so if the basket's "me" shipment was empty at order creation, the order has no "me" shipment. In
+      that case, the shipment with the lowest ID is returned as the fallback, or `null` if the order has
+      no shipments. See [Shipment.isDefault()](dw.order.Shipment.md#isdefault) for the matching logic.
+      
+      
+      Processes that access a shipment use the default shipment when none is specified. The default shipment can't be
+      removed. Calling [removeShipment(Shipment)](dw.order.LineItemCtnr.md#removeshipmentshipment) on it throws an exception.
 
 
 
@@ -1574,7 +1598,8 @@ Use [getGiftCertificateLineItems()](dw.order.LineItemCtnr.md#getgiftcertificatel
       [CHANNEL_TYPE_SUBSCRIPTIONS](dw.order.LineItemCtnr.md#channel_type_subscriptions), [CHANNEL_TYPE_ONLINERESERVATION](dw.order.LineItemCtnr.md#channel_type_onlinereservation),
       [CHANNEL_TYPE_CUSTOMERSERVICECENTER](dw.order.LineItemCtnr.md#channel_type_customerservicecenter), [CHANNEL_TYPE_INSTAGRAMCOMMERCE](dw.order.LineItemCtnr.md#channel_type_instagramcommerce),
       [CHANNEL_TYPE_GOOGLE](dw.order.LineItemCtnr.md#channel_type_google), [CHANNEL_TYPE_YOUTUBE](dw.order.LineItemCtnr.md#channel_type_youtube), [CHANNEL_TYPE_TIKTOK](dw.order.LineItemCtnr.md#channel_type_tiktok),
-      [CHANNEL_TYPE_SNAPCHAT](dw.order.LineItemCtnr.md#channel_type_snapchat), [CHANNEL_TYPE_WHATSAPP](dw.order.LineItemCtnr.md#channel_type_whatsapp)
+      [CHANNEL_TYPE_SNAPCHAT](dw.order.LineItemCtnr.md#channel_type_snapchat), [CHANNEL_TYPE_WHATSAPP](dw.order.LineItemCtnr.md#channel_type_whatsapp), [CHANNEL_TYPE_CHATGPT](dw.order.LineItemCtnr.md#channel_type_chatgpt),
+      [CHANNEL_TYPE_GEMINI](dw.order.LineItemCtnr.md#channel_type_gemini)
 
 
     **Returns:**
@@ -1663,14 +1688,19 @@ Use [getGiftCertificateLineItems()](dw.order.LineItemCtnr.md#getgiftcertificatel
 
 ### getDefaultShipment()
 - getDefaultShipment(): [Shipment](dw.order.Shipment.md)
-  - : Returns the default shipment of the line item container. Every basket and order has a default shipment with the
-      id "me". If you call a process that accesses a shipment, and you don't specify the shipment, then the process
-      uses the default shipment. You can't remove a default shipment. Calling [removeShipment(Shipment)](dw.order.LineItemCtnr.md#removeshipmentshipment) on it
-      throws an exception.
+  - : Returns the default shipment of the line item container. Baskets always have a default shipment with ID "me".
+      For orders, this can differ, for example: [OrderMgr.createOrder(Basket)](dw.order.OrderMgr.md#createorderbasket) removes empty
+      shipments, so if the basket's "me" shipment was empty at order creation, the order has no "me" shipment. In
+      that case, the shipment with the lowest ID is returned as the fallback, or `null` if the order has
+      no shipments. See [Shipment.isDefault()](dw.order.Shipment.md#isdefault) for the matching logic.
+      
+      
+      Processes that access a shipment use the default shipment when none is specified. The default shipment can't be
+      removed. Calling [removeShipment(Shipment)](dw.order.LineItemCtnr.md#removeshipmentshipment) on it throws an exception.
 
 
     **Returns:**
-    - the default shipment of the container
+    - the default shipment of the container, or `null` if the order has no shipments
 
 
 ---

package/data/script-api/dw.order.LineItemTax.md

@@ -0,0 +1,142 @@
+<!-- prettier-ignore-start -->
+# Class LineItemTax
+
+- [TopLevel.Object](TopLevel.Object.md)
+  - [dw.order.LineItemTax](dw.order.LineItemTax.md)
+
+A tax on a line item: tax identifier, rate, and optional amount. Use with [LineItem.setTaxes(Collection)](dw.order.LineItem.md#settaxescollection)
+and [LineItem.getTaxes()](dw.order.LineItem.md#gettaxes).
+
+
+Create instances via [new LineItemTax(taxId, taxRate)](dw.order.LineItemTax.md#lineitemtaxstring-number) to have the
+server compute the tax value, or via
+[new LineItemTax(taxId, taxRate, taxValue)](dw.order.LineItemTax.md#lineitemtaxstring-number-money) to provide a
+pre-computed tax value.
+
+
+
+
+Access is currently restricted to select pilot customers and controlled via feature toggle.
+
+
+**See Also:**
+- [LineItem.getTaxes()](dw.order.LineItem.md#gettaxes)
+- [LineItem.setTaxes(Collection)](dw.order.LineItem.md#settaxescollection)
+
+
+## Property Summary
+
+| Property | Description |
+| --- | --- |
+| [taxId](#taxid): [String](TopLevel.String.md) `(read-only)` | Gets the tax identifier (e.g. |
+| [taxRate](#taxrate): [Number](TopLevel.Number.md) `(read-only)` | Gets the tax rate as a decimal (e.g. |
+| [taxValue](#taxvalue): [Money](dw.value.Money.md) `(read-only)` | Gets the tax value (amount) in purchase currency, or null if computed from rate and tax basis. |
+
+## Constructor Summary
+
+| Constructor | Description |
+| --- | --- |
+| [LineItemTax](#lineitemtaxstring-number)([String](TopLevel.String.md), [Number](TopLevel.Number.md)) | Creates a tax item for use with [LineItem.setTaxes(Collection)](dw.order.LineItem.md#settaxescollection). |
+| [LineItemTax](#lineitemtaxstring-number-money)([String](TopLevel.String.md), [Number](TopLevel.Number.md), [Money](dw.value.Money.md)) | Creates a tax item for use with [LineItem.setTaxes(Collection)](dw.order.LineItem.md#settaxescollection). |
+
+## Method Summary
+
+| Method | Description |
+| --- | --- |
+| [getTaxId](dw.order.LineItemTax.md#gettaxid)() | Gets the tax identifier (e.g. |
+| [getTaxRate](dw.order.LineItemTax.md#gettaxrate)() | Gets the tax rate as a decimal (e.g. |
+| [getTaxValue](dw.order.LineItemTax.md#gettaxvalue)() | Gets the tax value (amount) in purchase currency, or null if computed from rate and tax basis. |
+
+### Methods inherited from class Object
+
+[assign](TopLevel.Object.md#assignobject-object), [create](TopLevel.Object.md#createobject), [create](TopLevel.Object.md#createobject-object), [defineProperties](TopLevel.Object.md#definepropertiesobject-object), [defineProperty](TopLevel.Object.md#definepropertyobject-object-object), [entries](TopLevel.Object.md#entriesobject), [freeze](TopLevel.Object.md#freezeobject), [fromEntries](TopLevel.Object.md#fromentriesiterable), [getOwnPropertyDescriptor](TopLevel.Object.md#getownpropertydescriptorobject-object), [getOwnPropertyNames](TopLevel.Object.md#getownpropertynamesobject), [getOwnPropertySymbols](TopLevel.Object.md#getownpropertysymbolsobject), [getPrototypeOf](TopLevel.Object.md#getprototypeofobject), [hasOwnProperty](TopLevel.Object.md#hasownpropertystring), [is](TopLevel.Object.md#isobject-object), [isExtensible](TopLevel.Object.md#isextensibleobject), [isFrozen](TopLevel.Object.md#isfrozenobject), [isPrototypeOf](TopLevel.Object.md#isprototypeofobject), [isSealed](TopLevel.Object.md#issealedobject), [keys](TopLevel.Object.md#keysobject), [preventExtensions](TopLevel.Object.md#preventextensionsobject), [propertyIsEnumerable](TopLevel.Object.md#propertyisenumerablestring), [seal](TopLevel.Object.md#sealobject), [setPrototypeOf](TopLevel.Object.md#setprototypeofobject-object), [toLocaleString](TopLevel.Object.md#tolocalestring), [toString](TopLevel.Object.md#tostring), [valueOf](TopLevel.Object.md#valueof), [values](TopLevel.Object.md#valuesobject)
+## Property Details
+
+### taxId
+- taxId: [String](TopLevel.String.md) `(read-only)`
+  - : Gets the tax identifier (e.g. "DE\_7").
+
+
+---
+
+### taxRate
+- taxRate: [Number](TopLevel.Number.md) `(read-only)`
+  - : Gets the tax rate as a decimal (e.g. 0.07 for 7%).
+
+
+---
+
+### taxValue
+- taxValue: [Money](dw.value.Money.md) `(read-only)`
+  - : Gets the tax value (amount) in purchase currency, or null if computed from rate and tax basis.
+
+
+---
+
+## Constructor Details
+
+### LineItemTax(String, Number)
+- LineItemTax(taxId: [String](TopLevel.String.md), taxRate: [Number](TopLevel.Number.md))
+  - : Creates a tax item for use with [LineItem.setTaxes(Collection)](dw.order.LineItem.md#settaxescollection).
+      The tax value will be computed server-side from the tax rate and the line item's tax basis.
+      
+      
+      Access is currently restricted to select pilot customers and controlled via feature toggle.
+
+
+    **Parameters:**
+    - taxId - tax identifier (e.g. "DE\_7"), must not be null or blank
+    - taxRate - tax rate as decimal (e.g. 0.07 for 7%), must not be null
+
+
+---
+
+### LineItemTax(String, Number, Money)
+- LineItemTax(taxId: [String](TopLevel.String.md), taxRate: [Number](TopLevel.Number.md), taxValue: [Money](dw.value.Money.md))
+  - : Creates a tax item for use with [LineItem.setTaxes(Collection)](dw.order.LineItem.md#settaxescollection).
+      
+      
+      Access is currently restricted to select pilot customers and controlled via feature toggle.
+
+
+    **Parameters:**
+    - taxId - tax identifier (e.g. "DE\_7"), must not be null or blank
+    - taxRate - tax rate as decimal (e.g. 0.07 for 7%), must not be null
+    - taxValue - tax amount in purchase currency, or null to compute from rate and tax basis
+
+
+---
+
+## Method Details
+
+### getTaxId()
+- getTaxId(): [String](TopLevel.String.md)
+  - : Gets the tax identifier (e.g. "DE\_7").
+
+    **Returns:**
+    - the tax id
+
+
+---
+
+### getTaxRate()
+- getTaxRate(): [Number](TopLevel.Number.md)
+  - : Gets the tax rate as a decimal (e.g. 0.07 for 7%).
+
+    **Returns:**
+    - the tax rate
+
+
+---
+
+### getTaxValue()
+- getTaxValue(): [Money](dw.value.Money.md)
+  - : Gets the tax value (amount) in purchase currency, or null if computed from rate and tax basis.
+
+    **Returns:**
+    - the tax value as Money, or null
+
+
+---
+
+<!-- prettier-ignore-end -->

package/data/script-api/dw.order.OrderMgr.md

@@ -468,6 +468,14 @@ Please use [failOrder(Order, Boolean)](dw.order.OrderMgr.md#failorderorder-boole
       
       
       
+      This method does not alter shipments. Note that [createOrder(Basket)](dw.order.OrderMgr.md#createorderbasket) removes empty shipments
+      before creating the order, so a reopened basket might be missing shipments that existed before. If the removed
+      shipment was the default ("me"), the fallback default is the shipment with the lowest ID. See
+      [LineItemCtnr.getDefaultShipment()](dw.order.LineItemCtnr.md#getdefaultshipment) and [Shipment.isDefault()](dw.order.Shipment.md#isdefault).
+      
+      
+      
+      
       A basket can only be reopened if no other basket for the customer exists at the moment of the call to
       `failOrder`, since a customer is limited to 1 storefront basket at a time. If, after order creation, a
       call was made to [BasketMgr.getCurrentOrNewBasket()](dw.order.BasketMgr.md#getcurrentornewbasket) or pipelet GetBasket with parameter Create=true, then

package/data/script-api/dw.order.PriceAdjustment.md

@@ -74,7 +74,7 @@ This class does not have a constructor, so you cannot create it directly.
 
 ### Methods inherited from class LineItem
 
-[getBasePrice](dw.order.LineItem.md#getbaseprice), [getGrossPrice](dw.order.LineItem.md#getgrossprice), [getLineItemCtnr](dw.order.LineItem.md#getlineitemctnr), [getLineItemText](dw.order.LineItem.md#getlineitemtext), [getNetPrice](dw.order.LineItem.md#getnetprice), [getPrice](dw.order.LineItem.md#getprice), [getPriceValue](dw.order.LineItem.md#getpricevalue), [getTax](dw.order.LineItem.md#gettax), [getTaxBasis](dw.order.LineItem.md#gettaxbasis), [getTaxClassID](dw.order.LineItem.md#gettaxclassid), [getTaxRate](dw.order.LineItem.md#gettaxrate), [setBasePrice](dw.order.LineItem.md#setbasepricemoney), [setGrossPrice](dw.order.LineItem.md#setgrosspricemoney), [setLineItemText](dw.order.LineItem.md#setlineitemtextstring), [setNetPrice](dw.order.LineItem.md#setnetpricemoney), [setPriceValue](dw.order.LineItem.md#setpricevaluenumber), [setTax](dw.order.LineItem.md#settaxmoney), [setTaxClassID](dw.order.LineItem.md#settaxclassidstring), [setTaxRate](dw.order.LineItem.md#settaxratenumber), [updatePrice](dw.order.LineItem.md#updatepricemoney), [updateTax](dw.order.LineItem.md#updatetaxnumber), [updateTax](dw.order.LineItem.md#updatetaxnumber-money), [updateTaxAmount](dw.order.LineItem.md#updatetaxamountmoney)
+[getBasePrice](dw.order.LineItem.md#getbaseprice), [getGrossPrice](dw.order.LineItem.md#getgrossprice), [getLineItemCtnr](dw.order.LineItem.md#getlineitemctnr), [getLineItemText](dw.order.LineItem.md#getlineitemtext), [getNetPrice](dw.order.LineItem.md#getnetprice), [getPrice](dw.order.LineItem.md#getprice), [getPriceValue](dw.order.LineItem.md#getpricevalue), [getTax](dw.order.LineItem.md#gettax), [getTaxBasis](dw.order.LineItem.md#gettaxbasis), [getTaxClassID](dw.order.LineItem.md#gettaxclassid), [getTaxRate](dw.order.LineItem.md#gettaxrate), [getTaxes](dw.order.LineItem.md#gettaxes), [setBasePrice](dw.order.LineItem.md#setbasepricemoney), [setGrossPrice](dw.order.LineItem.md#setgrosspricemoney), [setLineItemText](dw.order.LineItem.md#setlineitemtextstring), [setNetPrice](dw.order.LineItem.md#setnetpricemoney), [setPriceValue](dw.order.LineItem.md#setpricevaluenumber), [setTax](dw.order.LineItem.md#settaxmoney), [setTaxClassID](dw.order.LineItem.md#settaxclassidstring), [setTaxRate](dw.order.LineItem.md#settaxratenumber), [setTaxes](dw.order.LineItem.md#settaxescollection), [updatePrice](dw.order.LineItem.md#updatepricemoney), [updateTax](dw.order.LineItem.md#updatetaxnumber), [updateTax](dw.order.LineItem.md#updatetaxnumber-money), [updateTaxAmount](dw.order.LineItem.md#updatetaxamountmoney)
 ### Methods inherited from class ExtensibleObject
 
 [describe](dw.object.ExtensibleObject.md#describe), [getCustom](dw.object.ExtensibleObject.md#getcustom)

package/data/script-api/dw.order.ProductLineItem.md

@@ -146,7 +146,7 @@ This class does not have a constructor, so you cannot create it directly.
 
 ### Methods inherited from class LineItem
 
-[getBasePrice](dw.order.LineItem.md#getbaseprice), [getGrossPrice](dw.order.LineItem.md#getgrossprice), [getLineItemCtnr](dw.order.LineItem.md#getlineitemctnr), [getLineItemText](dw.order.LineItem.md#getlineitemtext), [getNetPrice](dw.order.LineItem.md#getnetprice), [getPrice](dw.order.LineItem.md#getprice), [getPriceValue](dw.order.LineItem.md#getpricevalue), [getTax](dw.order.LineItem.md#gettax), [getTaxBasis](dw.order.LineItem.md#gettaxbasis), [getTaxClassID](dw.order.LineItem.md#gettaxclassid), [getTaxRate](dw.order.LineItem.md#gettaxrate), [setBasePrice](dw.order.LineItem.md#setbasepricemoney), [setGrossPrice](dw.order.LineItem.md#setgrosspricemoney), [setLineItemText](dw.order.LineItem.md#setlineitemtextstring), [setNetPrice](dw.order.LineItem.md#setnetpricemoney), [setPriceValue](dw.order.LineItem.md#setpricevaluenumber), [setTax](dw.order.LineItem.md#settaxmoney), [setTaxClassID](dw.order.LineItem.md#settaxclassidstring), [setTaxRate](dw.order.LineItem.md#settaxratenumber), [updatePrice](dw.order.LineItem.md#updatepricemoney), [updateTax](dw.order.LineItem.md#updatetaxnumber), [updateTax](dw.order.LineItem.md#updatetaxnumber-money), [updateTaxAmount](dw.order.LineItem.md#updatetaxamountmoney)
+[getBasePrice](dw.order.LineItem.md#getbaseprice), [getGrossPrice](dw.order.LineItem.md#getgrossprice), [getLineItemCtnr](dw.order.LineItem.md#getlineitemctnr), [getLineItemText](dw.order.LineItem.md#getlineitemtext), [getNetPrice](dw.order.LineItem.md#getnetprice), [getPrice](dw.order.LineItem.md#getprice), [getPriceValue](dw.order.LineItem.md#getpricevalue), [getTax](dw.order.LineItem.md#gettax), [getTaxBasis](dw.order.LineItem.md#gettaxbasis), [getTaxClassID](dw.order.LineItem.md#gettaxclassid), [getTaxRate](dw.order.LineItem.md#gettaxrate), [getTaxes](dw.order.LineItem.md#gettaxes), [setBasePrice](dw.order.LineItem.md#setbasepricemoney), [setGrossPrice](dw.order.LineItem.md#setgrosspricemoney), [setLineItemText](dw.order.LineItem.md#setlineitemtextstring), [setNetPrice](dw.order.LineItem.md#setnetpricemoney), [setPriceValue](dw.order.LineItem.md#setpricevaluenumber), [setTax](dw.order.LineItem.md#settaxmoney), [setTaxClassID](dw.order.LineItem.md#settaxclassidstring), [setTaxRate](dw.order.LineItem.md#settaxratenumber), [setTaxes](dw.order.LineItem.md#settaxescollection), [updatePrice](dw.order.LineItem.md#updatepricemoney), [updateTax](dw.order.LineItem.md#updatetaxnumber), [updateTax](dw.order.LineItem.md#updatetaxnumber-money), [updateTaxAmount](dw.order.LineItem.md#updatetaxamountmoney)
 ### Methods inherited from class ExtensibleObject
 
 [describe](dw.object.ExtensibleObject.md#describe), [getCustom](dw.object.ExtensibleObject.md#getcustom)

package/data/script-api/dw.order.ProductShippingLineItem.md

@@ -54,7 +54,7 @@ This class does not have a constructor, so you cannot create it directly.
 
 ### Methods inherited from class LineItem
 
-[getBasePrice](dw.order.LineItem.md#getbaseprice), [getGrossPrice](dw.order.LineItem.md#getgrossprice), [getLineItemCtnr](dw.order.LineItem.md#getlineitemctnr), [getLineItemText](dw.order.LineItem.md#getlineitemtext), [getNetPrice](dw.order.LineItem.md#getnetprice), [getPrice](dw.order.LineItem.md#getprice), [getPriceValue](dw.order.LineItem.md#getpricevalue), [getTax](dw.order.LineItem.md#gettax), [getTaxBasis](dw.order.LineItem.md#gettaxbasis), [getTaxClassID](dw.order.LineItem.md#gettaxclassid), [getTaxRate](dw.order.LineItem.md#gettaxrate), [setBasePrice](dw.order.LineItem.md#setbasepricemoney), [setGrossPrice](dw.order.LineItem.md#setgrosspricemoney), [setLineItemText](dw.order.LineItem.md#setlineitemtextstring), [setNetPrice](dw.order.LineItem.md#setnetpricemoney), [setPriceValue](dw.order.LineItem.md#setpricevaluenumber), [setTax](dw.order.LineItem.md#settaxmoney), [setTaxClassID](dw.order.LineItem.md#settaxclassidstring), [setTaxRate](dw.order.LineItem.md#settaxratenumber), [updatePrice](dw.order.LineItem.md#updatepricemoney), [updateTax](dw.order.LineItem.md#updatetaxnumber), [updateTax](dw.order.LineItem.md#updatetaxnumber-money), [updateTaxAmount](dw.order.LineItem.md#updatetaxamountmoney)
+[getBasePrice](dw.order.LineItem.md#getbaseprice), [getGrossPrice](dw.order.LineItem.md#getgrossprice), [getLineItemCtnr](dw.order.LineItem.md#getlineitemctnr), [getLineItemText](dw.order.LineItem.md#getlineitemtext), [getNetPrice](dw.order.LineItem.md#getnetprice), [getPrice](dw.order.LineItem.md#getprice), [getPriceValue](dw.order.LineItem.md#getpricevalue), [getTax](dw.order.LineItem.md#gettax), [getTaxBasis](dw.order.LineItem.md#gettaxbasis), [getTaxClassID](dw.order.LineItem.md#gettaxclassid), [getTaxRate](dw.order.LineItem.md#gettaxrate), [getTaxes](dw.order.LineItem.md#gettaxes), [setBasePrice](dw.order.LineItem.md#setbasepricemoney), [setGrossPrice](dw.order.LineItem.md#setgrosspricemoney), [setLineItemText](dw.order.LineItem.md#setlineitemtextstring), [setNetPrice](dw.order.LineItem.md#setnetpricemoney), [setPriceValue](dw.order.LineItem.md#setpricevaluenumber), [setTax](dw.order.LineItem.md#settaxmoney), [setTaxClassID](dw.order.LineItem.md#settaxclassidstring), [setTaxRate](dw.order.LineItem.md#settaxratenumber), [setTaxes](dw.order.LineItem.md#settaxescollection), [updatePrice](dw.order.LineItem.md#updatepricemoney), [updateTax](dw.order.LineItem.md#updatetaxnumber), [updateTax](dw.order.LineItem.md#updatetaxnumber-money), [updateTaxAmount](dw.order.LineItem.md#updatetaxamountmoney)
 ### Methods inherited from class ExtensibleObject
 
 [describe](dw.object.ExtensibleObject.md#describe), [getCustom](dw.object.ExtensibleObject.md#getcustom)

package/data/script-api/dw.order.Shipment.md

@@ -32,7 +32,7 @@ Represents an order shipment.
 | [adjustedShippingTotalPrice](#adjustedshippingtotalprice): [Money](dw.value.Money.md) `(read-only)` | Returns the adjusted shipping total price. |
 | [adjustedShippingTotalTax](#adjustedshippingtotaltax): [Money](dw.value.Money.md) `(read-only)` | Returns the tax of all shipping line items of the shipment , including shipping adjustments. |
 | [allLineItems](#alllineitems): [Collection](dw.util.Collection.md) `(read-only)` | Returns all line items related to the shipment. |
-| [default](#default): [Boolean](TopLevel.Boolean.md) `(read-only)` | Return `true` if this shipment is the default shipment (shipment ID "me"). |
+| [default](#default): [Boolean](TopLevel.Boolean.md) `(read-only)` | Returns true if this is the default shipment. |
 | [gift](#gift): [Boolean](TopLevel.Boolean.md) | Returns true if this line item represents a gift, false otherwise. |
 | [giftCertificateLineItems](#giftcertificatelineitems): [Collection](dw.util.Collection.md) `(read-only)` | Returns all gift certificate line items of the shipment. |
 | [giftMessage](#giftmessage): [String](TopLevel.String.md) | Returns the value set for gift message or null if no value set. |
@@ -108,7 +108,7 @@ This class does not have a constructor, so you cannot create it directly.
 | [getTotalNetPrice](dw.order.Shipment.md#gettotalnetprice)() | Returns the total net price of the shipment in the purchase currency. |
 | [getTotalTax](dw.order.Shipment.md#gettotaltax)() | Returns the total tax for the shipment in the purchase currency. |
 | [getTrackingNumber](dw.order.Shipment.md#gettrackingnumber)() | Returns the tracking number of this shipment. |
-| [isDefault](dw.order.Shipment.md#isdefault)() | Return `true` if this shipment is the default shipment (shipment ID "me"). |
+| [isDefault](dw.order.Shipment.md#isdefault)() | Returns true if this is the default shipment. |
 | [isGift](dw.order.Shipment.md#isgift)() | Returns true if this line item represents a gift, false otherwise. |
 | [removeShippingLineItem](dw.order.Shipment.md#removeshippinglineitemshippinglineitem)([ShippingLineItem](dw.order.ShippingLineItem.md)) | Removes the specified shipping line item and any of its dependent shipping price adjustments. |
 | ~~[removeShippingPriceAdjustment](dw.order.Shipment.md#removeshippingpriceadjustmentpriceadjustment)([PriceAdjustment](dw.order.PriceAdjustment.md))~~ | Removes the specified shipping price adjustment from the shipment. |
@@ -270,7 +270,11 @@ Use [SHIPPING_STATUS_SHIPPED](dw.order.Shipment.md#shipping_status_shipped) inst
 
 ### default
 - default: [Boolean](TopLevel.Boolean.md) `(read-only)`
-  - : Return `true` if this shipment is the default shipment (shipment ID "me").
+  - : Returns true if this is the default shipment. The default is the shipment with ID "me". If no shipment with
+      ID "me" exists, the shipment with the lowest ID is used as the default. A "me" shipment can be absent if
+      [OrderMgr.createOrder(Basket)](dw.order.OrderMgr.md#createorderbasket) removed it for being empty, in which case another
+      shipment becomes the default.
+
 
 
 ---
@@ -1023,7 +1027,11 @@ Shipments cannot have product price adjustments, therefore this method will alwa
 
 ### isDefault()
 - isDefault(): [Boolean](TopLevel.Boolean.md)
-  - : Return `true` if this shipment is the default shipment (shipment ID "me").
+  - : Returns true if this is the default shipment. The default is the shipment with ID "me". If no shipment with
+      ID "me" exists, the shipment with the lowest ID is used as the default. A "me" shipment can be absent if
+      [OrderMgr.createOrder(Basket)](dw.order.OrderMgr.md#createorderbasket) removed it for being empty, in which case another
+      shipment becomes the default.
+
 
     **Returns:**
     - `true` if this shipment is the default shipment

package/data/script-api/dw.order.ShippingLineItem.md

@@ -50,7 +50,7 @@ This class does not have a constructor, so you cannot create it directly.
 
 ### Methods inherited from class LineItem
 
-[getBasePrice](dw.order.LineItem.md#getbaseprice), [getGrossPrice](dw.order.LineItem.md#getgrossprice), [getLineItemCtnr](dw.order.LineItem.md#getlineitemctnr), [getLineItemText](dw.order.LineItem.md#getlineitemtext), [getNetPrice](dw.order.LineItem.md#getnetprice), [getPrice](dw.order.LineItem.md#getprice), [getPriceValue](dw.order.LineItem.md#getpricevalue), [getTax](dw.order.LineItem.md#gettax), [getTaxBasis](dw.order.LineItem.md#gettaxbasis), [getTaxClassID](dw.order.LineItem.md#gettaxclassid), [getTaxRate](dw.order.LineItem.md#gettaxrate), [setBasePrice](dw.order.LineItem.md#setbasepricemoney), [setGrossPrice](dw.order.LineItem.md#setgrosspricemoney), [setLineItemText](dw.order.LineItem.md#setlineitemtextstring), [setNetPrice](dw.order.LineItem.md#setnetpricemoney), [setPriceValue](dw.order.LineItem.md#setpricevaluenumber), [setTax](dw.order.LineItem.md#settaxmoney), [setTaxClassID](dw.order.LineItem.md#settaxclassidstring), [setTaxRate](dw.order.LineItem.md#settaxratenumber), [updatePrice](dw.order.LineItem.md#updatepricemoney), [updateTax](dw.order.LineItem.md#updatetaxnumber), [updateTax](dw.order.LineItem.md#updatetaxnumber-money), [updateTaxAmount](dw.order.LineItem.md#updatetaxamountmoney)
+[getBasePrice](dw.order.LineItem.md#getbaseprice), [getGrossPrice](dw.order.LineItem.md#getgrossprice), [getLineItemCtnr](dw.order.LineItem.md#getlineitemctnr), [getLineItemText](dw.order.LineItem.md#getlineitemtext), [getNetPrice](dw.order.LineItem.md#getnetprice), [getPrice](dw.order.LineItem.md#getprice), [getPriceValue](dw.order.LineItem.md#getpricevalue), [getTax](dw.order.LineItem.md#gettax), [getTaxBasis](dw.order.LineItem.md#gettaxbasis), [getTaxClassID](dw.order.LineItem.md#gettaxclassid), [getTaxRate](dw.order.LineItem.md#gettaxrate), [getTaxes](dw.order.LineItem.md#gettaxes), [setBasePrice](dw.order.LineItem.md#setbasepricemoney), [setGrossPrice](dw.order.LineItem.md#setgrosspricemoney), [setLineItemText](dw.order.LineItem.md#setlineitemtextstring), [setNetPrice](dw.order.LineItem.md#setnetpricemoney), [setPriceValue](dw.order.LineItem.md#setpricevaluenumber), [setTax](dw.order.LineItem.md#settaxmoney), [setTaxClassID](dw.order.LineItem.md#settaxclassidstring), [setTaxRate](dw.order.LineItem.md#settaxratenumber), [setTaxes](dw.order.LineItem.md#settaxescollection), [updatePrice](dw.order.LineItem.md#updatepricemoney), [updateTax](dw.order.LineItem.md#updatetaxnumber), [updateTax](dw.order.LineItem.md#updatetaxnumber-money), [updateTaxAmount](dw.order.LineItem.md#updatetaxamountmoney)
 ### Methods inherited from class ExtensibleObject
 
 [describe](dw.object.ExtensibleObject.md#describe), [getCustom](dw.object.ExtensibleObject.md#getcustom)

package/data/script-api/dw.order.TaxMgr.md

@@ -32,6 +32,7 @@ This class does not have a constructor, so you cannot create it directly.
 | Method | Description |
 | --- | --- |
 | static [applyExternalTax](dw.order.TaxMgr.md#applyexternaltaxbasket)([Basket](dw.order.Basket.md)) | Applies externally set tax rates to the given [Basket](dw.order.Basket.md). |
+| static [applyTax](dw.order.TaxMgr.md#applytaxbasket)([Basket](dw.order.Basket.md)) | Applies tax to the given [Basket](dw.order.Basket.md) using the platform's tax hook dispatch logic. |
 | static [getCustomRateTaxClassID](dw.order.TaxMgr.md#getcustomratetaxclassid)() | Returns the ID of the tax class that represents items with a custom tax rate. |
 | static [getDefaultTaxClassID](dw.order.TaxMgr.md#getdefaulttaxclassid)() | Returns the ID of the default tax class defined for the site. |
 | static [getDefaultTaxJurisdictionID](dw.order.TaxMgr.md#getdefaulttaxjurisdictionid)() | Returns the ID of the default tax jurisdiction defined for the site. |
@@ -154,6 +155,59 @@ This class does not have a constructor, so you cannot create it directly.
     - basket - apply external taxation to this basket
 
 
+---
+
+### applyTax(Basket)
+- static applyTax(basket: [Basket](dw.order.Basket.md)): void
+  - : Applies tax to the given [Basket](dw.order.Basket.md) using the platform's tax hook dispatch logic.
+      
+      
+      This method is intended for use in custom {@code dw.order.calculate} hook implementations (e.g., in SFRA or
+      SiteGenesis) that override the default basket calculation. Calling this method instead of directly invoking
+      {@code dw.order.calculateTax} ensures that Commerce App tax providers registered via
+      {@code sfcc.app.tax.calculate} are invoked when available, with automatic fallback to the legacy
+      {@code dw.order.calculateTax} hook or the platform default tax calculation.
+      
+      
+      
+      
+      **WARNING:** Do NOT call this method from within a {@code dw.order.calculateTax} hook
+      implementation, as this will cause infinite recursion. This method is designed to be called from
+      {@code dw.order.calculate} hooks only.
+      
+      
+      
+      
+      The dispatch precedence is:
+      
+      1. {@code sfcc.app.tax.calculate}— if a Commerce App tax provider is installed and the feature is   enabled.
+      2. {@code dw.order.calculateTax}— if registered by the storefront.
+      3. Platform default tax calculation — using the site's tax tables.
+      
+      
+      
+      
+      
+      **Typical usage in a custom {@code dw.order.calculate} hook:**
+      
+      
+      
+      
+      ```
+      var TaxMgr = require('dw/order/TaxMgr');
+      
+      exports.calculate = function (basket) {
+          // ... product prices, promotions, shipping ...
+          TaxMgr.applyTax(basket);
+          basket.updateTotals();
+      };
+      ```
+
+
+    **Parameters:**
+    - basket - the basket for which tax should be calculated.
+
+
 ---
 
 ### getCustomRateTaxClassID()