• Home
• de.adorsys
• hbci4j-adorsys
• 3.5.25
• source code
• package.html

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

org.kapott.hbci.GV.package.html Maven / Gradle / Ivy

Dieses Package enthält alle Klassen zur internen Repräsentation von
    (Highlevel-)Jobs. Die einzige Klasse, die als Schnittstelle zu HBCI-Jobs
    innerhalb einer Anwendung benötigt wird, ist die Klasse
    HBCIJob.

Beim Festlegen von auszuführenden Jobs werden Highlevel-Jobs
    und Lowlevel-Jobs unterschieden. Diese Unterscheidung hat nichts
    mit der Art der Jobs an sich zu tun, sondern mit der Art und Weise, wie
    sie spezifiziert und parametrisiert werden können:

Alle von HBCI4Java unterstützten Jobs liegen in einer internen
    Beschreibungssprache vor (XML). Diese Sprache ist eng an die
    Beschreibung der Geschäftsvorfälle aus der HBCI-Spezifikation gekoppelt.
    In ihr ist jedem unterstützten Job ein Lowlevel-Jobname zugeordnet,
    der den Job eindeutig identifiziert. Zu jedem Job gibt es eine bestimmte Anzahl
    von Parametern, die zur Ausführung dieses Jobs benötigt werden (z.B. Kontoverbindungen,
    Geldbeträge, usw.). Jeder dieser Parameter hat dabei einen Lowlevel-Parameternamen.
    Dieser Lowlevel-Parametername stammt aus dem internen Beschreibungsformat des Jobs
    und ist teilweise sehr aufwändig zu schreiben (weil sehr lang) und schlecht zu merken
    (weil softwareorientiert).

Um die Arbeit mit häufig benutzten Jobs zu vereinfachen, wurden für die meisten
    Jobs Highlevel-Frontends entwickelt. Dabei handelt es sich HBCI4Java-intern
    um separate Klassen, die jeweils für bestimmte Lowlevel-Jobs zuständig sind. Die meisten
    Jobs können und sollten also über ihre Highlevel-Schnittstelle erzeugt und parametrisiert
    werden. Dazu gibt es für jeden Job, der durch die Highlevel-Schnittstelle unterstützt wird,
    einen Highlevel-Jobnamen. Außerdem gibt es für die benötigten Job-Parameter entsprechende
    Highlevel-Parameternamen. Diese sind zum einen kürzer als die Lowlevel-Parameternamen,
    außerdem sind sie intuitiver und leichter zu merken.

Beim Erzeugen von Jobs sollte also immer dem Highlevel-Interface der Vorzug gegeben werden,
    sofern es für den jeweiligen Job eine solche Schnittstelle gibt. Die Jobs, für die eine
    Highlevel-Schnittstelle existiert, sind unten aufgelistet. Prinzipiell kann natürlich jeder
    Job auch über die Lowlevel-Schnittstelle erzeugt und ausgewertet werden. Eine Liste aller
    Lowlevel-Jobs und deren Parameter erhält man mit den Tools
    ShowLowlevelGVs bzw.
    ShowLowlevelGVRs oder zur Laufzeit durch die
    Verwendung der Methoden getLowlevel* der
    HBCIHandler-Klasse. Da es zur
    Zeit nicht für alle Lowlevel-Jobs entsprechende Klassen für die Highlevel-Unterstützung
    gibt, sollten diese Methoden benutzt werden, um zu überprüfen, ob ein bestimmter
    Job gar nicht oder nur nicht per Highlevel-Interface unterstützt wird.

Folgende Unterschiede existieren also zwischen High- und Lowlevel-Jobs:


    

        

        
Highlevel-Interface
        
Lowlevel-Interface
    
    

        
Erzeugen des Jobs
        
HBCIHandler.newJob(HighlevelName)

            Eine Liste gültiger HighlevelNamen befindet sich in dieser Beschreibung weiter unten
        
        
HBCIHandler.newLowlevelJob(LowlevelName)

            Eine Liste gültiger LowlevelNamen erhält man zur Laufzeit durch
            HBCIHandler.getSupportedLowlevelGVs() bzw. offline mit dem Tool
            ShowLowlevelGVs.
        
    
    

        
Setzen von Parametern
        
HBCIJob.setParam(HLparamName,...)

            Gültige Werte für HLparamName finden sich in der Job-Beschreibung weiter unten.
            Es können auch komplexe Parameter gesetzt werden (siehe zum Beispiel
            HBCIJob.setParam(String,Konto)).
        
        
HBCIJob.setParam(LLparamName,value)

            Eine Liste gültiger LLparamNamen erhält man zur Laufzeit durch
            HBCIHandler.getLowlevelGVParameters() bzw. offline mit dem Tool
            ShowLowlevelGVs.
        
    
    

        
Ergebnisdaten (HBCIJob.getJobResult())
        
Klasse des zurückgegeben Objektes abhängig vom Job (siehe Beschreibung unten).
            Die Job-Rückgabedaten sind bereits anwendungsfreundlich aufbereitet
        
        
