Automatyzacja e-paragonów
Dzień dobry,
tak zgadza się, taka automatyzacja jest możliwa.
2,3 - po wystawieniu przez API Paragonu w Fakturowni, należy przesłać drugie żądanie jego fiskalizacji, lub włączyć automatyczną fiskalizację paragonów tworzonych przez API w Fakturowni.
W obu przypadkach, jeśli w edycji drukarki w Ustawienia -> Drukarki fiskalne w Fakturowni, ustawiony będzie domyślny sposób fiskalizacji na E-Paragon, do drukarki zostanie przesłane zlecenie e-paragonu zamiast wydruku fizycznego.
https://pomoc.fakturownia.pl/179236547-Automatyczna-fiskalizacja-paragonow-po-utworzeniu-przez-API
Do wystawienia e-Paragonu wymagamy uzupełnionego adresu e-mail Nabywcy. Jeśli go nie będzie, żądanie nie zostanie przesłane do drukarki. Niezafiskalizowane paragony można przefiltrować w Fakturowni i zlecić ich wydruk fizyczny, lub uzupełnić adres e-mail i zlecić e-Paragon.
4 - w oby przypadkach, papieru i e-paragonu, drukarka zapisuje sprzedaż w swojej pamięci chronionej i wysyła dane do CRK.
Natomiast w przypadku e-paragonu, drukarka zamiast wydruku papierowego, wysyła dane fiskalne na nasz serwer, które odkodowujemy i tworzymy wizualizację e-Paragonu, do której link można przesłać Klientowi mailowo.
Wysyłkę mailowo można zautomatyzować:
https://pomoc.fakturownia.pl/179433234-Automatyczne-wysylanie-e-paragonow-e-mailem
5 - Od razu po wystawieniu Paragonu w Fakturowni przez API, zwrotnie dostaną Państwo jego dane. Natomiast link do podglądu e-Paragonu pojawi się dopiero po jego fiskalizacji, co może trwać dłużej - np. w przypadku braku internetu na drukarce, drukarka próbuje wysłać e-paragon kilkukrotnie, a później co godzinę, lub w przypadku braku prądu - trzeba będzie ponownie nawiązać połączenie z drukarką i dopiero wtedy zlecenia fiskalizacji będą realizowane. Poza wysyłką mailową z Fakturowni, jeśli chcą Państwo umieścić też link do e-Paragonu w swojej aplikacji, są dwie możliwości:
-
można skonfigurować webhook invoice:update, który po aktualizacji dokumentu na koncie, wyśle na wskazany URL dane dokumentu. Link do podglądu e-Paragonu znajduje się w rekordzie “e_receipt_view_url”.
https://pomoc.fakturownia.pl/1239014-Integracja-danych-z-Fakturowni-za-pomoca-webhookow -
można też umieścić link do podglądu Paragonu (niefiskalnego) z Fakturowni - po fiskalizacji na drukarce, w tym podglądzie pojawi się również przycisk “Zobacz e-Paragon”.
https://github.com/fakturownia/api?tab=readme-ov-file#view_url
Zgodnie z przepisami, Klient musi otrzymać dostęp do pliku JSON z danymi z drukarki, chociaż same te dane nie będą dla niego czytelne. Dlatego Klientowi należy przekazać link do podglądu e-Paragonu - z poziomu tej wizualizacji danych, Klient ma możliwość w razie potrzeby pobrania pliku JSON oraz wizualizacji e-Paragonu w PDF.
6 - tak, raporty dobowe / miesięczne, nadal generujemy na drukarce, tak samo jak w przypadku paragonów papierowych.
E-paragony pozwalają wyeliminować papier, natomiast w drukarce powinna być włożona rolka papieru - raporty miesięczne nadal trzeba na niej wydrukować, oraz w przypadku problemu z połączeniem / internetem, drukarka wydrukuje paragon papierowo i będzie próbować wysłać e-paragon ponownie (nie powoduje to podwójnej fiskalizacji).
W przypadku dodatkowych pytań, jestem do dyspozycji.
Pozdrawiam,
Kacper
Customer Reviews
Dzień dobry,
-
Nie ma możliwości pobrania pliku JSON z pełnymi danymi przesłanymi przez drukarkę. Dane przesłane przez drukarkę przechowywane są w naszym HUBie, nie ma możliwości pobrania ich przez API. Odkodowany plik JWS można pobrać jedynie po wejściu w podgląd e-paragonu.
Poprzez webhook mogą Państwo uzyskać link do e-paragonu, natomiast w danym podglądzie będzie nasze logo Paragony.pl by Fakturownia. Nie ma możliwości usunięcia logo naszego HUBa. -
W przeciwieństwie do wydruków fizycznych, do wystawienia e-paragonu, drukarka musi być zafiskalizowana. Istnieją drukarki technologiczne zafiskalizowane z serwerem testowym CRK. W kwestii uzyskania tego typu urządzenia, trzeba kontaktować się bezpośrednio z producentem drukarek.
-
Najwięcej testów przeprowadzaliśmy na drukarkach Posnet Thermal HX Online oraz Posnet Thermal XL2 Online.
Pozdrawiam,
Kacper
Dziękuję za tak wyczerpującą odpowiedź.
-
Czy któreś z wymienionych zapytań zwraca dane w postaci JSON po fiskalizacji e-paragonu? Zależy nam na “generowaniu” pdf’a ze wspomnianego JSON’a z paragonem w naszym serwisie. Musimy wysyłać maila z naszego systemu mailowego wraz z linkiem do paragonu w naszym systemie. W otrzymanych założeniach nie możemy kierować użytkowników do zewnętrznych serwisów, ani wysyłać maili z marką zewnętrznego serwisu, dlatego wyświetlanie danych potrzebujemy zrobić po naszej stronie. Czy wasze API bezproblemowo zwróci dane w postaci JSON’a? Wtedy po naszej stronie zostanie przedstawienie tego w postaci czytelnej i możliwej do druku dla użytkownika.
-
Czy drukarki mają jakieś opcje testowe, aby przed fiskalizacją wykonać odpowiednie testy automatyzacji? Zakładam, że państwo również muszą mieć takie środowisko testowe z połączoną testową drukarką fiskalną.
-
W przypadku powyższego pytania, na jakich drukarkach wykonują państwo testy? Decydując się na integrację z państwa serwisem przed zakupem drukarki fiskalnej preferowalibyśmy model, który jest stosunkowo niezawodny. Wtedy zakładam, że jedynymi utrudnieniami zostanie awaryjność dostawy prądu, internetu i dostępności państwa serwisu.
Dziękuję za odpowiedzi. Uważam, że dla wielu firm pełna automatyzacja w tym obszarze to nieoceniona wartość.
Dzień dobry,
tak zgadza się, taka automatyzacja jest możliwa.
2,3 - po wystawieniu przez API Paragonu w Fakturowni, należy przesłać drugie żądanie jego fiskalizacji, lub włączyć automatyczną fiskalizację paragonów tworzonych przez API w Fakturowni.
W obu przypadkach, jeśli w edycji drukarki w Ustawienia -> Drukarki fiskalne w Fakturowni, ustawiony będzie domyślny sposób fiskalizacji na E-Paragon, do drukarki zostanie przesłane zlecenie e-paragonu zamiast wydruku fizycznego.
https://pomoc.fakturownia.pl/179236547-Automatyczna-fiskalizacja-paragonow-po-utworzeniu-przez-API
Do wystawienia e-Paragonu wymagamy uzupełnionego adresu e-mail Nabywcy. Jeśli go nie będzie, żądanie nie zostanie przesłane do drukarki. Niezafiskalizowane paragony można przefiltrować w Fakturowni i zlecić ich wydruk fizyczny, lub uzupełnić adres e-mail i zlecić e-Paragon.
4 - w oby przypadkach, papieru i e-paragonu, drukarka zapisuje sprzedaż w swojej pamięci chronionej i wysyła dane do CRK.
Natomiast w przypadku e-paragonu, drukarka zamiast wydruku papierowego, wysyła dane fiskalne na nasz serwer, które odkodowujemy i tworzymy wizualizację e-Paragonu, do której link można przesłać Klientowi mailowo.
Wysyłkę mailowo można zautomatyzować:
https://pomoc.fakturownia.pl/179433234-Automatyczne-wysylanie-e-paragonow-e-mailem
5 - Od razu po wystawieniu Paragonu w Fakturowni przez API, zwrotnie dostaną Państwo jego dane. Natomiast link do podglądu e-Paragonu pojawi się dopiero po jego fiskalizacji, co może trwać dłużej - np. w przypadku braku internetu na drukarce, drukarka próbuje wysłać e-paragon kilkukrotnie, a później co godzinę, lub w przypadku braku prądu - trzeba będzie ponownie nawiązać połączenie z drukarką i dopiero wtedy zlecenia fiskalizacji będą realizowane. Poza wysyłką mailową z Fakturowni, jeśli chcą Państwo umieścić też link do e-Paragonu w swojej aplikacji, są dwie możliwości:
-
można skonfigurować webhook invoice:update, który po aktualizacji dokumentu na koncie, wyśle na wskazany URL dane dokumentu. Link do podglądu e-Paragonu znajduje się w rekordzie “e_receipt_view_url”.
https://pomoc.fakturownia.pl/1239014-Integracja-danych-z-Fakturowni-za-pomoca-webhookow -
można też umieścić link do podglądu Paragonu (niefiskalnego) z Fakturowni - po fiskalizacji na drukarce, w tym podglądzie pojawi się również przycisk “Zobacz e-Paragon”.
https://github.com/fakturownia/api?tab=readme-ov-file#view_url
Zgodnie z przepisami, Klient musi otrzymać dostęp do pliku JSON z danymi z drukarki, chociaż same te dane nie będą dla niego czytelne. Dlatego Klientowi należy przekazać link do podglądu e-Paragonu - z poziomu tej wizualizacji danych, Klient ma możliwość w razie potrzeby pobrania pliku JSON oraz wizualizacji e-Paragonu w PDF.
6 - tak, raporty dobowe / miesięczne, nadal generujemy na drukarce, tak samo jak w przypadku paragonów papierowych.
E-paragony pozwalają wyeliminować papier, natomiast w drukarce powinna być włożona rolka papieru - raporty miesięczne nadal trzeba na niej wydrukować, oraz w przypadku problemu z połączeniem / internetem, drukarka wydrukuje paragon papierowo i będzie próbować wysłać e-paragon ponownie (nie powoduje to podwójnej fiskalizacji).
W przypadku dodatkowych pytań, jestem do dyspozycji.
Pozdrawiam,
Kacper