asyavee/medusa-store
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

docs: general fixes to cart and order concept docs (#13270)

Browse Source
This commit is contained in:
Shahed Nasser
2025-08-21 19:09:01 +03:00
committed by GitHub
parent e7b45f5fde
commit 25ed42f740
10 changed files with 367 additions and 121 deletions
Download Patch File Download Diff File Expand all files Collapse all files
www/apps/resources/app/commerce-modules/fulfillment/item-fulfillment/page.mdx
+13 -11
View File
@@ -1,28 +1,30 @@
export const metadata = {
title: `Item Fulfillment`,
title: `Item Fulfillment Concepts`,
}
# {metadata.title}
In this document, you’ll learn about the concepts of item fulfillment.
In this document, you’ll learn about the concepts related to item fulfillment.
## Fulfillment Data Model
A fulfillment is the shipping and delivery of one or more items to the customer. It’s represented by the [Fulfillment data model](/references/fulfillment/models/Fulfillment).
A fulfillment can be created to fulfill orders, [returns](../../order/return/), [exchanges](../../order/exchange/page.mdx), and [claims](../../order/claim/page.mdx).
---
## Fulfillment Processing by a Fulfillment Provider
A fulfillment is associated with a fulfillment provider that handles all its processing, such as creating a shipment for the fulfillment’s items.
A fulfillment is associated with a [fulfillment provider](../fulfillment-provider/page.mdx) that handles all its processing, such as creating a shipment for the fulfillment’s items.
The fulfillment is also associated with a shipping option of that provider, which determines how the item is shipped.
The fulfillment is also associated with a [shipping option](../shipping-option/page.mdx) of that provider, which determines how the item is shipped.
![A diagram showcasing the relation between a fulfillment, fulfillment provider, and shipping option](https://res.cloudinary.com/dza7lstvk/image/upload/v1712331947/Medusa%20Resources/fulfillment-shipping-option_jk9ndp.jpg)
---
## data Property
## data Property of Fulfillment Data Model
The `Fulfillment` data model has a `data` property that holds any necessary data for the third-party fulfillment provider to process the fulfillment.
@@ -32,7 +34,7 @@ For example, the `data` property can hold the ID of the fulfillment in the third
## Fulfillment Items
A fulfillment is used to fulfill one or more items. Each item is represented by the `FulfillmentItem` data model.
A fulfillment is used to fulfill one or more items. Each item is represented by the [FulfillmentItem data model](/references/fulfillment/models/FulfillmentItem).
The fulfillment item holds details relevant to fulfilling the item, such as barcode, SKU, and quantity to fulfill.
@@ -42,14 +44,14 @@ The fulfillment item holds details relevant to fulfilling the item, such as barc
## Fulfillment Label
Once a shipment is created for the fulfillment, you can store its tracking number, URL, or other related details as a label, represented by the `FulfillmentLabel` data model.
Once a shipment is created for the fulfillment, you can store its tracking number, URL, or other related details as a label, represented by the [FulfillmentLabel data model](/references/fulfillment/models/FulfillmentLabel).
---
## Fulfillment Status
The `Fulfillment` data model has three properties to keep track of the current status of the fulfillment:
The [Fulfillment data model](/references/fulfillment/models/Fulfillment) has three properties to determine the current status of the fulfillment:
- `packed_at`: The date the fulfillment was packed. If set, then the fulfillment has been packed.
- `shipped_at`: The date the fulfillment was shipped. If set, then the fulfillment has been shipped.
- `delivered_at`: The date the fulfillment was delivered. If set, then the fulfillment has been delivered.
- `packed_at`: The date the fulfillment was packed. If set, the fulfillment has been packed.
- `shipped_at`: The date the fulfillment was shipped. If set, the fulfillment has been shipped.
- `delivered_at`: The date the fulfillment was delivered. If set, the fulfillment has been delivered.