Zahlungsverkehr

SEPA-Sammelüberweisung (pain.001.001.09) erzeugen

Erzeugt aus einem Zahllauf (JSON) die SEPA-Sammelüberweisung im SCT-Profil, mit derselben Erzeugung wie auf /zahlungen (byteidentisches XML). Erfordert das Feature 'payments' (Zahlungsverkehr-Abo). Auth per Login-Session oder Bearer-Credential, unabhängig vom OAuth-Scope. Vor der Erzeugung laufen die Geschäftsregeln (IBAN-Prüfziffern, Beträge, Fristen; Verstoß ⇒ 422 mit Issue-Liste in details, keine Datei), danach die autoritative Prüfung gegen das DK-TVS (Scheitern ⇒ 502 mit Befunden in details, keine Datei). categoryPurpose "SALA" an einer Zahlung kennzeichnet sie als Gehaltszahlung (CtgyPurp SALA, eigener PmtInf-Block); an /payments/axz ist das Feld ein 422. instrPrty "HIGH" setzt die Priorität (PmtTpInf/InstrPrty, ebenfalls eigener PmtInf-Block); weglassen bedeutet NORM, an /payments/axz ist das Feld ein 422. purposeCode (1 bis 4 Zeichen, z. B. SUPP) setzt den Zweckcode CdtTrfTxInf/Purp/Cd für den Empfänger. ultimateDebtor/ultimateCreditor (Name, Kennung) sind abweichender Auftraggeber und Empfänger (UltmtDbtr/UltmtCdtr), instructionId die Auftragsreferenz (PmtId/InstrId), creditorId und debtor.id Partei-Kennungen (LEI, BIC, sonstige), initiatingPartyId die Kennung des Einreichers. Standardantwort ist das XML als Datei (Content-Disposition: sepa-inland-<Datum>.xml); nur ein Accept-Header, der ausdrücklich und ohne /-Platzhalter application/json verlangt, liefert stattdessen die JSON-Hülle.

post/payments/sepa

Request

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

requestedExecutionDatestring required

Response

Die erzeugte Zahlungsdatei, standardmäßig als XML; die JSON-Hülle nur auf ausdrücklichen Accept-Wunsch.

xmlstring required

Die pain.001-XML als Text.

filenamestring required

Vorgeschlagener Dateiname, gleiches Schema wie der Content-Disposition-Name der XML-Antwort (sepa-inland-<Datum>.xml bzw. axz-ausland-<Datum>.xml).

verification'autoritativ' | 'eingeschränkt' required

autoritativ = die Datei hat das QA-Gate (DK-TVS bzw. AXZ-TVS) durchlaufen; eingeschränkt = kein Validator konfiguriert, geprüft wurden nur Schema und Geschäftsregeln.

Changes

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