Jak sprawdzić generowanie PDF i kodów QR
System musi generować czytelną wizualizację PDF z danych XML faktury (dla człowieka) oraz kody QR umożliwiające weryfikację autentyczności. Kod QR weryfikujący MUSI być na KAŻDEJ fakturze (online i offline). Kod QR certyfikatu jest TYLKO dla faktur offline. Rozmieszczenie kodów musi być zgodne z wytycznymi MF - kontrahenci muszą móc łatwo zeskanować kody.
Kroki do wykonania
1. Sprawdź generowanie wizualizacji PDF
System musi konwertować plik XML faktury na czytelny PDF. Sprawdź:
- Wystaw fakturę testową w środowisku demo
- Wygeneruj PDF (powinien być przycisk 'Pobierz PDF' lub 'Wizualizacja')
- Otwórz PDF i sprawdź czy zawiera: wszystkie dane z nagłówka (numer faktury, data, NIP sprzedawcy i nabywcy), wszystkie pozycje faktury (nazwy, ilości, ceny, VAT), podsumowanie (netto, VAT, brutto), numer KSeF (jeśli online) lub oznaczenie 'OFFLINE' (jeśli offline)
- Sprawdź czytelność - czy PDF wygląda profesjonalnie? Czy dane są czytelne? Czy układ jest logiczny? Jeśli PDF jest nieczytelny lub brakuje danych - to problem dla kontrahentów, którzy otrzymają taki dokument.
2. Sprawdź kod QR weryfikujący (ZAWSZE obecny)
Kod QR weryfikujący MUSI być na każdej fakturze (online i offline). Pozwala kontrahentowi zweryfikować autentyczność faktury przez stronę KSeF. Sprawdź:
- Wygeneruj PDF faktury ONLINE - czy widzisz kod QR?
- Zeskanuj kod QR telefonem (aparat lub aplikacja QR)
- Powinieneś zostać przekierowany na https://ksef.mf.gov.pl/web/weryfikacja
- Na stronie weryfikacji powinieneś zobaczyć: numer KSeF, datę wystawienia, NIP sprzedawcy i nabywcy, kwotę brutto, status 'Zweryfikowana'
- Sprawdź położenie kodu na PDF - czy jest widoczny? Czy nie jest zasłonięty przez tekst? Zalecane miejsce: prawy górny róg lub dolna część faktury.
Jeśli kod QR nie działa lub nie ma go wcale - FAKTURA NIE BĘDZIE MOGŁA BYĆ ZWERYFIKOWANA!
3. Sprawdź kod QR certyfikatu (TYLKO faktury offline)
Kod QR certyfikatu pojawia się TYLKO na fakturach offline. Zawiera informacje o certyfikacie typu 2 użytym do podpisania faktury offline. Sprawdź:
- Wygeneruj fakturę w trybie offline (przełącz system w tryb offline24)
- Wygeneruj PDF - powinieneś zobaczyć DWA kody QR (weryfikujący + certyfikatu)
- Zeskanuj kod QR certyfikatu (drugi kod)
- Powinieneś zobaczyć dane certyfikatu: numer seryjny, datę ważności (od-do), NIP wystawcy, status certyfikatu (aktywny/nieaktywny)
- Sprawdź czy NIP w certyfikacie = NIP wystawcy na fakturze.
Kod QR certyfikatu pozwala kontrahentowi zweryfikować autentyczność faktury offline PRZED jej dosłaniem do KSeF. Jeśli faktury offline mają tylko JEDEN kod QR - to BŁĄD, brakuje kodu certyfikatu!
4. Sprawdź rozmieszczenie kodów QR zgodnie z wytycznymi
Ministerstwo Finansów ma wytyczne dotyczące rozmieszczenia kodów QR na wizualizacji. Sprawdź:
- Kod QR weryfikujący: zalecane miejsce to prawy górny róg lub dolna część faktury (widoczny bez przewijania)
- Kod QR certyfikatu (offline): powinien być obok kodu weryfikującego lub tuż pod nim
- Oba kody powinny mieć opis tekstowy (np. 'KOD WERYFIKUJĄCY' i 'KOD CERTYFIKATU')
- Kody nie mogą być: zasłonięte przez tekst/logo, zbyt małe (minimum 2x2 cm w druku), zniekształcone lub rozmazane.
Przetestuj: Wydrukuj fakturę offline na papierze i spróbuj zeskanować OBA kody telefonem z odległości 10-20 cm. Jeśli skanowanie się nie udaje - kody są źle umieszczone lub za małe.
5. Test różnicy: Faktura online vs offline
Porównaj PDF faktury online i offline:
- Wystaw tę samą fakturę dwa razy: raz w trybie online, raz w trybie offline
- Wygeneruj PDF obu faktur i otwórz obok siebie
- Faktura ONLINE powinna mieć: jeden kod QR (weryfikujący), numer KSeF (format NNN-NNNNNNNNNN-NNNNNNNNNN-NN)
- Faktura OFFLINE powinna mieć: DWA kody QR (weryfikujący + certyfikatu), oznaczenie 'OFFLINE' lub 'TRYB OFFLINE24/AWARIA', tymczasowy identyfikator (zamiast numeru KSeF, dopóki nie zostanie dosłana), informację o terminie dosłania
- Jeśli faktury wyglądają identycznie (lub offline ma tylko jeden kod QR) - system NIE ROZRÓŻNIA trybów, co jest BŁĘDEM.
6. Test skanowania kodów QR na urządzeniach mobilnych
Kontrahenci będą skanować kody QR telefonami. Przetestuj na różnych urządzeniach:
- Wygeneruj PDF faktury (online i offline)
- Wyświetl PDF na ekranie komputera lub wydrukuj na papierze
- Zeskanuj kod QR weryfikujący używając: aparatu iPhone (iOS), aparatu Android, dedykowanej aplikacji do skanowania QR (np. QR Code Reader)
- Sprawdź czy wszystkie urządzenia odczytują kod i przekierowują na stronę weryfikacji KSeF
- Dla faktury offline - zeskanuj również kod QR certyfikatu i sprawdź dane certyfikatu.
Jeśli którekolwiek urządzenie nie może zeskanować kodu - to problem z formatem, rozmiarem lub jakością kodu.
7. Weryfikacja zgodności z wymaganiami
Checklist weryfikacyjny: ✓ PDF zawiera wszystkie dane faktury (nagłówek, pozycje, podsumowanie)? ✓ PDF jest czytelny i profesjonalny? ✓ Kod QR weryfikujący na KAŻDEJ fakturze (online + offline)? ✓ Kod QR weryfikujący działa (przekierowuje na stronę weryfikacji)? ✓ Kod QR certyfikatu TYLKO na fakturach offline? ✓ Kod QR certyfikatu działa (pokazuje dane certyfikatu)? ✓ Oba kody są widoczne i łatwe do zeskanowania? ✓ Kody mają opisy tekstowe ('WERYFIKUJĄCY', 'CERTYFIKAT')? ✓ Rozmieszczenie zgodne z wytycznymi MF? Jeśli wszystkie punkty są ✓ - wizualizacja PDF i kody QR są poprawne. Jeśli brakuje kodu QR certyfikatu na fakturach offline - to KRYTYCZNY BŁĄD!