---
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)