Zum Hauptinhalt springen

pdfa_conversion_failed

HTTP 500 · code: "pdfa_conversion_failed" · type: https://docs.formfeed.dev/errors/pdfa-conversion-failed

Eine E-Rechnung ist ein PDF/A-3b, das die Rechnung als XML trägt. Das gerenderte PDF ließ sich nicht in eines umwandeln, oder die umgewandelte Datei hat die PDF/A-Prüfung nicht bestanden. Das Rendering ist failed; es wird keine Datei gespeichert, kein gewöhnliches PDF stattdessen ausgeliefert, und ein fehlgeschlagenes Rendering kostet nichts.

Das Problem trägt eines von beidem:

  • einvoice, den Bericht des Validators, wenn die umgewandelte Datei geprüft und abgelehnt wurde. Seine validation.messages mit "part": "pdf" nennen die Klausel von PDF/A (rule) und das Objekt des PDFs (location). Das fehlgeschlagene Rendering behält denselben Bericht.
  • reason, die erste Zeile dessen, was der Konverter gemeldet hat, wenn sich das PDF gar nicht umwandeln ließ.

Beispiel​

{
  "type": "https://docs.formfeed.dev/errors/pdfa-conversion-failed",
  "title": "PDF/A conversion failed",
  "status": 500,
  "detail": "The PDF could not be made a valid PDF/A-3b: 1 finding",
  "code": "pdfa_conversion_failed",
  "location": null,
  "render_id": "rnd_7da09ab6cd9946b798c187c2a9350852",
  "einvoice": {
    "profile": "en16931",
    "flavour": "factur-x",
    "spec_version": "1.09",
    "xml_url": null,
    "validation": {
      "valid": false,
      "schematron": "Factur-X 1.09.2 (Mustang 2.26.0)",
      "pdfa": "PDF/A-3b",
      "messages": [
        {
          "part": "pdf",
          "severity": "error",
          "rule": "6.2.11.4.1-1",
          "message": "…",
          "location": "…"
        }
      ]
    },
    "display": null
  },
  "request_id": "req_4b7c1e9a2f3d4c5b8a6e7f9012"
}

Häufige Ursachen​

  • Eine Schrift, die nicht eingebettet ist (6.2.11.4.1-1). PDF/A braucht jede Schrift in der Datei. Ein PDF aus der Dateibibliothek, das mit post.merge_after angehängt wird, kann eine solche Schrift mitbringen.
  • Eine Schrift, deren eingebettetes Programm den Breiten widerspricht, die das PDF nennt (6.2.11.5-1). Der Office-Konverter schreibt eine solche Schrift für OpenType-Schriften mit CFF-Konturen; bei uns ist das die Schrift für chinesischen, japanischen und koreanischen Text in einer Word- oder PowerPoint-Vorlage.
  • Ein Fehler des Konverters selbst, gemeldet in reason.

So beheben Sie es​

  • Lesen Sie einvoice.validation.messages: Dort steht, welche Klausel von PDF/A die Datei verletzt und wo.
  • Bei einer nicht eingebetteten Schrift in einem angehängten PDF: Erzeugen Sie dieses PDF neu mit eingebetteten Schriften, oder lassen Sie es aus der E-Rechnung heraus.
  • In jedem anderen Fall senden Sie die render_id an support@formfeed.dev. Ein Dokument, das Formfeed gerendert hat und nicht umwandeln kann, ist unsere Sache.

Wiederholen?​

Nein. Dasselbe Dokument schlägt auf dieselbe Weise fehl. Auch asynchrone Renderings werden bei diesem Code nicht wiederholt.