Structura meniului

Ierarhia

super_categories        (opțional)
└── categories          (minim una)
    └── sections        (minim una)
        └── products
            └── attribute_groups
                └── attributes

Nivel	Obligatoriu	La ce servește
super_categories	nu	Gruparea de cel mai înalt nivel. Dacă există, e prima listă pe care o vede clientul.
categories	da	Nivelul principal de navigare: Băuturi, Burgeri, Deserturi.
sections	da	Subîmpărțirea unei categorii.
products	da	Ce se comandă efectiv.
attribute_groups	nu	Grupuri de personalizări, cu minim și maxim de opțiuni.
attributes	nu	Opțiunile propriu-zise.

Dacă nu folosești super-categorii, categoriile devin primul nivel.

Identificarea magazinului

Câmp	Valoare
store_id	Identificatorul complet, partner_name__store_id.
partner_name	Numele soluției tale POS.
store_environment	prod.

Reguli de identificatori

Identificatorii trebuie să fie unici — și stabili

id-urile produselor, ale grupurilor de atribute și ale atributelor trebuie să fie unice în cadrul magazinului. Ele sunt și ceea ce primești înapoi în fiecare comandă, deci un identificator care se schimbă de la o sincronizare la alta îți face imposibilă potrivirea comenzii cu produsul din POS.

Un produs nu poate avea două prețuri. Dacă vinzi Coca-Cola cu 5 lei separat și cu 0 lei într-un meniu, sunt două produse cu identificatori diferiți, nu unul singur.

Imagini

Imaginile sunt găzduite de tine; noi primim doar URL-ul.

Cerință	Valoare
Orientare	pătrată
Dimensiune	1000 × 1000 px
Format	JPG
Mărime	sub 1 MB
Fundal	deschis, culoare simplă sau texturată
Protocol	HTTPS, cu certificat valid

Un certificat expirat înseamnă meniu fără poze

URL-urile de imagine sunt descărcate din exterior. Dacă certificatul serverului tău de imagini expiră, produsele rămân fără fotografii, iar problema nu apare ca eroare în actualizarea meniului.

Exemplu

{
  "store_environment": "prod",
  "store_id": "gi20__001",
  "partner_name": "gi20",
  "super_categories": [
    {
      "name": "default",
      "position": 0,
      "image_url": null,
      "display_super_category": false,
      "categories": [
        {
          "name": "MENIUL ZILEI",
          "position": 1,
          "sections": [
            {
              "name": "MENIUL ZILEI",
              "position": 0,
              "products": [
                {
                  "id": "18412870",
                  "name": "Meniul zilei",
                  "price": "45.0",
                  "image_url": null,
                  "description": "Ciorbă + fel principal + garnitură la alegere + salată",
                  "available": true,
                  "attribute_groups": [
                    {
                      "id": "17876377",
                      "name": "Alege ciorba 300 g",
                      "min": 1,
                      "max": 1,
                      "collapse": true,
                      "multiple_selection": false,
                      "attributes": [
                        {
                          "id": "17876412",
                          "name": "Ciorbă de văcuță",
                          "available": true,
                          "selected_by_default": false,
                          "price": "0.0"
                        },
                        {
                          "id": "17876428",
                          "name": "Ciorbă rădăuțeană",
                          "available": true,
                          "selected_by_default": false,
                          "price": "0.0"
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        },
        {
          "name": "HAMBURGERI",
          "position": 4,
          "sections": [
            {
              "name": "HAMBURGERI",
              "position": 0,
              "products": [
                {
                  "id": "18411340",
                  "name": "Hamburger clasic",
                  "price": "45.0",
                  "image_url": null,
                  "description": "Carne de vită, roșii, ceapă, brânză cheddar",
                  "available": true,
                  "attribute_groups": []
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Prețurile din meniu sunt zecimale, ca text

"price": "45.0" înseamnă 45 de lei. Este altă convenție decât în comenzi, unde sumele sunt întregi în subunitate (4500). Ține minte diferența când construiești payload-ul din aceleași date interne.

Grupuri de atribute

Câmp	Ce controlează
min / max	Câte opțiuni trebuie și poate alege clientul.
multiple_selection	Dacă aceeași opțiune poate fi aleasă de mai multe ori.
collapse	Dacă grupul apare pliat în interfață.
selected_by_default	Opțiunea preselectată.

Un grup cu min: 1 și max: 1 este o alegere obligatorie și unică — tipic pentru „alege garnitura“. Un grup cu min: 0 este complet opțional.