Subsembly FinTS API Release Notes

Version 10.7.2.9557

• BREAKING: BuildingSavingsAcctType was renamed to FinBuildingSavingsAcctType, BuildingSavingsContractStatus was renamed to FinBuildingSavingsContractStatus.
• BREAKING: Removed ancient legacy FinSingOrderBuilder (DTAUS) and FinReclassificationBuilder (HKUMB), which are no longer supported by any bank.
• Automatically send VoP confirmation if there is no Narrative and the GroupStatusCode is Completed (all match).
• Implemented Work-Around for HypoVB error that returns response data segments without any segment reference when there was a 2FA. For example, when requesting more than 90 days of statement data.

Version 10.7.1.9405

• Verschiedene Anpassungen und Bug-Fixes bzgl. Verification of Payee.
• Neue Klasse FinSepaSubmitPostdatedInstPaymtBuilder für Änderung terminierter Echtzeitüberweisungen (HKTIA) hinzugefügt.
• Neue Klassen FinTimeSlot und FinTimeConstraints für BPD Parameter von terminierten Echtzeitüberweisungen und Echtzeitdaueraufträgen hinzugefügt.
• Das FinDialogResult enthält nun die zusätzliche Eigenschaft VopOption, welche immer zusammen mit dem VopResult belegt wird.
• Die Basisklasse FinVopVerificationOrder enthält nun die zusätzliche abstrakte Eigenschaft VopOption.
• BREAKING: Die Methode ConfirmVerificationOfPayee im Interface IFinVerificationOfPayeeForm hat nun einen zusätzlichen Parameter VopOption.

Version 10.7.0.9369

In diesem Release ist erstmalig Verification of Payee vollumfänglich verfügbar.

• Neue Klasse FinSepaSubmitPostdatedInstPaymtBuilder für terminierte Echtzeitüberweisungen (HKIPT) hinzugefügt.
• BREAKING: FinSepaPostdatedMultInstPaymtBuilder wurde für eine einheitliche Namensgebung in FinSepaSubmitPostdatedMultInstPaymtBuilder umbenannt.
• Virtuelle Eigenschaften MinLeadTime, MinLeadTimeSpan und MaxLeadTime zu FinSepaOrderBuilder hinzugefügt. Werden von allen abgeleiteten, terminierten Auftragsarten passend überschrieben.
• BREAKING: FinOrder und alle davon abgeleiteten Klassen benötigen jetzt den OrderAcct im ctor. Die Eigenschaft OrderAcct kann nicht mehr gesetzt werden. Alle FinBuilder wurden entsprechend angepasst.
• Beim Einrichten eines Bankzugangs im FinTS Admin wird nun die Zugangsadresse aus der FinBanks Datei bevorzugt verwendet.
• Neues Interface IFinVerificationOfPayeeForm für eigene Implementierung des Verification of Payee Dialogs. In der Komponente Subsembly.FinTS.Win32 ist hierfür eine Standardimplementierung FinVerificationOfPayeeForm für Windows Forms enthalten.
• Die Klasse FinScriptSendOrder enthält nun neue Execute Methoden welche als zusätzliche Parameter eine IFinVerificationOfPayeeForm Implementierung und ein Opt-Out Flag enthalten. Grundsäzlich wickelt FinScriptSendOrder den kompletten Verification of Payee Ablauf automatisch ab.

Version 10.6.0.9208

