DelietaDokumentacja

Produkty

Kategorie i pozycje menu — to samo, co witryna czyta kluczem publikowalnym.

Produkty to to, co firma sprzedaje: kategorie i pozycje. Witryna nie zgaduje cennika. Czyta go z Deliety.

Co widzi sklep

GET /api/v1/menu oddaje aktywne produkty firmy, której kluczem publikowalnym wołasz API. Ceny są w groszach: 3200 to 32,00 zł. Witryna nie przysyła kwoty przy zamówieniu — serwer wycenia z listy produktów. Partner, który pokazuje inną cenę niż menu, kłamie klientowi, nie API.

Klucz publikowalny jest do czytania menu i do startu checkoutu. Klucz sekretny zostaje na serwerze witryny. Rotacja publikowalnego unieważnia stary od razu. Szczegóły: Partner API i kontrakt witryny.

Pozycja wyłączona znika z odpowiedzi menu. Sklep nie dostaje flagi „niedostępne” do samodzielnego honorowania — albo jest w menu, albo jej nie ma.

flowchart LR
  panel["Produkty w panelu"] --> menu["GET /menu"]
  menu --> shop["Witryna"]
  off["Pozycja wylaczona"] -.->|"znika"| menu

Kategorie i pozycje

W panelu: Produkty (sekcja Zaplecze). Najpierw kategoria (Pizza, Napoje), potem pozycja w kategorii (Margherita) — bez kategorii przycisk „Dodaj pozycję” jest wyłączony. Kolejność kategorii i pozycji to kolejność na witrynie; zmieniasz ją strzałkami przy wierszach.

Pozycja ma nazwę, opis, cenę (w panelu wpisujesz złote, np. 12,50; API oddaje grosze) i — gdy dotyczy — alergeny z unijnej listy. Warianty i dodatki, np. rozmiar, to grupy opcji z dopłatą w złotych i jedną zasadą wyboru: jedna obowiązkowa, jedna do pominięcia albo kilka. Pusty opis jest w porządku. Pusta cena nie przejdzie.

To nie jest magazyn. Nie ma stanów magazynowych w tej wersji. Wyłączenie pozycji to jedyny sposób, żeby zniknęła ze sklepu na dziś.