Katalog

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

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

Co widzi sklep

GET /api/v1/menu oddaje aktywny katalog 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 katalogu. 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["Katalog w panelu"] --> menu["GET /menu"]
  menu --> shop["Witryna"]
  off["Pozycja wylaczona"] -.->|"znika"| menu

Kategorie i pozycje

W panelu: Katalog. Najpierw kategoria (Pizza, Napoje), potem pozycja w kategorii (Margherita). Kolejność kategorii to kolejność na witrynie.

Pozycja ma nazwę, opis, cenę w groszach i — gdy dotyczy — alergeny z unijnej listy. 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ś.