eparagony.pl to kasa dla sklepu w Polsce. Elbuz wysyła sprzedaż do eparagony, ta drukuje paragon na Twojej drukarce fiskalnej, a kupujący dostaje e-paragon w linku. W Elbuz wpisujesz trzy wartości z e-maila od eparagony: client_id, client_secret i posId.
Kiedy to się przyda:
- Sprzedajesz z Elbuz w Polsce — paragon drukuje się sam, kasjer nie wbija go ręcznie.
- Chcesz najpierw sprawdzić — z kluczami testowymi eparagony paragon przechodzi całą drogę bez drukarki.
- Masz kasę na Ukrainie — zajrzyj do Vchasno.Kasa lub Checkbox.
Od czego zacząć: zawrzyj umowę z eparagony.pl i poczekaj na e-mail z danymi dostępowymi.
Co potrafi kasa eparagony.pl
Dział „Kasy PRRO” opisuje kasy ukraińskie. eparagony.pl jest w tej samej grupie „Paragony fiskalne”, ale działa według polskich zasad: paragon drukuje drukarka fiskalna, a nie kasa programowa (PRRO).
- Paragon sprzedaży w złotych — z zamówienia, faktury, okna „Kasa” albo sam przy płatności przez link.
- Polskie stawki VAT i formy płatności — Elbuz zamienia je na litery i nazwy, które rozumie drukarka.
- Środowisko testowe — sprawdzenie z kluczami testowymi, bez mocy prawnej.
- Bez duplikatów — ponowienie po błędzie znajduje ten sam paragon i nie drukuje drugiego.
Co przygotować w eparagony.pl
- Umowa. Sklep zawiera ją bezpośrednio z eparagony.pl, Elbuz nie jest stroną umowy. Cennik — na eparagony.pl.
- E-mail z danymi dostępowymi. Po rejestracji eparagony przysyła client_id, client_secret i posId — identyfikator Twojego sklepu.
- Drukarka. Drukarka fiskalna łączy się z eparagony przez ich program eDPS, zgodnie z dokumentacją eparagony. Elbuz nie komunikuje się z drukarką bezpośrednio.
- Stawki VAT na drukarce. Litery muszą odpowiadać standardowi: A 23%, B 8%, C 5%, D 0%, E — zwolnione. Elbuz wysyła dokładnie te litery.
Jak skonfigurować kasę w Elbuz
Gdzie: Panel klienta → Ustawienia systemu → „Inne ustawienia” → kafelek „Usługi zewnętrzne i integracje” → grupa „Paragony fiskalne” → wiersz „eparagony.pl”, ołówek.
1
client_id2
client_secret3
posId4
Środowisko testowe (sandbox)- client_id z e-maila od eparagony.
- Zapisana wartość jest widoczna jako kropki.
- Identyfikator sklepu z tego samego e-maila.
- Dla kluczy testowych eparagony.
| Pole | Co wpisać lub wybrać |
|---|---|
| Aktywność | Włącz, gdy wpiszesz wszystkie trzy wartości. Wyłączona kasa nie jest proponowana w dokumentach |
| client_id, client_secret | Z e-maila od eparagony. Zapisany client_secret jest w polu widoczny jako kropki |
| posId | Identyfikator sklepu z tego samego e-maila |
| Firma | „Dowolna” albo firma, której dokumenty idą przez tę kasę |
| Płatnik VAT | Włączone — stawka pochodzi z pozycji dokumentu lub z towaru. Wyłączone — wszystkie pozycje idą ze stawką E |
| Paragon przy płatności przez link | Paragon drukuje się sam, gdy kupujący zapłacił w całości przez link |
| Środowisko testowe (sandbox) | Włącz dla kluczy testowych eparagony. Dla produkcyjnych — wyłącz |
| Płatność przy odbiorze | Tak jak w innych kasach: „Paragon przy wysyłce” lub „Nie wystawiaj” |
Formularz zapisuje się sam: na dole pojawia się „Zapisano”. Nowy client_id lub client_secret kasuje zapisane logowanie, a kolejny paragon zaloguje się już nowymi danymi. Przełącznika zamykania zmiany tu nie ma: zmianę i raport dobowy prowadzi drukarka.
Jak sprawdzić w środowisku testowym
- Wpisz klucze testowe eparagony, włącz „Środowisko testowe (sandbox)” i „Aktywność”.
- Otwórz swoje zamówienie w złotych i kliknij „Paragon fiskalny”.
- Wybierz sposób płatności i kliknij „Wystaw paragon”. Elbuz czeka na potwierdzenie do 25 sekund.
Wynik: numer paragonu, kwota, data, oznaczenie „testowy, niefiskalny” i link „Otwórz paragon” do e-paragonu. W środowisku testowym zamiast drukarki działa emulator eparagony. Dlatego otwarty e-paragon zawsze pokazuje usługę cateringową na 460 PLN z datą z 2022 roku — tak działa eparagony, to nie błąd Elbuz.
1
Numer paragonu2
Testowy, niefiskalny3
Otwórz paragon- Numer, kwota w złotych i data zapisują się w dokumencie.
- Środowisko testowe: paragon bez mocy prawnej.
- Link do e-paragonu.
Aby przejść na prawdziwą kasę, zamień klucze na produkcyjne i wyłącz „Środowisko testowe (sandbox)”. Paragon testowy nie przeszkadza w wydrukowaniu prawdziwego do tego samego dokumentu.
Co trafia na paragon
Paragon wystawia się tak samo jak w innych kasach: przyciskiem „Paragon fiskalny” w dokumencie, z okna „Kasa” albo sam przy płatności przez link. Jak działa okno paragonu — w artykule o paragonach.
| W Elbuz | Na paragonie eparagony |
|---|---|
| „Płatnik VAT” włączony, stawka 23 / 8 / 5 / 0% | A / B / C / D |
| Przełącznik „Płatnik VAT” wyłączony | E — zwolnione, dla wszystkich pozycji |
| Gotówka | Gotówka |
| Karta | Karta |
| „Przelew na rachunek bieżący”, „Przelew z karty” | Przelew |
| Pozostałe sposoby: „Płatność internetowa”, „Przelew przez kod QR”, „Bezgotówkowo” itd. | Mobilna |
| Rabat na dokument | osobna pozycja „Rabat” |
Paragon wystawia się tylko do dokumentu w złotych i tylko jako paragon sprzedaży na całą kwotę: paragonu zaliczkowego ani zwrotu eparagony.pl nie drukuje. Nazwa towaru na paragonie jest skracana do 42 znaków — to limit drukarki. Po potwierdzeniu dokument zachowuje numer paragonu i link do e-paragonu.
Scenariusze
Sklep w Polsce sprzedaje przez stronę z płatnością przez link
Co zrobić. Podłącz kasę i włącz „Paragon przy płatności przez link”.
Co wyjdzie. Gdy kupujący zapłaci za zamówienie w całości, paragon drukuje się sam, a link do e-paragonu pojawia się w dokumencie. Jeśli się nie uda, administratorzy dostają powiadomienie, a Elbuz ponawia próbę co godzinę.
Sprzedaż w sklepie z okna „Kasa”
Co zrobić. Podłącz eparagony.pl i sprzedawaj z „Kasy” jak zwykle.
Co wyjdzie. Każda sprzedaż jest nabijana na drukarce fiskalnej, kasjer nie wbija paragonu na drukarce drugi raz.
Masz firmę na Ukrainie i firmę w Polsce
Co zrobić. Podłącz obie kasy i przypisz każdą do jej firmy w polu „Firma”.
Co wyjdzie. Dokument polskiej firmy w złotych pójdzie do eparagony.pl, dokument ukraińskiej firmy w hrywnach — do Checkbox lub Vchasno.Kasa.
Co zrobić, gdy paragon się nie wystawia
| 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, jedno z trzech pól jest puste albo firma kasy nie pasuje do dokumentu | Sprawdź formularz kasy (konfiguracja) |
| „Ta kasa wystawia paragony tylko w walucie PLN: dokument ma inną walutę.” | Dokument nie jest w złotych | Zmień walutę dokumentu na PLN |
| „Paragon nie został wystawiony: eparagony: auth HTTP …” | eparagony nie przyjęło client_id lub client_secret albo klucze testowe wpisano bez przełącznika „Środowisko testowe (sandbox)” (lub odwrotnie) | Przepisz klucze z e-maila i sprawdź przełącznik |
| „Paragon nie został wystawiony: eparagony: VAT rate 20 is not a Polish rate (23, 8, 5, 0)” | Pozycja dokumentu lub towar ma stawkę spoza polskich | Ustaw towarom polskie stawki (jak ustawić stawkę) i wystaw paragon ponownie |
| „Kasa eparagony.pl wystawia tylko paragony sprzedaży: paragonu zwrotu ani zaliczki nie można tu utworzyć.” | W oknie paragonu wybrano rodzaj „Zaliczka (płatność częściowa)” albo w „Kasie” sprzedano kartę podarunkową | Poczekaj na pełną płatność i wystaw „Pełny paragon z towarami” |
| „Paragon nie został wystawiony: eparagony: payment … is not supported” | Część sprzedaży opłacono kartą podarunkową lub rozliczoną zaliczką | Takiej sprzedaży nie da się nabić przez eparagony.pl; jak ją udokumentować, decyduje księgowy |
| „Paragon niepotwierdzony: eparagony: the fiscal printer has not confirmed the receipt yet (…). Kliknij ponownie: powtórzenie nie utworzy drugiego paragonu.” | Drukarka nie potwierdziła paragonu w ciągu 25 sekund: na przykład jest wyłączona albo eDPS nie jest uruchomiony | Sprawdź drukarkę i kliknij „Wystaw paragon” ponownie: Elbuz znajdzie ten sam dokument w eparagony |
| „Paragon nie został wystawiony: eparagony: fiscal printer error …” | Drukarka odmówiła druku, przyczyna jest w tekście po dwukropku | Usuń przyczynę na drukarce lub w eDPS i wystaw paragon ponownie |
Najczęstsze pytania
Jak kupujący dostanie e-paragon?
Link do e-paragonu jest zapisany w dokumencie jako „Otwórz paragon”. Elbuz nie przekazuje do eparagony e-maila ani telefonu kupującego, więc link wyślij kupującemu sam.
Kupujący zwrócił towar. Co zrobić w Elbuz?
Wystaw dokument zwrotu jak zwykle. Paragonu zwrotu nie będzie: w Polsce zwroty ewidencjonuje się w rejestrze zwrotów sprzedawcy, dlatego przy zwrocie Elbuz nie proponuje kasy eparagony.pl.
Kupujący zapłacił część przez link. Czy będzie paragon?
Nie: eparagony.pl nie drukuje paragonów zaliczkowych, więc przy częściowej płatności Elbuz nie wystawia paragonu. Gdy kupujący dopłaci przez link, paragon na całą kwotę wydrukuje się sam. Dopłatę w inny sposób zamknij przyciskiem „Paragon fiskalny”.
Co się stanie, jeśli wyłączę „Aktywność”?
Przycisk paragonu zniknie z nowych dokumentów, automatyczne paragony przestaną się wystawiać. Dokumenty z wystawionymi paragonami zachowują przycisk, klucze w formularzu zostają.
Czy trzeba otwierać zmianę w Elbuz?
Nie. Zmianę i raport dobowy prowadzi drukarka, Elbuz tylko wysyła sprzedaż.
Gdzie to jest i kto ma dostęp
- Menu
- Panel klienta → Ustawienia systemu → „Inne ustawienia” → „Usługi zewnętrzne i integracje” → grupa „Paragony fiskalne” → eparagony.pl
- Wystawienie paragonu
- karta zamówienia klienta lub faktury → „Paragon fiskalny”; okno „Kasa”
- Uprawnienia
- okno „API i tokeny dostępu” w uprawnieniach grup
- Przygotuj
- umowę z eparagony.pl, e-mail z client_id, client_secret i posId, drukarkę fiskalną z eDPS
Powiązane tematy
- Jeśli potrzebujesz ogólnego obrazu kas w Elbuz — Kasy PRRO: paragony fiskalne z Elbuz.
- Jeśli kasa jest podłączona i czas wystawiać paragony — Jak wystawić paragon fiskalny i co zrobić przy zwrocie.
- Jeśli sprzedajesz w sklepie z kasy — Kasa: jak sprzedawać w sklepie w kilka sekund.
- Jeśli towary nie mają stawek VAT — Jak ustawić stawkę VAT towarom i dokumentom.
