↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak podłączyć kasę Checkbox do Elbuz

    4 min czytaniaZaktualizowano

    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

    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.

    1. Panel. Zarejestruj się na my.checkbox.ua i dodaj dane firmy z urzędu skarbowego: potrzebny będzie klucz dyrektora.
    2. Punkt sprzedaży. Punkty już zarejestrowane w urzędzie skarbowym pobierają się przy synchronizacji. Nowy rejestruje się formularzem 20-OPP z panelu.
    3. 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.
    4. 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.
    5. 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).
    6. 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.
    Przy DepositSign nie pomiń ostatniego kroku w panelu: po akceptacji warunków kliknij czarny przycisk statusu „Відправити в ДПС” (wyślij do DPS). Dopóki kasjer nie jest zarejestrowany, zmiana się nie otworzy, a paragon nie powstanie. Szczegóły — w pomocy o kasjerach.

    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 ElbuzCo wpisaćSkąd wziąć
    Login kasjeraLogin kasjera. Zostaw puste, jeśli logujesz się PIN-emwymyślony przy dodawaniu kasjera, sekcja „Касири” (Kasjerzy)
    Hasło kasjera lub PINHasło kasjera albo, przy pustym loginie, kod PINwymyślone przy dodawaniu kasjera; hasła nie da się odzyskać, tylko zmienić: „Касири” → „Дії” (Działania) → „Редагувати” (Edytuj) → „Новий пароль” (Nowe hasło)
    Klucz licencji kasyKlucz tej kasy, przez którą idą paragonypanel my.checkbox.ua, sekcja „Каси” (Kasy)
    Klucz integracji (opcjonalnie)Zostaw puste, jeśli wsparcie Checkbox go nie wydałowsparcie 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.

    Formularz „Podłączenie Checkbox”: przełącznik aktywności, login kasjera, hasło lub PIN, klucz licencji kasy, klucz integracji, firma i przełączniki opcji
    1Login kasjera
    2Hasło kasjera lub PIN
    3Klucz licencji kasy
    4Klucz integracji (opcjonalnie)
    1. Login kasjera — zostaw puste, aby logować się samym PIN-em wpisanym w polu hasła obok.
    2. Hasło kasjera lub PIN — zapisana wartość nie jest już nigdy pokazywana.
    3. Klucz licencji kasy — osobny klucz dla każdej kasy.
    4. 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.

    PoleCo robiDomyślnie
    AktywnośćWyłączona — kasa nie jest proponowana, przycisk paragonu znika. Wystawione już paragony zostają w dokumentachwyłączone
    Firma„Dowolna” — dla wszystkich dokumentów; konkretna — tylko dla dokumentów tej firmyDowolna
    Płatnik VATWłączone — stawka pochodzi z pozycji dokumentu lub produktu. Wyłączone — wszystkie pozycje idą bez VATwyłączone
    Paragon przy płatności przez linkParagon wystawia się sam przy płatności przez link do płatnościwyłączone
    Zamykaj zmianę co wieczórZadanie cron tworzy raport Z o 22:30 lub 23:30 czasu kijowskiego. Dodatkowo przy otwarciu zmiany Checkbox otrzymuje godzinę automatycznego zamknięcia 23:30włączone
    Płatność przy odbiorzeTryb dla paczek za pobraniem, wybiera go księgowyParagon przy wysyłce
    Płatnik VAT włączył przełącznik, a w panelu Checkbox zostało tylko „Без ПДВ”. Paragon zatrzyma się na błędzie „VAT rate … is not set up”. Dodaj stawkę w panelu przy zamkniętej zmianie: Elbuz szuka tam dokładnie takiej samej stawki, jaka jest w pozycji.

    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.

    1. Wpisz w formularz Checkbox dane kasjera testowego i klucz licencji kasy testowej, włącz „Aktywność”.
    2. Otwórz zamówienie klienta w hrywnach i kliknij „Paragon fiskalny”. Do sprawdzenia weź własne zamówienie.
    3. Sprawdź sposób płatności.
    4. Wyłącz „Wyślij paragon na”, jeśli w dokumencie jest kontakt prawdziwego klienta.
    5. 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.

    Wynik paragonu fiskalnego: numer paragonu sprzedaży, kwota i data, oznaczenie testowy i niefiskalny, link „Otwórz paragon”
    1Numer paragonu
    2Testowy, niefiskalny
    3Otwórz paragon
    1. Numer paragonu — numer, kwota i data zapisują się w dokumencie.
    2. „testowy, niefiskalny” — to kasa testowa: paragon nie trafia do urzędu skarbowego.
    3. 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

    Komunikaty przy podłączaniu
    Co widziszDlaczego tak jestCo 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

    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