Wprowadzenie
Gdy faktura zostaje przyjęta, KSeF zwraca UPO (urzędowe poświadczenie odbioru) i numer KSeF; czytelny PDF to wizualizacja, którą Notaly generuje z danych FA(3) i na której umieszcza oficjalny kod QR KOD I. KOD I i KOD II to dwa różne kody, a nie dwa stany jednego: KOD I to link weryfikacyjny budowany przez wystawcę z sumy SHA-256 pliku XML, a KOD II to kod QR wystawcy podpisany certyfikatem KSeF typu Offline, dodawany tylko na fakturze offline.
PDF to wizualizacja, nie faktura
KSeF to krajowa platforma e-fakturowania prowadzona przez Ministerstwo Finansów. KSeF nie zwraca PDF-a: po akceptacji zwraca UPO oraz numer KSeF. Ustrukturyzowany plik XML FA(3) to faktura w sensie prawnym, a PDF to czytelne dla człowieka odwzorowanie, które pokazujesz klientowi albo audytorowi. Notaly generuje ten PDF dla wysyłanych faktur i umieszcza na nim kod weryfikacyjny KOD I.
KOD I: link weryfikacyjny
KOD I nie jest kodem, który KSeF zwraca po akceptacji — wystawca buduje go sam, w trybie online i offline, z sumy SHA-256 dokładnego pliku XML faktury. Link ma postać https://{host}/invoice/{NIP sprzedawcy}/{data wystawienia}/{hash} i nie niesie numeru KSeF w adresie URL. Gdy faktura została przyjęta, pod kodem QR widnieje numer KSeF, dzięki czemu każdy może potwierdzić dokument w portalu KSeF; gdy nie została — ten sam kod pokazuje „OFFLINE" zamiast numeru.
KOD II: kod QR offline
KOD II to kod QR wystawcy podpisany certyfikatem KSeF typu Offline, z etykietą CERTYFIKAT; weryfikuje wystawcę przez link /certificate/. Zgodnie z procedurą offline KSeF 2.0 faktura wystawiona, gdy platforma jest niedostępna, ma oba kody QR — KOD I (z napisem „OFFLINE") i KOD II — a nie KOD II zamiast KOD I, i nic nie jest później podmieniane. Warunki wystawiania offline określa Ministerstwo Finansów, więc zanim się na tym oprzesz, potwierdź aktualną procedurę na podatki.gov.pl/KSeF.
Gdzie w Notaly pojawia się PDF
Notaly generuje PDF dla zaakceptowanej faktury i zwraca jego bezwzględny adres URL w webhooku invoice.accepted. Zapisz ten adres przy rekordzie faktury i udostępnij go klientowi, żeby zawsze miał weryfikowalną, nadającą się do druku kopię z kodem QR KOD I.
FAQ
Jaki kod QR jest na zaakceptowanej fakturze? KOD I — link weryfikacyjny wystawcy; po akceptacji widnieje pod nim numer KSeF.
Kiedy używa się KOD II? Na fakturze offline, obok KOD I, jako kod QR wystawcy podpisany certyfikatem KSeF typu Offline.
Zastrzeżenie
Notaly nie jest doradcą podatkowym, księgowym ani prawnym. Ten artykuł ma charakter informacyjny, nie stanowi porady podatkowej i może być nieaktualny. Ponosisz odpowiedzialność za własne rozliczenia VAT; w razie potrzeby skonsultuj się z wykwalifikowanym księgowym.
Źródła
Źródło: www.podatki.gov.pl