Skip to main content
Skip to main content

TotalsService

A service that calculates total and subtotals for orders, carts etc..

Implements​

Properties​

__configModule__Record<string, unknown>
__container__anyRequired
__moduleDeclaration__Record<string, unknown>
featureFlagRouter_FlagRouterRequired
manager_EntityManagerRequired
newTotalsService_NewTotalsServiceRequired
taxCalculationStrategy_ITaxCalculationStrategyRequired
taxProviderService_TaxProviderServiceRequired
transactionManager_undefined | EntityManagerRequired

Accessors​

activeManager_​

Returns​

EntityManagerEntityManagerRequired

Methods​

atomicPhase_​

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​

work(transactionManager: EntityManager) => Promise<TResult>Required
the transactional work to be done
isolationOrErrorHandlerIsolationLevel | (error: TError) => Promise<void | TResult>
the isolation level to be used for the work.
maybeErrorHandlerOrDontFail(error: TError) => Promise<void | TResult>
Potential error handler

Returns​

PromisePromise<TResult>Required
the result of the transactional work

calculateDiscount_​

Calculates either fixed or percentage discount of a variant

Parameters​

lineItemLineItemRequired
id of line item
variantstringRequired
id of variant in line item
variantPricenumberRequired
price of the variant based on region
valuenumberRequired
discount value
discountTypeDiscountRuleTypeRequired
the type of discount (fixed or percentage)

Returns​

LineDiscountobjectRequired
Associates a line item and discount allocation.

Deprecated​

  • in favour of DiscountService.calculateDiscountForLineItem

getAllocationItemDiscounts​

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​

discountDiscountRequired
the discount to which we do the calculation
cartCart | OrderRequired
the cart to calculate discounts for

Returns​

LineDiscount[]LineDiscount[]Required
array of triples of lineitem, variant and applied discount

getAllocationMap​

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​

orderOrCartobjectRequired
the order or cart to get an allocation map for
orderOrCart.claimsClaimOrder[]
orderOrCart.discountsDiscount[]
orderOrCart.itemsLineItem[]Required
orderOrCart.swapsSwap[]
optionsAllocationMapOptions
controls what should be included in allocation map

Returns​

PromisePromise<LineAllocationsMap>Required
the allocation map for the line items in the cart or order.

getCalculationContext​

Prepares the calculation context for a tax total calculation.

Parameters​

calculationContextDataCalculationContextDataRequired
the calculationContextData to get the calculation context for
optionsCalculationContextOptions
options to gather context by

Returns​

PromisePromise<TaxCalculationContext>Required
the tax calculation context

getDiscountTotal​

Calculates the total discount amount for each of the different supported discount types. If discounts aren't present or invalid returns 0.

Parameters​

cartOrOrderCart | OrderRequired
the cart or order to calculate discounts for

Returns​

PromisePromise<number>Required
the total discounts amount

getGiftCardTotal​

Gets the gift card amount on a cart or order.

Parameters​

cartOrOrderCart | OrderRequired
the cart or order to get gift card amount for
optsobject
opts.gift_cardablenumber

Returns​

PromisePromise<{ tax_total: number ; total: number }>Required
the gift card amount applied to the cart or order

getGiftCardableAmount​

Gets the amount that can be gift carded on a cart. In regions where gift cards are taxable this amount should exclude taxes.

Parameters​

cartOrOrderCart | OrderRequired
the cart or order to get gift card amount for

Returns​

PromisePromise<number>Required
the gift card amount applied to the cart or order

getLineDiscounts​

Returns the discount amount allocated to the line items of an order.

Parameters​

cartOrOrderobjectRequired
the cart or order to get line discount allocations for
cartOrOrder.claimsClaimOrder[]
cartOrOrder.itemsLineItem[]Required
cartOrOrder.swapsSwap[]
discountDiscount
the discount to use as context for the calculation

Returns​

LineDiscountAmount[]LineDiscountAmount[]Required
the allocations that the discount has on the items in the cart or order

getLineItemAdjustmentsTotal​

Parameters​

