BigCommerce · Schema

productVariant_Put_Product

The model for a PUT to update variants on a product.

E-CommerceRetailCatalogOrdersCheckoutPaymentsSaaS

Properties

Name Type Description
cost_price number The cost price of the variant. Not affected by Price List prices.
price number This variant’s base price on the storefront. If a Price List ID is used, the Price List value will be used. If a Price List ID is not used, and this value is `null`, the product’s default price (set i
sale_price number This variant’s sale price on the storefront. If a Price List ID is used, the Price List value will be used. If a Price List ID is not used, and this value is null, the product’s sale price (set in the
retail_price number This variant’s retail price on the storefront. If a Price List ID is used, the Price List value will be used. If a Price List ID is not used, and this value is null, the product’s retail price (set in
weight number This variant’s base weight on the storefront. If this value is null, the product’s default weight (set in the Product resource’s weight field) will be used as the base weight.
width number Width of the variant, which can be used when calculating shipping costs. If this value is `null`, the productʼs default width (set in the Product resourceʼs `width` field) will be used as the base wid
height number Height of the variant, which can be used when calculating shipping costs. If this value is `null`, the productʼs default height (set in the Product resourceʼs `height` field) will be used as the base
depth number Depth of the variant, which can be used when calculating shipping costs. If this value is `null`, the productʼs default depth (set in the Product resourceʼs `depth` field) will be used as the base dep
is_free_shipping boolean Flag used to indicate whether the variant has free shipping. If `true`, the shipping cost for the variant will be zero.
fixed_cost_shipping_price number A fixed shipping cost for the variant. If defined, this value will be used during checkout instead of normal shipping-cost calculation.
purchasing_disabled boolean If `true`, this variant will not be purchasable on the storefront.
purchasing_disabled_message string If `purchasing_disabled` is `true`, this message should show on the storefront when the variant is selected.
upc string The UPC code used in feeds for shopping comparison sites and external channel integrations.
inventory_level integer Inventory level for the variant, which is used when the product’s inventory_tracking is set to `variant`. The Catalog API returns the inventory for only the default location. The inventory for a varia
inventory_warning_level integer When the variant hits this inventory level, it is considered low stock.
bin_picking_number string Identifies where in a warehouse the variant is located.
product_id integer Product ID
id integer Variant ID
sku string
View JSON Schema on GitHub

JSON Schema

bigcommerce-productvariant-put-product-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/productVariant_Put_Product",
  "title": "productVariant_Put_Product",
  "type": "object",
  "properties": {
    "cost_price": {
      "minimum": 0,
      "type": "number",
      "description": "The cost price of the variant. Not affected by Price List prices.",
      "format": "double",
      "nullable": true
    },
    "price": {
      "minimum": 0,
      "type": "number",
      "description": "This variant\u2019s base price on the storefront. If a Price List ID is used, the Price List value will be used. If a Price List ID is not used, and this value is `null`, the product\u2019s default price (set in the Product resource\u2019s `price` field) will be used as the base price.",
      "format": "double",
      "nullable": true
    },
    "sale_price": {
      "minimum": 0,
      "type": "number",
      "description": "This variant\u2019s sale price on the storefront. If a Price List ID is used, the Price List value will be used. If a Price List ID is not used, and this value is null, the product\u2019s sale price (set in the Product resource\u2019s `price` field) will be used as the sale price.",
      "format": "double",
      "nullable": true
    },
    "retail_price": {
      "minimum": 0,
      "type": "number",
      "description": "This variant\u2019s retail price on the storefront. If a Price List ID is used, the Price List value will be used. If a Price List ID is not used, and this value is null, the product\u2019s retail price (set in the Product resource\u2019s `price` field) will be used as the retail price.",
      "format": "double",
      "nullable": true
    },
    "weight": {
      "minimum": 0,
      "type": "number",
      "description": "This variant\u2019s base weight on the storefront. If this value is null, the product\u2019s default weight (set in the Product resource\u2019s weight field) will be used as the base weight.",
      "format": "double",
      "nullable": true
    },
    "width": {
      "minimum": 0,
      "type": "number",
      "description": "Width of the variant, which can be used when calculating shipping costs. If this value is `null`, the product\u02bcs default width (set in the Product resource\u02bcs `width` field) will be used as the base width.\n",
      "format": "double",
      "nullable": true
    },
    "height": {
      "minimum": 0,
      "type": "number",
      "description": "Height of the variant, which can be used when calculating shipping costs. If this value is `null`, the product\u02bcs default height (set in the Product resource\u02bcs `height` field) will be used as the base height.\n",
      "format": "double",
      "nullable": true
    },
    "depth": {
      "minimum": 0,
      "type": "number",
      "description": "Depth of the variant, which can be used when calculating shipping costs. If this value is `null`, the product\u02bcs default depth (set in the Product resource\u02bcs `depth` field) will be used as the base depth.\n",
      "format": "double",
      "nullable": true
    },
    "is_free_shipping": {
      "type": "boolean",
      "description": "Flag used to indicate whether the variant has free shipping. If `true`, the shipping cost for the variant will be zero.\n"
    },
    "fixed_cost_shipping_price": {
      "minimum": 0,
      "type": "number",
      "description": "A fixed shipping cost for the variant. If defined, this value will be used during checkout instead of normal shipping-cost calculation.\n",
      "format": "double",
      "nullable": true
    },
    "purchasing_disabled": {
      "type": "boolean",
      "description": "If `true`, this variant will not be purchasable on the storefront."
    },
    "purchasing_disabled_message": {
      "maxLength": 255,
      "minLength": 0,
      "type": "string",
      "description": "If `purchasing_disabled` is `true`, this message should show on the storefront when the variant is selected."
    },
    "upc": {
      "type": "string",
      "description": "The UPC code used in feeds for shopping comparison sites and external channel integrations.",
      "nullable": true
    },
    "inventory_level": {
      "type": "integer",
      "description": "Inventory level for the variant, which is used when the product\u2019s inventory_tracking is set to `variant`. The Catalog API returns the inventory for only the default location.\n                    \nThe inventory for a variant cannot exceed 2,147,483,647 in the catalog. The sum of the variant inventories, or the total inventory for a product, cannot exceed 2,147,483,647. \n                    \nIf you exceed the limit, the store sets the variant inventory to the limit if no other variant inventories are set. If other variant inventories are set, the store does not save the variant inventory rather than setting the variant inventory to the remaining limit.\n\nThe Catalog API handles limits in a different way than the Inventory API. For more information, see [Limit handling](/docs/store-operations/catalog/inventory-adjustments#limit-handling-in-inventory-versus-catalog-api). ",
      "nullable": true,
      "maximum": 2147483647
    },
    "inventory_warning_level": {
      "type": "integer",
      "description": "When the variant hits this inventory level, it is considered low stock.",
      "nullable": true,
      "maximum": 2147483647
    },
    "bin_picking_number": {
      "maxLength": 255,
      "minLength": 0,
      "type": "string",
      "description": "Identifies where in a warehouse the variant is located.",
      "nullable": true
    },
    "product_id": {
      "type": "integer",
      "description": "Product ID"
    },
    "id": {
      "type": "integer",
      "description": "Variant ID"
    },
    "sku": {
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    }
  },
  "description": "The model for a PUT to update variants on a product.\n",
  "required": [
    "product_id",
    "id"
  ],
  "x-internal": false
}