☰ Меню · Каталог
Каталог
Ваші товари та їхні категорії для правил кешбеку за категоріями й товарних звітів.
/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 у винятку означає «як у загальних правилах». Лише читання: правила задає власник у розділі Точки. Якщо в закладу немає правил за точками, список порожній.