**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). [](https://wiki.cairo.pl/uploads/images/gallery/2026-01/GZyu0Ud8zIAYHHar-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).