diff --git a/doc/KSeF/README.md b/doc/KSeF/README.md index 61c4b63..4092003 100644 --- a/doc/KSeF/README.md +++ b/doc/KSeF/README.md @@ -4,55 +4,28 @@ Die Idee ist es auf Basis der KSeF FA(2) XSD-Spezifikation einen Java-Konverter ## Github -https://github.com/CIRFMF/ksef-docs +# API -https://github.com/CIRFMF/ksef-client-java +Die Basis url ist: "https://ksef-test.mf.gov.pl/api/v2"; -## Strategische Überlegungen: +## Generieren einer Referenznummer. -### **1. Hybride Lösung mit EN 16931 + KSeF** +Man benötigt eine Referenznummer (Session ID). Dise kann man wie folgt generieren: -Ihr Ansatz würde funktionieren: +1.) "/auth/challenge" aufrufen um einen Challenge ID zu erhalten -- **Interne Basis**: EN 16931 XML als Standardformat in Ihrem System -- **Automatische Konvertierung**: Java-Konverter mappt EN 16931 → KSeF FA(2)/FA(3) -- **Zusätzliche Felder**: Polnische Spezialfelder werden über Extension Points in EN 16931 oder separate Datenstrukturen bereitgestellt +2.) "/auth/ksef-token" ksef Token + Challenge ID senden - man bekommt die Referenznummer (Gültig 1 Stunde) -### **2. Technische Umsetzung** +## Rechnung senden -```java -// Konzeptioneller Ansatz -public class EN16931ToKSeFConverter { - public FakturaType convert(EN16931Invoice source, KSeFExtensionData extensions) { - // Mapping der Standard-Felder - // + Ergänzung der Polen-spezifischen Daten - } -} -``` +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 -### **3. Vorteile dieser Lösung:** +Details: -- **EU-Compliance**: Basis bleibt EN 16931-konform -- **Polen-Compliance**: Vollständige KSeF-Unterstützung -- **Flexibilität**: Ein System für verschiedene EU-Länder erweiterbar -- **Wartbarkeit**: Klare Trennung zwischen Standard und nationalen Extensions +https://github.com/CIRFMF/ksef-docs/blob/main/sesja-interaktywna.md#2-wys%C5%82anie-faktury -### **4. Herausforderungen aus der XSD:** +### Das Rechnungsformat: -Basierend auf der bereitgestellten Spezifikation sehe ich: +XML Datei -- **Komplexe Steuer-Klassifikationen** (GTU-Codes, Procedura-Felder) -- **Transport-spezifische Daten** (perfekt für Ihr Logistik-Unternehmen) -- **Währungs-Handling** mit polnischen NBP-Kursen -- **Korrektur-Mechanismen** für Rechnungsänderungen - -## **Empfehlung für das Treffen:** - -**Präsentieren Sie diese Lösung als "Best of both worlds":** - -1. "Wir bleiben EU-Standard-konform mit EN 16931" -2. "Zusätzlich entwickeln wir automatische Konvertierung zu KSeF" -3. "Polen-spezifische Daten kommen aus unserem ERP-System" -4. "Zukunftssicher für weitere EU-Länder" - -Das zeigt **technische Kompetenz** und **strategisches Denken** - Sie lösen nicht nur das polnische Problem, sondern schaffen eine skalierbare EU-weite Lösung! +https://github.com/CIRFMF/ksef-docs/blob/main/faktury/weryfikacja-faktury.md