Script: Class dw.order.LineItem
Class LineItem
- Object
- dw.object.PersistentObject
- dw.object.ExtensibleObject
- dw.order.LineItem
- dw.object.ExtensibleObject
- dw.object.PersistentObject
Common line item base class.
All Known Subclasses
GiftCertificateLineItem, PriceAdjustment, ProductLineItem, ProductShippingLineItem, ShippingLineItem
Properties
basePrice : Money
The base price for the line item, which is the price of the unit before applying adjustments, in the purchase currency. The base price may be net or gross of tax depending on the configured taxation policy.
grossPrice : Money
The gross price for the line item, which is the price of the unit before applying adjustments, in the purchase currency, including tax.
lineItemCtnr : LineItemCtnr Read Only
The line item ctnr of the line item.
lineItemText : String
The display text for the line item.
netPrice : Money
The net price for the line item, which is the price of the unit before applying adjustments, in the purchase currency, excluding tax.
price : Money Read Only
Get the price of the line item. If the line item is based on net pricing then the net price is returned. If the line item is based on gross pricing then the gross price is returned.
priceValue : Number
Return the price amount for the line item. Same as getPrice().getValue().
tax : Money
The tax for the line item, which is the tax of the unit before applying adjustments, in the purchase currency.
taxBasis : Money Read Only
Get the price used to calculate the tax for this line item.
taxClassID : String
The tax class ID for the line item or null if no tax class ID is associated with the line item. In the case where the tax class ID is null, you should use the default tax class ID.
taxRate : Number
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%.
Constructor Summary
This class does not have a constructor, so you cannot create it directly. To get an instance of this class, use one of the subclass constructors.
Method Summary
getBasePrice() : Money
Returns the base price for the line item, which is the price of the unit before applying adjustments, in the purchase currency.
getGrossPrice() : Money
Returns the gross price for the line item, which is the price of the unit before applying adjustments, in the purchase currency, including tax.
getLineItemCtnr() : LineItemCtnr
Returns the line item ctnr of the line item.
Returns the display text for the line item.
getNetPrice() : Money
Returns the net price for the line item, which is the price of the unit before applying adjustments, in the purchase currency, excluding tax.
Get the price of the line item.
getPriceValue() : Number
Return the price amount for the line item.
Returns the tax for the line item, which is the tax of the unit before applying adjustments, in the purchase currency.
getTaxBasis() : Money
Get the price used to calculate the tax for this line item.
getTaxClassID() : String
Returns the tax class ID for the line item or null if no tax class ID is associated with the line item.
getTaxRate() : Number
Returns the tax rate, which is the decimal tax rate to be applied to the product represented by this line item.
setBasePrice(aValue : Money) : void
Sets the base price for the line item, which is the price of the unit before applying adjustments, in the purchase currency.
setGrossPrice(aValue : Money) : void
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(aText : String) : void
Sets the display text for the line item.
setNetPrice(aValue : Money) : void
Sets the value for the net price, which is the price of the unit before applying adjustments, in the purchase currency, excluding tax.
setPriceValue(value : Number) : void
Sets price attributes of the line item based on the current purchase currency and taxation policy.
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(aValue : String) : void
Sets the tax class ID for the line item.
setTaxRate(taxRate : Number) : void
Sets the tax rate, which is the decimal tax rate to be applied to the product represented by this line item.
updatePrice(price : Money) : void
Updates the price attributes of the line item based on the specified price.
updateTax(taxRate : Number) : void
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(taxRate : Number, taxBasis : Money) : void
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.
updateTaxAmount(tax : Money) : void
Updates tax amount of the line item setting the provided value.
Methods inherited from class ExtensibleObject
Methods inherited from class PersistentObject
getCreationDate, getLastModified, getUUID
Methods inherited from class Object
assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values
Method Detail
getBasePrice
getBasePrice() : Money
Returns the base price for the line item, which is the price of the unit before applying adjustments, in the purchase currency. The base price may be net or gross of tax depending on the configured taxation policy.
Returns:
the base price for the line item.
getGrossPrice
getGrossPrice() : Money
Returns the gross price for the line item, which is the price of the unit before applying adjustments, in the purchase currency, including tax.
Returns:
the value of the gross price.
getLineItemCtnr
getLineItemCtnr() : LineItemCtnr
Returns the line item ctnr of the line item.
Returns:
Line item ctnr of the line item
getLineItemText
getLineItemText() : String
Returns the display text for the line item.
Returns:
the display text.
getNetPrice
getNetPrice() : Money
Returns the net price for the line item, which is the price of the unit before applying adjustments, in the purchase currency, excluding tax.
Returns:
the value for the net price.
getPrice
getPrice() : Money
Get the price of the line item. If the line item is based on net pricing then the net price is returned. If the line item is based on gross pricing then the gross price is returned.
Returns:
either the net or the gross price
getPriceValue
getPriceValue() : Number
Return the price amount for the line item. Same as getPrice().getValue().
Returns:
the price for the line item
getTax
getTax() : Money
Returns the tax for the line item, which is the tax of the unit before applying adjustments, in the purchase currency.
Returns:
the tax for the line item.
getTaxBasis
getTaxBasis() : Money
Get the price used to calculate the tax for this line item.
Returns:
The tax basis used to calculate tax for this line item, or Money.NOT_AVAILABLE if tax has not been set for this line item yet.
getTaxClassID
getTaxClassID() : String
Returns the tax class ID for the line item or null if no tax class ID is associated with the line item. In the case where the tax class ID is null, you should use the default tax class ID.
Returns:
the tax class ID for the line item or null if no tax class ID is associated with the line item.
See Also:
getTaxRate
getTaxRate() : Number
Returns 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%.
Returns:
the value of the tax rate.
setBasePrice
setBasePrice(aValue : Money) : void
Sets the base price for the line item, which is the price of the unit before applying adjustments, in the purchase currency. The base price may be net or gross of tax depending on the configured taxation policy.
Deprecated:
Use updatePrice(Money) instead.
Parameters:
aValue - the new value of the base price.
setGrossPrice
setGrossPrice(aValue : Money) : void
Sets the gross price for the line item, which is the Price of the unit before applying adjustments, in the purchase currency, including tax.
Deprecated:
Use updatePrice(Money) which sets the base price and also the gross price if the line item is based on gross pricing.
Parameters:
aValue - the new value of the attribute
setLineItemText
setLineItemText(aText : String) : void
Sets the display text for the line item.
Parameters:
aText - line item text.
setNetPrice
setNetPrice(aValue : Money) : void
Sets the value for the net price, which is the price of the unit before applying adjustments, in the purchase currency, excluding tax.
Deprecated:
Use updatePrice(Money) which sets the base price and also the net price if the line item is based on net pricing.
Parameters:
aValue - the new value for the net price
setPriceValue
setPriceValue(value : Number) : void
Sets price attributes of the line item based on the current purchase currency and taxation policy.
The methods sets the 'basePrice' attribute of the line item. Additionally, it sets the 'netPrice' attribute of the line item if the current taxation policy is 'net', and the 'grossPrice' attribute, if the current taxation policy is 'gross'.
If null is specified as value, the price attributes are reset to Money.NOT_AVAILABLE.
Parameters:
value - Price value or null
setTax
setTax(aValue : Money) : 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.
Parameters:
aValue - the new value for the tax.
setTaxClassID
setTaxClassID(aValue : String) : void
Sets the tax class ID for the line item.
Parameters:
aValue - the tax class ID for the line item.
setTaxRate
setTaxRate(taxRate : Number) : 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%.
Parameters:
taxRate - the new value for the tax rate.
updatePrice
updatePrice(price : Money) : void
Updates the price attributes of the line item based on the specified price. The base price is set to the specified value. If the line item is based on net pricing then the net price attribute is set. If the line item is based on gross pricing then the gross price attribute is set. Whether or not a line item is based on net or gross pricing is a site-wide configuration parameter.
Deprecated:
Use setPriceValue(Number) instead.
Parameters:
price - The price to use when performing the update. This price must not be null and must either be equal to NOT_AVAIALBLE or must have a currency code equal to that of the parent container.
updateTax
updateTax(taxRate : Number) : void
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. This method sets the tax basis as an attribute, and is not affected by the previous value of this attribute.
The value used as a basis depends on the type of line item this is and on the promotion preferences for the current site. If you tax products, shipping, and discounts based on price (default), then the tax basis will simply be equal to getPrice(). If you tax products and shipping only based on adjusted price, then the tax basis depends upon line item type as follows:
- ProductLineItem: basis equals ProductLineItem.getProratedPrice().
- ShippingLineItem: basis equals ShippingLineItem.getAdjustedPrice().
- ProductShippingLineItem: basis equals ProductShippingLineItem.getAdjustedPrice().
- PriceAdjustment: basis equals 0.00.
- All other line item types: basis equals getPrice().
If null is passed as tax rate, tax-related attribute fields are set to N/A.
Parameters:
taxRate - taxRate the tax rate to use or null.
updateTax
updateTax(taxRate : Number, taxBasis : Money) : void
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.
Parameters:
taxRate - the tax rate to use or null.
taxBasis - the tax basis to use or null.
updateTaxAmount
updateTaxAmount(tax : Money) : void
Updates tax amount of the line item setting the provided value. Depending on the way how the tax is calculated (based on net or gross price), the corresponding gross or net price is updated accordingly. For tax calculation based on net price, the gross price is calculated by adding the tax to the net price. For tax calculation based on gross price, the net price is calculated by subtracting the tax from the gross price.
If null is passed as tax amount, the item tax and resulting net or gross price are set to N/A.
Note that tax rate is not calculated and it is not updated.
Parameters:
tax - the tax amount of the line item to set