1.6 KiB
KSeF - Converter
Die Idee ist es Rechnungen nach Erhalt aus cargosoft über die KSeF FA(2) API an die Behörde zu senden.
API
Dokumentation: https://ksef-test.mf.gov.pl/docs/v2/index.html
Die Basis url ist: "https://ksef-test.mf.gov.pl/api/v2";
Der Ablauf für die Übermittlung ist folgender:
- vom Polnischen Goverment (bzw. AGL/Taxman) haben wir ein Secret bekommen (KSeFToken)
- wir machen den call
/security/public-key-certificatesum Security Zertifikate zu erhalten - wir machen den call
/auth/challengeum eine Challenge ID zu erhalten - wir machen den call
/auth/ksef-tokenum eine ReferenceID und einen AccessToken zu erhalten - wir senden die Rechnung - mit dem öffentlichen Schlüssel verschlüsselt zusammen mit unserer ReferenceID und dem AccessToken an das Goverment.
Generieren einer Referenznummer.
Man benötigt eine Referenznummer (Session ID). Dise kann man wie folgt generieren:
1.) "/auth/challenge" aufrufen um einen Challenge ID zu erhalten
2.) "/auth/ksef-token" ksef Token + Challenge ID senden - man bekommt die Referenznummer (Gültig 1 Stunde)
Rechnung senden
API Aufruf: https://ksef-test.mf.gov.pl/docs/v2/index.html#tag/Wysylka-interaktywna/paths/1api1v21sessions1online1%7BreferenceNumber%7D1invoices/post
Details:
https://github.com/CIRFMF/ksef-docs/blob/main/sesja-interaktywna.md#2-wys%C5%82anie-faktury
Man muss die XML Datei mit dem öffentlichen Schlüssel der Behörde vor dem Versand verschlüsseln
Das Rechnungsformat:
XML Datei
https://github.com/CIRFMF/ksef-docs/blob/main/faktury/weryfikacja-faktury.md