Skip to main content
Skip to main content

ReturnService

Constructors​

constructor​

**new ReturnService**(«destructured»)

Parameters​

__namedParametersInjectedDependenciesRequired

Properties​

__configModule__Record<string, unknown>
__container__anyRequired
__moduleDeclaration__Record<string, unknown>
featureFlagRouter_FlagRouterRequired
fulfillmentProviderService_FulfillmentProviderServiceRequired
lineItemService_LineItemServiceRequired
manager_EntityManagerRequired
orderService_OrderServiceRequired
productVariantInventoryService_ProductVariantInventoryServiceRequired
returnItemRepository_Repository<ReturnItem>Required
returnReasonService_ReturnReasonServiceRequired
returnRepository_Repository<Return>Required
shippingOptionService_ShippingOptionServiceRequired
taxProviderService_TaxProviderServiceRequired
totalsService_TotalsServiceRequired
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

cancel​

**cancel**(returnId): Promise&#60;[Return](/references/services/classes/Return)&#62;

Cancels a return if possible. Returns can be canceled if it has not been received.

Parameters​

returnIdstringRequired
the id of the return to cancel.

Returns​

Promise<Return>

PromisePromise<Return>Required
the updated Return

create​

**create**(data): Promise&#60;[Return](/references/services/classes/Return)&#62;

Creates a return request for an order, with given items, and a shipping method. If no refund amount is provided the refund amount is calculated from the return lines and the shipping cost.

Parameters​

dataCreateReturnInputRequired
data to use for the return e.g. shipping_method, items or refund_amount

Returns​

Promise<Return>

PromisePromise<Return>Required
the created return

fulfill​

**fulfill**(returnId): Promise&#60;[Return](/references/services/classes/Return)&#62;

Parameters​

returnIdstringRequired

Returns​

Promise<Return>

PromisePromise<Return>Required

getFulfillmentItems​

Protected **getFulfillmentItems**(order, items, transformer): Promise&#60;[LineItem](/references/services/classes/LineItem) & &#123; note?: string ; reason_id?: string &#125;[]&#62;

Retrieves the order line items, given an array of items

Parameters​

orderOrderRequired
the order to get line items from
itemsOrdersReturnItem[]Required
the items to get
transformerTransformerRequired
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 & { note?: string ; reason_id?: string }[]>

PromisePromise<LineItem & { note?: string ; reason_id?: string }[]>Required
the line items generated by the transformer.

list​

**list**(selector, config?): Promise&#60;[Return](/references/services/classes/Return)[]&#62;

Parameters​

selectorSelector<Return>Required
the query object for find
configFindConfig<Return>Required
the config object for find

Returns​

Promise<Return[]>

PromisePromise<Return[]>Required
the result of the find operation

listAndCount​

**listAndCount**(selector, config?): Promise&#60;[[Return](/references/services/classes/Return)[], number]&#62;

Parameters​

selectorSelector<Return>Required
the query object for find
configFindConfig<Return>Required
the config object for find

Returns​

Promise<[Return[], number]>

PromisePromise<[Return[], number]>Required
the result of the find operation

receive​

**receive**(returnId, receivedItems, refundAmount?, allowMismatch?, context?): Promise&#60;[Return](/references/services/classes/Return)&#62;

Registers a previously requested return as received. 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 situations where a custom refund amount is requested, but the returned items are not matching the requested items. Setting the allowMismatch argument to true, will process the return, ignoring any mismatches.

Parameters​

returnIdstringRequired
the orderId to return to
receivedItemsOrdersReturnItem[]Required
the items received after return.
refundAmountnumber
the amount to return
allowMismatchbooleanRequired
whether to ignore return/received product mismatch

Default: false

contextobjectRequired

Default: {}

context.locationIdstring

Returns​

Promise<Return>

PromisePromise<Return>Required
the result of the update operation

retrieve​

**retrieve**(returnId, config?): Promise&#60;[Return](/references/services/classes/Return)&#62;

Retrieves a return by its id.

Parameters​

returnIdstringRequired
the id of the return to retrieve
configFindConfig<Return>Required
the config object

Default: {}

Returns​

Promise<Return>

PromisePromise<Return>Required
the return

retrieveBySwap​

**retrieveBySwap**(swapId, relations?): Promise&#60;[Return](/references/services/classes/Return)&#62;

Parameters​

swapIdstringRequired
relationsstring[]Required

Default: []

Returns​

Promise<Return>

PromisePromise<Return>Required

shouldRetryTransaction_​

Protected **shouldRetryTransaction_**(err): boolean

Parameters​

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

Returns​

boolean

booleanboolean

update​

**update**(returnId, update): Promise&#60;[Return](/references/services/classes/Return)&#62;

Parameters​

returnIdstringRequired
updateUpdateReturnInputRequired

Returns​

Promise<Return>

PromisePromise<Return>Required

validateReturnLineItem​

Protected **validateReturnLineItem**(item?, quantity?, additional?): DeepPartial&#60;[LineItem](/references/services/classes/LineItem)&#62;

Checks that a given quantity of a line item can be returned. Fails if the item is undefined or if the returnable quantity of the item is lower, than the quantity that is requested to be returned.

Parameters​

itemLineItem
the line item to check has sufficient returnable quantity.
quantitynumberRequired
the quantity that is requested to be returned.

Default: 0

additionalobjectRequired
the quantity that is requested to be returned.

Default: {}

additional.notestring
additional.reason_idstring

Returns​

DeepPartial<LineItem>

DeepPartialDeepPartial<LineItem>Required
a line item where the quantity is set to the requested return quantity.

validateReturnStatuses​

Protected **validateReturnStatuses**(order): void

Checks that an order has the statuses necessary to complete a return. fulfillment_status cannot be not_fulfilled or returned. payment_status must be captured.

Parameters​

orderOrderRequired
the order to check statuses on

Returns​

void

voidvoid

Throws​

when statuses are not sufficient for returns.

withTransaction​

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

Parameters​

transactionManagerEntityManager

Returns​

ReturnService

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