VD-Valitool-13: UBL-Namespace cac fehlt

Validator-Meldung

Kurz erklärt

Die XML-Datei verwendet Elemente mit dem Prefix cac: (z. B. cac:AccountingSupplierParty, cac:InvoiceLine), aber am Rechnungs-Root fehlt die Namespace-Deklaration xmlns:cac für CommonAggregateComponents-2.

Ausführliche Erklärung

UBL/XRechnung trennt Rechnungsdaten in mehrere Namespaces. Aggregate-Strukturen (Verkäufer, Käufer, Positionen, Summen) gehören zum Namespace urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2 und werden mit dem Prefix cac: geschrieben. Valitool prüft, dass dieser Namespace am Invoice-Element deklariert ist. Fehlt xmlns:cac, schlägt die technische Prüfung mit VD-Valitool-13 fehl – oft bevor einzelne BR-Regeln gemeldet werden.

Wann tritt der Fehler auf?

• xmlns:cac fehlt am Root-Element Invoice.
• cac:-Elemente sind vorhanden, aber der Namespace ist nicht im Scope deklariert.
• Ein anderer Prefix wird für Aggregate-Elemente verwendet, obwohl cac: erwartet wird.

Typische Ursachen

• ERP-Export gibt nur cbc:-Namespaces aus, nicht cac.
• Manuell erstelltes oder konvertiertes XML ohne vollständige Namespace-Deklarationen.
• Falscher UBL-Exporter oder veraltete Vorlage.

Diagnose-Checkliste

• Erste Zeilen der XML-Datei prüfen: xmlns:cac am Invoice-Element?
• Nach cac: im Dokument suchen – jedes cac:-Element braucht die Deklaration im Scope.
• Auch xmlns:cbc und ggf. xmlns:cec am Root prüfen.
• Mit einer gültigen XRechnung vergleichen (z. B. offizielle Beispieldatei).

Behebung

1. Root-Element Invoice (oder ns0:Invoice) in der XML-Datei öffnen.
2. xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" hinzufügen, falls fehlend.
3. Sicherstellen, dass Aggregate-Elemente mit cac: geschrieben sind.
4. Datei erneut im Validator prüfen.

Beispiele (UBL)

<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
         xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
  <cbc:ID>123</cbc:ID>
  <cac:AccountingSupplierParty>
    <cac:Party>
      <cac:PartyName>
        <cbc:Name>Verkäufer</cbc:Name>
      </cac:PartyName>
    </cac:Party>
  </cac:AccountingSupplierParty>
</Invoice>

<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"
         xmlns:cec="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2">
  <cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0</cbc:CustomizationID>
  <cbc:ID>123</cbc:ID>
  <cac:AccountingSupplierParty>
    <cac:Party>
      <cac:PartyName>
        <cbc:Name>Verkäufer</cbc:Name>
      </cac:PartyName>
    </cac:Party>
  </cac:AccountingSupplierParty>
</Invoice>

Verwandte Fehler

• XSD/XML — XML-Struktur- und Namespace-Fehler
• FMT-01 — Format- und Validierungsfehler
• BR-01 — Spezifikationskennung (BT-24)

Häufige Fragen

• Was bedeutet VD-Valitool-13?

  Der Validator meldet, dass der UBL-Namespace für Aggregate-Komponenten (cac) nicht korrekt deklariert ist, obwohl cac:-Elemente im XML vorkommen.

• Ist das ein BR-Regel-Fehler?

  Nein. VD-Valitool-13 ist eine technische Valitool-Meldung zur XML-Struktur/Namespaces. BR-Regeln werden oft erst danach geprüft.

• Wie behebe ich den Fehler schnell?

  Am Invoice-Root xmlns:cac mit der offiziellen UBL-URI ergänzen und erneut validieren.