generowanie kodu QR

[toudi]

czy wiadomo co miałoby się znaleźć na tym kodzie? przeryłem specyfikacje swagger i nie widzę tam odpowiedniego endpointu. po przeanalizuwaniu artykułów z google oraz UPO w formie XML widzę, że jest tam coś takiego:

<ds:DigestValue>( treść base64 )</ds:DigestValue>

czy to właśnie tą treść miałbym podstawić ? artykuły mówią także o kluczu i generowaniu QR offline ale nie wiem gdzie znaleźć dokumentację

[asoio]

Dokumentacja dotycząca kodu QR ma być dopiero opublikowana:
"W najbliższych dniach przedstawimy do uzgodnień również specyfikację oprogramowania interfejsowego, w tym opis wymagań technicznych dla kodów weryfikujących (tzw. kodów QR ) uwzględniającą proponowane rozwiązania. Materiał ten opublikujemy na stronie MF."
https://www.gov.pl/web/finanse/konsultacje-rozporzadzen-w-sprawie-powszechnego-krajowego-systemu-e-faktur-ksef

[toudi]

zaimplementowałem u siebie wsparcie do pobierania faktur z KSeF (w XML i PDF) i zauważyłem że wizualizacje PDF KSeF mają na ostatniej stronie kod QR. Jego treścią jest link postaci:

https://{srodowisko}/web/verify/{nrFakturyKSeF}/{kod}

gdzie kod to najprawdopodobniej wartość skrótu faktury aczkolwiek nie chce mi się teraz tego sprawdzać bo jestem po całonocnej sesji walki z KSeF. Rzecz jasna dalej nie ma żadnych informacji o tym jak wygenerować ten kod offline..

[alapierre]

w najnowszej wersji peseudo dokumentacji do API KSeF jest kilka akapitów wyjaśnienia, z błędami: https://ksef-test.mf.gov.pl/document/InterfaceSpecification/1.5/PL

na dzień dzisiejszy specyfikacja API (wersja 1.5) w sekcji 16.11 ("Linki weryfikacyjne") podaje niepoprawną postać linku ( %environment_path %/web/common/verification/{ksefReferenceNumber}/{hash} ). Działająca postać, podana w przykładach na następnej stronie i w używana w wizualizacjach z Aplikacji Podatnika to:

<serwer (produkcyjny | demo | testowy)>/web/verify/{ksefReferenceNumber}/{hash}

[toudi]

zacząłem grzebać dalej w plikach i popatrzcie:

mój przykładowy plik z fakturą:

sha256sum foo.xml 
5638f72741654cf8f0cf0558ac4352f99b218ebc4b29522ed68e8932dfbfec6f foo.xml

teraz wziąłem tą sumę kontrolną i zakodowałem w base64:

python3
>>> bytes.fromhex('5638f72741654cf8f0cf0558ac4352f99b218ebc4b29522ed68e8932dfbfec6f')
b"V8\xf7'AeL\xf8\xf0\xcf\x05X\xacCR\xf9\x9b!\x8e\xbcK)R.\xd6\x8e\x892\xdf\xbf\xeco"
>>> import base64
>>> base64.b64encode(bytes.fromhex('5638f72741654cf8f0cf0558ac4352f99b218ebc4b29522ed68e8932dfbfec6f'))
b'Vjj3J0FlTPjwzwVYrENS+ZshjrxLKVIu1o6JMt+/7G8='

i to jest dokładnie to co widnieje jako wartość skrótu (w oryginalnym QR kodzie) z tą drobną różnicą, że znak "+" jest zamieniony na encję HTML (%2B), podobnie jak znak "=" (%3D) oraz "/" (%2F). na początku bałem się, że skrót będzie generowany na podstawie indywidualnego certyfikatu (np. SHA-HMAC) albo jakiś bardziej wyrafinowany sposób) ale wygląda na to że jest to proste do bólu :D

pozdrawiam wszystkich walczących :D

// edit: odpowiednia funkcja z pythona to:

from urllib.parse import quote_plus

więc finalna suma liczona jest tak:

quote_plus(base64.b64encode(bytes.fromhex('5638f72741654cf8f0cf0558ac4352f99b218ebc4b29522ed68e8932dfbfec6f')))
'Vjj3J0FlTPjwzwVYrENS%2BZshjrxLKVIu1o6JMt%2B%2F7G8%3D'

w golang jest to najprawdopodobniej funkcja QueryEscape: https://pkg.go.dev/net/url#QueryEscape

p.s. oczywiście mam świadomość, że można sumę sha256 wygenerować od razu z postaci tablicy bajtów a nie ciągu hex :D

[toudi]

tak na marginesie to powyższy fakt oznacza ni mniej ni więcej że między bajki można włożyć informację o generowaniu kodu offline - bo w linku jest wrzucony numer referencyjny z KSeF. Gdyby taki QRKod był faktycznie powiązany z certyfikatem i zawierał jedynie sumę kontrolną to co innego - wówczas KSeF mógłby po swojej stronie zrobić odwrotną relację (skrót z certyfikatu -> numer w KSeF) a użytkownik mógłby wygenerować QRKod niezależnie.. chyba, że źle myślę?

[alapierre]

odnośnie generowania offline, to MF nie opisał jeszcze technicznych kwestii z tym związanych. Pewnie będzie to się opierać o podpis niekwalifikowany, który będzie wystawiał KSeF.

[alapierre]

w kliencie KSeF dodaliśmy możliwość generowania kodów QR - kod jest jeszcze w review, ale dziś na koniec dnia zrobię wersję stabilną i wrzucę do Maven Central.

[toudi]

u mnie też już jest generowanie kodów oraz przykładowych plików :) teraz pracuję nad wizualizacją własną ale najpierw muszę wprowadzić logowanie do programu bo bez niego bardzo ciężko się debuguje :)