Źródło: https://wpinplate.com/dokumentacja/kds/

# Ekran kuchni (KDS)

KDS (Kitchen Display System) to ekran kuchni działający w przeglądarce, przygotowany pod tablet i sterowanie dotykiem. Wszystkie zamówienia z każdego kanału trafiają w jedno miejsce, z jasnym statusem. Zastępuje kartki i telefon.

Adres: **`/wp-inplate/kds/`**. Do logowania potrzebne jest konto z uprawnieniem „Dostęp do KDS” – zobacz [Zespół i uprawnienia](/dokumentacja/zespol-i-uprawnienia/).

## Początek zmiany

1. Otwórz KDS na tablecie i zaloguj się.
2. **Dotknij ekranu.** Przeglądarki włączają dźwięk dopiero po pierwszym dotknięciu strony – bez tego nowe zamówienie nie zadzwoni.
3. Przy pierwszym uruchomieniu włącz powiadomienia push (baner u góry albo dzwonek w menu). Zobacz [Powiadomienia](/dokumentacja/powiadomienia/).

Podczas pracy z KDS ekran tabletu nie wygasa. KDS możesz zainstalować jako aplikację (PWA) – wymaga to HTTPS. Aplikacja nazywa się jak lokal, np. „Okrąglak KDS” – zobacz [Aplikacje na telefon i tablet](/dokumentacja/ustawienia/#aplikacje-na-telefon-i-tablet).

## Menu KDS

Przycisk menu w nagłówku otwiera panel z ustawieniami:

- **Widok:** Zamówienia, Lista, Archiwum, Zmiana, Manager (Manager widoczny dla osób z uprawnieniem do zarządzania menu),
- **Filtr kanału:** Wszystkie, Dostawa, Odbiór osobisty, Na miejscu, Stoliki QR,
- **Przypisane do mnie** i **Niezapłacone** – dodatkowe filtry,
- **Język:** PL, EN, UA,
- **Dzwonek powiadomień push** – włącza powiadomienia, a gdy są włączone, wysyła powiadomienie testowe,
- **Chowaj po kliknięciu** – menu zamyka się po wyborze opcji,
- **Wyloguj**.

## Widok „Zamówienia”

Kolumny: **Nowe → W przygotowaniu → Gotowe → W drodze**. Kolumna „W drodze” dotyczy dostaw. Zakończone i anulowane zamówienia znikają z tablicy i trafiają do archiwum.

Na telefonie, tablecie w pionie i w wąskim oknie kolumny mają stałą szerokość, a przesunięcie palcem przesuwa widok dokładnie o jedną kolumnę.

### Karta zamówienia

| Element | Opis |
|---|---|
| Numer zamówienia i kanał | Np. „#1042”, ikona dostawy, odbioru, posiłku na miejscu albo stolika |
| Termin | Godzina realizacji pod numerem. Data jest wyróżniona, gdy to nie jest dziś |
| Pozycje | Ilość, nazwa dania i wybrane dodatki, czytelną czcionką |
| Notatka klienta | Zawsze widoczna i wyróżniona, np. „bez cebuli”, alergie |
| Klient i kwota | Dwie dyskretne linie – tylko dla osób z uprawnieniem do danych klienta i cen |
| Przypisanie | Lista z osobą, która ma zamówienie, albo „Nieprzypisane” |
| Ikony | Drukowanie etykiety i historia zamówienia |
| Przycisk akcji | Następny krok: **Rozpocznij**, **Gotowe**, **Wyślij** albo **Dostarczone** |

**Dotknięcie karty w dowolnym miejscu** otwiera podgląd zamówienia.

### Zmiana statusu

- **Rozpocznij** – Nowe → W przygotowaniu. Osoba, która rozpoczyna, zostaje przypisana do zamówienia.
- **Gotowe** – W przygotowaniu → Gotowe. Przy odbiorze osobistym klient dostaje e-mail „Gotowe do odbioru”. Przy dostawie zamówienie trafia do puli kurierów (albo prosto do kuriera, który był przypisany wcześniej).
- **Wyślij** – Gotowe → W drodze (dostawa). Zwykle robi to kurier w swojej aplikacji.
- **Dostarczone** – wydanie klientowi albo potwierdzenie doręczenia. Zamówienie trafia do archiwum.

**Cofnij status** przywraca poprzedni status, np. gdy ktoś za wcześnie kliknął „Gotowe”. Może to zrobić osoba przypisana do zamówienia albo manager.

Przyciski widzisz tylko dla zmian, do których masz uprawnienia.

### Przypisywanie

- Zamówienie przypisane komuś innemu jest dla Ciebie zablokowane („Przypisane do …”). Manager może działać na każdym zamówieniu.
- **Zwolnij** oddaje zamówienie: wraca do kolejki Nowych i jest dostępne dla innych.
- Osoba z uprawnieniem do przypisywania wybiera z listy na karcie, kto ma zamówienie. Wybór „Nieprzypisane” oddaje zamówienie do puli.
- Przypisanie kuriera do zamówienia z dostawą jeszcze w trakcie przygotowania: gdy zamówienie będzie gotowe, trafi prosto do tego kuriera, a powiadomienie dostanie tylko on.

### Płatność

- Zamówienie płatne online, za które klient jeszcze nie zapłacił, ma oznaczenie **Oczekuje na płatność** i nie da się go rozpocząć. Można je tylko anulować.
- Zamówienie płatne w lokalu oznaczasz jako **Opłacone** przyciskiem na karcie. Zmiana wymaga drugiego dotknięcia w ciągu 2 sekund („Potwierdź: …”).

### Anulowanie

Osoba z uprawnieniem do anulowania wybiera powód: rezygnacja z zamówienia, klient nie odbiera telefonu, klienta nie ma na miejscu, błędny adres albo inny powód. Powód widać w podglądzie i w historii zamówienia. Anulowania nie można cofnąć.

## Podgląd zamówienia

Okno z pełnymi danymi zamówienia:

- **Podsumowanie:** status kuchni, sposób realizacji, przypisana osoba, godzina złożenia,
- **Płatność:** metoda płatności i status (Opłacone / Nieopłacone),
- **Klient i realizacja:** imię i nazwisko, telefon, adres, okno realizacji (według uprawnień), stolik,
- **Pozycje:** ilość, danie, dodatki, cena bazowa i dopłaty (według uprawnień),
- **Rozliczenie:** kupon, cena przed rabatem, koszt dostawy, opakowanie, dopłata logistyczna, suma – żółta, dopóki zamówienie nie jest opłacone, zielona po opłaceniu,
- **Uwagi:** notatka klienta,
- **Alerty:** powód anulowania, problem zgłoszony przez kuriera.

W nagłówku okna jest przycisk **Drukuj etykietę**. Klawisz Escape zamyka najpierw okno drukowania, potem podgląd.

## Historia zamówienia

Ikona historii na karcie pokazuje, kto i kiedy zmienił status, przypisał, zwolnił albo cofnął zamówienie, a także zgłoszenia kurierów i odbiory przez kod QR. Wpisy wyświetlają się w języku KDS.

## Nowe zamówienie

Nowe zamówienie wywołuje sygnał dźwiękowy i komunikat **Nowe zamówienie!**. Gdy KDS działał w tle, alarm na pełnym ekranie powtarza dźwięk, dopóki ktoś go nie potwierdzi.

## Zwroty od kuriera

Gdy kurier zgłosi nieudaną dostawę, KDS pokazuje osobny alarm **Zwrot od kuriera!** z własnym dźwiękiem i powodem. Zamówienie wraca do „Gotowe” z czerwonym oznaczeniem zwrotu. Kuchnia i manager dostają też powiadomienie push.

Zamówienie ze zwrotem jest ukryte przed kurierami – nikt nie odbierze go przez pomyłkę. Manager decyduje:

- **Wyczyść zwrot** – zamówienie staje się zwykłym gotowym zamówieniem, a kurierzy dostają powiadomienie (albo tylko przypisany kurier). Zgłoszenie kuriera zostaje w historii,
- przypisuje innego kuriera,
- albo anuluje zamówienie.

Kurier, który zwrócił zamówienie, może sam przywrócić je do dostawy, jeśli klient się odezwał – zobacz [Aplikacja kuriera](/dokumentacja/aplikacja-kuriera/#zwroty).

## Widok „Lista”

Aktywne zamówienia jako wiersze tylko do odczytu: numer i godzina złożenia, status, sposób realizacji, termin z oznaczeniem dnia, klient, przypisana osoba, notatka, oznaczenia anulowania i problemów, suma ze statusem płatności. Dotknięcie wiersza rozwija pełne dane zamówienia – te same co w podglądzie, z tymi samymi uprawnieniami.

## Widok „Archiwum”

Zakończone (**Dostarczone**) i **Anulowane** zamówienia. Domyślnie ostatnie 7 dni. Szybkie zakresy: 48 h, 7 dni, 30 dni albo własny zakres **Od – Do**. Filtr statusu pokazuje dostarczone, anulowane albo wszystkie. Wiersze rozwijają się do pełnych danych zamówienia.

## Widok „Zmiana” (podsumowanie)

Podsumowanie pracy w wybranym okresie:

- zakres: **Dziś** albo własny **Od – Do**,
- zakres osób: **Moja zmiana**, wybrana osoba albo **Wszyscy**,
- liczba zamówień i podział na dostawę, odbiór i posiłek na miejscu,
- przychód,
- liczba anulowanych zamówień,
- statystyki osób: ile zamówień obsłużyły i ile dostarczyły.

## Widok „Manager”

Prowadzenie menu z tabletu: produkty, ceny i stany, kategorie, znaczniki, dodatki, cross-sell, harmonogram i ekrany TV. Opis w rozdziale [Panel managera w KDS](/dokumentacja/panel-managera/).

## Odświeżanie i synchronizacja

Zmiany statusów, przypisań, płatności i zwrotów docierają do wszystkich otwartych urządzeń KDS i do aplikacji kurierów. Przycisk **Odśwież** wymusza pobranie danych. Gdy połączenie z serwerem zostanie przerwane, KDS pokazuje błąd i przycisk **Ponów** – nie ukrywa problemu.

## Licencja

Po wygaśnięciu licencji (po okresie przejściowym) podstawowa obsługa zamówień w KDS działa dalej. Podsumowanie zmiany i druk etykiet wymagają aktywnej licencji. Zobacz [Licencja](/dokumentacja/licencja/).