---
title: "line_item"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/sline/object/line-item'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/sline/object/line-item.md'
---

# line_item


    购物车、结账页或订单中一个商品行的详情信息。

    



## 属性

    <div>
    

        
<ObjectProperty
    name="discount_allocations"
    types={[<Mdx>array of [discount_allocation](https://developer.shopline.com/zh-hans-cn/docs/sline/object/discount-allocation.md)</Mdx>]}
>
<ObjectSummary>
商品行的折扣分配。

> **提示**
>
> 这里的折扣分配是指所有适用于商品行的订单级别的折扣分配。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="final_line_price"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>

商品行的合计价格，是扣除所有商品行级别的折扣优惠后的价格。


此值等于 `line_item.final_price` 与 `line_item.quantity` 的乘积。

> **提示**
>
> 可根据需要，使用 [money](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money.md) 、[money_with_currency](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money-with-currency.md) 或 [money_without_currency](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money-with-currency.md) filter 输出格式化的金额。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="final_price"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
商品行的商品单价，是扣除所有商品行级别的折扣优惠后的价格。

> **提示**
>
> 可根据需要，使用 [money](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money.md)、[money_with_currency](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money-with-currency.md) 或 [money_without_currency](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money-with-currency.md) filter 输出格式化的金额。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="fulfillments"
    types={[<Mdx>array of [fulfillment](https://developer.shopline.com/zh-hans-cn/docs/sline/object/fulfillment.md)</Mdx>]}
>
<ObjectSummary>

商品行的发货信息。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="gift_card"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
与商品行关联的商品款式是否支持礼品卡。
- `true`：支持
- `false`：不支持


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="image"
    types={[<Mdx>[image](https://developer.shopline.com/zh-hans-cn/docs/sline/object/image.md)</Mdx>]}
>
<ObjectSummary>
商品行的图片。

图片可以来自以下资源：
- 与商品行关联的商品款式图片
- 与商品行关联的商品特色图片（如果没有商品款式图片）
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="key"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
商品行的 key。


商品行的 key 是商品行的唯一标识符，由以下两部分（冒号分隔）组成：
- 与商品行关联的商品款式 ID
- 商品行的 ID
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="line_level_discount_allocations"
    types={[<Mdx>array of [discount_allocation](https://developer.shopline.com/zh-hans-cn/docs/sline/object/discount-allocation.md)</Mdx>]}
>
<ObjectSummary>
直接应用于商品行的折扣。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="line_level_total_discount"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
商品行的折扣总额。

> **提示**
>
> 可根据需要，使用 [money](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money.md)、[money_with_currency](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money-with-currency.md) 或 [money_without_currency](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money-with-currency.md) filter 输出格式化的金额。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="options_with_values"
    types={[<Mdx>array of [options_with_values](https://developer.shopline.com/zh-hans-cn/docs/sline/object/options-with-values.md)</Mdx>]}
>
<ObjectSummary>
商品行关联的商品款式的每个选项的名称和值。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="original_line_price"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
应用折扣前的商品行的合计价格。

此值等于 `line_item.original_price` 与 `line_item.quantity` 的乘积。

> **提示**
>
> 可根据需要，使用 [money](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money.md)、[money_with_currency](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money-with-currency.md) 或 [money_without_currency](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money-with-currency.md) filter 输出格式化的金额。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="original_price"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
应用折扣前的商品行单价。

> **提示**
>
> 可根据需要，使用 [money](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money.md)、[money_with_currency](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money-with-currency.md) 或 [money_without_currency](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money-with-currency.md) filter 输出格式化的金额。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="product_id"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
商品行的商品 ID。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="properties"
    types={[<Mdx>array of [line_item_property](https://developer.shopline.com/zh-hans-cn/docs/sline/object/line-item-property.md)</Mdx>]}
>
<ObjectSummary>
商品行的自定义属性。

一个自定义属性由一个键值对构成。可以通过以下方法获取客户输入信息作为自定义属性值：
- 商品表单中的自定义 `input` 元素。
- 购物车添加商品 Ajax API。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="quantity"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
商品行的商品数量。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="requires_shipping"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
与商品行关联的商品款式是否需要运费。
- `true`：需要
- `false`：不需要


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="selling_plan_allocation"
    types={[<Mdx>array of [selling_plan_allocation](https://developer.shopline.com/zh-hans-cn/docs/sline/object/selling-plan-allocation.md)</Mdx>]}
>
<ObjectSummary>
商品行关联的销售计划。如果没有则返回 `nil`。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="sku"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
与商品行关联的款式的 SKU。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="successfully_fulfilled_quantity"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>

商品行中已成功履约数量。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="taxable"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
商品是否为应税商品。
- `true`：应税商品
- `false`：非应税商品


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="url"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
与商品行关联的商品款式的相对 URL。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="url_to_remove"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
一个 URL，用于从购物车中删除一个商品行。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="variant_id"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
商品行关联的商品款式的 ID。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="vendor"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
与商品行关联的商品供应商。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="item_components"
    types={[<Mdx>array of [item_component](https://developer.shopline.com/zh-hans-cn/docs/sline/object/item-component.md)</Mdx>]}
>
<ObjectSummary>
套装商品的子商品行信息。


</ObjectSummary>
</ObjectProperty>
        
    
    </div>


