POST:product_variants.json
Commerce APIPOST:product_variants.json

POST:product_variants.json

Description

Create one or multiple variants.

Permission bit: "product_variants.create"

Topic: Product Variants

Query Parameters

product_id: String

Unique product identifier. See also: Unique Identifiers

Example: ?product_id=pd_EQzGqWoY


shop_id: String, required

Unique shop identifier. See also: Unique Identifiers

Example: ?shop_id=sh_EQzGqWoY

Request Body

Array of ProductVariantCreate

[
  {
    "attachment_id": "fi_EQzGqWoY",
    "barcode": "1234_pink",
    "bundle_line_items": [
      {
        "quantity": 0,
        "variant_id": "va_EQzGqWoY"
      }
    ],
    "cost_price": 150,
    "country_of_origin": "US",
    "currency_prices": [
      {
        "currency": "USD",
        "map_price": 190,
        "price": 190,
        "retail_price": 190,
        "tiered_pricing": {
          "model": "graduated",
          "tiers": [
            {
              "from": 1,
              "price": 1500,
              "to": 10
            }
          ]
        }
      }
    ],
    "custom_fields": [
      {
        "name": "",
        "value": ""
      }
    ],
    "discountable": false,
    "expiration_days": 5,
    "fulfillment_service": "manual",
    "grams": 200,
    "height": 200,
    "hs_code": "6404.19",
    "inventory_management": "automatic",
    "inventory_policy": "continue",
    "is_default": false,
    "length": 200,
    "map_price": 190,
    "max_downloads": 10,
    "media_files": [
      {
        "file_id": "fi_EQzGqWoY",
        "thumbnail_file_id": "fi_EQzGqWoY"
      }
    ],
    "options": [
      {
        "option_id": "size",
        "option_value_id": "small"
      }
    ],
    "position": 0,
    "price": 190,
    "pricing_overrides": [
      {
        "currency_prices": [
          null
        ],
        "map_price": 190,
        "price": 190,
        "price_list_id": "pl_EQzGqWoY",
        "retail_price": 190
      }
    ],
    "product_id": "pd_EQzGqWoY",
    "retail_price": 190,
    "sku": "IPOD2008PINK",
    "suppliers": [
      {
        "code": "2352345",
        "cost": 345,
        "inventory_location_id": "il_EQzGqWoY",
        "lead_time": 3600,
        "quantity": 50,
        "supplier_id": "su_EQzGqWoY"
      }
    ],
    "tax_class": "default",
    "taxable": true,
    "width": 200
  }
]

Response Body

Array of ProductVariant

Response Body Type

Loading module