FinTS auf der Kommandozeile

 
Benutzer
Avatar
Geschlecht: keine Angabe
Herkunft: München
Homepage: subsembly.com/
Beiträge: 4446
Dabei seit: 11 / 2004
Betreff:

FinTS auf der Kommandozeile

 · 
Gepostet: 27.09.2006 - 16:44 Uhr  ·  #1
Hallo allerseits,

ich arbeite zur Zeit an einem Programm mit dem man verschiedene FinTS Zahlungsverkehrsaufgaben direkt auf der Kommandozeile ausführen kann. Neben der manuellen Nutzung ist vor allem die automatisierte Nutzung aus Batch-Dateien und Skripts interessant. Eine erste Version hätte ich fertig und suche nun ein paar freiwillige die das mal ausprobieren wollen.

Damit Ihr seht was ich genau meine und was das Tool kann, hier die kurze Dokumentation dazu:

Zitat

Subsembly FinTS Tools: Command Line Utility
Copyright © 2006 Subsembly GmbH

Das Subsembly FinTS Command Line Utility basiert auf der Subsembly
FinTS API und unterstützt HBCI 2.0.1, HBCI 2.1, HBCI 2.2 und FinTS 3.0.
Als Sicherheitsverfahren werden unterstützt: DDV mit Chipkarte, RDH
mit Schlüsseldatei oder Chipkarte, und PIN/TAN. Folgende Chipkarten
werden unterstützt: Giesecke + Devrient STARCOS HBCI, VR-NetWorld V1,
VR-Networld V2 (SECCOS), DDV Typ 0 und Typ 1. Folgende
Schlüsseldateiformate werden unterstützt: DDBAC .RDH (Quicken, WISO
Mein Geld, ...), SIZ .KEY (StarMoney). Folgende TAN-Verfahren werden
unterstützt: klassisch, iTAN Prozessvariante 1 und Prozessvariante 2.

Verwendung: FinCmd <action> -<argname> <argvalue> ...

Folgende Werte für <action> sind möglich (Eine genaue Beschreibung
der möglichen Aktionen finden Sie weiter unten):

balance Abfrage des aktuellen Kontostands
statement Kontoumsatzdaten herunterladen
remitt Einzelüberweisung ausführen
debit Einzellastschrift ausführen
dtaus DTAUS-Datei einreichen
xml Auftrag im FinTS 4.0 XML-Format

Für jede Aktion muss durch die Parameter eine Bankverbindung bestehend
aus einem Bankkontakt und einem Bankkonto spezifiziert werden.
Zusätzlich gibt es weitere Parameter für die verschiedenen Aktionen.

Der Bankkontakt muss auf eine der folgenden Arten angegeben werden:
a) Parameter -contactfile mit dem Dateinamen des gespeicherten
Bankkontakts; b) Parameter -contactname mit dem Namen des Bankkontakts;
oder c) die kompletten PIN/TAN Zugangsdaten (Eine genaue Beschreibung
der Parameter finden Sie weiter unten):

a) Gespeicherter Bankkontakt

Die Datei mit den Daten des Bankkontakts kann mit dem Subsembly FinTS
Admin angelegt und dort exportiert werden.

-contactfile * Dateiname des Bankkontakts
-pin * PIN oder Passwort des Bankkontakts

b) Benannter Bankkontakt aus dem FinTS Admin

Der Bankkontakt muss unter diesem Namen vorher im Subsembly FinTS
Admin angelegt worden sein.

-contactname * Name des Bankkontakts
-pin * PIN oder Passwort des Bankkontakts

c) Komplette PIN/TAN Zugangsdaten

-commaddress * Komplette URL des Bankservers
-fintsversion Zu verwendende FinTS Version
-tanprocedure Zu verwendendes TAN-Verfahren
-bankcode * Bankleitzahl des Bankkontakts
-userid * HBCI Benutzerkennung des Bankkontakts
-pin * PIN oder Passwort des Bankkontakts

Das Bankkonto der gewünschten Bankverbindung muss durch folgende
Parameter festgelegt werden (Eine genaue Beschreibung der Parameter
finden Sie weiter unten):

-acctbankcode Bankleitzahl der Bankverbindung
-acctno * Kontonummer der Bankverbindung
-acctcurrency Kontowährung der Bankverbindung

Folgende Parameter sind für die Aktion "statement" möglich (Eine genaue
Beschreibung der Parameter finden Sie weiter unten):

