# finisma – ZUGFeRD-Konverter und Zahlungsverkehr > finisma ist ein Online-Dienst für elektronische Rechnungen und SEPA- > Zahlungsverkehr. Der ZUGFeRD-Konverter wandelt eine hochgeladene > PDF-Rechnung in eine geprüfte elektronische Rechnung im ZUGFeRD-Format > (EN 16931) um: finisma extrahiert die Rechnungsdaten, validiert sie gegen > die Norm EN 16931, erzeugt das CII-XML und bettet es in eine PDF/A-3 ein > (ZUGFeRD/Factur-X). Das Zahlungsverkehr-Modul erzeugt aus hochgeladenen > Rechnungen eine SEPA-Sammelüberweisung (pain.001) zum Download und, mit dem > Auslandsmodul, eine Auslandszahlungsdatei (AXZ); die Einreichung bei der > eigenen Bank bleibt beim Nutzer, finisma löst keine Zahlung aus. Dazu kommen > kostenlose Prüfwerkzeuge ohne Anmeldung: der ZUGFeRD-Viewer und ein > pain.001-Validator für SEPA- und Auslandszahlungsdateien. Die Basis-Nutzung > des Konverters ist kostenlos und ohne Anmeldung. KI-Agenten können finisma > direkt über einen MCP-Server nutzen. ## Wichtige Fakten - Eingabe: PDF-Rechnung. Ausgabe: ZUGFeRD-/Factur-X-PDF (PDF/A-3 mit eingebettetem EN-16931-CII-XML). - Kostenlos und ohne Registrierung nutzbar (mit Wasserzeichen). Credits: 10 € zzgl. MwSt. für 25 Rechnungen ohne Wasserzeichen (Guthaben, verfällt nicht, kostenloses Konto nötig; gilt auch für API und MCP, dort ohne Tageslimit; Aufladung per Karte). Konverter-Abo mit allen Premium-Funktionen: 8 € zzgl. MwSt./Monat, monatlich kündbar. Fair Use: bis 100 Rechnungen ohne Wasserzeichen je Kalendermonat, kein hartes Limit. Mehr Volumen über das Zusatzpaket „1.000 Rechnungen“: je Paket 82 € zzgl. MwSt./Monat und 1.000 Rechnungen im Monat mehr, mehrfach buchbar, zu jedem laufenden Abo (auch Zahlungsverkehr). Beispiele: Abo mit einem Paket 90 €/Monat für 1.100 Rechnungen, mit zwei Paketen 172 €/Monat für 2.100. Der Stand des Monats steht im Konto und unter GET /api/v1/me (fairUse). Fragen zu größeren Mengen an erechnung@paulibytes.de. - Zu-/Abschläge gibt es auf Dokumentebene (allowanceCharges, BG-20/21) und je Position (lines[].allowanceCharges, BG-27/28); lineNetAmount ist der Betrag nach den Positions-Einträgen, ein Grund ist Pflicht. Positions- Einträge dürfen als Prozentsatz ohne amount kommen (percent): amount = round2(Menge × unitPriceNet × percent / 100), mit basisAmount auf dessen Basis; lineNetAmount und Summen rechnet der Aufrufer mit diesem Betrag. Auf Rechnungsebene ebenso: ohne basisAmount ist die Basis die Summe der lineNetAmount mit ratePercent (fehlt der Satz, der einzige Satz der Positionen). - Zahlungsart über payment.meansCode (30, 58, 59; Codeliste /api/v1/codelists/payment-means). SEPA-Lastschrift (59) braucht Mandatsreferenz, Gläubiger-ID und das belastete Käuferkonto (BT-89/90/91). - Positionen tragen ihre USt-Kategorie automatisch über den Steuersatz; bei zwei Aufschlüsselungen mit demselben Satz (z. B. E und AE, je 0 %) ordnet das optionale Feld categoryCode je Position zu (BT-151). - XRechnung für öffentliche Auftraggeber: profile "xrechnung" im invoice-JSON erzeugt die XRechnung 3.0 (nur mit format=xml). Pflicht: Leitweg-ID in buyerReference, Verkäufer-Kontakt mit Telefon und E-Mail, Zahlungsangaben und electronicAddress beider Parteien (BT-34/BT-49). - Premium-Funktionen des Konverter-Abos: Rechnungen ohne Wasserzeichen, Dateianhänge in die E-Rechnung einbetten (BT-125), eingebettete Anhänge herunterladen, API-/MCP-Zugang zum Erzeugen von Rechnungen. - Zahlungsverkehr-Modul (/zahlungen): aus hochgeladenen Rechnungen (E-Rechnung, PDF, CSV) entsteht eine SEPA-Sammelüberweisung (pain.001) zum Download, 29 € zzgl. MwSt./Monat. Enthalten sind Mehrfach-Upload, alle Inland-Eingabewege, sämtliche Premium-Funktionen des Konverter-Abos und der REST-Endpoint POST /api/v1/payments/sepa. finisma erzeugt ausschließlich die Datei; Einreichung bei der Bank und Zahlungsauslösung bleiben beim Nutzer. - Gehaltszahlungen: Der Schalter „Gehaltszahlung“ auf /zahlungen kennzeichnet die SEPA-Datei als Lohn- und Gehaltszahlung (CtgyPurp SALA). In der CSV steht dafür die optionale Spalte zweck mit dem Wert SALA, in der REST-API das Feld categoryPurpose. Manche Banken verlangen für Gehaltsdateien eine eigene Freigabe oder Einreichung; das klärt der Nutzer mit seiner Bank. - Auslandsmodul: Zusatzbaustein zum Zahlungsverkehr-Modul für zusätzlich 19 € zzgl. MwSt./Monat (zusammen 48 € zzgl. MwSt./Monat), nur in Kombination mit dem Zahlungsverkehr-Modul buchbar. Erzeugt die Auslandszahlungsdatei (AXZ), ermittelt die BIC aus der IBAN und schaltet den REST-Endpoint POST /api/v1/payments/axz frei. DTAZV-Dateien einlesen und prüfen ist kostenlos und braucht kein Abo; das Modul wird für die erzeugte AXZ-Datei fällig. - Mandanten-Staffel: Zusatzbaustein zum Zahlungsverkehr-Modul für mehrere serverseitig hinterlegte Auftraggeberkonten. Stufe S (bis 5 Mandanten): zusätzlich 10 € zzgl. MwSt./Monat. Stufe M (bis 20 Mandanten): zusätzlich 25 € zzgl. MwSt./Monat. Ohne gebuchte Stufe gilt ein Mandant. Für mehr als 20 Mandanten Vertriebskontakt über die unten genannte E-Mail-Adresse. - Jahreszahlung: Alle Abos gibt es auf Wunsch als Jahresabo mit 2 Monaten Rabatt, abgerechnet als eine Jahresrechnung mit Zahlung per Überweisung (ZUGFeRD-Abo 80 € statt 96 €, Zusatzpaket 820 € je Paket, Zahlungsverkehr-Modul 290 € statt 348 €, Auslandsmodul 190 €, Stufe S 100 €, Stufe M 250 €, jeweils zzgl. MwSt. pro Jahr; Abo mit einem Paket 900 €, mit zwei Paketen 1.720 €). Buchbar im Konto-Bereich; die Rechnung kommt per E-Mail mit Überweisungsdaten (Zahlungsziel 14 Tage). Den Zahlungsverkehr gibt es dort auch monatlich auf Rechnung, das ZUGFeRD-Abo und die Zusatzpakete nur jährlich. Per Karte sind alle Abos monatlich. Credits werden per Karte aufgeladen. - Alle genannten Preise sind netto (zzgl. MwSt.); das Angebot richtet sich an Unternehmer (§ 14 BGB). - Kostenlose Prüfwerkzeuge ohne Anmeldung: der ZUGFeRD-Viewer (siehe Seiten) und der pain.001-Validator. Der pain.001-Validator prüft pain.001.001.09 gegen die DK-TVS GBIC_5 der deutschen Kreditwirtschaft (SEPA- und AXZ-Profil) sowie das ältere pain.001.001.03 gegen das ISO-Schema. - Datenschutz: Im Zahlungsverkehr-Modul werden E-Rechnung, CSV und DTAZV vollständig im Browser verarbeitet, die SEPA-/AXZ-Datei entsteht dort und verlässt den Browser nur beim Download. Nur der PDF-Eingabeweg läuft über den Server. Hochgeladene und erzeugte Dateien werden dort spätestens 5 Minuten nach dem Upload automatisch gelöscht. - Auftragsverarbeitung: ein Auftragsverarbeitungsvertrag (AVV) nach Art. 28 DSGVO mit den eingesetzten technischen und organisatorischen Maßnahmen gilt automatisch mit der Nutzung (siehe /avv). - Ablauf Konverter: Hochladen → automatische Extraktion → Prüfung/Korrektur → XML-Erzeugung → ZUGFeRD-Einbettung → Download inkl. Prüfprotokoll. - Ablauf Zahlungsverkehr: Hochladen → Zahlungsliste prüfen (IBAN-Prüfziffer, Skonto-Vorschlag) → Download der SEPA- bzw. AXZ-Datei. - Betreiber: Paulibytes UG (haftungsbeschränkt), Hamburg, Deutschland. - Sprache: Deutsch. ## Zugang über die REST-API - Basis: https://finisma.de/api/v1, Authentifizierung per API-Key (Authorization: Bearer fnsm_…) oder OAuth-2.1-Token. Maschinenlesbare Spezifikation: https://finisma.de/api/v1/openapi.json, Referenz mit Beispielen: https://finisma.de/entwickler/rest, interaktive Doku zum Ausprobieren: https://finisma.de/api-docs - `POST /api/v1/verify` prüft eine hochgeladene E-Rechnung. Kostenlos, ein Credential ist trotzdem nötig. - `POST /api/v1/extractions` liest die EN-16931-Daten aus einer hochgeladenen PDF-Rechnung und liefert `invoice`, `issues` und `repairedPaths`. Vorstufe zum Erzeugen. Läuft mit Abo oder kostet 1 Credit je Aufruf (dort arbeitet ein Sprachmodell); Rate-Limit 10 pro Minute. Unsicher gelesene Felder kommen als Platzhalter zurück ("KORRIGIEREN" bei Text, "1900-01-01" bei Datum, 0 bei Beträgen) und stehen in `repairedPaths`; sie müssen vor dem Erzeugen ersetzt werden. - `POST /api/v1/invoices` erzeugt aus visueller PDF und strukturierten EN-16931-Daten (JSON) die ZUGFeRD-PDF. Die PDF ist optional: Ohne sie setzt finisma die Rechnung aus den Daten (dieselbe Vorlage wie im ZUGFeRD-Viewer), optional mit Logo rechts oben (multipart-Part `logo` bzw. `logo_base64`; PNG, JPEG oder SVG, max. 500 KB) und Sprache (`lang`: de oder en). Die Anfrage geht als multipart/form-data oder als `application/json` mit `{ invoice, logo_base64, lang, filename, attachments }`. Die fertige Datei wird vor der Auslieferung autoritativ geprüft (PDF/A-3, EN 16931). - `POST /api/v1/invoices?format=xml` liefert stattdessen nur das CII-XML: kein Träger-PDF, kein Einbettungsschritt, deutlich schneller. Gedacht für B2G-Einreichungen (mit profile "xrechnung" als echte XRechnung 3.0) und ERP-Integrationen, die das Sichtdokument selbst erzeugen. Dieser Weg braucht ein aktives Abo oder Guthaben (1 Credit je Aufruf), weil das kostenlose Tageskontingent mit dem finisma-Prüfsiegel als Wasserzeichen arbeitet und ein XML kein Wasserzeichen tragen kann. - `POST /api/v1/payments/sepa` und `POST /api/v1/payments/axz` erzeugen aus einem Zahllauf (JSON) die SEPA-Sammelüberweisung (pain.001.001.09) bzw. die Auslandszahlungsdatei (DK-AXZ). Es ist dieselbe Erzeugung wie unter /zahlungen, mit Geschäftsregel-Prüfung (422 mit Issue-Liste) und autoritativem QA-Gate vor der Auslieferung; erfordert das Zahlungsverkehr-Modul bzw. zusätzlich das Auslandsmodul. Mit "categoryPurpose": "SALA" an einer Zahlung wird sie in der SEPA-Datei als Gehaltszahlung gekennzeichnet (eigener PmtInf-Block); an /payments/axz ist das Feld ein Fehler. - `POST /api/v1/payments/validate` prüft eine vorhandene Zahlungsdatei pain.001 (SEPA oder AXZ, Versionen .09 und .03): Zusammenfassung, Befunde der Prüfregeln, Schemaprüfung mit Zeile und Spalte, Gesamturteil. - `POST /api/v1/statements/validate` prüft Kontoauszüge (camt.052, camt.053, camt.054 in .02 und .08) und Gebührenabrechnungen (camt.086, .01 bis .05), einzeln oder als ZIP. `POST /api/v1/statements/parse` liefert dieselben Dateien als JSON: Konten, Salden, Buchungen mit Gegenpartei, IBAN, Verwendungszweck, End-to-End-Referenz und GVC, bei camt.086 Services und Summen je Währung. - Diese drei Endpunkte brauchen ein Konto. Kostenlos sind je Konto und Tag 5 Prüfungen von Zahlungsdateien und 5 Prüfungen von Kontoauszügen, dazu je Konto und Monat 5 Leseaufrufe. Mit dem Zahlungsverkehr-Abo gibt es kein Limit. Sonst kauft beim Prüfen 1 Credit einen Prüfblock mit 10 Prüfungen, der nicht verfällt, und beim Auslesen kostet jeder weitere Aufruf 1 Credit. Ohne Guthaben HTTP 402. Die Antwort nennt in `billing`, womit bezahlt wurde. ## Zugang für KI-Agenten (MCP) - Remote-MCP-Server: https://finisma.de/api/mcp (Streamable HTTP, JSON-RPC). Dateien werden Base64-kodiert übergeben und zurückgeliefert. - Tool `verify_zugferd`: prüft eine PDF auf ZUGFeRD-/Factur-X-Konformität (Struktur, EN-16931-Geschäftsregeln, PDF/A-3-Anhänge). Kostenlos, auch ohne API-Key nutzbar. - Tool `create_zugferd`: erzeugt aus einer visuellen Rechnungs-PDF und strukturierten EN-16931-Rechnungsdaten (JSON) eine ZUGFeRD-Rechnung, optional mit Anhängen. Ohne PDF wird die Rechnung aus den Daten gesetzt, optional mit Logo (`logo_base64`) und Sprache (`lang`). Braucht einen API-Key eines finisma-Kontos (Authorization: Bearer). Ohne Abo kostenlos mit Wasserzeichen (finisma-Prüfsiegel, standardmäßig bis zu 5 Rechnungen pro Tag), mit Abo ohne Wasserzeichen und ohne Tageslimit. - Tool `extract_invoice`: liest die EN-16931-Daten aus einer PDF-Rechnung aus (Formularfelder plus offene Probleme) als Korrekturschritt vor `create_zugferd`. Läuft mit Abo oder kostet 1 Credit je Aufruf (dort arbeitet ein Sprachmodell); das kostenlose Tageskontingent gilt hier nicht. Auch über HTTP verfügbar als `POST /api/v1/extractions`. - Tool `check_vat_id`: prüft eine USt-IdNr. live gegen VIES (das EU-Bestätigungsverfahren) und liefert valid/invalid/unavailable plus Firmenname, sofern der Mitgliedsstaat ihn herausgibt. Kostenlos, auch ohne API-Key nutzbar. Auch über HTTP als `GET /api/v1/vat/check?vatId=…`. - Tool `check_peppol_participant`: prüft per SML/SMP-Lookup, ob ein Geschäftspartner im Peppol-Netz erreichbar ist (Eingabe: GLN, deutsche USt-IdNr., Leitweg-ID oder volle Kennung), und listet seine registrierten Dokumenttypen. registered:false ist ein normales Ergebnis, kein Fehler. Kostenlos, auch ohne API-Key nutzbar. Auch über HTTP als `GET /api/v1/peppol/check?participant=…`. - API-Keys erstellt der Kontoinhaber unter https://finisma.de/konto. - Maschinenlesbares Tool-Verzeichnis inkl. JSON-Schemas: https://finisma.de/api/capabilities - Zusätzlich deklariert die Website ihre Tools in-page über WebMCP (document.modelContext) für Browser-Agenten eingeloggter Nutzer. - Tools `validate_payment_file`, `validate_bank_statement` und `parse_bank_statement`: Zahlungsdatei pain.001 prüfen, Kontoauszüge (camt) prüfen bzw. als JSON lesen. Datei als `xml` (Text) oder `file_base64`. Dieselben Funktionen und Preise wie die REST-Endpunkte payments/validate, statements/validate und statements/parse. - Der DTAZV-Konverter ist bislang nur über die Website nutzbar; Zahlungsdateien erzeugen (payments/sepa, payments/axz) gibt es außer über die Website auch über die REST-API, aber nicht über MCP. ## Maschinenlesbare Dokumente Alle Dokumente sind öffentlich, lesend und ohne Anmeldung abrufbar. - https://finisma.de/llms.txt: diese Anleitung als Text. - https://finisma.de/openapi.json: REST-API als OpenAPI 3.1 (kanonisch unter https://finisma.de/api/v1/openapi.json). Operationen mit dem Feld x-finisma-mcp-tool gibt es gleichnamig als MCP-Tool. - https://finisma.de/api/mcp/server-card: MCP Server Card (SEP-2127) mit Endpunkt, Protokollversionen und Auth-Hinweis; Aliase https://finisma.de/.well-known/mcp.json und https://finisma.de/.well-known/mcp/server-card.json. - https://finisma.de/.well-known/ai-catalog.json: AI Catalog, Einstieg für Domain-Crawler, verweist auf Server Card und REST-Spezifikation. - https://finisma.de/server.json: Eintrag für die MCP Registry (de.finisma/finisma). - https://finisma.de/.well-known/oauth-authorization-server und https://finisma.de/.well-known/oauth-protected-resource: OAuth 2.1 mit PKCE und Dynamic Client Registration, Nutzungsbedingungen und Datenschutz sind dort verlinkt. - https://finisma.de/api/capabilities: Tool-Verzeichnis mit JSON-Schemas. - https://finisma.de/.well-known/security.txt: Sicherheitskontakt (RFC 9116). ## Seiten - [Startseite / Konverter](https://finisma.de/): PDF hochladen und ZUGFeRD-Rechnung herunterladen. - [ZUGFeRD-Viewer](https://finisma.de/zugferd-viewer): kostenloses Tool, das eine PDF-Rechnung strukturell und inhaltlich prüft (ZUGFeRD-/Factur-X- Konventionen, EN-16931-Geschäftsregeln per Schematron, PDF/A-3-Anbindung der Anhänge) und die eingebettete CII-XML sichtbar macht. Keine Speicherung. - [Zahlungsverkehr](https://finisma.de/zahlungen): Tool, das aus hochgeladenen E-Rechnungen, PDF-Rechnungen oder CSV-Listen eine SEPA-Sammelüberweisung (pain.001) zum Download erzeugt; mit dem Auslandsmodul zusätzlich eine Auslandszahlungsdatei (AXZ). Upload und Zahlungsliste sind frei, der Download ist Teil des Zahlungsverkehr-Moduls. Ausführliche Erklärung mit FAQ unter [Rechnungen bezahlen](https://finisma.de/rechnungen-bezahlen). - [pain.001-Validator](https://finisma.de/pain-001-validator): kostenloses Tool ohne Anmeldung, das eine pain.001-Zahlungsdatei im Browser zusammenfasst und gegen Geschäftsregeln prüft; auf Klick zusätzlich autoritativ gegen die DK-TVS GBIC_5 (pain.001.001.09, SEPA- und AXZ-Profil) bzw. gegen das ISO-Schema (pain.001.001.03). - [DTAZV-Konverter](https://finisma.de/dtazv-konverter): erklärt die Umstellung von DTAZV auf AXZ (pain.001.001.09) vor der Abschaltung von DTAZV durch die Banken; die Umwandlung selbst läuft im Zahlungsverkehr-Tool unter /zahlungen, Teil des Auslandsmoduls. - [Preise](https://finisma.de/preise): alle Tarife auf einen Blick (Konverter kostenlos/Credits/Abo, Zahlungsverkehr-Bausteine, Mandanten-Staffel, Jahreszahlung). - [Konto](https://finisma.de/konto): Login (Magic Link), Abo-Verwaltung und API-Keys für den MCP-Zugang. - [Blog](https://finisma.de/blog): Ratgeber zur E-Rechnungspflicht, ZUGFeRD und digitaler Buchhaltung. - [Impressum](https://finisma.de/impressum): Anbieterkennzeichnung gemäß § 5 DDG. - [Datenschutzerklärung](https://finisma.de/datenschutz): Verarbeitung, Speicherdauer (5 Minuten) und Auftragsverarbeiter. - [AGB](https://finisma.de/agb), [Auftragsverarbeitungsvertrag](https://finisma.de/avv) (AVV, Art. 28 DSGVO, gilt automatisch mit der Nutzung) und [Widerrufsbelehrung](https://finisma.de/widerruf). ## Begriffe - ZUGFeRD / Factur-X: hybrides Rechnungsformat – sichtbares PDF plus eingebettete maschinenlesbare XML-Daten. - EN 16931: europäische Norm für das semantische Datenmodell elektronischer Rechnungen. - E-Rechnungspflicht: in Deutschland müssen Unternehmen im B2B seit 2025 elektronische Rechnungen empfangen können; finisma hilft beim Erstellen normkonformer Rechnungen aus bestehenden PDFs. - MCP (Model Context Protocol): offener Standard, über den KI-Agenten Tools aufrufen; finisma stellt Prüfen und Erzeugen von ZUGFeRD-Rechnungen als MCP-Tools bereit. - pain.001: ISO-20022-Nachricht für SEPA-Überweisungen (Sammelüberweisung); für Auslandszahlungen kommt dasselbe Format mit dem AXZ-Profil zum Einsatz. Deutsche Banken prüfen eine eingereichte Datei zusätzlich gegen die DK-TVS, eine engere Prüfgrundlage der deutschen Kreditwirtschaft. - AZV: Auslandszahlungsverkehr; zugleich die bisherige EBICS-Auftragsart, über die DTAZV-Dateien eingereicht werden. "AZV nach ISO 20022" meint den Nachfolger: die EBICS-Auftragsart AXZ mit einer pain.001.001.09-Datei im AXZ-Profil der Deutschen Kreditwirtschaft. finisma erzeugt und prüft solche Dateien. - DTAZV: älteres Festbreiten-Dateiformat für Auslandsüberweisungen im deutschen EBICS-Zahlungsverkehr. Einzelne Banken kündigten das Ende für November 2026 an, die Deutsche Kreditwirtschaft hat die Abkündigung im September 2026 ausgesetzt. Nachfolger bleibt AXZ. ## Kontakt - E-Mail: erechnung@paulibytes.de