Aktionen

Funktionen und Verwendung von windata black box

Aus windata WIKI

Version vom 9. Juli 2012, 15:59 Uhr von StefanBalk (Diskussion | Beiträge) (→‎Datensatzbeschreibung)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

Einführung

Die windata black box bietet Entwicklern die Möglichkeit, leistungsfähige und sichere Banking-Funktionen in eigene Programme zu integrieren. Es stehen dabei verschiedene Kommunikations- und Legitimationsverfahren zur Verfügung:

  • HBCI/FinTS mit Chipkarte
  • HBCI/FinTS mit Schlüsseldatei
  • HBCI/FinTS mit PIN/TAN
  • HBCI/FinTS mit 2-Schritt-TAN-Verfahren
  • EBICS

Zusätzlich besteht die Möglichkeit Transaktionsdaten eines Paypal-Accounts abzurufen. Dabei werden alle Transaktionen mit den zugehörigen Detailsdaten bereitgestellt.
Zahlungsdaten müssen in einem der folgenden Formate vorliegen:

  • DTAUS (belegloser Datenträgeraustausch, Inlandszahlungen)
  • DTAZV (belegloser Datenträgeraustausch, Auslandszahlungen)
  • SEPA-Überweisungen (SEPA-XML)
  • SEPA-Basis-Lastschriften (SEPA-XML)
  • SEPA-Firmen-Lastschriften (SEPA-XML)
  • SEPA-Überweisungen (SEPA, CSV)
  • SEPA-Basis-Lastschriften (SEPA, CSV)
  • SEPA-Firmen-Lastschriften (SEPA, CSV)

Die zu übertragende Datei muss sich im definierten Ordner (Optionen) befinden.

WdbbOptionen.png

Parameter für den Programmaufruf

Das Programm wird durch sog. Übergabeparameter gesteuert. Beim Aufruf des ausführbaren Programms (wd8bb.exe) werden die Übergabeparameter wie folgt angegeben:
Wd8bb.exe /Übergabeparamater1/Übergabeparamater2 etc.
Die Reihenfolge der Übergabeparameter ist beliebig, d.h. die einzelen Übergabeparameter können an beliebiger Stelle angegeben werden.
Nachfolgend werden die zulässigen Übergabeparameter erläutert.

HBCI/FinTS

Abruf von Kontoumsätzen mit Benutzerführung

wd8bb.exe /Abruf/HBCI

Abruf von Kontoumsätzen mit hinterlegter PIN (bei PIN/TAN-Verfahren bzw. Schlüsseldatei) im sog. silent mode

wd8bb.exe /Abruf/HBCI/Automatik

Zahlungen senden mit Benutzerführung

wd8bb.exe /Senden/HBCI

Zahlungen senden mit hinterlegter PIN (bei PIN/TAN-Verfahren bzw. Schlüsseldatei) im sog. silent mode

wd8bb.exe /Senden/HBCI/Automatik

EBICS

Abruf von Kontoumsätzen mit Benutzerführung

wd8bb.exe /Abruf/Benutzer: <Benutzer>

Wenn der Benutzername nicht mit übergeben wird, wird immer das Dialogfenster zur Auswahl eines Benutzers eingeblendet.
Abruf von Kontoumsätzen mit hinterlegtem Passwort im sog. silent mode

wd8bb.exe /Abruf/Automatik/Benutzer:<Benutzer>

Abruf von Vormerkposten mit Benutzerführung

wd8bb.exe /Abruf/VMP/Benutzer:<Benutzer>

Wenn der Benutzername nicht mit übergeben wird, wird immer das Dialogfenster zur Auswahl eines Benutzers eingeblendet.
Abruf von Vormerkposten mit hinterlegtem Passwort im sog. silent mode

wd8bb.exe /Abruf/VMP/Automatik/Benutzer:<Benutzer>

Zahlungen senden mit Benutzerführung

wd8bb.exe /Senden/Benutzer:<Benutzer>

Wenn der Benutzername nicht mit übergeben wird, wird immer das Dialogfenster zur Auswahl eines Benutzers eingeblendet.
Zahlungen senden mit hinterlegtem Passwort im sog. silent mode

wd8bb.exe /Senden/Automatik/Benutzer:<Benutzer>

