Dzień dobry,
mam pytanie dotyczące pełnej automatyzacji e-paragonów w serwisie. Planujemy zastąpić wyświetlanie dla klienta faktury imiennej systemem e-paragonów, co wymaga automatyzacji całego procesu. Chciałbym zapytać, czy taka automatyzacja jest możliwa w obecnej konfiguracji serwisu lub jakie są dostępne opcje?
Z tego, co rozumiem, proces wyglądałby następująco:
1. Drukarka fiskalna jest podłączona do komputera, na którym działa oprogramowanie 24/7.
2. Po zaksięgowaniu płatności, nasz system wysyła do fakturowni - dane klienta oraz szczegóły sprzedaży przez API.
3. Fakturownia wysyła dane do programu zainstalowanego na komputerze (połączonym z drukarką fiskalną).
4. Drukarka drukuje paragon (lub, w przypadku e-paragonu, zapisuje go w pamięci? - tak to obecnie rozumiem).
5. Nasz system pobiera przez API fakturowni - wygenerowany PDF, który następnie udostępniamy klientowi.
6. Na koniec miesiąca generowany jest "ręcznie" wydruk miesięczny z zestawieniem sprzedaży - dla księgowości.
Czy taki przepływ jest możliwy do zautomatyzowania w serwisie? Zależy mi na pełnym zautomatyzowaniu procesu, nawet jak to nieszczęsne urządzenie musi być podłączone do fizycznego komputera 24/7. Chociaż jak rozumiem w przypadku e-paragonów, nie wymaga kontroli papieru i zbędnego generowania dźwięku.
Napisałem na forum, może komuś jeszcze pomoże.
Z góry dziękuję za pomoc i wszelkie odpowiedzi!
Automatyzacja e-paragonów pytanie Rozwiązane
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
Komentarze
Kacper_Seta
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
2025-02-13 18:00
Mateo
1. 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.
2. 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ą.
3. 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ść.
2025-02-14 18:50
Kacper_Seta
1. 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.
2. 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.
3. Najwięcej testów przeprowadzaliśmy na drukarkach Posnet Thermal HX Online oraz Posnet Thermal XL2 Online.
Pozdrawiam,
Kacper
2025-02-20 18:13