-fromdate Startdatum für Kontoumsatzdaten
-format Legt das Format der Ausgabe fest

Folgende Parameter sind für die Aktionen "remitt" und "debit" möglich
(Eine genaue Beschreibung der Parameter finden Sie weiter unten):

-payeename * Name des Empfängers/Zahlungspflichtigen
-payeeacctno * Konto des Empfängers/Zahlungspflichtigen
-payeebankcode * BLZ des Empfängers/Zahlungspflichtigen
-amount * Betrag im Format 0000,00
-textkey Textschlüssel
-textkeyext Textschlüsselergänzung
-purpose * Verwendungszweck
-tan TAN für den Auftrag

Folgende Parameter sind für die Aktion "dtaus" möglich (Eine genaue
Beschreibung der Parameter finden Sie weiter unten):

-dtausfile * Dateiname der DTAUS-Datei
-tan TAN für den Auftrag

Folgende Parameter sind für die Aktion "xml" möglich (Eine genaue
Beschreibung der Parameter finden Sie weiter unten):

-xmlfile * Dateiname der XML-Datei
-tan TAN für den Auftrag

Die mit * markierten Parameter müssen jeweils angegeben werden. Alle
anderen Parameter sind optional.


Beschreibung der Aktionen


balance
Der aktuelle Kontostand der Bankverbindung wird abgefragt und im
CSV-Format ausgegeben.

statement
Die Umsatzdaten der Bankverbindung werden abgerufen und im gewählten
Format ausgegeben. Das Anfangsdatum kann über den Parameter -fromdate
eingestellt werden, das Format über den Parameter -format.

remitt
Eine Einzelüberweisung wird ausgeführt. Bei Verwendung des PIN/TAN-
Verfahrens muss eine TAN angegeben werden.

debit
Eine Einzellastschrift wird ausgeführt. Bei Verwendung des PIN/TAN-
Verfahrens muss eine TAN angegeben werden.

dtaus
Eine DTAUS-Datei mit Überweisungen oder Lastschriften wird
eingereicht. Bei Verwendung des PIN/TAN-Verfahrens muss eine TAN
angegeben werden.

xml
Eine Datei mit einem Auftrag im FinTS 4.0 XML-Format wird eingereicht.
FinCmd konvertiert die XML-Daten in das für die jeweilige HBCI-Version
(2.0.1, 2.1, 2.2, 3.0) erforderliche Format. Als Element-Tag für den
Auftrag werden folgende Tags unterstützt:

SingRemitt
SingRemitt_2_Req
SingRemitt_3_Req
SingRemitt_4_Req
SingRemitt_5_Req

SingDirDeb
SingDirDeb_2_Req
SingDirDeb_3_Req
SingDirDeb_4_Req
SingDirDeb_5_Req

Reclassification
Reclassification_1_Req
Reclassification_2_Req

SubmitPostdatedSingRemitt
SubmitPostdatedSingRemitt_2_Req
SubmitPostdatedSingRemitt_3_Req
SubmitPostdatedSingRemitt_4_Req

OutstandingPostdatedSingRemitt
OutstandingPostdatedSingRemitt_1_Req
OutstandingPostdatedSingRemitt_2_Req
OutstandingPostdatedSingRemitt_3_Req

CancelPostdatedSingRemitt
CancelPostdatedSingRemitt_1_Req
CancelPostdatedSingRemitt_2_Req
CancelPostdatedSingRemitt_3_Req

AcctBal
AcctBal_3_Req
AcctBal_4_Req
AcctBal_5_Req
AcctBal_6_Req

AcctMvmtsSpecifiedPeriod
AcctMvmtsSpecifiedPeriod_3_Req
AcctMvmtsSpecifiedPeriod_4_Req
AcctMvmtsSpecifiedPeriod_5_Req
AcctMvmtsSpecifiedPeriod_6_Req

SetupStandingOrder
SetupStandingOrder_2_Req
SetupStandingOrder_3_Req
SetupStandingOrder_4_Req
SetupStandingOrder_5_Req

AllStandingOrders
AllStandingOrders_1_Req
AllStandingOrders_2_Req
AllStandingOrders_3_Req
AllStandingOrders_4_Req

CancelStandingOrder
CancelStandingOrder_1_Req
CancelStandingOrder_2_Req
CancelStandingOrder_3_Req
CancelStandingOrder_4_Req