• In Vorbereitung auf das kommende Verification of Payee Verfahren wurden bereits Verschiedene FinVopXxx Klassen hinzugefügt. Eine vollständige Implementierung des Verification of Payee Verfahrens wird in Version 11 voraussichtlich im August 2025 zur Verfügung stehen.
• Eigenschaft FinDialogResult.TanInfo hinzugefügt, welche die kompletten HITAN Informationen im Falle einer TAN oder DECOUPLED Anforderung bereitstellt.
• BREAKING: Ein "deprecated" Overload von FinCredentialManager.GetTan() wurde entfernt. Alternativ bitte einen anderen Overload nutzen.
• BREAKING: FinCredential.TanMedia wurde durch FinCredential.TanMediaName ersetzt.
• BREAKING: Der Typ der Eigenschaften FinTanProcessParameters.TanMediaNameReqd, FinTanProcessParameters.ActiveTanMediaCount und FinTanProcInfo.TanMediaNameReqd wurde geändert um den vollständigen Wertebereich aus dem HITANS abbilden zu können.
• Klassen FinSepaModifyPostdatedSingRemittBuilder und FinSepaModifyOrder für Änderung terminierte Überweisung (HKCSA) hinzugefügt.
• Interface IFinCustomerSystem hinzugefügt. Dieses kann global in FinContact.CustSys gesetzt werden um die Speicherung der Kundensystem-ID, getrennt vom FinContact zu übernehmen. Wird dies nicht gesetzt, wird die Kundensystem-ID weiterhin im FinContact gespeichert. Wir die Speicherung über diese Eigenschaft übernommen, dann sollte die gesetzte Implementierung die Kundensystem-ID getrennt von anderen Daten auf dem Gerät selbst speichern.
• Interface IFinDecoupledForm hinzugefügt. Falls eine Implementierung dieses Interfaces an den FinCredentialManager übergeben wird, wird diese verwendet, um automatisches Polling bei Decoupled-Freigaben zu ermöglichen.
• Methoden FinTanProcessParameters.GetDecoupledMaxPollsAllowed(), FinTanProcessParameters.GetDecoupledMinSecondsBeforePolling() und FinTanProcessParameters.GetDecoupledMinSecondsBetweenPolls() hinzugefügt.
• Spezielle Behandlung des TargoBank easyTAN Decoupled Verfahrens entfernt. Ein Decoupled Polling ist bei der TargoBank dennoch nicht möglich und wird deshalb nicht unterstützt.
• Die FinCreditCard Klassen unterstützen nun auch die neuen HKKKU und HKKKS Segmenttypen. Wobei diese bervorzugt zu DKKKU und DKKKS verwendet werden.
• Virtuelle Methode FinAdmin.ShowIniLetter eingeführt.
• Abtrakte Zwischenklasse FinAcknowledgeableBuilder hinzugefügt.
• Falls ein Abruf eines E-Kontoauszugs über einen Builder erfolgt, dessen Parameter AcknowledgementRequired "true" ist, wird im Auszug der Status auf FinAcctStmtAckStatus.Required, sofern der Auszug noch nicht quittiert wurde.
• Bei Sparkassen, welche die Kontoauszugsnummer im Segment HIRMS, statt im dafür vorgesehenen Segment HIEKP, liefern, sollte die Zuordnung nun auch funktionieren, wenn in einer Antwortnachricht mehrere HIEKP Kontoauszüge geliefert werden.

Version 10.5.0.9063

• Unterstützung für Eilzahlungen (HKCSU und HKCMU) hinzugefügt (FinSepaUrgntPaymtBuilder und FinSepaMultUrgntPaymtBuilder).
• Unterstützung für Kontoinformationen (HKKIF) hinzugefügt (FinAcctDetailsBuilder, FinAcctDetailsOrder und FinAcctDetails). Wird nur von Finanz Informatik und Atruvia angeboten.
• Unterstützung für den Abruf von Freistellungsdaten (HKFRD) hinzugefügt (FinTaxExemptionListBuilder, FinTaxExemptionListOrder und FinTaxExemption).
• Unterstützung für Zeitversetzte, dialogübergreifende Eingabe von Mehrfach-Sicherheitsfreigaben bei Prozessvariante 2 implementiert. Die Zeitversetzte Freigabe wird durch die neue Methode FinBanking.ConfirmOrder() gestartet.
• Eigenschaft FinOrder.TanOrderRef hinzugefügt. Über diese Eigenschaft erhält eine Anwendung Zugriff auf die im 2-Schritt-TAN-Verfahren verwendete TAN Auftragsreferenz (siehe FinTanInfo.OrderRef).
• Unterstützung für HKCSBv2, HKBBSv2 und HKDBSv2 implementiert.
• Unterstützung für HKEKAv6 und HKKAUv3 implementiert.
• FinSepaDirectDebitIndication ist jetzt von FinPersist abgeleitet und kann deshalb als XML gespeichert und geladen werden.
• Alle DLLs mit Namen Subsembly.*.dll werden nun mit einer Code Signing Signatur versehen.

