TL;DR — Kurzzusammenfassung

CFDI-Addenda-Validierungsfehler: XML-Fehler, falschen Namespace, XSD-Schema und PAC-Ablehnung bei der Rechnungsgenerierung mit Addenda in Aspel SAE beheben.

Beim Senden einer elektronischen Rechnung an Walmart, Liverpool oder Volkswagen de México gibt das System “Error de validación en la addenda” (Addenda-Validierungsfehler) zurück, oder das Lieferantenportal lehnt das CFDI ab und gibt an, dass die Addenda nicht dem erwarteten Schema entspricht. Dieser Fehler tritt häufig auf, wenn die Addenda eines neuen Kunden zum ersten Mal konfiguriert wird oder wenn der Kunde seine Anforderungen aktualisiert. Dieser Artikel erklärt, was Addendas sind, warum sie fehlschlagen und wie das Problem Schritt für Schritt in Aspel SAE und anderen Rechnungssystemen gelöst wird.

Der Fehler

Addenda-bezogene Fehlermeldungen erscheinen in verschiedenen Phasen des Rechnungsprozesses:

  • “Error de validación en la addenda” — generische Meldung in Aspel SAE beim Versuch, das CFDI zu generieren
  • “Namespace nicht deklariert” oder “Prefix not bound” — das Addenda-XML referenziert einen im CFDI-Header nicht definierten Namespace
  • “Das Element ‘Addenda’ ist gemäß seinem DTD/Schema nicht gültig” — die XML-Struktur entspricht nicht dem vom Kunden erwarteten XSD
  • “CFDI vom Portal abgelehnt — Addenda nicht erkannt” — das CFDI wird vom PAC korrekt gestempelt, aber das Kundenportal lehnt es bei seiner eigenen Validierung ab
  • “Pflichtfeld in der Addenda fehlt” — ein im XSD des Kunden definiertes Pflichtfeld fehlt (zum Beispiel die Bestellnummer in der Walmart-Addenda)
  • “Addenda-Version nicht unterstützt” — der Kunde hat sein XSD aktualisiert und das System generiert noch die frühere Version

Diese Fehler erscheinen beim Erstellen von Rechnungen unter Rechnungsstellung > Rechnungen, wenn der Kunde eine Addenda konfiguriert hat, oder beim Hochladen des XML in das Lieferantenportal des Kunden nach dem Stempeln.

Ursache des Problems

Addendas sind optionale XML-Erweiterungen, die große Unternehmenskunden von ihren Lieferanten verlangen, um zusätzliche Informationen einzuschließen, die im SAT-Standard nicht vorgesehen sind: Bestellnummer, Lieferantennummer, Einkaufsabteilung, Logistikinformationen und mehr. Der SAT erlaubt ihre Einbindung innerhalb des Elements <cfdi:Addenda>, validiert sie aber nicht; die Verantwortung für die korrekte Struktur liegt beim Lieferanten.

Falscher oder nicht deklarierter Namespace. Jede Unternehmens-Addenda hat ihren eigenen XML-Namespace (eine URI, die das Schema identifiziert). Stimmt der Namespace in Ihrem XML nicht exakt mit dem im XSD des Kunden definierten überein, schlägt die Validierung fehl. Selbst ein abschließender Schrägstrich oder eine andere Versionsnummer in der URL macht das XML ungültig.

Veraltetes XSD. Kunden aktualisieren ihre Addenda-Anforderungen regelmäßig. Wurde Ihre Vorlage in Aspel SAE oder Ihrem System mit der früheren Version des XSD konfiguriert, fehlen neu hinzugefügte Pflichtfelder und die Validierung schlägt fehl.

Fehlende Pflichtfelder oder falsches Format. Jeder Kunde definiert eigene Pflichtfelder. Walmart México verlangt eine 10-stellige Lieferantennummer und eine 10-stellige alphanumerische Bestellnummer. Liverpool verlangt die Abteilungsnummer. Volkswagen verlangt den Audi/VW-Materialcode in einem bestimmten Format. Fehlt ein Feld oder hat es ein abweichendes Format, lehnt das XSD es ab.

Falsche Position der Addenda im XML. Die Addenda muss das letzte Element innerhalb von <cfdi:Comprobante> sein, nach allen Ergänzungen. Einige Rechnungssysteme fügen sie an der falschen Position ein, was das gesamte XML ungültig macht.

Versionsinkompatiblität zwischen Addenda und CFDI-Version. Bei der Migration von CFDI 3.3 zu CFDI 4.0 mussten einige Addenda-XSD-Dateien für die Kompatibilität aktualisiert werden. Hat der Kunde sein XSD nicht aktualisiert oder haben Sie die Vorlage nicht aktualisiert, entstehen Versionskonflikte.

