Lokamo i Twoja kasa
Lokamo i Dotykacka
Podłączenie Dotykacki jest najprostsze ze wszystkich czterech, 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ź
Dotykacka to jedyna z obsługiwanych kas, którą podłączysz jednym kliknięciem: zatwierdzasz zgodę w chmurze Dotykacki 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
Dotykacka jako jedyna z naszych integracji ma prawdziwy ekran zgody. Klikasz „Połącz” w panelu Lokamo, lądujesz w chmurze Dotykacki, 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 Dotykacka 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 Dotykacki 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 Dotykacki 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
Dotykacka 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 Dotykacki 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 Dotykacce 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 Dotykacce 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ć Dotykacką do Lokamo
Trzy kroki przez ekran zgody Dotykacki, bez przepisywania kluczy API.
- Uruchom łączenie w panelu Lokamo
W sekcji POS wybierz Dotykacką i kliknij Połącz. Lokamo przekieruje Cię do chmury Dotykacki z podpisanym żądaniem.
- Zatwierdź zgodę i wybierz chmurę
Na stronie Dotykacki 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 Dotykacki?
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 Dotykacki?
Bo ich nie mapujemy. Dokumentacja Dotykacki 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 Dotykacki. 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.