pain.001.001.02 zu pain.001.001.03 Format-Konverter für den österreichischen Zahlungsverkehr (STUZZA)

SEPA-Konverter: STUZZA pain.001 (v02 zu v03)

Automatisieren Sie die Migration Ihrer österreichischen Zahlungsverkehrsdateien.

Die ZIP-Dateil enthält ein PowerShell-Script "xml-converter.ps1" und pain001_02to03.xslt mit der eigentlichen Logik. Beide Dateien müssen sich im selben Order befinden. Der Konverter erzeugt dann im Home-Ordner (z.B. "Dokumente) eine neue Datei mit der Endung _out.xml.

Dieses Tool löst das Kompatibilitätsproblem zwischen älterer Buchhaltungssoftware und modernen Bankportalen. Es transformiert spezifische STUZZA-XML-Strukturen präzise in den aktuellen ISO-Standard.

Was das Tool technisch leistet:

• Namespace-Migration: Wandelt den STUZZA-spezifischen Namespace (APC:STUZZA...) in den Standard-Namespace (urn:iso:std:iso:20022...) um.
• Struktur-Update: Wickelt die Daten aus dem alten pain.001.001.02 Wrapper aus und bettet sie korrekt in die neue CstmrCdtTrfInitn-Struktur ein.
• Daten-Bereinigung:
• Automatisches "SEPA"-Tag: Ergänzt fehlende Service-Level-Informationen, falls diese im Quellformat fehlten.
• BIC-Korrektur: Wandelt ungültige NOTAVAIL Einträge automatisch in den Standardwert NOTPROVIDED um.
• Validierung: Stellt sicher, dass Pflichtfelder wie EndToEndId niemals leer bleiben (Fallback auf NOTPROVIDED).
• Spezial-Filter: Entfernt veraltete Felder (z. B. Grpg oder BkPtyId), die im neuen Standard zu Fehlermeldungen beim Bank-Upload führen würden.

Anleitung

Besonderheiten der Transformation

Das Skript führt eine intelligente Datenprüfung durch. Bitte beachten Sie folgende Punkte bei der Vorbereitung Ihrer Dateien:

1. BIC-Handling: Wenn Ihre Quelldatei keinen BIC enthält (oder dort "NOTAVAIL" steht), wird dies im Zielformat zu "NOTPROVIDED" korrigiert. Dies ist für SEPA-Zahlungen innerhalb des EWR meist ausreichend.
2. Identifikationsdaten: Das Skript ist darauf optimiert, nur notwendige Identifikationsmerkmale (wie den Namen) zu übernehmen. Komplexe Organisations-IDs, die oft zu Validierungsfehlern führen, werden bewusst gefiltert.
3. SEPA-Kennzeichnung: Das System erkennt automatisch, ob eine Zahlung als SEPA-Transfer markiert ist. Falls nicht, fügt das Skript diesen Marker eigenständig hinzu, um die Akzeptanz bei der Bank zu erhöhen.

Fehler im Log

Falls das PowerShell-Fenster einen Fehler bei der Transform-Methode ausgibt, liegt dies meist an einer ungültigen XML-Struktur der Quelldatei (z. B. Sonderzeichen, die nicht UTF-8 konform sind).