einvoice_display_mismatch

HTTP 422 · code: "einvoice_display_mismatch" · type: https://docs.formfeed.dev/errors/einvoice-display-mismatch

Das Rendering hat eine E-Rechnung mit display_check: "strict" verlangt, und der Text des fertigen PDFs zeigt einen Wert nicht, den sein XML nennt: die Rechnungsnummer (BT-1), die Nettosumme (BT-109), die Umsatzsteuersumme (BT-110), die Gesamtsumme (BT-112), den fälligen Betrag (BT-115), wo er von der Gesamtsumme abweicht, und bei mehr als einem Steuersatz den Steuerbetrag jedes Satzes (BT-117). Beträge von null werden nicht gesucht. Die Sichtprüfung erklärt, wonach gesucht wird.

detail nennt die fehlenden Werte, einvoice.display.missing ihre Geschäftsbegriffe. Die Datei selbst war gültig, das sagt einvoice.validation. Das Rendering ist failed und behält den Bericht; es wird keine Datei gespeichert, und ein fehlgeschlagenes Rendering kostet nichts. Mit display_check: "warn", dem Standard, lässt derselbe Befund das Rendering nicht fehlschlagen.

Hat das Rendering außerdem pdf.ua gesetzt, trägt das Problem auch accessibility: Die Datei war zu diesem Zeitpunkt bereits gegen PDF/UA-1 geprüft, und der Block sagt, was diese Prüfung ergeben hat.

Beispiel

{
  "type": "https://docs.formfeed.dev/errors/einvoice-display-mismatch",
  "title": "PDF does not show the e-invoice",
  "status": 422,
  "detail": "The PDF does not show the VAT total 182.40 (BT-110) of the e-invoice",
  "code": "einvoice_display_mismatch",
  "location": null,
  "render_id": "rnd_7da09ab6cd9946b798c187c2a9350852",
  "einvoice": {
    "profile": "en16931",
    "flavour": "factur-x",
    "spec_version": "1.09",
    "xml_url": null,
    "validation": {
      "valid": true,
      "schematron": "Factur-X 1.09.2 (Mustang 2.26.0)",
      "pdfa": "PDF/A-3b",
      "messages": []
    },
    "display": {
      "checked": ["BT-1", "BT-109", "BT-110", "BT-112"],
      "missing": ["BT-110"]
    }
  },
  "request_id": "req_4b7c1e9a2f3d4c5b8a6e7f9012"
}

Häufige Ursachen

• Die Vorlage addiert ihre eigenen Summen aus anderen Feldern als _invoice, und sie weichen vom Block ab, zum Beispiel weil sie je Position rundet.
• Die Vorlage gibt den Wert gar nicht aus, etwa eine Rechnung ohne Zeile für die Umsatzsteuer.
• Die Vorlage gibt einen gerundeten Betrag aus: 1.142 € zeigt 1142.40 nicht.
• Die Vorlage gibt eine andere Rechnungsnummer aus als _invoice.number.
• Der Wert ist Teil eines Bilds. Die Prüfung liest den Text des PDFs.

So beheben Sie es

• Geben Sie die Werte aus _invoice aus, statt Werte aus anderen Feldern.
• Im Editor zählen die Vorschauen Fließend und Seiten einer Rechnungsvorlage die Werte, die das Dokument zeigt, und die Liste Probleme nennt jeden fehlenden, bevor etwas gerendert wird.
• Um die Datei zu erhalten, während Sie die Vorlage korrigieren, stellen Sie display_check zurück auf warn. Das Rendering gelingt dann und meldet dieselben Werte in einvoice.display.missing. Das XML ist die Rechnung, und ein PDF, das andere Rechnungsangaben zeigt, kann als zweite Rechnung gelten; belassen Sie es also nicht dabei.

Wiederholen?

Nein. Dieselbe Anfrage liefert bei einer Wiederholung dieselbe Antwort; ändern Sie zuerst die Vorlage oder die Daten. Senden Sie die korrigierte Anfrage mit einem neuen Idempotency-Key oder ohne: Eine 4xx-Antwort wird 24 Stunden unter ihrem Schlüssel gespeichert, der alte Schlüssel liefert also wieder dieses Problem. Siehe Wiederholen.