Lokamo i Twoja kasa
Lokamo i Dotykačka
Podłączenie Dotykački jest najprostsze ze wszystkich pięciu, a zakres integracji najwęższy. Oba te zdania są prawdziwe naraz i lepiej wiedzieć to przed wdrożeniem niż po nim.
- wdrożenie etapami
- czytelny przepływ
- pomiar przed obietnicą
Krótka odpowiedź
Dotykačka to jedyna z obsługiwanych kas, którą podłączysz jednym kliknięciem: zatwierdzasz zgodę w chmurze Dotykački i wracasz do Lokamo z gotowym połączeniem. Lokamo pobiera produkty, kategorie i ceny, a zamówienie potrafi wysłać jako akcję do terminala, choć sama wysyłka jest dziś wyłączona i otwieramy ją osobno dla każdego lokalu. Warianty i dodatki nie są dziś mapowane.
Odpowiedź wprost
Połączenie jednym kliknięciem
Dotykačka jako jedyna z naszych integracji ma prawdziwy ekran zgody. Klikasz „Połącz” w panelu Lokamo, lądujesz w chmurze Dotykački, wybierasz swoją chmurę, zatwierdzasz i wracasz do nas z gotowym połączeniem. Zero szukania kluczy w ustawieniach, zero przepisywania.
Ekran zgody wymaga danych aplikacji, które Dotykačka wydaje po rejestracji klienta. Gdy ich brakuje, panel pokazuje pola ręczne: refresh token i Cloud ID. Sam podpis żądania jest ważny bardzo krótko, bo dokumentacja Dotykački odrzuca odchylenie czasu większe niż minuta, więc formularz wysyła się natychmiast po wygenerowaniu.
Trzecie pole, Branch ID, oznacza oddział. Karta pobiera się bez niego, ale zamówienie bez oddziału nie ma dokąd pójść, więc do wysyłki jest obowiązkowe.
02 · praktycznie
Co przechodzi z Dotykački do Lokamo
Synchronizacja pobiera produkty i kategorie. Pozycja przenosi nazwę, opis, zdjęcie, cenę oraz widoczność, a produkty i kategorie oznaczone jako usunięte są pomijane. Cena brana jest z kwoty z VAT, a gdy jej nie ma, z kwoty bez VAT.
To wystarcza, żeby gość zobaczył pełną kartę na telefonie i złożył zamówienie, które kasa rozpozna po identyfikatorze produktu.
Najpierw znajdź wąskie gardło. Dopiero potem wybierz zmianę.
03 · praktycznie
Czego świadomie nie mapujemy
Dotykačka ma własny mechanizm personalizacji produktu, ale jego dokumentacja potwierdza pola encji, a nie to, jak personalizacja rozwiązuje wybieralne produkty. Zgadywanie tego skończyłoby się kartą, w której gość wybiera dodatek, a kasa dostaje zamówienie bez niego.
Dlatego karta pobrana z Dotykački nie ma dziś grup dodatków ani rozmiarów. Dodatki możesz prowadzić po stronie Lokamo, ale wtedy nie pojadą na kasę razem z zamówieniem, bo nie mają w Dotykačce identyfikatora, o który moglibyśmy je zaczepić.
To jest ograniczenie do usunięcia, a nie decyzja produktowa. Zostanie zdjęte wtedy, gdy będzie można potwierdzić mapowanie na realnej chmurze, a nie wcześniej.
więcej przejść
krótszy przepływ
04 · praktycznie
Jak wysyłane jest zamówienie
Wysyłka zamówień na kasę jest dziś wyłączona na całej instalacji i uruchamiamy ją osobno dla każdego lokalu, więc opis poniżej mówi, jak zadziała w dniu uruchomienia. Zamówienia nie tworzy się w Dotykačce przez zasób zamówień, bo ten jest tylko do odczytu. Lokamo wysyła je jako akcję dla kasy, przypisaną do oddziału. Akcja jest asynchroniczna: chmura potwierdza przyjęcie pustą odpowiedzią i przekazuje ją do terminala, a właściwy wynik wraca później osobnym powiadomieniem.
W praktyce znaczy to, że Lokamo zapisuje fakt wysłania, ale nie ma w tym momencie numeru bonu z kasy. Numer stolika, imię gościa i notatka jadą w notatce zamówienia, więc obsługa przy terminalu widzi, czego dotyczy.
Do akcji dołączamy identyfikator zamówienia z Lokamo, dzięki czemu duplikat da się rozpoznać. Nic jednak nie dokumentuje odrzucania powtórek po tym polu, a odpowiedzi z samego terminala nie dostajemy od razu, więc niejednoznaczny wynik nie jest ponawiany i trafia do obsługi.
01Wysyłka zamówień na kasę jest dziś wyłączona na całej instalacji i uruchamiamy ją osobno dla każdego lokalu, więc opis poniżej mówi, jak zadziała w dniu uruchomienia
02W praktyce znaczy to, że Lokamo zapisuje fakt wysłania, ale nie ma w tym momencie numeru bonu z kasy
03Do akcji dołączamy identyfikator zamówienia z Lokamo, dzięki czemu duplikat da się rozpoznać
Krok po kroku
Jak podłączyć Dotykačką do Lokamo
Trzy kroki przez ekran zgody Dotykački, bez przepisywania kluczy API.
- Uruchom łączenie w panelu Lokamo
W sekcji POS wybierz Dotykačką i kliknij Połącz. Lokamo przekieruje Cię do chmury Dotykački z podpisanym żądaniem.
- Zatwierdź zgodę i wybierz chmurę
Na stronie Dotykački zaloguj się, wskaż swoją chmurę i zatwierdź dostęp. Wrócisz do Lokamo z gotowym połączeniem, bez kopiowania kluczy.
- Uzupełnij oddział i pobierz kartę
Podaj Branch ID oddziału, jeśli zamówienia mają trafiać na kasę, a następnie uruchom synchronizację menu i sprawdź pobrane produkty oraz ceny.
Bez niedomówień
Częste pytania
Krótko i konkretnie, także tam, gdzie odpowiedź brzmi „to zależy”.
Czy muszę szukać kluczy w ustawieniach Dotykački?
Nie, jeśli łączenie przez ekran zgody jest aktywne: klikasz Połącz, wybierasz chmurę i zatwierdzasz. Pola ręczne, refresh token i Cloud ID, zostają jako droga zapasowa.
Dlaczego nie widzę dodatków z Dotykački?
Bo ich nie mapujemy. Dokumentacja Dotykački nie opisuje jednoznacznie, jak personalizacja produktu rozwiązuje wybieralne pozycje, a zgadywanie skończyłoby się dodatkiem widocznym dla gościa i nieobecnym na kasie.
Skąd wziąć Branch ID?
To identyfikator oddziału w chmurze Dotykački. Bez niego karta się pobierze, ale zamówienie nie wyjdzie, bo akcja dla kasy jest adresowana właśnie do oddziału.
Czy zobaczę w Lokamo numer bonu z kasy?
Nie od razu. Chmura potwierdza przyjęcie akcji pustą odpowiedzią, a wynik z terminala przychodzi później osobnym powiadomieniem, więc Lokamo zapisuje sam fakt wysłania.