Kod QR ONLINE na wydrukach

W ramach integracji z  KSeF API 2.0 , wprowadzono mechanizm automatycznego generowania i umieszczania kodu QR ONLINE na wydrukach dokumentów sprzedaży. Kod ten umożliwia natychmiastową weryfikację faktury w systemie ministerialnym za pomocą urządzenia mobilnego. 

 Działanie: Po pomyślnej wysyłce dokumentu do KSeF i nadaniu mu numeru KSeF ID , system generuje unikalny kod QR, który zostaje naniesiony na wydruk PDF. 

 Charakterystyka kodu QR na wydruku 

 

 Lokalizacja: Kod QR drukowany jest wraz z napisem pomocniczym "sprawdź w ksef" . 

 Formaty: 

 

 Wydruk PDF: Zawiera graficzny kod QR. 

 Wydruk tekstowy (TXT) / E-mail TXT: Ze względu na ograniczenia formatu, zamiast kodu graficznego drukowany jest sam numer KSeF ID . 

 

 

 Obsługiwane dokumenty: Faktury (FV), Korekty (ZW), Faktury zaliczkowe (ZAL) oraz Korekty faktur zaliczkowych (KOR ZAL). 

 

 

 Warunki pojawienia się kodu QR 

 Aby kod QR został naniesiony na dokument, muszą zostać spełnione następujące warunki: 

 

 Dokument musi zostać poprawnie przetworzony przez bramkę KSeF (status: Wysłany ). 

 Dokument musi posiadać nadany numer KSeF ID . 

 Wydruk musi być realizowany w formacie obsługującym grafikę (np. PDF, cairo.desk). 

 

 Uwaga! Kod QR nie pojawi się na dokumentach: 

 

 Wystawionych w trybie offline, które nie zostały jeszcze przesłane do KSeF. 

 Starych fakturach, które zostały wysłane przed wdrożeniem funkcjonalności KSeF API 2.0. 

 Dokumentach typu Asygnata (DD). 

 

 Konfiguracja czasu oczekiwania (Timeout) 

 W związku z tym, że kod QR jest generowany na podstawie danych z systemu KSeF, system ERP musi poczekać na odpowiedź z serwerów ministerstwa przed wygenerowaniem wydruku. Procesem tym steruje parametr: 

 Parametr: KsefSendTimeout (Maksymalny czas oczekiwania na wysyłkę faktury w sekundach - uzyskania ksefid)  Wartość domyślna: 30 sekund. 

 Procedura odpytywania o status wygląda następująco: 

 

 System wysyła fakturę i rejestruje ją w KSeF. 

 Jeśli status nie jest znany natychmiast, system ponawia zapytanie w interwałach (2s, 2s, 3s, 4s... itd.) aż do osiągnięcia sumarycznego czasu określonego w parametrze KsefSendTimeout . 

 Jeśli w tym czasie KSeF nie nada numeru ID, dokument zostanie wydrukowany bez kodu QR (można go przedrukować później po uzyskaniu statusu).