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
- Podłączenie tokenem — jeden klucz na jedną kasę, bez kasjera i hasła w Elbuz.
- Ustawienia kasy — firma, VAT, paragon automatyczny, zamknięcie zmiany, pobranie.
- Przebieg testowy — prawdziwa ścieżka paragonu bez urzędu skarbowego.
- Zamiana na kasę produkcyjną — zmiana tokenu; paragony testowe nie przeszkadzają prawdziwym.
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.
- Na kasa.vchasno.com.ua kliknij „Зареєструватися” (Zarejestruj się), podaj e-mail i hasło, potwierdź e-mail z wiadomości.
- Dodaj plik klucza KEP/EDS firmy (kwalifikowany podpis elektroniczny), wpisz hasło i sprawdź dane.
- Wybierz „Тестувати” (Testuj), aby najpierw pracować bez urzędu skarbowego, albo „Почати роботу” (Rozpocznij pracę), aby wystawiać prawdziwe paragony.
- 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).
- 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:
- W panelu Vchasno.Kasa w menu po lewej otwórz „Торгові точки та каси” (Punkty sprzedaży i kasy).
- Wybierz kasę i kliknij koło zębate: otworzą się ustawienia.
- Przewiń do pozycji „Токен” (Token), kliknij „Згенерувати токен” (Wygeneruj token) i skopiuj wartość.
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.
1
Skąd wziąć token2
Token kasy3
Płatnik VAT4
Zamykaj zmianę co wieczór- Podpowiedź mówi, gdzie w panelu Vchasno.Kasa wziąć token.
- Zapisana wartość tokenu nigdy nie wraca do pola.
- Gdy „Płatnik VAT” jest wyłączony, wszystkie pozycje idą bez VAT.
- 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.
| Pole | Co robi | Domyślnie |
|---|---|---|
| Aktywność | Wyłączona — kasa nie jest proponowana, przycisk paragonu znika. Wystawione już paragony zostają w dokumentach | wyłączone |
| Token kasy | Klucz kasy z panelu | puste |
| Firma | „Dowolna” — dla wszystkich dokumentów; konkretna — tylko dla dokumentów tej firmy | Dowolna |
| Płatnik VAT | Włączony — stawka pochodzi z pozycji dokumentu lub z produktu. Wyłączony — 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 crona tworzy raport Z o 22:30 lub 23:30 czasu kijowskiego, zależnie od pory roku | włączone |
| Płatność przy odbiorze | Tryb dla paczek za pobraniem, wybiera go księgowy | Paragon przy wysyłce |
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.
- Wpisz token kasy testowej i włącz „Aktywność”.
- Otwórz zamówienie klienta w hrywnach i kliknij „Paragon fiskalny”. Do testu 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”.
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.
1
Numer paragonu2
Oznaczenie „testowy, niefiskalny”3
Otwórz paragon- Numer paragonu — numer, kwota i data zapisują się w dokumencie.
- „Testowy, niefiskalny” — taki paragon nie trafia do urzędu i nie przeszkadza prawdziwemu.
- „Otwórz paragon” — link do podglądu i wydruku paragonu.
Jak przejść na prawdziwą kasę
- Zamknij zmianę kasy testowej przyciskiem „Zamknij zmianę”.
- Wygeneruj token prawdziwej kasy i wpisz go w pole „Token kasy” w miejsce starego.
- Sprawdź „Płatnik VAT”, „Firma” i pozostałe przełączniki: nie zależą od kasy i zostają bez zmian.
- 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
| 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, 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
- 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 rozważasz drugą opcję — Jak podłączyć kasę Checkbox.
