Zahlungsverkehr

Zahlungsdatei pain.001 prüfen (SEPA oder AXZ)

Prüft eine pain.001-Datei (Versionen .09 und .03) mit denselben fachlichen Regeln wie der pain.001-Validator auf finisma.de und dazu gegen das Schema (DK-TVS für SEPA bzw. AXZ, ISO-Schema für .03). Das Profil (SEPA oder AXZ) wird erkannt; 'profile' setzt es fest. Antwort: Profil, Version, Zusammenfassung (Anzahl, Summe je Währung), Befunde der Prüfregeln, Ergebnis der Schemaprüfung mit Zeile und Spalte und ein Gesamturteil. Ist der Validierungsdienst nicht erreichbar, steht xsd.available=false und das Urteil beruht nur auf den Prüfregeln. Nichts wird gespeichert. Kostenlos bis 5 Aufrufe pro Tag und Konto. Mit dem Zahlungsverkehr-Abo (Feature payments) ohne Limit. Ohne Abo kauft 1 Credit einen Prüfblock mit 10 weiteren Prüfungen (für Zahlungsdateien und Kontoauszüge gemeinsam, ohne Ablaufdatum). Ein Konto (API-Key oder OAuth) ist immer nötig.

post/payments/validate

Request

  • Base URL: https://finisma.de/api/v1
  • URL: https://finisma.de/api/v1/payments/validate
  • 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)

Request body

xmlstring

Die Datei als XML-Text (max. 10 MB). Alternativ 'file_base64'.

file_base64string byte

Die XML-Datei Base64-kodiert (max. 10 MB). Alternativ 'xml'.

filenamestring

Optionaler Dateiname, erscheint in den Meldungen.

profile'auto' | 'sct' | 'axz'

Profil der Prüfung: auto (Erkennung aus der Datei), sct (SEPA-Überweisung) oder axz (Auslandszahlung).

Response

Ergebnis; billing nennt, womit bezahlt wurde.

summarystring required

Kurzfassung des Ergebnisses.

Changes

No recorded changes to this operation across all 1 revision of this API.