41 lines
1.6 KiB
Markdown
41 lines
1.6 KiB
Markdown
# 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-certificates` um Security Zertifikate zu erhalten
|
|
- wir machen den call `/auth/challenge` um eine Challenge ID zu erhalten
|
|
- wir machen den call `/auth/ksef-token` um 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/~1api~1v2~1sessions~1online~1%7BreferenceNumber%7D~1invoices/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
|