windata SEPA-API Basic / Pr Dkumentatin Versin v1.8.0.0 11.11.2014 windata GmbH & C. KG windata GmbH & C.KG Gegenbaurstraße 4 88239 Wangen im Allgäu
windata SEPA-API Basic / Pr - Dkumentatin Inhaltsverzeichnis 1 Einführung... 3 2 Ausführungen... 4 2.1 SEPA-API Basic... 4 2.2 SEPA-API Pr... 5 3 Einbindung... 7 4 Hinweise zu den Kmpnenten... 8 4.1 Financial Institutin Supprt Library (wdfispt.dll)... 8 4.2 SEPA Cnverter (wdsepacnv.dll)... 8 4.3 SEPA Checker (wdsepachk.dll)... 9 4.4 SEPA Dcument Pl (wdsepadcpl.dll)... 9 Cpyright windata GmbH & C. KG Seite 2 vn 9
windata SEPA-API Basic / Pr - Dkumentatin 1 Einführung Der neue SEPA-Zahlungsverkehr stellt Verbraucher, jedch insbesndere Unternehmen, vr zahlreiche Herausfrderungen. Die Umstellung vm bisherigen natinalen Zahlungsfrmat in ein eurpaweites Transaktinsverfahren stellt eine der umfangreichsten Umwälzungen in der Geschichte der eurpäischen Finanzwelt dar. Ab August 2014 sind Firmen verpflichtet, sämtliche Transaktinen auf das neue SEPA-Frmat umzustellen. Unternehmen, welche diesen Termin vernachlässigen der letztlich verstreichen lassen, handeln fahrlässig und können nach Ablauf dieser Frist unter Umständen keine Zahlungen mehr tätigen. Eine vrübergehende Parallellösung beider Frmate ist nicht vrgesehen. Basierend auf diesem Hintergrund stellt die windata GmbH & C.KG eine mderne und zukunftsfähige Prgrammierbiblithek bereit, welche Entwickler bei der Umsetzung vn SEPA-fähigen Lösungen unterstützen. Ein besnderes Augenmerk wird hierbei auf die Umwandlung vn bisherigen in neue Frmate, swie das Erstellen und Prüfen vn SEPA-Dateien, gelegt. Die windata SEPA-API stellt diese Lösung dar. Sie ist eine mdulare.net- Entwicklungsbiblithek, welche in bereits existierende der neue Sftwarekmpnenten integriert werden kann. Durch die Einbindung der gewählten SEPA-API-Kmpnenten kann dafür Srge getragen werden, dass vrhandene Sftware mit dem neuen SEPA-Frmat umgehen kann. Die SEPA-API besteht aus verschiedenen.net 4.0-DLLs und kann mit den Entwicklungsumgebungen Micrsft Visual Studi 2010 der höher, genutzt werden. Cpyright windata GmbH & C. KG Seite 3 vn 9
windata SEPA-API Basic / Pr - Dkumentatin 2 Ausführungen Die windata SEPA-API ist in zwei Ausführungen verfügbar, welche sich jeweils an unterschiedliche Anfrderungen richtet. Diese sind nachflgend aufgeführt: 2.1 SEPA-API Basic Diese Ausführung bietet die Möglichkeit, u.a. flgende bankunterstützende Funktinen aufzurufen und Infrmatinen abzufragen: IBAN berechnen Berechnet die IBAN aus einer deutschen Kntnummer und Bankleitzahl gem. ISO 7064 und den IBAN-Regeln der Deutschen Bundesbank. BIC ermitteln Durch Übergabe einer deutschen Bankleitzahl wird der dazugehörige BIC ermittelt. Kntnummer prüfen Validiert eine deutsche Kntnummer anhand einer Bankleitzahl. IBAN prüfen Überprüft eine IBAN anhand der ISO 7064 und den IBAN-Regeln der Deutschen Bundesbank. Bankname ermitteln Anhand einer deutschen Bankleitzahl der dem BIC eines deutschen Kreditinstituts kann der Name der Bank/Sparkasse ermittelt werden. Cpyright windata GmbH & C. KG Seite 4 vn 9
windata SEPA-API Basic / Pr - Dkumentatin 2.2 SEPA-API Pr Diese Ausführung stellt sämtliche Funktinen der SEPA-API Basic bereit und bietet zusätzlich flgende Mdule: SEPA Knverter Knvertiert DTAUS0- (natinales Zahlungsverkehrsfrmat) und windata CSV-1.1 Dateien in SEPA XML Einzel- und Cntainerdateien. Unterstützt die autmatische Umwandlung vn Kntnummern und Bankleitzahlen in IBAN und BIC. Ermöglicht die Umwandlung vn DTAUS0-Lastschriften mittels hinzugefügter Steuerdateien, um eine einfache und massentaugliche Knvertierung durchführen zu können Erkennt und filtert autmatisch fehlerhafte Datensätze aus und stellt ein Lg-Objekt zur Verfügung, welches nähere Details zu aussrtierten Instanzen enthält. SEPA Checker Überprüft SEPA-Dateien und Cntainer auf semantische und inhaltliche Fehler und gliedert diese in Warnungen und Fehler. Stellt detaillierte Fehlermeldungen, wie den XPath eines fehlerhaften Kntens der den beanstandeten Wert, bereit. Unterstützt sämtliche pain-versinen, welche vm ZK-Institut freigegeben sind (Stand: 2014) Cpyright windata GmbH & C. KG Seite 5 vn 9
windata SEPA-API Basic / Pr - Dkumentatin SEPA Dcument Pl Erzeugt laufzeitbasierte SEPA-Objekte aller pain-versinen, welche bearbeitet und in physikalische SEPA-Dateien geschrieben werden können. Stellt zudem eine Abstraktinsklassensammlungen bereit, welche sämtliche erweiterte SEPA-XML Knten ausblendet und smit einen vereinfachten Zugang zur Erstellung vn SEPA-Dkumenten in der Versin v2.6 ermöglicht. Ein technisches Hintergrundwissen zur Spezifikatin und den Aufbau vn SEPA-Dkumenten ist smit nicht erfrderlich. Cpyright windata GmbH & C. KG Seite 6 vn 9
windata SEPA-API Basic / Pr - Dkumentatin 3 Einbindung Alle Assemblies sind.net 4.0-kmpatibel und erlauben smit die Einbindung in Visual Studi 2010 der höher. Die Libraries sind mdular aufgebaut und können je nach Anfrderungsziel entsprechend eingebunden werden. Die nachflgende Grafik listet alle Kmpnenten der SEPA-API Pr auf: Um eine Kmpnente einzubinden, ist es eventuell erfrderlich, deren zusätzliche Abhängigkeiten als Referenzen einzubinden. Bei Fehlen einer abhängigen Assembly können unerwünschte Nebenwirkungen, wie unbehandelte Exceptins aufgrund nicht gefundener Biblitheken, auftreten. Cpyright windata GmbH & C. KG Seite 7 vn 9
windata SEPA-API Basic / Pr - Dkumentatin 4 Hinweise zu den Kmpnenten 4.1 Financial Institutin Supprt Library (wdfispt.dll) Klassenbeschreibung: "wdfispt.chm" Als Datenbasis für die Abfragefunktinen dient die aktuelle Datenbank "BLZ.mdb", welche im Knstruktr als Dateipfad übergeben wird. 4.2 SEPA Cnverter (wdsepacnv.dll) Klassenbeschreibung: "wdsepacnv.chm" Schnellstart: "wdsepacnv_readme.pdf" Die Library benötigt das Verzeichnis "ext", welches im API Pr-Paket mitgeliefert wird. Dieses Verzeichnis muss im selben Verzeichnis wie die Cnverter-DLL liegen und darf nicht verschben, gelöscht der umbenannt werden. Eine Umbenennung der untergerdneten Dateien ist ebenfalls unzulässig. Das ext-verzeichnis ermöglicht es, Lastschrift-Infrmatinen für DTAUS-Dateien zu hinterlegen. Weitere Infrmatinen hierzu finden sich unter flgender URL: http://www.windata.de/pdf/dtaus0_lastschriften.pdf Cpyright windata GmbH & C. KG Seite 8 vn 9
windata SEPA-API Basic / Pr - Dkumentatin 4.3 SEPA Checker (wdsepachk.dll) Klassenbeschreibung: "wdsepachk.chm" 4.4 SEPA Dcument Pl (wdsepadcpl.dll) Klassenbeschreibung: "wdsepadcpl.chm" Dkumentatin zu den Abstractin Classes: "wdsepadcpl_readme.pdf" Diese Library benötigt keine zusätzliche Knfiguratin. Cpyright windata GmbH & C. KG Seite 9 vn 9