office-alexander-logistics/doc/KSeF

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/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