Jak działa VisualEReceipt
Jeden obieg dokumentu - cztery kroki, kilka sekund. Poniżej dokładnie to, co dzieje się między Twoim systemem, naszym serwerem a drukarką fiskalną.
1. Twój system wysyła paragon
Po opłaceniu zamówienia Twój system sprzedaży wywołuje POST /api/v1/print/receipt
z pozycjami paragonu: nazwami, ilościami, cenami w groszach, stawkami VAT, płatnościami,
opcjonalnie rabatami, kaucjami i NIP-em nabywcy. Żądanie autoryzujesz tokenem przypisanym
do Twojej drukarki.
Źródłem żądania może być sklep internetowy, ale równie dobrze kasa biletowa czy stanowisko obsługi - wiele stanowisk może korzystać z tej samej drukarki jednocześnie.
Zanim cokolwiek trafi na drukarkę, sprawdzamy dwie rzeczy:
- Duplikaty - jeśli zamówienie o tym numerze zostało już zafiskalizowane w Twoim systemie, nie drukujemy go ponownie. Odpowiadamy natychmiast danymi istniejącego e-paragonu, linkiem i flagą
duplicate: true. - Kolejkę - równoległe żądania do tej samej drukarki są automatycznie serializowane, więc wydruki nie kolidują ze sobą. Dzięki temu jedna drukarka spokojnie obsługuje wiele stanowisk sprzedaży naraz.
2. Fiskalizacja na drukarce Posnet
Łączymy się z drukarką natywnym protokołem Posnet po TCP/IP - niezależnie od tego, czy urządzenie stoi u Ciebie, czy w naszej serwerowni. Na drukarkę trafiają kolejno: pozycje sprzedaży, rabaty, opakowania zwrotne (kaucje), formy płatności i zakończenie transakcji. Drukarka fiskalizuje paragon w trybie e-paragonu.
Już w tym momencie znamy przyszły adres paragonu - wyliczamy go na podstawie numeru unikatowego drukarki i numeru paragonu. Dzięki temu link możemy zwrócić od razu, nie czekając, aż e-paragon technicznie spłynie z urządzenia.
3. Drukarka odsyła e-paragon
Drukarka Posnet, skonfigurowana przez nasz panel, samodzielnie wypycha e-paragon na nasz serwer - jako podpisany dokument w formacie zgodnym z JPK. Dekodujemy go, zapisujemy oryginał oraz odczytane dane i wiążemy z wcześniej wydanym adresem. Proces jest idempotentny: ponowne przesłanie tego samego dokumentu niczego nie zdubluje.
4. Klient ogląda paragon online
Pod publicznym adresem /paragon/… klient widzi czytelny
e-paragon: sprzedawcę, pozycje, sumy VAT, płatności - wraz z logo Twojej marki,
jeśli je ustawisz w panelu. Link możesz wysłać mailem, SMS-em albo pokazać jako kod QR.
W tle: monitoring, alerty, raporty
- Monitoring drukarek - cyklicznie sprawdzamy łączność z każdą drukarką. Gdy urządzenie nie odpowiada, po 2 minutach wysyłamy alert e-mail (z ochroną przed zalewem powiadomień).
- Alert o błędzie wydruku - nieudana fiskalizacja to natychmiastowy e-mail do Twojego zespołu z opisem problemu i numerem zamówienia.
- Automatyczne raporty fiskalne - raport dobowy każdej nocy, miesięczny pierwszego dnia miesiąca, roczny na początku roku. Bez klikania.
- Panel administracyjny - podgląd paragonów i historii żądań, test połączenia, status papieru, zdalna konfiguracja drukarki.