eparagony.pl — e-paragony i faktury KSeF z zamówień
Noxti wysyła sprzedaż do eparagony.pl, a ten drukuje i fiskalizuje paragon na Twojej drukarce fiskalnej. Kupujący dostaje e-mail z linkiem do e-paragonu, a na życzenie powstaje też faktura w KSeF.
Co to robi
eparagony.pl stoi między Noxti a Twoją drukarką fiskalną. Kiedy Noxti wysyła zamówienie, drukarka je fiskalizuje, a kupujący dostaje link do e-paragonu. Ta sama integracja potrafi też wystawić fakturę VAT w KSeF.
Podłączenie
- Integracje → katalog → eparagony.pl → dodaj połączenie.
- W sekcji bezpieczeństwa wpisz dane od eparagony.pl: ID klienta API, Sekret klienta API i ID punktu sprzedaży (posId). Integrator dostaje też ID integratora.
- Uzupełnij Tabelę stawek VAT drukarki fiskalnej (A-G) dokładnie tak, jak jest zaprogramowana w drukarce. Jeśli stawki z zamówienia nie ma w tabeli, paragon nie zostanie wystawiony. Noxti nigdy nie podstawia po cichu 0%. Pozycje bez stawki (Allegro jej nie przesyła) dostają Domyślną stawkę VAT (23%).
- Ustaw formy płatności dla zamówień opłaconych z góry i dla pobrań.
- Wpisz Sekret webhooka, a statusy będą przychodzić od razu. Bez niego Noxti sprawdza je co 5 minut.
Wystawianie
- Ręcznie: w szczegółach zamówienia karta Dokumenty fiskalne → Wystaw przy e-paragonie albo fakturze KSeF.
- Automatycznie: reguła Workflow z akcją Wystaw e-paragon fiskalny. To reguła decyduje, które zamówienia dostają paragon — kanał sprzedaży, pobranie, opłacenie, kraj, status. Akcja wymaga uprawnienia do tej akcji w rolach.
Które zamówienia: wzory reguł
Zbuduj osobną regułę dla każdego kanału i sposobu płatności. Przykłady:
| Reguła | Kiedy | Jeżeli | Wtedy |
|---|---|---|---|
| Przedpłaty z Allegro | zmiana statusu na „Opłacone” | Kanał = Allegro, NIE Płatność za pobraniem, Opłacone | Wystaw e-paragon fiskalny |
| Pobrania ze sklepu | zmiana statusu na „Wysłane” | Kanał = Sklep, Płatność za pobraniem | Wystaw e-paragon fiskalny |
| Tylko Polska | dowolny | dodaj warunek Kraj dostawy = Polska | Wystaw e-paragon fiskalny |
Kanałów, których nie fiskalizujesz (np. B2B albo marketplace z własnym dokumentem), po prostu nie obejmuj żadną regułą.
Klient chce fakturę. Akcja ma ustawienie Gdy klient chce fakturę:
- Nie wystawiaj paragonu (domyślnie) — fakturę wystawi inna reguła albo inny system, np. wFirma;
- Wystaw zamiast niego fakturę KSeF — przez to samo połączenie eparagony.pl.
Warunek Klient chce fakturę możesz też dodać do dowolnej reguły.
Zanim włączysz paragony dla przedpłat, sprawdź z księgową, czy sprzedaż wysyłkowa opłacona przelewem nie jest u Ciebie zwolniona z kasy fiskalnej.
Wystawianie z karty wymaga uprawnienia Zamówienia > Wystawianie paragonów i faktur w Zespół i dostęp → Role i uprawnienia oraz prawa dodawania w module Zamówienia. Bez niego karta pokazuje dokumenty, ale bez przycisków.
Paragon nie zostanie wystawiony, gdy:
- zamówienie jest w innej walucie niż PLN;
- zamówienie opłacane z góry nie jest jeszcze opłacone;
- zamówienie jest anulowane albo dane kupującego zostały usunięte;
- zamówienie ma już fakturę w innym systemie księgowym (np. wFirma) — sprzedaż byłaby wykazana dwa razy.
Do jednego zamówienia powstaje jeden paragon albo faktura do paragonu — także gdy masz kilka połączeń eparagony.pl. Fakturę wystawisz dopiero po zafiskalizowaniu paragonu, na ten sam NIP. Ponowne kliknięcie i ponowne uruchomienie reguły nie wystawiają drugiego dokumentu. Po zerwanym połączeniu Noxti najpierw pyta eparagony.pl, czy dokument już istnieje, a dopiero potem ponawia z tym samym kluczem.
Statusy na karcie
| Status | Co znaczy |
|---|---|
| Wysyłanie do eparagony.pl | Dokument jest wysyłany. |
| Ponawiane automatycznie | eparagony.pl nie odpowiedział. Noxti sprawdzi i ponowi sam co kilka minut. Możesz też kliknąć Ponów — Noxti najpierw zapyta, czy dokument już powstał. |
| Czeka na fiskalizację | eparagony.pl przyjął dokument, drukarka jeszcze go nie potwierdziła. |
| Wystawiono, błąd doręczenia | Paragon jest wydrukowany, ale nie dotarł do repozytorium e-paragonów. Noxti nie wystawi drugiego i przestaje go sprawdzać — wyjaśnij to w eparagony.pl. |
| Wystawiono | Dokument zafiskalizowany. Link otwiera e-paragon, przy fakturze widać numer KSeF. |
| Fiskalizacja nieudana | Pod statusem stoi powód, np. błąd drukarki albo zła stawka VAT. Popraw przyczynę i kliknij Ponów. |
E-mail do kupującego
Po zafiskalizowaniu paragonu Noxti wysyła kupującemu e-mail z linkiem. Wysyłkę wyłącza ustawienie Wyślij kupującemu e-mail z linkiem do paragonu. Treść maila zmienisz w szablonie eparagony_receipt w ustawieniach powiadomień. Ikoną koperty na karcie wyślesz mail ponownie. Faktury KSeF nie są wysyłane mailem.
Allegro
Gdy włączysz Dołącz paragon do zamówień z Allegro, eparagony.pl przekaże paragon do zamówienia na Allegro. Działa tylko dla zamówień, które przyszły z Allegro.
Faktura KSeF
Faktura wymaga NIP Twojej firmy w ustawieniach firmy oraz adresu kupującego z polskim kodem pocztowym w formacie NN-NNN — faktur KSeF dla adresów zagranicznych integracja nie wystawia. Gdy eparagony.pl zgłosi fakturę jako duplikat w KSeF, Noxti nie ponawia jej sam: sprawdź ją w panelu eparagony.pl. Jeśli faktury tam nie ma, kliknij Wystaw mimo to. Jeśli zamówienie ma już wystawiony paragon, faktura zostanie oznaczona jako faktura do paragonu.
Czego nie ma
- Paragonów zwrotnych i korekt, bo eparagony.pl ich nie obsługuje.
- Wysyłki faktur KSeF mailem.
Chcesz zobaczyć to na swoich zamówieniach? Pokażemy NOXTI na Twoich kanałach sprzedaży i Twoim magazynie.
Umów prezentację