SEPA-API in Node.js integrieren

Lernen Sie Schritt für Schritt, wie Sie die GenerateSEPA-API aus Node.js mit fetch oder axios nutzen.

Kurzüberblick

Geschätzte Zeit: 5–15 Minuten je nach Dateigröße.
Tool: GenerateSEPA.
Ergebnis: Eine SEPA-XML-Datei, die bereit für Ihre Bank ist.

Voraussetzungen

Sie benötigen:

Eine Quelldatei (Norma, CSV, Excel oder JSON).
Ihre Gläubiger-ID (CID). Falls Sie noch keine haben, berechnen Sie sie unter SEPA Creditor Identifier.
Zugang zum Online-Banking-Portal Ihrer Bank.

Schritte

API-Schlüssel besorgen — Kopieren Sie Ihr persönliches Token aus dem GenerateSEPA-Dashboard.
/api/v1/sepa/direct_debits aufrufen — Senden Sie Ihre Vorgänge als JSON per POST.
XML empfangen — Die Antwort ist eine pain.008-Datei, bereit zum Signieren und Einreichen.
Fehler behandeln — Jeder 4xx-Statuscode enthält ein errors-Feld mit den betroffenen IBANs/Vorgängen.

Pflichtvalidierung

Bevor Sie die Datei einreichen, validieren Sie sie immer mit unserem SEPA-XML-Validator. 80 % der Retouren werden hier abgefangen.

Häufige Fehler

Falsches Prüfzeichen in der Schuldner-IBAN → AC01.
Nicht unterschriebenes Mandat oder falsches Datum → MD01.
Verwendungszweck mit Nicht-ASCII-Zeichen → manche Banken lehnen die Datei ab.

Fazit

Folgen Sie diesen Schritten und Ihre Sammellastschrift wird in unter 10 Minuten eingereicht. Bei Problemen kontaktieren Sie uns über die Website.

Häufig gestellte Fragen

Benötige ich einen kostenpflichtigen Tarif?

Mit GenerateSEPA erhalten Sie eine kostenlose Konvertierung pro Monat. Bei größeren Volumina prüfen Sie bitte die Monatspläne.

Funktioniert die erzeugte Datei bei jeder Bank?

Ja, SEPA-XML ist ein Standard, den jede Bank im SEPA-Raum akzeptiert. Einige Banken verlangen `pain.001.001.09`, das wir ebenfalls unterstützen.

Kann ich den Prozess vollständig automatisieren?

Ja, über die API oder die Zapier/Make/n8n-Connectoren. Weitere Details finden Sie in unseren Automatisierungsanleitungen.

Sollte ich fetch oder axios für die API-Aufrufe verwenden?

Beide Bibliotheken funktionieren einwandfrei. `fetch` ist seit Node.js 18 nativ verfügbar und benötigt keine zusätzliche Abhängigkeit. `axios` bietet zusätzliche Funktionen wie automatische JSON-Serialisierung und interceptors, was es für komplexere Integrationen nützlich macht.