fa7c94b4cc
* docs: migrate ui docs to docs universe * created yarn workspace * added eslint and tsconfig configurations * fix eslint configurations * fixed eslint configurations * shared tailwind configurations * added shared ui package * added more shared components * migrating more components * made details components shared * move InlineCode component * moved InputText * moved Loading component * Moved Modal component * moved Select components * Moved Tooltip component * moved Search components * moved ColorMode provider * Moved Notification components and providers * used icons package * use UI colors in api-reference * moved Navbar component * used Navbar and Search in UI docs * added Feedback to UI docs * general enhancements * fix color mode * added copy colors file from ui-preset * added features and enhancements to UI docs * move Sidebar component and provider * general fixes and preparations for deployment * update docusaurus version * adjusted versions * fix output directory * remove rootDirectory property * fix yarn.lock * moved code component * added vale for all docs MD and MDX * fix tests * fix vale error * fix deployment errors * change ignore commands * add output directory * fix docs test * general fixes * content fixes * fix announcement script * added changeset * fix vale checks * added nofilter option * fix vale error
138 lines
4.2 KiB
YAML
138 lines
4.2 KiB
YAML
title: Shipping Option
|
|
description: >-
|
|
A Shipping Option represents a way in which an Order or Return can be shipped.
|
|
Shipping Options have an associated Fulfillment Provider that will be used
|
|
when the fulfillment of an Order is initiated. Shipping Options themselves
|
|
cannot be added to Carts, but serve as a template for Shipping Methods. This
|
|
distinction makes it possible to customize individual Shipping Methods with
|
|
additional information.
|
|
type: object
|
|
required:
|
|
- admin_only
|
|
- amount
|
|
- created_at
|
|
- data
|
|
- deleted_at
|
|
- id
|
|
- is_return
|
|
- metadata
|
|
- name
|
|
- price_type
|
|
- profile_id
|
|
- provider_id
|
|
- region_id
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
description: The shipping option's ID
|
|
type: string
|
|
example: so_01G1G5V27GYX4QXNARRQCW1N8T
|
|
name:
|
|
description: >-
|
|
The name given to the Shipping Option - this may be displayed to the
|
|
Customer.
|
|
type: string
|
|
example: PostFake Standard
|
|
region_id:
|
|
description: The ID of the region this shipping option can be used in.
|
|
type: string
|
|
example: reg_01G1G5V26T9H8Y0M4JNE3YGA4G
|
|
region:
|
|
description: The details of the region this shipping option can be used in.
|
|
x-expandable: region
|
|
nullable: true
|
|
type: object
|
|
profile_id:
|
|
description: The ID of the Shipping Profile that the shipping option belongs to.
|
|
type: string
|
|
example: sp_01G1G5V239ENSZ5MV4JAR737BM
|
|
profile:
|
|
description: The details of the shipping profile that the shipping option belongs to.
|
|
x-expandable: profile
|
|
nullable: true
|
|
$ref: ./ShippingProfile.yaml
|
|
provider_id:
|
|
description: >-
|
|
The ID of the fulfillment provider that will be used to later to process
|
|
the shipping method created from this shipping option and its
|
|
fulfillments.
|
|
type: string
|
|
example: manual
|
|
provider:
|
|
description: >-
|
|
The details of the fulfillment provider that will be used to later to
|
|
process the shipping method created from this shipping option and its
|
|
fulfillments.
|
|
x-expandable: provider
|
|
nullable: true
|
|
$ref: ./FulfillmentProvider.yaml
|
|
price_type:
|
|
description: >-
|
|
The type of pricing calculation that is used when creatin Shipping Methods
|
|
from the Shipping Option. Can be `flat_rate` for fixed prices or
|
|
`calculated` if the Fulfillment Provider can provide price calulations.
|
|
type: string
|
|
enum:
|
|
- flat_rate
|
|
- calculated
|
|
example: flat_rate
|
|
amount:
|
|
description: >-
|
|
The amount to charge for shipping when the Shipping Option price type is
|
|
`flat_rate`.
|
|
nullable: true
|
|
type: integer
|
|
example: 200
|
|
is_return:
|
|
description: Flag to indicate if the Shipping Option can be used for Return shipments.
|
|
type: boolean
|
|
default: false
|
|
admin_only:
|
|
description: >-
|
|
Flag to indicate if the Shipping Option usage is restricted to admin
|
|
users.
|
|
type: boolean
|
|
default: false
|
|
requirements:
|
|
description: >-
|
|
The details of the requirements that must be satisfied for the Shipping
|
|
Option to be available for usage in a Cart.
|
|
type: array
|
|
x-expandable: requirements
|
|
items:
|
|
$ref: ./ShippingOptionRequirement.yaml
|
|
data:
|
|
description: >-
|
|
The data needed for the Fulfillment Provider to identify the Shipping
|
|
Option.
|
|
type: object
|
|
example: {}
|
|
includes_tax:
|
|
description: Whether the shipping option price include tax
|
|
type: boolean
|
|
x-featureFlag: tax_inclusive_pricing
|
|
default: false
|
|
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
|
|
deleted_at:
|
|
description: The date with timezone at which the resource was deleted.
|
|
nullable: true
|
|
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
|