Meniu

Meniul QR al localului: categorii, preparate, modificatori, prețuri și stop-list.

Preparatele, categoriile și valorile modificatorilor pot avea external_id-ul tău (SKU-ul tău), unic per local. Oriunde o cale conține {item} sau {value}, poți folosi id-ul nostru sau external_id-ul tău. Denumirile și descrierile sunt obiecte pe limbi ({"ro": "Zeamă", "en": "Chicken soup"}); adaugă ?lang=en la orice GET ca să primești texte simple într-o singură limbă, cu revenire la limba principală a meniului.

GET/v1/menu

Permisiune: menu:read

Meniul întreg, ca arbore: categorii, preparatele lor, grupurile de modificatori și valorile fiecărui preparat. Categoriile și preparatele ascunse sunt omise, dacă nu adaugi ?include_hidden=true.

curl

curl "https://loyaltyfy.io/api/v1/menu?lang=en" \
  -H "Authorization: Bearer sk_test_..."

Răspuns · 200

{
  "object": "menu",
  "url": "https://loyaltyfy.io/m/your-venue",
  "published": true,
  "currency": "MDL",
  "primary_language": "ro",
  "languages": ["ru", "en"],
  "categories": [
    {
      "object": "menu_category",
      "id": "0b8e4c1d-6f0e-4b8a-9a55-3c1d2e7f9a10",
      "external_id": "CAT-COFFEE",
      "parent_id": null,
      "name": "Coffee",
      "emoji": null,
      "visible": true,
      "items": [
        {
          "object": "menu_item",
          "id": "a48343bd-9f6e-424a-b003-fe790617f4d6",
          "external_id": "1001",
          "category_id": "0b8e4c1d-6f0e-4b8a-9a55-3c1d2e7f9a10",
          "name": "Flat white",
          "description": "Double ristretto, steamed milk",
          "price": 4500,
          "old_price": null,
          "currency": "MDL",
          "available": true,
          "visible": true,
          "photo_url": "https://...",
          "options": [
            {
              "object": "option_group",
              "id": "5c2f...",
              "kind": "addon",
              "name": "Milk",
              "min_select": 0,
              "max_select": 1,
              "values": [
                {
                  "object": "option_value",
                  "id": "9e41...",
                  "external_id": "MOD-OAT",
                  "name": "Oat milk",
                  "price_delta": 800,
                  "available": true,
                  "default": false
                }
              ]
            }
          ],
          "updated_at": "2026-10-06T09:12:44.120+00:00"
        }
      ]
    }
  ]
}

GET/v1/menu/items

Permisiune: menu:read

O listă plată de preparate, fără modificatori, până la 1000, în ordinea din meniu. Filtre: ?external_id= pentru un SKU, ?available=false pentru stop-listul curent, ?lang=.

GET/v1/menu/items/{item}

Permisiune: menu:read

Un preparat, cu modificatorii lui.

POST/v1/menu/items

Permisiune: menu:write

Adaugă un preparat. Cu external_id, apelul poate fi repetat în siguranță: un preparat existent cu acel external_id este întors cu 200.

categorystring, obligatoriu: Id-ul categoriei sau external_id-ul categoriei. O valoare necunoscută creează o categorie cu acest nume.
nameobject, obligatoriu: Denumirea pe limbi, cel puțin una.
priceinteger, obligatoriu: În subunități.
external_idstring: SKU-ul tău.
descriptionobject: Pe limbi.
available, visibleboolean: Implicit true.

Parametru	Tip	Descriere
category	string, obligatoriu	Id-ul categoriei sau `external_id`-ul categoriei. O valoare necunoscută creează o categorie cu acest nume.
name	object, obligatoriu	Denumirea pe limbi, cel puțin una.
price	integer, obligatoriu	În subunități.
external_id	string	SKU-ul tău.
description	object	Pe limbi.
available, visible	boolean	Implicit true.

curl

curl https://loyaltyfy.io/api/v1/menu/items \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "category": "CAT-SOUPS",
    "external_id": "2040",
    "name": { "ro": "Zeamă", "ru": "Зама", "en": "Chicken soup" },
    "price": 6500
  }'

PATCH/v1/menu/items/{item}

Permisiune: menu:write

Schimbă price, old_price (afișat tăiat), available, visible, external_id, name sau description. Trimite menu.updated.

curl

# the kitchen ran out: hide the "+" button in the menu
curl -X PATCH https://loyaltyfy.io/api/v1/menu/items/2040 \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{ "available": false }'

POST/v1/menu/items/bulk

Permisiune: menu:write

Până la 500 de modificări într-un apel. Fiecare intrare adresează un preparat prin item (id sau external_id) și setează oricare dintre price, old_price, available, visible. Intrările care nu schimbă nimic apar în unchanged, cele necunoscute în not_found. Un singur eveniment menu.updated pentru tot lotul.

curl

curl https://loyaltyfy.io/api/v1/menu/items/bulk \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "item": "1001", "price": 4800 },
      { "item": "2040", "available": false },
      { "item": "3017", "price": 9900, "old_price": 12000 }
    ]
  }'

Răspuns · 200

{
  "object": "menu_bulk_result",
  "updated": ["1001", "2040"],
  "unchanged": [],
  "not_found": ["3017"],
  "failed": []
}

PATCH/v1/menu/option_values/{value}

Permisiune: menu:write

Schimbă o valoare de modificator: available, price_delta, external_id.

curl

curl -X PATCH https://loyaltyfy.io/api/v1/menu/option_values/MOD-OAT \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{ "available": false }'