Skip to main content
Skip to main content

ShippingOptionService

Provides layer to manipulate profiles.

Constructors​

constructor​

new ShippingOptionService(«destructured»)

Parameters​

__namedParametersInjectedDependenciesRequired

Properties​

__configModule__Record<string, unknown>
__container__anyRequired
__moduleDeclaration__Record<string, unknown>
featureFlagRouter_FlagRouterRequired
manager_EntityManagerRequired
methodRepository_Repository<ShippingMethod>Required
optionRepository_Repository<ShippingOption> & { upsertShippingProfile: Method upsertShippingProfile }Required
providerService_FulfillmentProviderServiceRequired
regionService_RegionServiceRequired
requirementRepository_Repository<ShippingOptionRequirement>Required
transactionManager_undefined | EntityManagerRequired

Accessors​

activeManager_​

Protected get activeManager_(): EntityManager

Returns​

EntityManager

EntityManagerEntityManagerRequired

Methods​

addRequirement​

addRequirement(optionId, requirement): Promise<ShippingOption>

Adds a requirement to a shipping option. Only 1 requirement of each type is allowed.

Parameters​

optionIdstringRequired
the option to add the requirement to.
requirementShippingOptionRequirementRequired
the requirement for the option.

Returns​

Promise<ShippingOption>

PromisePromise<ShippingOption>Required
the result of update

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.

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

create​

create(data): Promise<ShippingOption>

Creates a new shipping option. Used both for outbound and inbound shipping options. The difference is registered by the is_return field which defaults to false.

Parameters​

dataCreateShippingOptionInputRequired
the data to create shipping options

Returns​

Promise<ShippingOption>

PromisePromise<ShippingOption>Required
the result of the create operation

createShippingMethod​

createShippingMethod(optionId, data, config): Promise<ShippingMethod>

Creates a shipping method for a given cart.

Parameters​

optionIdstringRequired
the id of the option to use for the method.
dataRecord<string, unknown>Required
the optional provider data to use.
configCreateShippingMethodDtoRequired
the cart to create the shipping method for.

Returns​

Promise<ShippingMethod>

PromisePromise<ShippingMethod>Required
the resulting shipping method.

delete​

delete(optionId): Promise<void | ShippingOption>

Deletes a profile with a given profile id.

Parameters​

optionIdstringRequired
the id of the profile to delete. Must be castable as an ObjectId

Returns​

Promise<void | ShippingOption>

PromisePromise<void | ShippingOption>Required
the result of the delete operation.

deleteShippingMethods​

deleteShippingMethods(shippingMethods): Promise<ShippingMethod[]>

Removes a given shipping method

Parameters​

shippingMethodsShippingMethod | ShippingMethod[]Required
the shipping method to remove

Returns​

Promise<ShippingMethod[]>

PromisePromise<ShippingMethod[]>Required
removed shipping methods

getPrice_​

getPrice_(option, data, cart): Promise<number>

Returns the amount to be paid for a shipping method. Will ask the fulfillment provider to calculate the price if the shipping option has the price type "calculated".

Parameters​

optionShippingOptionRequired
the shipping option to retrieve the price for.
dataRecord<string, unknown>Required
the shipping data to retrieve the price.
cartundefined | Order | CartRequired
the context in which the price should be retrieved.

Returns​

Promise<number>

PromisePromise<number>Required
the price of the shipping option.

list​

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

Parameters​

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

Returns​

Promise<ShippingOption[]>

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

listAndCount​

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

Parameters​

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

Returns​

Promise<[ShippingOption[], number]>

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

removeRequirement​

removeRequirement(requirementId): Promise<void | ShippingOptionRequirement>

Removes a requirement from a shipping option

Parameters​

requirementIdanyRequired
the id of the requirement to remove

Returns​

Promise<void | ShippingOptionRequirement>

PromisePromise<void | ShippingOptionRequirement>Required
the result of update

retrieve​

retrieve(optionId, options?): Promise<ShippingOption>

Gets a profile by id. Throws in case of DB Error and if profile was not found.

Parameters​

optionIdanyRequired
the id of the profile to get.
optionsFindConfig<ShippingOption>Required
the options to get a profile

Default: {}

Returns​

Promise<ShippingOption>

PromisePromise<ShippingOption>Required
the profile document.

shouldRetryTransaction_​

Protected shouldRetryTransaction_(err): boolean

Parameters​

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

Returns​

boolean

booleanboolean

update​

update(optionId, update): Promise<ShippingOption>

Updates a profile. Metadata updates and product updates should use dedicated methods, e.g. setMetadata, etc. The function will throw errors if metadata or product updates are attempted.

Parameters​

optionIdstringRequired
the id of the option. Must be a string that can be casted to an ObjectId
updateUpdateShippingOptionInputRequired
an object with the update values.

Returns​

Promise<ShippingOption>

PromisePromise<ShippingOption>Required
resolves to the update result.

updateShippingMethod​

updateShippingMethod(id, update): Promise<undefined | ShippingMethod>

Updates a shipping method's associations. Useful when a cart is completed and its methods should be copied to an order/swap entity.

Parameters​

idstringRequired
the id of the shipping method to update
updateShippingMethodUpdateRequired
the values to update the method with

Returns​

Promise<undefined | ShippingMethod>

PromisePromise<undefined | ShippingMethod>Required
the resulting shipping method

updateShippingProfile​

updateShippingProfile(optionIds, profileId): Promise<ShippingOption[]>

Parameters​

optionIdsstring | string[]Required
ID or IDs of the shipping options to update
profileIdstringRequired
Shipping profile ID to update the shipping options with

Returns​

Promise<ShippingOption[]>

PromisePromise<ShippingOption[]>Required
updated shipping options

validateAndMutatePrice​

Private validateAndMutatePrice(option, priceInput): Promise<CreateShippingOptionInput | Omit<ShippingOption, "beforeInsert">>

Parameters​

Returns​

Promise<CreateShippingOptionInput | Omit<ShippingOption, "beforeInsert">>

PromisePromise<CreateShippingOptionInput | Omit<ShippingOption, "beforeInsert">>Required

validateCartOption​

validateCartOption(option, cart): Promise<null | ShippingOption>

Checks if a given option id is a valid option for a cart. If it is the option is returned with the correct price. Throws when region_ids do not match, or when the shipping option requirements are not satisfied.

Parameters​

optionShippingOptionRequired
the option object to check
cartCartRequired
the cart object to check against

Returns​

Promise<null | ShippingOption>

PromisePromise<null | ShippingOption>Required
the validated shipping option

validatePriceType_​

validatePriceType_(priceType, option): Promise<ShippingOptionPriceType>

Validates a shipping option price

Parameters​

priceTypeShippingOptionPriceTypeRequired
the price to validate
optionShippingOptionRequired
the option to validate against

Returns​

Promise<ShippingOptionPriceType>

PromisePromise<ShippingOptionPriceType>Required
the validated price

validateRequirement_​

validateRequirement_(requirement, optionId?): Promise<ShippingOptionRequirement>

Validates a requirement

Parameters​

requirementShippingOptionRequirementRequired
the requirement to validate
optionIdundefined | stringRequired
the id to validate the requirement

Default: undefined

Returns​

Promise<ShippingOptionRequirement>

PromisePromise<ShippingOptionRequirement>Required
a validated shipping requirement

withTransaction​

withTransaction(transactionManager?): ShippingOptionService

Parameters​

transactionManagerEntityManager

Returns​

ShippingOptionService

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