daea35fe73
Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action Co-authored-by: Shahed Nasser <27354907+shahednasser@users.noreply.github.com>
7.1 KiB
displayed_sidebar
| displayed_sidebar |
|---|
| jsClientSidebar |
Interface: FulfillmentService
internal.internal.FulfillmentService
Fulfillment Provider interface Fullfillment provider plugin services should extend the AbstractFulfillmentService from this file
Implemented by
Methods
calculatePrice
▸ calculatePrice(optionData, data, cart): Promise<number>
Used to calculate a price for a given shipping option.
Parameters
| Name | Type |
|---|---|
optionData |
ShippingOptionData |
data |
FulfillmentProviderData |
cart |
Cart |
Returns
Promise<number>
Defined in
packages/medusa/dist/interfaces/fulfillment-service.d.ts:47
canCalculate
▸ canCalculate(data): Promise<boolean>
Used to determine if a shipping option can have a calculated price
Parameters
| Name | Type |
|---|---|
data |
ShippingOptionData |
Returns
Promise<boolean>
Defined in
packages/medusa/dist/interfaces/fulfillment-service.d.ts:43
cancelFulfillment
▸ cancelFulfillment(fulfillmentData): Promise<any>
Cancel a fulfillment using data from the fulfillment
Parameters
| Name | Type |
|---|---|
fulfillmentData |
FulfillmentProviderData |
Returns
Promise<any>
Defined in
packages/medusa/dist/interfaces/fulfillment-service.d.ts:56
createFulfillment
▸ createFulfillment(data, items, order, fulfillment): Promise<FulfillmentProviderData>
Create a fulfillment using data from shipping method, line items, and fulfillment. All from the order.
The returned value of this method will populate the fulfillment.data field.
Parameters
| Name | Type |
|---|---|
data |
ShippingMethodData |
items |
LineItem[] |
order |
Order |
fulfillment |
Fulfillment |
Returns
Promise<FulfillmentProviderData>
Defined in
packages/medusa/dist/interfaces/fulfillment-service.d.ts:52
createReturn
▸ createReturn(returnOrder): Promise<Record<string, unknown>>
Used to create a return order. Should return the data necessary for future operations on the return; in particular the data may be used to receive documents attached to the return.
Parameters
| Name | Type |
|---|---|
returnOrder |
CreateReturnType |
Returns
Promise<Record<string, unknown>>
Defined in
packages/medusa/dist/interfaces/fulfillment-service.d.ts:62
getFulfillmentDocuments
▸ getFulfillmentDocuments(data): Promise<any>
Used to retrieve documents associated with a fulfillment.
Parameters
| Name | Type |
|---|---|
data |
FulfillmentProviderData |
Returns
Promise<any>
Defined in
packages/medusa/dist/interfaces/fulfillment-service.d.ts:66
getFulfillmentOptions
▸ getFulfillmentOptions(): Promise<any[]>
Called before a shipping option is created in Admin. The method should return all of the options that the fulfillment provider can be used with, and it is here the distinction between different shipping options are enforced. For example, a fulfillment provider may offer Standard Shipping and Express Shipping as fulfillment options, it is up to the store operator to create shipping options in Medusa that are offered to the customer.
Returns
Promise<any[]>
Defined in
packages/medusa/dist/interfaces/fulfillment-service.d.ts:24
getIdentifier
▸ getIdentifier(): string
Return a unique identifier to retrieve the fulfillment plugin provider
Returns
string
Defined in
packages/medusa/dist/interfaces/fulfillment-service.d.ts:15
getReturnDocuments
▸ getReturnDocuments(data): Promise<any>
Used to retrieve documents related to a return order.
Parameters
| Name | Type |
|---|---|
data |
Record<string, unknown> |
Returns
Promise<any>
Defined in
packages/medusa/dist/interfaces/fulfillment-service.d.ts:70
getShipmentDocuments
▸ getShipmentDocuments(data): Promise<any>
Used to retrieve documents related to a shipment.
Parameters
| Name | Type |
|---|---|
data |
Record<string, unknown> |
Returns
Promise<any>
Defined in
packages/medusa/dist/interfaces/fulfillment-service.d.ts:74
retrieveDocuments
▸ retrieveDocuments(fulfillmentData, documentType): Promise<any>
Parameters
| Name | Type |
|---|---|
fulfillmentData |
FulfillmentProviderData |
documentType |
"label" | "invoice" |
Returns
Promise<any>
Defined in
packages/medusa/dist/interfaces/fulfillment-service.d.ts:75
validateFulfillmentData
▸ validateFulfillmentData(optionData, data, cart): Promise<Record<string, unknown>>
Called before a shipping method is set on a cart to ensure that the data sent with the shipping method is valid. The data object may contain extra data about the shipment such as an id of a drop point. It is up to the fulfillment provider to enforce that the correct data is being sent through.
Parameters
| Name | Type |
|---|---|
optionData |
ShippingOptionData |
data |
FulfillmentProviderData |
cart |
Cart |
Returns
Promise<Record<string, unknown>>
the data to populate cart.shipping_methods.$.data this
is usually important for future actions like generating shipping labels
Defined in
packages/medusa/dist/interfaces/fulfillment-service.d.ts:34
validateOption
▸ validateOption(data): Promise<boolean>
Called before a shipping option is created in Admin. Use this to ensure that a fulfillment option does in fact exist.
Parameters
| Name | Type |
|---|---|
data |
ShippingOptionData |
Returns
Promise<boolean>
Defined in
packages/medusa/dist/interfaces/fulfillment-service.d.ts:39