↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak podłączyć Vchasno.Kasa do Elbuz

    4 min czytaniaZaktualizowano

    Vchasno.Kasa podłączasz do Elbuz jednym tokenem: od tej chwili paragon fiskalny wystawiasz prosto z karty zamówienia. Kasa, klucz podpisu i rejestracja w urzędzie skarbowym zostają w Twoim panelu Vchasno.Kasa.

    Co to daje:

    • Nie masz jeszcze kasy — formularz „3в1” (3 w 1) w panelu usługi rejestruje punkt sprzedaży, kasę i klucz kasjera za jednym razem.
    • Kasa już działa — wpisujesz jej token i paragony z Elbuz idą przez nią.
    • Chcesz najpierw sprawdzić — kasa testowa daje pełną ścieżkę: paragon widzisz w dokumencie, ale do urzędu on nie trafia.

    Od czego zacząć: wygeneruj token kasy testowej i wpisz go w Elbuz.

    Co daje podłączenie Vchasno.Kasa

    Jak zarejestrować kasę w Vchasno.Kasa

    Rejestracja odbywa się w panelu usługi, nie w Elbuz. Poniższe kroki opisano według pomocy Vchasno.Kasa na dzień 06.11.2026; jeśli panel wygląda inaczej, kieruj się pierwszymi krokami w usłudze.

    1. Na kasa.vchasno.com.ua kliknij „Зареєструватися” (Zarejestruj się), podaj e-mail i hasło, potwierdź e-mail z wiadomości.
    2. Dodaj plik klucza KEP/EDS firmy (kwalifikowany podpis elektroniczny), wpisz hasło i sprawdź dane.
    3. Wybierz „Тестувати” (Testuj), aby najpierw pracować bez urzędu skarbowego, albo „Почати роботу” (Rozpocznij pracę), aby wystawiać prawdziwe paragony.
    4. Dla prawdziwej kasy wypełnij formularz „3в1”: punkt sprzedaży, kasa, klucz kasjera. Dla sklepu internetowego typ kasy to „Інтернет-торгівля” (handel internetowy). Kliknij „Зареєструвати у ДПС” (Zarejestruj w DPS — ukraińskim urzędzie skarbowym).
    5. Poczekaj na odpowiedź urzędu. Pomoc podaje do 3 minut przy pierwszej konfiguracji i około 15 minut dla osobnych zapytań do DPS.

    Którym kluczem podpisywać — kluczem FOP (ukraińskiej jednoosobowej działalności), kasjera czy pieczęcią — opisuje pomoc usługi o kluczach. Klucz musi leżeć w magazynie kluczy panelu: bez niego, jak podaje opis chmurowego API, fiskalizacja nie działa.

    Kasa jest już zarejestrowana w urzędzie — panel zaproponuje jej import: zaznacz właściwy punkt i kasę. Ponowna rejestracja nie jest potrzebna.

    Tam też ustaw rodzaje płatności i grupy podatkowe. Elbuz przekazuje stawkę VAT z dokumentu, a kasa musi ją obsługiwać.

    Skąd wziąć token kasy

    Token jest osobny dla każdej kasy, także testowej. Według pomocy usługi:

    1. W panelu Vchasno.Kasa w menu po lewej otwórz „Торгові точки та каси” (Punkty sprzedaży i kasy).
    2. Wybierz kasę i kliknij koło zębate: otworzą się ustawienia.
    3. Przewiń do pozycji „Токен” (Token), kliknij „Згенерувати токен” (Wygeneruj token) i skopiuj wartość.
    Token wyświetla się tylko raz. Zgubiłeś go — wygeneruj nowy: stary przestanie działać i trzeba go zamienić w Elbuz. Usługa zaleca zmieniać token kasy dopiero po zamknięciu zmiany.

    Jak skonfigurować kasę w Elbuz

    Gdzie: Panel klienta → Ustawienia systemu → „Inne ustawienia” → kafelek „Usługi zewnętrzne i integracje” → grupa „Paragony fiskalne” → wiersz „Vchasno.Kasa”, ołówek.

    Formularz „Podłączenie Vchasno.Kasa”: podpowiedź, przełącznik aktywności, token kasy, firma, płatnik VAT, paragon przy płatności przez link, nocne zamknięcie zmiany, płatność przy odbiorze
    1Skąd wziąć token
    2Token kasy
    3Płatnik VAT
    4Zamykaj zmianę co wieczór
    1. Podpowiedź mówi, gdzie w panelu Vchasno.Kasa wziąć token.
    2. Zapisana wartość tokenu nigdy nie wraca do pola.
    3. Gdy „Płatnik VAT” jest wyłączony, wszystkie pozycje idą bez VAT.
    4. Raport Z powstaje automatycznie; przełącznik jest domyślnie włączony.

    Formularz zapisuje się sam, przycisku „Zapisz” nie ma: na dole pojawia się „Zapisano”. Zapisany token nie jest pokazywany w polu — widać tylko kropki.

    PoleCo robiDomyślnie
    AktywnośćWyłączona — kasa nie jest proponowana, przycisk paragonu znika. Wystawione już paragony zostają w dokumentachwyłączone
    Token kasyKlucz kasy z panelupuste
    Firma„Dowolna” — dla wszystkich dokumentów; konkretna — tylko dla dokumentów tej firmyDowolna
    Płatnik VATWłączony — stawka pochodzi z pozycji dokumentu lub z produktu. Wyłączony — 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 crona tworzy raport Z o 22:30 lub 23:30 czasu kijowskiego, zależnie od pory rokuwłączone
    Płatność przy odbiorzeTryb dla paczek za pobraniem, wybiera go księgowyParagon przy wysyłce
    Płatnik VAT zostawił przełącznik „Płatnik VAT” wyłączony: paragony idą jako „Без ПДВ” (bez VAT). Wystawionego paragonu nie da się poprawić, więc ustaw przełącznik przed pierwszym prawdziwym paragonem. Vchasno.Kasa przyjmuje stawki 20, 14, 7 i 0%. Inna stawka da błąd „VAT rate … is not supported”.

    Blok „Zmiana” pod formularzem pokazuje stan: „Zmiana otwarta” lub „Zmiana zamknięta”. Jeśli jest tam treść błędu — token nie pasuje: sprawdź go. To pierwsza kontrola klucza i paragon nie jest do niej potrzebny.

    Jak wystawić pierwszy paragon na kasie testowej

    Paragon testowy nie trafia do urzędu i nie przeszkadza w wystawieniu prawdziwego do tego samego dokumentu. Nie wolno go wysyłać klientowi: usługa wprost zabrania wydawania paragonów testowych kupującym.

    1. Wpisz token kasy testowej i włącz „Aktywność”.
    2. Otwórz zamówienie klienta w hrywnach i kliknij „Paragon fiskalny”. Do testu 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”.

    Wynik widać w oknie, a potem w oknie dialogowym dokumentu: numer, kwota, data, oznaczenie „testowy, niefiskalny” i link „Otwórz paragon”. Blok „Zmiana” w kasie pokaże „Zmiana otwarta”: otworzył ją pierwszy paragon.

    Okno wyniku paragonu fiskalnego: numer paragonu sprzedaży, kwota i data, oznaczenie „testowy, niefiskalny” i link „Otwórz paragon”
    1Numer paragonu
    2Oznaczenie „testowy, niefiskalny”
    3Otwórz paragon
    1. Numer paragonu — numer, kwota i data zapisują się w dokumencie.
    2. „Testowy, niefiskalny” — taki paragon nie trafia do urzędu i nie przeszkadza prawdziwemu.
    3. „Otwórz paragon” — link do podglądu i wydruku paragonu.

    Jak przejść na prawdziwą kasę

    1. Zamknij zmianę kasy testowej przyciskiem „Zamknij zmianę”.
    2. Wygeneruj token prawdziwej kasy i wpisz go w pole „Token kasy” w miejsce starego.
    3. Sprawdź „Płatnik VAT”, „Firma” i pozostałe przełączniki: nie zależą od kasy i zostają bez zmian.
    4. Upewnij się, że blok „Zmiana” nie pokazuje błędu. Pierwszy prawdziwy paragon sam otworzy zmianę.

    Paragony testowe zostają w dokumentach z oznaczeniem i nie wpływają na prawdziwy paragon do tej samej sprzedaży.

    Scenariusze

    Nie masz jeszcze kasy

    Co zrobić. Zarejestruj się w Vchasno.Kasa, wybierz „Тестувати” (Testuj), wygeneruj token i sprawdź w Elbuz jeden paragon. Potem wypełnij formularz „3в1” i zamień token.

    Efekt. Pierwszy prawdziwy paragon pojawia się dopiero wtedy, gdy menedżerowie zobaczyli całą ścieżkę.

    Kasa działa w Vchasno, paragony nabijane są ręcznie

    Co zrobić. Zamknij zmianę, wygeneruj nowy token, jeśli stary się zgubił, i wpisz go w Elbuz.

    Efekt. Paragon z zamówienia trafia na tę samą kasę. Paragonu sprzedaży wystawionego wcześniej w panelu Elbuz nie widzi: do zwrotu na jego podstawie służą osobne pola.

    Płatność przez link przez LiqPay

    Co zrobić. Włącz „Paragon przy płatności przez link” i podłącz usługę płatniczą.

    Efekt. Paragon ze sposobem płatności „LiqPay” wystawia się sam po wpływie płatności.

    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, token jest pusty albo firma kasy nie pasuje do dokumentu Sprawdź formularz kasy (ustawienia)
    „Вчасно.Каса: HTTP …” lub „Вчасно.Каса: ‹kod› ‹tekst›” w bloku „Zmiana” Usługa nie przyjęła żądania. Najczęściej token jest stary albo skopiowany ze zbędnymi znakami Wygeneruj nowy token i wpisz go (skąd go wziąć)
    „Вчасно.Каса: VAT rate … is not supported” Stawka pozycji nie należy do 20, 14, 7 ani 0% Popraw stawkę w pozycji dokumentu lub w produkcie
    „Paragon nie został wystawiony: Вчасно.Каса: …” z tekstem o kluczu Usługa nie może podpisać paragonu Sprawdź klucz w magazynie kluczy panelu (rejestracja)

    Tekst po nazwie usługi tworzy sama Vchasno.Kasa. Komunikaty o paragonie w dokumencie omawia artykuł o paragonach.

    Najczęstsze pytania

    Czy trzeba instalować Device Manager?

    Nie. Elbuz łączy się bezpośrednio z chmurowym API Vchasno.Kasa, więc na komputerze nie trzeba niczego instalować.

    Mam kilka kas w Vchasno. Jak podłączyć drugą?

    Jeden wiersz to jeden token, czyli jedna kasa. Drugą dodaj przyciskiem „Dodaj API” nad listą „Usługi zewnętrzne i integracje”, wybierając „Paragony fiskalne — Vchasno.Kasa”. W dokumencie pojawi się pole „Kasa” do wyboru.

    Czy trzeba co rano otwierać zmianę?

    Nie. Zmianę otwiera pierwszy paragon, a zamyka zadanie crona, jeśli nie wyłączono „Zamykaj zmianę co wieczór”.

    Co się stanie, jeśli wyłączę „Aktywność”?

    Przycisk paragonu zniknie z nowych dokumentów, paragony automatyczne ustaną. Dokumenty z wystawionymi paragonami zachowują przycisk, a token zostaje w formularzu. Ponowne włączenie przywraca wszystko, jak było.

    Czy paragony w Elbuz są płatne?

    Wystawienie paragonu niczego nie pobiera z salda Elbuz. Cennik kasy ustala Vchasno.Kasa w Twojej umowie.

    Gdzie to jest i kto ma dostęp

    Menu
    Panel klienta → Ustawienia systemu → „Inne ustawienia” → „Usługi zewnętrzne i integracje” → grupa „Paragony fiskalne” → Vchasno.Kasa
    Uprawnienia
    okno „API i tokeny dostępu” w „Uprawnieniach grup”
    Przygotuj
    panel Vchasno.Kasa; plik klucza KEP/EDS firmy do rejestracji

    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