Kasę Checkbox podłączasz do Elbuz danymi kasjera i kluczem licencji kasy: od tej chwili paragon fiskalny wystawiasz prosto z karty zamówienia. Kasę, kasjera i podpis konfigurujesz w panelu my.checkbox.ua, a zmianę Elbuz otwiera sam.
Co to daje:
- Nie masz jeszcze kasy — panel sam składa wnioski do urzędu skarbowego, a darmowy klucz DepositSign nie wymaga pliku.
- Chcesz najpierw spróbować — kasa i kasjer testowi pojawiają się zaraz po rejestracji, urząd skarbowy nie jest potrzebny.
- Kasa już działa — wpisujesz jej dane i paragony z Elbuz idą przez nią.
Od czego zacząć: weź dane kasjera testowego i wpisz je w formularz Checkbox w Elbuz.
Co daje podłączenie Checkbox
- Dwa sposoby logowania kasjera — login i hasło albo sam kod PIN.
- Ustawienia kasy — firma, VAT, automatyczny paragon, zamknięcie zmiany, płatność przy odbiorze.
- Tryb testowy — prawdziwa ścieżka paragonu bez urzędu skarbowego.
- Jasne przyczyny awarii — podpis, stawka VAT, klucz licencji.
Jak zarejestrować kasę i kasjera w Checkbox
Rejestracja odbywa się w panelu Checkbox, który sam składa wnioski do ukraińskiego urzędu skarbowego (DPS). Poniższe kroki opisano według pomocy Checkbox na dzień 06.11.2026: pierwsze kroki, kasy, kasjerzy.
- Panel. Zarejestruj się na my.checkbox.ua i dodaj dane firmy z urzędu skarbowego: potrzebny będzie klucz dyrektora.
- Punkt sprzedaży. Punkty już zarejestrowane w urzędzie skarbowym pobierają się przy synchronizacji. Nowy rejestruje się formularzem 20-OPP z panelu.
- Kasa. Sekcja „Каси” (Kasy) → „Додати касу” (Dodaj kasę), punkt sprzedaży z listy, typ PRRO „Інтернет-торгівля” (handel internetowy). Wniosek podpisuje się kluczem z pliku, Diia.Pidpys lub SmartID. Status „На реєстрації” (w rejestracji) zmienia się na „Активна” (aktywna) po około 5–10 minutach.
- Kasjer i klucz. Sekcja „Касири” (Kasjerzy) → „Додати касира” (Dodaj kasjera), dalej „Створити ключ DepositSign” (utwórz klucz DepositSign) lub „Через ключ ЕЦП” (kluczem podpisu elektronicznego). Wymyśl login i hasło i podpisz wniosek.
- Checkbox.Pidpys. Jeśli klucz jest w pliku: w wierszu kasjera trzy kropki → „Запустити Checkbox.Підпис на захищеному хмарному сервісі” (uruchom Checkbox.Pidpys w chronionej usłudze chmurowej), ACSK (centrum certyfikacji kluczy), plik, hasło, „Запустити” (Uruchom). Po 3–5 minutach przy kasjerze pojawi się status „Агент підпису працює” (agent podpisu działa).
- Stawki. Domyślnie panel ma tylko „Без ПДВ” (bez VAT). Płatnik VAT dodaje swoje stawki: zmieniać je można przy zamkniętej zmianie, zmiany obowiązują od następnej.
Kasjer pracuje naraz tylko z jedną kasą. FOP (ukraińska jednoosobowa działalność) może zarejestrować kasjera na własny klucz, a dla TOV (ukraińskiej spółki z o.o.) pomoc wymaga osobnej pieczęci na każdą kasę.
Jakich danych potrzebuje Elbuz i gdzie je znaleźć
| Pole w Elbuz | Co wpisać | Skąd wziąć |
|---|---|---|
| Login kasjera | Login kasjera. Zostaw puste, jeśli logujesz się PIN-em | wymyślony przy dodawaniu kasjera, sekcja „Касири” (Kasjerzy) |
| Hasło kasjera lub PIN | Hasło kasjera albo, przy pustym loginie, kod PIN | wymyślone przy dodawaniu kasjera; hasła nie da się odzyskać, tylko zmienić: „Касири” → „Дії” (Działania) → „Редагувати” (Edytuj) → „Новий пароль” (Nowe hasło) |
| Klucz licencji kasy | Klucz tej kasy, przez którą idą paragony | panel my.checkbox.ua, sekcja „Каси” (Kasy) |
| Klucz integracji (opcjonalnie) | Zostaw puste, jeśli wsparcie Checkbox go nie wydało | wsparcie Checkbox |
Login kasjera jest unikalny w całym Checkbox. Opublikowana pomoc nie pokazuje dokładnie, gdzie na ekranie jest klucz licencji i kod PIN. Jeśli nie możesz ich znaleźć w panelu, zapytaj wsparcie Checkbox.
Jak skonfigurować kasę w Elbuz
Gdzie: „Panel klienta” → „Ustawienia systemu” → „Inne ustawienia” → kafelek „Usługi zewnętrzne i integracje” → grupa „Paragony fiskalne” → wiersz „Checkbox”, ołówek.
1
Login kasjera2
Hasło kasjera lub PIN3
Klucz licencji kasy4
Klucz integracji (opcjonalnie)- Login kasjera — zostaw puste, aby logować się samym PIN-em wpisanym w polu hasła obok.
- Hasło kasjera lub PIN — zapisana wartość nie jest już nigdy pokazywana.
- Klucz licencji kasy — osobny klucz dla każdej kasy.
- Klucz integracji — wypełnij tylko, jeśli wydało go wsparcie Checkbox.
Formularz zapisuje się sam: na dole pojawia się „Zapisano”. Zapisane hasło i klucz licencji nie są pokazywane w polach. Nowe wartości zerują sesję kasjera, a następne zapytanie zaloguje się już z nimi.
| Pole | Co robi | Domyślnie |
|---|---|---|
| Aktywność | Wyłączona — kasa nie jest proponowana, przycisk paragonu znika. Wystawione już paragony zostają w dokumentach | wyłączone |
| Firma | „Dowolna” — dla wszystkich dokumentów; konkretna — tylko dla dokumentów tej firmy | Dowolna |
| Płatnik VAT | Włączone — stawka pochodzi z pozycji dokumentu lub produktu. Wyłączone — wszystkie pozycje idą bez VAT | wyłączone |
| Paragon przy płatności przez link | Paragon wystawia się sam przy płatności przez link do płatności | wyłączone |
| Zamykaj zmianę co wieczór | Zadanie cron tworzy raport Z o 22:30 lub 23:30 czasu kijowskiego. Dodatkowo przy otwarciu zmiany Checkbox otrzymuje godzinę automatycznego zamknięcia 23:30 | włączone |
| Płatność przy odbiorze | Tryb dla paczek za pobraniem, wybiera go księgowy | Paragon przy wysyłce |
Blok „Zmiana” pod formularzem pokazuje „Zmiana otwarta” lub „Zmiana zamknięta”. Jeśli jest tam treść błędu, dane kasjera lub klucz licencji nie pasują. To pierwsza kontrola i paragon nie jest do niej potrzebny.
Jak wystawić pierwszy paragon w trybie testowym
Kasa i kasjer testowi pojawiają się w sekcjach „Каси” i „Касири” zaraz po rejestracji, KEP (kwalifikowany podpis elektroniczny) nie jest do nich potrzebny. Limit — 100 paragonów testowych miesięcznie. Paragonu testowego nie wolno wydawać klientowi: to nie jest dokument rozliczeniowy.
- Wpisz w formularz Checkbox dane kasjera testowego i klucz licencji kasy testowej, włącz „Aktywność”.
- Otwórz zamówienie klienta w hrywnach i kliknij „Paragon fiskalny”. Do sprawdzenia weź własne zamówienie.
- Sprawdź sposób płatności.
- Wyłącz „Wyślij paragon na”, jeśli w dokumencie jest kontakt prawdziwego klienta.
- Kliknij „Wystaw paragon” i poczekaj. Pierwszy paragon w zmianie trwa dłużej, bo Elbuz najpierw otwiera zmianę.
Wynik: numer, kwota, data, oznaczenie „testowy, niefiskalny” i link „Otwórz paragon”. Ten sam paragon z oznaczeniem „Тестовий чек” (paragon testowy) jest w panelu, w „Архів чеків” (archiwum paragonów). Nie przeszkadza w wystawieniu prawdziwego paragonu do tego dokumentu.
1
Numer paragonu2
Testowy, niefiskalny3
Otwórz paragon- Numer paragonu — numer, kwota i data zapisują się w dokumencie.
- „testowy, niefiskalny” — to kasa testowa: paragon nie trafia do urzędu skarbowego.
- Otwórz paragon — link do wystawionego paragonu.
Aby przejść na prawdziwą kasę, zamknij zmianę testową, zamień w formularzu dane kasjera i klucz licencji i upewnij się, że blok „Zmiana” nie pokazuje błędu.
Scenariusze
FOP sam sprzedaje przez stronę
Co zrobić. Zarejestruj kasę z typem „Інтернет-торгівля”, kasjera na własny klucz, uruchom Checkbox.Pidpys, wpisz dane w Elbuz.
Efekt. Paragony podpisują się same, komputera z kluczem nie trzeba trzymać włączonego.
Kasjer nie chce przekazywać hasła do panelu
Co zrobić. Zostaw „Login kasjera” puste, a w „Hasło kasjera lub PIN” wpisz kod PIN.
Efekt. Elbuz loguje się parą „klucz licencji + PIN”. Ten sposób pomoc Checkbox nazywa zalecanym.
Kasa już działa w aplikacji Checkbox
Co zrobić. Zamknij zmianę i podłącz w Elbuz tego samego kasjera albo drugiego do drugiej kasy: jeden kasjer pracuje naraz tylko z jedną kasą.
Efekt. Paragony z zamówień widać i w Elbuz, i w panelu. Paragonów wystawionych wcześniej w aplikacji Elbuz nie widzi, a danych takiego paragonu Checkbox od Elbuz nie przyjmuje. Jak obsłużyć zwrot do niego, opisuje sekcja o paragonie z innego programu.
Co zrobić, gdy kasa nie działa
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Kasa nie jest podłączona. Włącz ją i wpisz klucz w «Usługi zewnętrzne» → «Paragony fiskalne».” | Kasa jest wyłączona, nie wpisano hasła lub klucza licencji albo firma kasy nie pasuje do dokumentu | Sprawdź formularz kasy (ustawienia) |
| „Checkbox: sign in HTTP …” | Checkbox nie przyjął loginu, hasła, PIN-u lub klucza licencji | Wpisz dane ponownie (gdzie je znaleźć). Przy PIN-ie zostaw login pusty |
| „Checkbox: shift was not opened, check the signing key in the Checkbox account” | Usługa odmówiła otwarcia zmiany, zwykle z powodu klucza podpisu | Sprawdź status „Агент підпису працює” i ważność klucza w panelu (rejestracja) |
| „Checkbox: VAT rate … is not set up in the Checkbox account” | Takiej stawki nie ma w panelu Checkbox | Dodaj stawkę przy zamkniętej zmianie i kliknij „Wystaw paragon” jeszcze raz |
| „Paragon niepotwierdzony: Checkbox: receipt is still being fiscalized. Kliknij ponownie: powtórzenie nie utworzy drugiego paragonu.” | Usługa nie zdążyła przetworzyć paragonu w czasie oczekiwania | Poczekaj kilka minut i kliknij „Wystaw paragon” ponownie: Elbuz znajdzie ten sam paragon |
Komunikaty o samym paragonie w dokumencie omówiono w artykule o paragonach.
Najczęstsze pytania
Czym jest „Klucz integracji” i skąd go wziąć?
To opcjonalny klucz, który wydaje wsparcie Checkbox. Jeśli wsparcie go nie wydało, zostaw pole puste: kasa działa i bez niego.
Kto wysyła paragon klientowi?
Sam Checkbox, na e-mail i telefon, które Elbuz przekazał z dokumentu. Przekazywany jest tylko ukraiński numer telefonu, w formacie +380.
Czy trzeba otwierać zmianę przed paragonem?
Nie. Jeśli zmiana jest zamknięta, Elbuz sam otworzy ją przed paragonem i poczeka na potwierdzenie usługi.
Wygasł klucz KEP. Co zmieni się w Elbuz?
W Elbuz nie trzeba niczego zmieniać. Wymień klucz w panelu Checkbox przy zamkniętej zmianie. Dopóki klucz nie zostanie wymieniony, zmiana może się nie otworzyć.
Co się stanie, gdy wyłączę „Aktywność”?
Przycisk paragonu zniknie z nowych dokumentów, automatyczne paragony ustaną. Dokumenty z wystawionymi paragonami zachowują przycisk, dane w formularzu zostają. Włączenie przywraca wszystko, jak było.
Gdzie to jest i kto ma dostęp
- Menu
- „Panel klienta” → „Ustawienia systemu” → „Inne ustawienia” → „Usługi zewnętrzne i integracje” → grupa „Paragony fiskalne” → Checkbox
- Uprawnienia
- okno „API i tokeny dostępu” w uprawnieniach grup
- Przygotuj
- panel my.checkbox.ua; dla prawdziwej kasy — klucz KEP dyrektora lub FOP
Powiązane tematy
- Jeśli potrzebujesz ogólnego obrazu i informacji, kiedy paragon jest obowiązkowy — Kasy PRRO: paragony fiskalne z Elbuz.
- Jeśli kasa jest podłączona i czas zacząć pracę — Jak wystawić paragon fiskalny i co zrobić przy zwrocie.
- Jeśli wybierasz usługę i patrzysz na drugą opcję — Jak podłączyć Vchasno.Kasa.