Version 10.4.0.8902

• FinSepaInstPaymt enthält nun eine zusätzliche Eigenschaft MustQueryStatus.
• BREAKING: FinSepaInstPaymtStatusBuilder ist jetzt eine abstrakte Basisklasse von FinSepaMultInstPaymtStatusBuilder und dem neuen FinSepaSingInstPaymtStatusBuilder. Über die Basisklasse gibt es nun eine zusätzlichen Build Methode, welche als Parameter den ursprünglichen FinSepaInstPaymt Auftrag, für welchen der Status abgefragt werden soll, benötigt. Das Ergebnis der Statusabfrage wird dann automatisch auch im übergebenen Originalauftrag gesetzt.
• FinScriptSendOrder ruft bei Echtzeitüberweisungen nun vollautomatisch den Ausführungsstatus ab, sofern dies durch das Banksystem erforderlich ist (Deutsche Bank und alle Ihre Töchter und Marken).
• Enthält nun die Subsembly SEPA API Version 9.2.0.8902.
• Enthält den aktualisierten FinBanks Datenbestand vom 14.05.2024.

Version 10.3.2.8679

• Unterstützung für Auslandsüberweisungen nach ISO 20022, Segmentart HKAUP, durch neue Klasse FinSepaIntRemittBuilder implementiert.
• Unterstützung für FinTS Geschäftsvorfall HKECA "Kontoauszug camt anfordern" durch neue Klasse FinAcctStmtCamtBuilder implementiert.

Version 10.3.1.8536

• Beispiel FinCmdUI zur ZIP-Datei hinzugefügt.
• Die FinScript Basisklasse hat nun eine zusätzliche Result Eigenschaft, aus der das letzte Ergebnis nach Script-Ausführung gelesen werden kann.
• In FinCommServiceTcp wurde das Timeout von 30 auf 60 Sekunden erhöht.

Version 10.3.0.8502

• Unterstützung für terminierte Echtzeit-Sammelüberweisungen HKIPE mit der Klasse FinSepaPostdatedMultInstPaymtBuilder implementiert.
• Unterstützung für SEPA-Instant Payment Sammelzahlung Status HKISS mit der Klasse FinSepaMultInstPaymtStatusBuilder implementiert.
• Unterstützung der PSD2 Management Geschäftsvorfälle zur Verwaltung der Empfänger Whitelist mit verschiedenen FinWhitelistXxx Klassen implementiert.
• Unterstützung für Aufträge HKPOF und HKKAA zum Abrufen des elektronischen Postfachs mit verschiedenen FinMailXxx Klassen implementiert.
• Unterstützung für die "Willenserklärung des Kunden" via HKWEK mit der Klasse FinConsentDeclarationBuilder.
• Unterstützung der RDH/RAH Schlüsselsperrung vis FinBanking.KeyBlockDialog und FinDialog.KeyBlock.
• In den von FinSepaSubmitPostdatedDirDebBuilder abgeleiteten Klassen wird der LocalInstrumentCode im PaymentInformation-Block jetzt nur mehr dann gesetzt/überschrieben, wenn in allen TransactionInformation-Blöcken, noch kein LocalInstrumentCode gesetzt wurde.

Version 10.2.3.8111

• BREAKING: Jegliche Implementierungsdetails des nicht mehr existierenden DDV Sicherheitsverfahrens entfernt. Unter Umständen müssen spezifische Referenzen auf dieses Sicherheitsverfahren auch in Anwendungscode entfernt werden.

Version 10.2.2.8095

• Fehler beim Parsen des Segments HIEKP Version 2 behoben.
• Enthält nun die Subsembly SEPA API 9.0.3 mit Korrekturen zur neuen CAMT version 08.
• Die Klasse FinDtaBase hat keine Eigenschaft HandbookVersion mehr, da diese inzwischen irrelevant geworden ist. FinDtaBuilder.GenerateDTAZV hat nun eine DailySeqNo Parameter statt HandbookVersion.
• Die Klasse FinInternationalRemittBuilder hat nun eine statische DailySeqNo, welche bei jedem Aufruf von Build() verwendet und hochgezählt wird.
• Verhalten von FinCmd Parameter -tanprocedure korrigiert und neuen FinCmd Parameter -tanfunction hinzugefügt.