Zahlungen mit verteilter, elektronischer Unterschrift (VEU) senden
Der Übergabeparameter wird um den Zusatz /VEU an beliebiger Stelle ergänzt.
Bsp.:

wd8bb.exe /Senden/VEU/Automatik/Benutzer:<Benutzer>
wd8bb.exe /VEU/Senden/Benutzer:<Benutzer>

Steuerdatei für den Abruf von Kontoumsätzen

Die Steuerdatei muss folgenden Dateiname und Dateikennung haben:
AbrufKonten.csv
Es handelt sich hierbei um eine Textdatei, bei de die einzelnen Daten mit Semikolon (;) getrennt werden. Jede Zeile entspricht einem Datensatz. Der Aufbau der Datei ist wie folgt:
Konto-Nr; BLZ; Währung
Bsp.:
1234567; 65050110; EUR
5697890; 65092010; USD
Die Angabe der Bankleitzahl ist optional. Sie ist nur dann zwingend anzugeben, wenn eine Kontonummer bei einem Kreditinstitut für mehrere Konten mit unterschiedlicher Währung verwendet wird.
Bsp.: Eine Kontonummer wird sowohl für ein EUR- als auch für ein USD-Konto genutzt.
123456789; 65070024; EUR
123456789; 65070024; USD

Das Währungskennzeichen ist ebenfalls optional und muss nur angegeben werden, wenn die Kontowährung nicht EUR lautet. Ist das Währungskennzeichen nicht angegeben, wird die Standardwährung Euro genutzt. Abweichende Währungskennzeichen sind gem. ISO 4217 (s. Anhang) anzugeben.
Die Datei AbrufKonten.csv muss sich im selben Ordner wie die ausführbare Datei wd8bb.exe befinden.

Satzaufbau für SEPA, CSV-Dateien

Zum automatisierten Import von SEPA-Zahlungen im Format CSV (Textdatei, Felder durch Semikolon getrennt, einzelne Datensätze sind durch CR/LF zu trennen) ist nachfolgender Satzaufbau zu berücksichtigen.
Hinweis: CR/LF= Carriage Return + Line Feed
Die erste Zeile der CSV-Datei enthält die Kennzeichnung des Importformats und ist mit dem Wert windata CSV zu belegen. In der zweiten Zeile sind zwingend die Feldbezeichnungen wie nachfolgend dargestellt anzugeben und mit einem CR/LF abzuschließen:
AG Name; AG KontoNr; AG BLZ; Beg/Zahlpfl Name; Beg/Zahlpfl Name2; Beg/Zahlpfl Strasse; Beg/Zahlpfl Ort; Beg/Zahlpfl KontoNr bzw. IBAN; Beg/Zahlpfl BLZ bzw. BIC; Betrag; Währung; Textschlüssel bzw. Zahlart; Termin; VWZ1; VWZ2; VWZ3; VWZ4; VWZ5; VWZ6; VWZ7; VWZ8; VWZ9; VWZ10; VWZ11; VWZ12; VWZ13; VWZ14; Ref-ID; Mandat-ID; Mandat-Datum


Datensatzbeschreibung

Feldbezeichnung Inhalt Typ Länge
AG Name P Name des Auftraggebers Text 27
AG KontoNr P Kontonummer des Auftraggeberkontos numerisch 10
AG BLZ P Bankleitzahl des Auftraggeberinstituts numerisch 8
Beg/Zahlpfl Name P Name des Begünstigten (bei Überweisungen) bzw. Zahlungspflichtigen (bei Lastschriften) Text 27
Beg/Zahlpfl Name2 O Weitere Angaben zum Name des Begünstigten (bei Überweisungen) bzw. Zahlungspflichtigen (bei Lastschriften) Text 27
Beg/Zahlpfl Strasse O Straße des Begünstigten (bei Überweisungen) bzw. Zahlungspflichtigen (bei Lastschriften) Text 27
Beg/Zahlpfl Ort O Ort des Begünstigten (bei Überweisungen) bzw. Zahlungspflichtigen (bei Lastschriften) Text 27
Beg/Zahlpfl KontoNr bzw. IBAN P IBAN des Begünstigten (bei Überweisungen) bzw. Zahlungspflichtigen (bei Lastschriften) Text 35
Beg/Zahlpfl BLZ bzw. BIC P BIC des Begünstigten (bei Überweisungen) bzw. Zahlungspflichtigen (bei Lastschriften) Text 11
Betrag P Betrag im Format XXXX,XX Beträge ohne Nachkommastellen werden mit ,00 beim Import ergänzt numerisch, Komma als Trennzeichen für Nachkommastellen 12
Währung O EUR Text 3
Textschlüssel bzw. Zahlart P SEPA: für SEPA-Überweisungen (Angabe der Währung entfällt, immer EUR)

