Zum Inhalt springen

Fehler

FX-SCH-A-000417: Die Dokumentart muss eine sein, die das Profil erlaubt

Kurz gesagt

Fehler: Die Rechnung besteht die ausgewählten Prüfungen nicht.

FX-SCH-A-000417 bedeutet, dass der nicht leere Dokumentart-Code (BT-3) einer Basic-WL-Datei nicht in der Codeliste des Profils steht. Tragen Sie in ram:TypeCode unter rsm:ExchangedDocument einen erlaubten Code ein, der der tatsächlichen Dokumentart entspricht. Exportieren Sie die Datei erneut und prüfen Sie sie noch einmal.

Auf dieser Seite

Was die Regel bedeutet

Der Dokumentart-Code (BT-3) steht in ram:TypeCode innerhalb von rsm:ExchangedDocument. Im Profil Basic WL von Factur-X und ZUGFeRD muss ein nicht leerer Wert aus der Codeliste des Profils stammen. Beispiele sind 380 für eine Rechnung und 381 für eine Rechnungskorrektur. Ein leerer Wert besteht diese Codelistenprüfung; daraus folgt nicht, dass die Dokumentart weggelassen werden darf.

Warum sie wichtig ist

Der Typcode kennzeichnet die Art des ausgestellten Dokuments. Er muss deshalb die tatsächliche Dokumentart wiedergeben.

So beheben Sie den Fehler

Prüfen Sie, welche Dokumentart die Datei tatsächlich hat, und verwenden Sie den entsprechenden Code aus der Basic-WL-Liste. Verwenden Sie 380 für eine Rechnung oder 381 für eine Rechnungskorrektur nur, wenn dies die richtige Dokumentart ist. Ersetzen Sie keinen anderen passenden, erlaubten Code allein deshalb, weil er ungewöhnlich ist. Im XML steht ram:TypeCode unter rsm:ExchangedDocument, nicht unter ram:ExchangedDocument. Lassen Sie eine falsche Zuordnung durch den Softwareanbieter korrigieren. Exportieren Sie die Datei erneut und prüfen Sie sie noch einmal.

Ist die Datei korrigiert, prüfen Sie sie kostenlos noch einmal: ZUGFeRD-Rechnung prüfen

Oder Sie korrigieren die Rechnung in einem Formular und laden die korrigierte Datei für 1 Credit herunter: Eine abgelehnte E-Rechnung korrigieren Beta

Der veröffentlichte Regeltext

Value of 'ram:TypeCode' is not allowed.

Wo diese Regel gilt

Regelwerk Version
Factur-X 1.09 BASIC WL 1.0.9-2
ZUGFeRD 2.5 BASIC WL 2.5.2
Regeltext aus phive-rules 4.6.4.

Ihre Datei prüfen

Legen Sie Ihre E-Rechnung ab, um zu sehen, ob sie noch gegen FX-SCH-A-000417 verstößt und welche weiteren Regeln sie verletzt.

Aktualisiert am 6. November 2026