ДокументацияКаталог товаров и складские остатки

Каталог товаров и складские остатки

5 минПоследнее обновление: 2026-03-31

Создание каталога

Каталог товаров является контейнером для всех ваших товаров. У каждого каталога есть название, необязательное описание и валюта. Создайте каталог в панели управления или через API:

POST /api/v1/commerce/catalogs
{
  "name": "PetCenter Serbia",
  "description": "Pet food and accessories",
  "currency": "RSD"
}

Каталог принадлежит группе. В конфигурациях для нескольких стран используется отдельный каталог на каждую страну с местной валютой.

Добавление товаров

Каждый товар содержит:

  • name: название товара
  • sku: уникальный артикул (SKU)
  • price: базовая цена в валюте каталога
  • variants: JSON-массив вариантов (размер, цвет, вкус и т. д.)
  • images: массив URL изображений
  • description: описание товара (используется AI-ассистентом покупателя)
  • status: active, draft или archived
POST /api/v1/commerce/catalogs/:catalogId/products
{
  "name": "Premium Dog Food",
  "sku": "PDF-001",
  "price": 2450,
  "variants": [
    { "name": "size", "options": ["2kg", "5kg", "10kg"] }
  ],
  "images": ["https://..."],
  "description": "High-protein dry food for adult dogs"
}

Управление складскими остатками

Для учета остатков используются атомарные операции (SELECT...FOR UPDATE), которые исключают продажу сверх наличия:

  • Set inventory: установить абсолютное количество товара на складе
  • Adjust inventory: увеличить или уменьшить остаток (положительная/отрицательная дельта)
  • Check inventory: получить текущий остаток
  • Transfer: переместить товар между точками/складами
POST /api/v1/commerce/inventory/adjust
{
  "product_id": 123,
  "delta": -5,
  "reason": "Manual adjustment"
}

Уведомления о низком остатке и импорт CSV

Задайте порог низкого остатка для каждого товара. Когда остаток опускается ниже порога, срабатывает триггер воркфлоу low_stock. Товары также можно массово импортировать из CSV со столбцами: name, sku, price, description, quantity.

Была ли эта статья полезна?