Files

github-actions[bot] 5c8ef2d370 chore(docs): Generated Services Reference (automated) (#4206 )

Co-authored-by: olivermrbl <olivermrbl@users.noreply.github.com>
Co-authored-by: Shahed Nasser <shahednasser@gmail.com>

2023-05-31 16:44:22 +03:00

28 KiB

Raw Blame History

Class: OrderService

Hierarchy

TransactionBaseService

↳ OrderService

Constructors

constructor

• new OrderService(__namedParameters)

Parameters

Name	Type
`__namedParameters`	`InjectedDependencies`

Overrides

TransactionBaseService.constructor

Defined in

medusa/src/services/order.ts:137

Properties

configModule

• Protected Optional Readonly __configModule__: Record<string, unknown>

Inherited from

TransactionBaseService.__configModule__

Defined in

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

container

• Protected Readonly __container__: any

Inherited from

TransactionBaseService.__container__

Defined in

medusa/src/interfaces/transaction-base-service.ts:13

moduleDeclaration

• Protected Optional Readonly __moduleDeclaration__: Record<string, unknown>

Inherited from

TransactionBaseService.__moduleDeclaration__

Defined in

medusa/src/interfaces/transaction-base-service.ts:15

addressRepository_

• Protected Readonly addressRepository_: Repository<Address>

Defined in

medusa/src/services/order.ts:128

cartService_

• Protected Readonly cartService_: CartService

Defined in

medusa/src/services/order.ts:127

customerService_

• Protected Readonly customerService_: CustomerService

Defined in

medusa/src/services/order.ts:115

discountService_

• Protected Readonly discountService_: DiscountService

Defined in

medusa/src/services/order.ts:119

draftOrderService_

• Protected Readonly draftOrderService_: DraftOrderService

Defined in

medusa/src/services/order.ts:130

eventBus_

• Protected Readonly eventBus_: EventBusService

Defined in

medusa/src/services/order.ts:132

featureFlagRouter_

• Protected Readonly featureFlagRouter_: FlagRouter

Defined in

medusa/src/services/order.ts:133

fulfillmentProviderService_

• Protected Readonly fulfillmentProviderService_: FulfillmentProviderService

Defined in

medusa/src/services/order.ts:120

fulfillmentService_

• Protected Readonly fulfillmentService_: FulfillmentService

Defined in

medusa/src/services/order.ts:121

giftCardService_

• Protected Readonly giftCardService_: GiftCardService

Defined in

medusa/src/services/order.ts:129

inventoryService_

• Protected Readonly inventoryService_: IInventoryService

Defined in

medusa/src/services/order.ts:131

lineItemService_

• Protected Readonly lineItemService_: LineItemService

Defined in

medusa/src/services/order.ts:122

manager_

• Protected manager_: EntityManager

Inherited from

TransactionBaseService.manager_

Defined in

medusa/src/interfaces/transaction-base-service.ts:5

newTotalsService_

• Protected Readonly newTotalsService_: NewTotalsService

Defined in

medusa/src/services/order.ts:124

orderRepository_

• Protected Readonly orderRepository_: Repository<Order> & { findOneWithRelations: (relations: FindOptionsRelations<Order>, optionsWithoutRelations: Omit<FindManyOptions<Order>, "relations">) => Promise<Order> ; findWithRelations: (relations: FindOptionsRelations<Order>, optionsWithoutRelations: Omit<FindManyOptions<Order>, "relations">) => Promise<Order[]> }

Defined in

medusa/src/services/order.ts:114

paymentProviderService_

• Protected Readonly paymentProviderService_: PaymentProviderService

Defined in

medusa/src/services/order.ts:116

productVariantInventoryService_

• Protected Readonly productVariantInventoryService_: ProductVariantInventoryService

Defined in

medusa/src/services/order.ts:135

regionService_

• Protected Readonly regionService_: RegionService

Defined in

medusa/src/services/order.ts:126

shippingOptionService_

• Protected Readonly shippingOptionService_: ShippingOptionService

Defined in

medusa/src/services/order.ts:117

shippingProfileService_

• Protected Readonly shippingProfileService_: ShippingProfileService

Defined in

medusa/src/services/order.ts:118

taxProviderService_

• Protected Readonly taxProviderService_: TaxProviderService

Defined in

medusa/src/services/order.ts:125

totalsService_

• Protected Readonly totalsService_: TotalsService

Defined in

medusa/src/services/order.ts:123

transactionManager_

• Protected transactionManager_: undefined | EntityManager

Inherited from

TransactionBaseService.transactionManager_

Defined in

medusa/src/interfaces/transaction-base-service.ts:6

Events

▪ Static Readonly Events: Object

Type declaration

Name	Type
`CANCELED`	`string`
`COMPLETED`	`string`
`FULFILLMENT_CANCELED`	`string`
`FULFILLMENT_CREATED`	`string`
`GIFT_CARD_CREATED`	`string`
`ITEMS_RETURNED`	`string`
`PAYMENT_CAPTURED`	`string`
`PAYMENT_CAPTURE_FAILED`	`string`
`PLACED`	`string`
`REFUND_CREATED`	`string`
`REFUND_FAILED`	`string`
`RETURN_ACTION_REQUIRED`	`string`
`RETURN_REQUESTED`	`string`
`SHIPMENT_CREATED`	`string`
`SWAP_CREATED`	`string`
`UPDATED`	`string`

Defined in

medusa/src/services/order.ts:95

Accessors

activeManager_

• Protected get activeManager_(): EntityManager

Returns

EntityManager

Inherited from

TransactionBaseService.activeManager_

Defined in

medusa/src/interfaces/transaction-base-service.ts:8

Methods

addShippingMethod

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

Parameters

Name	Type
`orderId`	`string`
`optionId`	`string`
`data?`	`Record`<`string`, `unknown`>
`config`	`CreateShippingMethodDto`

Returns

Promise<Order>

Defined in

medusa/src/services/order.ts:1026

Name	Type	Description
`orderId`	`string`	the order to archive

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

Name	Type	Description
`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

medusa/src/interfaces/transaction-base-service.ts:56

cancel

▸ cancel(orderId): Promise<Order>

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

Parameters

Name	Type	Description
`orderId`	`string`	id of order to cancel.

Returns

Promise<Order>

result of the update operation.

Defined in

medusa/src/services/order.ts:1178

cancelFulfillment

▸ cancelFulfillment(fulfillmentId): Promise<Order>

Cancels a fulfillment (if related to an order)

Parameters

Name	Type	Description
`fulfillmentId`	`string`	the ID of the fulfillment to cancel

Returns

Promise<Order>

updated order

Defined in

medusa/src/services/order.ts:1499

capturePayment

▸ capturePayment(orderId): Promise<Order>

Captures payment for an order.

Parameters

Name	Type	Description
`orderId`	`string`	id of order to capture payment for.

Returns

Promise<Order>

result of the update operation.

Defined in

medusa/src/services/order.ts:1267

completeOrder

▸ completeOrder(orderId): Promise<Order>

Parameters

Name	Type	Description
`orderId`	`string`	id of the order to complete

Returns

Promise<Order>

the result of the find operation

Defined in

medusa/src/services/order.ts:579

createFromCart

▸ createFromCart(cartOrId): Promise<Order>

Creates an order from a cart

Parameters

Name	Type
`cartOrId`	`string` \| `Cart`

Returns

Promise<Order>

resolves to the creation result.

Defined in

medusa/src/services/order.ts:609

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

Name	Type	Description
`orderId`	`string`	id of order to cancel.
`itemsToFulfill`	`FulFillmentItemType`[]	items to fulfil.
`config`	`Object`	the 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

medusa/src/services/order.ts:1372

createGiftCardsFromLineItem_

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

Parameters

Name	Type
`order`	`Order`
`lineItem`	`LineItem`
`manager`	`EntityManager`

Returns

Promise<GiftCard>[]

Defined in

medusa/src/services/order.ts:806

createRefund

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

Refunds a given amount back to the customer.

Parameters

Name	Type	Description
`orderId`	`string`	id of the order to refund.
`refundAmount`	`number`	the amount to refund.
`reason`	`string`	the reason to refund.
`note?`	`string`	note for refund.
`config`	`Object`	the config for refund.
`config.no_notification?`	`boolean`	-

Returns

Promise<Order>

the result of the refund operation.

Defined in

medusa/src/services/order.ts:1588

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

Name	Type	Description
`orderId`	`string`	the id of the order that has been shipped
`fulfillmentId`	`string`	the fulfillment that has now been shipped
`trackingLinks?`	`TrackingLink`[]	array of tracking numebers associated with the shipment
`config`	`Object`	the config of the order that has been shipped
`config.metadata`	`Record`<`string`, `unknown`>	-
`config.no_notification?`	`boolean`	-

Returns

Promise<Order>

the resulting order following the update.

Defined in

medusa/src/services/order.ts:860

decorateTotals

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

Calculate and attach the different total fields on the object

Parameters

Name	Type
`order`	`Order`
`totalsFields?`	`string`[]

Returns

Promise<Order>

Defined in

medusa/src/services/order.ts:1785

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

Calculate and attach the different total fields on the object

Parameters

Name	Type
`order`	`Order`
`context?`	`TotalsContext`

Returns

Promise<Order>

Defined in

medusa/src/services/order.ts:1787

decorateTotalsLegacy

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

Parameters

Name	Type	Default value
`order`	`Order`	`undefined`
`totalsFields`	`string`[]	`[]`

Returns

Promise<Order>

Defined in

medusa/src/services/order.ts:1656

getFulfillmentItems

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

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

Parameters

Name	Type	Description
`order`	`Order`	the order to get line items from
`items`	`FulFillmentItemType`[]	the items to get
`transformer`	(`item`: `undefined` \| `LineItem`, `quantity`: `number`) => `unknown`	a 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

medusa/src/services/order.ts:1541

getTotalsRelations

▸ Private getTotalsRelations(config): string[]

Parameters

Name	Type
`config`	`FindConfig`<`Order`>

Returns

string[]

Defined in

medusa/src/services/order.ts:2050

list

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

Parameters

Name	Type	Description
`selector`	`Selector`<`Order`>	the query object for find
`config`	`FindConfig`<`Order`>	the config to be used for find

Returns

Promise<Order[]>

the result of the find operation

Defined in

medusa/src/services/order.ts:189

listAndCount

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

Parameters

Name	Type	Description
`selector`	`QuerySelector`<`Order`>	the query object for find
`config`	`FindConfig`<`Order`>	the config to be used for find

Returns

Promise<[Order[], number]>

the result of the find operation

Defined in

medusa/src/services/order.ts:206

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

Name	Type	Description
`orderId`	`string`	the order to return.
`receivedReturn`	`Return`	the received return
`customRefundAmount?`	`number`	the custom refund amount return

Returns

Promise<Order>

the result of the update operation

Defined in

medusa/src/services/order.ts:1975

retrieve

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

Gets an order by id.

Parameters

Name	Type	Description
`orderId`	`string`	id or selector of order to retrieve
`config`	`FindConfig`<`Order`>	config of order to retrieve

Returns

Promise<Order>

the order document

Defined in

medusa/src/services/order.ts:390

retrieveByCartId

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

Gets an order by cart id.

Parameters

Name	Type	Description
`cartId`	`string`	cart id to find order
`config`	`FindConfig`<`Order`>	the config to be used to find order

Returns

Promise<Order>

the order document

Defined in

medusa/src/services/order.ts:486

retrieveByCartIdWithTotals

▸ retrieveByCartIdWithTotals(cartId, options?): Promise<Order>

Parameters

Name	Type
`cartId`	`string`
`options`	`FindConfig`<`Order`>

Returns

Promise<Order>

Defined in

medusa/src/services/order.ts:520

retrieveByExternalId

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

Gets an order by id.

Parameters

Name	Type	Description
`externalId`	`string`	id of order to retrieve
`config`	`FindConfig`<`Order`>	query config to get order by

Returns

Promise<Order>

the order document

Defined in

medusa/src/services/order.ts:535

retrieveLegacy

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

Parameters

Name	Type
`orderIdOrSelector`	`string` \| `Selector`<`Order`>
`config`	`FindConfig`<`Order`>

Returns

Promise<Order>

Defined in

medusa/src/services/order.ts:430

retrieveWithTotals

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

Parameters

Name	Type
`orderId`	`string`
`options`	`FindConfig`<`Order`>
`context`	`TotalsContext`

Returns

Promise<Order>

Defined in

medusa/src/services/order.ts:469

shouldRetryTransaction_

▸ Protected shouldRetryTransaction_(err): boolean

Parameters

Name	Type
`err`	`Record`<`string`, `unknown`> \| { `code`: `string` }

Returns

boolean

Inherited from

TransactionBaseService.shouldRetryTransaction_

Defined in

medusa/src/interfaces/transaction-base-service.ts:37

transformQueryForTotals

▸ Protected transformQueryForTotals(config): Object

Parameters

Name	Type
`config`	`FindConfig`<`Order`>

Returns

Object

Name	Type
`relations`	`undefined` \| `string`[]
`select`	`undefined` \| keyof `Order`[]
`totalsToSelect`	`undefined` \| keyof `Order`[]

Defined in

medusa/src/services/order.ts:312

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

Name	Type	Description
`orderId`	`string`	the id of the order. Must be a string that can be casted to an ObjectId
`update`	`UpdateOrderInput`	an object with the update values.

Returns

Promise<Order>

resolves to the update result.

Defined in

medusa/src/services/order.ts:1089

updateBillingAddress

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

Updates the order's billing address.

Parameters

Name	Type	Description
`order`	`Order`	the order to update
`address`	`Address`	the value to set the billing address to

Returns

Promise<void>

the result of the update operation

Defined in

medusa/src/services/order.ts:948

updateShippingAddress

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

Updates the order's shipping address.

Parameters

Name	Type	Description
`order`	`Order`	the order to update
`address`	`Address`	the value to set the shipping address to

Returns

Promise<void>

the result of the update operation

Defined in

medusa/src/services/order.ts:995

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

Name	Type	Description
`item`	`LineItem`	the line item to check has sufficient fulfillable quantity.
`quantity`	`number`	the quantity that is requested to be fulfilled.

Returns

null | LineItem

a line item that has the requested fulfillment quantity set.

Defined in

medusa/src/services/order.ts:1339

withTransaction

▸ withTransaction(transactionManager?): OrderService

Parameters

Name	Type
`transactionManager?`	`EntityManager`

Returns

OrderService

Inherited from

TransactionBaseService.withTransaction

Defined in

medusa/src/interfaces/transaction-base-service.ts:20

28 KiB Raw Blame History

Class: OrderService

Hierarchy

Constructors

constructor

Parameters

Overrides

Defined in

Properties

__configModule__

Inherited from

Defined in

__container__

Inherited from

Defined in

__moduleDeclaration__

Inherited from

Defined in

addressRepository_

Defined in

cartService_

Defined in

customerService_

Defined in

discountService_

Defined in

draftOrderService_

Defined in

eventBus_

Defined in

featureFlagRouter_

Defined in

fulfillmentProviderService_

Defined in

fulfillmentService_

Defined in

giftCardService_

Defined in

inventoryService_

Defined in

lineItemService_

Defined in

manager_

Inherited from

Defined in

newTotalsService_

Defined in

orderRepository_

Defined in

paymentProviderService_

Defined in

productVariantInventoryService_

Defined in

regionService_

Defined in

shippingOptionService_

Defined in

shippingProfileService_

Defined in

taxProviderService_

Defined in

totalsService_

Defined in

transactionManager_

Inherited from

Defined in

Events

Type declaration

Defined in

Accessors

activeManager_

Returns

Inherited from

Defined in

Methods

addShippingMethod

Parameters

Returns

Defined in

archive

28 KiB

Raw Blame History

configModule

container

moduleDeclaration