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
244 lines
6.9 KiB
YAML
244 lines
6.9 KiB
YAML
title: Line Item
|
|
description: >-
|
|
Line Items are created when a product is added to a Cart. When Line Items are
|
|
purchased they will get copied to the resulting order, swap, or claim, and can
|
|
eventually be referenced in Fulfillments and Returns. Line items may also be
|
|
used for order edits.
|
|
type: object
|
|
required:
|
|
- allow_discounts
|
|
- cart_id
|
|
- claim_order_id
|
|
- created_at
|
|
- description
|
|
- fulfilled_quantity
|
|
- has_shipping
|
|
- id
|
|
- is_giftcard
|
|
- is_return
|
|
- metadata
|
|
- order_edit_id
|
|
- order_id
|
|
- original_item_id
|
|
- quantity
|
|
- returned_quantity
|
|
- shipped_quantity
|
|
- should_merge
|
|
- swap_id
|
|
- thumbnail
|
|
- title
|
|
- unit_price
|
|
- updated_at
|
|
- variant_id
|
|
properties:
|
|
id:
|
|
description: The line item's ID
|
|
type: string
|
|
example: item_01G8ZC9GWT6B2GP5FSXRXNFNGN
|
|
cart_id:
|
|
description: The ID of the cart that the line item may belongs to.
|
|
nullable: true
|
|
type: string
|
|
example: cart_01G8ZH853Y6TFXWPG5EYE81X63
|
|
cart:
|
|
description: The details of the cart that the line item may belongs to.
|
|
x-expandable: cart
|
|
nullable: true
|
|
type: object
|
|
order_id:
|
|
description: The ID of the order that the line item may belongs to.
|
|
nullable: true
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
order:
|
|
description: The details of the order that the line item may belongs to.
|
|
x-expandable: order
|
|
nullable: true
|
|
type: object
|
|
swap_id:
|
|
description: The ID of the swap that the line item may belong to.
|
|
nullable: true
|
|
type: string
|
|
example: null
|
|
swap:
|
|
description: The details of the swap that the line item may belong to.
|
|
x-expandable: swap
|
|
nullable: true
|
|
type: object
|
|
claim_order_id:
|
|
description: The ID of the claim that the line item may belong to.
|
|
nullable: true
|
|
type: string
|
|
example: null
|
|
claim_order:
|
|
description: The details of the claim that the line item may belong to.
|
|
x-expandable: claim_order
|
|
nullable: true
|
|
type: object
|
|
tax_lines:
|
|
description: The details of the item's tax lines.
|
|
x-expandable: tax_lines
|
|
type: array
|
|
items:
|
|
$ref: ./LineItemTaxLine.yaml
|
|
adjustments:
|
|
description: >-
|
|
The details of the item's adjustments, which are available when a discount
|
|
is applied on the item.
|
|
x-expandable: adjustments
|
|
type: array
|
|
items:
|
|
$ref: ./LineItemAdjustment.yaml
|
|
original_item_id:
|
|
description: >-
|
|
The ID of the original line item. This is useful if the line item belongs
|
|
to a resource that references an order, such as a return or an order edit.
|
|
nullable: true
|
|
type: string
|
|
order_edit_id:
|
|
description: The ID of the order edit that the item may belong to.
|
|
nullable: true
|
|
type: string
|
|
order_edit:
|
|
description: The details of the order edit.
|
|
x-expandable: order_edit
|
|
nullable: true
|
|
type: object
|
|
title:
|
|
description: The title of the Line Item.
|
|
type: string
|
|
example: Medusa Coffee Mug
|
|
description:
|
|
description: A more detailed description of the contents of the Line Item.
|
|
nullable: true
|
|
type: string
|
|
example: One Size
|
|
thumbnail:
|
|
description: A URL string to a small image of the contents of the Line Item.
|
|
nullable: true
|
|
type: string
|
|
format: uri
|
|
example: https://medusa-public-images.s3.eu-west-1.amazonaws.com/coffee-mug.png
|
|
is_return:
|
|
description: Is the item being returned
|
|
type: boolean
|
|
default: false
|
|
is_giftcard:
|
|
description: Flag to indicate if the Line Item is a Gift Card.
|
|
type: boolean
|
|
default: false
|
|
should_merge:
|
|
description: >-
|
|
Flag to indicate if new Line Items with the same variant should be merged
|
|
or added as an additional Line Item.
|
|
type: boolean
|
|
default: true
|
|
allow_discounts:
|
|
description: >-
|
|
Flag to indicate if the Line Item should be included when doing discount
|
|
calculations.
|
|
type: boolean
|
|
default: true
|
|
has_shipping:
|
|
description: Flag to indicate if the Line Item has fulfillment associated with it.
|
|
nullable: true
|
|
type: boolean
|
|
example: false
|
|
unit_price:
|
|
description: >-
|
|
The price of one unit of the content in the Line Item. This should be in
|
|
the currency defined by the Cart/Order/Swap/Claim that the Line Item
|
|
belongs to.
|
|
type: integer
|
|
example: 8000
|
|
variant_id:
|
|
description: The id of the Product Variant contained in the Line Item.
|
|
nullable: true
|
|
type: string
|
|
example: variant_01G1G5V2MRX2V3PVSR2WXYPFB6
|
|
variant:
|
|
description: The details of the product variant that this item was created from.
|
|
x-expandable: variant
|
|
nullable: true
|
|
$ref: ./ProductVariant.yaml
|
|
quantity:
|
|
description: The quantity of the content in the Line Item.
|
|
type: integer
|
|
example: 1
|
|
fulfilled_quantity:
|
|
description: The quantity of the Line Item that has been fulfilled.
|
|
nullable: true
|
|
type: integer
|
|
example: 0
|
|
returned_quantity:
|
|
description: The quantity of the Line Item that has been returned.
|
|
nullable: true
|
|
type: integer
|
|
example: 0
|
|
shipped_quantity:
|
|
description: The quantity of the Line Item that has been shipped.
|
|
nullable: true
|
|
type: integer
|
|
example: 0
|
|
refundable:
|
|
description: >-
|
|
The amount that can be refunded from the given Line Item. Takes taxes and
|
|
discounts into consideration.
|
|
type: integer
|
|
example: 0
|
|
subtotal:
|
|
description: The subtotal of the line item
|
|
type: integer
|
|
example: 8000
|
|
tax_total:
|
|
description: The total of tax of the line item
|
|
type: integer
|
|
example: 0
|
|
total:
|
|
description: The total amount of the line item
|
|
type: integer
|
|
example: 8000
|
|
original_total:
|
|
description: The original total amount of the line item
|
|
type: integer
|
|
example: 8000
|
|
original_tax_total:
|
|
description: The original tax total amount of the line item
|
|
type: integer
|
|
example: 0
|
|
discount_total:
|
|
description: The total of discount of the line item rounded
|
|
type: integer
|
|
example: 0
|
|
raw_discount_total:
|
|
description: The total of discount of the line item
|
|
type: integer
|
|
example: 0
|
|
gift_card_total:
|
|
description: The total of the gift card of the line item
|
|
type: integer
|
|
example: 0
|
|
includes_tax:
|
|
description: Indicates if the line item unit_price include tax
|
|
x-featureFlag: tax_inclusive_pricing
|
|
type: boolean
|
|
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
|
|
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
|