ModifyStandingOrder
ModifyStandingOrder_2_Req
ModifyStandingOrder_3_Req
ModifyStandingOrder_4_Req
ModifyStandingOrder_5_Req

Bei XML-Tags mit Versionsnummer wird ein Segment mit genau dieser Version
erzeugt. Bei einem generischen Tag, wird von FinCmd die bestmögliche
Segmentversion automatisch gewählt. Den erforderlichen Aufbau der XML-Daten
können Sie der FinTS 4.0 Spezifikation entnehmen.

Das obligatorische FinTS 4.0 Element <OrderingCustAcct> kann im
Auftrags-XML entfallen. FinCmd setzt an dieser Stelle in jedem Fall das
Konto der gewählten Bankverbindung ein.

Die Antwortdaten werden ebenfalls in das FinTS 4.0 XML-Format
konvertiert und auf der Konsole ausgegeben.


Beschreibung der Parameter


-contactfile
Vollständiger Pfad und Dateiname der XML-Datei mit dem
gespeicherten Bankkontakt. Diese Datei kann mit dem Subsembly FinTS
Admin erzeugt und exportiert werden.

-contactname
Name des mit dem Subsembly FinTS Admin angelegten Bankkontakts.
Bitte beachten Sie, dass der FinTS Admin die Bankkontakte jeweils
für den angemeldeten Benutzer separat verwaltet.

-pin
Je nach Art des Bankkontakts entweder die Online-PIN, die
Chipkarten-PIN oder das Passwort der Schlüsseldatei. Dieser
Parameter muss übergeben werden. Eine PIN kann beinahe beliebig,
also auch ein alfanumerischer String sein. Eine leere PIN ist nicht
möglich.

-commaddress
Die komplette HTTP-Adresse des HBCI/FinTS-Bankservers
einschließlich "https:", z.B.
"https://hbci11.fiducia.de/cgi-bin/hbciservlet". Die korrekte
Adresse erfahren Sie bei Ihrem Kreditinstitut.

-fintsversion
Version des zu verwendenden FinTS Protokolls. Für HBCI 2.0.1 muss
201 angegeben werden, für HBCI 2.1 210, für HBCI 2.2 220 und für
FinTS 3.0 300. Der Standardwert ist 300 für FinTS 3.0.

-tanprocedure
Optional das zu verwendende TAN-Verfahren. Dieser Parameter kann
weggelassen werden, wenn das klassische TAN-Verfahren verwendet werden
soll. Für das iTAN-Verfahren muss hier die technische Identifikation
des Verfahrens, meist einfach "iTAN", übergeben werden. Weitere
Beispiele sind "mtan1" bis "mtan4" für das Mobile-TAN-Verfahren der
Postbank, oder "CR01" für das iTAN-Verfahren bei der
HypoVereinsbank.

-bankcode
Die Bankleitzahl des Kreditinstituts. Diese muss aus genau acht
Ziffern bestehen.

-userid
Die HBCI/FinTS-Benutzerkennung der Person die mit der Bank in Kontakt
treten möchte. Je nach Kreditsintitut kann dies auch die Girokontonummer
oder ein anderes Identifizierungsmerkmal, wie z.B. der VR-NetKey, sein.
Dieser Parameter muss übergeben werden.

-acctbankcode
Die Bankleitzahl des Kontos der gewünschten Bankverbindung. Dieser
Parameter kann angegeben werden, wenn die Bankleitzahl der
Bankverbindung von der Bankleitzahl des Bankkontakts abweicht. Dies
ist bei einigen Banken möglich. Standardmäßig wird die Bankleitzahl
des Bankkontakts verwendet.

-acctno
Die Kontonummer des Kontos der gewünschten Bankverbindung. Darf
führende Nullen enthalten und darf bis zu 30 Zeichen lang sein.
Beim internen Kontonummernvergleich werden führende Nullen generell
ignoriert.

-acctcurrency
ISO-Währungscode der Währung des Kontos der gewünschten
Bankverbindung. Dieser Parameter ist erforderlich, weil bei einigen
Banken verschiedene Währungskonten unter der gleichen Kontonummer
geführt werden. Der Standardwert für diesen Parameter ist "EUR" für
Euro.

-fromdate
Wird als Aktion ein Download der Kontoumsatzdaten gewünscht, dann
kann über diesen Parameter das Anfangsdatum der Abfrage übergeben
werden. Das Datum muss im Format JJJJ-MM-TT angegeben werden. Wird
kein Datum angegeben, so werden alle vorhandenen Umsatzdaten
abgerufen.

