Wiki & Docs | OreonX

1. Einführung in OreonX

OreonX ist die führende Instanz zur Validierung, Streichung und Neukalkulation von elektronischen Rechnungen nach europäischer Norm (EN 16931). Das System liest eingebettete XML-Daten aus PDFs oder verarbeitet reine XML-Datensätze, erlaubt interaktive Korrekturen an Einzelpositionen und generiert im Anschluss einen rechtssicheren, neukalkulierten Datensatz.

Wichtig: OreonX verändert niemals das Ursprungsdokument, sondern generiert einen neuen, revisionssicheren Korrekturdatensatz für Ihr ERP-System.

2. Unterstützte Formate

Unsere Core Engine unterstützt alle gängigen Profile der deutschen und europäischen E-Rechnungs-Standards. Die Engine erkennt das Format beim Upload automatisch.

ZUGFeRD 2.0 bis 2.2: Profile BASIC, EN 16931 (COMFORT), EXTENDED
XRechnung: Version 1.2 bis 3.0 (UBL & CII)
Hybride PDF/A-3: Extrahierung der eingebetteten `factur-x.xml` oder `zugferd-invoice.xml`

3. Der Korrektur-Prozess

Der Workflow in OreonX ist darauf ausgelegt, Rechnungsprüfern (z.B. Bauleitern) maximale Effizienz zu bieten:

Upload: Das Dokument wird via Drag&Drop oder API übergeben.
Parsing: Die Neural Logic extrahiert Positionen, Mengen, Einzelpreise und Steuersätze.
Workspace: Der Nutzer ändert Mengen (Aufmaße) oder storniert ganze Positionen.
Re-Calculation: Netto-, Brutto- und Steuerbeträge auf Header- und Line-Level werden streng nach EN 16931 neu berechnet.
Export: Download der neuen XML für den Import in DATEV, SAP etc.

4. XML Struktur (Beispiel Line-Item)

So sieht eine typische, von OreonX geparste Positionszeile (Cross Industry Invoice) im Hintergrund aus:

<ram:IncludedSupplyChainTradeLineItem>
  <ram:AssociatedDocumentLineDocument>
    <ram:LineID>1</ram:LineID>
  </ram:AssociatedDocumentLineDocument>
  <ram:SpecifiedTradeProduct>
    <ram:Name>Transportbeton C25/30</ram:Name>
  </ram:SpecifiedTradeProduct>
  <ram:SpecifiedLineTradeAgreement>
    <ram:GrossPriceProductTradePrice>
      <ram:ChargeAmount>118.00</ram:ChargeAmount>
    </ram:GrossPriceProductTradePrice>
  </ram:SpecifiedLineTradeAgreement>
  <ram:SpecifiedLineTradeDelivery>
    <ram:BilledQuantity unitCode="MTQ">45.0</ram:BilledQuantity>
  </ram:SpecifiedLineTradeDelivery>
</ram:IncludedSupplyChainTradeLineItem>
                

5. REST API (Enterprise)

Enterprise-Kunden können Korrektur-Sätze vollautomatisiert abrufen oder Dokumente headless validieren lassen. Die API kommuniziert ausschließlich über TLS 1.3 und erfordert einen Bearer-Token.

Endpunkte

POST /api/v1/invoice/parse - Lade eine Rechnung hoch und erhalte ein JSON-Objekt der Struktur.
POST /api/v1/invoice/recalculate - Sende ein modifiziertes JSON-Objekt zurück, um eine valide XML zu generieren.