Przegląd tematu
Krajowe banki centralne lub centra rozliczeniowe publikują dane wszystkich banków w kraju w regularnych odstępach czasu. Dane te można wykorzystać do wprowadzenia nowych banków do systemu ERP lub aktualizacji istniejących. Te dane bankowe są importowane za pomocą aplikacji działającej w tle Import danych bankowych.
Niniejszy dokument opisuje strukturę aplikacji działającej w tle Import danych bankowych.
Definicje terminów
Aplikacja w tle — jest to aplikacja, która jest wykonywana bez interakcji z użytkownikiem. Może zostać otwarta przez zadanie przetwarzania, przez wywołanie CORBA lub przez inną aplikację.
Opis aplikacji
Aplikacja w tle Import danych bankowych służy do importowania zewnętrznych danych bankowych. Źródłem mogą być pliki publikowane przez krajowe banki centralne lub centra rozliczeniowe. Import danych bankowych może być wykorzystany do utworzenia nowej bazy danych OLTP, ale także do regularnej aktualizacji danych bankowych. Obsługuje tworzenie, modyfikację i usuwanie danych bankowych, a także ogłoszenia o sukcesji i fuzji.
Aplikację można uruchomić raz dla każdej bazy danych OLTP i każdego kraju.
Parametry
Aplikacja działająca w tle Import danych bankowych ma następujące parametry.
- Kraj — w tym miejscu należy wybrać kraj, dla którego mają zostać zaimportowane dane bankowe.
Dostępne są następujące opcje:- Niemcy
- Austria
- Szwajcaria
- Dostawca danych — w tym polu należy wybrać bank centralny lub centrum rozliczeniowe, z którego mają pochodzić dane bankowe.
Dostępni są następujący dostawcy danych i formaty:-
Deutsche Bundesbank, tekst ASCII, stała długość rekordu
-
Austriacki Bank Narodowy, tekst CSV
-
SIX Interbank Clearing, tekst ASCII, stała długość rekordu
-
- Rodzaj identyfikacji kodu bankowego — w tym miejscu należy określić, który numer identyfikacyjny ma być używany dla importowanych banków.
Dostępne są następujące opcje:- Identyfikacja zewnętrzna
- Krajowy identyfikator banku i rozszerzenie o identyfikator oddziału w oddziałach
Jeśli identyfikacja banku krajowego jest zawarta w kilku wpisach pliku importu, jest ona rozszerzana o identyfikację oddziału banku.
- Zakres importu — w tym polu należy określić, które dane banku mają zostać zaimportowane z pliku źródłowego.
Dostępne są następujące opcje:-
Zmienione bank
-
Usunięte banki
-
Nowe banki
-
Banki, które się nie zmieniły
-
Zakres importu można określić tylko wtedy, gdy dostawca danych dostarczy informacje o statusie zmiany. W przeciwnym razie pole nie będzie gotowe do wprowadzenia danych.
- Tylko centralne banki — ta funkcja służy do określenia, czy importowane są tylko dane bankowe centrów bankowych, które zarządzają kodem sortowania. Jeśli funkcja jest wyłączona, importowane są również dane bankowe powiązanych oddziałów. Tylko centra bankowe są istotne dla transakcji płatniczych.
- Prefix rozliczenia — w tym miejscu można wprowadzić prefix, który zostanie umieszczony przed identyfikatorem banku. Różna prefixy pomogą w szybkim rozróżnieniu dokumentów zaimportowanych a tych wprowadzonych ręcznie.
- Kod regionu — w tym miejscu należy wprowadzić kod regionu. Jeśli identyfikacja banku u dostawcy danych zapewnia kod regionu, jest on używany do określenia tego kodu.
- Adres zapisu do pliku — w tym miejscu należy podać pełny adres URL, pod którym można pobrać plik danych bankowych dostawcy danych
Sekcja Import
- Ścieżka i nazwa pliku — jeśli wprowadzony został adres pobierania, należy wprowadzić ścieżkę do katalogu, w którym ma zostać zapisany pobrany plik. Jeśli nie wprowadzono adresu pobierania, należy wprowadzić ścieżkę i nazwę pliku do zaimportowania. Ścieżkę należy wprowadzić zgodnie z następującym schematem: „file:///” lub „kstore://”.
- Filtr importu banku — w tym miejscu należy wprowadzić filtr dla automatycznego importu. Filtr
musi być ustawiony dla podmiotu gospodarczego
com.cisag.app.fincancials.obj.Bank
Aplikacja obsługuje tylko filtry z ustawieniem języka Jeden język. Jeśli filtr nie zostanie wprowadzony, zostanie użyty domyślny filtr dla tej jednostki biznesowej ze wszystkimi atrybutami, ustawieniem języka Jeden język i formatem czasu Forma kompaktowa. - Ostrzeżenia — określa sposób obsługi wszelkich ostrzeżeń pojawiających się podczas procesu importowania
- W przypadku poprawnego importu — określa, czy plik źródłowy ma zostać usunięty po zaimportowaniu.
Dostępne są następujące opcje:- Pozostaw plik źródłowy — pliki źródłowe nie są usuwane po zaimportowaniu
- Usuń plik źródłowy, pozostaw w przypadku anulowania — pliki źródłowe są usuwane po zaimportowaniu. Jeśli import zostanie anulowany przed pełnym przetworzeniem pliku źródłowego lub wystąpi błąd podczas tworzenia pliku błędu, plik źródłowy nie zostanie usunięty.
- Poziom protokołowania — określa, czy protokołowanie ma być włączone podczas procesu importowania. Dostępne są następujące opcje:
- Bez protokołowania
- Aktywowano protokołowanie
Sekcja Usunięcie błędu podczas importu
- Plik błędu — w tym miejscu należy wprowadzić nazwę pliku błędu. Plik błędu można wprowadzić jako bezwzględny identyfikator URI ze schematem „file:///” lub „kstore://” i rozszerzeniem. Należy wprowadzić ścieżkę lub samą nazwę pliku. Jeśli wprowadzona zostanie jedynie nazw pliku, plik błędu zostanie utworzony w folderze, w którym przechowywany jest plik źródłowy.
- Dla pliku błędów — w tym miejscu należy określić jak zapisywane są pliki.
Można wybrać jedną z dostępnych opcji:- (brak)
- Nadpisz plik błędów
- Ciągła numeracja pliku błędów
- Koryguj — Określa, czy i w jaki sposób nieprawidłowe dane zapisane w pliku błędów są korygowane.
Dostępne są następujące opcje: - Nie koryguj
- Za pomocą obiegu pracy
Na podstawie wydarzenia com.cisag.pgm.bi.ImportRunCompleted może być użyty do utworzenia aktywności, która otwiera aplikację Import danych. Jeśli zarządzanie przepływem pracy nie jest aktywowane, dane nie są korygowane.
Wartość tego ustawienia jest zawsze powiązana z parametrem CorrectionMode zdarzenia. com.cisag.pgm.bi.ImportRunCompleted Pozwala to zdecydować w definicji działania, czy i w jakich przypadkach działania są faktycznie generowane.
Właściwości
Aby skonfigurować połączenie internetowe za pośrednictwem serwera proxy, należy określić następujące właściwości Java:
- proxyHost
- proxyPort
Jeśli serwer proxy wymaga dodatkowych uprawnień, należy również określić następujące właściwości:
- proxyUser
- proxyPassword
Przepływ pracy
Usunięte banki
Dla banków o statusie Usunięty tworzona jest lista miejsc użycia. Jeśli bank jest używany, generowane jest zdarzenie, a odpowiedni bank jest przekazywany jako parametr. Jeśli bank nie jest używany, otrzymuje znacznik usuwania.
Zdarzenie:
com.sem.ext.app.bankimp.NationalBankIdDeleted
Parametry
Bank — obiekt typu:
com.cisag.app.financials.obj.Bank
Błąd podczas importowania danych bankowych
Jeśli podczas importu wystąpią błędy, np. z powodu niemożności nawiązania połączenia internetowego, wyzwalane jest zdarzenie przepływu pracy. Zdarzenie wskazuje, że dane bankowe nie mogły zostać zaimportowane lub że wystąpiły błędy podczas importu. Kraj, dla którego import nie powiódł się, jest przekazywany jako parametr.
Zdarzenie:
com.sem.ext.app.bankimp.BankImportFailed
Parametry
Kraj — Obiekt typu:
com.cisag.app.general.obj.Country
Dostawcy danych
Austriacki Bank Narodowy
Austriacki Bank Narodowy udostępnia codziennie aktualizowany plik banków zarejestrowanych w Austrii na swojej stronie internetowej. Dane są dostarczane jako spakowany plik CSV.
Rekord danych składa się z następujących pól oddzielonych średnikiem:
Nie. |
Oznaczenie |
Zawartość |
Atrybut |
1 |
Tablica rejestracyjna |
Główna instytucja, Oddział, Oddział |
Uwaga Główna instytucja odpowiada głównej siedzibie banku. |
2 |
Numer identyfikacyjny |
Numeryczne (5-7) |
Bank.bankId(20) (patrz Określenie identyfikacji banku) |
3 |
Kod sortowania banku |
Numeryczny (5) |
Bank.localBankIdentification(20) (patrz Określenie identyfikacji banku) |
4 |
Typ instytutu |
KI, ZW, WS, pusty |
Brak |
5 |
Sektor |
Alfanumeryczne |
Brak |
6 |
Numer w rejestrze spółek |
Alfanumeryczne |
Brak |
7 |
Nazwa banku |
Alfanumeryczne (80) |
Bank.name (65) Uwaga Przesyłanych jest tylko pierwszych 65 linii. |
8 |
ul. |
Alfanumeryczne (40) |
Bank.AddressData.street(256) |
9 |
KOD POCZTOWY |
Numeryczny (4) |
Bank.AddressData.postalCode(5) |
10 |
Miejsce |
Alfanumeryczne (40) |
Bank.AddressData.city(256) |
11 |
Adres pocztowy / ulica |
Zawsze pusty |
Brak |
12 |
Adres pocztowy / kod pocztowy |
Numeryczny (4) |
Bank.AddressData.poBoxPostalCod e(16) |
13 |
Adres pocztowy / lokalizacja |
Alfanumeryczne (40) |
Bank.AddressData.poBoxCity(256) |
14 |
Skrytka pocztowa |
Numeryczny (10) |
Bank.AddressData.poBox(64) |
15 |
Państwo federalne |
Alfanumeryczne (20) |
Bank.AddressData.region(3) Uwaga Mapowanie jest przeprowadzane przy użyciu typu kodowania zdefiniowanego dla importu banku (patrz Parametr) |
16 |
Telefony |
Alfanumeryczne |
Brak |
17 |
faks |
Alfanumeryczne |
Brak |
18 |
|
Alfanumeryczne |
Brak |
19 |
Kod SWIFT |
Numeryczny (8) |
Bank.bic(11) |
20 |
Strona główna |
Alfanumeryczne |
Brak |
21 |
Data założenia |
|
Brak |
22 |
LEI |
Alfanumeryczne |
Bank.mainBank(guid) Identyfikator podmiotu prawnego biura |
Określenie identyfikacji banku
W zależności od wyboru w parametrze Rodzaj identyfikacji kodu bankowego, identyfikacja banku odbywa
się w następujący sposób:
- Identyfikacja zewnętrzna — Numer identyfikacyjny (pole 2)
- Krajowy identyfikator banku i rozszerzenie o identyfikator oddziału w oddziałach — Kod banku krajowego (pole 3) i rozszerzona o Numer identyfikacyjny (pole 2)
Jeśli wprowadzono prefiks memoriałowy, jest on umieszczany przed identyfikatorem banku.
Niemiecki Bundesbank
Plik kodów banku jest tworzony przez Niemiecki Bundesbank cztery razy w roku i staje się ważny w poniedziałek następujący po pierwszej sobocie w marcu, czerwcu, wrześniu i grudniu. Plik zawiera dane wszystkich ważnych i anulowanych kodów sortowania banków w odpowiedniej dacie zamknięcia.
Plik tekstowy ASCII dostarczony przez Bundesbank w następującym formacie jest obsługiwany jako źródło importu danych bankowych:
Nie. |
Zawartość |
Praca |
Atrybuty (maksymalna liczba cyfr, jeśli dotyczy) |
1 |
Kod sortowania banku |
8 |
Bank.localBankIdentification(20 ) (patrz Określenie identyfikacji banku) |
2 |
Cecha, czy dostawca usług płatniczych posiada bankowy numer rozliczeniowy (1) czy nie (2). |
1 |
1: Bank.mainBank= null 2: Bank.mainBank= wiodący bank z tym samym kodem banku (GUID) |
3 |
Nazwa dostawcy usług płatniczych (bez formy prawnej) |
58 |
Bank.name(65) |
4 |
Kod pocztowy |
5 |
Bank.AddressData,postalCode( 16) |
5 |
Lokalizacja |
35 |
Bank.AddressData.city(256) |
6 |
Skrócona nazwa dostawcy usług płatniczych wraz z lokalizacją (bez formy prawnej) |
27 |
Bank.shortName(40) |
7 |
Numer instytutu dla PAN |
5 |
Bank.pan(5) |
8 |
Kod identyfikacyjny banku (BIC) |
11 |
Bank.bic(11) |
9 |
Wskaźnik metody obliczania cyfry kontrolnej |
2 |
Brak |
10 |
Numer rekordu danych |
6 |
|
11 |
Wskaźnik zmiany (w odniesieniu do poprzedniego pliku):
|
1 |
Jeśli wartość wynosi D, status (Bank.sem_bankimp_status) jest zmieniany na Usunięty. W innych przypadkach status Zwolniony. |
12 |
Odniesienie do zamierzonego usunięcia kodu sortowania: 0 (brak wpisu), 1 (kod sortowania w polu 1 jest przeznaczony do usunięcia). |
1 |
Jeśli wartość wynosi 1, status zostanie zmieniony na Ogłoszono anulowanie. |
13 |
Odniesienie do kodu sortowania banku następcy. Pole zawiera albo wartość 00000000 (numer rozliczeniowy banku nie jest przeznaczony do anulowania lub dostawca usług płatniczych nie opublikował numeru rozliczeniowego kolejnego banku) lub numer rozliczeniowy kolejnego banku. |
8 |
Bank.sem_bankimp_succeedin gBank (guid), jeśli pole zawiera kod banku (różny od 00000000) zawiera |
Określenie identyfikacji banku
W zależności od wyboru w parametrze Rodzaj identyfikacji kodu bankowego, identyfikacja banku odbywa się w następujący sposób:
- Identyfikacja zewnętrzna — Numer rekordu danych (pole 10)
- Krajowy identyfikator banku i rozszerzenie o identyfikator oddziału w oddziałach — Kod banku (pole 1), a w przypadku oddziałów rozszerzona o Numer rekordu danych (pole 10).
Jeśli wprowadzono prefiks memoriałowy, jest on umieszczany przed identyfikatorem banku.
SIX Interbank Clearing
Szwajcarski Bank Narodowy (SNB) udostępnia kody sortowania banków zarejestrowanych w Szwajcarii na stronie głównej SIX Interbank Clearing.
Plik tekstowy ASCII w następującym formacie jest obsługiwany jako źródło
importu danych bankowych:
Nie. |
Oznaczenie |
Zawartość |
Atrybuty |
1 |
Grupa banków |
Numeryczny, 1-9 |
Brak |
2 |
Numer rozliczeniowy banku (bcn) |
Numeryczny, 3-5 cyfr |
Bank.localBankIdentification(20) (patrz Określenie identyfikacji banku) |
3 |
Numer jednostki zależnej |
Numeryczny, „0000”= centrum banku |
|
4 |
Nowy bankowy numer rozliczeniowy (nowy bcn) |
Numeryczny, 3- 5 cyfr; jeśli nie jest pusty, identyfikator banku z pola 2 został zastąpiony określonym identyfikatorem. |
Bank.sem_bankimp_succeedingB ank(guid)= „Nowy numer rozliczeniowy banku „+0000 Status banku zostaje zmieniony na Ogłoszono sukcesję/fuzję, jeśli pole nie jest puste. W przeciwnym razie status zostanie ustawiony na Zwolniony. |
5 |
Numer SIC |
Numeryczne |
Brak |
6 |
Siedziba bcn |
Numeryczne |
Bank.mainBank(guid)=”Headqua rter bcn „+0000 |
7 |
Typ rozliczenia bankowego |
1 = Centrala 2 = Centrum 3 = Oddział |
1: Bank.mainBank= null 2/3: Bank.mainBank=”Head- quarter bcn „+0000 (guid) |
8 |
Rekord jest ważny od |
data |
Brak |
9 |
Kod uczestnictwa w rozliczeniu dla CHF |
Numeryczne |
Brak |
10 |
Kod uczestnictwa w rozliczeniach dla EUR |
Numeryczne |
Brak |
11 |
Kod języka dla krótkiego opisu i nazwy |
1= niemiecki 2= francuski 3= Włoski |
Brak |
12 |
Krótki opis |
Alfanumeryczne (15) |
Bank.shortName(40) |
13 |
Nazwa |
Alfanumeryczne (60) |
Bank.name(65) |
14 |
ul. |
Alfanumeryczne (35) |
Bank.AddressData.street(256) |
15 |
Skrzynka pocztowa |
Alfanumeryczne (35) |
Bank.AddressData.poBox(256) |
16 |
Kod pocztowy |
Numeryczny (10) |
Bank.AddressData.postalCode(16 ) |
17 |
Miejsce (miasto) |
Alfanumeryczne (35) |
Bank.AddressData.city(256) |
18 |
Telefon |
Alfanumeryczne |
Brak |
19 |
Faks |
Alfanumeryczne |
Brak |
20 |
Międzynarodowy kodeks dynamiki |
Alfanumeryczne |
Brak |
21 |
Kod kraju ISO |
Alfa, tylko obcy kraj, np. „AT”, „DE”, „GB”, „LI”; empty=”CH” |
Bank.AddressData.Country.isoCo de Tylko szwajcarskie banki są akceptowane do importu. |
22 |
Numer konta pocztowego |
Alfanumeryczne |
Brak |
23 |
Kod SWIFT (międzynarodowy kod BIC) |
Alfanumeryczne, tylko dla centrali i centrów kontroli (14) |
Bank.bic(11) |
Usuniętych banków nie można odczytać z pliku lub można je odczytać tylko niejawnie; numer rozliczeniowy banku można zmienić na 00000. Dane banku są zazwyczaj przechowywane przez okres do 2 lat.
Określenie identyfikacji banku
W zależności od wyboru w parametrze Rodzaj identyfikacji kodu bankowego, identyfikacja banku odbywa się w następujący sposób:
- Identyfikacja zewnętrzna — Numer rekordu danych (pole 10)
- Krajowy identyfikator banku i rozszerzenie o identyfikator oddziału w oddziałach —
- Numer rozliczeniowy banku (pole 2) rozszerzony o Numer filii (pole 3)
Jeśli wprowadzono prefiks memoriałowy, jest on umieszczany przed identyfikatorem banku.
Konfiguracja
Dla aplikacji Import danych bankowych istotne są następujące ustawienia pól w funkcji Import danych bankowych w aplikacji Konfiguracja:
- Dostawca danych/Format – tylko wybrani dostawcy danych mogą być wykorzystywani do importowania danych bankowych
Jednostki biznesowe
Jednostka biznesowa Bank — com.cisag.app.financials.obj.Bank — wykorzystywana jest przez aplikację Import danych bankowych między innymi w celu:
- Przyporządkowywania uprawnień
- Definiowania działań
- Importu i eksportu danych
Uprawnienia
Uprawnienia mogą zostać przypisane za pomocą ról uprawnień jak również poprzez przyporządkowanie organizacji. Szczegółowe informacje można znaleźć w artykule Uprawnienia.
Uprawnienia specjalne
Dla aplikacji Import danych bankowych nie ma dostępnych uprawnień specjalnych.
Funkcje specjalne
Dla aplikacji Import danych bankowych nie są dostępne funkcje specjalne.
Uprawnienia dla partnerów biznesowych
Aplikacja Import danych bankowych nie jest udostępniana partnerom biznesowym.