☰ Меню · Каталог
Каталог
Ваши товары и их категории для правил кэшбэка по категориям и товарных отчётов.
/v1/catalog/products/bulkСоздаёт или обновляет до 1000 товаров по sku. Новый код категории создаёт категорию с правилами по умолчанию (начисляет кэшбэк, можно оплатить кэшбэком). category_name переименовывает категорию, а её денежные правила задаёт только владелец.
- products[].skustring, обязательный
- Ваш код товара, уникальный в пределах заведения.
- products[].namestring
- Название товара.
- products[].categorystring
- Ваш код категории.
- products[].category_namestring
- Название категории, которое увидит владелец.
- products[].priceinteger
- Цена в минимальных единицах.
- products[].activeboolean
- По умолчанию true.
curl https://loyaltyfy.io/api/v1/catalog/products/bulk \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
"products": [
{ "sku": "4840001", "name": "Marlboro Gold", "category": "TOB", "category_name": "Tobacco", "price": 6500 },
{ "sku": "1001", "name": "Latte", "category": "COF", "category_name": "Coffee", "price": 4500 },
{ "sku": "2040", "name": "Zeama", "category": "KIT", "category_name": "Kitchen", "price": 6500 }
]
}'
# { "object": "catalog_sync", "upserted": 3 }/v1/catalog/productsТовары, отсортированные по sku. Фильтры: ?category=, ?sku=. Поддерживает пагинацию, starting_after принимает sku.
У каждого товара есть rules: правило владельца поверх категории, заданное на странице «Товары». earn, redeem и earn_percent равны null там, где действует категория; from и until ограничивают акцию. API читает эти правила и не меняет их.
/v1/catalog/categoriesВсе категории с правилами владельца: earn, redeem, earn_percent (null означает процент по уровню гостя).
{
"object": "list",
"url": "/v1/catalog/categories",
"has_more": false,
"data": [
{ "object": "catalog_category", "code": "COF", "name": "Coffee", "earn": true, "redeem": true, "earn_percent": 10, ... },
{ "object": "catalog_category", "code": "TOB", "name": "Tobacco", "earn": false, "redeem": false, "earn_percent": null, ... }
]
}/v1/catalog/location-rulesПравила точек: процент, начисление и списание, коды касс и исключения точки для категорий (type: "category", code категории) и товаров (type: "product", sku). null в исключении значит «как в общих правилах». Только чтение: правила задаёт владелец в разделе Точки. Если у заведения нет правил по точкам, список пуст.