Vorab

Dies ist die offizielle Quelle von HBCI4Java, welches u.a. in Hibiscus zum Einsatz kommt.

Versionshinweis

• Version 4.x von HBCI4Java verwendet Jakarta EE (jakarta.*)
• Version 3.x von HBCI4Java verwendet Java EE (javax.*) - veraltet

Kontakt

Unter https://groups.google.com/forum/?hl=de#!forum/hbci4java findet ihr die zugehörige Mailingliste.

Entstehung

Das Projekt entstand 2010 als Fork von http://hbci4java.kapott.org, da dessen Weiterentwicklung eingestellt wurde.

Seither wurden umfangreiche neue Features hinzugefügt wie etwa:

• Unterstützung für die neuen EU-weiten PSD2-Anforderungen (SCA), die ab Mitte September 2019 für FinTS verpflichtend sind
• Abruf von Umsätzen im CAMT-Format (HKCAZ)
• Unterstützung für chipTAN USB
• Abruf des elektronischen Kontoauszuges (HKEKA und HKEKP)
• SEPA-Überweisungen und -Lastschriften (jeweils Einzel- und Sammelaufträge) sowie SEPA-Daueraufträge
• Support für alle aktuellen SEPA-PAIN-Versionen
• Unterstützung von PC/SC-Kartenlesern via javax.smartcardio API
• Eine aktuelle Bankenliste (mit BLZ, Server-Adresse, HBCI-Version,...)
• Unterstützung der neuen TAN-Verfahren (smsTAN, photoTAN, chipTAN - incl. Implementierung des HHD-Standards mit Flicker-Code)
• Unterstützung von RAH10-Schlüsseldateien

Lizenz

LGPL 2.1 - GNU Lesser General Public License, version 2.1 http://www.gnu.org/licenses/old-licenses/lgpl-2.1

Hinweis Bis 02.05.2016 unterlag HBCI4Java der GPLv2 - wurde mit https://github.com/willuhn/hbci4java/issues/36 aber auf LGPL 2.1 geändert.

Download

Du kannst die aktuellste Version von HBCI4Java in Maven Central finden:

https://central.sonatype.com/artifact/com.github.hbci4j/hbci4j-core/versions

Maven

<dependency>
   <groupId>com.github.hbci4j</groupId>
   <artifactId>hbci4j-core</artifactId>
</dependency>

Gradle

dependencies {
  compile 'com.github.hbci4j:hbci4j-core:+'
}

Selbst compilieren

Du benötigst:

• GIT https://git-scm.com/
• Java SDK 17 oder höher https://adoptium.net/
• Gradle 8 oder höher https://gradle.org/

Öffne ein Terminal-Fenster und checke den Quellcode per GIT aus:

$> git clone https://github.com/hbci4j/hbci4java.git

Wechsle in den Ordner "hbci4java":

$> cd hbci4java

Erzeuge die JAR-Datei per:

$> gradle jar

Im Ordner "build/libs" wird die Datei "hbci4j-core-${version}.jar" erzeugt.

Alternativ:

$> gradle distZip

Hier wird im Ordner "build/distributions" die Datei "hbci4j-core-${version}.zip" erzeugt, welche auch die nötigen Abhängigkeiten mit enthält.

In Eclipse einrichten

Öffne ein Terminal-Fenster und checke den Quellcode per GIT aus:

$> git clone https://github.com/hbci4j/hbci4java.git

Wechsle in den Ordner "hbci4java":

$> cd hbci4java

Führe die folgenden beiden Befehle aus:

$> gradle jaxb
$> gradle eclipse

Hierbei wird der Java-Code für die PAIN/CAMT XML-Dateien im Ordner "build/generated/jaxb" und die Eclipse Projekt-Konfiguration generiert.

• Starte Eclipse.
• Wähle in der View "GIT Repositories" oben den Button "Add an existing local GIT repository to this view".
• Klicke mit der rechten Maustaste auf das importierte Repository und wähle "Import Projects..." (wenn das nicht funktioniert, öffne den "Project Explorer" und wähle dort im Kontextmenü "Import..." und anschließend unter "General" die Option "Existing Projects into Workspace". Wähle anschließend den Ordner "hbci4java" aus).
• Folge den Anweisungen des Assistenten.

Unit-Tests

Im Ordner "src/main/test/" befinden sich einige JUnit-Tests. Einige davon erfordern jedoch das Vorhandensein spezieller Testumgebungen (Vorhandensein von Bankzugängen oder Chipkartenleser). Diese Tests werden im Zuge der Erstellung von Deployment-Artefakten nur dann ausgeführt, wenn die entsprechenden System-Properties "test.online=true" und "test.chipcard=true" aktiv sind. Die Tests zur Ausführung von HBCI-Geschäftsvorfällen benötigen jedoch weitere Daten (Empfängerkonto, Betrag, Verwendungszweck, usw.). Wenn du diese Tests ausführen möchtest, schaue dir den Quellcode der entsprechenden Tests an.

Du kannst die Tests starten per:

$> gradle test

Beispiel-Code

Unter https://github.com/hbci4j/hbci4java/blob/master/src/main/java/org/kapott/hbci/examples/UmsatzAbrufPinTan.java findest du Beispiel-Code zum Abrufen des Saldos und der Umsätze eines Kontos per PIN/TAN-Verfahren.