-format
Legt das Ausgabeformat der Umsatzdaten fest. Möglich sind folgende
Angaben:
csv - Daten werden im CSV-Format ausgegeben
mt940 - Es werden die original MT-940-Daten ausgegeben
mt942 - Es werden die original MT-942-Daten ausgegeben
Standardmäßig werden die Daten im CSV-Format ausgegeben.

-payeename
Der Name des Überweisungsempfängers bzw. des Zahlungspflichtigen
bei einer Lastschrift. Maximal 27 Zeichen. Werden vor der
Übertragung automatisch in Großbuchstaben gewandelt.

-payeeacctno
Kontonummer des Überweisungsempfängers bzw. des Zahlungspflichtigen
bei einer Lastschrift.

-payeebankcode
Bankleitzahl des Überweisungsempfängers bzw. des Zahlungspflichtigen
bei einer Lastschrift.

-amount
Betrag der Überwiesen bzw. per Lastschrift eingezogen werden soll.
Dieser muss im Format 100000,00 angegeben werden.

-textkey
Textschlüssel der für die Überweisung bzw. Lastschrift verwendet
werden soll. Standardwert ist "51" für Überweisungen und "05" für
Lastschriften.

-textkeyext
Textschlüsselergänzung die für die Überweisung bzw. Lastschrift
verwendet werden soll. Standardwert ist "000".

-purpose
Verwendungszweck für Überweisung bzw. Lastschrift. Es dürfen
maximal zwei mit "|" getrennte Zeilen mit jeweils maximal 27
Zeichen angegeben werden. Umlaute sollten möglichst vermieden
werden. Der Text wird vor der Übertragung automatisch in
Großbuchstaben gewandelt.

-tan
Bei Verwendung des PIN/TAN-Verfahrens muss für TAN-pflichtige
Aufträge eine TAN angegeben werden. TAN-pflichtige Aufträge können
prinzipbedingt nur bei Verwendung des klassischen TAN-Verfahrens
gesendet werden. Bei Verwendung des iTAN-Verfahrens ist eine
Benutzerinteraktion erforderlich.

-dtausfile
Dateiname der DTAUS-Datei die eingereicht werden soll. Sind in
dieser Datei Überweisungen enthalten, wird die Datei per
HKSUB-Segment eingereicht. Sind Lastschriften enthalten, wird die
Datei per HKSLA-Segment eingereicht.

-xmlfile
Dateiname des XML-Dokuments mit dem einzurichenden Auftrag. Das
XML-Dokument muss einen Einzelauftrag entsprechend der FinTS 4.0
Spezifikation enthalten (siehe auch weiter oben).


Über jede Art von Kommentar würde ich mich freuen.
Neuling
Avatar
Geschlecht: keine Angabe
Beiträge: 1
Dabei seit: 11 / 2006
Betreff:

Re: FinTS auf der Kommandozeile

 · 
Gepostet: 13.11.2006 - 12:07 Uhr  ·  #2
Ich würde das Tool gerne testen.
Zu welchem Preis wird das Programm später angeboten?
Benutzer
Avatar
Geschlecht: keine Angabe
Herkunft: München
Homepage: subsembly.com/
Beiträge: 4446
Dabei seit: 11 / 2004
Betreff:

Re: FinTS auf der Kommandozeile

 · 
Gepostet: 13.11.2006 - 15:13 Uhr  ·  #3
Hallo,

voraussichtlich wird es ein Teil der Subsembly FinTS Tools 4.0, die in den nächsten Tagen veröffentlich werden.

Die private Nutzung und die reine Evaluierung wird kostenlos sein. Für die kommerzielle Nutzung der FinTS Tools muss eine Lizenz erworben werden. Der Preis dafür steht aber noch nicht fest.

Wenn Du mir eine E-Mail an support@subsembly.com schickst, dann bekommst Du von mir eine Vorabversion.
Benutzer
Avatar
Geschlecht: keine Angabe
Beiträge: 1083
Dabei seit: 10 / 2003
Betreff:

Re: FinTS auf der Kommandozeile

 · 
Gepostet: 14.11.2006 - 09:39 Uhr  ·  #4
Wenn das ganze auch über Windows-PC läuft dann würd' ich das auch gerne mal testen!

Mail geht raus!

Hylli
Gewählte Zitate für Mehrfachzitierung:   0