Κατάλογος

Τα προϊόντα σας και οι κατηγορίες τους, για τους κανόνες cashback ανά κατηγορία και τις αναφορές προϊόντων.

POST/v1/catalog/products/bulk

Δικαίωμα: catalog:write

Δημιουργεί ή ενημερώνει έως 1000 προϊόντα με βάση το sku. Ένας νέος κωδικός κατηγορίας δημιουργεί κατηγορία με τους προεπιλεγμένους κανόνες (δίνει cashback, πληρώνεται με cashback). Το category_name μετονομάζει την κατηγορία· τους κανόνες χρημάτων της τους ορίζει μόνο ο ιδιοκτήτης.

products[].skustring, υποχρεωτικό: Ο κωδικός του προϊόντος σας, μοναδικός ανά επιχείρηση.
products[].namestring: Όνομα προϊόντος.
products[].categorystring: Ο κωδικός κατηγορίας σας.
products[].category_namestring: Όνομα κατηγορίας που βλέπει ο ιδιοκτήτης.
products[].priceinteger: Τιμή, στη μικρότερη υποδιαίρεση.
products[].activeboolean: Προεπιλογή true.

Παράμετρος	Τύπος	Περιγραφή
products[].sku	string, υποχρεωτικό	Ο κωδικός του προϊόντος σας, μοναδικός ανά επιχείρηση.
products[].name	string	Όνομα προϊόντος.
products[].category	string	Ο κωδικός κατηγορίας σας.
products[].category_name	string	Όνομα κατηγορίας που βλέπει ο ιδιοκτήτης.
products[].price	integer	Τιμή, στη μικρότερη υποδιαίρεση.
products[].active	boolean	Προεπιλογή true.

curl

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 }

GET/v1/catalog/products

Δικαίωμα: catalog:read ή catalog:write

Τα προϊόντα ταξινομημένα κατά sku. Φίλτρα: ?category=, ?sku=. Με σελιδοποίηση· το starting_after δέχεται sku.

GET/v1/catalog/categories

Δικαίωμα: catalog:read ή catalog:write

Όλες οι κατηγορίες με τους κανόνες του ιδιοκτήτη: earn, redeem, earn_percent (null σημαίνει το επίπεδο του πελάτη).

Απάντηση · 200

{
  "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, ... }
  ]
}