# 6. Product

Product — Day-to-Day Catalog Operations

Manage products after onboarding: create new items, update a single product, and bulk-update prices.

NOTE: For the initial, full catalog import right after onboarding, use the Catalog folder. Product APIs are for routine operations.

Many bulk calls run as asynchronous, batched jobs (track via requestId/batchId; final summary via webhook).
Warehouse-aware where applicable.
Returns the standard response envelope.

# Endpoints

# Product Update — Stock & Variant Support Matrix

This section explains how API PATCH /partner/products/<external_product_id> handles updates to stock, variants, and warehouses.
The supported fields depend on whether the store has warehouse support enabled and whether the product has variants.

# Support Matrix

Store Type	Product Type	Supported Fields	Stock Location	Example
No Warehouses	Non-variant	`stock`	`listings.stock`	`{ "stock": 100 }`
No Warehouses	Variant	`variants`	`listing_variants.stock`	`{ "variants": { "items": [{ "sku": "SKU-1", "stock": 50 }] } }`
Has Warehouses	Non-variant	`warehouses`	`listing_warehouses`	`{ "warehouses": [{ "clientId": "wh_123", "stock": 50 }] }`
Has Warehouses	Variant	`variants + warehouses`	`listing_warehouses`	`{ "variants": { "items": [{ "sku": "SKU-1", "warehouses": [{ "clientId": "wh_123", "stock": 50 }] }] } }`

Example Scenarios

Simple store (no warehouses, no variants):
```
{
  "stock": 100
}
```

Fashion store (no warehouses, but with size/color variants):

{
  "variants": {
    "items": [
      {
        "sku": "SKU-1",
        "stock": 50
      }
    ]
  }
}

Multi-warehouse store (non-variant):

{
  "warehouses": [
    {
      "clientId": "wh_123",
      "stock": 50
    }
  ]
}

Multi-warehouse + variants (advanced):

{
  "variants": {
    "items": [
      {
        "sku": "SKU-1",
        "warehouses": [
          {
            "clientId": "wh_123",
            "stock": 50
          }
        ]
      }
    ]
  }
}