Klasse des zurückgegebenen Objektes ist immer HBCIJobResult. Darin
            enthalten sind die "puren" Datenelement-Daten, wie sie aus der HBCI-Antwortnachricht
            extrahiert wurden. Der Inhalt der einzelnen Datenelemte kann über bestimmte Namen
            ermittelt werden
            (HBCIHandler.getLowlevelResultProperties()
            bzw.
            ShowLowlevelGVRs).
        
    


Beschreibung der unterstützten Highlevel-Jobs


    Kundenmitteilung an die Bank

    Dauerauftrag einrichten

    Liste bestehender Daueraufträge abholen

    Bestehenden Dauerauftrag bearbeiten

    Bestehenden Dauerauftrag löschen

    Einzelüberweisung

    Umbuchung

    Einzelüberweisung mit prüfziffergesichertem Verwendungszweck (BZÜ)

    Eilüberweisung

    Spendenüberweisung

    Auslandsüberweisung

    SEPA-Einzelüberweisung

    Terminierte Einzelüberweisung

    Liste noch anstehender terminierten Überweisungen abholen

    Noch anstehende terminierte Überweisung verändern

    Noch anstehende terminierte Überweisung löschen

    Sammelüberweisung einreichen

    Sammellastschrift einreichen

    Einzellastschrift einreichen

    Lastschriftwiderruf

    Kontoumsätze anzeigen

    Neue Kontoumsätze anzeigen

    Saldoabfrage eines Kontos

    Saldenabfrage aller Kundenkonten

    Saldenabfrage eines SEPA-Kontos

    Festgeldkonditionen abholen

    Liste bestehender Festgeldanlagen abholen

    Liste aller bestehender Festgeldanlagen abholen

    Kontostammdaten abholen

    Karten-Informationen abholen

    Übersicht über Kreditinstitutsinformationen abholen

    Bestellen bzw. Abholen von Kreditinstitutsinformationen

    Statusinformationen zu Geschäftsvorfällen abholen

    Abholen von Informationen über TAN-Listen

    Ändern der PIN für HBCI-PIN/TAN




Kundenmitteilung an die Bank
Mit diesem Geschäftsvorfall kann ein Bankkunde eine Nachricht an seine Bank versenden.
    Der Inhalt dieser Nachricht hat keinen Auftragscharakter.

    

        
Highlevel-Name
        
CustomMsg
    
    

        
Highlevel-Parameter
    
    

        

        
msg
        
String
        
obligatorisch
        
die zu übermittelnde Nachricht
    
    

        

        
my
        
Konto
        
optional
        
Kontoverbindung des Bankkunden
    
    

        

        
curr
        
String
        
optional
        
Währung des Kundenkontos ("EUR")
    
    

        

        
betreff
        
String
        
optional
        
Betreff der Nachricht
    
    

        

        
recpt
        
String
        
optional
        
Empfänger der Nachricht (z.B. ein bestimmter Ansprechpartner)
    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult
        

    



Dauerauftrag einrichten
Mit diesem Geschäftsvorfall kann ein neuer Dauerauftrag eingerichtet werden.

    

        
Highlevel-Name
        
DauerNew
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
src
        
Konto
        
obligatorisch
        
das Konto, welches bei dem Dauerauftrag belastet wird (Kundenkonto)
    
    

        

        
dst
        
Konto
        
obligatorisch
        
das auf welches die Gutschrift erfolgt (fremdes Konto)
    
    

        

        
btg
        
Value
        
obligatorisch
        
Geldbetrag, der bei dem Dauerauftrag überwiesen wird.
    
    

        

        
name
        
String
        
obligatorisch
        
Name des Empfängers ("Begünstigter").
    
    

        

        
name2
        
String
        
optional
        
Fortsetzung Name des Empfängers ("Begünstigter").
    
    

        

        
firstdate
        
Date
        
obligatorisch
        
Datum der ersten Ausführung des Dauerauftrages.
    
    

        

        
lastdate
        
Date
        
optional
        
Datum der letzten Ausführung des Dauerauftrages.
    
    

        

        
timeunit
        
String
        
obligatorisch
        
Zeiteinheit für den Turnus-Wert. Entweder "M" für Monat oder "W" für Woche.
    
    

        

        
turnus
        
int
        
obligatorisch
        
Dieser Wert gibt an, aller wieviel "timeunit"s der Dauerauftrag ausgeführt werden soll.
    
    

        

        
execday
        
int
        
obligatorisch
        
Dieser Wert gibt bei timeunit=M den Tag des Monats (1-31) und bei timeunit=W den
            Wochentag (1-7) der Ausführung an. Gültige Werte sind den Job-Restriktionen zu entnehmen.
        
    
    

        

        
usage,
usage_2,
usage_3,...
        
String
        
optional
        
Verwendungszweckzeilen
    
    

        

        
key
        
String
        
optional
        
