Каталог товаров и складские остатки
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.