Źródło: https://wpinplate.com/dokumentacja/aplikacja-kuriera/

# Aplikacja kuriera

Aplikacja kuriera działa na telefonie w przeglądarce. Kurier widzi zamówienia gotowe do odbioru, bierze je, jedzie do klienta i potwierdza doręczenie. Nie potrzebujesz zewnętrznej floty ani platformy dostaw.

Adres: **`/wp-inplate/courier/`**. Kurier potrzebuje konta z profilem **Kurier** (albo Manager) – zobacz [Zespół i uprawnienia](/dokumentacja/zespol-i-uprawnienia/).

Zainstaluj aplikację na telefonie (PWA): w Chrome „Zainstaluj aplikację”, na iPhonie w Safari „Udostępnij → Do ekranu początkowego”. Wymaga HTTPS. Na iPhonie powiadomienia push działają tylko w aplikacji dodanej do ekranu początkowego. Aplikacja nazywa się jak lokal, np. „Okrąglak Kurier” – zobacz [Aplikacje na telefon i tablet](/dokumentacja/ustawienia/#aplikacje-na-telefon-i-tablet).

## Ekran aplikacji

- **Nagłówek** z tytułem ekranu i przyciskiem odświeżania.
- **Dolny pasek** z zakładkami **Do odbioru** i **W drodze** oraz wyróżnionym przyciskiem **Skanuj QR** pośrodku.
- Przesunięcie palcem w lewo lub w prawo przełącza między „Do odbioru” i „W drodze”.
- **Menu:** Archiwum, Zwroty, Testowe powiadomienie, Wyloguj.

## Do odbioru

Zamówienia z dostawą, które kuchnia oznaczyła jako gotowe – wspólna pula dla wszystkich kurierów – oraz zamówienia przypisane do tego kuriera.

Karta zamówienia pokazuje:

- numer, termin dostawy i dzień (zamówienia na kolejne dni są posortowane według dnia),
- oznaczenie spóźnienia, gdy termin dostawy minął,
- adres – dotknięcie otwiera nawigację do współrzędnych klienta,
- telefon – dotknięcie rozpoczyna połączenie,
- kwotę **Do pobrania** przy płatności gotówką albo informację „Opłacone online”,
- notatkę klienta – na jej początku są wskazówki zapisane przez klienta przy adresie („Dla kuriera: klatka B, domofon 12”),
- notatkę z poprzedniej, nieudanej próby dostawy, jeśli była.

Przycisk **Odbieram** przypisuje zamówienie kurierowi i zmienia status na **W drodze**. Klient dostaje e-mail „W drodze”. Jeśli odbiór się nie uda (np. inny kurier był szybszy), karta pokaże powód.

## Skanowanie etykiety

Przycisk **Skanuj QR** uruchamia aparat. Kurier skanuje kod z [etykiety zamówienia](/dokumentacja/etykiety/) i od razu odbiera zamówienie. Przeglądarka poprosi o dostęp do aparatu przy pierwszym użyciu.

Każde skanowanie daje czytelną odpowiedź:

| Sytuacja | Co widzi kurier |
|---|---|
| Zamówienie gotowe, wolne | Zamówienie odebrane |
| Zamówienie jeszcze w kuchni | Informację, że nie jest gotowe, ze statusem kuchni |
| Zamówienie przypisane innemu kurierowi | Pytanie, czy przejąć. Przejęcie jest zapisywane w historii, a poprzedni kurier dostaje powiadomienie |
| Zamówienie w drodze z innym kurierem | Odmowa. Kuriera zmieni tylko manager w KDS |
| Zamówienie dostarczone, anulowane albo bez dostawy | Odpowiedni komunikat |
| Kod nieważny | Komunikat o nieważnym kodzie |

## W drodze

Zamówienia, które kurier wiezie. Po dotarciu do klienta:

- **Dostarczone** – potwierdza doręczenie. Przy płatności gotówką przycisk ma postać „Pobrano 54,90 zł – potwierdź”, więc kurier jednocześnie potwierdza pobranie pieniędzy.
- **Problem z dostawą** – zgłasza nieudaną dostawę z powodem: klient nie odbiera telefonu, klienta nie ma na miejscu, błędny adres, inny powód.

Zgłoszony problem trafia do kuchni jako **Zwrot od kuriera** (alarm w KDS i powiadomienie push). Zamówienie znika z list kurierów, dopóki manager nie zdecyduje, co dalej – zobacz [KDS: zwroty od kuriera](/dokumentacja/kds/#zwroty-od-kuriera).

## Zwroty

Menu → **Zwroty** pokazuje zwroty tego kuriera, które czekają na decyzję w KDS. Jeśli klient się odezwał, a zamówienie jest jeszcze u kuriera, **Przywróć do dostawy** (po potwierdzeniu) przywraca je do tego kuriera jako „W drodze”. Przywrócenie trafia do historii zamówienia, a kuchnia dostaje powiadomienie.

## Alarm nowego zamówienia

Nowe zamówienie do odbioru wywołuje alarm na pełnym ekranie z powtarzanym dźwiękiem i wibracją, dopóki kurier go nie potwierdzi („OK – rozumiem”) albo nie odbierze zamówienia.

**Tryb „w trasie”:** gdy kurier ma zamówienia w drodze, nowe zamówienia do odbioru dają jeden krótki sygnał zamiast powtarzanego alarmu, a powiadomienia push są ciche. Gdy kurier zakończy ostatnią dostawę, pełny alarm zadzwoni z liczbą czekających zamówień. Powiadomienia o zamówieniach w puli są łączone w jedno.

## Archiwum

Menu → **Archiwum** pokazuje zamówienia dostarczone i anulowane z ostatnich 48 godzin, z informacją o pobranej gotówce.

## Synchronizacja

Zmiany z KDS (gotowe zamówienia, przypisania, wyczyszczone zwroty, oznaczona płatność) docierają do aplikacji kuriera automatycznie. Przycisk odświeżania w nagłówku wymusza pobranie danych.