Textschlüssel für Art der Überweisung (default="52").
    
    

        
Rückgabedaten-Klasse
        
GVRDauerNew
        

    



Liste bestehender Daueraufträge abholen
Mit diesem Geschäftsvorfall kann eine Übersicht der bestehenden Daueraufträge abgeholt werden.

    

        
Highlevel-Name
        
DauerList
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
optional
        
das Kundenkonto, für welches der Dauerauftragsbestand abgeholt werden soll.
            Ist kein Konto angegeben, so wird das erste in den UPD aufgeführte Konto benutzt.
        
    
    

        

        
orderid
        
String
        
optional
        
Auftrags-Identifikationsnummer für einen bestimmten Auftrag, dessen Daten abgeholt werden sollen.
    
    

        
Rückgabedaten-Klasse
        
GVRDauerList
        

    



Bestehenden Dauerauftrag bearbeiten
Mit diesem Geschäftsvorfall kann ein bestehender Dauerauftrag verändert werden. Dazu muss
    die orderid des zu ändernden Auftrages bekannt sein. Zur Ermittlung und
    Verwendung von Order-IDs siehe entsprechenden Abschnitt in der Beschreibung zur
    Löschung terminierter Überweisungen.
    Es müssen nur die Job-Parameter angegeben werden, die tatsächlich verändert werden
    sollen, die Angabe aller anderen Job-Parameter ist optional.
Aus den Job-Restriktionen kann ermittelt werden, welche Parameter überhaupt
    geändert werden dürfen.

    

        
Highlevel-Name
        
DauerEdit
        

    
    

        
Highlevel-Parameter
        
sämtliche Parameter wie bei DauerNew, allerdings alle
            optional; außerdem:
        
        

    
    

        

        
orderid
        
String
        
obligatorisch
        
Auftrags-Identifikationsnummer für den zu bearbeitenden Auftrag
    
    

        

        
date
        
Date
        
optional
        
Datum, ab wann der Auftrag geändert werden soll
    
    

        
Rückgabedaten-Klasse
        
GVRDauerEdit
        

    



Bestehenden Dauerauftrag löschen
Mit diesem Geschäftsvorfall kann ein bestehender Dauerauftrag gelöscht werden.
    Für die Angabe, welcher Dauerauftrag gelöscht werden soll, gibt es prinzipiell
    zwei Möglichkeiten:

    
Wenn die Bank keine Order-IDs (Auftrags-Identifikationsnummern) unterstützt,
        dann müssen für die Identifikation des "richtigen" Dauerauftrages alle
        Dauerauftrags-Parameter angegeben werden, die auch beim Einrichten des
        Dauerauftrages verwendet wurden (siehe Dauerauftrag
            einrichten).
    
    
Unterstützt die Bank Order-IDs, gibt es wiederum zwei Möglichkeiten:
        

            
Es werden alle Parameter wie beim Erzeugen des Dauerauftrages und
                zusätzlich die Order-ID angegeben.
            
            
Es genügt die Angabe der Order-ID. Dazu muss allerdings vor dem Erzeugen
                des Jobs "Dauerauftrag löschen" die Liste der existierenden
                Daueraufträge abgeholt werden (siehe Liste
                    bestehender Daueraufträge abholen), damit HBCI4Java
                die verwendete Order-ID kennt und die restlichen Auftrags-Parameter
                "selbst ausfüllen" kann.
            
        
    
    Siehe dazu auch den entsprechenden Abschnitt in der Beschreibung zur
    Löschung terminierter Überweisungen



    

        
Highlevel-Name
        
DauerDel
        

    
    

        
Highlevel-Parameter
        
sämtliche Parameter wie bei DauerNew, allerdings alle
            optional; außerdem:
        
        

    
    

        

        
orderid
        
String
        
optional
        
Auftrags-Identifikationsnummer für den zu löschenden Auftrag
    
    

        

        
date
        
Date
        
optional
        
Datum, wann der Auftrag gelöscht werden soll
    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult
        

    



Einzelüberweisung
Mit diesem Geschäftsvorfall wird eine einzelne Überweisung in Auftrag gegeben.

    

        
Highlevel-Name
        
Ueb
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
src
        
Konto
        
obligatorisch
        
Belastungskonto des Kunden
    
    

        

        
dst
        
Konto
        
obligatorisch
        
Konto, auf dem der Betrag gutgeschrieben werden soll
    
    

        

        
btg
        
Value
        
obligatorisch
        
Geldbetrag, der überwiesen werden soll.
    
    

        

        
name
        
String
        
obligatorisch
        
Name des Empfängers ("Begünstigter").
    
    

        

        
name2
        
String
        
optional
        
Fortsetzung Name des Empfängers ("Begünstigter").
    
    

        

        
usage,
usage_2,
usage_3,...
        
String
        
optional
        
Verwendungszweckzeilen
    
    

        

        
key
        
String
        
optional
        
Textschlüssel für Transaktionsart (default="51").
    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult
        

    



