docu

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
+2.) "/auth/ksef-token" ksef Token + Challenge ID senden - man bekommt die Referenznummer (Gültig 1 Stunde)
-- **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. Technische Umsetzung**
+## Rechnung senden
 
-```java
+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
-// Konzeptioneller Ansatz
-public class EN16931ToKSeFConverter {
-    public FakturaType convert(EN16931Invoice source, KSeFExtensionData extensions) {
-        // Mapping der Standard-Felder
-        // + Ergänzung der Polen-spezifischen Daten
-    }
-}
-```
 
-### **3. Vorteile dieser Lösung:**
+Details:
 
-- **EU-Compliance**: Basis bleibt EN 16931-konform
+https://github.com/CIRFMF/ksef-docs/blob/main/sesja-interaktywna.md#2-wys%C5%82anie-faktury
-- **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
 
-### **4. Herausforderungen aus der XSD:**
+### Das Rechnungsformat:
 
-Basierend auf der bereitgestellten Spezifikation sehe ich:
+XML Datei
 
-- **Komplexe Steuer-Klassifikationen** (GTU-Codes, Procedura-Felder)
+https://github.com/CIRFMF/ksef-docs/blob/main/faktury/weryfikacja-faktury.md
-- **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!