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
- Import opłaconych paragonów — z każdego paragonu powstają trzy dokumenty: wydanie towaru, wpływ pieniędzy i sprzedaż.
- Karty dla nowych produktów — pozycja, której nie ma w katalogu, staje się kartą w kategorii technicznej.
- Formy płatności — gotówka, karta, przelew i płatność online trafiają do Twoich form płatności.
- Kartoteka klientów — nowi klienci kasy są zakładani jako kontrahenci bez duplikatów.
- Eksport na kasę — kategorie i produkty z Elbuz pojawiają się i aktualizują na kasie.
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ć
- Utwórz szablon importu typu „dotykacka.pl (POS)” i wypełnij pola „ID instancji (api_instance_id)” i „Token”.
- 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ę.
- Kliknij „Importuj” wtedy, gdy możesz od razu obejrzeć wynik: pierwszy przebieg jest największy.
- Sprawdź dziennik i dokumenty (co powinno w nich być), potem ustaw szablon w harmonogramie.
- 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:
| Dokument | Po 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 klienta | Ewidencja 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 kasie | Forma płatności w Elbuz |
|---|---|
| gotówka | Gotówka |
| karta płatnicza | Karta płatnicza |
| przelew bankowy | Przelew bankowy |
| płatność online | Pł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:
- po numerze produktu w kasie — zapisuje się on w karcie już po pierwszym imporcie, więc znana pozycja znajduje się od razu;
- 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.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
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.
- Запит або дія
- Відповідь
- 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:
| Co | Co robi ponowny przebieg |
|---|---|
| Już zaimportowany paragon — trzy dokumenty | Nie 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 Elbuz | Nie nadpisuje ceny, nazwy, stanu ani miejsca w drzewie; aktualizuje tylko liczbę sprzedanych sztuk — jest ona przeliczana ze wszystkich zamówień klientów |
| Produkty na kasie | Eksport 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.
- Запит або дія
- Відповідь
- alt — один із варіантів, залежно від умови
- Примітка
Wiersze w dzienniku idą w takiej kolejności:
- „Łącznie zaimportowano kontrahentów: N” — ilu klientów z kartoteki kasy okazało się nowych. Nowych nie było — wiersza nie ma.
- „Pobieranie listy zamówień” — początek pracy z paragonami.
- „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.
- „Łą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.
- „Łą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.
- „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)”.
1
Import zamówień od daty2
Grupa kontrahentów- „Import zamówień począwszy od daty (RRRR-MM-DD)” — data, od której przebieg pobiera paragony.
- „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ą
| Co widzisz | Dlaczego tak jest | Co 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:
| Pole | Co wpisać |
|---|---|
| ID instancji | Numer Twojej chmury Dotykacka (cloud ID). Widać go w adresie panelu po /cloud/ |
| Token | Refresh token dostępu do API utworzony w panelu Dotykacka |
1
Pole „Token”2
Pole „ID instancji (api_instance_id)”- „Token” — refresh token kasy.
- „ID instancji (api_instance_id)” — numer chmury, do której należy kasa.
Powiązane tematy
- Jeśli potrzebujesz ogólnego obrazu, jak zamówienia z różnych systemów stają się dokumentami — Import zamówień przez API.
- Jeśli dokumenty z kasy trzeba zatwierdzić, żeby zdjąć towar ze stanu — Zamówienie klienta.
- Jeśli chcesz zrozumieć ogólną mechanikę importu i harmonogramu — Przegląd importu danych.
