---
title: "E-Rechnung prüfen (kostenlos, Key nötig)"
method: POST
path: "/verify"
tags: ["Rechnungen"]
---

# E-Rechnung prüfen (kostenlos, Key nötig)

`POST /verify`

## Request

- Base URL: `https://finisma.de/api/v1`
- URL: `https://finisma.de/api/v1/verify`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://finisma.de/api/oauth/authorize`, token URL `https://finisma.de/api/oauth/token`, scopes: `invoice:verify`, `invoice:create`)

## Response `200`

Prüfbericht.

- object
  - `summary` string, required: Kurzfassung des Ergebnisses.
  - `result` object, required
    - `structure` object, required: Strukturelle Prüfung der PDF (ohne die eingebettete XML).
      - `file` object
        - `present` boolean
        - `bytes` integer
        - `isPdf` boolean
        - `pdfVersion` string, nullable
      - `zugferd` object
        - `embeddedFiles` boolean
        - `facturXFilename` boolean
        - `associatedFile` boolean
        - `pdfAPart` string, nullable: z. B. "3" für PDF/A-3.
        - `pdfAConformance` string, nullable: z. B. "B", "U".
        - `facturXMetadata` boolean
        - `xmlEmbedded` boolean
        - `xmlMatchesGenerated` boolean, nullable
    - `en16931` object, nullable: EN-16931-Prüfung; null, wenn keine XML eingebettet war.
      - `checked` boolean
      - `errorCount` integer
      - `warningCount` integer
      - `profile` string
      - `findings` object[]
        - `code` string, required: z. B. "BR-CO-25".
        - `message` string, required
        - `severity` 'error' | 'warning', required
        - `location` string
        - `source` 'schematron' | 'supplementary', required
    - `pdfa3` object, nullable: PDF/A-3-Anbindung der eingebetteten Dateien (ISO 19005-3 §6.8).
      - `hasAfArray` boolean
      - `allOk` boolean
      - `files` object[]
        - `filename` string
        - `afRelationship` string, nullable
        - `associated` boolean
        - `status` 'ok' | 'warning' | 'error'
        - `message` string
    - `attachments` object[], required: Im CII referenzierte Anhänge (BT-125).
      - `filename` string
      - `mimeCode` string
      - `sizeBytes` integer
    - `authoritative` object, required: Autoritative Prüfung: PDF/A-Konformität (ISO 19005-3), XML-Syntax (XSD) und Geschäftsregeln des erkannten Profils. available=false, wenn der Validator-Service nicht erreichbar war; das Ergebnis basiert dann nur auf der Schnellprüfung.
      - `available` boolean, required
      - `profile` string
      - `verdict` 'valid' | 'valid_with_warnings' | 'invalid'
      - `errorCount` integer
      - `warningCount` integer
      - `engines` string[]
      - `findings` object[]
        - `code` string, required
        - `severity` 'error' | 'warning' | 'info', required
        - `message` string, required
        - `location` string, nullable
        - `source` string, required: xsd | schematron | pdfa | structure
        - `ruleset` string
        - `engine` string
      - `note` string

## Other responses

- `400`: Ungültige Eingabe.
- `401`: Kein oder ungültiges Credential.
- `429`: Rate-Limit oder kostenloses Tageskontingent erschöpft (siehe Retry-After).
- `502`: Fehler im nachgelagerten Dienst.

---

[API](https://skmtc.dev/finisma/apis/finisma-rest-api.md) · [All operations](https://skmtc.dev/finisma/apis/finisma-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finisma/apis/finisma-rest-api/revisions/c1a9acfab69b?raw)