658339767b
Co-authored-by: olivermrbl <olivermrbl@users.noreply.github.com> Co-authored-by: Shahed Nasser <shahednasser@gmail.com>
152 lines
4.4 KiB
YAML
152 lines
4.4 KiB
YAML
title: Fulfillment
|
|
description: >-
|
|
A Fulfillment is created once an admin can prepare the purchased goods.
|
|
Fulfillments will eventually be shipped and hold information about how to
|
|
track shipments. Fulfillments are created through a fulfillment provider,
|
|
which typically integrates a third-party shipping service. Fulfillments can be
|
|
associated with orders, claims, swaps, and returns.
|
|
type: object
|
|
required:
|
|
- canceled_at
|
|
- claim_order_id
|
|
- created_at
|
|
- data
|
|
- id
|
|
- idempotency_key
|
|
- location_id
|
|
- metadata
|
|
- no_notification
|
|
- order_id
|
|
- provider_id
|
|
- shipped_at
|
|
- swap_id
|
|
- tracking_numbers
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
description: The fulfillment's ID
|
|
type: string
|
|
example: ful_01G8ZRTMQCA76TXNAT81KPJZRF
|
|
claim_order_id:
|
|
description: The ID of the Claim that the Fulfillment belongs to.
|
|
nullable: true
|
|
type: string
|
|
example: null
|
|
claim_order:
|
|
description: The details of the claim that the fulfillment may belong to.
|
|
x-expandable: claim_order
|
|
nullable: true
|
|
type: object
|
|
swap_id:
|
|
description: The ID of the Swap that the Fulfillment belongs to.
|
|
nullable: true
|
|
type: string
|
|
example: null
|
|
swap:
|
|
description: The details of the swap that the fulfillment may belong to.
|
|
x-expandable: swap
|
|
nullable: true
|
|
type: object
|
|
order_id:
|
|
description: The ID of the Order that the Fulfillment belongs to.
|
|
nullable: true
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
order:
|
|
description: The details of the order that the fulfillment may belong to.
|
|
x-expandable: order
|
|
nullable: true
|
|
type: object
|
|
provider_id:
|
|
description: >-
|
|
The ID of the Fulfillment Provider responsible for handling the
|
|
fulfillment.
|
|
type: string
|
|
example: manual
|
|
provider:
|
|
description: >-
|
|
The details of the fulfillment provider responsible for handling the
|
|
fulfillment.
|
|
x-expandable: provider
|
|
nullable: true
|
|
$ref: ./FulfillmentProvider.yaml
|
|
location_id:
|
|
description: The ID of the stock location the fulfillment will be shipped from
|
|
nullable: true
|
|
type: string
|
|
example: sloc_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
items:
|
|
description: >-
|
|
The Fulfillment Items in the Fulfillment. These hold information about how
|
|
many of each Line Item has been fulfilled.
|
|
type: array
|
|
x-expandable: items
|
|
items:
|
|
$ref: ./FulfillmentItem.yaml
|
|
tracking_links:
|
|
description: >-
|
|
The Tracking Links that can be used to track the status of the
|
|
Fulfillment. These will usually be provided by the Fulfillment Provider.
|
|
type: array
|
|
x-expandable: tracking_links
|
|
items:
|
|
$ref: ./TrackingLink.yaml
|
|
tracking_numbers:
|
|
description: >-
|
|
The tracking numbers that can be used to track the status of the
|
|
fulfillment.
|
|
deprecated: true
|
|
type: array
|
|
items:
|
|
type: string
|
|
data:
|
|
description: >-
|
|
This contains all the data necessary for the Fulfillment provider to
|
|
handle the fulfillment.
|
|
type: object
|
|
example: {}
|
|
shipped_at:
|
|
description: The date with timezone at which the Fulfillment was shipped.
|
|
nullable: true
|
|
type: string
|
|
format: date-time
|
|
no_notification:
|
|
description: >-
|
|
Flag for describing whether or not notifications related to this should be
|
|
sent.
|
|
nullable: true
|
|
type: boolean
|
|
example: false
|
|
canceled_at:
|
|
description: The date with timezone at which the Fulfillment was canceled.
|
|
nullable: true
|
|
type: string
|
|
format: date-time
|
|
idempotency_key:
|
|
description: >-
|
|
Randomly generated key used to continue the completion of the fulfillment
|
|
in case of failure.
|
|
nullable: true
|
|
type: string
|
|
externalDocs:
|
|
url: https://docs.medusajs.com/development/idempotency-key/overview.md
|
|
description: Learn more how to use the idempotency key.
|
|
created_at:
|
|
description: The date with timezone at which the resource was created.
|
|
type: string
|
|
format: date-time
|
|
updated_at:
|
|
description: The date with timezone at which the resource was updated.
|
|
type: string
|
|
format: date-time
|
|
metadata:
|
|
description: An optional key-value map with additional details
|
|
nullable: true
|
|
type: object
|
|
example:
|
|
car: white
|
|
externalDocs:
|
|
description: Learn about the metadata attribute, and how to delete and update it.
|
|
url: >-
|
|
https://docs.medusajs.com/development/entities/overview#metadata-attribute
|