Skip to main content

Class: OrderService

Hierarchy

  • TransactionBaseService

    OrderService

Constructors

constructor

new OrderService(__namedParameters)

Parameters

NameType
__namedParametersInjectedDependencies

Overrides

TransactionBaseService.constructor

Defined in

packages/medusa/src/services/order.ts:125

Properties

__configModule__

Protected Optional Readonly __configModule__: Record<string, unknown>

Inherited from

TransactionBaseService.__configModule__

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:10


__container__

Protected Readonly __container__: any

Inherited from

TransactionBaseService.__container__

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:9


__moduleDeclaration__

Protected Optional Readonly __moduleDeclaration__: Record<string, unknown>

Inherited from

TransactionBaseService.__moduleDeclaration__

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:11


addressRepository_

Protected Readonly addressRepository_: typeof AddressRepository

Defined in

packages/medusa/src/services/order.ts:117


cartService_

Protected Readonly cartService_: CartService

Defined in

packages/medusa/src/services/order.ts:116


customerService_

Protected Readonly customerService_: CustomerService

Defined in

packages/medusa/src/services/order.ts:104


discountService_

Protected Readonly discountService_: DiscountService

Defined in

packages/medusa/src/services/order.ts:108


draftOrderService_

Protected Readonly draftOrderService_: DraftOrderService

Defined in

packages/medusa/src/services/order.ts:119


eventBus_

Protected Readonly eventBus_: EventBusService

Defined in

packages/medusa/src/services/order.ts:120


featureFlagRouter_

Protected Readonly featureFlagRouter_: FlagRouter

Defined in

packages/medusa/src/services/order.ts:121


fulfillmentProviderService_

Protected Readonly fulfillmentProviderService_: FulfillmentProviderService

Defined in

packages/medusa/src/services/order.ts:109


fulfillmentService_

Protected Readonly fulfillmentService_: FulfillmentService

Defined in

packages/medusa/src/services/order.ts:110


giftCardService_

Protected Readonly giftCardService_: GiftCardService

Defined in

packages/medusa/src/services/order.ts:118


lineItemService_

Protected Readonly lineItemService_: LineItemService

Defined in

packages/medusa/src/services/order.ts:111


manager_

Protected manager_: EntityManager

Overrides

TransactionBaseService.manager_

Defined in

packages/medusa/src/services/order.ts:100


newTotalsService_

Protected Readonly newTotalsService_: NewTotalsService

Defined in

packages/medusa/src/services/order.ts:113


orderRepository_

Protected Readonly orderRepository_: typeof OrderRepository

Defined in

packages/medusa/src/services/order.ts:103


paymentProviderService_

Protected Readonly paymentProviderService_: PaymentProviderService

Defined in

packages/medusa/src/services/order.ts:105


productVariantInventoryService_

Protected Readonly productVariantInventoryService_: ProductVariantInventoryService

Defined in

packages/medusa/src/services/order.ts:123


regionService_

Protected Readonly regionService_: RegionService

Defined in

packages/medusa/src/services/order.ts:115


shippingOptionService_

Protected Readonly shippingOptionService_: ShippingOptionService

Defined in

packages/medusa/src/services/order.ts:106


shippingProfileService_

Protected Readonly shippingProfileService_: ShippingProfileService

Defined in

packages/medusa/src/services/order.ts:107


taxProviderService_

Protected Readonly taxProviderService_: TaxProviderService

Defined in

packages/medusa/src/services/order.ts:114


totalsService_

Protected Readonly totalsService_: TotalsService

Defined in

packages/medusa/src/services/order.ts:112


transactionManager_

Protected transactionManager_: EntityManager

Overrides

TransactionBaseService.transactionManager_

Defined in

packages/medusa/src/services/order.ts:101


Events

Static Readonly Events: Object

Type declaration

