Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Import i eksport danych w GB24 bankowość zabezpieczona kartą mikroprocesorową Spis treści: 1. Wstęp .................................................................................................................................................................3 2. Struktura i organizacja dokumentu ....................................................................................................................3 3. Opis funkcji importu i eksportu danych..............................................................................................................3 3.1 3.1.1 Import przelewów zwykłych................................................................................................................3 3.1.2 Import przelewów ZUS ........................................................................................................................4 3.1.3 Import przelewów podatku.................................................................................................................4 3.1.4 Import przelewów zagranicznych ........................................................................................................5 3.1.5 Import listy płac ..................................................................................................................................6 3.1.6 Import kontrahentów..........................................................................................................................7 3.1.7 Import dyspozycji sum depozytowych.................................................................................................7 3.2 4. Funkcje importu danych..............................................................................................................................3 Funkcje eksportu danych ............................................................................................................................8 3.2.1 Eksport statusów przelewów ..............................................................................................................8 3.2.2 Eksport listy wyciągów ........................................................................................................................9 3.2.3 Eksport listy operacji bieżących.........................................................................................................10 Formaty danych i struktury plików ...................................................................................................................10 4.1 Formaty danych ........................................................................................................................................10 4.2 Struktury plików .......................................................................................................................................11 4.2.1 Struktury plików importu przelewów zwykłych, ZUS oraz podatku...................................................11 4.2.1.1 Plik w formacie XML....................................................................................................................11 4.2.1.2 Plik w formacie Elixir ...................................................................................................................13 4.2.1.3 Plik w formacie liniowym ............................................................................................................17 4.2.1.4 Plik w formacie Telekonto...........................................................................................................19 4.2.1.5 Plik w formacie VideoTel.............................................................................................................20 4.2.1.6 Plik w formacie Płatnik................................................................................................................24 1 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA 4.2.2 Struktury plików importu przelewów zagranicznych.........................................................................27 4.2.2.1 Plik w formacie liniowym ............................................................................................................27 4.2.2.2 Plik w formacie XML....................................................................................................................28 4.2.3 Struktura pliku importu listy płac......................................................................................................29 4.2.3.1 Plik w formacie Termit ................................................................................................................29 4.2.3.2 Plik w formacie Elixir ...................................................................................................................30 4.2.3.3 Plik w formacie XML....................................................................................................................32 4.2.3.4 Plik w formacie VideoTel.............................................................................................................32 4.2.3.5 Plik w formacie Telekonto...........................................................................................................34 4.2.3.6 Plik w formacie liniowym ............................................................................................................34 4.2.4 Struktura pliku importu dyspozycji sądowych.............................................................................36 4.2.4.1 4.2.5 Plik w formacie XML...............................................................................................................36 Struktury plików importu kontrahentów ..........................................................................................40 4.2.5.1 Plik w formacie liniowym ............................................................................................................40 4.2.5.2 Plik w formacie XML....................................................................................................................41 4.2.5.3 Plik w formacie Telekonto...........................................................................................................42 4.2.5.4 Plik w formacie VideoTel.............................................................................................................42 4.2.6 Struktura plików eksportu statusów przelewów ...............................................................................44 4.2.6.1 Format liniowy ............................................................................................................................44 4.2.6.2 Format XML ................................................................................................................................45 4.2.7 Struktura plików eksportu listy wyciągów.........................................................................................46 4.2.7.1 Format liniowy ............................................................................................................................46 4.2.7.2 Format XML ................................................................................................................................47 4.2.7.3 Format MT940 (SWIFT) ...............................................................................................................47 4.2.8 Struktura plików eksportu operacji bieżących .........................................................................................50 4.2.8.1 Format liniowy ............................................................................................................................50 4.2.8.2 Format XML ................................................................................................................................51 5. Konfiguracja parametrów aplikacji .........................................................................................52 2 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA 1. Wstęp Dokument dotyczy funkcjonalności systemu w zakresie importu i eksportu danych w aplikacji GB24 zabezpieczonej kartą mikroprocesorową. Opisuje dostępne opcje w systemie oraz sposób ich wykorzystania. Zawiera także opis formatów danych, jak i struktury importowanych oraz eksportowanych plików. 2. Struktura i organizacja dokumentu Dokumentacja zawiera w kolejnych punktach opis funkcji importu i eksportu danych, sposobu ich wykorzystywania i parametryzacji oraz dostępne formaty i struktury plików. Dokument można czytać w naturalnej kolejności bądź sięgać do opisu odpowiedniej funkcji w zależności od potrzeb. 3. Opis funkcji importu i eksportu danych W systemie GB24 dostępne są następujące operacje dotyczące importu i eksportu danych: · import przelewów zwykłych, · import przelewów ZUS, · import przelewów podatku, · import przelewów zagranicznych, · import kontrahentów, · import listy płac, · import sum depozytowych, · eksport statusów przelewów, · eksport listy wyciągów, · eksport listy operacji bieżących. 3.1 Funkcje importu danych 3.1.1 Import przelewów zwykłych Import przelewów zwykłych dostępny jest w opcji Przelewy -> Import przelewów. Po wybraniu opcji importu pojawia się okienko z możliwością wybrania pliku z danymi. Po wybraniu pliku z danymi i kliknięciu przycisku [Importuj plik], plik jest sprawdzany pod względem zgodności z ustaloną strukturą i zapisywany w bazie danych. Kolejne okno informuje o sprawdzeniu pliku. W przypadku wystąpienia błędów w pliku z danymi przelewów system poinformuje o tym fakcie stosownymi komunikatami. 3 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Kliknięcie przycisku [Zapisz poprawne przelewy] spowoduje zapisanie danych. Przycisk [Nie zapisuj przelewów] anuluje całą akcję i usuwa plik z danymi z bazy danych. 3.1.2 Import przelewów ZUS Import przelewów ZUS dostępny jest w opcji Przelewy -> Import przelewów ZUS. Po wybraniu opcji importu pojawia się okienko z możliwością wybrania pliku z danymi. Po wybraniu pliku z danymi i kliknięciu przycisku [Importuj plik], plik jest sprawdzany pod względem zgodności z ustaloną strukturą i zapisywany w bazie danych. Kolejne okno informuje o sprawdzeniu pliku. W przypadku wystąpienia błędów w pliku z danymi przelewów system poinformuje o tym fakcie stosownymi komunikatami. Podczas importu przelewów ZUS możliwe jest zapisanie danych płatników. Kliknięcie przycisku [Zapisz poprawne: przelewy i płatników] spowoduje zapisanie danych przelewów i płatników. Przycisk [Zapisz tylko poprawne przelewy] spowoduje zapisanie danych przelewów. Przycisk [Nie zapisuj przelewów i płatników] anuluje całą akcję i usuwa plik z danymi z bazy danych. 3.1.3 Import przelewów podatku Import przelewów podatku dostępny jest w opcji Przelewy -> Import przelewów podatku. Po wybraniu opcji importu pojawia się okienko z możliwością wybrania pliku z danymi. Po wybraniu pliku z danymi i kliknięciu przycisku Importuj plik, plik jest sprawdzany pod względem zgodności z ustaloną strukturą i zapisywany w bazie danych. Kolejne okno informuje o sprawdzeniu pliku. W przypadku wystąpienia błędów w pliku z danymi przelewów system poinformuje o tym fakcie stosownymi komunikatami. 4 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Podczas importu przelewów podatku możliwe jest zapisanie danych zobowiązanych. Import danych zobowiązanych wykonywany jest tylko dla poprawnie zaimportowanych przelewów. Kliknięcie przycisku [Zapisz poprawne: przelewy i zobowiązanych] spowoduje zapisanie danych przelewów i zobowiązanych. Przycisk [Zapisz tylko poprawne przelewy] spowoduje zapisanie danych przelewów. Przycisk [Nie zapisuj przelewów i zobowiązanych] anuluje całą akcję i usuwa plik z danymi z bazy danych. 3.1.4 Import przelewów zagranicznych Import przelewów zagranicznych dostępny jest w opcji Przelewy -> Import przelewów zagranicznych. Po wybraniu opcji importu pojawia się okienko z możliwością wybrania pliku z danymi. Po wybraniu pliku z danymi i kliknięciu przycisku Importuj plik, plik jest sprawdzany pod względem zgodności z ustaloną strukturą i zapisywany w bazie danych. Kolejne okno informuje o sprawdzeniu pliku. W przypadku wystąpienia błędów w pliku z danymi przelewów system poinformuje o tym fakcie stosownymi komunikatami. Kliknięcie przycisku [Zapisz poprawne przelewy] spowoduje zapisanie danych. Przycisk [Nie zapisuj przelewów] anuluje całą akcję i usuwa plik z danymi z bazy danych. W przypadku, gdy wśród importowanych przelewów zagranicznych znajdują się przelewy podlegające wymogom projektu Ustawy o Usługach Płatniczych wynikającej z dyrektywy PSD (waluta oraz kraj kontrahenta przynależy do koszyka PSD) użytkownik w przypadku próby importu przelewów z opcją BEN zostanie poinformowany o tym fakcie komunikatem o następującej treści: Pole 71A Koszty i prowizje zawiera niedozwoloną wartość. Dozwolone są tylko opcje SHA lub OUR. Pozostałe przelewy nie podlegające wymogom PSD zostaną zaimportowane. 5 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA 3.1.5 Import listy płac Import listy płac dostępny jest w opcji Przelewy -> Import listy płac. Po wybraniu opcji importu pojawia się okienko z możliwością wybrania pliku z danymi. Po wypełnieniu pól tytułem i referencje oraz wyborze pliku z listą płac i kliknięciu przycisku [Importuj plik], w pierwszej kolejności plik sprawdzany jest pod względem zgodności z ustaloną strukturą. Następnie wykonywana jest walidacja danych zawartych w pliku. W przypadku błędów lista płac nie zostanie zaimportowana, natomiast wyświetlony zostanie Raport z importu listy płac. Raport zawiera informacja o wystąpieniu błędu oraz o numerze linii, w której ten błąd występuje. W przypadku poprawnej akcji importu (bez błędów w pliku z listą płac), pojawi się odpowiedni komunikat o zakończeniu importu. 6 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA 3.1.6 Import kontrahentów Import kontrahentów dostępny jest w opcji Kontrahenci -> Import kontrahentów. Po wybraniu tej opcji pojawia się okienko z możliwością wybrania pliku z danymi. Po wybraniu pliku z danymi i kliknięciu przycisku [Importuj plik], plik jest sprawdzany pod względem zgodności z ustaloną strukturą i zapisywany w bazie danych. Kolejne okno informuje o sprawdzeniu pliku oraz prosi o wybranie jednego z trzech sposobów zapisu kontrahentów. Kliknięcie przycisku [Zapisz poprawnych kontrahentów] spowoduje zapisanie danych. Przycisk [Nie zapisuj kontrahentów] anuluje całą akcję i usuwa plik z danymi z bazy danych. W przypadku wystąpienia błędów w pliku z danymi kontrahentów system poinformuje o tym fakcie stosownymi komunikatami. 3.1.7 Import dyspozycji sum depozytowych Import dyspozycji sum depozytowych dostępny jest w opcji Sumy depozytowe -> Lista dyspozycji -> Import dyspozycji sądowych. Po wybraniu tej opcji pojawia się okienko z możliwością wybrania pliku z danymi. 7 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Kolejne okno informuje o sprawdzeniu pliku. W przypadku wystąpienia błędów w pliku z danymi dyspozycji sum depozytowych system poinformuje o tym fakcie stosownymi komunikatami. Kliknięcie przycisku [Zapisz poprawne dyspozycje] spowoduje zapisanie danych. Przycisk [Nie zapisuj dyspozycji] anuluje całą akcję i usuwa plik z danymi z bazy danych. 3.2 Funkcje eksportu danych 3.2.1 Eksport statusów przelewów Eksport statusów przelewów dostępny jest w opcji Przelewy lub w opcji Przelewy -> Archiwum. Po kliknięciu przycisku [Pobierz] system wyświetli komunikat: 8 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Przycisk [Otwórz] powoduje otwarcie eksportowanego pliku do podglądu. Przycisk [Zapisz] powoduje zapisanie pliku w określonej lokalizacji. Do pliku eksportowane są przelewy o statusie zrealizowane oraz odrzucone. 3.2.2 Eksport listy wyciągów Eksport listy wyciągów dostępny jest w opcji Rachunki poprzez kliknięcie w kolumnie [Wyciągi] nazwy [Lista]. Po wybraniu i wyświetleniu listy wyciągów dla zadanych kryteriów dostępne są dwie opcje: Pobierz plik z wyciągami, Pobierz plik. Opcja [Pobierz plik z wyciągami] powoduje wygenerowanie pliku z listą wszystkich wyciągów. Opcja Pobierz plik powoduje wygenerowanie pliku z listą operacji konkretnego wyciągu. Po wybraniu jednej z opcji system wyświetli komunikat. Przycisk [Otwórz] powoduje otwarcie eksportowanego pliku do podglądu. Przycisk [Zapisz] powoduje zapisanie pliku w określonej lokalizacji. 9 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA 3.2.3 Eksport listy operacji bieżących Eksport listy operacji bieżących dostępny jest w opcji Rachunki poprzez kliknięcie na kwotę w kolumnie Saldo bieżące. Po wybraniu tej opcji pojawia się okienko z informacjami o stanie rachunku, gdzie jest dostępny przycisk [Pobierz plik]. Kliknięcie przycisku [Pobierz plik] powoduje wygenerowanie pliku z listą operacji bieżących oraz wyświetlenie komunikatu. Przycisk [Otwórz] powoduje otwarcie eksportowanego pliku do podglądu. Przycisk [Zapisz] powoduje zapisanie pliku w określonej lokalizacji. 4. Formaty danych i struktury plików 4.1 Formaty danych System GB24 pozwala na import i eksport danych w różnych stałych oraz definiowanych formatach plików. Poniżej przedstawione są dostępne formaty danych przeznaczone dla importu i eksportu danych, z podziałem na poszczególne opcje systemu. Format importu przelewów zwykłych: · XML, · Eliksir, · Liniowy, · Telekonto, · Videotel. Format importu przelewów ZUS: · XML, · Płatnik, · Liniowy, 10 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA · VideoTel. Format importu przelewów podatku: · XML, · Eliksir, · Liniowy, · VideoTel. Format importu przelewów zagranicznych: · XML, · Liniowy. Format importu listy płac: · Termit, · Elixir, · XML, · VideoTel, · Telekonto, · Liniowy. Format importu kontrahentów: · XML, · Liniowy, · Telekonto, · VideoTel. Format importu sum depozytowych: · XML. Format eksportu statusów przelewów: · XML, · Liniowy. Format eksportu listy wyciągów: · XML, · Liniowy, · MT940. Format eksportu listy operacji bieżących: · XML, · Liniowy. Formaty plików XML, Eliksir, Płatnik, VideoTel, Telekonto i MT940 mają stałą określoną strukturę. Format pliku Liniowy zależy od zaimportowanej struktury z pliku SCHEMA.INI. Dla danych w formacie XML niedozwolone są następujące znaki: ‘&’, ‘<’, ‘>’. Jeśli w pliku XML wystąpią takie znaki będzie on traktowany jako niepoprawny. Dla powyższych znaków należy koniecznie zastosować następujące zamienniki: ‘&’ - &amp; ‘<’ - &lt; ‘>’ - &gt; 4.2 Struktury plików Poniżej opisane są poszczególne struktury plików obsługiwane przez system wraz dokładnym opisem każdego pola. Dla każdej struktury podany jest przykład. 4.2.1 Struktury plików importu przelewów zwykłych, ZUS oraz podatku 4.2.1.1 Plik w formacie XML Dla pliku przelewów w formacie XML dozwolone jest stosowanie następujących tagów (tekst pisany czcionką bold): <?xml version="1.0" encoding="iso-8859-2"?> <przelewy> <przelew> <rach_obc>rachunek obciążany w formacie NRB</rach_obc> 11 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA <bank>numer banku odbiorcy przelewu</bank> <rachunek>numer rachunku odbiorcy przelewu</rachunek> <nazwa>nazwa odbiorcy przelewu</nazwa> <kwota>kwota przelewu</kwota> <tresc>treść przelewu</tresc> <referencje>referencje własne klienta</referencje> <data>data przelewu (bieżąca lub przyszła)</data> </przelew> ... </przelewy> Każde powtórzenie tagów <przelew> ... </przelew> jest interpretowane przez aplikację jako nowy przelew. Przykładowy plik .xml zawierający przelewy zwykłe: <?xml version="1.0" encoding="iso-8859-2"?> <przelewy> <przelew> <rach_obc>38 1130 0007 2001 0000 4444 0003</rach_obc> <bank>10800001</bank> <rachunek>63 1080 0001 1232 1232 1154 8412</rachunek> <nazwa>Janina Test</nazwa> <kwota>123.10</kwota> <tresc>faktura nr 12345</tresc> </przelew> <przelew> <rach_obc>38 1130 0007 2001 0000 4444 0003</rach_obc> <bank>10800001</bank> <rachunek>63 1080 0001 1232 1232 1154 8412</rachunek> <nazwa>Jan Test ul. Testowa 21</nazwa> <kwota>73.12</kwota> <tresc>opłata za wynajęcie mieszkania</tresc> <referencje>referencje testowe</referencje> <data>2012-11-05</data> </przelew> </przelewy> PRZELEWY ZUS I PRZELEWY PODATKU Dla pliku przelewów ZUS i przelewów podatku w formacie XML dozwolone jest stosowanie następujących tagów (tekst pisany czcionką bold): <?xml version="1.0" encoding="iso-8859-2"?> <przelewy> <przelew> <rach_obc>rachunek obciążany w formacie NRB</rach_obc> <bank> w przypadku przelewu do ZUS numer banku ZUS w przypadku przelewu do US numer banku US </bank> <rachunek> w przypadku przelewu ZUS numer rachunku ZUS w przypadku przelewu US numer rachunku US </rachunek> <nazwa> nazwa odbiorcy przelewu w przypadku przelewu ZUS – ZUS w przypadku przelewu US – nazwa urzędu skarbowego </nazwa> <kwota> kwota na jaką przelew jest realizowany</kwota> <tresc> dla przelewu do ZUS (tekst pogrubiony jest stały): /NIP/numer nip/TI/typ identyfikatora numer identyfikatora/TWP/typ wpłaty (dozwolone wartości S, M, U, T, D, E, A, B)/DKL/deklaracja w formacie MMRRRR/NRD/numer deklaracji/DUT/numer decyzji/umowy/tyt. wyk. dla przelewu do US (tekst pogrubiony jest stały): /TI/typ identyfikatora numer identyfikatora/OKR/okres w formacie RRTXXxx, gdzie RR – rok, T – oznaczenie typu(R – rok, P – półrocze, K – kwartał, M-miesiąc, D – dekada, J – dzień), XXxx – oznaczenie półrocza, kwartału, miesiąca, miesiąca i dekady lub miesiąca i dnia/SFP/symbol formularza/TXT/identyfikacja wpłaty </tresc> <płatnik> dane płatnika/zobowiązanego (tekst o maks. długości 140 znaków, jeśli występują w nim znaki „|” – są one traktowane jako separatory wierszy i nie liczą się do długości tekstu. Separatory muszą dzielić tekst na części nie dłuższe niż 35 znaków) </płatnik> 12 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA lub <płatnik1>dane płatnika/zobowiązanego – linia1 (tekst o maksymalnej długosci 35 znaków)</platnik1> <płatnik2>dane płatnika//zobowiązanego – linia2 (tekst o maksymalnej długości 35 znaków)</platnik2> <płatnik3>dane płatnika/zobowiązanego – linia 3 (tekst o maksymalnej długości 35 znaków)</platnik3> <płatnik4>dane płatnika/zobowiązanego – linia 4 (tekst o maksymalnej długości 35 znaków)</platnik4> <referencje>referencje własne klienta</referencje> <data>data przelewu (bieżąca lub przyszła)</data> </przelew> ... </przelewy> Każde powtórzenie tagów <przelew> ... </przelew> jest interpretowane przez aplikację jako nowy przelew. Przykładowy plik .xml zawierający przelew ZUS: <?xml version="1.0" encoding="iso-8859-2" ?> <przelewy> <przelew> <rach_obc>79 1560 1108 2006 0000 1065 0002</rach_obc> <bank>10101023</bank> <rachunek>83101010230000261395100000</rachunek> <nazwa>ZUS</nazwa> <kwota>100.00</kwota> <tresc>/NIP/1111111111/TI/1AB1234567/TWP/A/DKL/062005/NRD/01/DUT/2</tresc> <platnik1>Jan Test</platnik1> <platnik2>ul. Testowa 15</platnik2> <platnik3>Warszawa</platnik3> <referencje>ZUS</referencje> <data>2012-11-09</data> </przelew> </przelewy> Przykładowy plik .xml zawierający przelew podatku: <?xml version="1.0" encoding="iso-8859-2"?> <przelewy> <przelew> <rach_obc>38 1130 0007 2001 0000 4444 0003</rach_obc> <bank>10800001</bank> <rachunek>98 1010 1078 0024 1122 2200 0000</rachunek> <nazwa>Urząd Skarbowy</nazwa> <kwota>123.10</kwota> <tresc>/TI/N8000007816|/OKR/04R/SFP/VAT-8|/TXT/podatek</tresc> <platnik>Jan Test</platnik> <referencje>Podatek</referencje> <data>2012-11-09</data> </przelew> </przelewy> 4.2.1.2 Plik w formacie Elixir PLIK Z PRZELEWAMI ZWYKŁYMI Plik z przelewami do importu jest zapisany w formacie tekstowym. Każde zlecenie przelewu zajmuje jedną linię (jeden rekord) zakończoną znakiem< CRLF>. Każdy rekord jest złożony z 17 pól. Pola są oddzielone separatorem. Separatorem jest przecinek. Pola występują w ustalonej kolejności, opisanej w części Struktura rekordu. Pola tekstowe są objęte cudzysłowami. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string “ “. Puste pola końcowe rekordu mogą zostać pominięte. Znakiem podziału linii w obrębie pola jest znak „|”. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki są kodowane w ISO 8859-2. Struktura rekordu: Rekord danych musi mieć strukturę zgodną ze strukturą pliku przecinkowego Elixir. Typy danych stosowane przy opisie pól: N – pole numeryczne, wartością jest liczba całkowita D – data w formacie RRRRMMDD, gdzie RRRR – rok, MM – miesiąc, DD – dzień (np. 20060501). C – pole tekstowe. Dozwolone znaki zgodne z wymaganiami systemu Elixir. Rozmiar pola 4*35 oznacza że pole może zawierać maksymalnie 4 linie po 35 znaków , nie wliczając znaków podziału linii. K – pole zawierające kwotę. Kwota wyrażona w groszach. Nie może zawierać żadnych separatorów dla części ułamkowej ani separatorów tysięcy. Przykład: 150 zł należy zapisać jako 15000, 10 zł 90 gr jako 1090, zapis 50 oznacza kwotę 50 gr. 13 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Do GB24 wczytywane są pola o statusie M. Pola o statusie O są pomijane przy wczytywaniu pliku do GB24. Kolejność pola w rekordzie Pole wg Elixir Format Rozmiar Status pola Pole w GB24 Opis pola w GB24 1 Typ komunikatu N 3 O - Pole pomijane przy wczytywaniu do GB24 2 Data transakcji D 8 M DATA Data zlecenia. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 3 Kwota K 15 M KWOTA Kwota zlecenia. Waluta domyślnie przyjmowana jako PLN. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 4 Nr jednostki prezentującej N 8 O - Pole pomijane przy wczytywaniu do GB24 5 Nr jednostki odbierającej N 8 O - Pole pomijane przy wczytywaniu do GB24 6 Rachunek klienta C nadawcy 34 M RACH_OBC Numer rachunku nadawcy. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 7 Rachunek klienta C adresata 34 M RACHUNEK Numer rachunku beneficjenta. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 8 Nazwa klienta nadawcy C 4*35 O - Pole pomijane przy wczytywaniu do GB24 9 Nazwa klienta adresata C 4*35 M NAZWA Nazwa beneficjenta. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 10 Numer nadawcy uczestnika pośredniego N 8 O - Pole pomijane przy wczytywaniu do GB24 11 Numer oddziału – N finalny adresat 8 M BANK Bank beneficjenta. Pole nie jest obowiązkowe, można przekazać wartość pustą. 12 Informacje dodatkowe C 4*35 M TRESC Tytuł płatności przelewu. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 13 Numer czeku C 10 O - Pole pomijane przy wczytywaniu do GB24 14 Szczegóły reklamacji C 4*35 O - Pole pomijane przy wczytywaniu do GB24 15 Dodatkowa identyfikacja spraw C 34 O - Pole pomijane przy wczytywaniu do GB24 16 Informacje międzybankowe C 16 M REFERENCJE Dodatkowy identyfikator przelewu – referencje. Pole nie jest obowiązkowe- można przekazać wartość pustą. 17 Dowolny tekst C 35 O - Pole pomijane przy wczytywaniu do GB24 Przykłady rekordów z pliku przelewów w formacie Elixir 110,20060526,10,,,"32156000132005000001720001","51101010231234567890123456","","Firma|Test",15600001,10101023 ,"Zapłata za fakturę| nr 2006-01-01","","","51","ref1-2006","" 14 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA ,20060527,2000,,,"32156000132005000001720001","48835500091234567890123456","","Zakład| Testowy| Miasto ul. Testowa 1",15600001,10101023,"Zapłata za usługę","","","51","usługa1/2006","" 110,20060527,2000,,,"32156000132005000001720001","48835500091234567890123456","","Firma Testowa SA",,83550009,"Zapłata za usługę","","","","Faktura vat 0605/12345","" 110,20060527,2000,,,"32156000132005000001720001","48835500091234567890123456","","Firma Testowa SA",,,"Usługa instalacyjna","","","","","" ,20060527,3000,,,"32156000132005000001720001","48835500091234567890123456","","Firma Testowa SA",,,"Usługa instalacyjna" PLIK Z PRZELEWAMI PODATKU Plik z przelewami podatku jest zapisany w formacie tekstowym. Każde zlecenie przelewu zajmuje jedną linię (jeden rekord) zakończoną znakiem <CRLF>. Każdy rekord jest złożony z 17 pól. Pola występują w ustalonej kolejności opisanej w części Struktura rekordu. Pola są oddzielone separatorem. Separatorem jest przecinek. Pola tekstowe są objęte cudzysłowami. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string “ “. Puste pola końcowe rekordu mogą zostać pominięte. Znakiem podziału linii w obrębie pola jest znak „|”. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki są kodowane w formacie ISO 8859-2. Struktura rekordu: Rekord danych musi mieć strukturę zgodną ze strukturą pliku przecinkowego Elixir Typy danych stosowane przy opisie pól: N – pole numeryczne, wartością jest liczba całkowita. D – data w formacie RRRRMMDD, gdzie RRRR - rok, MM - miesiąc, DD – dzień (np. 20060501). C – pole tekstowe. Dozwolone znaki zgodne z wymaganiami systemu Elixir. Rozmiar pola 4*35 oznacza że pole może zawierać maksymalnie 4 linie po 35 znaków, nie wliczając znaków podziału linii. K – pole zawierające kwotę. Kwota wyrażona w groszach. Nie może zawierać żadnych separatorów dla części ułamkowej ani separatorów tysięcy. Przykład: 150 zł należy zapisać jako 15000, 10 zł 90 gr jako 1090, zapis 50 oznacza kwotę 50 gr. Do GB24 wczytywane są pola o statusie M. Pola o statusie O są pomijane przy wczytywaniu pliku do GB24 . Kolejność pola w rekordzie Pole wg Elixir Format Rozmiar Status pola Pole w GB24 Opis pola w GB24 1 Typ komunikatu N 3 O - Pole pomijane przy wczytywaniu do GB24 2 Data transakcji D 8 M DATA Data zlecenia. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 3 Kwota K 15 M KWOTA Kwota zlecenia. Waluta domyślnie przyjmowana jako PLN. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 4 Nr jednostki prezentującej N 8 O - Pole pomijane przy wczytywaniu do GB24 5 Nr jednostki odbierającej N 8 O - Pole pomijane przy wczytywaniu do GB24 6 Rachunek klienta C nadawcy 34 M RACH_OBC Numer rachunku nadawcy. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 7 Rachunek klienta C 34 M RACHUNEK Numer rachunku 15 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA adresata dla płatności podatku. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 8 Nazwa klienta nadawcy C 4*35 O - Pole pomijane przy wczytywaniu do GB24 9 Nazwa klienta adresata C 4*35 M NAZWA Nazwa beneficjenta dla płatności podatku. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 10 Numer nadawcy uczestnika pośredniego N 8 O - Pole pomijane przy wczytywaniu do GB24 11 Numer oddziału – N finalny adresat 8 M BANK Bank beneficjenta dla płatności podatku. Pole nie jest obowiązkowe, można przekazać wartość pustą. 12 Informacje dodatkowe C 4*35 M TRESC1 Informacje o płatności podatku – typ i zawartość identyfikatora, okres za który dokonywana jest płatność, symbol formularza lub tytuł płatności, opis płatności. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 13 Numer czeku C 10 O - Pole pomijane przy wczytywaniu do GB24 14 Szczegóły reklamacji C 4*35 O - Pole pomijane przy wczytywaniu do GB24 15 Dodatkowa identyfikacja spraw C 34 O - Pole pomijane przy wczytywaniu do GB24 16 Informacje międzybankowe C 16 M REFERENCJE Dodatkowy identyfikator przelewu – referencje. Pole nie jest obowiązkowemożna przekazać wartość pustą. 17 Dowolny tekst C 35 O - Pole pomijane przy wczytywaniu do GB24 1 – Sposób wypełniania pola TRESC jest zgodny z zasadami obowiązującymi dla Elixir. W polu należy wprowadzić jednym ciągiem: Słowo kodowe /TI/, typ identyfikatora (1X) i zawartość identyfikatora (14X) Słowo kodowe /OKR/ i okres za który dokonywana jest płatność (7X) Słowo kodowe /SFP/ i symbol formularza lub płatności (7X) Słowo kodowe /TXT/ i opcjonalnie tytuł płatności (40X) Przykłady: /TI/N1111111111/OKR/06M05/SFP/VAT-7/TXT/podatek vat za m-c maj 2006 16 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA /TI/1WL1234567/OKR/06D0105/SFP/VAT-7/TXT/ Przykłady rekordów z pliku w formacie Elixir 110,20060529,300,,,"32156000132005000001720001","98101010780024112222000000",""," Urząd Skarbowy|Aleksandrów Kujawski ",15600001,10101078,"/TI/N1111111111/OKR/06R/SFP/VAT-7/TXT/podatek za m-c maj 06","","","71","podatek maj 2006","" ,20060529,400,,,"32156000132005000001720001","98101010780024112222000000",""," Urząd Skarbowy|Aleksandrów Kujawski",15600001,10101078,"/TI/N1111111111/OKR/06R/SFP/VAT-7/TXT/","","","","podatek maj 2006","" ,20060529,500,,,"32156000132005000001720001","98101010780024112222000000",""," Urząd Skarbowy|Aleksandrów Kujawski",,,"/TI/N1111111111/OKR/06R/SFP/VAT-7/TXT/","","","","","" ,20060529,500,,,"32156000132005000001720001","98101010780024112222000000",""," Urząd Skarbowy|Aleksandrów Kujawski",,,"/TI/1WL1234567/OKR/06R/SFP/VAT-7/TXT/" 4.2.1.3 Plik w formacie liniowym W formacie liniowym dane przelewów importowane są z pliku tekstowego o strukturze opisanej w pliku schema.ini. Informacja o pojedynczym przelewie zajmuje jedną linię (rekord) zakończoną znakami <CRLF>. Każda linia składa się z pól zawierających dane przelewu. Pola występują w pliku w określonej kolejności, zgodnie z opisem struktury ze schema.ini. Pola oddzielone są separatorem (określonym w pliku schema.ini) lub są stałej długości. Dopuszczalny zestaw pól opisujących przelew wraz z formatem danych dla każdego pola przedstawiono w poniższej tabeli: Typy danych stosowane przy opisie pól: N – pole numeryczne C – pole tekstowe Pole Długoś ć Typ Opis modulo 8 N konto 25 C uwaga * 11 C referencje* 35 C Referencje własne klienta 140 C Pełna nazwa kontrahenta 4x35 znaków Jeśli w polu występują znaki | - traktowane są jako separatory wierszy Zamiast pola nazwa mogą występować pola nazwa1, nazwa2, nazwa3, nazwa4 o długości 35 znaków każde nazwa Pola te stanowią numer rachunku do obciążenia. Zamiast trzech pól (rachunek w formacie modulo – konto - uwaga ) może występować pole rach_obc ( typu C ) stanowiące numer rachunku w formacie NRB Tytuł przelewu 4x35 znaków, dla przelewów ZUS: pierwsze 35 znaków: NIP drugie 35 znaków: typ identyfikatora uzupełniającego oraz identyfikator uzupełniający trzecie 35 znaków: typ wpłaty, deklaracja i nr deklaracji czwarte 35 znaków: numer decyzji/umowy/tytułu wykonawczego tresc 140 C Dla przelewów US: Po słowie kluczowym uzupełniający Po słowie kluczowym Po słowie kluczowym Po słowie kluczowym /TI/ typ identyfikatora uzupełniającego i identyfikator /OKR/ okres należności /SFP/ symbol formularza płatności /TXT/ opis zobowiązania Jeśli w polu występują znaki | - traktowane są jako separatory wierszy. Zamiast pola tresc mogą wystąpić cztery pola tresc1, tresc2, tresc3, tresc4, każde o długości 35 znaków kwota 15/2 C Kwota przelewu bank * 8 N Numer rozliczeniowy Banku rachunek 34 C Numer rachunku kontrahenta 140 C Dane płatnika/zobowiązanego Pole obecne tylko dla przelewów ZUS i przelewów podatkowych. platnik 17 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Jeśli w polu występują znaki | - traktowane są jako separatory wierszy Zamiast pola platnik mogą wystąpić cztery pola: platnik1, platnik2, platnik3, platnik4, każde o długości 35 znaków. data 10 C Data przelewu (bieżąca lub przyszła) w formacie RRRR-MM-DD *- pole nie wymagane ( dozwolona jest pusta wartość ) Przykładowy opis struktury pliku przelewów wczytany ze schema.ini [przel_lin.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=RACH_OBC Char Width 34 Col2=REFERENCJE Char Width 35 Col3=NAZWA Char Width 140 Col4=RACHUNEK Char Width 34 Col5=KWOTA Float Col6=TRESC1 Char Width 35 Col7=TRESC2 Char Width 35 Col8=TRESC3 Char Width 35 Col9=TRESC4 Char Width 35 Col10=DATA Char Width 10 Przykładowy opis struktury pliku przelewów ZUS/US wczytany ze schema.ini [przel_ZUS.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=RACH_OBC Char Width 34 Col2=REFERENCJE Char Width 35 Col3=NAZWA Char Width 140 Col4=RACHUNEK Char Width 34 Col5=KWOTA Float Col6=TRESC1 Char Width 35 Col7=TRESC2 Char Width 35 Col8=TRESC3 Char Width 35 Col9=TRESC4 Char Width 35 Col10=PLATNIK1 Char Width 35 Col11=PLATNIK2 Char Width 35 Col12=PLATNIK3 Char Width 35 Col13=PLATNIK4 Char Width 35 Col14=DATA Char Width 10 Przykład pliku importu przelewów w formacie liniowym: 85156000132005000002600001;referencje;nazwa_odb_linia1;48 8355 0009 1234 5678 3456;123,45;tytul_plat_linia1;tytul_plat_linia2;tytul_plat_linia3;tytul_platn_linia4;2010-11-25; 9012 Uwaga: Nazwy pól w opisie struktury powinny być pisane dużymi literami. Rodzaj separatora pól rekordu określa parametr Format. Format= Delimited (x) oznacza, że pola rekordu oddzielone są znakiem x – w powyższym przykładzie średnikiem. Format =FixedLength oznacza plik stałopozycyjny, w którym pola rekordu mają stałą długość. W takim przypadku konieczne jest określenie długości poszczególnych pól w opisie struktury. Parametry MaxScanRows oraz CharacterSet zostały umieszczone w opisie struktury dla zachowania zgodności ze standardem ODBC. Parametry te są ignorowane przez aplikację GB24 i w opisie struktury mogą zostać pominięte. Parametr ColNameHeader umożliwia wczytanie (wartość False) lub pominięcie podczas wczytywania (wartość True) pierwszego wiersza danych z importowanego pliku. Obecnie parametr ten może przyjmować tylko wartość False. W przypadku wpisania innej wartości dla parametru lub pominięcia go, aplikacja przyjmuje domyślną wartość parametru - False. 18 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA 4.2.1.4 Plik w formacie Telekonto Plik z przelewami do importu w formacie Telekonto jest plikiem tekstowym. Pierwsza linia pliku stanowi nagłówek. W nagłówku określany jest rodzaj danych w pliku - w przypadku importu danych przelewów należy tam umieścić tekst Zlecenia. Informacja o pojedynczym przelewie zajmuje jedną linię (jeden rekord) zakończoną znakiem <CRLF>. Każda linia pliku składa się z pól oddzielonych znakiem „|” (pionowa kreska). Pola występują w ustalonej kolejności, opisanej w poniżej załączonej tabeli. Każda linia zawiera pola wymagane (muszą być wypełnione), pola opcjonalne (wypełnione mogą być, ale nie muszą) oraz pola, które nie są wczytywane do aplikacji GB24 . Pojedyncza spacja (pomiędzy separatorami pól) oznacza pole puste. Brak tej spacji oznacza brak pola (pomimo wystąpienia separatorów || ). Puste pola końcowe rekordu mogą zostać pominięte. Polskie znaki kodowane są w ISO 8859-2. Istnieje możliwość importu danych z polskimi znakami kodowanymi w standardzie Mazovia. W takim przypadku strona kodowa musi zostać zadeklarowana w nagłówku pliku importu w postaci Zlecenia|MAZOVIA. Uwaga: Dane odbiorców przelewów wczytywanych z pliku importu muszą znajdować się w bazie odbiorców. Zestaw pól opisujących dane przelewu wraz z formatem danych: N – pole numeryczne, C – pole tekstowe, D – pole data – format MM/DD/YY, gdzie MM – miesiąc, DD – dzień YY – rok, K – pole kwoty. Kwota w formacie Zł.GR. Separatorem części ułamkowej jest separatorów, np. separatora tysięcy. Pole Długość Typ kropka. Nie należy używać żadnych innych Opis data 8 D Data operacji kwota 15/2 K Kwota operacji rach_obc 34 C Numer rachunku obciążanego rachunek 34 C Numer rachunku uznawanego tytulem1 35 C Tytuł płatności tytulem2 35 C Tytuł płatności typ przelewu** 3 C Pole pomijane przy wczytywaniu do aplikacji GB24 kod waluty** 3 C Pole pomijane przy wczytywaniu do aplikacji GB24 system rozliczeniowy** 1 C Pole pomijane przy wczytywaniu do aplikacji GB24 tytulem3* 35 C Tytuł płatności tytulem4* 35 C Tytuł płatności * - pole opcjonalne ** - pole pomijane przy wczytywaniu do aplikacji GB24 Przykład pliku importu przelewów w formacie Telekonto: Zlecenia 07/01/09|157.50|59 1560 0013 2005 0000 0215 0001|48 8355 0009 1234 5678 9012 3456|tytuł 1|tytuł 2||||tytuł 3|tytuł 4 19 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA 4.2.1.5 Plik w formacie VideoTel PLIK Z PRZELEWAMI ZWYKŁYMI Plik importu przelewów w formacie VideoTel jest plikiem tekstowym. Każde zlecenie przelewu zajmuje jedną linię (jeden rekord) zakończoną znakiem <CRLF>. Każdy rekord jest złożony z 14 pól. Pola występują w ustalonej kolejności, opisanej w tabeli zamieszczonej poniżej. Każde pole w rekordzie musi wystąpić. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string "". Poszczególne pola są oddzielone jedną i tylko jedną spacją. Pola tekstowe są objęte cudzysłowami. Jeżeli w tekście do zaimportowania ma się znaleźć cudzysłów, należy zastąpić go dwoma cudzysłowami. Znakiem podziału linii w obrębie pola są trzy znaki zapytania. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki kodowane są w standardzie ISO 8859-2 lub WINDOWS 1250. Formaty pól: N – pole numeryczne, wartością jest liczba całkowita. Zapis 10N oznacza, że pole może zawierać maksymalnie 10 cyfr. C – pole tekstowe. Zapis 3*35C oznacza że pole może zawierać maksymalnie 3 linie po 35 znaków, nie wliczając znaków podziału linii oraz licząc podwójne cudzysłowy jako jeden znak. K – pole zawierające kwotę. Kwota w formacie Zł.GR. Separatorem części ułamkowej jest kropka. Nie należy używać żadnych innych separatorów, np. separatora tysięcy. Struktura rekordu: Do aplikacji GB24 wczytywane są pola o statusie M. Pola o statusie O są pomijane przy wczytywaniu pliku do GB24 . Kolejność pola w rekordzie Nazwa pola Opis pola Format pola 35C Status pola 1 BBen Nazwa banku beneficjenta O 2 RBen1 Nazwa rachunku beneficjenta 3*35C M 3 NrBen Numer rachunku beneficjenta 34C M 4 REZ12 Klucz N O 5 KW Kwota przelewu K M 6 BNad Nazwa banku nadawcy 35C O 7 RNad Nazwa rachunku nadawcy 35C O 8 NrNad Numer rachunku nadawcy 34C M 9 REF Tytuł płatności 4*35C M 10 WAL3 Waluta przelewu 3C O 11 NF Nazwa firmy, do której mają być dopisane nowe rachunki beneficjenta, które zostaną zaimportowane wraz z 35C O 20 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA przelewami 12 DNN Nazwa beneficjenta 3*35C M 13 WL Określenie rodzaju własności firmy NF „T” jeśli firma własna, „N” jeśli firma obca O 14 REZ2 Nazwa systemu finansowego dla przelewu 35C O Uwagi: 1RBen – zawartość pola interpretowana przez aplikację jako nazwa odbiorcy przelewu 2REZ1 – pole może zawierać dowolną liczbę całkowitą np.1 3WAL – w aplikacji przyjmowana zawsze wartość PLN Przykładowy rekord danych z pliku importu przelewów w formacie VideoTel: "" "JAN KOWALSKI-ROR" "48835500091234567890123456" 0000001 206.96 "" "JANINA KOWALSKA???UL.TESTOWA "86864200023001840004460001" "ZASILENIE RACHUNKU???LIPIEC 2007" "PLN" "" "JAN KOWALSKI" "" "" 5" Plik z przelewami ZUS Plik z przelewami ZUS do importu jest zapisany w formacie tekstowym. Każde zlecenie przelewu zajmuje jedną linię (jeden rekord) zakończoną znakiem CRLF. Każdy rekord jest złożony z 14 pól. Pola występują w ustalonej kolejności, opisanej w części Struktura rekordu. Każde pole w rekordzie musi wystąpić. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string “ “. Poszczególne pola są oddzielone jedną i tylko jedną spacją. Pola tekstowe są objęte cudzysłowami. Jeżeli w tekście do zaimportowania ma się znaleźć cudzysłów, należy zastąpić go dwoma cudzysłowami. Znakiem podziału linii w obrębie pola są trzy znaki zapytania. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki są kodowane w ISO 8859-2. Formaty pól: · N – pole numeryczne, wartością jest liczba całkowita. Zapis 10N oznacza, że pole może zawierać maksymalnie 10 cyfr. · X – pole tekstowe. Zapis 3*35X oznacza że pole może zawierać maksymalnie 3 linie po 35 znaków , nie wliczając znaków podziału linii oraz licząc podwójne cudzysłowy jako jeden znak. · R – pole tekstowe zawierające numer rachunku w formacie NRB. · K – pole zawierające kwotę. Kwota w formacie Zł.GR. Separatorem części ułamkowej jest kropka. Nie należy używać żadnych innych separatorów, np. separatora tysięcy. Struktura rekordu Do GB24 wczytywane są pola o statusie M. Pola o statusie O są pomijane przy wczytywaniu pliku do GB24 . Kolejność pola w rekordzie Nazwa pola Opis pola Format pola Status pola 1 BBen Nazwa banku beneficjenta (nazwa banku, w którym prowadzony jest rachunek ZUS) 2 RBen Nazwa rachunku beneficjenta 3*35X (nazwa rachunku ZUS) O 3 NrBen Numer rachunku beneficjenta R (numer rachunku ZUS) M 4 REZ11 Klucz 35X N O O 21 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA 5 KW Kwota przelewu K M 6 BNad Nazwa banku nadawcy 35X O 7 RNad2 Dane płatnika składki ZUS 3*34 M 8 NrNad Numer rachunku nadawcy R M 9 REF3 Informacje o składce ZUS – NIP płatnika, typ i identyfikator uzupełniający, typ wpłaty, 4*35X deklaracja, numer deklaracji, numer decyzji/umowy/tytułu wykonawczego M 10 WAL4 Waluta przelewu 3X O 11 NF Nazwa firmy, do której mają być dopisane nowe rachunki beneficjenta, które zostaną zaimportowane wraz z przelewami 35X O 12 DNN5 Nazwa beneficjenta 3*35X M 13 WL Określenie rodzaju własności firmy NF „T” jeśli firma własna, „N” jeśli firma obca O 14 REZ2 Nazwa systemu finansowego dla przelewu 35C O Uwagi: 1 – REZ1 – pole może zawierać dowolną liczbę całkowitą np.1 2 – RNad – Pole podzielone na 3 podpola, każde z podpól oddzielone znakiem podziału linii wewnątrz pola czyli symbolem „???”. 3 – REF – Pole podzielone na 4 podpola, każde z podpól oddzielone znakiem podziału linii wewnątrz pola czyli symbolem „???”. Sposób wypełniania pola zgodny z Elixir: linia1 – NIP płatnika (10X) linia2 – wpisywane bez spacji: typ identyfikatora uzupełniającego (1X), identyfikator uzupełniający płatnika (14X) linia3 – wpisywane bez spacji: typ wpłaty(1X) deklaracja (RRRRMM, gdzie RRRR- rok, MM-miesiąc) nr deklaracji (2N) linia4 – numer decyzji/umowy/tytułu wykonawczego (15X) 4 – WAL – w aplikacji przyjmowana zawsze wartość PLN 5 – DNN – pole powinno zawierać wartość „ZUS”. W przypadku wprowadzenia innej wartości, aplikacja podczas wczytywania pliku zamienia ją na wartość domyślną „ZUS”. Przykładowe rekordy danych: "" "" "83101010230000261395100000" 1234567890 0.10 "" "JAN KOWALSKI???WARSZAWA" "32156000132005000001720001" "1111111111???1WL1234567???S20060101???" "" "" "ZUS" "" "" "" "" "83101010230000261395100000" 1234567890 0.10 "" "" "32156000132005000001720001" "1111111111???1WL1234567???E20060101???egz1/234" "" "" "ZUS" "" "" 22 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Plik z przelewami podatku Plik z przelewami podatku do importu jest zapisany w formacie tekstowym. Każde zlecenie przelewu zajmuje jedną linię (jeden rekord) zakończoną znakiem CRLF. Każdy rekord jest złożony z 14 pól. Pola występują w ustalonej kolejności, opisanej w części Struktura rekordu. Każde pole w rekordzie musi wystąpić. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string “ “. Poszczególne pola są oddzielone jedną i tylko jedną spacją. Pola tekstowe są objęte cudzysłowami. Jeżeli w tekście do zaimportowania ma się znaleźć cudzysłów, należy zastąpić go dwoma cudzysłowami. Znakiem podziału linii w obrębie pola są trzy znaki zapytania. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki są kodowane w ISO 8859-2. Formaty pól: · N – pole numeryczne, wartością jest liczba całkowita. · X – pole tekstowe. Zapis 3*35X oznacza że pole może zawierać maksymalnie 3 linie po 35 znaków , nie wliczając znaków podziału linii oraz licząc podwójne cudzysłowy jako jeden znak. · R – pole tekstowe zawierające numer rachunku w formacie NRB. · K – pole zawierające kwotę. Kwota w formacie Zł.GR. Separatorem części ułamkowej jest kropka. Nie należy używać żadnych innych separatorów, np. separatora tysięcy. Struktura rekordu Do aplikacji GB24 wczytywane są pola o statusie M. Pola o statusie O są pomijane przy wczytywaniu pliku do GB24 . Kolejność pola w rekordzie Nazwa pola Opis pola Format pola Nazwa banku beneficjenta (nazwa banku, w którym 35X prowadzony jest rachunek dla płatności podatkowych) Nazwa rachunku beneficjenta (nazwa rachunku dla płatności 3*35X podatkowych) Status pola 1 BBen 2 RBen 3 NrBen 4 REZ11 Klucz N O 5 KW Kwota przelewu K M 6 BNad Nazwa banku nadawcy 35X O 7 RNad2 Dane zobowiązanego 3*34X M 8 NrNad Numer rachunku nadawcy R M 9 REF3 Informacje o płatności podatku – typ i zawartość identyfikatora, okres za który 4*35X dokonywana jest płatność, symbol formularza lub tytuł płatności, opis płatności M 10 WAL4 Waluta przelewu 3X O 11 NF Nazwa firmy, do której mają być dopisane nowe rachunki beneficjenta, które zostaną zaimportowane wraz z przelewami 35X O 12 DNN Nazwa beneficjenta 3*35X M Numer rachunku beneficjenta (numer rachunku dla płatności R podatkowych) O O M 23 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA 13 WL Określenie rodzaju własności firmy NF „T” jeśli firma własna, „N” jeśli firma obca O 14 REZ2 Nazwa systemu finansowego dla przelewu 35C O Uwagi: 1 – REZ1 – pole może zawierać dowolną liczbę całkowitą np.1 2 – RNad – Pole podzielone na 3 podpola, każde z podpól oddzielone znakiem podziału linii wewnątrz pola czyli symbolem „???”. 3 – REF – Sposób wypełniania pola zgodny z Elixir. W polu należy wprowadzić jednym ciągiem: Słowo kodowe /TI/, typ identyfikatora (1X) i zawartość identyfikatora (14X) Słowo kodowe /OKR/ i okres za który dokonywana jest płatność (7X) Słowo kodowe /SFP/ i symbol formularza lub płatności (7X) Słowo kodowe /TXT/ i opcjonalnie tytuł płatności (40X) Przykłady: /TI/N1111111111/OKR/06M05/SFP/VAT-7/TXT/podatek vat za m-c maj 2006 /TI/1WL1234567/OKR/06D0105/SFP/VAT-7/TXT/ 4 – WAL – w aplikacji przyjmowana zawsze wartość PLN Przykładowe rekordy danych: "Rachunek Urzędu Skarbowego Aleksandrów Kujawski" "VAT" "98101010780024112222000000" 1234567890 100.10 "BANK TESTOWY" "PPHU TEST" "4386420002200100260534 0001" "/TI/N1111111111/OKR/06M05/SFP/VAT-7/TXT/Podatek za m-c maj 2006" "PLN" "" "Urząd Skarbowy" "" "" "" "" "98101010780024112222000000" 1234567890 200.50 "" "JAN "/TI/1WL1234567/OKR/06D0105/SFP/VAT-7/TXT/" "PLN" "" "US" "" "" "" "" "98101010780024112222000000" 1234567890 300.00 "/TI/1WL87654321/OKR/06K01/SFP/VAT-7/TXT/" "" "" "US" "" "" KOWALSKI" "" "" "43864200022001002605340001" "43864200022001002605340001" 4.2.1.6 Plik w formacie Płatnik Plik z przelewami ZUS jest zapisany w formacie tekstowym. Każde zlecenie przelewu zajmuje jedną linię (jeden rekord) zakończoną znakiem <CRLF>. Każdy rekord jest złożony z 17 pól. Pola występują w ustalonej kolejności opisanej w części Struktura rekordu. Pola są oddzielone separatorem. Separatorem jest przecinek. Pola tekstowe są objęte cudzysłowami. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string “ “. Puste pola końcowe rekordu mogą zostać pominięte. Znakiem podziału linii w obrębie pola jest znak „|”. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki są kodowane w ISO 8859-2. Struktura rekordu: N – pole numeryczne, wartością jest liczba całkowita. D – data w formacie RRRRMMDD, gdzie RRRR – rok, MM – miesiąc, DD – dzień (np. 20060501). C – pole tekstowe. Rozmiar pola 2*35 oznacza że pole może zawierać maksymalnie 2 linie po 35 znaków , nie wliczając znaków podziału linii wewnątrz pola. K – pole zawierające kwotę. Kwota wyrażona w groszach. Nie może zawierać żadnych separatorów dla części ułamkowej ani separatorów tysięcy. Przykład: 150 zł należy zapisać jako 15000, 10 zł 90 gr jako 1090, zapis 50 oznacza kwotę 50 gr. Do GB24 wczytywane są pola o statusie M. Pola o statusie O są pomijane przy wczytywaniu pliku do GB24 . 24 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Kolejność pola w rekordzie Pole wg Płatnik Format Rozmiar Status pola Pole w GB24 Opis pola w GB24 1 Typ komunikatu N 3 O - Pole pomijane przy wczytywaniu do GB24 2 Data dokumentu D 8 M DATA Data zlecenia. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 3 Kwota K 15 M KWOTA Kwota zlecenia. Waluta domyślnie przyjmowana jako PLN. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 4 Oddział banku prowadzącego rachunek płatnika składek N 8 O - Pole pomijane przy wczytywaniu do GB24 5 Oddział banku prowadzącego rachunek ZUS N 8 M BANK Numer banku prowadzącego rachunek ZUS. Pole jest wczytywane do GB24 ale nie jest polem obowiązkowym, nie musi być wypełnione. W polu BANK można przekazać wartość niepustą (aplikacja wczytuje wartość, lecz nie sprawdza jej poprawności ani nie prezentuje na formatkach ekranowych). Można również w polu przekazać wartość pustą. 6 Rachunek płatnika składek C 34 M RACH_OBC Numer rachunku nadawcy – płatnika składki ZUS. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 7 Rachunek ZUS C 34 M RACHUNEK Numer rachunku ZUS dla płatności składki. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 8 Nazwa skrócona albo nazwisko i imię płatnika składek C 2*35 M NAZWA Wartością pola powinien być tekst ”ZUS”. Wartość ta jest interpretowana jako nazwa beneficjenta zlecenia. W przypadku innej wartości w polu, aplikacja zamienia ją na wartość „ZUS” Pole obowiązkowe. 9 Nazwa odpowiedniej jednostki ZUS C 4*35 O - Pole pomijane przy wczytywaniu do GB24 10 Numer oddziału banku N 8 O - Pole pomijane przy wczytywaniu do GB24 25 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA prowadzącego rachunek płatnika składek 11 Numer oddziału prowadzącego rachunek ZUS N 8 O - Pole pomijane przy wczytywaniu do GB24 12 Informacje dodatkowe o składce dla transakcji ZUS C 4*35 M TRESC1 Informacje o składce – NIP płatnika, typ identyfikatora uzupełniającego i identyfikator uzupełniający płatnika, typ wpłaty, deklaracja i numer deklaracji, numer decyzji/umowy/tytułu wykonawczego. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 13 Numer czeku C 10 O - Pole pomijane przy wczytywaniu do GB24 14 Szczegóły reklamacji C 4*35 O - Pole pomijane przy wczytywaniu do GB24 15 Kod dokumentu C 2 O - Pole pomijane przy wczytywaniu do GB24 16 Informacje międzybankowe C 16 M REFERENCJE Dodatkowy identyfikator przelewu – referencje. Pole, o ile ma wartość niepustą, jest wczytywane do GB24 . Pole nie jest obowiązkowe- można przekazać wartość pustą. 17 Dowolny tekst C 35 O - Pole pomijane przy wczytywaniu do GB24 1 – Sposób wypełniania pola TRESC: Pole podzielone jest na 4 linie (podpola). Każde z podpól oddzielone znakiem podziału linii wewnątrz pola czyli symbolem „|”. linia1 – NIP płatnika (10X) linia2 – wpisywane bez spacji: typ identyfikatora uzupełniającego (1X), identyfikator uzupełniający płatnika (14X) linia3 – wpisywane bez spacji: typ wpłaty(1X) deklaracja (RRRRMM, gdzie RRRR – rok, MM – miesiąc) nr deklaracji (2N) linia4 – numer decyzji/umowy/tytułu wykonawczego (15X) Przykłady rekordów z pliku w formacie Płatnik 120,20060530,3000,,10101023,"32156000132005000001720001","83101010230000261395100000","ZUS","",,,"1111111111| 1WL1234567|S20060501","","","51","przelewZUS","" ,20060530,3000,,10101023,"32156000132005000001720001","83101010230000261395100000","ZUS","",,,"1111111111|1WL 1234567|S20060501","","","51","przelewZUS","" ,20060530,4010,,,"32156000132005000001720001","83101010230000261395100000","ZUS","",,,"1111111111|1WL1234567| E20060501|egz0601","","","","","" ,20060530,5075,,,"32156000132005000001720001","83101010230000261395100000","ZUS","",,,"1111111111|1WL1234567| S20060501" 26 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA 4.2.2 Struktury plików importu przelewów zagranicznych 4.2.2.1 Plik w formacie liniowym W formacie liniowym dane przelewów zagranicznych importowane są z pliku tekstowego o strukturze opisanej w pliku schema.ini. Informacja o pojedynczym przelewie zagranicznym zajmuje jedną linię (rekord) zakończoną znakami <CRLF>. Każda linia składa się z pól zawierających dane przelewu zagranicznego. Pola występują w pliku w określonej kolejności, zgodnie z opisem struktury ze schema.ini. Pola oddzielone są separatorem (określonym w pliku schema.ini). Dopuszczalny zestaw pól opisujących przelew wraz z formatem danych dla każdego pola przedstawiono w poniższej tabeli: Typy danych stosowane przy opisie pól: N – pole numeryczne C – pole tekstowe Pole rach_obc Długość 34 nr_tel Typ Opis N Numer NRB rachunku do obciążenia C Numet telefonu kontaktowego referencje* 15 C Referencje własne klienta bank_swift 8 lub 11 N BIC Code rachunek 34 N Numer rachunku beneficjenta 140 C Pełna nazwa i adres beneficjenta 4x35 znaków Jeśli w polu występują znaki | - traktowane są jako separatory wierszy. Zamiast pola nazwa mogą występować pola nazwa1, nazwa2, nazwa3, nazwa4 o długości 35 znaków każde 1 N Status dewizowy beneficjenta (rezydent - 1, nierezydent -0) C Kraj nierezydenta nazwa status_dewiz kraj_nierezyd kwota 15/2 N Kwota przelewu waluta 3 C Kod ISO waluty przelewu 140 C Tytuł przelewu 4x35 znaków. Jeśli w polu występują znaki | - traktowane są jako separatory wierszy. Zamiast pola tresc mogą występować pola tresc1, tresc2, tresc3, tresc4 o długości 35 znaków każde 3 C Oznaczenie strony pokrywającej koszty przelewu (BEN, OUR, SHA). W przypadku gdy przelew podlega regułom PSD (waluta oraz kraj kontrahenta przynależy do koszyka PSD) dla pola 71A KOSZTY I PROWIZJE dozwolona jest jedynie opcja SHA oraz OUR. 35 C Rodzaj towaru/usługi 34 N Numer NRB rachunku do obciążenia kwotą kosztów i prowizji, opcjonalne w trakcie importu powinno nastąpić aut. uzupełnienie pola zgodnie z rach_obc 280 C Informacje dodatkowe do obsługi zlecenia w Banku tresc koszty_pokrywa towar_usluga rach_obc_prow* info_dodatkowe* *- pole nie wymagane ( jest dozwolona pusta wartość ) Poniżej przedstawiono przykładowy opis struktury z pliku schema.ini definiującej plik z danymi przelewu zagranicznego. [przelewzagr.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=RACH_OBC Char Width 34 Col2=NR_TEL Char Width 20 Col3=OS_KONTAKT Char Width 30 Col4=REFERENCJE Char Width 15 Col5=BANK_SWIFT Char Width 11 Col6=RACHUNEK Char Width 34 Col7=NAZWA1 Char Width 35 27 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Col8=NAZWA2 Char Width 35 Col9=NAZWA3 Char Width 35 Col10=NAZWA4 Char Width 35 Col11=STATUS_DEWIZ Integer Col12=KRAJ_NIEREZYD Char Width 40 Col13=KWOTA Integer Col14=WALUTA Char Width 3 Col15=TRESC1 Char Width 35 Col16=TRESC2 Char Width 35 Col17=TRESC3 Char Width 35 Col18=TRESC4 Char Width 35 Col19=KOSZTY_POKRYWA Char Width 3 Col20=RACH_OBC_PROW Char Width 34 Col21=INFO_DODATKOWE Char Width 280 Uwaga: Nazwy pól w opisie struktury powinny być pisane dużymi literami. Rodzaj separatora pól rekordu określa parametr Format. Format= Delimited (x) oznacza, że pola rekordu oddzielone są znakiem x – w powyższym przykładzie średnikiem. Parametry MaxScanRows oraz CharacterSet zostały umieszczone w opisie struktury dla zachowania zgodności ze standardem ODBC. Parametry te są ignorowane przez aplikację GB24 i w opisie struktury mogą zostać pominięte. Parametr ColNameHeader umożliwia wczytanie (wartość False) lub pominięcie podczas wczytywania (wartość True) pierwszego wiersza danych z importowanego pliku. Obecnie parametr ten może przyjmować tylko wartość False. W przypadku wpisania innej wartości dla parametru lub pominięcia go, aplikacja przyjmuje domyślną wartość parametru Przykładowa zawartość pliku z danymi przelewów zagranicznych w formacie liniowym: 93156000132015000005760102;693849781;;przelewzagr1;ABBLBDDH002;94102015050000080200112714;John;Johnson;Nazwa; Nazwa;0;Francja;100;USD;Zapłata1;Zapłata2;Zapłata3;Zapłata4;BEN;9315600013 2015 0000 0576 0102;dodatkowe informacje 4.2.2.2 Plik w formacie XML Dla pliku przelewów zagranicznych w formacie XML dozwolone jest stosowanie następujących tagów (tekst pisany czcionką bold): <?xml version="1.0" encoding="iso-8859-2"?> <przelewy> <przelew> <rach_obc>Rachunek obciążany kwotą zlecenia w formacie NRB</rach_obc> <nr_tel>Nr telefonu kontaktowego</nr_tel> <os_kontakt>Osoba do kontaktu</os_kontakt> <bank_swift> Kod SWIFT banku odbiorcy przelewu</bank_swift> <rachunek>Nr rachunku odbiorcy przelewu</rachunek> <nazwa>Nazwa odbiorcy przelewu</nazwa> <status_dewiz>Status dewizowy beneficjenta</status_dewiz> <kraj_nierezyd>Kraj nierezydenta</kraj_nierezyd> <kwota>Kwota zlecenia</kwota> <waluta>Waluta zlecenia</waluta> <tresc>Tytuł prawny płatności</tresc> <koszty_pokrywa>Oznaczenie strony pokrywającej koszty przelewu (BEN, OUR, SHA). W przypadku gdy przelew podlega regułom PSD (waluta oraz kraj kontrahenta przynależy do koszyka PSD) dla pola 71A KOSZTY I PROWIZJE dozwolona jest jedynie opcja kosztów SHA oraz OUR. </koszty_pokrywa> <referencje>Referencje własne klienta</referencje> <rach_obc_prow>Rachunek obciążany kwotą kosztów i prowizji (NRB)</rach_obc> <info_dodatkowe>Informacje dodatkowe do obsługi zlecenia</info_dodatkowe> </przelew> ... </przelewy> Każde powtórzenie tagów <przelew> ... </przelew> oznacza dane nowego przelewu zagranicznego. Przykładowy plik .xml zawierający przelewy zagraniczne: <?xml version="1.0" encoding="iso-8859-2"?> <przelewy> 28 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA <przelew> <rach_obc>93 1560 0013 2015 0000 0576 0102</rach_obc> <nr_tel>(52) 348 24 32</nr_tel> <os_kontakt>Zagraniczny1</os_kontakt> <referencje>Referencje1</referencje> <bank_swift>ABBSLBBE</bank_swift> <rachunek>85 1560 0013 2005 0000 0260 0001</rachunek> <nazwa1>Nazwa1</nazwa1> <nazwa2>Nazwa2</nazwa2> <nazwa3>Nazwa3</nazwa3> <nazwa4>Nazwa4</nazwa4> <status_dewiz>1</status_dewiz> <kraj_nierezyd>Polska</kraj_nierezyd> <kwota>100</kwota> <waluta>EUR</waluta> <tresc1>Transakcja1</tresc1> <tresc2>Transakcja2</tresc2> <tresc3>Transakcja3</tresc3> <tresc4>Transakcja3</tresc4> <koszty_pokrywa>BEN</koszty_pokrywa> <referencje>Referencje klienta</referencje> <rach_obc_prow>93 1560 0013 2015 0000 0576 0102</rach_obc_prow> <info_dodatkowe>Dodatkowe informacje1</info_dodatkowe> </przelew> <przelew> <rach_obc>93 1560 0013 2015 0000 0576 0102</rach_obc> <nr_tel>(52) 348 24 31</nr_tel> <os_kontakt>Zagraniczny2</os_kontakt> <referencje>Referencj2</referencje> <bank_swift>AACFFRCPAAF</bank_swift> <rachunek>85 1560 0013 2005 0000 0260 0001</rachunek> <nazwa1>Nazwa1</nazwa1> <nazwa2>Nazwa2</nazwa2> <nazwa3>Nazwa3</nazwa3> <nazwa4>Nazwa4</nazwa4> <status_dewiz>1</status_dewiz> <kraj_nierezyd>Polska</kraj_nierezyd> <kwota>50</kwota> <waluta>EUR</waluta> <tresc1>Transakcja1</tresc1> <tresc2>Transakcja2</tresc2> <tresc3>Transakcja3</tresc3> <tresc4>Transakcja4</tresc4> <koszty_pokrywa>BEN</koszty_pokrywa> <referencje>Referencje klienta</referencje> <rach_obc_prow>93 1560 0013 2015 0000 0576 0102</rach_obc_prow> <info_dodatkowe>Dodatkowe informacje2</info_dodatkowe> </przelew> </przelewy> 4.2.3 Struktura pliku importu listy płac 4.2.3.1 Plik w formacie Termit Plik importu listy płac w formacie Termit jest plikiem tekstowym (specyficznym dla przelewów z listy płac w stosunku do formatu liniowego dla przelewów zwykłych/ZUS/podatku). Informacja o pojedynczym przelewie zajmuje jedną linię (rekord) zakończoną znakami <CRLF>. Każda linia składa się z pól o stałej długości zawierających poszczególne dane przelewu. Długość pojedynczego rekordu to 338 znaków (336 znaków wynikających z wartości pól plus dwa znaki końca rekordu <CRLF>). Pola występują w pliku w określonej kolejności (bez separatorów). Długość pól jest stała – każde pole znakowe uzupełniane jest do prawej spacjami, natomiast pole kwoty od lewej zerami. Maksymalna ilość rekordów w pliku importu listy płac to 9999. Wszystkie pola opisane w strukturze pliku listy płac są polami wymagalnymi, natomiast nie wszystkie wartości są wczytywane do przelewu. Z pliku importu nie są przenoszone do danych przelewu: numer rozliczeniowy banku nadawcy oraz wartości z pól waluta i transfer. Obecność wymienionych powyżej pól jest wymagana przez strukturę pliku i obowiązujące przy wczytywaniu pliku reguły walidacji danych. Zestaw pól opisujących dane przelewu listy płac wraz z formatem danych dla każdego pola przedstawiono w poniższej tabeli. Typy danych stosowane przy opisie pól: N – pole numeryczne C – pole tekstowe K – pole kwoty. Kwota w formacie zł,gr. Separatorem części dzięsiętnej jest znak przecinka. 29 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Pole Długość Typ Opis bank 8 N Numer rozliczeniowy banku nadawcy rachunek 34 C Numer rachunku nadawcy bank 8 N Numer rozliczeniowy banku odbiorcy rachunek 34 C Numer rachunku odbiorcy nazwa 54 C Nazwa odbiorcy adres 54 C Adres odbiorcy tytul 54 C Tytuł płatności tytul cd 54 C Tytuł płatności c.d. waluta 3 C Zawsze ‘000’ kwota 16/2 K Kwota operacji. Maksymalna długość pola to 16 znaków wraz z separatorem i częścią dziesiętną. transfer 1 C Typ transferu: ‘E’-Elixir symbol 16 C Symbol dokumentu Przykładowy plik z listą płac w formacie termin zawierający dane o dwóch przelewach listy płac: 1560001358156000132015000002150004 00-123 Warszawa Testowa 23 0000000000000011,00E05/2009 1560001358156000132015000002150004 00-123 Warszawa ul. Testowa 0000000000000021,00E05/2013 1320000664132000060000000110000001 WYNAGRODZENIE 3a 1320000664132000060000000110000001 WYNAGRODZENIE ZA ZA Alina Test : 05.2013 Bernard Test : 05.2013 4.2.3.2 Plik w formacie Elixir Plik z listą płac do importu w formacie elixir zapisany jest w formacie tekstowym. Każde zlecenie przelewu z listy płac zajmuje jedną linię (jeden rekord) zakończoną znakiem< CRLF>. Każdy rekord jest złożony z 17 pól. Pola są oddzielone separatorem. Separatorem jest przecinek. Pola występują w ustalonej kolejności, opisanej w części Struktura rekordu. Pola tekstowe są objęte cudzysłowami. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string “ “. Puste pola końcowe rekordu mogą zostać pominięte. Znakiem podziału linii w obrębie pola jest znak „|”. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki są kodowane w ISO 8859-2. Struktura rekordu: Rekord danych musi mieć strukturę zgodną ze strukturą pliku przecinkowego Elixir. Typy danych stosowane przy opisie pól: N – pole numeryczne, wartością jest liczba całkowita D – data w formacie RRRRMMDD, gdzie RRRR – rok, MM – miesiąc, DD – dzień (np. 20060501). C – pole tekstowe. Dozwolone znaki zgodne z wymaganiami systemu Elixir. Rozmiar pola 4*35 oznacza że pole może zawierać maksymalnie 4 linie po 35 znaków , nie wliczając znaków podziału linii. K – pole zawierające kwotę. Kwota wyrażona w groszach. Nie może zawierać żadnych separatorów dla części ułamkowej ani separatorów tysięcy. Przykład: 150 zł należy zapisać jako 15000, 10 zł 90 gr jako 1090, zapis 50 oznacza kwotę 50 gr. Do GB24 wczytywane są pola o statusie M. Pola o statusie O są pomijane przy wczytywaniu pliku do GB24 . 30 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Kolejność pola w rekordzie Pole wg Elixir Format Rozmiar Status pola Pole w GB24 Opis pola w GB24 1 Typ komunikatu N 3 O - Pole pomijane przy wczytywaniu do GB24 2 Data transakcji D 8 M DATA Data zlecenia. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 3 Kwota K 15 M KWOTA Kwota zlecenia. Waluta domyślnie przyjmowana jako PLN. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 4 Nr jednostki prezentującej N 8 O - Pole pomijane przy wczytywaniu do GB24 5 Nr jednostki odbierającej N 8 O - Pole pomijane przy wczytywaniu do GB24 6 Rachunek klienta C nadawcy 34 M RACH_OBC Numer rachunku nadawcy. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 7 Rachunek klienta C adresata 34 M RACHUNEK Numer rachunku beneficjenta. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 8 Nazwa klienta nadawcy C 4*35 O - Pole pomijane przy wczytywaniu do GB24 9 Nazwa klienta adresata C 4*35 M NAZWA Nazwa beneficjenta. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 10 Numer nadawcy uczestnika pośredniego N 8 O - Pole pomijane przy wczytywaniu do GB24 11 Numer oddziału – N finalny adresat 8 M BANK Bank beneficjenta. Pole nie jest obowiązkowe, można przekazać wartość pustą. 12 Informacje dodatkowe C 4*35 M TRESC Tytuł płatności przelewu. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 13 Numer czeku C 10 O - Pole pomijane przy wczytywaniu do GB24 14 Szczegóły reklamacji C 4*35 O - Pole pomijane przy wczytywaniu do GB24 15 Dodatkowa identyfikacja spraw C 34 O - Pole pomijane przy wczytywaniu do GB24 16 Informacje międzybankowe C 16 M REFERENCJE Dodatkowy identyfikator przelewu – referencje. Pole nie jest obowiązkowe można przekazać wartość pustą. 17 Dowolny tekst C 35 O - Pole pomijane przy wczytywaniu do GB24 Przykłady rekordów z pliku przelewów z listy płac 110,20130508,10,,,"09156000132015000005760062","06113000100000000316200001","","Jan|Test",15600013,11300010," Wynagrodzenie|za pracę","","","51","04/2013","" ,20130507,2000,,,"09156000132015000005760062","48835500091234567890123456","","Anna|Test|Miasto ul. Testowa1",15600013,10101023,"Wynagrodzenie za pracę","","","51","04/2013","" 31 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA 110,20130507,2000,,,"09156000132015000005760062","48835500091234567890123456","","Klient Test",,83550009,"Wynagrodzenie","","","","04/2013","" 4.2.3.3 Plik w formacie XML Dla pliku przelewów z listą płac w formacie XML dozwolone jest stosowanie następujących tagów (tekst pisany czcionką bold): <?xml version="1.0" encoding="iso-8859-2"?> <przelewy> <przelew> <rach_obc>rachunek obciążany w formacie NRB</rach_obc> <bank>numer banku odbiorcy przelewu</bank> <rachunek>numer rachunku odbiorcy przelewu</rachunek> <nazwa>nazwa odbiorcy przelewu</nazwa> <kwota>kwota przelewu</kwota> <tresc>treść przelewu</tresc> <referencje>referencje własne klienta</referencje> <data>data przelewu (bieżąca)</data> </przelew> ... </przelewy> Każde powtórzenie tagów <przelew> ... </przelew> jest wynagrodzeniem pracownika. interpretowane przez aplikację jako nowy przelew z Przykładowy plik .xml zawierający przelewy z listy płac: <?xml version="1.0" encoding="iso-8859-2"?> <przelewy> <przelew> <rach_obc>07156000132015000005760001</rach_obc> <bank>15600013</bank> <rachunek>55132000061234567890123456</rachunek> <nazwa>Janina Test</nazwa> <kwota>2500.10</kwota> <tresc>Wynagrodzenie 04/2013</tresc> <data>2013-05-08</data> </przelew> <przelew> <rach_obc>07156000132015000005760001</rach_obc> <bank>15600013</bank> <rachunek>48835500091234567890123456</rachunek> <nazwa>Jan Test ul. Testowa 21</nazwa> <kwota>1500.12</kwota> <tresc>Wynagrodzenie 04/2013</tresc> <referencje>Pensja</referencje> <data>2013-05-08</data> </przelew> </przelewy> 4.2.3.4 Plik w formacie VideoTel Plik importu listy płac w formacie VideoTel jest plikiem tekstowym. Każde zlecenie przelewu związanego z wynagrodzeniem pracownika zajmuje jedną linię (jeden rekord) zakończoną znakiem <CRLF>. Każdy rekord jest złożony z 14 pól. Pola występują w ustalonej kolejności, opisanej w tabeli zamieszczonej poniżej. Każde pole w rekordzie musi wystąpić. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string "". Poszczególne pola są oddzielone jedną i tylko jedną spacją. Pola tekstowe są objęte cudzysłowami. Jeżeli w tekście do zaimportowania ma się znaleźć cudzysłów, należy zastąpić go dwoma cudzysłowami. Znakiem podziału linii w obrębie pola są trzy znaki zapytania. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki kodowane są w standardzie ISO 8859-2 lub WINDOWS 1250. Formaty pól: N – pole numeryczne, wartością jest liczba całkowita. Zapis 10N oznacza, że pole może zawierać maksymalnie 10 cyfr. C – pole tekstowe. Zapis 3*35C oznacza że pole może zawierać maksymalnie 3 linie po 35 znaków, nie wliczając znaków podziału linii oraz licząc podwójne cudzysłowy jako jeden znak. K – pole zawierające kwotę. Kwota w formacie Zł.GR. Separatorem części ułamkowej jest kropka. Nie należy używać żadnych innych separatorów, np. separatora tysięcy. Struktura rekordu: 32 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Do aplikacji GB24 wczytywane są pola o statusie M. Pola o statusie O są pomijane przy wczytywaniu pliku do GB24 . Kolejność pola w rekordzie Nazwa pola Opis pola Format pola 35C Status pola 1 BBen Nazwa banku beneficjenta O 2 RBen1 Nazwa rachunku beneficjenta 3*35C M 3 NrBen Numer rachunku beneficjenta 34C M 4 REZ12 Klucz N O 5 KW Kwota przelewu K M 6 BNad Nazwa banku nadawcy 35C O 7 RNad Nazwa rachunku nadawcy 35C O 8 NrNad Numer rachunku nadawcy 34C M 9 REF Tytuł płatności 4*35C M 10 WAL3 Waluta przelewu 3C O 11 NF Nazwa firmy, do której mają być dopisane nowe rachunki beneficjenta, które zostaną zaimportowane wraz z przelewami 35C O 12 DNN Nazwa beneficjenta 3*35C M 13 WL Określenie rodzaju własności firmy NF „T” jeśli firma własna, „N” jeśli firma obca O 14 REZ2 Nazwa systemu finansowego dla przelewu 35C O Uwagi: 1RBen – zawartość pola interpretowana przez aplikację jako nazwa odbiorcy przelewu 2REZ1 – pole może zawierać dowolną liczbę całkowitą np.1 3WAL – w aplikacji przyjmowana zawsze wartość PLN Przykładowy rekord danych z pliku importu przelewu z listy płac w formacie VideoTel: "" "FIRMA TEST" "48835500091234567890123456" 0000001 1500.96 "" "JAN TEST???UL.TESTOWA 5" "09156000132015000005760062" "Wynagrodzenie???Kwiecień 2013" "PLN" "" "TEST TEST" "" "" "" "" "54156000132234000871150001" 1 2000.01 "" "" "07156000132015000005760001" "Wynagrodzenie???Kwiecień 2013" "" "" "KLIENT TEST" 33 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA 4.2.3.5 Plik w formacie Telekonto Plik importu listy płac w formacie Telekonto jest plikiem tekstowym. Pierwsza linia pliku stanowi nagłówek. W nagłówku określany jest rodzaj danych w pliku - w przypadku importu danych przelewów należy tam umieścić tekst Zlecenia. Informacja o pojedynczym przelewie zwuązanym z wynagrodzeniem pracownika zajmuje jedną linię (jeden rekord) zakończoną znakiem <CRLF>. Każda linia pliku składa się z pól oddzielonych znakiem „|” (pionowa kreska). Pola występują w ustalonej kolejności, opisanej w poniżej załączonej tabeli. Każda linia zawiera pola wymagane (muszą być wypełnione), pola opcjonalne (wypełnione mogą być, ale nie muszą) oraz pola, które nie są wczytywane do aplikacji GB24 . Pojedyncza spacja (pomiędzy separatorami pól) oznacza pole puste. Brak tej spacji oznacza brak pola (pomimo wystąpienia separatorów || ). Puste pola końcowe rekordu mogą zostać pominięte. Polskie znaki kodowane są w ISO 8859-2. Istnieje możliwość importu danych z polskimi znakami kodowanymi w standardzie Mazovia. W takim przypadku strona kodowa musi zostać zadeklarowana w nagłówku pliku importu w postaci Zlecenia|MAZOVIA. Uwaga: Dane odbiorców przelewów wczytywanych z pliku importu muszą znajdować się w bazie odbiorców. Zestaw pól opisujących dane przelewu wraz z formatem danych: N – pole numeryczne, C – pole tekstowe, D – pole data – format MM/DD/YY, gdzie MM – miesiąc, DD – dzień YY – rok, K – pole kwoty. Kwota w formacie Zł.GR. Separatorem części ułamkowej jest separatorów, np. separatora tysięcy. Pole Długość Typ kropka. Nie należy używać żadnych innych Opis data 8 D Data operacji kwota 15/2 K Kwota operacji rach_obc 34 C Numer rachunku obciążanego rachunek 34 C Numer rachunku uznawanego tytulem1 35 C Tytuł płatności tytulem2 35 C Tytuł płatności typ przelewu** 3 C Pole pomijane przy wczytywaniu do aplikacji GB24 kod waluty** 3 C Pole pomijane przy wczytywaniu do aplikacji GB24 system rozliczeniowy** 1 C Pole pomijane przy wczytywaniu do aplikacji GB24 tytulem3* 35 C Tytuł płatności tytulem4* 35 C Tytuł płatności * - pole opcjonalne ** - pole pomijane przy wczytywaniu do aplikacji GB24 Przykład pliku importu przelewów w formacie Telekonto: Zlecenia 05/08/13|2500.50|07156000132015000005760001|06113000100000000316200001|tytul 1|tytul 2||||tytul 3|tytul 4 4.2.3.6 Plik w formacie liniowym W formacie liniowym dane przelewów listy płac importowane są z pliku tekstowego o strukturze opisanej w pliku schema.ini. Informacja o pojedynczym przelewie zajmuje jedną linię (rekord) zakończoną znakami <CRLF>. Każda linia składa się z pól zawierających dane przelewu. Pola występują w pliku w określonej kolejności, zgodnie z opisem struktury ze schema.ini. Pola oddzielone są separatorem (określonym w pliku schema.ini) lub są stałej długości. Dopuszczalny zestaw pól opisujących przelew wraz z formatem danych dla każdego pola przedstawiono w poniższej tabeli: 34 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Typy danych stosowane przy opisie pól: N – pole numeryczne C – pole tekstowe Pole Długoś ć Typ Opis modulo 8 N konto 25 C uwaga * 11 C referencje* 35 C Referencje własne klienta 140 C Pełna nazwa kontrahenta 4x35 znaków Jeśli w polu występują znaki | - traktowane są jako separatory wierszy Zamiast pola nazwa mogą występować pola nazwa1, nazwa2, nazwa3, nazwa4 o długości 35 znaków każde nazwa Pola te stanowią numer rachunku do obciążenia. Zamiast trzech pól (rachunek w formacie modulo – konto - uwaga ) może występować pole rach_obc ( typu C ) stanowiące numer rachunku w formacie NRB Tytuł przelewu 4x35 znaków, dla przelewów ZUS: pierwsze 35 znaków: NIP drugie 35 znaków: typ identyfikatora uzupełniającego oraz identyfikator uzupełniający trzecie 35 znaków: typ wpłaty, deklaracja i nr deklaracji czwarte 35 znaków: numer decyzji/umowy/tytułu wykonawczego tresc 140 C Dla przelewów US: Po słowie kluczowym uzupełniający Po słowie kluczowym Po słowie kluczowym Po słowie kluczowym /TI/ typ identyfikatora uzupełniającego i identyfikator /OKR/ okres należności /SFP/ symbol formularza płatności /TXT/ opis zobowiązania Jeśli w polu występują znaki | - traktowane są jako separatory wierszy. Zamiast pola tresc mogą wystąpić cztery pola tresc1, tresc2, tresc3, tresc4, każde o długości 35 znaków kwota 15/2 C Kwota przelewu bank * 8 N Numer rozliczeniowy Banku rachunek 34 C Numer rachunku kontrahenta 140 C Dane płatnika/zobowiązanego Pole obecne tylko dla przelewów ZUS i przelewów podatkowych. Jeśli w polu występują znaki | - traktowane są jako separatory wierszy Zamiast pola platnik mogą wystąpić cztery pola: platnik1, platnik2, platnik3, platnik4, każde o długości 35 znaków. 10 C Data przelewu (bieżąca lub przyszła) w formacie RRRR-MM-DD platnik data *- pole nie wymagane ( dozwolona jest pusta wartość ) Przykładowy opis struktury pliku przelewów wczytany ze schema.ini [lista_plac_lin.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=RACH_OBC Char Width 34 Col2=REFERENCJE Char Width 35 Col3=NAZWA Char Width 140 Col4=RACHUNEK Char Width 34 Col5=KWOTA Float Col6=TRESC1 Char Width 35 Col7=TRESC2 Char Width 35 Col8=TRESC3 Char Width 35 Col9=TRESC4 Char Width 35 35 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Col10=DATA Char Width 10 Przykład pliku importu przelewów z listą płac w formacie liniowym: 07156000132015000005760001;referencje;Klient pracę;Kwiecień;2013;2013-05-08; TEST;55132000061234567890123456;3000,45;Wynagrodzenie;za Uwaga: Nazwy pól w opisie struktury powinny być pisane dużymi literami. Rodzaj separatora pól rekordu określa parametr Format. Format= Delimited (x) oznacza, że pola rekordu oddzielone są znakiem x – w powyższym przykładzie średnikiem. Format =FixedLength oznacza plik stałopozycyjny, w którym pola rekordu mają stałą długość. W takim przypadku konieczne jest określenie długości poszczególnych pól w opisie struktury. Parametry MaxScanRows oraz CharacterSet zostały umieszczone w opisie struktury dla zachowania zgodności ze standardem ODBC. Parametry te są ignorowane przez aplikację GB24 i w opisie struktury mogą zostać pominięte. Parametr ColNameHeader umożliwia wczytanie (wartość False) lub pominięcie podczas wczytywania (wartość True) pierwszego wiersza danych z importowanego pliku. Obecnie parametr ten może przyjmować tylko wartość False. W przypadku wpisania innej wartości dla parametru lub pominięcia go, aplikacja przyjmuje domyślną wartość parametru - False. 4.2.4 Struktura pliku importu dyspozycji sądowych Pliki importu dyspozycji dotyczących rachunków spraw sądowych dostępne są tylko w formacie XML i mogą zawierać następujące typy operacji: 1. Korekta (edycja) między kapitałem i odsetkami należnymi na dzień bilansu otwarcia – wymaga określenia kwoty o jaką zmodyfikowana zostanie wartość kapitału. O taką samą wartość z przeciwnym znakiem zostaną zmodyfikowane odsetki. Dopuszczalne są liczby ujemne. 2. Przeksięgowanie między rachunkami spraw (wypłata z jednego rachunku sprawy, w tym wypłata całkowita, wpłata na inny rachunek sprawy) – wymaga określenia wartości wszystkich rejestrów rachunku sprawy do przeksięgowania. 3. Wypłata – wymaga określenia wartości kapitału i należnych odsetek do wypłaty. 4.2.4.1 Plik w formacie XML Dla pliku importu dyspozycji sądowych o typie edycja danych rachunku dozwolone jest stosowanie następujących tagów (tekst pisany czcionką bold): <?xml version="1.0" encoding="iso-8859-2"?> <dyspozycje> <dyspozycja> <edycja> <rach_obc>NRB rachunku obciążanego</rach_obc> <lp>Identyfikator sumy depozytowej - pole nie jest wymagane</lp> <sygnatura>Sygnatura sprawy sądowej nadana przez sąd - pole nie jest wymagane</sygnatura> <zmiana_kapitalu>Kwota o jaką zmodyfikowana zostanie wartość kapitału. O taką samą wartość z przeciwnym znakiem zostaną zmodyfikowane odsetki - dopuszczalne są liczby ujemne. Pole nie jest wymagane.</zmiana_kapitalu> <dane_dodatkowe>Dane_dodatkowe. Pole może zawierać maksymalnie 140 znaków. Pole nie jest wymagane.</dane_dodatkowe> <referencje>Referencje własne klienta. Pole może zawierać maksymalnie 16 znaków. Pole nie jest wymagane.</referencje> </edycja> </dyspozycja> </dyspozycje> Poniżej zaprezentowano przykładowy plik importu dyspozycji edycji danych rachunku. <?xml version="1.0" encoding="iso-8859-2"?> <dyspozycje> <dyspozycja> <edycja> <rach_obc>63156000132203831045360001</rach_obc> <lp>lp1</lp> <sygnatura>syg12</sygnatura> <zmiana_kapitalu>0.00</zmiana_kapitalu> <dane_dodatkowe>dane dodatkowe123</dane_dodatkowe> <referencje>referencje</referencje> </edycja> </dyspozycja> <dyspozycja> <edycja> 36 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA <rach_obc>63156000132203831045360001</rach_obc> <lp>lp1w</lp> <sygnatura>syg12</sygnatura> <zmiana_kapitalu>12ww</zmiana_kapitalu> <dane_dodatkowe>dane dodatkowe123</dane_dodatkowe> <referencje>referencje123</referencje> </edycja> </dyspozycja> <dyspozycja> <edycja> <rach_obc>63156000132203831045360001</rach_obc> <lp>lp1</lp> <sygnatura>syg12</sygnatura> <zmiana_kapitalu>0.00</zmiana_kapitalu> <dane_dodatkowe>dane dodatkowe123 niepoprawny rachunek</dane_dodatkowe> <referencje>referencje</referencje> </edycja> </dyspozycja> <dyspozycja> <edycja> <rach_obc>63156000132203831045360001</rach_obc> <lp>lp1</lp> <sygnatura>syg12</sygnatura> <zmiana_kapitalu>12</zmiana_kapitalu> <dane_dodatkowe>dane dodatkowe123</dane_dodatkowe> <referencje>referencje111</referencje> </edycja> </dyspozycja> </dyspozycje> Dla pliku importu dyspozycji sądowych o typie wypłata w PLN oraz przeksięgowanie między rachunkami spraw dozwolone jest stosowanie następujących tagów (tekst pisany czcionką bold). <?xml version="1.0" encoding="iso-8859-2"?> <dyspozycje> <dyspozycja> <przelew> <typ_wypl>Typ wypłaty, możliwe wartości: 1 - zdefiniowana, 2 - proporcjonalna, 3 - kwotowa, 4 - likwidacja - pole wymagane</typ_wypl> <rach_obc>NRB rachunku obciążanego - pole wymagane</rach_obc> <bank>Numer banku odbiorcy przelewu - pole wymagane</bank> <rachunek>Numer rachunku kontrahenta - pole wymagane</rachunek> <nazwa>Nazwa odbiorcy przelewu, maksymalna ilość znaków dla pola wynosi 140 - pole wymagane</nazwa> <kwota>Wartość kwoty przelewu - pole wymagane dla typu wypłaty - kwotowa</kwota> <kapital>Wartość kwoty kapitału - pole nie jest wymagane</kapital> <odsetki>Kwota odsetek do przelewu. Wartość nie może być większa niż odsetki całkowite na rachunku do obciążenia. Pole nie jest wymagane.</odsetki> <referencje>Referencje własne klienta. Pole może zawierać maksymalnie 16 znaków. Pole nie jest wymagane.</referencje> <tresc>Treść przelewu, pole wymagane. Maksymalna ilość znaków w polu wynosi 105 znaków</tresc> </przelew> </dyspozycja> <dyspozycja> </dyspozycje> Poniżej zaprezentowano przykładowy plik importu dyspozycji sądowych o typie wypłata (w walucie PLN) oraz przeksięgowanie między rachunkami spraw. <?xml version="1.0" encoding="iso-8859-2"?> <dyspozycje> <dyspozycja> <przelew> <typ_wypl>1</typ_wypl> <rach_obc>71156000137088412083018538</rach_obc> <bank>83550009</bank> <rachunek>48835500091234567890123456</rachunek> <nazwa>Kontahent testowy 1</nazwa> <kwota>10225</kwota> <kapital>10222</kapital> <odsetki>3</odsetki> <referencje>Zdefiniowana</referencje> <tresc>Tytul Zdefiniowana</tresc> </przelew> </dyspozycja> <dyspozycja> 37 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA <przelew> <typ_wypl>2</typ_wypl> <rach_obc>71156000137088412083018538</rach_obc> <bank>13200006</bank> <rachunek>55132000061234567890123456</rachunek> <nazwa>Kontrahent testowy2</nazwa> <kapital>10222</kapital> <referencje>Proporcjonalna</referencje> <tresc>Tytul Proporcjonalna</tresc> </przelew> </dyspozycja> <dyspozycja> <przelew> <typ_wypl>3</typ_wypl> <rach_obc>71156000137088412083018538</rach_obc> <bank>13200006</bank> <rachunek>55132000061234567890123456</rachunek> <nazwa>Kontrahent3</nazwa> <kwota>10225</kwota> <referencje>Kwotowa</referencje> <tresc>Tytul - Kwotowa</tresc> </przelew> </dyspozycja> <dyspozycja> <przelew> <typ_wypl>4</typ_wypl> <rach_obc>71156000137088412083018538</rach_obc> <bank>83550009</bank> <rachunek>48835500091234567890123456</rachunek> <nazwa>Kontrahent4</nazwa> <referencje>Likwidacja</referencje> <tresc>Tytul Likwidacja</tresc> </przelew> </dyspozycja> <dyspozycja> <przelew> <typ_wypl>1</typ_wypl> <rach_obc>71156000137088412083018538</rach_obc> <bank>15600013</bank> <rachunek>44156000137088412083018539</rachunek> <nazwa>Kontrahent</nazwa> <kwota>10225</kwota> <kapital>10222</kapital> <odsetki>3</odsetki> <referencje>Przeksiegowanie</referencje> <tresc>Tytul Przeksiegowanie</tresc> </przelew> </dyspozycja> </dyspozycje> Dla pliku importu dyspozycji sądowych o typie wypłata w walucie obcej oraz przeksięgowanie między rachunkami spraw dozwolone jest stosowanie następujących tagów (tekst pisany czcionką bold). <?xml version="1.0" encoding="iso-8859-2"?> <dyspozycje> <dyspozycja> <przelew_zagr> <typ_wypl>Typ wypłaty, możliwe wartości: 1 - zdefiniowana, 2 - proporcjonalna, 3 - kwotowa, 4 - likwidacja - pole wymagane</typ_wypl> <rach_obc>NRB rachunku obciążanego - pole wymagane</rach_obc> <bank_swift>Kod SWIFT banku odbiorcy - pole wymagane</bank_swift> <rachunek>NRB rachunku odbiorcy - pole wymagane</rachunek> <nazwa>Nazwa odbiorcy przelewu - pole wymagane</nazwa> <kwota>Wartość kwoty przelewu - pole wymagane dla typu wypłaty - kwotowa</kwota> <kapital>Wartość kwoty kapitału - pole nie jest wymagane</kapital> <odsetki>Kwota odsetek - pole nie jest wymagane</odsetki> <referencje>Referencje własne klienta. Pole może zawierać maksymalnie 16 znaków. Pole wymagane</referencje> <tresc>Treść przelewu, pole wymagane. Maksymalna ilość znaków w polu wynosi 105 znaków</tresc> <waluta>Waluta przelewu - pole wymagane</waluta> <nr_tel>Numer telefonu kontaktowego - pole wymagane</nr_tel> <status_dewiz>Status dewizowy 0 - Nierezydent, 1 - Rezydent - pole wymagane</status_dewiz> <kraj_nierezyd>Kraj nierezydenta - pole wymagane dla statusu 0 - Nierezydent</kraj_nierezyd> <info_dodatkowe>Informacje dodatkowe, maksymalna wartość w polu wynosi 140 znaków. Pole nie jest wymagane</info_dodatkowe> <os_kontakt>Osoba do kontaktu, pole może zawierać maksymalnie 30 znaków. Pole nie jest wymagane</os_kontakt> </przelew_zagr> 38 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA </dyspozycja> </dyspozycje> <?xml version="1.0" encoding="iso-8859-2"?> <dyspozycje> <dyspozycja> <przelew_zagr> <typ_wypl>1</typ_wypl> <rach_obc>71156000137088412083018538</rach_obc> <bank_swift>BPKOPLPWXXX</bank_swift> <rachunek>PL48835500091234567890123456</rachunek> <nazwa>Kontrahent1</nazwa> <kwota>10225</kwota> <kapital>10222</kapital> <odsetki>3</odsetki> <referencje>Proporcjonalna</referencje> <tresc>Tytuł przelewu dla wypłaty o typie Proporcjonalna</tresc> <waluta>EUR</waluta> <nr_tel>1234567890</nr_tel> <status_dewiz>0</status_dewiz> <kraj_nierezyd>Francja</kraj_nierezyd> <info_dodatkowe>Informacje dodatkowe</info_dodatkowe> <os_kontakt>Jan Test</os_kontakt> </przelew_zagr> </dyspozycja> <dyspozycja> <przelew_zagr> <typ_wypl>2</typ_wypl> <rach_obc>71156000137088412083018538</rach_obc> <bank_swift>BPKOPLPWXXX</bank_swift> <rachunek>PL48835500091234567890123456</rachunek> <nazwa>Kontrahent2</nazwa> <kapital>10222</kapital> <referencje>wyplpropzagrimpK</referencje> <tresc>Tytuł przelewu dla wypłaty o typie Zdefiniowana</tresc> <waluta>EUR</waluta> <nr_tel>1234567890</nr_tel> <status_dewiz>1</status_dewiz> <info_dodatkowe>Informacje dodatkowe</info_dodatkowe> <os_kontakt>Jan Test</os_kontakt> </przelew_zagr> </dyspozycja> <dyspozycja> <przelew_zagr> <typ_wypl>3</typ_wypl> <rach_obc>71156000137088412083018538</rach_obc> <bank_swift>BPKOPLPWXXX</bank_swift> <rachunek>PL48835500091234567890123456</rachunek> <nazwa>Kontrahent3</nazwa> <kwota>10225</kwota> <referencje>wyplkwotzagrimpK</referencje> <tresc>Tytuł przelewu dla wypłaty o typie Kwotowa</tresc> <waluta>EUR</waluta> <nr_tel>1234567890</nr_tel> <status_dewiz>0</status_dewiz> <kraj_nierezyd>Francja</kraj_nierezyd> <info_dodatkowe>Informacje dodatkowe</info_dodatkowe> <os_kontakt>Jan Test</os_kontakt> </przelew_zagr> </dyspozycja> <dyspozycja> <przelew_zagr> <typ_wypl>4</typ_wypl> <rach_obc>71156000137088412083018538</rach_obc> <bank_swift>BPKOPLPWXXX</bank_swift> <rachunek>PL48835500091234567890123456</rachunek> <nazwa>Kontrahent4</nazwa> <referencje>wypllikwzagrimpK</referencje> <tresc>Tytuł przelewu dla wypłaty o typie Likwidacja</tresc> <waluta>EUR</waluta> <nr_tel>1234567890</nr_tel> <status_dewiz>0</status_dewiz> <kraj_nierezyd>Francja</kraj_nierezyd> <info_dodatkowe>Informacje dodatkowe</info_dodatkowe> <os_kontakt>Jan Test</os_kontakt> </przelew_zagr> </dyspozycja> 39 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA <dyspozycja> <przelew_zagr> <typ_wypl>1</typ_wypl> <rach_obc>71156000137088412083018538</rach_obc> <rachunek>44156000137088412083018539</rachunek> <nazwa>Kontrahent</nazwa> <kwota>10225</kwota> <kapital>10222</kapital> <odsetki>3</odsetki> <referencje>Przeksięgowanie</referencje> <tresc>Przeksięgowanie między rachunkami spraw w walucie obcej</tresc> <waluta>EUR</waluta> <nr_tel>1234567890</nr_tel> <status_dewiz>0</status_dewiz> <kraj_nierezyd>Francja</kraj_nierezyd> <info_dodatkowe>Informacje dodatkowe</info_dodatkowe> <os_kontakt>Jan Test</os_kontakt> </przelew_zagr> </dyspozycja> </dyspozycje> W pliku importu dyspozycji sądowych ważna jest kolejność poszczególnych pól. Typ dyspozycji wyznaczany jest na podstawie porównania maski (cyfry 3-20 NRB) obciążanego rachunku wirtualnego z maską rachunku wirtualnego uznawanego. Jeżeli są takie same, to dyspozycja zostanie uznana jako przeksięgowanie. Każde powtórzenie tagów <dyspozycja> ... </dyspozycja> oznacza dane nowej dyspozycji sądowej. 4.2.5 Struktury plików importu kontrahentów 4.2.5.1 Plik w formacie liniowym W formacie liniowym dane kontrahentów importowane są z pliku tekstowego o strukturze opisanej w pliku schema.ini. Informacja o pojedynczym kontrahencie zajmuje jedną linię (rekord) zakończoną znakami <CRLF>. Każda linia składa się z pól zawierających dane kontrahenta. Pola występują w pliku w określonej kolejności, zgodnie z opisem struktury ze schema.ini. Pola oddzielone są separatorem (określonym w pliku schema.ini) lub są stałej długości. Dopuszczalny zestaw pól opisujących kontrahenta wraz z formatem danych dla każdego pola przedstawiono w tabeli: N – pole numeryczne C – pole tekstowe Pole nazwa Długość Typ Opis 140 C Pełna nazwa kontrahenta 4x35 znaków Jeśli w polu występują znaki | - traktowane są jako separatory wierszy Zamiast pola nazwa mogą występować pola nazwa1, nazwa2, nazwa3, nazwa4 o długości 35 znaków każde bank * 8 N Numer banku kontrahenta rachunek 34 C Numer rachunku kontrahenta swift* 8 lub 11 CN Kod Swift C Skrócona nazwa kontrahenta. Dozwolona pusta wartość, podstawiane jest 20 początkowych znaków z nazwy nazwa_kr* 20 * - pole nie jest obowiązkowe Poniżej przedstawiono przykładowy opis struktury z pliku schema.ini definiującej plik z danymi kontrahentów. [kontrah.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=NAZWA1 Char Width 255 Col2=NAZWA2 Char Width 255 Col3=NAZWA3 Char Width 255 Col4=NAZWA4 Char Width 255 Col5=BANK Integer Col6=RACHUNEK Char Width 255 Col7=SWIFT Char Width 11 40 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Col8=NAZWA_KR Char Width 255 Uwaga: Nazwy pól w opisie struktury powinny być pisane dużymi literami. Rodzaj separatora pól rekordu określa parametr Format. Format= Delimited (x) oznacza, że pola rekordu oddzielone są znakiem x – w powyższym przykładzie średnikiem. Format =FixedLength oznacza plik stałopozycyjny, w którym pola rekordu mają stałą długość. W takim przypadku konieczne jest określenie długości poszczególnych pól w opisie struktury. Parametry MaxScanRows oraz CharacterSet zostały umieszczone w opisie struktury dla zachowania zgodności ze standardem ODBC. Parametry te są ignorowane przez aplikację GB24 i w opisie struktury mogą zostać pominięte. Parametr ColNameHeader umożliwia wczytanie (wartość False) lub pominięcie podczas wczytywania (wartość True) pierwszego wiersza danych z importowanego pliku. Obecnie parametr ten może przyjmować tylko wartość False. W przypadku wpisania innej wartości dla parametru lub pominięcia go, aplikacja przyjmuje domyślną wartość parametru – False. Przykładowa zawartość pliku z danymi kontrahentów w formacie liniowym: John;Johnson;London;England;;FR243634654241242353534543;ABBLINB1;John Jan Test;ul. Testowa 16;00-001 Warszawa;;10101023;51101010231234567890123456;;JAN 4.2.5.2 Plik w formacie XML Dla pliku kontrahentów w formacie XML dozwolone jest stosowanie następujących tagów (tekst pisany czcionką bold): <?xml version="1.0" encoding="iso-8859-2"?> <kontrahenci> <kontrahent> <nazwa_kr> Nazwa krótka kontrahenta <nazwa_kr> </bank> numer banku kontrahenta </bank> <rachunek> numer rachunku kontrahenta <rachunek> </nazwa> Nazwa pełna kontrahenta </nazwa> <swift> kod swift </swift> </kontrahent> ... </kontrahenci> Każde powtórzenie tagów <kontrahent> ... </kontrahent> oznacza dane nowego kontrahenta. Przykładowy plik .xml zawierający dane o kontrahentach: <?xml version="1.0" encoding="iso-8859-2"?> <kontrahenci> <kontrahent> <nazwa_kr>Jan Kowalski</nazwa_kr> <bank>19600004</bank> <rachunek>75196000048764509212477460</rachunek> <nazwa>Jan Piotr Kowalski</nazwa> </kontrahent> <kontrahent> <nazwa_kr>Zagraniczny</nazwa_kr> <bank>83550009</bank> <rachunek>48835500091234567890123456</rachunek> <nazwa>KontrahentZagraniczny England</nazwa> <swift>AAALSARIJED</swift> <kontrahent> </kontrahenci> Uwaga: W przypadku importu danych kontrahentów zagranicznych plik nie może zawierać polskich znaków diakrytycznych. 41 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA 4.2.5.3 Plik w formacie Telekonto Plik importu kontrahentów w formacie Telekonto jest plikiem tekstowym. Pierwsza linia pliku stanowi nagłówek. W nagłówku określany jest rodzaj danych w pliku - w przypadku importu danych kontrahentów należy tam umieścić tekst Kontrahenci Informacja o pojedynczym kontrahencie zajmuje jedną linię (jeden rekord) zakończoną znakiem <CRLF>. Każda linia pliku składa się z pól oddzielonych znakiem „|” (pionowa kreska). Pola występują w ustalonej kolejności opisanej w tabeli poniżej. Każda linia zawiera pola wymagane (muszą być wypełnione), pola opcjonalne (wypełnione mogą być, ale nie muszą) oraz pola, które nie są wczytywane do aplikacji GB24 . Pojedyncza spacja pomiędzy separatorami pól oznacza pole puste. Brak tej spacji oznacza brak pola (pomimo występowania separatorów ||). Puste pola końcowe rekordu mogą zostać pominięte. Polskie znaki są kodowane w formacie ISO 8859-2. Istnieje możliwość importu danych z polskimi znakami kodowanymi w standardzie Mazovia. W takim przypadku strona kodowa musi zostać zadeklarowana w nagłówku pliku importu w postaci Kontrahenci|MAZOVIA. Zestaw pól opisujących kontrahenta: C – pole tekstowe Pole Długość Typ Opis Nazwa1 35 C Nazwa kontrahenta –linia1 Nazwa2* 35 C Nazwa kontrahenta – linia2 Adres1* 35 C Adres kontrahenta – linia 1 Adres2* 35 C Adres kontrahenta – linia2 Numer konta 34 C Numer rachunku kontrahenta Nazwa banku1** 35 C Pole pomijane przy wczytywaniu do aplikacji GB24 Nazwa banku2** 35 C Pole pomijane przy wczytywaniu do aplikacji GB24 Adres banku1** 35 C Pole pomijane przy wczytywaniu do aplikacji GB24 Adres banku2** 35 C Pole pomijane przy wczytywaniu do aplikacji GB24 Identyfikator* 20 C Nazwa skrócona kontrahenta. Dozwolona pusta wartość, podstawiane jest 20 początkowych znaków z nazwy kontrahenta. * - pole opcjonalne ** - pole pomijane przy wczytywaniu do aplikacji GB24 Przykład pliku importu kontrahentów w formacie Telekonto: Kontrahenci JAN |KOWALSKI |TESTOWA 1|00-123 WARSZAWA|41 8627 0001 2002 3009 0489 0001 |||||JAN PIOTR |KOWALSKI |TESTOWA 2|00-123 WARSZAWA|41 8627 0001 2002 3009 0489 0001|||||PIOTR 4.2.5.4 Plik w formacie VideoTel Plik importu kontrahentów w formacie VideoTel jest plikiem tekstowym. Informacja o pojedynczym kontrahencie zajmuje jedną linię (jeden rekord) zakończoną znakiem <CRLF>. Każdy rekord jest złożony z 20 pól. Pola występują w ustalonej kolejności, opisanej w tabeli zamieszczonej poniżej. Każde pole w rekordzie musi wystąpić. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string "". Poszczególne pola są oddzielone jedną i tylko jedną spacją. Pola tekstowe są objęte cudzysłowami. Jeżeli w tekście do zaimportowania ma się znaleźć cudzysłów, należy zastąpić go dwoma cudzysłowami. Znakiem podziału linii w obrębie pola są trzy znaki zapytania. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki kodowane są w standardzie ISO 8859-2 lub WINDOWS 1250. Formaty pól: 42 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA N – pole numeryczne, wartością jest liczba całkowita. Zapis 10N oznacza, że pole może zawierać maksymalnie 10 cyfr. C – pole tekstowe. Zapis 3*35C oznacza że pole może zawierać maksymalnie 3 linie po 35 znaków, nie wliczając znaków podziału linii oraz licząc podwójne cudzysłowy jako jeden znak. Struktura rekordu: Do aplikacji GB24 wczytywane są pola o statusie M. Pola o statusie O są pomijane przy wczytywaniu pliku do GB24 . Kolejność pola w rekordzie Nazwa pola Opis pola Format pola 1 BBen Nazwa banku beneficjenta 2 RBen Nazwa rachunku beneficjenta 3*35C O 3 NrBen Numer rachunku beneficjenta 34C M 4 REZ11 Klucz N O 5 WAL2 Waluta rachunku 3C O 6 TypRach Typ rachunku (np: RB, RBZ lub 35C inny) O Nazwa firmy, do której mają być dopisane nowe rachunki beneficjenta 35C M 7 NF3 35C Status pola O 8 ADR Adres 34C O 9 MST Nazwa miasta 34C O 10 KOD Kod pocztowy 34C O 11 NIP Numer NIP'u 34C O 12 REG Numer REGONU 34C O 13 TEL Numer telefonu 34C O 14 DNN4 Domyślna nazwa rachunków powiązanych z daną firmą NF 3*35C M 15 REZ2 Nazwa systemu finansowego 35C O 16 WL Określenie rodzaju własności firmy NF „T” jeśli firma własna, „N” jeśli firma obca O 17 KRAJ Nazwa kraju 35C O 18 DLUZ N lub T (T oznacza dłużnika) 1C O 19 IDPI Identyfikator płatności 20C O 43 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA 20 Rodzaj działalności - „F” (działalność gospodarcza), „P” 1C (pozostałe) RDZIAL O Uwagi: 1REZ1 – pole może zawierać dowolną liczbę całkowitą np.1 2WAL – w aplikacji przyjmowana zawsze wartość PLN 3 NF – zawartość pola interpretowana przez aplikację jako nazwa skrócona kontrahenta 4 DNN – zawartość pola interpretowana przez aplikację jako nazwa kontrahenta wraz z danymi adresowymi Przykładowy rekord danych z pliku importu kontrahentów w formacie Videotel: "NBP O/Okr. w Warszawie" "Adam Test???ul.Testowa 5???00-600 Warszawa" "64132000060000000110000001" "" "PLN" "RB" "Jan Kowalski" "" "" "" "" "" "" "Jan Test???ul. Testowa 14???00-900 Warszawa" "N" "" "Polska" "N" "" "" "BGK II O. w Warszawie" "Testowa Firma" "48835500091234567890123456" "" "PLN" "RB" "Testowa Firma" "" "" "" "" "" "" "Testowa Firma" "T" "" "Polska" "N" "" "" "; 4.2.6 Struktura plików eksportu statusów przelewów 4.2.6.1 Format liniowy W pliku eksportu statusów przelewów w formacie liniowym informacja o pojedynczym przelewie zajmuje jedną linię (rekord) zakończoną znakami <CRLF>. Każda linia składa się z pól zawierających poszczególne dane przelewu. Pola występują w pliku w określonej kolejności, zgodnie z opisem struktury zdefiniowanym w pliku schema.ini. Pola oddzielone są separatorem (określonym w pliku schema.ini) lub są stałej długości. Dopuszczalny zestaw pól dla statusów przelewów wraz z formatem danych dla każdego pola przedstawiono w poniższej tabeli: N – pole numeryczne C – pole tekstowe Pole Długość Typ Opis Status 2 C Status przelewu Blad 80 C Opis błędu w przelewie. Pole jest wypełnione jeśli uzupełniona jest informacja o przyczynie odrzucenia przelewu z systemu def3000/CB. Jeśli informacja o przyczynie odrzucenia zawiera informację techniczną to prezentowana będzie wartość: 'Problem wewnętrzny'. Modulo 8 C Modulo klienta NRB 34 C Numer rachunku obciążanego w formacie NRB Data_wpisu 10 C Data ostatniej edycji przelewu Data_zlecenia 10 C Data zlecenia przelewu Id 10 C Unikalny identyfikator przelewu w systemie Referencje 35 C Referencje przelewu Bank 8 N Numer rozliczeniowy banku kontrahenta Rachunek 34 C Numer rachunku kontrahenta Kwota 22/2 N Kwota przelewu Waluta 3 C Waluta rachunku obciążanego Nazwa1 35 C Nazwa kontrahenta – część 1 Nazwa2 35 C Nazwa kontrahenta – część 2 Nazwa3 35 C Nazwa kontrahenta – część 3 44 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Nazwa4 35 C Nazwa kontrahenta – część 4 Tresc1 35 C Tytuł przelewu – część 1 Tresc2 35 C Tytuł przelewu – część 2 Tresc3 35 C Tytuł przelewu – część 3 Tresc4 35 C Tytuł przelewu – część 4 Poniżej przedstawiono przykładowy opis struktury definiującej plik z danymi o statusach przelewów. [statusy_lin.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=NRB Char Width 34 Col2=REFERENCJE Char Width 35 Col3=STATUS Char Width 2 Col4=RACHUNEK Char Width 34 Col5=KWOTA Float Col6=WALUTA Char Width 3 Col7=TRESC1 Char Width 35 Col8=TRESC2 Char Width 35 Col9=TRESC3 Char Width 35 Col10=TRESC4 Char Width 35 Uwaga: Nazwy pól w opisie struktury powinny być pisane dużymi literami. Rodzaj separatora pól rekordu określa parametr Format. Format = Delimited (x) oznacza, że pola rekordu oddzielone są znakiem x – w poniższym przykładzie średnikiem. Format = FixedLength oznacza plik stałopozycyjny, w którym pola rekordu mają stałą długość. W takim przypadku konieczne jest określenie długości poszczególnych pól w opisie struktury. Parametry MaxScanRows oraz CharacterSet zostały umieszczone w opisie struktury dla zachowania zgodności ze standardem ODBC. Parametry te są ignorowane przez aplikację GB24 i w opisie struktury mogą zostać pominięte. Parametr ColNameHeader może przyjmować tylko wartość False. W przypadku wpisania innej wartości dla parametru lub pominięcia parametru w pliku schema.ini, aplikacja przyjmuje domyślną wartość parametru – False. 4.2.6.2 Format XML Plik wyeksportowanych statusów przelewów ma następującą strukturę: <?xml version = '1.0' encoding = 'ISO-8859-2'?> <statusy> <przelew> <status>Status przelewu</status> <blad>Opis błędu w przelewie. Tag jest dostępny jeśli uzupełniona jest informacja o przyczynie odrzucenia przelewu z systemu def3000/CB. Jeśli informacja o przyczynie odrzucenia zawiera informację techniczną to prezentowana będzie wartość: 'Problem wewnętrzny'</blad> <modulo>Modulo klienta</modulo> <nrb>Rachunek obciążany</nrb> <data_wpisu>Data wpisu przelewu</data_wpisu> <data_zlecenia>Data zlecenia</data_zlecenia> <id>Identyfikator przelewu</id> <bank>Numer banku odbiorcy</bank> <rachunek>Numer rachunku odbiorcy</rachunek> <kwota>Kwota przelewu</kwota> <waluta>Waluta przelewu</waluta> <referencje>Referencje użytkownika</referencje> <nazwa1>nazwa odbiorcy</nazwa1> <nazwa2>nazwa odbiorcy</nazwa2> <nazwa3>nazwa odbiorcy</nazwa3> <nazwa4>nazwa odbiorcy</nazwa4> <tresc1>treść przelewu</tresc1> <tresc2>treść przelewu</tresc2> 45 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA <tresc3>treść przelewu</tresc3> <tresc4>treść przelewu</tresc4> </przelew> ... </statusy> Każde powtórzenie tagów <przelew> ... </przelew> jest traktowane jako kolejny przelew z listy. Format XML nie wymusza konkretnej kolejności pól zawartych w pliku. Poszczególne tagi prezentowane są w przypadku występowania odpowiednich danych w polach. Oznacza to, że w przypadku gdy pole nie będzie wypełnione wówczas nie jest ono uwzględniane w elemencie <przelew>. 4.2.7 Struktura plików eksportu listy wyciągów 4.2.7.1 Format liniowy W pliku eksportu wyciągów w formacie liniowym informacja o pojedynczej operacji zajmuje jedną linię (rekord) zakończoną znakami <CRLF>. Każda linia składa się z pól zawierających poszczególne dane operacji. Pola występują w pliku w określonej kolejności, zgodnie z opisem struktury zdefiniowanym w pliku schema.ini. Pola oddzielone są separatorem (określonym w pliku schema.ini) lub są stałej długości. Dopuszczalny zestaw pól opisujących dane operacji wraz z formatem danych dla każdego pola przedstawiono w tabeli: N – pole numeryczne C – pole tekstowe Pole Długość Typ Opis id_tr_def 10 N Liczba porządkowa operacji w dniu księgowym data_waluty 10 C Data operacji tresc_d 20 C Skrócony opis operacji bank 8 N Numer rozliczeniowy banku kontrahenta rachunek 34 C Numer rachunku kontrahenta kwota 22/2 N Kwota przelewu strona 1 C strona operacji: D - Debit (Winien), C - Credit (Ma) waluta 3 C Waluta rachunku obciążanego nazwa1 35 C Nazwa kontrahenta – wiersz 1 nazwa2 35 C Nazwa kontrahenta – wiersz 2 nazwa3 35 C Nazwa kontrahenta – wiersz 3 nazwa4 35 C Nazwa kontrahenta – wiersz 4 tresc1 35 C Treść operacji– wiersz 1 tresc2 35 C Treść operacji – wiersz 2 tresc3 35 C Treść operacji – wiersz 3 tresc4 35 C Treść operacji – wiersz 4 Poniżej przedstawiono przykładowy opis struktury dla pliku z danymi o operacjach: [operacje_lin.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=ID_TR_DEF Integer Col2=DATA_WALUTY Char Width 10 46 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Col3=TRESC_D Char Width 20 Col4=BANK Integer Col5=RACHUNEK Char Width 34 Col6=KWOTA Float Col7=STRONA Char Width 1 Col8=WALUTA Char Width 3 Uwaga: Nazwy pól w opisie struktury powinny być pisane dużymi literami. Rodzaj separatora pól rekordu określa parametr Format. Format= Delimited (x) oznacza, że pola rekordu oddzielone są znakiem x – w poniższym przykładzie średnikiem. Format =FixedLength oznacza plik stałopozycyjny, w którym pola rekordu mają stałą długość. W takim przypadku konieczne jest określenie długości poszczególnych pól w opisie struktury. Parametry MaxScanRows oraz CharacterSet zostały umieszczone w opisie struktury dla zachowania zgodności ze standardem ODBC. Parametry te są ignorowane przez aplikację GB24 i w opisie struktury schema.ini mogą zostać pominięte. Parametr ColNameHeader może przyjmować tylko wartość False. W przypadku wpisania innej wartości dla parametru lub pominięcia parametru w pliku schema.ini, aplikacja przyjmuje domyślną wartość parametru – False. 4.2.7.2 Format XML W formacie XML dozwolone są następujące tagi (tekst pogrubiony jest stały): <?xml version = '1.0' encoding = 'ISO-8859-2'?> <wyciagi data_od="data początku" data_do="data waluta="waluta rachunku" nazwa="nazwa klienta"> <wyciag data="data zestawienia" rachunek="numer nazwa="nazwa klienta"> <saldo_otwarcia> <kwota>kwota otwarcia</kwota> <strona>strona(C/D)</strona> </saldo_otwarcia> <operacja> <pozycja>pozycja operacji na liście</pozycja> <data_waluty>data waluty</data_waluty> <opis>opis operacji</opis> <bank>numer banku</bank> <rachunek>numer rachunku</rachunek> <kwota>kwota operacji</kwota> <strona>strona operacji</strona> <waluta>waluta operacji</waluta> <nazwa1>nazwa odbiorcy</nazwa1> <nazwa2>nazwa odbiorcy</nazwa2> <nazwa3>nazwa odbiorcy</nazwa3> <nazwa4>nazwa odbiorcy</nazwa4> <tresc1>treść operacji</tresc1> <tresc2>treść operacji</tresc2> <tresc3>treść operacji</tresc3> <tresc4>treść operacji</tresc4> </operacja> ... <saldo_zamkniecia> <kwota>kwota zamknięcia</kwota> <strona>strona (C/D)</strona> </saldo_zamkniecia> </wyciag> ... </wyciagi> końca" rachunek="numer rachunku" opis="opis rachunku" rachunku" opis="opis rachunku" waluta="waluta rachunku" Każde powtórzenie tagów <operacja> ... </operacja> jest traktowane jako kolejna operacja z zestawienia. Każde powtórzenie tagów <wyciag> ... </wyciag> jest traktowane jako kolejny wyciąg z listy. 4.2.7.3 Format MT940 (SWIFT) Plik eksportu wyciągów w formacie MT940 składa się z 3 sekcji: pierwszej, drugiej i czwartej. 47 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Sekcje pierwsza i druga rozpoczynają się i kończą w pierwszej linii komunikatu. Również ich pola znajdują się w pierwszej linii pliku. Sekcja czwarta rozpoczyna się w pierwszej linii jednak każde jej pole umieszczone musi być w nowej linii – również zamknięcie sekcji czwartej znajduje się w nowej, ostatniej linii komunikatu. Sekcje otwierają i zamykają znaki klamry: '{' i '}'. Układ sekcji i ich pól (opis pól znajduje się w dalszej części dokumentacji) dla komunikatu MT940 jest następujący: {1:F01}{2:O940}{4: :20: :25: :28: :60F: (lub :60M:) :61: :86: :62F: (lub :62M:) -} W przypadku gdy komunikat ma więcej niż 10 operacji zostanie on podzielony na części - każda po maksymalnie 10 operacji. W takim przypadku, pierwsza część będzie zawierać w sekcji czwartej pola :20:, :25:, :28:, :60F:, :61:, :86:, :62M:, ostatnia część pola :20:, :25:, :28:, :60M:, :61:, :86:, :62F:, a wszystkie części pomiędzy nimi :20:, :25:, :28:, :60M:, :61:, :86:, :62M:. Warunki budowania pliku: 1 przed każdą linią stosuje się ciąg znaków <CR><LF> 2 żadna z linii nie może być pusta lub składać się z samej spacji, 3 żadna z linii (z wyjątkiem ostatniej linii sekcji 4 oraz linii składowych pola :86:) nie może zaczynać się od znaku ‘-’ (myślnika), 4 zestaw dopuszczalnych znaków SWIFT zawiera znaki: 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '/', '', '?', ':', '(', ')', '.', ',', ''', '+', '{', '}', 'CR', 'LF', ' '. Użyte oznaczenia dla formatu danych w kolejnych polach: c – tylko cyfry, n – tylko cyfry i spacje, l – tylko litery, z – tylko litery i cyfry (c i l), s – wszystkie znaki dopuszczane przez SWIFT, k – liczba oznaczająca kwotę (separatorem dziesiętnym musi być przecinek ‘,’ a część dziesiętna musi zawsze być określona dwiema cyframi, np.: ‘12,25’ lub ‘1234,00’. Przykłady oznaczania formatu pól: 6c – maksymalnie sześć cyfr, 5n – maksymalnie pięć cyfr wraz ze spacjami, np.: ’12 34’, lub ‘12345’. 4!l – dokładnie 4 litery, 6*65s – do sześciu linii, każda po maksymalnie 65 dowolnych znaków SWIFT. Specyfikacja pól w pliku MT940: Etykieta F01 O940 :20: :25: Nazwa Nagłówek sekcji 1 Nagłówek sekcji 2 Numer referencyjny Identyfikator rachunku Format Opis 22!n Modulo Klienta. Pole uzupełniane od tyłu spacjami do 22 znaków. Przykład ‘F01123456 42!nN Modulo Klienta poprzedzone 10 znakami spacji. Pole uzupełniane od tyłu spacjami do 43 (razem z końcowym znakiem ‘N’). Pierwsze 10 znaków to spacje. Ostatni znak to ‘N’. Przykład ‘0940 6!c/9c Pierwszy ciąg znaków to data początkowa wyciągu w formacie RRMMDD. Drugi ciąg znaków to modulo Klienta. Przykład ‘:20:060302/123456’ 32n Numer NRB rachunku. ’ 123456 N’ 48 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA :28: :60F: Przykład 1 ‘:25:12 3456 7890 1234 5678 9012 3456’ Przykład 2 ‘:25:12345678901234567890123456’ 5c/3c Pierwszy ciąg znaków to identyfikator zestawienia (w przykładzie ‘10’). Drugi ciąg znaków to nr sekwencyjny kolejnych części zestawienia (w przykładzie ‘4’). Przykład ‘:28:10/4’ 1!l6!c3!l15k Format całego pola – łącznie do 25 znaków. Poniżej znajduje się opis w rozbiciu na poszczególne sekcje. 1!l Strona - znak ‘C’ dla salda kredytowego lub znak ‘D’ dla salda debetowego. 6!c Data początkowa zestawienia obrotów dziennych w formacie RRMMDD. 3!l Symbol waluty. 15k Kwota salda początkowego zestawienia obrotów dziennych. Przykład ‘:60F:C060302PLN12,34’ Numer zestawienia Saldo początkowe zestawienia ob. d. 6!c1!l15k22!s4 Format całego pola – łącznie do 68 znaków (nie c wliczając znaków nowej linii). Poniżej znajduje się opis <CR><LF>20s w rozbiciu na poszczególne sekcje. :61: Szczegóły każdej operacji. 6!c Data waluty w formacie RRMMDD. 1!l Strona - znak ‘C’ dla salda kredytowego lub znak ‘D’ dla salda debetowego. 15k Kwota operacji. 22!s4c Referencja operacji składająca się ze stałego ciągu 22 znaków: ‘FMSCNONREF //’ oraz liczby porządkowej operacji na wyciągu. Przykład: ‘FMSCNONREF //7’. <CR><LF>20s Treść krótka operacji (w nowej linii). :86: :62F: Przykład ‘:61:060302D12,00FMSCNONREF Przelew do US’ 6*65s Nazwa kontrahenta i tytuł płatności (każdą linię poprzedza kombinacja znaków <CR><LF>). Pole nie jest uzupełniane pustymi liniami ani znakami spacji. Przykład ‘:86:42156011081112223344556677 INTERMODA S.A. UL.NOWA 35 53-508 WROCLAW ZAPŁATA ZA FAKTURE 1!l6!c3!l15k Format całego pola – łącznie do 25 znaków. Poniżej znajduje się opis w rozbiciu na poszczególne sekcje. 1!l Strona - znak ‘C’ dla salda kredytowego lub znak ‘D’ dla salda debetowego. Szczegóły operacji Saldo końcowe zestawienia ob. d. //7 49 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA :60M: (:62M:) Saldo początkowe (końcowe) części zestawienia ob. d. 6!c Data końcowa zestawienia obrotów dziennych w formacie RRMMDD. 3!l Symbol waluty. 15k Kwota salda końcowego zestawienia obrotów dziennych. Przykład ‘:62F:C060302PLN25,00’ 1!l6!c3!l15k Format całego pola – łącznie do 25 znaków. Poniżej znajduje się opis w rozbiciu na poszczególne sekcje. 1!l Strona - znak ‘C’ dla salda kredytowego lub znak ‘D’ dla salda debetowego. 6!c Data początkowa (końcowa) części zestawienia obrotów dziennych w formacie RRMMDD. 3!l Symbol waluty. 15k Kwota salda początkowego (końcowego) części zestawienia obrotów dziennych. Przykład 1 ‘:60M:C060302PLN12,34’ Przykład 2 ‘:62M:C060302PLN25,00’ Z uwagi na fakt, że zestaw dopuszczalnych znaków SWIFT nie zawiera polskich znaków diakrytycznych, znaki te w pliku eksportu są zamieniane na ich odpowiedniki łacińskie. 4.2.8 Struktura plików eksportu operacji bieżących 4.2.8.1 Format liniowy W pliku eksportu zestawienia operacji bieżących w formacie liniowym informacja o pojedynczej operacji zajmuje jedną linię (rekord) zakończoną znakami <CRLF>. Każda linia składa się z pól zawierających poszczególne dane operacji. Pola występują w pliku w określonej kolejności, zgodnie z opisem struktury zdefiniowanym w pliku schema.ini. Pola oddzielone są separatorem (określonym w pliku schema.ini) lub są stałej długości. Dopuszczalny zestaw pól opisujących dane operacji wraz z formatem danych dla każdego pola przedstawiono w poniższej tabeli. Typy danych stosowane przy opisie pól: N – pole numeryczne C – pole tekstowe Pole Długość Typ Opis id_transakcji 10 N Liczba porządkowa operacji id_an_def 10 N Iidentyfikator rachunku do obciążenia data_waluty 10 C Data operacji typ_operacja 100 C Nazwa typu operacji tresc_d 20 C Skrócony opis operacji bank 8 N Numer rozliczeniowy banku kontrahenta rachunek 34 C Numer rachunku kontrahenta kwota 22/2 N Kwota operacji strona 1 C strona operacji: D - Debit (Winien), C - Credit (Ma) waluta 3 C Waluta rachunku obciążanego nazwa1 35 C Nazwa kontrahenta – wiersz 1 nazwa2 35 C Nazwa kontrahenta – wiersz 2 50 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA nazwa3 35 C Nazwa kontrahenta – wiersz 3 nazwa4 35 C Nazwa kontrahenta – wiersz 4 tresc1 35 C Treść operacji– wiersz 1 tresc2 35 C Treść operacji – wiersz 2 tresc3 35 C Treść operacji – wiersz 3 tresc4 35 C Treść operacji – wiersz 4 Przykładowy opis struktury dla pliku z danymi o operacjach bieżących [operacje_biez.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=ID_TRANSAKCJI Integer Col2=DATA_WALUTY Char Width 10 Col3=TRESC_D Char Width 20 Col4=BANK Integer Col5=RACHUNEK Char Width 34 Col6=KWOTA Float Col7=STRONA Char Width 1 Col8=WALUTA Char Width 3 Col9=NAZWA1 Char Width 35 Col10=NAZWA2 Char Width 35 Col11=NAZWA3 Char Width 35 Col12=NAZWA4 Char Width 35 Col13=TRESC1 Char Width 35 Col14=TRESC2 Char Width 35 Col15=TRESC3 Char Width 35 Col16=TRESC4 Char Width 35 Uwaga: Nazwy pól w opisie struktury powinny być pisane dużymi literami. Rodzaj separatora pól rekordu określa parametr Format. Format= Delimited (x) oznacza, że pola rekordu oddzielone są znakiem x – w poniższym przykładzie średnikiem. Format =FixedLength oznacza plik stałopozycyjny, w którym pola rekordu mają stałą długość. W takim przypadku konieczne jest określenie długości poszczególnych pól w opisie struktury. Parametry MaxScanRows oraz CharacterSet zostały umieszczone w opisie struktury dla zachowania zgodności ze standardem ODBC. Parametry te są ignorowane przez aplikację GB24 i w opisie struktury schema.ini mogą zostać pominięte. Parametr ColNameHeader może przyjmować tylko wartość False. W przypadku wpisania innej wartości dla parametru lub pominięcia parametru w pliku schema.ini, aplikacja przyjmuje domyślną wartość parametru – False. 4.2.8.2 Format XML W formacie XML dozwolone są następujące tagi (tekst pogrubiony jest stały): <?xml version = '1.0' encoding = 'ISO-8859-2'?> <operacje> <operacja num=”numer kolejny operacji na liście”> <ord>identyfikator wewnętrzny</ord> <id_transakcji>identyfikator transakcji w systemie</id_transakcji> <id_an_def>identyfikator rachunku</id_an_def> <data_waluty>data waluty</data_waluty> <tresc_d>skrócony opis operacji</tresc_d> <tresc_1>opis operacji – linia 1</tresc_1> <tresc_2>opis operacji - linia 2</tresc_2> <tresc_3>opis operacji – linia3</tresc_3> <tresc_4>opis operacji – linia4</tresc_4> 51 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA <kwota>kwota operacji</kwota> <waluta>waluta operacji</waluta> <nazwa1>nazwa odbiorcy – linia1</nazwa1> <nazwa2>nazwa odbiorcy –linia2</nazwa2> <nazwa3>nazwa odbiorcy –linia3</nazwa3> <nazwa4>nazwa odbiorcy –linia4</nazwa4> <strona>strona operacji</strona> <rachunek>numer rachunku</rachunek> <bank>numer banku</bank> </operacja> ... </operacje> Każde powtórzenie tagów <operacja> ... </operacja> jest traktowane jako kolejna operacja z zestawienia. 5. Konfiguracja parametrów aplikacji Konfiguracja parametrów aplikacji umożliwia określenie struktur plików importowanych i eksportowanych w systemie oraz wczytanie struktur plików dla formatów liniowych. Konfiguracja parametrów aplikacji dostępna jest w opcji Konfiguracja -> Parametry aplikacji. Przed rozpoczęciem pracy w systemie należy ustawić odpowiednie struktury importowanych i eksportowanych plików a następnie kliknąć przycisk [Zapisz parametry] w celu zapisania ustawień w bazie danych. W opcji Konfiguracja -> Parametry aplikacji są dostępne następujące przyciski: · · · · [Import struktury] – służy do zaczytania pliku opisującego strukturę danych [Pokaż strukturę] – służy do obejrzenia zaczytanej struktury pod warunkiem, że taka struktura istnieje [Usuń strukturę] – usuwa zaczytaną strukturę z bazy danych [Zapisz parametry] – zapisuje bieżące ustawienia Tylko dla formatu liniowego wymagane jest zaczytanie struktury danych. Pozostałe formaty mają określoną stałą strukturę. Aby zaimportować strukturę należy w liście wyboru wybrać format Liniowy i kliknąć przycisk [Import struktury]. Po wskazaniu pliku struktury należy kliknąć przycisk [Importuj plik]. Następnie system sprawdzi plik i poprosi o wybranie nazwy dla zaimportowanej struktury. 52 Import i eksport danych w GB24 wersja 2.32.009 Getin Noble Bank SA Przycisk [Zapisz wybraną strukturę] powoduje zapisanie importowanej struktury do bazy danych. Przycisk [Nie zapisuj struktury] powoduje anulowanie całej akcji i usunięcie importowanej struktury. Aby obejrzeć zaimportowaną strukturę należy kliknąć przycisk [Pokaż strukturę]. 53