Umbuchung
Eine Umbuchung entspricht im wesentlichen einer Überweisung, wird aber von einigen
    Kreditinstituten intern anders ausgeführt. Voraussetzung für das Verwenden von Umbuchungen
    anstelle von "normalen" Überweisungen ist, dass das Empfängerkonto bei der gleichen
    Bank wie das Auftraggeberkonto geführt wird und ebenfalls dem Auftraggeber gehört.
    Mit diesem Geschäftsvorfall kann also eine Überweisung zwischen zwei eigenen Konten
    bei der gleichen Bank durchgeführt werden.

    

        
Highlevel-Name
        
Umb
        

    
    

        
Highlevel-Parameter
        
wie bei Einzelüberweisung
        

    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult
        

    



Einzelüberweisung mit prüfziffergesichertem Verwendungszweck (BZÜ)
Mit diesem Geschäftsvorfall wird eine einzelne Überweisung in Auftrag gegeben. Dabei enthält die
    erste Zeile des Verwendungszweckes einen 13-stelligen String, wovon 12 Ziffern tatsächlich
    Nutzdaten sind, die 13.Ziffer ist eine Prüfziffer über die restlichen 12. Beim Anlegen eines
    solchen Geschäftsvorfalles wird automatisch überprüft, ob die 13-stellige Ziffernfolge
    konsistent ist.

    

        
Highlevel-Name
        
UebBZU
        

    
    

        
Highlevel-Parameter
        
wie bei Einzelüberweisung, aber ohne die erste Verwendungszweckzeile (usage),
            dafür:
        
        

    
    

        

        
bzudata
        
String
        
obligatorisch
        
13-stellige Zeichenkette (enthält Prüfziffer).
    
    

        

        
key
        
String
        
optional
        
Textschlüssel für Transaktionsart (default="67").
    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult
        

    



Eilüberweisung
Eine Eilüberweisung funktioniert analog einer "normalen" Überweisung,
    wird aber u.U. schneller bearbeitet (die genauen bankfachlichen Hintergründe
    sind hier nicht relevant).

    

        
Highlevel-Name
        
UebEil
        

    
    

        
Highlevel-Parameter
        
wie bei Einzelüberweisung
        

    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult
        

    



Spendenüberweisung
Dabei handelt es sich im Prinzip um eine normale Einzelüberweisung. Einziger Unterschied
    ist ein bankintern anders gesetzter Textschlüssel für den Überweisungstyp. Wo dieser
    Textschlüssel konkret ausgewertet wird, weiß ich leider auch nicht.

    

        
Highlevel-Name
        
Donation
        

    
    

        
Highlevel-Parameter
        
wie bei Einzelüberweisung, allerdings ohne die
            Verwendungszweckzeilen; statt dessen:
        
        

    
    

        

        
spenderid
        
String
        
obligatorisch
        
Name des Spenders oder Kunden-/Mitgliedsnummer
    
    

        

        
plz_street
        
String
        
obligatorisch
        
PLZ und Straße des Spenders
    
    

        

        
name_ort
        
String
        
obligatorisch
        
Name und Ort des Einzahlers
    
    

        

        
key
        
String
        
optional
        
Textschlüssel für Transaktionsart (default="69").
    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult
        

    



Auslandsüberweisung
Mit diesem Geschäftsvorfall kann eine einfache Auslandsüberweisung in Auftrag gegeben werden.
    Darunter fallen alle Überweisungen in die meisten europäischen Länder, bei denen der
    zu überweisende Geldbetrag die gesetzliche Meldepflicht (zur Zeit 12500 EUR) nicht übersteigt.

    

        
Highlevel-Name
        
UebForeign
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
src
        
Konto
        
obligatorisch
        
Belastungskonto des Kunden
    
    

        

        
src.name
        
String
        
obligatorisch
        
Name des Auftraggebers
    
    

        

        
dst
        
Konto
        
optional
        
Konto, auf dem der Betrag gutgeschrieben werden soll.
            Es ist entweder dieser Parameter oder die IBAN anzugeben.
        
    
    

        

        
dst.iban
        
String
        
optional
        
Alternativ zur Kontoverbindung des Empfängers kann die IBAN des Zielkontos angegeben werden.
            Es muss genau einer der beiden Parameter angegeben werden.
        
    
    

        

        
dst.name
        
String
        
obligatorisch
        
Name des Empfängers ("Begünstigter").
    
    

        

        
dst.kiname
        
String
        
obligatorisch
        
Vollständiger Name der Zielbank.
    
    

        

        
btg
        
Value
        
obligatorisch
        
Geldbetrag, der überwiesen werden soll.
    
    

        

        
usage
        
String
        
optional
        
Verwendungszweck
    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult
        

    