Version 10.2.1.8021

• Verschiedene Anpassungen um das easyTAN Verfahren der Targobank zu unterstützen.
• Unterstützung für HKIPZ Version 2 zu FinSepaInstPaymtBuilder hinzugefügt.
• Unterstützung für Echtzeit-Sammelüberweisungen HKIPM mit der Klasse FinSepaMultInstPaymtBuilder implementiert.

Version 10.2.0.7851

• Alle für das .NET Framework für Windows compilierten Komponenten und Anwendungen werden ab sofort für .NET Framework 4.8 compiliert.
• FinCmd wird jetzt für .NET Core 3.1 compiliert und ist somit auch unter Linux und macOS lauffähig.

Version 10.1.2.7713

• Klassen FinPortfAcctStatementReqBuilder und FinPortfAcctStatementReqOrder für Abrufe von Wertpapierumsätzen via HKWDU hinzugefügt.
• Klassen FinPortfOrderStatReqBuilder, FinPortfOrderStatReqOrder, FinPortfOrderStatResp und das Enum FinPortfOrderStatus für Abrufe von Wertpapierorderstatus via HKWSO hinzugefügt.
• Klassen FinDoc, FinDocFormatInfo, FinDocListBuilder, FinDocListOrder, FinDocReqBuilder, FinDocReqOrder und das Enum FinDocFormatType für Abrufe von Finanzdokumenten via HKFDL und HKFDA hinzugefügt.

Version 10.1.1.7646

• Klasse FinAcctOrderInfo hinzugefügt, welche über FinAcctInfo.GetAllowedSegmentInfo ermittelt werden kann. Liefert zusätzliche Informationen zu den erlaubten Geschäftsvorfällen aus dem HIUPD Segment, sofern verfügbar.
• Wird ein SendOrder mit einem FinMessageResult.ErrorTanProcess beendet, so wird der gespeicherte TanMediaName und die gespeicherte TanMedias Liste im FinContact gelöscht. Dadurch wird diese bei der nächsten Anmeldung neu abgerufen.
• FinBanking aktualisiert nun die TAN-Medienliste automatisch, wenn diese älter als eine Stunde ist. Änderungen bei der Bank werden dadurch zuverlässiger, und ohne explizite Synchronisierung, übernommen.
• Klassen FinDistHvbSignatureOrderBuilder (BKTAS), FinDistHvbCancellationOrderBuilder (BKTAL) und FinDistHvbOrderListBuilder (BKTAB), sowie Eigenschaft FinOrder.HvbDistOrder für spezielle Teilsignierte Aufträge der HypoVereinsbank hinzugefügt.

Version 10.1.0.7573

