--- displayed_sidebar: servicesSidebar --- import ParameterTypes from "@site/src/components/ParameterTypes" # TotalsService A service that calculates total and subtotals for orders, carts etc.. #### Implements ## Constructors ### constructor `**new TotalsService**(«destructured»)` #### Parameters ## Properties `", "description": "", "optional": true, "defaultValue": "", "expandable": false, "children": [] }, { "name": "__container__", "type": "`any`", "description": "", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "__moduleDeclaration__", "type": "`Record`", "description": "", "optional": true, "defaultValue": "", "expandable": false, "children": [] }, { "name": "featureFlagRouter_", "type": "[FlagRouter](FlagRouter.mdx)", "description": "", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "manager_", "type": "EntityManager", "description": "", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "newTotalsService_", "type": "[NewTotalsService](NewTotalsService.mdx)", "description": "", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "taxCalculationStrategy_", "type": "[ITaxCalculationStrategy](../interfaces/ITaxCalculationStrategy.mdx)", "description": "", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "taxProviderService_", "type": "[TaxProviderService](TaxProviderService.mdx)", "description": "", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "transactionManager_", "type": "`undefined` \\| EntityManager", "description": "", "optional": false, "defaultValue": "", "expandable": false, "children": [] } ]} /> ## Accessors ### activeManager\_ `Protected get**activeManager_**(): EntityManager` #### Returns EntityManager ## Methods ### atomicPhase\_ `Protected **atomicPhase_**(work, isolationOrErrorHandler?, maybeErrorHandlerOrDontFail?): Promise<TResult>` Wraps some work within a transactional block. If the service already has a transaction manager attached this will be reused, otherwise a new transaction manager is created. #### Parameters Promise<TResult>", "description": "the transactional work to be done", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "isolationOrErrorHandler", "type": "`IsolationLevel` \\| (`error`: `TError`) => Promise<void \\| TResult>", "description": "the isolation level to be used for the work.", "optional": true, "defaultValue": "", "expandable": false, "children": [] }, { "name": "maybeErrorHandlerOrDontFail", "type": "(`error`: `TError`) => Promise<void \\| TResult>", "description": "Potential error handler", "optional": true, "defaultValue": "", "expandable": false, "children": [] } ]} /> #### Returns Promise<TResult> ___ ### calculateDiscount\_ `**calculateDiscount_**(lineItem, variant, variantPrice, value, discountType): [LineDiscount](../types/LineDiscount.mdx)` Calculates either fixed or percentage discount of a variant #### Parameters #### Returns [LineDiscount](../types/LineDiscount.mdx) #### Deprecated - in favour of DiscountService.calculateDiscountForLineItem ___ ### getAllocationItemDiscounts `**getAllocationItemDiscounts**(discount, cart): [LineDiscount](../types/LineDiscount.mdx)[]` If the rule of a discount has allocation="item", then we need to calculate discount on each item in the cart. Furthermore, we need to make sure to only apply the discount on valid variants. And finally we return ether an array of percentages discounts or fixed discounts alongside the variant on which the discount was applied. #### Parameters #### Returns [LineDiscount](../types/LineDiscount.mdx)[] ___ ### getAllocationMap `**getAllocationMap**(orderOrCart, options?): Promise<[LineAllocationsMap](../types/LineAllocationsMap.mdx)>` Gets a map of discounts and gift cards that apply to line items in an order. The function calculates the amount of a discount or gift card that applies to a specific line item. #### Parameters #### Returns Promise<[LineAllocationsMap](../types/LineAllocationsMap.mdx)> ___ ### getCalculationContext `**getCalculationContext**(calculationContextData, options?): Promise<[TaxCalculationContext](../types/TaxCalculationContext.mdx)>` Prepares the calculation context for a tax total calculation. #### Parameters #### Returns Promise<[TaxCalculationContext](../types/TaxCalculationContext.mdx)> ___ ### getDiscountTotal `**getDiscountTotal**(cartOrOrder): Promise<number>` Calculates the total discount amount for each of the different supported discount types. If discounts aren't present or invalid returns 0. #### Parameters #### Returns Promise<number> ___ ### getGiftCardTotal `**getGiftCardTotal**(cartOrOrder, opts?): Promise<{ tax_total: number ; total: number }>` Gets the gift card amount on a cart or order. #### Parameters #### Returns Promise<{ tax_total: number ; total: number }> ___ ### getGiftCardableAmount `**getGiftCardableAmount**(cartOrOrder): Promise<number>` Gets the amount that can be gift carded on a cart. In regions where gift cards are taxable this amount should exclude taxes. #### Parameters #### Returns Promise<number> ___ ### getLineDiscounts `**getLineDiscounts**(cartOrOrder, discount?): [LineDiscountAmount](../types/LineDiscountAmount.mdx)[]` Returns the discount amount allocated to the line items of an order. #### Parameters #### Returns [LineDiscountAmount](../types/LineDiscountAmount.mdx)[] ___ ### getLineItemAdjustmentsTotal `**getLineItemAdjustmentsTotal**(cartOrOrder): number` #### Parameters #### Returns `number` ___ ### getLineItemDiscountAdjustment `**getLineItemDiscountAdjustment**(lineItem, discount): number` #### Parameters #### Returns `number` ___ ### getLineItemRefund `**getLineItemRefund**(order, lineItem): Promise<number>` The amount that can be refunded for a given line item. #### Parameters #### Returns Promise<number> ___ ### getLineItemTotal `**getLineItemTotal**(lineItem, cartOrOrder, options?): Promise<number>` Gets a total for a line item. The total can take gift cards, discounts and taxes into account. This can be controlled through the options. #### Parameters #### Returns Promise<number> ___ ### getLineItemTotals `**getLineItemTotals**(lineItem, cartOrOrder, options?): Promise<[LineItemTotals](../types/LineItemTotals-1.mdx)>` Breaks down the totals related to a line item; these are the subtotal, the amount of discount applied to the line item, the amount of a gift card applied to a line item and the amount of tax applied to a line item. #### Parameters #### Returns Promise<[LineItemTotals](../types/LineItemTotals-1.mdx)> ___ ### getPaidTotal `**getPaidTotal**(order): number` Gets the total payments made on an order #### Parameters #### Returns `number` ___ ### getRefundTotal `**getRefundTotal**(order, lineItems): Promise<number>` Calculates refund total of line items. If any of the items to return have been discounted, we need to apply the discount again before refunding them. #### Parameters #### Returns Promise<number> ___ ### getRefundedTotal `**getRefundedTotal**(order): number` Gets the total refund amount for an order. #### Parameters #### Returns `number` ___ ### getShippingMethodTotals `**getShippingMethodTotals**(shippingMethod, cartOrOrder, opts?): Promise<[ShippingMethodTotals](../types/ShippingMethodTotals-1.mdx)>` Gets the totals breakdown for a shipping method. Fetches tax lines if not already provided. #### Parameters #### Returns Promise<[ShippingMethodTotals](../types/ShippingMethodTotals-1.mdx)> ___ ### getShippingTotal `**getShippingTotal**(cartOrOrder): Promise<number>` Calculates shipping total #### Parameters #### Returns Promise<number> ___ ### getSubtotal `**getSubtotal**(cartOrOrder, opts?): Promise<number>` Calculates subtotal of a given cart or order. #### Parameters #### Returns Promise<number> ___ ### getSwapTotal `**getSwapTotal**(order): number` The total paid for swaps. May be negative in case of negative swap difference. #### Parameters #### Returns `number` ___ ### getTaxTotal `**getTaxTotal**(cartOrOrder, forceTaxes?): Promise<`null` \| number>` Calculates tax total Currently based on the Danish tax system #### Parameters #### Returns Promise<`null` \| number> ___ ### getTotal `**getTotal**(cartOrOrder, options?): Promise<number>` Calculates total of a given cart or order. #### Parameters #### Returns Promise<number> ___ ### rounded `**rounded**(value): number` Rounds a number using Math.round. #### Parameters #### Returns `number` ___ ### shouldRetryTransaction\_ `Protected **shouldRetryTransaction_**(err): boolean` #### Parameters ` \\| `{ code: string }`", "description": "", "optional": false, "defaultValue": "", "expandable": false, "children": [] } ]} /> #### Returns `boolean` ___ ### withTransaction `**withTransaction**(transactionManager?): [TotalsService](TotalsService.mdx)` #### Parameters #### Returns [TotalsService](TotalsService.mdx)