SEPA-Einzelüberweisung
Dabei handelt es sich um eine Überweisung nach dem SEPA-Standard (ein Projekt, bei dem ein
    europaweit einheitlicher Zahlungsraum angestrebt wird). Solche Überweisungen können als Ziel
    sowohl in- als auch ausländische Konten haben. Die normale Kombination von Kontonummer/BLZ wird
    ersetzt durch die weltweit eindeutige IBAN (entspricht Konto-Identifikation) und BIC
    (Bankkennung). Derzeit (2009) werden SEPA-Geschäftsvorfälle nicht von allen Banken unterstützt.

    

        
Highlevel-Name
        
UebSEPA
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
src
        
Konto
        
obligatorisch
        
Belastungskonto des Kunden. Entscheidend sind gesetzte Werte
            für bic, iban und name
    
    

        

        
dst
        
Konto
        
obligatorisch
        
Konto, auf dem der Betrag gutgeschrieben werden soll. Entscheidend sind auch hier gesetzte Werte
            für bic, iban und name
    
    

        

        
btg
        
Value
        
obligatorisch
        
Geldbetrag, der überwiesen werden soll. Die Währung muss immer EUR sein
    
    

        

        
usage
        
String
        
optional
        
Verwendungszweck (max. 140 Zeichen)
    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult
        

    



Terminierte Einzelüberweisung
Dabei handelt es sich um eine Einzelüberweisung, bei der zusätzlich das Datum
    angegeben wird, zu dem diese Überweisung ausgeführt werden soll. Das Datum darf in der Regel
    nicht zu nah in der Zukunft liegen (meist mind. 2 Tage) und muss ein Werktag sein. Die
    Mindestvorlaufzeit zur Einreichung einer terminierten Überweisung ist aus den Job-Restriktionen
    zu erfahren.

    

        
Highlevel-Name
        
TermUeb
        

    
    

        
Highlevel-Parameter
        
wie bei Einzelüberweisung, zusätzlich:
        

    
    

        

        
date
        
Date
        
obligatorisch
        
Datum der geplanten Ausführung der Überweisung
    
    

        
Rückgabedaten-Klasse
        
GVRTermUeb
        

    



Liste noch anstehender terminierten Überweisungen abholen
Mit diesem Geschäftsvorfall kann eine Liste aller noch anstehenden terminierten Überweisungen
    abgeholt werden.

    

        
Highlevel-Name
        
TermUebList
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
optional
        
Kundenkonto, für das die Liste abgeholt werden soll; ist kein Konto angegeben, so wird das erste Konto aus
            den UPD verwendet.
        
    
    

        

        
startdate
        
Date
        
optional
        
nur Aufträge abholen, die an oder nach diesem Datum ausgeführt werden sollen
    
    

        

        
enddate
        
Date
        
optional
        
nur Aufträge abholen, die an oder vor diesem Datum ausgeführt werden sollen
    
    

        
Rückgabedaten-Klasse
        
GVRTermUebList
        

    



Noch anstehende terminierte Überweisung verändern
Mit diesem Geschäftsvorfall kann eine noch nicht ausgeführte terminierte Überweisung verändert
    werden. Aus den Job-Restriktionen ist ersichtlich, ob das überhaupt möglich ist und wenn ja, welche
    Parameter verändert werden dürfen. Für diesen Geschäftsvorfall wird die Auftrags-Identifikationsnummer (orderid)
    des zu bearbeitenden Auftrages benötigt.
    Es müssen nur die Parameter angegeben werden, die tatsächlich geändert werden sollen.
    Alle anderen Job-Parameter müssen nicht mit angegeben werden (sie werden automatisch
    anhand der Order-ID ermittelt). Zur Benutzung von Order-IDs siehe entsprechenden Abschnitt
    in der Beschreibung zu Löschen einer terminierten Überweisung.

    

        
Highlevel-Name
        
TermUebEdit
        

    
    

        
Highlevel-Parameter
        
wie bei Terminierte Überweisung, jedoch alles optional;
            zusätzlich:
        
        

    
    

        

        
orderid
        
String
        
obligatorisch
        
Die Auftragsidentifikationsnummer des zu bearbeitenden Auftrages.
    
    

        
Rückgabedaten-Klasse
        
GVRTermUebEdit
        

    



Noch anstehende terminierte Überweisung löschen
Mit diesem Geschäftsvorfall kann eine noch nicht ausgeführte terminierte Überweisung gelöscht
    werden. Für diesen Geschäftsvorfall wird nur die Order-ID eines terminierten Überweisungsauftrages
    benötigt.
Order-IDs werden bei den Geschäftsvorfällen Einrichten einer terminierten Überweisung,
    Ändern einer terminierten Überweisung sowie Abrufen
        des Bestandes terminierter
        Überweisungen zurückgegeben. Auch wenn die entsprechenden Order-IDs bereits offline bekannt sind
    (z.B. aus früheren HBCI-Dialogen), so muss erst ein Auftrag ausgeführt werden, der die Order-ID
    für den zu löschenden Auftrag tatsächlich zurückgibt (also in der Regel ein Abrufen des Bestandes...).
    Der Grund ist der, dass HBCI4Java zusätzlich benötigte Auftragsdaten intern
    zwischenspeichert und gegebenenfalls benutzt. Diese Zwischenspeicherung ist aber an
    ein konkretes HBCIPassport-Objekt gebunden, weshalb die Verwendung von
    Order-IDs, welche nicht zur Laufzeit erzeugt wurden, zu einer Exception führt.

    

        