• NEU: Unterstützung der neuen DECOUPLED Sicherheitsverfahren mit HKTAN Version 7. Diese werden von einigen Pilot-Sparkassen ab 11.10.2020, flächendeckend ab 22.11.2020 angeboten. Beim DECOUPLED Verfahren wird keine TAN mehr benötigt, sondern die Freigabe erfolgt direkt in einer separaten App durch einfachen Knopfdruck. Damit dies auch in Ihrer Software funktioniert sind evtl. Anpassungen und Erweiterungen erforderlich. Bitte beachten Sie deshalb folgende Hinweise genau.
• Zur Aufzählung FinDialogResultCode wurde der zusätzliche Wert NeedDecoupled hinzugefügt. Dieser kann alternativ zum bisherigen Wert NeedTan auftauchen, wenn eine DECOUPLED Freigabe ohne TAN erforderlich ist. Prüfen Sie deshalb alle Stellen in Ihrem Code in dem Sie NeedTan auswerten und erweitern Sie die Auswertung um den Fall NeedDecoupled.
• Wurde ein FinDialogResult mit dem Wert NeedDecoupled geliefert, so muss zwingend ein Aufruf der neuen Methode FinBanking.SendDecoupled() erfolgen. SendDecoupled sendet eine HKTAN Statusabfrage an das FinTS System. Wurde der Auftrag vom Anwender noch nicht freigegeben so liefert SendDecoupled erneut ein FinDialogResult mit dem Wert NeedDecoupled. Wurde der Auftrag bereits freigegeben, so wird ein Success Ergebnis geliefert.
• Die Klasse FinChallengeInfo wurde um eine Methode GetChallengePrompt() erweitert, welche genutzt werden sollte um einen sauberen Prompt-Text im Fall NeedTan oder NeedDecoupled zu erhalten.
• Die für die DECOUPLED Sicherheitsverfahren zusätzlichen BPD Rahmenparameter wurden zur Klasse FinTanProcessParameters hinzugefügt.
• Die neue Aufzählung FinTanProcessStep ersetzt alle bisherigen Integer-Parameter und Eigenschaften. Sollte es bei Ihnen deshalb zu Compilerfehlern kommen, prüfen Sie bitte genau, wie Sie mit den neuen Wert FinTanProcessStep.Status behandeln müssen. Dies betrifft nur Low-Level-Code. Bei Verwendung der FinBanking Klasse sollte niemals ein FinTanProcessStep sichtbar sein.
• Zusätzliche Eigenschaft FinTanProcessParameters.IsDecoupled welche anzeigt ob ein TAN-Verfahren eigentlich ein DECOUPLED Sicherheitsverfahren ist.
• Zusätzliche Eigenschaften TanProcessParameters und TanMedia zur Klasse FinCredential hinzugefügt. Diese werden bei allen TAN-Abfragen gesetzt.
• Die institutsspezifische HKTAN Version 7 Variante mit dem appTAN Verfahren der Degussa Bank wird ebenfalls unterstützt.
• Das FinCmd Beispielprogramm wurde um eine Unterstützung für das DECOUPLED Sicherheitsverfahren erweitert. Die Änderungen befinden sich ausschließlich in der Datei FinCmdMain.cs in der Methode Resolve().
• Unser Subsembly FinTS Dummy Testsystem unterstützt bereits das DECOUPLED Sicherheitsverfahren mit HKTAN Version 7.

Version 10.0.1.7489

• ACHTUNG: Mit dieser Version gibt es ein erweitertes Tracing, kontrollierbar über den neuen, globalen FinDialog.TraceSwitch.
• IFinCommService.SendReceive() mit neuem FinDialog parameter.
• Neue Klasse FinChallengeHHDUCSequencer zur besseren Unterstützung der Implementierung einer Darstellung von Chip-TAN Flicker-Codes.
• HIRMS-Segmente mit Bezug auf die Signatur werden jetzt korrekt in die FinMessage.OrphanStatusSegments eingestellt.
• Die Subsembly.Sepa.dll und Subsembly.Swift.dll wurden zusammengeführt und erweitert. Die Klassen sind nun alle in der Subsembly.Sepa.dll, die Subsembly.Swift.dll entfällt. Weitere Informationen hierzu finden Sie bei der Dokumentation der Subsembly SEPA API.

Version 10.0.0.7387

• Enthält nun englische Text-Resourcen.
• PSD2: Work-Around für fehlerhaftes FinTS bei der Degussa Bank.
• Work-Around für fehlerhaftes CAMT-Umsatzdatenformat der Targobank.
• PSD2: FinContactSCA.Default wird jetzt auch bei der 1822direkt als RequestSCA=true interpretiert.

Version 10.0.0.7209

• FinContact.ProduceOrderAcct mit IBAN benötigt nun zusätzlich auch die BIC als Parameter.
• Fehler bei Zugriff auf Text-Resource des Subsembly.FinTS.SmartCard Assemblies behoben.
• PSD2: Besseres Fehlerverhalten bei der Consorsbank.
• PSD2: FinContactSCA.Default wird jetzt immer (mit Ausnahme der 1822direkt) als RequestSCA=true interpretiert.

Version 10.0.0.7202

• PSD2: Work-Around für comdirect bank 3920 Rückmeldungsfehler.
• PSD2: Die durch SCA nicht mehr funktionsfähigen Klassen FinService und FinOnlineBanking wurden entfernt.
• Neue Methode FinDialog.KeepAlive() hinzugefügt, welche ein HKLIF Segment sendet.
• Texte wurden in externe Resourcedateien verschoben.
• PSD2: Der Sicherheitsfunktionscode 999 wird jetzt aus der Liste der erlaubten TAN-Verfahren herausgefiltert. Damit werden Probleme bei der Consorsbank umgangen.

