↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak podłączyć kasę eparagony.pl do Elbuz

    4 min czytaniaZaktualizowano

    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).

    Co przygotować w eparagony.pl

    1. Umowa. Sklep zawiera ją bezpośrednio z eparagony.pl, Elbuz nie jest stroną umowy. Cennik — na eparagony.pl.
    2. E-mail z danymi dostępowymi. Po rejestracji eparagony przysyła client_id, client_secret i posId — identyfikator Twojego sklepu.
    3. Drukarka. Drukarka fiskalna łączy się z eparagony przez ich program eDPS, zgodnie z dokumentacją eparagony. Elbuz nie komunikuje się z drukarką bezpośrednio.
    4. 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.

    Formularz podłączenia eparagony.pl: dane dostępowe, identyfikator sklepu, firma i przełącznik sandbox
    1client_id
    2client_secret
    3posId
    4Środowisko testowe (sandbox)
    1. client_id z e-maila od eparagony.
    2. Zapisana wartość jest widoczna jako kropki.
    3. Identyfikator sklepu z tego samego e-maila.
    4. Dla kluczy testowych eparagony.
    PoleCo wpisać lub wybrać
    AktywnośćWłącz, gdy wpiszesz wszystkie trzy wartości. Wyłączona kasa nie jest proponowana w dokumentach
    client_id, client_secretZ e-maila od eparagony. Zapisany client_secret jest w polu widoczny jako kropki
    posIdIdentyfikator sklepu z tego samego e-maila
    Firma„Dowolna” albo firma, której dokumenty idą przez tę kasę
    Płatnik VATWłączone — stawka pochodzi z pozycji dokumentu lub z towaru. Wyłączone — wszystkie pozycje idą ze stawką E
    Paragon przy płatności przez linkParagon 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 odbiorzeTak 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

    1. Wpisz klucze testowe eparagony, włącz „Środowisko testowe (sandbox)” i „Aktywność”.
    2. Otwórz swoje zamówienie w złotych i kliknij „Paragon fiskalny”.
    3. 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.

    Wynik wystawienia testowego paragonu przez eparagony.pl
    1Numer paragonu
    2Testowy, niefiskalny
    3Otwórz paragon
    1. Numer, kwota w złotych i data zapisują się w dokumencie.
    2. Środowisko testowe: paragon bez mocy prawnej.
    3. 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 ElbuzNa paragonie eparagony
    „Płatnik VAT” włączony, stawka 23 / 8 / 5 / 0%A / B / C / D
    Przełącznik „Płatnik VAT” wyłączonyE — zwolnione, dla wszystkich pozycji
    GotówkaGotówka
    KartaKarta
    „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 dokumentosobna 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

    Komunikaty kasy eparagony.pl
    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, 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

    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