Highlevel-Name
        
TermUebDel
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
orderid
        
String
        
obligatorisch
        
Die Auftragsidentifikationsnummer des zu löschenden Auftrages.
    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult
        

    



Sammelüberweisung einreichen
Mit diesem Geschäftsvorfall kann ein Sammelüberweisungsauftrag eingereicht werden.
    Die Daten müssen dabei bereits im DTAUS-Format vorliegen. Für die Erzeugung von DTAUS-Datensätzen
    kann die Klasse DTAUS benutzt werden.

    

        
Highlevel-Name
        
MultiUeb
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
obligatorisch
        
Kontoverbindung des Auftraggebers
    
    

        

        
data
        
String
        
obligatorisch
        
DTAUS-Daten mit den Überweisungsinformationen
    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult
        

    



Sammellastschrift einreichen
Mit diesem Geschäftsvorfall kann ein Sammellastschriftauftrag eingereicht werden.
    Die Daten müssen dazu bereits im DTAUS-Format vorliegen. Für die Erzeugung von DTAUS-Datensätzen
    kann die Klasse DTAUS benutzt werden.

    

        
Highlevel-Name
        
MultiLast
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
obligatorisch
        
Kontoverbindung des Auftraggebers
    
    

        

        
data
        
String
        
obligatorisch
        
DTAUS-Daten mit den Überweisungsinformationen
    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult
        

    



Einzellastschrift einreichen
Mit diesem Geschäftsvorfall wird ein einzelner Auftrag zum Lastschrifteinzug eingereicht.

    

        
Highlevel-Name
        
Last
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
obligatorisch
        
Konto des Bankkunden
    
    

        

        
other
        
Konto
        
obligatorisch
        
Konto, welches mit dem Betrag belastet werden soll
    
    

        

        
btg
        
Value
        
obligatorisch
        
Geldbetrag, der eingezogen werden soll.
    
    

        

        
name
        
String
        
obligatorisch
        
Name des Zahlungspflichtigen
    
    

        

        
name2
        
String
        
optional
        
Fortsetzung Name des Zahlungspflichtigen.
    
    

        

        
type
        
String
        
optional
        
Typ der Lastschrift. Defaultmäßig wird hier "05" verwendet, es ist auch der Code "04" zulässig.
    
    

        

        
usage,
usage_2,
usage_3,...
        
String
        
optional
        
Verwendungszweckzeilen
    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult
        

    



Lastschriftwiderruf
Damit kann eine Lastschrift, mit der das eigene Konto belastet wurde, "zurückgegeben" werden.

    

        
Highlevel-Name
        
StornoLast
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
obligatorisch
        
Konto des Bankkunden
    
    

        

        
other
        
Konto
        
obligatorisch
        
Gegenkonto, dem die ursprüngliche Lastschrift gutgeschrieben wurde
    
    

        

        
btg
        
Value
        
obligatorisch
        
Betrag der ursprünglichen Lastschrift
    
    

        

        
date
        
Date
        
obligatorisch
        
Datum des ursprünglichen Lastschriftauftrages
    
    

        

        
name
        
String
        
obligatorisch
        
Name des Auftraggebers der ursprünglichen Lastschrift
    
    

        

        
name2
        
String
        
optional
        
Fortsetzung Name des Auftraggebers.
    
    

        

        
primanota
        
String
        
optional
        
Primanota-Nummer der ursprünglichen Lastschrift
    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult
        

    



Kontoumsätze anzeigen
Mit diesem Geschäftsvorfall kann eine Übersicht über die Kontoumsatzdaten
    eines Kontos abgeholt werden.

    

        
Highlevel-Name
        
KUmsAll
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
optional
        
Das Konto, für das Umsatzinformationen abgeholt werden sollen. Wird hier kein Konto angegeben, so wird das
            erste Konto aus den UPD verwendet.
        
    
    

        

        
startdate
        
Date
        
optional
        
Nur Umsatzdaten abholen, die an oder nach diesem Datum gebucht wurden
    
    

        

        
enddate
        
Date
        
optional
        
Nur Umsatzdaten abholen, die an oder vor diesem Datum gebucht wurden
    
    

        
Rückgabedaten-Klasse
        
GVRKUms
        

    



Neue Kontoumsätze anzeigen
Mit diesem Geschäftsvorfall kann eine Übersicht über die Kontoumsatzdaten
    eines Kontos abgeholt werden. Dabei werden nur die Umsatzdaten zurückgegeben, die
    seit dem letzten Aufruf dieses Geschäftsvorfalles neu hinzugekommen sind.

    

        
Highlevel-Name
        
KUmsNew
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
optional
        
Das Konto, für das Umsatzinformationen abgeholt werden sollen. Wird hier kein Konto angegeben, so wird das
            erste Konto aus den UPD verwendet.
        
    
    

        
Rückgabedaten-Klasse
        
GVRKUms
        

    



Saldoabfrage eines Kontos
Mit diesem Geschäftsvorfall wird der Saldo eines Kundenkontos abgefragt.

    

        
Highlevel-Name
        
SaldoReq
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
optional
        
Das Konto, für das der Saldo ermittelt werden soll. Wird hier kein Konto angegeben, so wird das erste Konto
            aus den UPD verwendet.
        
    
    

        
Rückgabedaten-Klasse
        
GVRSaldoReq
        

    



Saldenabfrage aller Kundenkonten
Mit diesem Geschäftsvorfall werden die Salden aller Kundenkonten abgefragt.

    

        
Highlevel-Name
        
SaldoReqAll
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
optional
        
Ein Kundenkonto. Wird hier kein Konto angegeben, so wird das erste Konto aus den UPD verwendet.
    
    

        
Rückgabedaten-Klasse
        
GVRSaldoReq
        

    



Saldoabfrage eines SEPA-Kontos
Mit diesem Geschäftsvorfall kann der Saldo eines SEPA-fähigen Kontos abgefragt werden.

    

        
Highlevel-Name
        
SaldoReqSEPA
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
obligatorisch
        
Das Konto, für das der Saldo ermittelt werden soll. Bei diesem Konto müssen mindestens BIC und IBAN gesetzt
            sein, abhängig von der Bank evtl. zusätzlich auch die Kontowährung.
        
    
    

        
Rückgabedaten-Klasse
        
GVRSaldoReq
        

    



Festgeldkonditionen abholen
Mit diesem Geschäftsvorfall können die aktuell gültigen Konditionen für Festgeldanlagen
    vom Kreditinstitut abgeholt werden.

    

        
Highlevel-Name
        
FestCondList
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
curr
        
String
        
obligatorisch
        
Die Währung, in der die Festgeldanlagen geführt werden sollen ("EUR").
    
    

        
Rückgabedaten-Klasse
        
GVRFestCondList
        

    



Liste bestehender Festgeldanlagen abholen
Mit diesem Geschäftsvorfall kann eine Übersicht über bestehende Festgeldanlagen zu einem
    bestimmten Anlagekonto abgeholt werden.

    

        
Highlevel-Name
        
FestList
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
obligatorisch
        
Festgeld-Anlagekonto, für dessen Festgeldanlagen Informationen abgeholt werden sollen.
    
    

        
Rückgabedaten-Klasse
        
GVRFestList
        

    



Liste aller bestehender Festgeldanlagen abholen
Mit diesem Geschäftsvorfall kann eine Übersicht über alle bestehende Festgeldanlagen
    abgeholt werden.

    

        
Highlevel-Name
        
FestListAll
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
optional
        
Kontoverbindung eines existierenden Anlagekontos oder eines "normalen" Kontos.
    
    

        
Rückgabedaten-Klasse
        
GVRFestList
        

    



Kontostammdaten abholen
Dieser Geschäftsvorfall ermöglicht das Abholen von Kontostammdaten. Er ist erst ab
    HBCI 2.2 spezifiziert, wird aber unter Umständen von einigen Banken bereits in früheren
    HBCI-Versionen angeboten.

    

        
Highlevel-Name
        
AccInfo
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
obligatorisch
        
Kontoverbindung, für die Stammdaten ermittelt werden sollen.
    
    

        

        
all
        
J oder N
        
optional
        
J, wenn für alle verfügbaren Konten die Daten abgeholt werden sollen, sonst N (default)
    
    

        
Rückgabedaten-Klasse
        
GVRAccInfo
        

    



Karteninformationen abholen
Dieser Geschäftsvorfall ermöglicht es, Informationen zu den von der Bank
    ausgegebenen Karten abzuholen. Das wird u.U. benötigt, wenn eine Karte nach
    Verlust gesperrt werden soll, die dafür notwendigen Kartendaten aber nicht mehr
    bekannt sind. Dieser Geschäftsvorfall ist erst ab
    HBCI 2.2 spezifiziert, wird aber unter Umständen von einigen Banken bereits in früheren
    HBCI-Versionen angeboten.

    

        
Highlevel-Name
        
CardList
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
my
        
Konto
        
obligatorisch
        
Kontoverbindung des Karteninhabers
    
    

        
Rückgabedaten-Klasse
        
GVRCardList
        

    



Übersicht über Kreditinstitutsinformationen abholen
Mit diesem Geschäftsvorfall kann eine Übersicht über die vom Kreditinstitut bereitgestellten
    Informationen abgeholt werden. Mit einem weiteren Geschäftsvorfall können dann die Informationen
    selbst bestellt bzw. abgeholt werden.

    

        
Highlevel-Name
        
InfoList
        

    
    

        
Highlevel-Parameter
        

        

    
    

        
Rückgabedaten-Klasse
        
GVRInfoList
        

    



Bestellen bzw. Abholen von Kreditinstitutsinformationen
Mit diesem Geschäftsvorfall können bestimmte Kreditinstitutsinformationen angefordert werden.
    Die dafür benötigten Codes für die jeweiligen Informationen können mit dem Geschäftsvorfall
    InfoList ermittelt werden. Werden Freitextinformationen
    angefordert, so werden diese direkt in der Antwortnachricht übermittelt, ansonsten wird durch
    diesen Geschäftsvorfall eine Bestellung der Informationen ausgelöst, die dann anderweitig
    zugestellt werden (per Post).

    

        
Highlevel-Name
        
InfoOrder
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
code,
code_2,
code_3,...
        
String
        
obligatorisch
        
Es muss mindestens einer der Informationscodes aus dem GV "InfoList" angegeben werden.
    
    

        

        
name
        
String
        
optional
        
Name des Kunden, wird für die schriftliche Zustellung benötigt (wie auch alle folgenden Parameter)
    
    

        

        
name2
        
String
        
optional
        
Fortsetzung Name des Kunden
    
    

        

        
street
        
String
        
optional
        
Strasse der Lieferanschrift
    
    

        

        
ort
        
String
        
optional
        
Ort der Lieferanschrift
    
    

        

        
plz
        
String
        
optional
        
PLZ der Lieferanschrift
    
    

        

        
country
        
String
        
optional
        
Ländercode der Lieferanschrift ("DE")
    
    

        

        
tel
        
String
        
optional
        
Telefonnumer für Rückfragen
    
    

        

        
fax
        
String
        
optional
        
Telefaxnummer des Kunden
    
    

        

        
email
        
String
        
optional
        
Email-Adresse des Kunden
    
    

        
Rückgabedaten-Klasse
        
GVRInfoOrder
        

    



Statusinformationen zu Geschäftsvorfällen abholen
Mit diesem Geschäftsvorfall können zu allen bisher via HBCI eingereichten Aufträgen
    Statusinformationen abgeholt werden. Diese enthalten i.d.R. den Returncode, den das Einreichen
    des entsprechenden Auftrages erzeugt hat, bzw. eine Information über den gegenwärtigen
    Status der Verarbeitung.
Nach dem Ausführen eines beliebigen Geschäftsvorfalles gibt die Methode
    HBCIJob.getJobResult().getJobId() eine ID
    zurück,
    die diesen Job eindeutig kennzeichnet. Diese ID kann dann zur Identifikation der entsprechenden
    Status-Daten aus dem Status-Protokoll benutzt werden (siehe dazu die Dokumentation der Klasse
    GVRStatus).

    

        
Highlevel-Name
        
Status
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
startdate
        
Date
        
optional
        
Nur Statusprotokolleinträge zurückgebenm die an oder nach diesem Datum erzeugt wurden
    
    

        

        
enddate
        
Date
        
optional
        
Nur Statusprotokolleinträge zurückgebenm die an oder vor diesem Datum erzeugt wurden
    
    

        

        
jobid
        
String
        
optional
        
alternativ zu den beiden Date-Parametern kann eine Job-Id angegeben werden, für die
            Statusinformationen benötigt werden. Es werden dann intern automatisch die richtigen Parameterwerte für
            startdate und enddate erzeugt und gesetzt.
        
    
    

        
Rückgabedaten-Klasse
        
GVRStatus
        

    



Abholen von Informationen über TAN-Listen
Dieser Geschäftsvorfall macht nur bei Verwendung von PIN/TAN-Passports Sinn. Damit können
    Informationen zu aktuellen TAN-Listen abgeholt werden. Mit diesem Geschäftsvorfall können
    keine neuen TAN-Listen bestellt werden, es ist auch nicht möglich, mit diesem
    Geschäftsvorfall die Menge der noch nicht verbrauchten TANs zu ermitteln.

    

        
Highlevel-Name
        
TANList
        

    
    

        
Highlevel-Parameter
        

        

    
    

        
Rückgabedaten-Klasse
        
GVRTANList
        

    



Ändern der PIN für HBCI-PIN/TAN
Dieser Geschäftsvorfall macht nur bei Verwendung von PIN/TAN-Passports Sinn. Damit
    kann die aktuelle PIN für HBCI-PIN/TAN auf einen neuen Wert geändert werden.

    Aus Sicherheitsgründen wird die neue PIN nicht automatisch verwendet. Das heißt, sobald
    dieser GV erfolgreich bei der Bank eingereicht wurde und das OK empfangen wurde,
    muss für die nachfolgende Nachricht (Dialog-Ende) die neue PIN explizit eingegeben
    werden.

    

        
Highlevel-Name
        
ChangePIN
        

    
    

        
Highlevel-Parameter
        

        

    
    

        

        
newpin
        
String
        

        
Die neue PIN.
    
    

        
Rückgabedaten-Klasse
        
HBCIJobResult