☰ Meniu · Catalog
Catalog
Produsele tale și categoriile lor, pentru regulile de cashback pe categorii și rapoartele de produse.
/v1/catalog/products/bulkCreează sau actualizează până la 1000 de produse după sku. Un cod de categorie nou creează o categorie cu regulile implicite (acordă cashback, se poate plăti cu cashback). category_name redenumește categoria; regulile ei de bani le setează doar proprietarul.
- products[].skustring, obligatoriu
- Codul tău de produs, unic per local.
- products[].namestring
- Denumirea produsului.
- products[].categorystring
- Codul tău de categorie.
- products[].category_namestring
- Denumirea categoriei afișată proprietarului.
- products[].priceinteger
- Prețul, în subunități.
- products[].activeboolean
- Implicit 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/productsProdusele, sortate după sku. Filtre: ?category=, ?sku=. Cu paginare; starting_after primește un sku.
Fiecare produs are rules: regula proprietarului peste categorie, setată în pagina Produse. earn, redeem și earn_percent sunt null acolo unde se aplică categoria; from și until delimitează o promoție. API-ul citește aceste reguli și nu le schimbă.
/v1/catalog/categoriesToate categoriile, cu regulile proprietarului: earn, redeem, earn_percent (null înseamnă nivelul oaspetelui).
{
"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-rulesRegulile locațiilor: procent, acumulare și achitare, coduri de casă și excepțiile locației pentru categorii (type: "category", code categoriei) și produse (type: "product", sku). null într-o excepție înseamnă „ca în regulile generale”. Doar citire: proprietarul le setează în pagina Locații. Un local fără reguli pe locații returnează o listă goală.