Version 10.0.0.7194

• Eigenschaft FinDialog.DialogTypeParam hinzugefügt. Wird für die korrekte Behandlung von Dialoginitialisierungen bei TAN-Prozessvariante 1 benötigt.
• PSD2: Endlosschleife bei SCA-Aktivierung bei Sparda-DV behoben.
• PSD2: Deutsche Bank und Norisbank: Fehler 9200 führt zu automatischer Auswahl des TAN-Verfahrens.
• PSD2: Optimierung des FinTS-Verhaltens bei der Postbank.
• PSD2: Work-Around für FinTS-Fehler bei der Consorsbank.

Version 10.0.0.7188

• FinDialog.InitDialog unterstützt nun auch wieder FinDialogType.KeyChange korrekt. Schlüsseländerungen und Sicherheitsprofilwechsel sollten damit nun wieder funktionieren.
• In der FinContactForm kann nun das Sicherheitsprofil eines Bankzugangs direkt geändert werden.
• Fehler in FinCredentialForm mit Chip-TAN USB Lesern behoben.
• Um das Problem der im HIUPD fehlenden IBAN bei der Commerzbank zu lösen wird die IBAN nun aus dem HISPA übernommen. Ein HKSPA wird von FinBanking automatisch ausgeführt, wenn keine IBAN oder BIC für ein, ansonsten SEPA-fähiges, Konto vorliegen.

Version 10.0.0.7174

• Anpassung: Nur wenn eine Anmeldung ohne TAN-Verfahren 999 erfolgt, wird im Fehlerfall die SCA für den FinContact deaktiviert.
• Fehler in FinTanBeamerForm behoben, der zu einem Absturz führen konnte.
• Die fest programmierten Sonderfälle für die Begrenzung der PassphraseMaxLength wurden größtenteils entfernt. Nur für die HypoVereinsbank ist noch ein Work-Around für falsche BPD Daten enthalten.
• FinCredentialManager.GetTan erstellt jetzt einen ausführlicheren GetCredential-Dialog.
• ExecuteOrderWithTanInfo und SendTan behandeln nun Aufsetzpunkte, egal ob mit oder ohne TAN, automatisch und korrekt. Bitte beachten Sie, dass mit PSD2 auch Abrufe jederzeit zu TAN-Anforderungen führen können.

Version 10.0.0.7160

• HINWEIS: Um zusätzliche TAN-Eingaben beim Abruf von Kontoumsätzen zu vermeiden sollten Kontoumsätze nur für die letzten 89 Tage (also Startdatum = Today - 89) abgerufen werden. Werden weiter zurückliegende Kontoumsätze abgerufen, wird spätestens ab dem 14.09.2019 jeweils eine zusätzliche TAN angefordert.
• Eine SCA bei der Dialoginitialisierung wird jetzt, unabhängig vom Datum, nur dann versucht, wenn im FinContact ein TAN-Verfahren ausgewählt ist für das es einen Eintrag im HITANS::6 gibt. Gibt es kein HITANS::6, so wird niemals eine SCA versucht.
• Die Eigenschaft FinUserParamData.HaveAllSepaInfos entscheidet jetzt basierend auf dem Vorhandensein der Auftragsart HKSPA im HIUPD, und nicht mehr basierend auf der Kontoart, ob für ein Konto IBAN und BIC erforderlich sind.
• Wird im JSON Erweiterungsteil im HIUPD eine BIC geliefert, so wird diese ins FinAcct übernommen und es ist kein HKSPA mehr erforderlich.
• FinAcctInfo.Bookmark für optimierte Umsatzabrufe hinzugefügt.

Version 10.0.0.7149

• FinDialogResultCode.ErrorWrongPin wird nicht mehr durch anderen Fehler überschrieben.
• Fehler mit doppelten MT-940 Umsätzen durch doppeltes OnExecuteComplete bei TAN-Ausnahme behoben.

Version 10.0.0.7144

• FinContact Datenspeicherung nun wieder kompatibel zu Prä-Betaversionen.
• Problem bei Rückmeldung mit neuer User-ID behoben.
• FinBanking.BeginDialog ruft nun auch automatisch Bankschlüssel ab, sofern diese nicht vorliegen.