BASIS: für SEPA-Basis-Lastschriften (Angabe der Währung entfällt, immer EUR) FIRMEN: für SEPA-Firmenlastschriften (Angabe der Währung entfällt, immer EUR)

Text 6
Termin O Fälligkeits- bzw. Ausführungstermin Datum TT.MM.JJJJ 10
VWZ1 O Verwendungszweck Text 27
VWZ2 O Verwendungszweck Text 27
VWZ3 O Verwendungszweck Text 27
VWZ4 O Verwendungszweck Text 27
VWZ5 O Verwendungszweck Text 27
VWZ6 O Verwendungszweck Text 27
VWZ7 O Verwendungszweck Text 27
VWZ8 O Verwendungszweck Text 27
VWZ9 O Verwendungszweck Text 27
VWZ10 O Verwendungszweck Text 27
VWZ11 O Verwendungszweck Text 27
VWZ12 O Verwendungszweck Text 27
VWZ13 O Verwendungszweck Text 27
VWZ14 O Verwendungszweck Text 27
Ref-ID SL Referenznummer Text 35
Mandat-ID SL Lastschriftmandat Text 35
Mandat-Datum SL Datum des Lastschriftmandats (Ausstellungsdatum) Datum TT.MM.JJJJ 10


Hinweise:
P=Pflichtangabe - O=optional – SL=Pflichtangabe bei allen Formen der SEPA-Lastschriften
Die CSV-Datei kann Zahlungen verschiedener Zahlungsarten enthalten.
Leere Zeilen sind zulässig. Jede Zeile muss mit einem CR/LF abgeschlossen werden.

Satzaufbau für Kontoumästze im CSV-Format

Im Anschluß an den Abruf von Kontoumsätzen über die windata black box werden immer zwei Dateien erzeugt:

  • AbrufStatus.txt
Diese Datei beinhaltet Details zum Abruf der Kontoumsätze.
  • Datei mit Kontoumsätzen
Diese Datei beinhaltet alle Kontoumsätze des jeweiligen Zeitraums.

Datensatzbeschreibung der AbrufStatus.txt

Datum; Konto-Nr.; BLZ; Bank; Abruf; Information

Zum automatisierten Export von Kontoumsätze im Format CSV (Textdatei, Felder durch Semikolon getrennt) ist nachfolgender Satzaufbau zu berücksichtigen:

Datensatzbeschreibung der Kontoauszug.csv

Konto-Währung; IBAN Auftraggeber; Konto-Nr. Auftraggeber; BIC Auftraggeber; BLZ Auftraggeber; Buchungstag; Valuta; Betrag; Währung; Sall/Haben (CRDT/DBIT); Ende-zu-Ende-Ref; Kundenreferenz; Mandats-ID; Gläubiger/Creditor-ID, VWZ1; VWZ2; VWZ3; VWZ4; VWZ5; VWZ6; VWZ7; VWZ8; VWZ9; VWZ10; VWZ11; VWZ12; VWZ13; VWZ14; Buchungstext; Primanota; Geschäftsvorfallcode, Name; IBAN; Konto-Nr.; BIC; BLZ; Auszugs-Nr.; AnfangsSaldo; Soll/Haben (CRDT/DBIT); Endsaldo; Soll/Haben (CRDT/DBIT); Textschlüssel; Textschlüsselergänzung

Downloads

Die vollständige Beschreibung der windata black box kann hier als PDF-Datei geöffnet werden: Funktionen und Verwendung von windata black box
windata black box steht allen Interessenten zum Download zur Verfügung: windata black box

Abgerufen von „https://wiki.windata.de/index.php?title=Funktionen_und_Verwendung_von_windata_black_box&oldid=663“