Zahlungsverkehr

Auslandszahlungsdatei (pain.001.001.09, DK-AXZ) erzeugen

Erzeugt aus einem Zahllauf (JSON) die Auslandszahlungsdatei im DK-AXZ-Profil (GBIC_5): beliebige ISO-Währungen, Entgeltregelung je Zahlung (Default SHAR), Empfängeradresse mit Ort und Länderkennung ist Pflicht, purposeCode (Zweckcode Purp/Cd, z. B. SUPP) optional; ultimateDebtor/ultimateCreditor brauchen hier einen Namen (max 140) und dürfen eine Adresse tragen, instructionId, creditorId, debtor.id und initiatingPartyId wie bei /payments/sepa. Erfordert das Feature 'paymentsAbroad' (Auslandsmodul-Add-on; 'payments' allein reicht NICHT). Ablauf, Fehlerformen (422 mit Issue-Liste, 502 mit QA-Befunden) und Accept-Regel wie bei /payments/sepa; die autoritative Prüfung läuft hier gegen das AXZ-TVS. Dateiname: axz-ausland-<Datum>.xml.

post/payments/axz

Request

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