Schritt-für-Schritt-Lösung

1. Aktuelles XSD und Dokumentation des Kunden besorgen

Melden Sie sich vor jeglicher Konfiguration im Lieferantenportal Ihres Kunden an und laden Sie herunter:

  • Das offizielle Addenda-XSD (es kann eines pro Dokumenttyp geben: Rechnung, Gutschrift usw.)
  • Die Pflichtfeld-Dokumentation mit den zugehörigen Formaten
  • Ein Beispiel-CFDI mit korrekt geformter Addenda

Haben Sie keinen Portalzugang, wenden Sie sich an das Kreditorenteam des Kunden, damit dieses Ihnen die aktuellen Unterlagen bereitstellt. Konfigurieren Sie eine Addenda niemals anhand inoffizieller Drittanbieterdokumente.

2. Addenda in Aspel SAE konfigurieren

Öffnen Sie in Aspel SAE Konfiguration > Elektronische Rechnungsstellung > Addendas:

  1. Prüfen Sie, ob Ihr Kunde in der Liste der vordefinierten Addendas erscheint
  2. Falls ja, wählen Sie sie aus und füllen Sie die angeforderten Felder aus
  3. Falls nein, verwenden Sie Benutzerdefinierte Addenda und importieren Sie die XML-Vorlage des Kunden
  4. Stellen Sie sicher, dass die zugeordneten Felder den richtigen Daten aus Ihren Dokumenten entsprechen

Für Addendas, die von Aspel SAE nicht nativ unterstützt werden, bieten viele Kundenanbieter (oder der Kunde selbst) vorkonfigurierte Vorlagen oder Plug-ins an, die in SAE installiert werden können.

3. Generiertes XML gegen das XSD validieren

Erstellen Sie eine Testrechnung und suchen Sie die generierte XML-Datei (normalerweise im Belegordner von SAE). Validieren Sie sie mit diesen Werkzeugen:

Mit xmllint (Befehlszeile):

xmllint --schema kunden_addenda.xsd mein_cfdi_mit_addenda.xml --noout

Mit Notepad++ und XML Tools:

  1. Öffnen Sie das XML in Notepad++
  2. Gehen Sie zu Plugins > XML Tools > Validate Now
  3. Wählen Sie das XSD des Kunden, wenn Sie dazu aufgefordert werden

Online:

  • FreeFormatter.com > XML Validator — ermöglicht das Hochladen von XML und XSD zur sofortigen Validierung

Beheben Sie jeden gemeldeten Fehler: fehlende Elemente, ungültige Datentypen (ein numerisches Feld mit Buchstaben, ein Datum im falschen Format), fehlende Pflichtattribute oder falsch definierter Namespace.

4. Namespace-Deklaration prüfen

Öffnen Sie das CFDI-XML mit einem beliebigen Texteditor und suchen Sie das Element <cfdi:Addenda>. Die Addenda muss ihren Namespace entweder im Root-Element des CFDI (<cfdi:Comprobante) oder im Addenda-Element selbst deklarieren:

<cfdi:Addenda>
  <wmm:WalmartMexico xmlns:wmm="http://www.walmart.com.mx/esquemas/..." version="1.0">
    <wmm:NumProveedor>1234567890</wmm:NumProveedor>
    <wmm:NumOrden>OC-2026-001</wmm:NumOrden>
  </wmm:WalmartMexico>
</cfdi:Addenda>

