Skip to main content
Skip to main content

TaxProviderService

Finds tax providers and assists in tax related operations.

constructor​

Parameters​

containerAwilixContainer<any>Required

Properties​

__container__anyRequired
cacheService_ICacheServiceRequired
container_AwilixContainer<any>Required
eventBus_IEventBusServiceRequired
manager_EntityManagerRequired
smTaxLineRepo_Repository<ShippingMethodTaxLine> & objectRequired
taxLineRepo_Repository<LineItemTaxLine> & objectRequired
taxProviderRepo_Repository<TaxProvider>Required
taxRateService_TaxRateServiceRequired
transactionManager_undefined | EntityManagerRequired
__configModule__Record<string, unknown>
__moduleDeclaration__Record<string, unknown>

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.

Type Parameters​

TResultobjectRequired
TErrorobjectRequired

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

clearLineItemsTaxLines​

Parameters​

itemIdsstring[]Required

Returns​

PromisePromise<void>Required

clearTaxLines​

Parameters​

cartIdstringRequired

Returns​

PromisePromise<void>Required

createShippingTaxLines​

Persists the tax lines relevant for a shipping method to the database. Used for return shipping methods.

Parameters​

shippingMethodShippingMethodRequired
the shipping method to create tax lines for
calculationContextTaxCalculationContextRequired
the calculation context to get tax lines by

Returns​

PromisePromise<(LineItemTaxLine | ShippingMethodTaxLine)[]>Required
the newly created tax lines

createTaxLines​

Persists the tax lines relevant for an order to the database.

Parameters​

cartOrLineItemsLineItem[] | CartRequired
the cart or line items to create tax lines for
calculationContextTaxCalculationContextRequired
the calculation context to get tax lines by

Returns​

PromisePromise<(LineItemTaxLine | ShippingMethodTaxLine)[]>Required
the newly created tax lines

getCacheKey​

The cache key to get cache hits by.

Parameters​

idstringRequired
the entity id to cache
regionIdstringRequired
the region id to cache

Returns​

stringstringRequired
the cache key to use for the id set

getRegionRatesForProduct​

Gets the tax rates configured for a product. The rates are cached between calls.

Parameters​

productIdsstring | string[]Required
regionRegionDetailsRequired
the region to get configured rates for.

Returns​

PromisePromise<Map<string, TaxServiceRate[]>>Required
the tax rates configured for the shipping option. A map by product id

getRegionRatesForShipping​

Gets the tax rates configured for a shipping option. The rates are cached between calls.

Parameters​

optionIdstringRequired
the option id of the shipping method.
regionDetailsRegionDetailsRequired
the region to get configured rates for.

Returns​

PromisePromise<TaxServiceRate[]>Required
the tax rates configured for the shipping option.

getShippingTaxLines​

Gets the relevant tax lines for a shipping method. Note: this method doesn't persist the tax lines. Use createShippingTaxLines if you wish to persist the tax lines to the DB layer.

Parameters​

shippingMethodShippingMethodRequired
the shipping method to get tax lines for
calculationContextTaxCalculationContextRequired
the calculation context to get tax lines by

Returns​

PromisePromise<ShippingMethodTaxLine[]>Required
the computed tax lines

getTaxLines​

Gets the relevant tax lines for an order or cart. If an order is provided the order's tax lines will be returned. If a cart is provided the tax lines will be computed from the tax rules and potentially a 3rd party tax plugin. Note: this method doesn't persist the tax lines. Use createTaxLines if you wish to persist the tax lines to the DB layer.

Parameters​

lineItemsLineItem[]Required
the cart or order to get tax lines for
calculationContextTaxCalculationContextRequired
the calculation context to get tax lines by

Returns​

PromisePromise<(LineItemTaxLine | ShippingMethodTaxLine)[]>Required
the computed tax lines

getTaxLinesMap​

Return a map of tax lines for line items and shipping methods

Parameters​

itemsLineItem[]Required
calculationContextTaxCalculationContextRequired

Returns​

PromisePromise<TaxLinesMaps>Required
Return a map of tax lines for line items and shipping methods

list​

Returns​

PromisePromise<TaxProvider[]>Required

registerInstalledProviders​

Parameters​

providersstring[]Required

Returns​

PromisePromise<void>Required

retrieveProvider​

Retrieves the relevant tax provider for the given region.

Parameters​

regionRegionRequired
the region to get tax provider for.

Returns​

ITaxServiceobjectRequired
Overview A tax provider is used to retrieve the tax lines in a cart. The Medusa backend provides a default system provider. You can create your own tax provider, either in a plugin or directly in your Medusa backend, then use it in any region. A tax provider class is defined in a TypeScript or JavaScript file under the src/services directory and the class must extend the AbstractTaxService class imported from @medusajs/medusa. The file's name is the tax provider's class name as a slug and without the word Service. For example, you can create the file src/services/my-tax.ts with the following content: 
1import {2  AbstractTaxService,3  ItemTaxCalculationLine,4  ShippingTaxCalculationLine,5  TaxCalculationContext,6} from "@medusajs/medusa"7import {8  ProviderTaxLine,9} from "@medusajs/medusa/dist/types/tax-service"10
11class MyTaxService extends AbstractTaxService {12  async getTaxLines(13    itemLines: ItemTaxCalculationLine[],14    shippingLines: ShippingTaxCalculationLine[],15    context: TaxCalculationContext):16    Promise<ProviderTaxLine[]> {17    throw new Error("Method not implemented.")18  }19}20
21export default MyTaxService
Identifier Property The TaxProvider entity has 2 properties: identifier and is_installed. The identifier property in the tax provider service is used when the tax provider is added to the database. The value of this property is also used to reference the tax provider throughout Medusa. For example, it is used to change the tax provider to a region. 
1class MyTaxService extends AbstractTaxService {2  static identifier = "my-tax"3  // ...4}

shouldRetryTransaction_​

Parameters​

errRecord<string, unknown> | objectRequired

Returns​

booleanbooleanRequired

withTransaction​

Parameters​

transactionManagerEntityManager

Returns​

thisthisRequired
Was this section helpful?
© 2024 Medusa, Inc. All rights reserved.