XML-Strukturen

XML-Strukturen bieten ein standardisiertes Datenmodell, das den Inhalt eines Dokuments von seiner Darstellung trennt. Im Gegensatz zu PDF, das sich auf das visuelle Layout konzentriert, steht bei XML die semantische Bedeutung der Daten im Vordergrund. Dadurch kann Continia eDocuments elektronische Belege zuverlässig austauschen, validieren und verarbeiten.

Hinweis

OIOUBL, CII, Factur-X und andere Formate sind Geschäftsstandards, die eine bestimmte XML-Struktur für eine bestimmte Belegart festlegen. Zum Beispiel Rechnung, Gutschrift, Bestellung usw.

Eine typische XML-Struktur besteht aus Elementen, Attributen und einer hierarchischen Beziehung zwischen über- und untergeordneten Elementen, die einen Baum bildet. Elemente stellen Geschäftskonzepte oder Datenstrukturen dar, z. B. Invoice, ProfileID und IssueDate. Attribute hingegen liefern Metadaten oder nähere Angaben zum Wert eines Elements – zum Beispiel currency, format, scheme identifier und language.

Im folgenden Beispiel sind IssueDate, EndpointID und PayableAmount Elemente, während schemeID und currencyID Attribute sind.

<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
         xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
         xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">

    <cbc:CustomizationID>
        urn:cen.eu:en16931:2017
    </cbc:CustomizationID>

    <cbc:ProfileID>
        urn:fdc:peppol.eu:2017:poacc:billing:01:1.0
    </cbc:ProfileID>

    <cbc:ID>INV-2026-12345</cbc:ID>

    <cbc:IssueDate>2026-09-25</cbc:IssueDate>

    <cac:AccountingSupplierParty>
        <cac:Party>
            <cbc:EndpointID schemeID="0088">
                5790000435944
            </cbc:EndpointID>
            <cac:PartyName>
                <cbc:Name>Contoso Denmark A/S</cbc:Name>
            </cac:PartyName>
        </cac:Party>
    </cac:AccountingSupplierParty>

    <cac:DeliveryTerms>
        <cbc:ID schemeID="INCOTERMS">DAP</cbc:ID>
    </cac:DeliveryTerms>

    <cac:LegalMonetaryTotal>
        <cbc:PayableAmount currencyID="EUR">
            1250.00
        </cbc:PayableAmount>
    </cac:LegalMonetaryTotal>

</Invoice>

Nachfolgend sehen Sie eine vereinfachte Darstellung des obigen Beispiels, die die Beziehung zwischen über- und untergeordneten Elementen hervorhebt.

Invoice
├─ ProfileID
├─ ID
├─ IssueDate
├─ AccountingSupplierParty
│  └─ Party
│     └─ EndpointID (schemeID="0088")
├─ DeliveryTerms
│  └─ ID (schemeID="INCOTERMS")
└─ LegalMonetaryTotal
   └─ PayableAmount (currencyID="EUR")

Die Seite „XML-Strukturansicht“

Die Seite XML-Strukturansicht listet alle in der Continia eDocuments-Datenbank verfügbaren Strukturen auf, und jede Struktur listet alle ihre verfügbaren Elemente auf. Von Continia importierte Strukturen sind vorkonfiguriert. Änderungen sind daher nicht erforderlich, es sei denn, Sie benötigen eine Anpassung oder es treten Validierungsfehler auf, die sich nicht anders beheben lassen.

Tipp

Informationen zum Herunterladen zusätzlicher Strukturen finden Sie unter Die unterstützte Einrichtung von Document Capture verwenden.

So zeigen Sie die Struktur einer XML-Datei an:

  1. Suchen Sie () nach XML-Strukturansicht, und wählen Sie dann den zugehörigen Link aus.
  2. Wählen Sie den gewünschten Strukturcode aus.

Die Ansicht folgt der XML-Datei: Das erste Element ist Invoice, dann folgt UBLVersionID usw. Die Struktur enthält alle im Format verfügbaren Elemente, nicht nur die exportierten. Elemente ohne Daten werden übersprungen – daher erscheinen viele Elemente, wie z. B. Projekt- oder Vertragsreferenzen, nicht in der XML-Datei.

Hinweis

Elemente die in fett auf der Seite XML-Strukturansicht hervorgehoben wurden, können mehrmals in einer XML-Datei erscheinen.

Um zu prüfen, wie ein bestimmtes Element konfiguriert ist, folgen Sie seinem XML-Pfad durch die Struktur, bis Sie es erreichen. Zum Beispiel:

XML-PfadTabellennr.TabellennameFeldnr.Feldname
/rsm:CrossIndustryInvoice/rsm:ExchangedDocumentContext/ram:BusinessProcessSpecifiedDocumentContextParameter/ram:ID6225510eAbrechnungskopf704Profil-ID

Die folgenden Spalten erfordern besondere Aufmerksamkeit.

SpalteBeschreibung
MindestvorkommenDie minimale Anzahl der Vorkommen dieses Elements. Der Wert 0 (null) bedeutet, dass der Knoten optional ist. Dieser Wert sollte nicht bearbeitet werden.
MaximalvorkommenDie maximale Anzahl der Vorkommen dieses Elements. Der Wert 0 (null) bedeutet, dass eine unbegrenzte Anzahl von Elementen zulässig ist. Dieser Wert sollte nicht bearbeitet werden.
Minimale DezimalstellenDie Mindestanzahl von Dezimalstellen beim Exportieren des Werts in XML.
Maximale DezimalstellenDie maximale Anzahl von Dezimalstellen beim Exportieren des Werts in XML.

