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).