↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Księgowość, CRM i kasy: integracja z 1C, Odoo, SalesDrive i Dotykacka

    Jak podłączyć kasę Dotykacka: sprzedaż stacjonarna w Elbuz i produkty na kasę

    24 min czytaniaZaktualizowano

    Elbuz pobiera z kasy Dotykacka opłacone paragony i klientów do swojej ewidencji, a w drugą stronę eksportuje kategorie i produkty: sprzedaży nie przepisujesz ręcznie, a kasa sprzedaje asortyment z katalogu.

    Kiedy to się przyda:

    • Masz punkt stacjonarny z kasą Dotykacka — każdy opłacony paragon staje się dokumentem WZ, dowodem wpłaty i zamówieniem klienta.
    • Klient kupuje i w sklepie, i na stronie — kartoteka klientów kasy trafia do tej samej bazy kontrahentów bez duplikatów.
    • Ceny i nazwy prowadzisz w Elbuz — osobny szablon eksportu zakłada i aktualizuje produkty na kasie.
    • Kasa działa od dawna — sprzedaż jest pobierana dopiero od dnia przejścia.

    Od czego zacząć: weź ID chmury i refresh token z panelu Dotykacka i utwórz szablon „dotykacka.pl (POS)”.

    Co potrafi podłączenie kasy

    Czego potrzeba od Dotykacka

    Dwóch wartości: numeru chmury (widać go w adresie panelu po /cloud/) i refresh tokenu utworzonego w panelu chmury, w ustawieniach dostępu do API.

    Dotykacka wydaje długoterminowy refresh token, który sam nie wykonuje zapytań: służy do uzyskania krótkiego dostępu roboczego. Elbuz robi tę wymianę automatycznie przed każdą operacją — dlatego w szablonie zapisuje się właśnie refresh token i nie musisz niczego codziennie przedłużać.

    Dokumentacja kasy: Dotykacka API.

    Jak podłączyć

    1. Utwórz szablon importu typu „dotykacka.pl (POS)” i wypełnij pola „ID instancji (api_instance_id)” i „Token”.
    2. Jeśli historia kasy jest długa, a sprzedaż potrzebna jest dopiero od określonego dnia, przed pierwszym uruchomieniem wpisz datę w pole „Import zamówień począwszy od daty (RRRR-MM-DD)” w sekcji „Zaawansowane” (scenariusz). Puste pole — kasa odda całą historię.
    3. Kliknij „Importuj” wtedy, gdy możesz od razu obejrzeć wynik: pierwszy przebieg jest największy.
    4. Sprawdź dziennik i dokumenty (co powinno w nich być), potem ustaw szablon w harmonogramie.
    5. Jeśli asortyment prowadzisz w Elbuz, utwórz osobny szablon eksportu „dotykacka.pl” (jak).

    Jakie paragony i klienci są pobierani i co z nich powstaje

    Elbuz pobiera z kasy tylko opłacone paragony sprzedaży. Wszystko inne — wersje robocze, dokumenty wewnętrzne, nieopłacone rachunki — jest pomijane: do ewidencji ma trafić fakt sprzedaży, a nie stany pośrednie zmiany kasowej.

    Przy regularnych uruchomieniach pobierane są paragony utworzone po poprzednim imporcie, z zapasem dwunastu godzin wstecz — na wypadek rozbieżności zegarów i opóźnień synchronizacji kasy z chmurą. Już zaimportowane dokumenty nie są przy tym duplikowane.

    Jeden paragon — trzy dokumenty

    Sprzedaż na kasie ma dla ewidencji trzy skutki: towar zszedł z magazynu, pieniądze wpłynęły do kasy, sprzedaż trzeba doliczyć do obrotu. Dlatego z każdego paragonu Elbuz tworzy trzy dokumenty:

    DokumentPo co
    Dokument WZ (wydanie zewnętrzne)Zdjęcie sprzedanego towaru ze stanu magazynu
    Dowód wpłaty (KP)Ewidencja pieniędzy, które wpłynęły za paragon
    Zamówienie klientaEwidencja samej sprzedaży: obrót i pozycje

    Po pierwszym imporcie dokumentów jest trzy razy więcej niż paragonów — tak ma być. Trójkę łączy numer paragonu: we wszystkich trzech stoi w kolumnie „Nr dokumentu (sklep)” listy dokumentów. Identyfikator wewnętrzny („Zewnętrzne ID dokumentu”) każdy ma własny — inaczej program uznałby je za jeden dokument i założył tylko pierwszy.

    Wszystkie trzy powstają jako niezatwierdzone: znacznik w kolumnie „Status zatwierdzenia” nie jest ustawiony. Sam import nie wykonuje żadnych ruchów magazynowych — zdjęcie ze stanu i pozostałe skutki pojawiają się wtedy, gdy dokument zostanie zatwierdzony.

    Zamówienie klienta z paragonu nie rezerwuje towaru, nawet zatwierdzone i ze statusem „Opłacono”: towar został wydany na kasie w chwili sprzedaży, nie ma po co go trzymać dla klienta. Towar ze stanu zdejmuje dokument WZ. Statusy i kwoty paragonów się od tego nie zmieniają, a analityka sprzedaży pozostaje ta sama. Co w ogóle zajmuje rezerwację — w artykule o rezerwacji.

    Wszystkie trzy dokumenty są wystawiane na kontrahenta technicznego „Odbiorca końcowy” — tworzy się go raz, przy pierwszym imporcie, jeśli jeszcze go nie ma w bazie. Klienta z paragonu Elbuz do dokumentu nie przenosi (dlaczego to ważne).

    Formy płatności

    Kasa przekazuje sposób płatności kodem, a Elbuz przypisuje podstawowe do swoich form płatności:

    Płatność na kasieForma płatności w Elbuz
    gotówkaGotówka
    karta płatniczaKarta płatnicza
    przelew bankowyPrzelew bankowy
    płatność onlinePłatność online

    Poza nimi Dotykacka zna jeszcze około pięćdziesięciu sposobów — bony żywieniowe, karty podarunkowe, kod QR, a także płatności od serwisów dostawy jedzenia (Glovo, Bolt Food, Wolt, Foodora i innych). Ich nazwy Elbuz zapisuje w dokumencie bez zmian, więc w raportach widać, skąd przyszły pieniądze. Status płatności we wszystkich przypadkach to „Opłacono”: paragon jest opłacony z definicji.

    Co się dzieje z klientami kasy

    Przed paragonami Elbuz pobiera kartotekę klientów kasy — tych, których na kasie zakłada się dla rabatów i programów lojalnościowych. Przychodzą imię i nazwisko, telefon, e-mail, adres, kod pocztowy, kraj, miasto, data urodzenia, zebrane punkty i uwaga.

    Zakładani są tylko nowi klienci, w grupie klientów. Elbuz porównuje kartotekę kasy ze swoją bazą kontrahentów po identyfikatorze klienta w kasie, telefonie i e-mailu. E-mail jest porównywany w postaci kanonicznej, więc jan.kowalski+shop@gmail.com i jankowalski@gmail.com są rozpoznawane jako jeden adres, a klient kupujący i w sklepie, i na stronie nie stanie się duplikatem.

    Numery z kasy są normalizowane: dziewięć cyfr bez kodu kraju dostaje polski kod 48. Zrobiono to pod główny scenariusz — punkt sprzedaży w Polsce. Numery z innych krajów wpisuj na kasie w całości, z kodem kraju: wtedy zapiszą się bez zmian i poprawnie dopasują do istniejących kontrahentów.

    • Istniejącego klienta przebieg nie aktualizuje: zmieniony na kasie telefon czy adres nie trafia do jego karty — takie poprawki przenosi się do Elbuz ręcznie.
    • Klient nie trafia do dokumentów: kartoteka kasy i dokumenty sprzedaży istnieją obok siebie, ale nie są ze sobą połączone. Żeby zobaczyć zakupy konkretnego klienta, kontrahenta w dokumencie ustawia się ręcznie.
    • Pole „Grupa kontrahentów” w sekcji „Zaawansowane” szablonu ustala grupę tylko dla „Odbiorcy końcowego” w chwili jego utworzenia, na nowych klientów nie wpływa.

    Jak pozycje paragonu znajdują produkt

    Z każdego wiersza paragonu pobierane są nazwa, ilość, cena z VAT, wartość wiersza, procent rabatu, jednostka miary, numer produktu w kasie i numer jego kategorii w kasie. Kartę katalogu dla wiersza Elbuz szuka tak:

    1. po numerze produktu w kasie — zapisuje się on w karcie już po pierwszym imporcie, więc znana pozycja znajduje się od razu;
    2. po dokładnej zgodności nazwy z nazwą karty w katalogu.

    Znaleziona karta się nie zmienia: ani cena, ani stan, ani nazwa nie drgną od importu paragonu.

    Nie znalazła się — zakładana jest nowa karta: nazwa z paragonu, cena z paragonu (z VAT, po której sprzedano), ilość z wiersza jako stan i jednostka miary. Karta powstaje jako aktywna, ze stanem „Dostępny”, ale bez flagi „Eksportuj do pliku (do sklepu)”: sama nie pojedzie na witrynę ani na marketplace’y.

    Dwa górne sprawdzenia szukają istniejącej karty — znalezionej nie zmieniają. Dolne rozgałęzienie rozstrzyga tylko jedno: do której kategorii trafi nowa karta.
    taknietaknietaknieWiersz paragonuNumer produktu w kasie jest jużzapisany w karcie?Wiersz jest wiązany ze znalezionąkartąsama karta się nie zmieniaJest karta o takiej samej nazwie?Numer kategorii z kasy zgadza się zzewnętrznym UUID Twojejkategorii?Nowa karta w Twojej kategoriiNowa karta w kategorii technicznej„Produkty - kod źródła - nazwaszablonu”Karta bez flagi „Eksportuj do pliku(do sklepu)”
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    W wierszu dokumentu na zawsze zostaje to, co zarejestrowano na kasie: nazwa, ilość i cena z paragonu. Późniejsza zmiana ceny w katalogu nie ruszy już zaimportowanego paragonu — dokument utrwala fakt sprzedaży.

    Gdzie trafiają nowe produkty z kasy

    Kategorię kasa przekazuje numerem, a nie nazwą. Elbuz porównuje ten numer z polem zewnętrznego Twoich kategorii i tylko przy zgodności umieszcza produkt w Twojej gałęzi. Eksport na kasę tego pola nie wypełnia — prowadzi własny zapis powiązania z kasą. Dlatego zwykle zgodności nie ma i nierozpoznane pozycje trafiają do jednej kategorii technicznej „Produkty - ‹kod źródła› - ‹nazwa Twojego szablonu›”.

    Powstaje ona jako wyłączona i bez udziału w eksportach. Kolejne importy dokładają nowe pozycje do tej samej kategorii i nie ruszają jej flag — jeśli ręcznie włączysz jej eksport, tak już zostanie.

    Przenoś karty stamtąd do swoich kategorii bez obaw: ponowny import nie zmienia miejsca produktu w drzewie, a wiersz dokumentu nie odwołuje się do kategorii.

    Usunięcie kategorii zabiera z bazy wszystkie produkty, dla których jest ona główna — razem z opisami, zdjęciami, cechami i pytaniami. Wiersze już zaimportowanych dokumentów zostają, ale karty, do której się odwołują, już nie ma. Najpierw przenieś karty, potem usuń kategorię; następny przebieg założy ją ponownie, gdy tylko z kasy przyjdzie nieznana pozycja.

    Jak wyeksportować produkty z Elbuz na kasę

    Osobnym szablonem eksportu typu „dotykacka.pl” Elbuz zakłada na kasie kategorie i produkty z Twojego katalogu. Najpierw idą kategorie, potem produkty; nowe są tworzone, istniejące aktualizowane. Elbuz zapamiętuje powiązanie, więc ponowny eksport nie mnoży duplikatów na kasie.

    Tworzenie i aktualizacja idą osobnymi pakietami. Na tworzenie kasa odpowiada i odmowa jest widoczna w dzienniku. Aktualizacja przechodzi bez sprawdzania odpowiedzi.
    Kasa DotykackaElbuzalt[Kasa nie przyjęła tokenu][Token przyjęty]Tak przechodzą najpierw „Kategorie”, potem „Produkty” — te zaznaczone w szabloniealt[Kasa przyjęła][Kasa odmówiła]Ten pakiet nie jest aktualizowany, w dzienniku pomarańczowy wiersz, ponowna próba przy następnym przebiegualt[Kasa zwróciła znacznik wersji][Brak znacznika]loop[Każdy pakiet 100 już powiązanych rekordów]Odpowiedź na aktualizację nie jest sprawdzana ani zapisywana w dziennikuRefresh token i ID instancjiKomunikat odmowy — do dziennika, eksport się zatrzymujeKrótki dostęp roboczyNowe rekordy w pakietach po 100Numery utworzonych rekordów — Elbuz je zapamiętujeKomunikat odmowy — do dziennika przebieguZapytanie o te same rekordyAktualizacja na wierzchu wartości kasy
    • Запит або дія
    • Відповідь
    • alt — один із варіантів, залежно від умови
    • loop — повторюється
    • Примітка
    • Co jest eksportowane. Tylko produkty z flagą „Eksportuj do pliku (do sklepu)”, których kategoria też jest włączona i oznaczona do eksportu. Dlatego karty założone z paragonów do eksportu nie trafiają.
    • Cena w dwóch wariantach. Kasa przechowuje cenę z VAT i bez VAT osobno, więc Elbuz wylicza cenę bez VAT według stawki podatku produktu.
    • Jednostki miary. Dotykacka przyjmuje tylko swoją zamkniętą listę (sztuka, kilogram, litr, metr i tak dalej); Twoje oznaczenia są do niej dopasowywane, nierozpoznane stają się sztuką.
    • Co jest nadpisywane na kasie: nazwa, kategoria, jednostka miary, kod kreskowy, widoczność, stawka VAT, cena z VAT i bez VAT, kolor. Rabat kasa za każdym razem dostaje zerowy, a znacznik „zdejmuj ze stanu” — odznaczony: stany prowadzi Elbuz, a kasa sprzeda pozycję nawet przy zerowej ilości.

    Kategorie nie idą pierwsze dla porządku: produkt jest wysyłany z numerem swojej kategorii w kasie, a ten numer pojawia się dopiero po eksporcie kategorii. Dlatego w karcie „Co eksportować” zaznacz oba pola — „Kategorie” i „Produkty”.

    Jeśli kasa odmówi przyjęcia nowych rekordów, jej komunikat odmowy trafia do dziennika przebiegu. Odpowiedzi kasy na aktualizację program nie sprawdza, więc nieudana aktualizacja przejdzie niezauważona. Przed aktualizacją Elbuz pyta kasę o bieżącą wersję pakietu rekordów; jeśli jej nie zwróci, pakiet jest pomijany z pomarańczowym wierszem w dzienniku (rozwiązanie).

    Karty, która przyszła z paragonu, nie warto włączać do eksportu: na kasie ten produkt już jest. Powiązania zapisanego przez import paragonów eksport nie widzi — szuka własnego. Dlatego kasa dostanie taką kartę jako nowy rekord i na kasie pojawi się drugi produkt o tej samej nazwie.

    Aktualizacja według harmonogramu i ponowna wymiana

    Kasa sama nie powiadamia Elbuz o nowych paragonach: pobiera je uruchomienie szablonu — przyciskiem „Importuj” albo według harmonogramu. Każde uruchomienie bierze paragony od daty ostatniego zaimportowanego minus 12 godzin i po zakończeniu samo przesuwa tę datę. Jak ustawić szablon w harmonogramie i co daje wyłączenie — w przeglądzie importu danych.

    Co nadpisuje ponowna wymiana

    Wymiana działa w obie strony, a reguła jest tu niesymetryczna:

    CoCo robi ponowny przebieg
    Już zaimportowany paragon — trzy dokumentyNie rusza wcale: dokument jest wyszukiwany po identyfikatorze paragonu w kasie, ani status, ani kwota, ani wiersze, ani kontrahent nie są nadpisywane
    Karty produktów w ElbuzNie nadpisuje ceny, nazwy, stanu ani miejsca w drzewie; aktualizuje tylko liczbę sprzedanych sztuk — jest ona przeliczana ze wszystkich zamówień klientów
    Produkty na kasieEksport za każdym razem pisze na wierzchu: cenę, nazwę, kategorię, VAT i widoczność zmienione na kasie przywróci do wartości z Elbuz bez ostrzeżenia

    Pozycji, które prowadzisz właśnie na kasie, nie wpuszczaj do eksportu — odznacz w karcie „Eksportuj do pliku (do sklepu)”. Innej ochrony nie ma: przełączniki „Nie aktualizuj” i „Stała cena” w karcie produktu dotyczą importów do Elbuz, a nie eksportu z niego.

    Gdy paragon anulowano albo produkt zniknął

    • Paragonu nie ma już na kasie. Trzy dokumenty w Elbuz zostają bez zmian: import potrafi tylko tworzyć dokumenty i nie zapisuje w dzienniku wiersza o zniknięciu paragonu. Takie dokumenty usuwa się ręcznie (jak).
    • Na kasie wystawiono zwrot. Przyjdzie tylko wtedy, gdy kasa zapisała go zwykłym opłaconym paragonem — wtedy jako taka sama trójka dokumentów. Inny typ zapisu jest odrzucany bez komunikatu, a ruch zwrotny robisz w Elbuz samodzielnie. Już zaimportowanej trójki sprzedaży zwrot nie zmienia.
    • Produktu nie ma już w Elbuz. Na kasie zostaje taki, jakim go wysłano ostatnio: eksport nie wysyła kasie poleceń usunięcia. Tak samo będzie, jeśli odznaczysz w karcie „Eksportuj do pliku (do sklepu)”. Pozycję usuwa się w samej kasie.

    Granice przebiegu

    • Ile paragonów naraz. Bez limitu. Klienci i paragony przychodzą stronami po 200 rekordów, wiersze paragonu — razem z paragonem; strony są pobierane, dopóki kasa mówi, że jest następna.
    • Za jaki okres. Paragony utworzone później niż data z pola „Import zamówień począwszy od daty” minus 12 godzin. Pole puste — filtra po dacie nie ma, kasa oddaje całą historię, dlatego pierwszy przebieg jest wyraźnie większy od kolejnych.
    • Eksport na kasę wysyła pakiety po 100 rekordów: najpierw tworzenie, potem aktualizacja. Przed każdym pakietem aktualizacji Elbuz pobiera z kasy te same 100 rekordów — bez tego kasa poprawki nie przyjmie.
    • Na koncie demonstracyjnym eksport jest ograniczony do pierwszych 100 kategorii i 100 produktów; na koncie roboczym takiego limitu nie ma.

    Jak sprawdzić przebieg i naprawić błąd

    Dziennik przebiegu otwiera się w Centrum operacji — prawym panelu, który nie blokuje pracy: kartę szablonu można zamknąć i śledzić przebieg z dowolnego miejsca.

    Po lewej Elbuz, po prawej kasa. Klienci są pobierani przed paragonami, a data w sekcji „Zaawansowane” przesuwa się dopiero na końcu przebiegu.
    Kasa DotykackaElbuzZakłada nowych klientów z telefonem lub e-mailemZostawia opłacone paragony, z każdego trzy dokumentyParagony, które już są w bazie, pomijaJeśli paragony przyszły, przesuwa datę w „Zaawansowane” na najpóźniejszyalt[Kasa nie przyjęła tokenu][Token przyjęty]Refresh token i ID instancjiKomunikat odmowy — do dziennika, przebieg się zatrzymujeKrótki dostęp roboczyKartoteka klientów, stronami po 200KlienciParagony po dacie z „Zaawansowane” minus 12 godzin, stronami po 200Paragony razem z wierszami
    • Запит або дія
    • Відповідь
    • alt — один із варіантів, залежно від умови
    • Примітка

    Wiersze w dzienniku idą w takiej kolejności:

    1. „Łącznie zaimportowano kontrahentów: N” — ilu klientów z kartoteki kasy okazało się nowych. Nowych nie było — wiersza nie ma.
    2. „Pobieranie listy zamówień” — początek pracy z paragonami.
    3. „Pobrano zamówień: N” — nie liczba paragonów, tylko liczba wierszy, które przyszły z kasy: po trzy na każdy paragon, czyli trzy razy więcej, i razem z paragonami, które już są w bazie.
    4. „Łącznie zaimportowano produktów: N”, a po nim „Indeksowanie produktów” — ile nowych kart założono z pozycji paragonów. Nowych nie było — obu wierszy nie ma.
    5. „Łącznie zaimportowano zamówień: N” — ile dokumentów faktycznie utworzono. To główna liczba przebiegu; brak nowych paragonów — wiersza nie ma wcale i to normalne.
    6. „Aktualizacja wartości na podstawie formuł” i „Import danych zakończony!” z dopiskiem „Czas trwania”.

    Same paragony znajdziesz w oknie „Dokumenty”:

    • „Źródło: nazwa” — nazwa Twojego szablonu;
    • „Typ dokumentu” rozdzieli trójkę;
    • „Nr dokumentu (sklep)” — numer paragonu z kasy, taki sam we wszystkich trzech;
    • „Data dodania (źródło)” — czas paragonu na kasie.

    Nowe karty widać w oknie „Produkty” w kolumnie „Źródło: nazwa”, nowych klientów — w „Kontrahentach” w kolumnie „Źródło — nazwa”. Za dłuższą historię odpowiada przycisk „Historia uruchomień” w nagłówku karty szablonu.

    Jeśli zaimportowano nie to

    Przebiegu nie da się zatrzymać w połowie. Przycisk „Stop” ustawia znacznik zatrzymania, a wymiana z kasą sprawdza go tylko raz, na samym początku. Kliknięty w trakcie pracy, zapisze w dzienniku „Operacja przerwana przez użytkownika!”, ale import dojdzie do końca. Znacznik jest zdejmowany na początku następnego uruchomienia.

    Wszystko, co założył przebieg, jest oznaczone źródłem, więc da się to wyfiltrować:

    • Dokumenty — okno „Dokumenty”, kolumna „Źródło: nazwa” równa nazwie szablonu. Zaznacz wiersze i usuń je zbiorczo; zatwierdzonych dokumentów operacja zbiorcza nie usuwa, program pokaże, ile pominięto.
    • Produkty — okno „Produkty”, ta sama kolumna. Do wyniku filtrowania trafią tylko karty, które utworzył ten import; istniejących on nawet nie zmieniał.
    • Kontrahenci — okno „Kontrahenci”, kolumna „Źródło — nazwa”: klienci z kartoteki kasy.

    Usunięte dokumenty przez 30 dni leżą w „Koszu dokumentów”, skąd pakiet można przywrócić w całości.

    Usunięcie dokumentów nie cofa znacznika, od którego miejsca kontynuować. Następny przebieg zacznie od daty ostatniego zaimportowanego paragonu i tych samych paragonów ponownie nie pobierze. Żeby ponownie zaimportować okres, wpisz datę ręcznie: karta szablonu, sekcja „Zaawansowane”, pole „Import zamówień począwszy od daty (RRRR-MM-DD)”.

    Rozwinięty blok „Zaawansowane” w formularzu podłączenia kasy
    1Import zamówień od daty
    2Grupa kontrahentów
    1. „Import zamówień począwszy od daty (RRRR-MM-DD)” — data, od której przebieg pobiera paragony.
    2. „Grupa kontrahentów” — grupa przypisywana odbiorcy końcowemu.

    Scenariusze

    Sprzedaż punktu stacjonarnego w tych samych dokumentach co zamówienia ze strony

    Zadanie: widzieć sprzedaż z kasy w Elbuz obok zamówień ze sklepu internetowego.

    Co skonfigurować: szablon importu typu „dotykacka.pl (POS)”, w karcie „Połączenie” — pola „Token” i „ID instancji (api_instance_id)”; uruchomienie — przyciskiem „Importuj”.

    Efekt: każdy opłacony paragon stanie się trzema dokumentami — „Dokument WZ”, „Dowód wpłaty (KP)”, „Zamówienie klienta” — na kontrahenta „Odbiorca końcowy”. Stany istniejących produktów zmienią się dopiero po zatwierdzeniu dokumentów; nieopłacone paragony i zapisy innych typów nie przyjdą.

    Ewidencja od określonego dnia, a nie z całej historii kasy

    Zadanie: kasa działa od dawna, a w Elbuz potrzebna jest sprzedaż dopiero od dnia przejścia.

    Co skonfigurować: przed pierwszym uruchomieniem w karcie szablonu, sekcja „Zaawansowane”, wpisz datę w pole „Import zamówień począwszy od daty (RRRR-MM-DD)”.

    Efekt: przyjdą paragony utworzone później niż ta data minus 12 godzin. Po przebiegu data w polu sama przesunie się na najpóźniejszy zaimportowany paragon, a następne uruchomienie będzie kontynuować od tego miejsca.

    Stali klienci kasy — w bazie kontrahentów

    Zadanie: klienci założeni na kasie dla rabatów i bonusów mają być w tej samej bazie co klienci ze strony.

    Co skonfigurować: osobno nic — ten sam szablon „dotykacka.pl (POS)” pobiera kartotekę klientów na początku każdego przebiegu.

    Efekt: nowi klienci są zakładani w grupie klientów; ci, których Elbuz już zna po identyfikatorze w kasie, telefonie lub e-mailu, nie staną się duplikatami. Klient bez telefonu i bez e-maila nie zostanie założony wcale, a do dokumentów z paragonów klient nie jest podstawiany.

    Asortyment z Elbuz — na kasę

    Zadanie: ceny i nazwy są prowadzone w Elbuz, a kasa ma sprzedawać według nich.

    Co skonfigurować: osobny szablon eksportu typu „dotykacka.pl”, w karcie „Co eksportować” — pola „Kategorie” i „Produkty”. Produkty muszą mieć flagę „Eksportuj do pliku (do sklepu)”, a ich kategoria — być włączona i oznaczona do eksportu.

    Efekt: najpierw na kasie pojawią się kategorie, potem produkty; kolejne eksporty aktualizują te same rekordy. Produkt wyłączony z eksportu albo usunięty w Elbuz sam z kasy nie zniknie, a kasa nie będzie zdejmować stanu przy sprzedaży.

    Co zrobić, gdy paragony nie przychodzą

    Rozwiązywanie częstych problemów
    Co widziszDlaczego tak jestCo zrobić
    „Nie podano tokenu API” Puste pole „Token” albo „ID instancji” Wypełnij oba pola (skąd je wziąć)
    W dzienniku komunikat odmowy od kasy Kasa nie przyjęła tokenu Utwórz nowy refresh token w panelu chmury i wklej go do szablonu
    Jest „Pobrano zamówień”, ale nie ma „Łącznie zaimportowano zamówień” Nowych paragonów nie ma — wszystkie pobrane już są w bazie Nic: to normalny wynik ponownego uruchomienia (dziennik)
    Zaimportowały się nie wszystkie paragony Pobierane są tylko opłacone paragony sprzedaży i tylko po dacie z „Zaawansowane” minus 12 godzin Sprawdź typ i opłacenie paragonu na kasie oraz datę w szablonie (jakie paragony)
    Na kasie są dwa produkty o tej samej nazwie Kartę, która przyszła z paragonu, włączono do eksportu Odznacz w karcie „Eksportuj do pliku (do sklepu)”, zbędny rekord usuń na kasie (eksport)
    „Dotykačka: kasa nie zwróciła wersji rekordów (ETag) — pakiet aktualizacji pominięto, ponowna próba przy następnym uruchomieniu.” Kasa nie oddała bieżącej wersji pakietu, a bez niej nie przyjmuje poprawki Poczekaj na następny eksport albo uruchom go jeszcze raz
    „Operacja przerwana przez użytkownika!”, a dokumenty i tak się pojawiły Zatrzymanie jest sprawdzane tylko na początku wymiany Usuń zbędne, filtrując po źródle (jak)
    Telefony klientów dostały kod 48 Dziewięć cyfr bez kodu kraju jest normalizowane do formatu polskiego Wpisuj na kasie numery z kodem kraju (klienci)

    Najczęstsze pytania

    Skąd wziąć ID instancji i token Dotykacka?

    ID instancji to numer Twojej chmury, widać go w adresie panelu po /cloud/. Token tworzy się w panelu chmury, w sekcji dostępu do API: to refresh token, z którego Elbuz sam uzyskuje dostęp roboczy.

    Dlaczego z jednego paragonu powstają trzy dokumenty?

    Sprzedaż na kasie ma trzy skutki: zdjęcie towaru ze stanu, wpływ pieniędzy i obrót. Wszystkie trzy dokumenty mają ten sam numer paragonu w kolumnie „Nr dokumentu (sklep)” (więcej).

    Czy produkty z kasy powstają we właściwej kategorii?

    Nie: kasa przekazuje kategorię numerem, a nowe pozycje trafiają do kategorii technicznej — wyłączonej i poza eksportami. Przenoś karty stamtąd do swoich kategorii (kategoria techniczna).

    Czy ponowny import nadpisze moje poprawki w dokumentach?

    Nie. Już zaimportowanego paragonu przebieg w ogóle nie rusza, kart produktów też nie nadpisuje. Natomiast eksport na kasę pisze na wierzchu danych kasy (co jest nadpisywane).

    Dlaczego w dokumentach jest „Odbiorca końcowy”, a nie klient z kasy?

    Klienta z paragonu Elbuz do dokumentu nie przenosi. Kartoteka kasy przychodzi osobno, do kontrahentów; żeby powiązać sprzedaż z klientem, ustaw kontrahenta w dokumencie ręcznie.

    Jak usunąć omyłkowo zaimportowane paragony?

    W oknie „Dokumenty” wyfiltruj wiersze po kolumnie „Źródło: nazwa” i usuń je zbiorczo; usunięte przez 30 dni leżą w „Koszu dokumentów”. Żeby zaimportować okres ponownie, wpisz datę w „Zaawansowane” (krok po kroku).

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Operacje → Import danych
    Typ szablonu
    „dotykacka.pl (POS)”; do eksportu na kasę — szablon eksportu „dotykacka.pl”
    Uprawnienia
    okno „Import danych” w „Uprawnieniach grup”
    Przygotuj
    chmury (cloud ID) i refresh token z panelu Dotykacka

    Plik nie jest potrzebny. W karcie „Połączenie” wypełnia się dwa pola:

    PoleCo wpisać
    ID instancjiNumer Twojej chmury Dotykacka (cloud ID). Widać go w adresie panelu po /cloud/
    TokenRefresh token dostępu do API utworzony w panelu Dotykacka
    Karta „Połączenie” szablonu dotykacka.pl (POS) z polami podłączenia
    1Pole „Token”
    2Pole „ID instancji (api_instance_id)”
    1. „Token” — refresh token kasy.
    2. „ID instancji (api_instance_id)” — numer chmury, do której należy kasa.

    Powiązane tematy

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo