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 `LLparamName`n 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:
1. Es werden alle Parameter wie beim Erzeugen des Dauerauftrages und zusätzlich die Order-ID angegeben.
2. 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.

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`