Skip to main content
Skip to main content

FulfillmentProviderService

Helps retrieve fulfillment providers

Constructors​

constructor​

**new FulfillmentProviderService**(container)

Parameters​

Properties​

__configModule__Record<string, unknown>
__container__anyRequired
__moduleDeclaration__Record<string, unknown>
container_FulfillmentProviderContainerRequired
fulfillmentProviderRepository_Repository<FulfillmentProvider>Required
manager_EntityManagerRequired
transactionManager_undefined | EntityManagerRequired

Accessors​

activeManager_​

Protected get**activeManager_**(): EntityManager

Returns​

EntityManager

EntityManagerEntityManagerRequired

Methods​

atomicPhase_​

Protected **atomicPhase_**<TypeParameter TResult, TypeParameter TError>(work, isolationOrErrorHandler?, maybeErrorHandlerOrDontFail?): Promise&#60;TResult&#62;

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.

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​

Promise<TResult>

PromisePromise<TResult>Required
the result of the transactional work

calculatePrice​

**calculatePrice**(option, data, cart?): Promise&#60;number&#62;

Parameters​

optionShippingOptionRequired
A Shipping Option represents a way in which an Order or Return can be shipped. Shipping Options have an associated Fulfillment Provider that will be used when the fulfillment of an Order is initiated. Shipping Options themselves cannot be added to Carts, but serve as a template for Shipping Methods. This distinction makes it possible to customize individual Shipping Methods with additional information.
dataRecord<string, unknown>Required
cartOrder | Cart

Returns​

Promise<number>

PromisePromise<number>Required

canCalculate​

**canCalculate**(option): Promise&#60;boolean&#62;

Parameters​

Returns​

Promise<boolean>

PromisePromise<boolean>Required

cancelFulfillment​

**cancelFulfillment**(fulfillment): Promise&#60;[Fulfillment](/references/services/classes/Fulfillment)&#62;

Parameters​

fulfillmentFulfillmentRequired
A Fulfillment is created once an admin can prepare the purchased goods. Fulfillments will eventually be shipped and hold information about how to track shipments. Fulfillments are created through a fulfillment provider, which typically integrates a third-party shipping service. Fulfillments can be associated with orders, claims, swaps, and returns.

Returns​

Promise<Fulfillment>

PromisePromise<Fulfillment>Required

createFulfillment​

**createFulfillment**(method, items, order, fulfillment): Promise&#60;Record&#60;string, unknown&#62;&#62;

Parameters​

methodShippingMethodRequired
A Shipping Method represents a way in which an Order or Return can be shipped. Shipping Methods are created from a Shipping Option, but may contain additional details that can be necessary for the Fulfillment Provider to handle the shipment. If the shipping method is created for a return, it may be associated with a claim or a swap that the return is part of.
itemsLineItem[]Required
orderCreateFulfillmentOrderRequired
fulfillmentOmit<Fulfillment, "beforeInsert">Required

Returns​

Promise<Record<string, unknown>>

PromisePromise<Record<string, unknown>>Required

createReturn​

**createReturn**(returnOrder): Promise&#60;Record&#60;string, unknown&#62;&#62;

Parameters​

returnOrderCreateReturnTypeRequired

Returns​

Promise<Record<string, unknown>>

PromisePromise<Record<string, unknown>>Required

list​

**list**(): Promise&#60;[FulfillmentProvider](/references/services/classes/FulfillmentProvider)[]&#62;

Returns​

Promise<FulfillmentProvider[]>

PromisePromise<FulfillmentProvider[]>Required

listFulfillmentOptions​

**listFulfillmentOptions**(providerIds): Promise&#60;[FulfillmentOptions](/references/services/types/FulfillmentOptions)[]&#62;

Parameters​

providerIdsstring[]Required

Returns​

Promise<FulfillmentOptions[]>

PromisePromise<FulfillmentOptions[]>Required

registerInstalledProviders​

**registerInstalledProviders**(providers): Promise&#60;void&#62;

Parameters​

providersstring[]Required

Returns​

Promise<void>

PromisePromise<void>Required

retrieveDocuments​

**retrieveDocuments**(providerId, fulfillmentData, documentType): Promise&#60;any&#62;

Fetches documents from the fulfillment provider

Parameters​

providerIdstringRequired
the id of the provider
fulfillmentDataRecord<string, unknown>Required
the data relating to the fulfillment
documentType"label" | "invoice"Required
the typ of

Returns​

Promise<any>

PromisePromise<any>Required
document to fetch

retrieveProvider​

**retrieveProvider**(providerId): any

Parameters​

providerIdstringRequired
the provider id

Returns​

any

anyany
the payment fulfillment provider

shouldRetryTransaction_​

Protected **shouldRetryTransaction_**(err): boolean

Parameters​

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

Returns​

boolean

booleanboolean

validateFulfillmentData​

**validateFulfillmentData**(option, data, cart): Promise&#60;Record&#60;string, unknown&#62;&#62;

Parameters​

optionShippingOptionRequired
A Shipping Option represents a way in which an Order or Return can be shipped. Shipping Options have an associated Fulfillment Provider that will be used when the fulfillment of an Order is initiated. Shipping Options themselves cannot be added to Carts, but serve as a template for Shipping Methods. This distinction makes it possible to customize individual Shipping Methods with additional information.
dataRecord<string, unknown>Required
cartRecord<string, unknown> | CartRequired

Returns​

Promise<Record<string, unknown>>

PromisePromise<Record<string, unknown>>Required

validateOption​

**validateOption**(option): Promise&#60;boolean&#62;

Parameters​

optionShippingOptionRequired
A Shipping Option represents a way in which an Order or Return can be shipped. Shipping Options have an associated Fulfillment Provider that will be used when the fulfillment of an Order is initiated. Shipping Options themselves cannot be added to Carts, but serve as a template for Shipping Methods. This distinction makes it possible to customize individual Shipping Methods with additional information.

Returns​

Promise<boolean>

PromisePromise<boolean>Required

withTransaction​

**withTransaction**(transactionManager?): [FulfillmentProviderService](/references/services/classes/FulfillmentProviderService)

Parameters​

transactionManagerEntityManager

Returns​

FulfillmentProviderService

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