---
title: "ProductVariantInput"
description: "商品款式相关的输入字段。"
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/inputs/product-variant-input'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/inputs/product-variant-input.md'
---
# ProductVariantInput

商品款式相关的输入字段。

- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Input

## Input Fields

* `inventoryItem`

  [InventoryItemInput](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/inputs/inventory-item-input.md)

  商品款式对应的库存项输入信息。

* `taxable`

  [Boolean](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/boolean.md)

  表明商品款式是否需要收税。
  
  - `true`：需要收税。
  - `false`：不需要收税。
  
  默认值:`true`

* `inventoryPolicy`

  [ProductVariantInventoryPolicy](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/enums/product-variant-inventory-policy.md)

  表明商品款式是否允许超卖。

* `weight`

  [Float](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/float.md)

  款式的重量，要求大于 0，超过两位小数向上取整。

* `mediaId`

  [ID](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/id.md)

  商品款式关联媒体的唯一标识 ID。该字段用于在 Mutation 操作中关联或创建媒体。若商品未关联此媒体 ID，系统将自动把该 ID 对应的媒体同步至商品媒体库中。<br/>
  最大长度限制：64

* `inventoryQuantities`

  [[InventoryLevelInput!]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/inputs/inventory-level-input.md)

  商品款式下各存放地点的库存数量总和。该字段仅支持作为 `productVariantCreate` 突变接口的输入。

* `mediaSrc`

  [[String!]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  商品款式媒体的链接。

* `harmonizedSystemCode`

  [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  商品款式的海关协调编码（HS编码）或关税编码。

* `requiresShipping`

  [Boolean](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/boolean.md)

  表明商品款式是否需要运输。
  
  - `true`：需要运输。
  - `false`：不需要运输。
  
  默认值：`true`

* `price`

  [Money](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/money.md)

  商品款式的售价，数值保留到小数点后两位。<br/>默认值：`0`

* `options`

  [[String!]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  商品款式规格信息。

* `id`

  [ID](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/id.md)

  商品款式的唯一标识 ID，用于指定待更新的商品款式。若该商品款式不存在，则系统将创建新的商品款式。<br/>
  最大长度限制：64

* `sku`

  [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  商家为款式自定义的标识。<br/>
  最大长度限制：255

* `barcode`

  [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  商品款式的条形码。<br/>
  最大长度限制：255

* `weightUnit`

  [WeightUnit](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/enums/weight-unit.md)

  商品款式的重量单位。

* `compareAtPrice`

  [Money](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/money.md)

  商品款式的原价，数值保留到小数点后两位。<br/>默认值: `0`

## Input field from

* [ProductInput](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/inputs/product-input.md).variants