NameType
CANCELEDstring
COMPLETEDstring
FULFILLMENT_CANCELEDstring
FULFILLMENT_CREATEDstring
GIFT_CARD_CREATEDstring
ITEMS_RETURNEDstring
PAYMENT_CAPTUREDstring
PAYMENT_CAPTURE_FAILEDstring
PLACEDstring
REFUND_CREATEDstring
REFUND_FAILEDstring
RETURN_ACTION_REQUIREDstring
RETURN_REQUESTEDstring
SHIPMENT_CREATEDstring
SWAP_CREATEDstring
UPDATEDstring

Defined in

packages/medusa/src/services/order.ts:81

Methods

addShippingMethod

addShippingMethod(orderId, optionId, data?, config?): Promise<Order>

Parameters

NameType
orderIdstring
optionIdstring
data?Record<string, unknown>
configCreateShippingMethodDto

Returns

Promise<Order>

Defined in

packages/medusa/src/services/order.ts:943


archive

archive(orderId): Promise<Order>

Archives an order. It only alloved, if the order has been fulfilled and payment has been captured.

Parameters

NameTypeDescription
orderIdstringthe order to archive

Returns

Promise<Order>

the result of the update operation

Defined in

packages/medusa/src/services/order.ts:1480


atomicPhase_

Protected atomicPhase_<TResult, TError>(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.

Type parameters

Name
TResult
TError

Parameters

NameTypeDescription
work(transactionManager: EntityManager) => Promise<TResult>the transactional work to be done
isolationOrErrorHandler?IsolationLevel | (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>

the result of the transactional work

Inherited from

TransactionBaseService.atomicPhase_

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:50


cancel

cancel(orderId): Promise<Order>

Cancels an order. Throws if fulfillment process has been initiated. Throws if payment process has been initiated.

Parameters

NameTypeDescription
orderIdstringid of order to cancel.

Returns

Promise<Order>

result of the update operation.

Defined in

packages/medusa/src/services/order.ts:1095


cancelFulfillment

cancelFulfillment(fulfillmentId): Promise<Order>

Cancels a fulfillment (if related to an order)

Parameters

NameTypeDescription
fulfillmentIdstringthe ID of the fulfillment to cancel

Returns

Promise<Order>

updated order

Defined in

packages/medusa/src/services/order.ts:1417


capturePayment

capturePayment(orderId): Promise<Order>

Captures payment for an order.

Parameters

NameTypeDescription
orderIdstringid of order to capture payment for.

Returns

Promise<Order>

result of the update operation.

Defined in

packages/medusa/src/services/order.ts:1184


completeOrder

completeOrder(orderId): Promise<Order>

Parameters

NameTypeDescription
orderIdstringid of the order to complete

Returns

Promise<Order>

the result of the find operation

Defined in

packages/medusa/src/services/order.ts:513


createFromCart

createFromCart(cartOrId): Promise<Order>

Creates an order from a cart

Parameters

NameType
cartOrIdstring | Cart

Returns

Promise<Order>

resolves to the creation result.

Defined in

packages/medusa/src/services/order.ts:541


createFulfillment

createFulfillment(orderId, itemsToFulfill, config?): Promise<Order>

Creates fulfillments for an order. In a situation where the order has more than one shipping method, we need to partition the order items, such that they can be sent to their respective fulfillment provider.

Parameters

NameTypeDescription
orderIdstringid of order to cancel.
itemsToFulfillFulFillmentItemType[]items to fulfil.
configObjectthe config to cancel.
config.location_id?string-
config.metadata?Record<string, unknown>-
config.no_notification?boolean-

Returns

Promise<Order>

result of the update operation.

Defined in

packages/medusa/src/services/order.ts:1289


createGiftCardsFromLineItem_

Protected createGiftCardsFromLineItem_(order, lineItem, manager): Promise<GiftCard>[]

Parameters

NameType
orderOrder
lineItemLineItem
managerEntityManager

Returns

Promise<GiftCard>[]

Defined in

packages/medusa/src/services/order.ts:731


createRefund

createRefund(orderId, refundAmount, reason, note?, config?): Promise<Order>

Refunds a given amount back to the customer.

Parameters

NameTypeDescription
orderIdstringid of the order to refund.
refundAmountnumberthe amount to refund.
reasonstringthe reason to refund.
note?stringnote for refund.
configObjectthe config for refund.
config.no_notification?boolean-

Returns

Promise<Order>

the result of the refund operation.

Defined in

packages/medusa/src/services/order.ts:1506


createShipment

createShipment(orderId, fulfillmentId, trackingLinks?, config?): Promise<Order>

Adds a shipment to the order to indicate that an order has left the warehouse. Will ask the fulfillment provider for any documents that may have been created in regards to the shipment.

Parameters

NameTypeDescription
orderIdstringthe id of the order that has been shipped
fulfillmentIdstringthe fulfillment that has now been shipped
trackingLinks?TrackingLink[]array of tracking numebers associated with the shipment
configObjectthe config of the order that has been shipped
config.metadataRecord<string, unknown>-
config.no_notification?boolean-

Returns

Promise<Order>

the resulting order following the update.

Defined in

packages/medusa/src/services/order.ts:785


decorateTotals

decorateTotals(order, totalsFields?): Promise<Order>

Calculate and attach the different total fields on the object

Parameters

NameType
orderOrder
totalsFields?string[]

Returns

Promise<Order>

Defined in

packages/medusa/src/services/order.ts:1701

decorateTotals(order, context?): Promise<Order>

Calculate and attach the different total fields on the object

Parameters

NameType
orderOrder
context?TotalsContext

Returns

Promise<Order>

Defined in

packages/medusa/src/services/order.ts:1703


decorateTotalsLegacy

Protected decorateTotalsLegacy(order, totalsFields?): Promise<Order>

Parameters

NameTypeDefault value
orderOrderundefined
totalsFieldsstring[][]

Returns

Promise<Order>

Defined in

packages/medusa/src/services/order.ts:1572


getFulfillmentItems

Protected getFulfillmentItems(order, items, transformer): Promise<LineItem[]>

Retrieves the order line items, given an array of items.

Parameters

NameTypeDescription
orderOrderthe order to get line items from
itemsFulFillmentItemType[]the items to get
transformer(item: undefined | LineItem, quantity: number) => unknowna function to apply to each of the items retrieved from the order, should return a line item. If the transformer returns an undefined value the line item will be filtered from the returned array.

Returns

Promise<LineItem[]>

the line items generated by the transformer.

Defined in

packages/medusa/src/services/order.ts:1459


getTotalsRelations

Private getTotalsRelations(config): string[]

Parameters

NameType
configFindConfig<Order>

Returns

string[]

Defined in

packages/medusa/src/services/order.ts:1961


list

list(selector, config?): Promise<Order[]>

Parameters

NameTypeDescription
selectorSelector<Order>the query object for find
configFindConfig<Order>the config to be used for find

Returns

Promise<Order[]>

the result of the find operation

Defined in

packages/medusa/src/services/order.ts:179


listAndCount

listAndCount(selector, config?): Promise<[Order[], number]>

Parameters

NameTypeDescription
selectorQuerySelector<Order>the query object for find
configFindConfig<Order>the config to be used for find

Returns

Promise<[Order[], number]>

the result of the find operation

Defined in

packages/medusa/src/services/order.ts:196


registerReturnReceived

registerReturnReceived(orderId, receivedReturn, customRefundAmount?): Promise<Order>

Handles receiving a return. This will create a refund to the customer. If the returned items don't match the requested items the return status will be updated to requires_action. This behaviour is useful in sitautions where a custom refund amount is requested, but the retuned items are not matching the requested items. Setting the allowMismatch argument to true, will process the return, ignoring any mismatches.

Parameters

NameTypeDescription
orderIdstringthe order to return.
receivedReturnReturnthe received return
customRefundAmount?numberthe custom refund amount return

Returns

Promise<Order>

the result of the update operation

Defined in

packages/medusa/src/services/order.ts:1886


retrieve

retrieve(orderId, config?): Promise<Order>

Gets an order by id.

Parameters

NameTypeDescription
orderIdstringid or selector of order to retrieve
configFindConfig<Order>config of order to retrieve

Returns

Promise<Order>

the order document

Defined in

packages/medusa/src/services/order.ts:339


retrieveByCartId

retrieveByCartId(cartId, config?): Promise<Order>

Gets an order by cart id.

Parameters

NameTypeDescription
cartIdstringcart id to find order
configFindConfig<Order>the config to be used to find order

Returns

Promise<Order>

the order document

Defined in

packages/medusa/src/services/order.ts:435


retrieveByExternalId

retrieveByExternalId(externalId, config?): Promise<Order>

Gets an order by id.

Parameters

NameTypeDescription
externalIdstringid of order to retrieve
configFindConfig<Order>query config to get order by

Returns

Promise<Order>

the order document

Defined in

packages/medusa/src/services/order.ts:476


retrieveLegacy

Protected retrieveLegacy(orderIdOrSelector, config?): Promise<Order>

Parameters

NameType
orderIdOrSelectorstring | Selector<Order>
configFindConfig<Order>

Returns

Promise<Order>

Defined in

packages/medusa/src/services/order.ts:380


retrieveWithTotals

retrieveWithTotals(orderId, options?, context?): Promise<Order>

Parameters

NameType
orderIdstring
optionsFindConfig<Order>
contextTotalsContext

Returns

Promise<Order>

Defined in

packages/medusa/src/services/order.ts:418


shouldRetryTransaction_

Protected shouldRetryTransaction_(err): boolean

Parameters

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

Returns

boolean

Inherited from

TransactionBaseService.shouldRetryTransaction_

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:31


transformQueryForTotals

Protected transformQueryForTotals(config): Object

Parameters

NameType
configFindConfig<Order>

Returns

Object

NameType
relationsundefined | string[]
selectundefined | keyof Order[]
totalsToSelectundefined | keyof Order[]

Defined in

packages/medusa/src/services/order.ts:263


update

update(orderId, update): Promise<Order>

Updates an order. Metadata updates should use dedicated method, e.g. setMetadata etc. The function will throw errors if metadata updates are attempted.

Parameters

NameTypeDescription
orderIdstringthe id of the order. Must be a string that can be casted to an ObjectId
updateUpdateOrderInputan object with the update values.

Returns

Promise<Order>

resolves to the update result.

Defined in

packages/medusa/src/services/order.ts:1006


updateBillingAddress

Protected updateBillingAddress(order, address): Promise<void>

Updates the order's billing address.

Parameters

NameTypeDescription
orderOrderthe order to update
addressAddressthe value to set the billing address to

Returns

Promise<void>

the result of the update operation

Defined in

packages/medusa/src/services/order.ts:873


updateShippingAddress

Protected updateShippingAddress(order, address): Promise<void>

Updates the order's shipping address.

Parameters

NameTypeDescription
orderOrderthe order to update
addressAddressthe value to set the shipping address to

Returns

Promise<void>

the result of the update operation

Defined in

packages/medusa/src/services/order.ts:912


validateFulfillmentLineItem

Protected validateFulfillmentLineItem(item, quantity): null | LineItem

Checks that a given quantity of a line item can be fulfilled. Fails if the fulfillable quantity is lower than the requested fulfillment quantity. Fulfillable quantity is calculated by subtracting the already fulfilled quantity from the quantity that was originally purchased.

Parameters

NameTypeDescription
itemLineItemthe line item to check has sufficient fulfillable quantity.
quantitynumberthe quantity that is requested to be fulfilled.

Returns

null | LineItem

a line item that has the requested fulfillment quantity set.

Defined in

packages/medusa/src/services/order.ts:1256


withTransaction

withTransaction(transactionManager?): OrderService

Parameters

NameType
transactionManager?EntityManager

Returns

OrderService

Inherited from

TransactionBaseService.withTransaction

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:14