Vergleichen Sie die Namespace-URI (http://www.walmart.com.mx/esquemas/...) mit der im vom Kunden heruntergeladenen XSD angegebenen. Sie müssen Zeichen für Zeichen identisch sein.

5. Im PAC-Sandbox testen

Laden Sie das CFDI vor der Produktionsausstellung in die Testumgebung Ihres PAC hoch:

  • Finkok: Testportal unter sandbox.finkok.com
  • SW Sapien: Demo-Umgebung im Entwicklerportal verfügbar
  • Edicom: Sandbox mit Ihren Produktions-Anmeldedaten im Testmodus verfügbar

Der PAC validiert das vollständige CFDI. Verursacht die Addenda ein fehlerhaftes XML, lehnt der PAC es mit Fehler 301 (fehlerhaftes XML) ab. Akzeptiert der PAC es, aber der Kunde lehnt es ab, liegt das Problem in der internen Validierung des Kundenportals (Geschäftsregeln, keine XML-Struktur).

Alternative Lösung

Falls Sie die Aspel-SAE-Konfiguration nicht direkt ändern können, besteht eine Alternative darin, das CFDI ohne Addenda aus SAE zu generieren und die Addenda dann vor dem Stempeln programmgesteuert hinzuzufügen — mittels eines Skripts oder eines XML-Transformationswerkzeugs (XSLT). Einige Integratoren und Buchführungsbüros verwenden diesen Ablauf, wenn die Addenda des Kunden zu komplex ist oder von SAE nicht nativ unterstützt wird.

Eine weitere Option ist die direkte Zusammenarbeit mit dem autorisierten Technologieanbieter des Kunden. Walmart México arbeitet beispielsweise mit EDI-Anbietern wie GS1 México, Soltec und TCI Commerce zusammen, die vorvalidierte Addenda-Lösungen anbieten, die bereits mit den neuesten Anforderungen aktualisiert sind.

Prävention

  • Laden Sie das aktualisierte XSD herunter, sobald der Kunde Änderungen meldet. Große Einkäufer senden ihren Lieferanten Mitteilungen, wenn sie Anforderungen aktualisieren; abonnieren Sie deren Lieferanten-Newsletter.
  • Validieren Sie das XML jeder neuen Addenda vor der Produktionseinführung. Gehen Sie nie davon aus, dass die frühere Konfiguration mit einer neuen XSD-Version funktioniert.
  • Bewahren Sie eine Kopie des XSD auf, mit dem die Addenda konfiguriert wurde. So können Sie Versionen vergleichen, wenn der Kunde Ablehnungen meldet.
  • Testen Sie immer im PAC-Sandbox vor der Produktion. Ein in der Produktion abgelehntes CFDI mit fehlerhafter Addenda kann die Rechnungszahlung verzögern.
  • Halten Sie Aspel SAE aktuell. Aspel veröffentlicht Updates, die neue Versionen von Addendas für häufige Kunden wie Walmart, Liverpool und Automotive-OEMs enthalten.
  • Dokumentieren Sie die Feldzuordnungen. Halten Sie fest, welches SAE-Feld welchem Addenda-Element des Kunden entspricht, um zukünftige Aktualisierungen zu erleichtern.

Verwandte Probleme

Das CFDI wird gestempelt, aber das Kundenportal lehnt es ab. Dies tritt auf, wenn die Addenda ein gültiges XML gemäß XSD ist, die Feldwerte aber nicht die Geschäftsregeln des Kunden erfüllen (zum Beispiel eine Bestellnummer, die in seinem ERP nicht existiert). Lösung: Fragen Sie das Kreditorenteam des Kunden nach dem spezifischen Fehler, den sein System anzeigt.

Aspel SAE generiert die Addenda nicht, obwohl sie konfiguriert ist. Prüfen Sie, ob das Feld “Addenda” oder “Kunde mit Addenda” im Dokument (Rechnung) aktiviert ist. Einige Kunden müssen im SAE-Kundenkatalog einzeln konfiguriert werden, damit die Addenda automatisch generiert wird.

Der PAC lehnt nur bei vorhandener Addenda mit Fehler “301 - Fehlerhaftes XML” ab. Dies weist darauf hin, dass die Addenda in XML ungültige Zeichen einführt (wie nicht escapte &, <, >) oder der Namespace nicht korrekt deklariert ist. Exportieren Sie das XML, öffnen Sie es in einem Editor und prüfen Sie, ob der Block <cfdi:Addenda> wohlgeformtes XML ist.

Die VW- oder Automotive-OEM-Addenda enthält unbekannte Felder. Automotive-OEMs (Volkswagen, General Motors, Stellantis) verlangen in der Regel Addendas mit Fertigungsauftragsdaten, Materialcodes und Werksnummern. Ihre technische Dokumentation ist umfangreich; wenden Sie sich direkt an die Kreditorenabteilung des OEM oder dessen autorisierten EDI-Anbieter, um die vollständige Spezifikation und Beispiele zu erhalten.

Zusammenfassung

  • Addendas sind XML-Erweiterungen, die große Kunden im CFDI für zusätzliche Daten verlangen, die nicht durch den SAT abgedeckt sind
  • Die häufigsten Fehler sind: falscher Namespace, fehlende Pflichtfelder, veraltetes XSD und falsche Position im XML
  • Laden Sie stets das offizielle XSD aus dem Lieferantenportal des Kunden herunter, bevor Sie die Addenda konfigurieren
  • Validieren Sie das generierte XML mit xmllint, Notepad++ oder einem Online-Validator gegen das XSD, bevor Sie stempeln
  • Testen Sie im PAC-Sandbox vor der Produktionsausstellung, um Ablehnungen zu vermeiden, die die Zahlung verzögern
  • Unterstützt Aspel SAE die Addenda Ihres Kunden nicht, erwägen Sie einen externen Addenda-Workflow oder kontaktieren Sie den EDI-Anbieter des Kunden

Verwandte Artikel