Grundlegendes zu Standardwerten

Wenn eine Gruppe in der XML-Datei erscheint, müssen ihre obligatorischen untergeordneten Elemente einen Wert haben. Unter dem Stammelement Invoice sind Elemente wie UBLVersionID, CustomizationID, ID und IssueDate obligatorisch. Ein obligatorisches Element ohne zugeordneten Wert übernimmt seinen Wert aus Default Value . Beispiel: UBLVersionID hat den Standardwert 2.0 und CustomizationID den Standardwert OIOUBL-2.02.

Gruppen wie AccountingSupplierParty und AccountingCustomerParty werden immer exportiert, da eine Rechnung immer einen Absender und einen Empfänger benötigt. Für ihre untergeordneten Elemente gelten dieselben Regeln.

Problembehandlung bei Validierungsfehlern

Eine der wichtigsten Eigenschaften von XML ist die Unterstützung der Schemavalidierung. Schemas legen fest, welche Elemente wie oft zulässig sind, welche Datentypen sie haben und in welcher Beziehung sie zueinander stehen. So kann Continia eDocuments vor der Verarbeitung prüfen, ob ein elektronischer Beleg strukturell und semantisch korrekt ist.

Wenn eine E-Rechnung die Validierung nicht besteht, wird ihr eDokumentenstatus auf Ungültig gesetzt. So beheben Sie dieses Problem:

  1. Suchen Sie () nach Geb. Verkaufsrechnungen, und wählen Sie dann den zugehörigen Link aus.
  2. Klicken Sie auf die Nr. der gewünschten E-Rechnung und klicken Sie auf der Seite Geb. Verkaufsrechnung auf den Wert des Felds eDokumentenstatus.
  3. Klicken Sie auf der eAbrechnung-Karte für ausgehende Dokumente auf der Aktionsleiste auf Validierungsprotokoll.
  4. Die in diesem Protokoll angezeigten Fehlermeldungen stammen aus dem Schema, das zur XML-Struktur gehört, z. B. eine von einer Behörde im UBL-Format festgelegte Anforderung. Kopieren Sie die Fehlermeldung und recherchieren Sie sie mit einer Suchmaschine oder einem KI-Chatbot.
  5. Wenn die Fehlermeldung einen Business Term Code enthält (z. B. BT-3), öffnen Sie die Seite XML-Strukturansicht, klicken Sie auf der Aktionsleiste auf das Trichtersymbol, klicken Sie auf Filter und wählen Sie Business Term aus. Fügen Sie dann den Business Term Code in den Filter ein, um das zugehörige Element zu finden.

Wichtig

Wenn der Status eines elektronischen Belegs Fehlgeschlagen lautet, hat der elektronische Beleg die CDN-Validierung bestanden, aber beim Senden über das Netzwerk ist ein Fehler aufgetreten. In diesem Fall ist das Validierungsprotokoll leer. Um herauszufinden, warum das Senden fehlgeschlagen ist, prüfen Sie das Feld Dokumentenempfangsstatus auf der eAbrechnung-Karte für ausgehende Dokumente.

Wenn Sie das Problem weiterhin nicht beheben können, wenden Sie sich mit den von Ihnen gefundenen Informationen an das Continia-Supportteam: Geben Sie den Fehler, den Business Term, das Element und das, was falsch ist, an. Beispiel: “BT-3, InvoiceTypeCode, missing”. Je mehr relevante Informationen Sie angeben, desto besser.

XML-Strukturen ändern

Es gibt drei Möglichkeiten, XML-Strukturen zu ändern.

Strukturelle Änderungen

Nehmen Sie eine schnelle Korrektur an einem fehlenden oder falschen Element vor, indem Sie es z. B. einem Feld zuordnen oder einen Standardwert festlegen. Diese Änderungen gehen jedoch verloren, wenn die Struktur erneut aus der Konfiguration importiert wird. Verwenden Sie diese Methode daher nur für Korrekturen, die Sie problemlos erneut vornehmen können.

So ändern Sie eine XML-Struktur:

  1. Suchen Sie () nach XML-Strukturansicht, und wählen Sie dann den zugehörigen Link aus.
  2. Wählen Sie den gewünschten Strukturcode aus.
  3. Wählen Sie das gewünschte Element aus.
  4. Geben Sie die Zuordnung oder den Standardwert des Elements an. Beispiel.: map InvoiceTypeCode to a field on the eBilling Header table (table 6225510).

Strukturerweiterungen

Nehmen Sie dauerhafte Änderungen vor, die bei erneuten Imports der Basisstruktur unverändert bleiben. Die Erweiterung ist eine separate Kopie, die nur die von Ihnen geänderten Elemente überschreibt. Weitere Informationen finden Sie unter XML-Strukturerweiterungen erstellen.

Szenario-Framework

Ändern Sie Werte je nach Anwendungsfall auf dem Beleg, sodass ein Wert von den Umständen eines bestimmten Belegs abhängen kann. Weitere Informationen finden Sie unter eDocuments-Szenarien.