Przejdź do treści głównej

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

image.png

Warunki pojawienia się kodu QR

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

  1. Dokument musi zostać poprawnie przetworzony przez bramkę KSeF (status: Wysłany).
  2. Dokument musi posiadać nadany numer KSeF ID.
  3. 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).
Powrót na górę