Die nationalen Zentralbanken oder Clearingstellen veröffentlichen in regelmäßigen Abständen die Daten aller Banken des Landes. Diese Daten können verwendet werden, um im ERP-System neue Banken zu erfassen oder die vorhandenen zu aktualisieren. Mithilfe der Hintergrund-Anwendung Bankdaten importieren werden diese Bankdaten importiert.
In diesem Dokument ist beschrieben, wie die Hintergrund-Anwendung Bankdaten importieren aufgebaut ist.
Begriffsbestimmung
Hintergrund-Anwendung – Eine Hintergrund-Anwendung ist eine Anwendung, die ohne Interaktion mit einem Benutzer ausgeführt wird. Sie kann entweder durch einen Verarbeitungsauftrag, durch einen CORBA-Aufruf oder durch eine andere Anwendung geöffnet werden.
Anwendungsbeschreibung
Mithilfe der Hintergrund-Anwendung Bankdaten importieren werden externe Bankdaten importiert. Als Quelle können die Dateien verwendet werden, die durch die nationalen Zentralbanken oder Clearingstellen veröffentlicht werden. Der Bankdatenimport kann für das Einrichten einer neuen OLTP-Datenbank, aber auch für die regelmäßige Aktualisierung von Bankdaten verwendet werden. Dabei werden die Neuanlage, das Ändern und das Löschen der Bankdaten sowie Nachfolge- und Fusionsankündigungen unterstützt.
Die Anwendung kann einmal für jede OLTP-Datenbank und jedes Land gestartet werden.
Parameter
Die Hintergrund-Anwendung Bankdaten importieren hat die folgenden Parameter.
- Land – Wählen Sie das Land aus, für das die Bankdaten importiert werden sollen. Folgende Auswahlmöglichkeiten bestehen:
- Deutschland
- Österreich
- Schweiz
- Datenlieferant und Format – Wählen Sie aus, von welcher Zentralbank oder Clearingstelle die Bankdaten verwendet werden sollen. Die folgenden Datenlieferanten und Formate stehen zur Verfügung:
- Deutsche Bundesbank, ASCII-Text, feste Satzlänge
- Österreichische Nationalbank, CSV-Text
- SIX Interbank Clearing, ASCII-Text, feste Satzlänge
- Bankidentifikation – Legen Sie fest, welche Identifikationsnummer für die importierten Banken verwendet werden soll. Folgende Auswahlmöglichkeiten bestehen:
- Identifikation beim Datenlieferanten
- Nationale Bankidentifikation erweitert um Filialidentifikation
Wenn die nationale Bankidentifikation in mehreren Einträgen der Import-Datei enthalten ist, dann wird sie um die Identifikation der Bankfiliale erweitert.
- Importumfang – Legen Sie fest, welche Bankdaten aus der Quell-Datei importiert werden sollen. Folgende Auswahlmöglichkeiten bestehen:
- Geänderte Banken
- Gelöschte Banken
- Neue Banken
- Nicht geänderte Banken
Sie können den Importumfang nur dann festlegen, wenn der Datenlieferant Informationen über den Änderungsstatus bereitstellt. Andernfalls ist das Feld nicht eingabebereit.
- Nur Bankzentralen (Checkbox) – Mit dieser Funktion legen Sie fest, ob nur die Bankdaten der bankleitzahlführenden Bankzentralen importiert werden. Wenn die Funktion deaktiviert ist, dann werden auch die Bankdaten der zugehörigen Filialen importiert. Für den Zahlungsverkehr sind nur die Bankzentralen maßgeblich.
- Kodierungsart – Geben Sie eine vorhandene Kodierungsart ein. Die Kodierungsarten werden in der Anwendung Kodierungsarten erfasst.
Wenn die Bankidentifikation beim Datenlieferanten einen Regionencode vorsieht, dann wird die Kodierungsart zur Ermittlung dieses Codes verwendet. - Abgrenzungspräfix – Geben Sie ein Präfix an, das der Bankidentifikation vorangestellt wird. Mit diesem Präfix können Sie z. B. automatisch importierte Bankdaten von manuell erfassten abgrenzen
- Download-Adresse – Geben Sie die vollständige URL ein, unter der die Bankdatendatei des Datenlieferanten heruntergeladen werden kann
Rubrik Import
- Dateipfad und -name – Wenn Sie eine Download-Adresse eingegeben haben, dann tragen Sie den Dateipfad zu dem Verzeichnis ein, in das die heruntergeladene Datei abgelegt werden soll.
Wenn Sie keine Download-Adresse eingegeben haben, dann geben Sie den Pfad und den Namen der Datei ein, die importiert werden soll. Geben Sie den Pfad nach folgendem Schema ein: file:/// oder kstore://. - Filter – Geben Sie einen Filter für den automatischen Import ein. Der Filter muss für das Business Entity
com.cisag.app.fincancials.obj.Bankgelten.
Die Anwendung unterstützt nur Filter mit der Spracheinstellung Einsprachig. Wenn Sie keinen Filter eingeben, dann wird der Standard-Filter für dieses Business Entity mit allen Attributen, der Spracheinstellung Einsprachig und dem Zeitformat Kompakte Form verwendet. - Warnungen – Legen Sie fest, wie auftretende Warnungen während des Importvorgangs behandelt werden sollen
- Bei erfolgtem Import – Legen fest, ob die Quell-Datei nach dem Import gelöscht wird. Folgende Auswahlmöglichkeiten bestehen:
- Quell-Datei belassen – Die Quell-Dateien werden nach dem Import nicht gelöscht
- Quell-Datei löschen, bei Abbruch belassen – Die Quell-Dateien werden nach dem Import gelöscht. Wenn der Import abbricht, bevor die Quell-Datei vollständig verarbeitet wurde oder ein Fehler beim Erzeugen der Fehler-Datei auftritt, dann wird die Quell-Datei nicht gelöscht.
- Protokollierungsstufe – Legen Sie fest, ob die Protokollierung während des Importvorgangs eingeschaltet wird. Folgende Auswahlmöglichkeiten bestehen:
- Keine Protokollierung
- Protokollierung aktiviert
Rubrik Import-Fehlerbehebung
- Fehler-Datei – Geben Sie einen Namen für die Fehler-Datei ein.
Sie können die Fehler-Datei als absolute URI mit dem Schema file:/// oder kstore:// und einem Pfad eingeben oder nur einen Dateinamen.
Wenn Sie nur einen Dateinamen eingeben, dann wird die Fehler-Datei in dem Ordner erzeugt, in dem die Quell-Datei abgelegt ist. - Korrigieren – Legen Sie fest, ob und wie die fehlerhaften Daten korrigiert werden, die in der Fehler-Datei gespeichert wurden. Folgende Auswahlmöglichkeiten bestehen:
- Nicht korrigieren
- Mit Workflow
Auf Basis des Ereignisses com.cisag.pgm.bi.ImportRunCompletedkann eine Aktivität erzeugt werden, welche die Anwendung Daten importieren öffnet. Wenn das Workflow-Management nicht aktiviert ist, dann werden die Daten nicht korrigiert.
Der Wert dieser Einstellung wird immer an den Parameter CorrectionMode des Ereignisses com.cisag.pgm.bi.ImportRunCompletedübergeben. Somit kann in einer Aktivitätsdefinition entschieden werden, ob und in welchen Fällen tatsächlich Aktivitäten erzeugt werden.
Propertys
Für die Konfiguration der Internetverbindung über einen Proxy-Server müssen folgende Java Propertys angegeben werden:
- proxyHost
- proxyPort
Wenn der Proxy eine Autorisierung erfordert, dann müssen zusätzlich folgende Propertys angegeben werden:
- proxyUser
- proxyPassword
Workflow
Gelöschte Banken
Für Banken mit dem Status Gelöscht wird ein Verwendungsnachweis ausgeführt. Wenn die Bank verwendet wird, dann wird ein Ereignis erzeugt und die betroffene Bank wird als Parameter übergeben. Wenn die Bank nicht verwendet wird, dann wird sie mit einem Löschkennzeichen versehen.
Ereignis:
com.sem.ext.app.bankimp.NationalBankIdDeleted
Parameter
- Bank – Objekt vom Typ
com.cisag.app.financials.obj.Bank
Fehler beim Import von Bankdaten
Wenn während des Imports Fehler auftreten, weil z. B. die Internetverbindung nicht aufgebaut werden kann, dann wird ein Workflow-Ereignis ausgelöst. Das Ereignis weist darauf hin, dass die Bankdaten nicht importiert werden konnten oder beim Import Fehler aufgetreten sind. Als Parameter wird das Land übergeben, für das der Import fehlgeschlagen ist.
Ereignis:
com.sem.ext.app.bankimp.BankImportFailed
Parameter
- country – Objekt vom Typ
com.cisag.app.general.obj.Country
Datenlieferanten
Österreichische Nationalbank
Die Österreichische Nationalbank stellt auf ihrer Homepage eine täglich aktualisierte Datei der in Österreich registrierten Banken zur Verfügung. Die Daten werden als gezippte CSV-Datei bereitgestellt.
Ein Datensatz besteht aus den folgenden Feldern, die durch ein Semikolon getrennt sind:
| Nr. | Bezeichnung | Inhalt | Attribut |
| 1 | Kennzeichen | Hauptanstalt, Zweigstelle, Filiale |
Hinweis Hauptanstalt entspricht der Bankzentrale |
| 2 | Identnummer | Numerisch (5-7) | Bank.bankId(20) (siehe Abschnitt Bestimmung der Bankidentifikation) |
| 3 | Bankleitzahl | Numerisch (5) | Bank.localBankIdentification(20) (siehe Abschnitt Bestimmung der Bankidentifikation) |
| 4 | Institutsart | KI, ZW, WS, leer | None |
| 5 | Sektor | Alphanumerisch | None |
| 6 | Firmenbuchnummer | Alphanumerisch | None |
| 7 | Bankenname | Alphanumerisch (80) | Bank.name (65) Hinweis Es werden nur die ersten 65 Zeichen übernommen. |
| 8 | Straße | Alphanumerisch (40) | Bank.AddressData.street(256) |
| 9 | PLZ | Numerisch (4) | Bank.AddressData.postalCode(5) |
| 10 | Ort | Alphanumerisch (40) | Bank.AddressData.city(256) |
| 11 | Postadresse / Straße | Immer leer | None |
| 12 | Postadresse / PLZ | Numerisch (4) | Bank.AddressData.poBoxPostalCode(16) |
| 13 | Postadresse / Ort | Alphanumerisch (40) | Bank.AddressData.poBoxCity(256) |
| 14 | Postfach | Numerisch (10) | Bank.AddressData.poBox(64) |
| 15 | Bundesland | Alphanumerisch (20) | Bank.AddressData.region(3) Hinweis Das Mapping erfolgt mit Hilfe einer für den Bankenimport festgelegten Kodierungsart (siehe Abschnitt Parameter) |
| 16 | Telefone | Alphanumerisch | None |
| 17 | Fax | Alphanumerisch | None |
| 18 | Alphanumerisch | None | |
| 19 | SWIFT-Code | Numerisch (8) | Bank.bic(11) |
| 20 | Homepage | Alphanumerisch | None |
| 21 | Gründungsdatum | None | |
| 22 | LEI | Alphanumerisch | Bank.mainBank(guid) Legal Entity Identifier Wird zum Mappen der Hauptanstalt verwendet |
Bank.sem_bankimp_status) ist bei allen importierten Banken Freigegeben.Bestimmung der Bankidentifikation
Abhängig von Ihrer Auswahl beim Parameter Bankidentifikation setzt sich die Bankidentifikation folgendermaßen zusammen:
- Identifikation beim Datenlieferanten: Identity number (Feld 2)
- Nationale Bankidentifikation erweitert um Filialidentifikation: National bank code (Feld 3) und erweitert um Identity number (Feld 2)
Wenn ein Abgrenzungspräfix eingegeben wurde, dann wird dieser der Bankidentifikation vorangestellt.
Deutsche Bundesbank
Die Bankleitzahlendatei wird von der Deutschen Bundesbank viermal jährlich erstellt und wird gültig zum Montag, der dem ersten Samstag in den Monaten März, Juni, September und Dezember folgt. Die Datei enthält die Daten aller gültigen und zu dem jeweiligen Abschlusstermin gelöschten Bankleitzahlen.
Als Quelle für den Bankdatenimport wird die von der Bundesbank bereitgestellte ASCII-Text-Datei mit dem folgenden Format unterstützt:
| Nr. | Inhalt | Stellen | Attribute (ggf. maximale Anzahl der Stellen) |
| 1 | Bankleitzahl | 8 | Bank.localBankIdentification(20) (siehe Abschnitt Bestimmung der Bankidentifikation) |
| 2 | Merkmal, ob bankleitzahlführender Zahlungsdienstleister („1“) oder nicht („2“) | 1 | 1: Bank.mainBank= null 2: Bank.mainBank= bankleitzahlführende Bank mit der gleichen Bankleitzahl (GUID) |
| 3 | Bezeichnung des Zahlungsdienstleisters (ohne Rechtsform) | 58 | Bank.name(65) |
| 4 | Postleitzahl | 5 | Bank.AddressData,postalCode(16) |
| 5 | Ort | 35 | Bank.AddressData.city(256) |
| 6 | Kurzbezeichnung des Zahlungsdienstleisters mit Ort (ohne Rechtsform) | 27 | Bank.shortName(40) |
| 7 | Institutsnummer für PAN | 5 | Bank.pan(5) |
| 8 | Bank Identifier Code (BIC) | 11 | Bank.bic(11) |
| 9 | Kennzeichen für Prüfzifferberechnungsmethode | 2 | None |
| 10 | Nummer des Datensatzes | 6 | Siehe Abschnitt Bestimmung der Bankidentifikation. |
| 11 | Änderungskennzeichen (bzgl. der vorherigen Datei):
|
1 | Beim Wert D wird der Status (Bank.sem_bankimp_status) zu Gelöscht geändert. In anderen Fällen ist der Status Freigegeben. |
| 12 | Hinweis auf eine beabsichtigte Bankleitzahllöschung: 0 (keine Angabe), 1 (BLZ im Feld 1 ist zur Löschung vorgesehen) | 1 | Beim Wert 1 wird der Status zu Löschung angekündigt geändert. |
| 13 | Hinweis auf Nachfolge-Bankleitzahl. Das Feld enthält entweder den Wert 00000000 (Bankleitzahl ist nicht zur Löschung vorgesehen oder der Zahlungsdienstleister hat keine Nachfolge-Bankleitzahl veröffentlicht) oder die Nachfolge-Bankleitzahl. | 8 | Bank.sem_bankimp_succeedingBank (guid), wenn das Feld eine Bankleitzahl (ungleich 00000000) enthält |
Bestimmung der Bankidentifikation
Abhängig von Ihrer Auswahl beim Parameter Bankidentifikation setzt sich die Bankidentifikation folgendermaßen zusammen:
- Identifikation beim Datenlieferanten – Nummer des Datensatzes (Feld 10)
- Nationale Bankidentifikation erweitert um Filialidentifikation – Bankleitzahl (Feld 1) und bei Filialen erweitert um die Nummer des Datensatzes (Feld 10)
Wenn ein Abgrenzungspräfix eingegeben wurde, dann wird dieser der Bankidentifikation vorangestellt.
SIX Interbank Clearing
Die Schweizer Nationalbank (SNB) stellt auf der Homepage der SIX Interbank Clearing die in der Schweiz registrierten Bankleitzahlen zur Verfügung.
Als Quelle für den Bankdatenimport wird eine ASCII-Text-Datei mit dem folgenden Format unterstützt:
| Nr. | Bezeichnung | Inhalt | Attribute |
| 1 | Bank group | Numerisch, 1-9 | None |
| 2 | Bank clearing number (bcn) | Numerisch, 3-5 Stellen | Bank.localBankIdentification(20) (siehe Abschnitt Bestimmung der Bankidentifikation) |
| 3 | Subsidiary number | Numerisch, 0000= Bankzentrale | Siehe Abschnitt Bestimmung der Bankidentifikation |
| 4 | New bank clearing number (new bcn) | Numerisch, 3-5 Stellen; wenn nicht leer, dann wurde Bankidentifikation aus Feld 2 mit der angegebenen ersetzt | Bank.sem_bankimp_succeedingBank(guid)= New bank clearing number+0000 Der Status der Bank wird zu Nachfolge/Fusion angekündigt geändert, wenn das Feld nicht leer ist. Andernfalls wird der Status auf Freigegeben gesetzt. |
| 5 | SIC number | Numerisch | None |
| 6 | Headquarter bcn | Numerisch | Bank.mainBank(guid)= Headquarter bcn+0000 |
| 7 | Bank clearing type | 1= Hauptsitz 2= Zentrale 3= Filiale |
1: Bank.mainBank= null 2/3: Bank.mainBank= Headquarter bcn+0000 (guid) |
| 8 | Record is valid from | Datum | None |
| 9 | Clearing participation code for CHF | Numerisch | None |
| 10 | Clearing participation code for EUR | Numerisch | None |
| 11 | Language code for short description and name | 1= Deutsch 2= Französisch 3= Italienisch |
None |
| 12 | Short description | Alphanumerisch (15) | Bank.shortName(40) |
| 13 | Name | Alphanumerisch (60) | Bank.name(65) |
| 14 | Street | Alphanumerisch (35) | Bank.AddressData.street(256) |
| 15 | Post box | Alphanumerisch (35) | Bank.AddressData.poBox(256) |
| 16 | Postal code | Numerisch (10) | Bank.AddressData.postalCode(16) |
| 17 | Place (City) | Alphanumerisch (35) | Bank.AddressData.city(256) |
| 18 | Telephone | Alphanumerisch | None |
| 19 | Telefax | Alphanumerisch | None |
| 20 | International dialling code | Alphanumerisch | None |
| 21 | Iso country code | Alpha, nur Ausland, z. B. AT, DE, GB, LI; leer= CH |
Bank.AddressData.Country.isoCode Beim Import werden nur die schweizerischen Banken übernommen. |
| 22 | Post account number | Alphanumerisch | None |
| 23 | SWIFT code (international bic) | Alphanumerisch, nur für Hauptsitze und Zentralen (14) | Bank.bic(11) |
Gelöschte Banken können aus der Datei nicht oder nur implizit abgelesen werden, die Bankenclearingnummer wird ggf. zu 00000 geändert. Die Bankdaten bleiben in der Regel bis zu 2 Jahre erhalten.
Bestimmung der Bankidentifikation
Abhängig vom Parameter Bankidentifikation setzt sich die Bankidentifikation folgendermaßen zusammen:
- Identifikation beim Datenlieferanten – Bank clearing number (Feld 2) +Subsidiary number (Feld 3)
- Nationale Bankidentifikation erweitert um Filialidentifikation Bank clearing number (Feld 2) erweitert um Subsidiary number (Feld 3)
Wenn ein Abgrenzungspräfix eingegeben wurde, dann wird dieser der Bankidentifikation vorangestellt.
Customizing
Für die Anwendung Bankdaten importieren ist in der Anwendung Customizing die folgende Einstellung in der Funktion Bankdatenimport relevant:
- Datenlieferant und Format – Nur die ausgewählten Datenlieferanten können für den Import von Bankdaten verwendet werden.
Business Entitys
Für die Anwendung Bankdaten importieren ist das nachfolgende Business Entity relevant, das Sie beispielsweise verwenden, um
- Berechtigungen zu vergeben,
- Aktivitätsdefinitionen einzurichten oder
- Daten zu importieren oder zu exportieren
Bank
com.cisag.app.financials.obj.Bank
Berechtigungen
Berechtigungen können sowohl mithilfe der Berechtigungsrollen als auch durch die Zuordnung einer Organisation vergeben werden. Das Berechtigungskonzept können Sie in der Technischen Dokumentation Berechtigungen nachlesen.
Spezielle Fähigkeiten
Für die Anwendung Bankdaten importieren bestehen keine speziellen Fähigkeiten.
Organisations-Zuordnungen
Für die Anwendung Bankdaten importieren ist eine Organisations-Zuordnung nicht erforderlich.
Besonderheiten
Für die Anwendung Bankdaten importieren bestehen keine Besonderheiten.
Berechtigungen für Geschäftspartner
Die Anwendung Bankdaten importieren ist für Geschäftspartner nicht freigegeben.