xclade
Admin APIProducts

Associate Variant with Inventory Item

Associate with a product variant an inventory item that manages its inventory details.

POST
/admin/products/{id}/variants/{variant_id}/inventory-items
AuthorizationBearer <token>

In: header

Path Parameters

id*string

The product's ID.

variant_id*string

The variant's ID.

Query Parameters

fields?string

Comma-separated fields that should be included in the returned data. if a field is prefixed with + it will be added to the default fields, using - will remove it from the default fields. without prefix it will replace the entire default fields.

Request Body

application/json

required_quantity*number

The quantity of the variant in the inventory item.

inventory_item_id*string

The inventory item's ID.

Response Body

application/json

application/json

text/plain

application/json

application/json

application/json

application/json

curl -X POST "https://{tenant}.api.myxclade.com/admin/products/string/variants/string/inventory-items" \  -H "Content-Type: application/json" \  -d '{    "required_quantity": 0,    "inventory_item_id": "string"  }'
{
  "variant": {
    "prices": [
      {
        "id": "string",
        "title": "string",
        "currency_code": "usd",
        "amount": 0,
        "raw_amount": {},
        "min_quantity": 0,
        "max_quantity": 0,
        "price_set_id": "string",
        "created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z",
        "deleted_at": "2019-08-24T14:15:22Z"
      }
    ],
    "id": "string",
    "title": "string",
    "sku": "string",
    "barcode": "string",
    "ean": "string",
    "upc": "string",
    "allow_backorder": true,
    "manage_inventory": true,
    "inventory_quantity": 0,
    "hs_code": "string",
    "origin_country": "string",
    "mid_code": "string",
    "material": "string",
    "weight": 0,
    "length": 0,
    "height": 0,
    "width": 0,
    "variant_rank": 0,
    "options": [
      {
        "id": "string",
        "value": "string",
        "option": {
          "id": "string",
          "title": "string",
          "product": {},
          "product_id": "string",
          "values": [
            {}
          ],
          "metadata": {},
          "created_at": "2019-08-24T14:15:22Z",
          "updated_at": "2019-08-24T14:15:22Z",
          "deleted_at": "2019-08-24T14:15:22Z"
        },
        "option_id": "string",
        "metadata": {},
        "created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z",
        "deleted_at": "2019-08-24T14:15:22Z"
      }
    ],
    "product": {},
    "product_id": "string",
    "calculated_price": {
      "id": "string",
      "is_calculated_price_price_list": true,
      "is_calculated_price_tax_inclusive": true,
      "calculated_amount": 0,
      "calculated_amount_with_tax": 0,
      "calculated_amount_without_tax": 0,
      "is_original_price_price_list": true,
      "is_original_price_tax_inclusive": true,
      "original_amount": 0,
      "currency_code": "usd",
      "calculated_price": {},
      "original_price": {},
      "original_amount_with_tax": 0,
      "original_amount_without_tax": 0
    },
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "deleted_at": "2019-08-24T14:15:22Z",
    "metadata": {},
    "inventory_items": [
      {
        "id": "string",
        "variant_id": "string",
        "variant": {},
        "inventory_item_id": "string",
        "inventory": {
          "id": "string",
          "sku": "string",
          "origin_country": "string",
          "hs_code": "string",
          "requires_shipping": true,
          "mid_code": "string",
          "material": "string",
          "weight": 0,
          "length": 0,
          "height": 0,
          "width": 0,
          "title": "string",
          "description": "string",
          "thumbnail": "string",
          "metadata": {},
          "location_levels": [
            {
              "id": "string",
              "created_at": "2019-08-24T14:15:22Z",
              "updated_at": "2019-08-24T14:15:22Z",
              "deleted_at": "2019-08-24T14:15:22Z",
              "inventory_item_id": "string",
              "location_id": "string",
              "stocked_quantity": 0,
              "reserved_quantity": 0,
              "incoming_quantity": 0,
              "metadata": {},
              "inventory_item": {},
              "available_quantity": 0
            }
          ]
        },
        "required_quantity": 0
      }
    ]
  }
}

{
  "message": "Discount must be set to dynamic",
  "type": "not_allowed"
}

"Unauthorized"
{
  "message": "Entity with id 1 was not found",
  "type": "not_found"
}
{
  "code": "unknown_error",
  "message": "The request conflicted with another request. You may retry the request with the provided Idempotency-Key.",
  "type": "QueryRunnerAlreadyReleasedError"
}
{
  "code": "invalid_request_error",
  "message": "Discount with code TEST already exists.",
  "type": "duplicate_error"
}

{
  "code": "api_error",
  "message": "An error occured while hashing password",
  "type": "database_error"
}