# 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