cartOrOrderCart | OrderRequired

Returns​

numbernumber

getLineItemDiscountAdjustment​

Parameters​

lineItemLineItemRequired
Line Items are created when a product is added to a Cart. When Line Items are purchased they will get copied to the resulting order, swap, or claim, and can eventually be referenced in Fulfillments and Returns. Line items may also be used for order edits.
discountDiscountRequired
A discount can be applied to a cart for promotional purposes.

Returns​

numbernumber

getLineItemRefund​

The amount that can be refunded for a given line item.

Parameters​

orderOrderRequired
order to use as context for the calculation
lineItemLineItemRequired
the line item to calculate the refund amount for.

Returns​

PromisePromise<number>Required
the line item refund amount.

getLineItemTotal​

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​

lineItemLineItemRequired
the line item to calculate a total for
cartOrOrderCart | OrderRequired
the cart or order to use as context for the calculation
optionsGetLineItemTotalOptions
the options to use for the calculation

Returns​

PromisePromise<number>Required
the line item total

getLineItemTotals​

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​

lineItemLineItemRequired
the line item to calculate totals for
cartOrOrderCart | OrderRequired
the cart or order to use as context for the calculation
optionsLineItemTotalsOptions
the options to evaluate the line item totals for

Returns​

PromisePromise<LineItemTotals>Required
the breakdown of the line item totals

getPaidTotal​

Gets the total payments made on an order

Parameters​

orderOrderRequired
the order to calculate paid amount for

Returns​

numbernumber
the total paid amount

getRefundTotal​

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​

orderOrderRequired
cart or order to calculate subtotal for
lineItemsLineItem[]Required
the line items to calculate refund total for

Returns​

PromisePromise<number>Required
the calculated subtotal

getRefundedTotal​

Gets the total refund amount for an order.

Parameters​

orderOrderRequired
the order to get total refund amount for.

Returns​

numbernumber
the total refunded amount for an order.

getShippingMethodTotals​

Gets the totals breakdown for a shipping method. Fetches tax lines if not already provided.

Parameters​

shippingMethodShippingMethodRequired
the shipping method to get totals breakdown for.
cartOrOrderCart | OrderRequired
the cart or order to use as context for the breakdown
optsGetShippingMethodTotalsOptions
options for what should be included

Returns​

PromisePromise<ShippingMethodTotals>Required
An object that breaks down the totals for the shipping method

getShippingTotal​

Calculates shipping total

Parameters​

cartOrOrderCart | OrderRequired
cart or order to calculate subtotal for

Returns​

PromisePromise<number>Required
shipping total

getSubtotal​

Calculates subtotal of a given cart or order.

Parameters​

cartOrOrderCart | OrderRequired
cart or order to calculate subtotal for
optsSubtotalOptions
options

Returns​

PromisePromise<number>Required
the calculated subtotal

getSwapTotal​

The total paid for swaps. May be negative in case of negative swap difference.

Parameters​

orderOrderRequired
the order to calculate swap total for

Returns​

numbernumber
the swap total

getTaxTotal​

Calculates tax total Currently based on the Danish tax system

Parameters​

cartOrOrderCart | OrderRequired
cart or order to calculate tax total for
forceTaxesboolean
whether taxes should be calculated regardless of region settings

Returns​

PromisePromise<null | number>Required
tax total

getTotal​

Calculates total of a given cart or order.

Parameters​

cartOrOrderCart | OrderRequired
object to calculate total for
optionsGetTotalsOptions
options to calculate by

Returns​

PromisePromise<number>Required
the calculated subtotal

rounded​

Rounds a number using Math.round.

Parameters​

valuenumberRequired
the value to round

Returns​

numbernumber
the rounded value

shouldRetryTransaction_​

Parameters​

errRecord<string, unknown> | { code: string }Required

Returns​

booleanboolean

withTransaction​

Parameters​

transactionManagerEntityManager

Returns​

TotalsServiceTotalsServiceRequired
Was this section helpful?
© 2023 Medusa, Inc. All rights reserved.