1. WSTĘP 2. DOSTĘPNE FUNKCJE IMPORTU I EKSPORTU DANYCH 2.1. FUNKCJE IMPORTU DANYCH

Transkrypt

1

2 SPIS TREŚCI 1. WSTĘP 2 2. OPIS FUNKCJI IMPORTU I EKSPORTU DANYCH FUNKCJE IMPORTU DANYCH IMPORT PRZELEWÓW KRAJOWYCH IMPORT PRZELEWÓW ZAGRANICZNYCH FUNKCJE EKSPORTU DANYCH EKSPORT LISTY PRZELEWÓW KRAJOWYCH EKSPORT STATUSÓW PRZELEWÓW KRAJOWYCH EKSPORT POTWIERDZEŃ PRZELEWÓW ZAGRANICZNYCH EKSPORT HISTORII RACHUNKU LISTA TRANSAKCJI FORMATY DANYCH I STRUKTURY PLIKÓW FORMATY DANYCH STRUKTURY PLIKÓW STRUKTURY PLIKÓW IMPORTU PRZELEWÓW KRAJOWYCH PLIK W FORMACIE LINIOWYM PLIK W FORMACIE ELIXIR PLIK W FORMACIE XML PLIK W FORMACIE ISO STRUKTURA PLIKÓW IMPORTU PRZELEWÓW ZAGRANICZNYCH PLIK W FORMACIE LINIOWYM PLIK W FORMACIE XML PLIK W FORMACIE ISO STRUKTURA PLIKÓW EKSPORTU LISTY PRZELEWÓW KRAJOWYCH PLIK W FORMACIE ELIXIR PLIK W FORMACIE XML STRUKTURA PLIKU EKSPORTU STATUSÓW PRZELEWÓW KRAJOWYCH PLIK W FORMACIE XML STRUKTURA PLIKU EKSPORTU POTWIERDZEŃ PRZELEWÓW ZAGRANICZNYCH PLIK W FORMACIE XML PLIK W FORMACIE ISO STRUKTURA PLIKÓW EKSPORTU HISTORII RACHUNKU FORMAT TXT (TAB) FORMAT CSV FORMAT QIF FORMAT XML FORMAT PDF FORMAT ISO

3 WSTĘP W niniejszym materiale znajdziesz opisy funkcjonalności systemu BOŚBank24 Twoje e-konto w zakresie importu i eksportu danych, sposobu ich wykorzystywania oraz dostępne formaty i struktury plików. 2. DOSTĘPNE FUNKCJE IMPORTU I EKSPORTU DANYCH W systemie BOŚBank24 Twoje e-konto dostępne są następujące operacje dotyczące importu i eksportu danych: import przelewów krajowych (zwykły, podatku/cła), import przelewów zagranicznych, eksport przelewów krajowych, eksport statusów przelewów krajowych, eksport potwierdzeń przelewów zagranicznych, eksport historii rachunku FUNKCJE IMPORTU DANYCH Import przelewów krajowych Import przelewów krajowych w PLN (przelew zwykły, przelew podatku/cła) dostępny jest w opcji Transakcje Przelewy import/eksport Import przelewów krajowych. Po wybraniu opcji importu pojawi się okienko z możliwością wybrania pliku z danymi. Istnieje możliwość zaimportowania przelewów w formatach: LINIOWYM ELIXIR, XML oraz ISO20022 (dla przelewów zwykłych). 2

4 2.1. W celu zaimportowania przelewów należy: wybrać rachunek z dostępnej listy, na który będą importowane przelewy, używając przycisku [przeglądaj], należy wskazać lokalizację i nazwę pliku do importu, wybrać typ importowanego pliku: Elixir, liniowy, XML lub ISO20022, uruchomić import przyciskiem [wczytaj] lub wycofać się z wczytywania wybranego pliku przycisk [zrezygnuj]. Opcja Transakcje Przelewy import/eksport Import przelewów krajowych (krok 1/2). Po uruchomieniu importu system sprawdza zawartość wskazanego pliku oraz jego poprawność, a następnie prezentuje raport zawierający: nazwę oraz numer rachunku, na który będą zaimportowane przelewy, nazwę zaimportowanego pliku, typ zaimportowanego pliku, liczbę przelewów znalezionych w pliku oraz liczbę poprawnych i niepoprawnych przelewów. W przypadku niepoprawnych przelewów prezentowany jest: numer przelewu oraz opis błędu (np. niepoprawny rachunek odbiorcy, przekroczony dzienny limit przelewów). W celu ostatecznego wczytania poprawnych przelewów należy wybrać przycisk [importuj poprawne]. W przypadku rezygnacji z importu należy wybrać przycisk [zrezygnuj]. Opcja Transakcje Przelewy import/eksport Import przelewów krajowych (krok 2/2). 3

5 2.1. Opcja Transakcje Przelewy import/eksport Import przelewów krajowych (krok 2/2) Potwierdzenie poprawności importu przelewów. Po poprawnym zaimportowaniu przelewy dostępne są w opcji Koszyk lista transakcji w Koszyku i oczekują na Twoją autoryzację Import przelewów zagranicznych BOŚBank24 Twoje e-konto z poziomu zakładki Transakcje Przelewy import/eksport Import przelewów zagranicznych umożliwia importowanie z pliku przelewów do banków zagranicznych w walutach: AUD, CAD, CHF, CZK, DKK, EUR, GBP, HUF, JPY, NOK, PLN, RUB, SEK, USD lub do banków krajowych, ale tylko w walucie obcej. Istnieje możliwość zaimportowania przelewów w formacie ELIXIR, XML, ISO20022 lub o strukturze liniowej. 4

6 2.1. W celu zaimportowania przelewów zagranicznych należy wybrać opcję Import przelewów zagranicznych z menu bocznego aplikacji: wybrać rachunek z dostępnej listy, na który będą importowane przelewy, używając przycisku [przeglądaj], należy wskazać lokalizację i nazwę pliku do importu, wybrać typ importowanego pliku: liniowy, XML lub ISO20022, uruchomić import przyciskiem [wczytaj] lub wycofać się z wczytywania wybranego pliku przycisk [zrezygnuj]. Opcja Transakcje Przelewy import/eksport Import przelewów zagranicznych (krok 1/2). Po uruchomieniu importu system sprawdza zawartość wskazanego pliku oraz jego poprawność, a następnie prezentuje raport zawierający: nazwę oraz numer rachunku, na który będą zaimportowane przelewy, nazwę zaimportowanego pliku, typ zaimportowanego pliku, liczbę przelewów znalezionych w pliku oraz liczbę poprawnych i niepoprawnych przelewów. W przypadku niepoprawnych przelewów prezentuje numer przelewu oraz opis błędu (np. niepoprawny rachunek odbiorcy, brak kodu SWIFT). W celu ostatecznego wczytania poprawnych przelewów należy wybrać przycisk [importuj poprawne]. Opcja Transakcje Przelewy import/eksport Import przelewów zagranicznych (krok 2/2). 5

7 2.1. Opcja Transakcje Przelewy import/eksport Import przelewów zagranicznych (krok 2/2) Potwierdzenie. Po poprawnym zaimportowaniu przelewy dostępne są w opcji Koszyk lista transakcji w Koszyku i oczekują na autoryzację. 6

8 Funkcje eksportu danych Eksport przelewów krajowych Eksport przelewów krajowych dostępny jest w opcji Transakcje Przelewy import/eksport Eksport statusów przelewów krajowych. Eksport przelewów krajowych (zgodnie z prezentowaną listą transakcji) zostanie wykonany po dokonaniu wyboru formatu eksportu przelewów krajowych: XML lub ELIXIR, a następnie uruchomieniu przycisku [eksportuj przelewy krajowe]. Opcja Transakcje Przelewy import/eksport Eksport statusów przelewów krajowych. 7

9 2.2. Po wyborze formatu eksportu przelewów krajowych oraz kliknięciu przycisku [eksportuj przelewy krajowe] nastąpi pobranie danych z listą przelewów krajowych do pliku TXT lub XML. Plik można wyświetlić na ekranie lub zapisać we wskazanym miejscu. Opcja Transakcje Przelewy import/eksport Eksport przelewów krajowych. 8

10 Eksport statusów przelewów krajowych Eksport statusów przelewów krajowych (bieżących oraz odroczonych) dostępny jest w opcji Transakcje Przelewy import/eksport Eksport statusów przelewów krajowych. Eksport statusów przelewów krajowych (zgodnie z prezentowaną listą transakcji) zostanie wykonany w formacie XML po uruchomieniu przycisku [eksportuj statusy przelewów krajowych]. Opcja Transakcje Przelewy import/eksport Eksport statusów przelewów krajowych (w formacie XML). 9

11 2.2. Po kliknięciu przycisku [eksportuj statusy przelewów krajowych] nastąpi pobranie danych z listą statusów przelewów krajowych znajdujących się w dowolnym statusie do pliku w formacie XML. Plik można wyświetlić na ekranie lub zapisać we wskazanym miejscu. Opcja Transakcje Przelewy import/eksport Eksport statusów przelewów krajowych. 10

12 Eksport potwierdzeń przelewów zagranicznych Eksport potwierdzeń przelewów zagranicznych dostępny jest w opcji Transakcje Przelewy import/ eksport Eksport potwierdzeń przelewów zagranicznych. Eksport potwierdzeń przelewów zagranicznych (zgodnie z prezentowaną listą transakcji) zostanie wykonany po wyborze formatu: XML lub ISO20022 i uruchomieniu przycisku [eksportuj]. Opcja Transakcje Przelewy import/eksport Eksport potwierdzeń przelewów zagranicznych. 11

13 2.2. Po kliknięciu przycisku [eksportuj] nastąpi pobranie danych z listą potwierdzeń przelewów zagranicznych znajdujących się w dowolnym statusie do pliku w formacie XML lub ISO Plik można wyświetlić na ekranie lub zapisać we wskazanym miejscu. Opcja Transakcje Przelewy import/eksport Eksport potwierdzeń przelewów zagranicznych. 12

14 Eksport historii rachunku Eksport listy transakcji dla rachunku dostępny jest w opcji Rachunki Historia rachunku sekcja Historia rachunku lista transakcji przycisk [eksportuj historię do pliku]. Istnieje możliwość zapisu listy transakcji do pliku w formatach: TXT (TAB), QIF, CSV, XML, ISO20022 oraz PDF. Opcja Rachunki Historia rachunku. 13

15 2.2. Wybór formatu eksportu oraz kliknięcie przycisku [eksportuj historię do pliku] powoduje wygenerowanie pliku z listą transakcji oraz wyświetlenie poniższego komunikatu. Plik można wyświetlić na ekranie lub zapisać we wskazanym miejscu. Opcja Rachunki Historia rachunku Eksport historii do pliku (w formacie PDF). 14

16 3. 3. Formaty danych i struktury plików Formaty danych System BOŚBank24 Twoje e-konto 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, podatku/cła ELIXIR, liniowy, XML oraz ISO20022 (dla prze-lewów zwykłych). Format importu przelewów zagranicznych liniowy, XML, ISO Format eksportu przelewów krajowych ELIXIR, XML. Format eksportu statusów przelewów krajowych XML. Format eksportu potwierdzeń przelewów zagranicznych XML, ISO Format eksportu historii rachunku TXT (TAB), CSV, QIF, XML, PDF, ISO UWAGA: Formaty plików XML, ELIXIR oraz liniowy mają stałą określoną strukturę. Dla danych w formacie XML niedozwolone są następujące znaki: &, <, >. Dla powyższych znaków należy koniecznie zastosować następujące zamienniki: & & < < > &gt. 15

17 3.2. Struktury plików Poniżej opisane są poszczególne struktury plików obsługiwane przez system BOŚBank24 Twoje e-konto wraz z dokładnym opisem każdego pola oraz podanym przykładem Struktury plików importu przelewów krajowych Plik w formacie liniowym W formacie liniowym dane przelewów importowane są z pliku tekstowego. 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. Pola oddzielone są separatorem w postaci średnika (;). Polskie znaki są kodowane w ISO 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. D data w formacie DD.MM.RRRR, gdzie DD dzień, MM miesiąc, RRRR rok. Jeżeli data nie zostanie przez Ciebie podana, przyjęta zostanie bieżąca data dla płatności. C pole tekstowe. 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. * pole pomijane przy wczytywaniu do BOŚBank24 Twoje e-konto. Kolejność pola w rekordzie Pole Długość Pola Typ Opis pola 1 AAA* Pole pomijane przy wczytywaniu. 2 DATA 10 D Data zlecenia. Pole opcjonalne, jeśli nie wystąpi, przyjmowana jest data aktualna płatności. W przypadku zdefiniowania daty przyszłej w pliku importu zaimportowane przelewy prezentowane w transakcjach oczekujących oraz na liście przelewów odroczonych. 3 KWOTA 14/2 C Kwota zlecenia. Waluta domyślnie przyjmowana jako PLN. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 4 BBB* Pole pomijane przy wczytywaniu. 5 CCC* Pole pomijane przy wczytywaniu. 6 DDD* Pole pomijane przy wczytywaniu. 7 Numer rachunku beneficjenta w formacie NRB. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 8 Pole pomijane przy wczytywaniu. 16

18 Kolejność pola w rekordzie Pole Długość Pola Typ Opis pola 9 NAZWA 4*35 C W przypadku przelewów zwykłych oraz przelewów podatku pełna nazwa kontrahenta/urzędu Skarbowego lub innego organu podatkowego. Jeśli w polu występują znaki traktowane są jako separatory wierszy. Zamiast pola NAZWA mogą wystąpić cztery pola NAZWA1, NAZWA2, NAZWA3, NAZWA4, każde o długości 35 znaków. 10 FFF* Pole pomijane przy wczytywaniu. 11 GGG* Pole pomijane przy wczytywaniu. 12 TRESC 4*35 C Tytuł przelewu zwykłego 4x35 znaków. Dla przelewów US: Po słowie kluczowym /TI/ typ identyfikatora uzupełniającego i identyfikator uzupełniający, Po słowie kluczowym /OKR/ okres należności, Po słowie kluczowym /SFP/ symbol formularza płatności, Po słowie kluczowym / TXT/ opis zobowiązania. Jeśli w polu występują znaki traktowane są jako separatory wierszy. Zamiast pola TRESC dla przelewów zwykłych mogą wystąpić cztery pola TRESC1, TRESC2, TRESC3, TRESC4, każde o długości 35 znaków. 13 HHH* Pole pomijane przy wczytywaniu. 14 III* Pole pomijane przy wczytywaniu. 15 JJJ* Pole pomijane przy wczytywaniu. 16 REFERENCJE Referencja własna klienta. Pole opcjonalne. Przy czym wartość REFERENCJI będzie importowana i prezentowana w szczegółach przelewu. Maksymalna długość pola wynosi 50 znaków. 17 NAZWA_NAD 4*35 C Nazwa płatnika dla przelewów US (w formie 4 pola po 35 znaków). Pole opcjonalne. Jeśli nie wystąpi, system przyjmie nazwę klienta jako domyślną wartość dla pola płatnika zobowiązania. Dla przelewów zwykłych pole jest ignorowane. Jeśli w polu występują znaki traktowane są jako separatory wierszy. Zamiast pola NAZWA_NAD mogą wystąpić cztery pola NAZWA_NAD1, NAZWA_NAD2, NAZWA_NAD3, NAZWA_NAD4, każde o długości 35 znaków. 17

19 Przykładowa zawartość pliku importu w formacie liniowym Przelew zwykły: ; ;33.34;;;; ;;Jan Kowalski ul. Koszarowa Toruń;;;Tresc 1 Tresc 2 Tresc 3 Tresc 4;;;;Referencje; ;;;; Przelew podatku/cła: ; ;12.35;;;; ;;Urząd Skarbowy;;;/TI/N /OKR/04R/SFP/CIT2;;;;Referencje US;NazwaNad1;NazwaNad2;NazwaNad3;NazwaNad4; Plik w formacie Elixir Plik z przelewami do importu w formacie Elixir zapisany jest 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 oddzielonych separatorem w postaci przecinka (,). Pola tekstowe są objęte cudzysłowami te, 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. Polskie znaki są kodowane w ISO Typy danych stosowane przy opisie pól: Rekord danych musi mieć strukturę zgodną ze strukturą pliku przecinkowego Elixir. N pole numeryczne, wartością jest liczba całkowita. D data w formacie RRRRMMDD, gdzie RRRR rok, MM miesiąc, DD dzień, MM miesiąc, RRRR rok. Jeżeli data nie jest podawana, przyjmowana jest bieżąca data dla płatności. 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ładowo 150 zł należy zapisać jako 15000, 10 zł 90 gr jako 1090, zapis 50 oznacza kwotę 50 gr). 18

20 Do BOŚBank24 Twoje e-konto wczytywane są pola o statusie M, pola o statusie O są pomijane. Kolejność pola w rekordzie Pole wg Elixir Format Rozmiar Status pola Opis pola 1 Typ komunikatu 2 Data transakcji N 3 O Pole pomijane przy wczytywaniu. D 8 M Data zlecenia. Pole opcjonalne, jeśli nie wystąpi, przyjmowana jest data aktualna płatności. 3 Kwota K 15 M Kwota zlecenia. Waluta domyślnie przyjmowana jako PLN. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. 4 Nr jednostki N 8 O Pole pomijane przy wczytywaniu. 5 Nr jednostki odbierającej N 8 O Pole pomijane przy wczytywaniu. 6 Rachunek klienta nadawcy 7 Rachunek klienta adresata 8 Nazwa klienta nadawcy 9 Nazwa klienta adresata 10 Numer nadawcy uczestnika pośredniego 11 Numer oddziału finalny adresat 12 Informacje dodatkowe C 34 Pole pomijane przy wczytywaniu. Numer rachunku klienta nadawcy definiowany jest na formatce importu przelewów przed zaimportowaniem przelewów. C 34 M Numer rachunku beneficjenta. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. C 4*35 M Pole pomijane przy wczytywaniu. C 4*35 M W przypadku przelewów zwykłych nazwa kontrahenta 4x35 znaków. Jeśli w polu występują znaki traktowane są jako separatory wierszy. W przypadku przelewów podatku pole jest pomijane przy wczytywaniu. N 8 O Pole pomijane przy wczytywaniu. N 8 O Pole pomijane przy wczytywaniu. C 4*35 M Dla przelewu zwykłego: tytuł płatności przelewu 4x35 znaków. Dla przelewu US: 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. 19

21 Kolejność pola w rekordzie Pole wg Elixir Format Rozmiar Status pola Opis pola 13 Numer czeku C 10 O Pole pomijane przy wczytywaniu. 14 Szczegóły C 4*35 O Pole pomijane przy wczytywaniu. reklamacji 15 Dodatkowa C 34 O Pole pomijane przy wczytywaniu. identyfikacja spraw 16 Informacje C 16 O Pole pomijane przy wczytywaniu. międzybankowe 17 Dowolny tekst C 35 O Pole pomijane przy wczytywaniu. Dla przelewu podatku/cła, w polu TRESC, 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ładowa zawartość pliku importu w formacie Elixir Przelew zwykły:, ,210,,,, ,, JanKowalski ul.testowa Warszawa,,, Opłata1 Opłata2 Opłata3 Opłata4,,,,, Przelew podatku/cła:, ,0114,,,, ,,,,, /TI/N /OKR/06R/SF P/VAT-7/TXT/podatek za m-c maj,,,, 20

22 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 ?> <PRZELEWY> <PRZELEW> <DATA>Data płatności. Pole opcjonalne. Jeśli nie wystąpi, przyjmowana jest data aktualna jako data płatności. Format daty DD.MM.RRRR. </DATA> <RACHUNEK> NRB rachunku odbiorcy. Pole jest wymagane. Numer rachunku odbiorcy przelewu zwykłego. W przypadku przelewu US numer rachunku US. </RACHUNEK> <NAZWA1><NAZWA2><NAZWA3><NAZWA4> Nazwa odbiorcy w formie 4 pola po 35 znaków każde. Pole jest wymagane. </NAZWA1></NAZWA2></NAZWA3></NAZWA4> <KWOTA> Kwota przelewu podana w PLN. Pole wymagane. </KWOTA> <TRESC1><TRESC2><TRESC3><TRESC4> Tytuł płatności w formacie 4 pola po 35 znaków każde. Pole jest wymagane. dla zwykłego przelewu treść przelewu 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/ </TRESC1></TRESC2></TRESC3></TRESC4> <REFERENCJE> Referencja własna klienta. Pole opcjonalne. Przy czym wartość REFERENCJI będzie importowana i prezentowana w szczegółach przelewu. Maksymalna długość pola wynosi 50 znaków. </REFERENCJE> <NAZWA_NAD1><NAZWA_NAD2><NAZWA_NAD3><NAZWA_NAD4> Nazwa płatnika dla przelewów US i ZUS (w formie 4 pola po 35 znaków). Pole opcjonalne. Jeśli nie wystąpi, system przyjmie nazwę klienta jako domyślną wartość dla pola płatnika zobowiązania. Dla przelewów zwykłych pole jest ignorowane. 21

23 </NAZWA_NAD1></NAZWA_NAD2></NAZWA_NAD3></NAZWA_NAD4> </PRZELEW> </PRZELEWY> Każde powtórzenie tagów <przelew>... </przelew> jest interpretowane przez aplikację jako nowy przelew. Zamiast tagu <NAZWA1> mogą występować tagi <NAZWA1>, <NAZWA2>, <NAZWA3>, <NAZWA4> o długości 35 znaków każdy. Zamiast tagu <TRESC1> mogą występować tagi <TRESC1>, <TRESC2>, <TRESC3>, <TRESC4> o długości 35 znaków każdy. Zamiast tagu <NAZWA_NAD1> mogą występować tagi <NAZWA_NAD1>, <NAZWA_NAD12>, <NAZWA_NAD13>, <NAZWA_NAD14> o długości 35 znaków każdy. Przykładowy plik importu w formacie XML Przelew zwykły: <?xml version= 1.0 encoding= ISO ?> <PRZELEWY> <PRZELEW> <DATA> </DATA> <KWOTA>100</KWOTA> <RACHUNEK> </RACHUNEK> <NAZWA1>Anna Test</NAZWA1> <NAZWA2>ul. Testowa 1</NAZWA2> <NAZWA3>87-100</NAZWA3> <NAZWA4>Toruń</NAZWA4> <TRESC1>Opłata 1</TRESC1> <TRESC2>Opłata 2</TRESC2> <TRESC3>Opłata 3</TRESC3> <TRESC4>Opłata 4</TRESC4> <REFERENCJE>Referencje</REFERENCJE> <NAZWA_NAD1></NAZWA_NAD1> <NAZWA_NAD2></NAZWA_NAD2> <NAZWA_NAD3></NAZWA_NAD3> <NAZWA_NAD4></NAZWA_NAD4> </PRZELEW> </PRZELEWY> 22

24 Przelew podatku/cła: <?xml version= 1.0 encoding= ISO ?> <PRZELEWY> <PRZELEW> <DATA> </DATA> <KWOTA>50,50</KWOTA> <RACHUNEK> </RACHUNEK> <NAZWA1>Urząd Skarbowy</NAZWA1> <NAZWA2>ul. Podatkowa 1</NAZWA2> <NAZWA3>00-100</NAZWA3> <NAZWA4>Warszawa</NAZWA4> <TRESC1>/TI/N /OKR/09R/SFP/VAT-7/T</TRESC1> <TRESC2>XT/podatek za m-c maj 09</TRESC2> <TRESC3></TRESC3> <TRESC4></TRESC4> <REFERENCJE>Referencje US</REFERENCJE> <NAZWA_NAD1>Płatnik 1</NAZWA_NAD1> <NAZWA_NAD2>Płatnik 3</NAZWA_NAD2> <NAZWA_NAD3>Płatnik 3</NAZWA_NAD3> <NAZWA_NAD4>Płatnik 4</NAZWA_NAD4> </PRZELEW> </PRZELEWY> 23

25 Plik w formacie ISO20022 Do weryfikacji struktury pliku importu przelewów zwykłych w formacie ISO20022 wykorzystywany jest plik XSD w wersji pain Plik ten definiuje: strukturę pliku importu, listę pól i status ich wymagalności, walidację poszczególnych pól na poziomie formalnym (typy poszczególnych pól, dopuszczalne wartości dla pól słownikowych). W formacie ISO20022 można importować przelewy zwykłe (bez US). Nazwa elementu Typ Wymagalność Opis Document CstmrCdtTrfInitn GrpHdr MsgId 35x T (1) Dowolna wartość zgodna typem pola. CreDtTm ISODateTime T (1) Dowolna wartość zgodna typem pola. NbOfTxs 15d T Liczba zleceń przekazywana w komunikacie wejściowym. System będzie weryfikował wartość z ilością faktycznie przekazanych przelewów. InitgPty /InitgPty /GrpHdr PmtInf Dane przelewu. PmtInfId 35x T (1) Dowolna wartość zgodna typem pola. PmtMtd 3!a T Metoda płatności (Payment Method). Wymagana wartość TRF. ReqdExctnDt ISODate T Data realizacji przelewu (Requested Execution Date) Dbtr Dane Zleceniodawcy. Nm 140x T (1) Dowolna wartość zgodna typem pola. /Dbtr DbtrAcct Id Othr Id 34x T Rachunek Zleceniodawcy (Debtor Account) Dla systemu wartość ignorowana (import odbywa się w kontekście konkretnego rachunku klienta). /Othr /Id /DbtrAcct DbtrAgt FinInstnId /FinInstnId /DbtrAgt CdtTrfTxInf PmtId 24

26 Nazwa elementu Typ Wymagalność Opis EndToEndId 35x T Referencje/Sygnatura (Payment Identification - End to End Identification). /PmtId Amt InstdAmt T Kwota przelewu (Amount Instructed Amount). Kod waluty (zgodny z walutą rachunku obciążanego) zgodny z ISO Kwota musi być w przedziale od 0.01 do /Amt Cdtr Nm 140x T Nazwa Kontrahenta (Creditor Name). Dopuszcza się przekazanie nazwy składającej się z 2 części po maksymalnie 35 znaków (rozdzielonych separatorem ). PstlAdr AdrLine 70x Adres kontrahenta (ciąg dalszy nazwy). Pole może wystąpić 2 razy. Nazwa wypełniana jest jako 2 pola po 35 znaków. /PstlAdr /Cdtr CdtrAcct Id Othr Id 34x T Rachunek Kontrahenta (Creditor Account). Dopuszcza się tylko rachunek w formacie NRB. /Othr /Id /CdtrAcct RmtInf Ustrd 140x T Tytuł zlecenia (Remittance Information Unstructured) Dopuszcza się przesłanie więcej niż jednego pola. Każde pole będzie stanowić osobną linię. Linie 4 oraz kolejne zostaną połączone w jedną linię. Jeśli linia jest dłuższa niż 35 znaków nadmiarowe znaki zostają przeniesione do kolejnej linii. Jeśli ostatnia linia jest dłuższa niż 35 znaków zostaje skrócona do 35. /RmtInf /CdtTrfTxInf /PmtInf /CstmrCdtTrfInitn /Document (1) pole wymagalne ze względu na zgodność ze standardem ISO 20022, jednak nie interpretowane w systemie. 25

27 Poniżej przedstawiono przykładowy plik importu przelewu zwykłego w formacie ISO <?xml version= 1.0 encoding= utf-8?> <Document xmlns= urn:iso:std:iso:20022:tech:xsd:pain > <CstmrCdtTrfInitn> <GrpHdr> <MsgId>msgId_1</MsgId> <CreDtTm> T12:12:12</CreDtTm> <NbOfTxs>1</NbOfTxs> <InitgPty> <!--<Nm>Nm_1</Nm> <PstlAdr> <AdrTp>ADDR</AdrTp> <Dept>Dept_1</Dept> <SubDept>SubDept_1</SubDept> <StrtNm>10</StrtNm> <BldgNb>2</BldgNb> <PstCd>PstCd_1</PstCd> <TwnNm>TwnNm_1</TwnNm> <CtrySubDvsn>CtrySubDvsn_1</CtrySubDvsn> <Ctry>PL</Ctry> <AdrLine>AdrLine_1</AdrLine> </PstlAdr> <Id> <OrgId> <Othr> <Id>50DC532V</Id> </Othr> </OrgId> </Id> <CtryOfRes>PL</CtryOfRes> <CtctDtls> <NmPrfx>DOCT</NmPrfx> <Nm>Nm_2</Nm>--> <!--<PhneNb> </PhneNb>--> <!--<MobNb> </MobNb>--> <!--<FaxNb>str1234</FaxNb>--> <!-- < Adr>test@test.pl</ Adr> <Othr>othr</Othr> </CtctDtls>--> </InitgPty> </GrpHdr> <PmtInf> 26

28 <PmtInfId>PmtInfId</PmtInfId> <PmtMtd>TRF</PmtMtd> <ReqdExctnDt> </ReqdExctnDt> <Dbtr> <Nm>Dane Zleceniodawcy</Nm> </Dbtr> <DbtrAcct> <Id> <Othr> <Id> </Id> </Othr> </Id> <!--<Ccy>PLN</Ccy> <Nm>Nm_4</Nm>--> </DbtrAcct> <DbtrAgt> <FinInstnId> <!--<BICFI>BREXPLPWRZE</BICFI> <ClrSysMmbId> <MmbId>MmbId</MmbId> </ClrSysMmbId> <Nm>Nm_5</Nm> <PstlAdr> <AdrTp>ADDR</AdrTp> <Dept>Dept_2</Dept> <SubDept>SubDept_2</SubDept> <StrtNm>15</StrtNm> <BldgNb>3</BldgNb> <PstCd>PstCd_2</PstCd> <TwnNm>TwnNm_2</TwnNm> <CtrySubDvsn>CtrySubDvsn_2</CtrySubDvsn> <Ctry>PL</Ctry> <AdrLine>AdrLine_2</AdrLine> </PstlAdr> <Othr> <Id>Id_1</Id> </Othr>--> </FinInstnId> </DbtrAgt> <CdtTrfTxInf> <PmtId> <EndToEndId>Referencje Sygnatura - maksymalnie1</endtoendid> 27

29 </PmtId> <Amt> <InstdAmt Ccy= PLN >10.01</InstdAmt> </Amt> <Cdtr> <Nm>Nazwa Kontrahenta druga linia nazwy kontrahenta trzecia linia</nm> <PstlAdr> <AdrLine>Adres kontrahenta</adrline> <AdrLine>druga linia Adres kontrahenta</adrline> </PstlAdr> </Cdtr> <CdtrAcct> <Id> <Othr> <Id> </Id> </Othr> </Id> <Ccy>PLN</Ccy> <Nm>Nm_7</Nm> </CdtrAcct> <RmtInf> <Ustrd>tytyl zlecenia1 0x0105 </Ustrd> <Ustrd>tytyl zlecenia2</ustrd> <Ustrd>tytyl zlecenia3 </Ustrd> <Ustrd>tytyl zlecenia4</ustrd> <Ustrd>tytyl zlecenia5</ustrd> <Ustrd>tytyl zlecenia6</ustrd> </RmtInf> </CdtTrfTxInf> </PmtInf> </CstmrCdtTrfInitn> </Document> 28

30 Struktura plików importu przelewów zagranicznych Plik w formacie liniowym W formacie liniowym dane przelewów zagranicznych importowane są z pliku tekstowego. 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, oddzielonych separatorem w postaci średnika (;). Pola występują w pliku w określonej kolejności, zgodnie z opisem. Plik nie może zawierać polskich znaków diakrytycznych (np. ą, ę, ż). Dopuszczalny zestaw pól opisujących przelew wraz z formatem danych dla każdego pola znajdziesz poniżej: N pole numeryczne C pole tekstowe. Pole Długość Typ Opis KWOTA 14/2 N Kwota przelewu. Pole wymagane. WALUTA 3 C Kod ISO waluty przelewu. Pole wymagane. RACHUNEK 34 N Numer rachunku beneficjenta w formacie IBAN. Pole wymagane. NAZWA1 140 C Pełna nazwa i adres beneficjenta 4x35 znaków. Pole wymagane Jeśli w polu występują znaki traktowane są jako separatory wierszy. Zamiast pola NAZWA1 mogą występować pola NAZWA1, NAZWA 2, NAZWA3, NAZWA4 o długości 35 znaków każde. Pole NAZWA1 jest pole wymaganym natomiast pola NAZWA2, NAZWA3 oraz NAZWA4 są polami opcjonalnymi. TRESC1 140 C Tytuł przelewu zagranicznego 4x35 znaków. Pole wymagane. Jeśli w polu występują znaki traktowane są jako separatory wierszy. Zamiast pola TRESC1 mogą występować pola TRESC1, TRESC2, TRESC3, TRESC4 o długości 35 znaków każde. Pole TRESC1 jest pole wymaganym natomiast pola TRESC2, TRESC3 oraz TRESC4 są polami opcjonalnymi. BANK_SWIFT 8 lub 11 C Kod SWIFT banku odbiorcy przelewu. Pole wymagane. znaków KOSZTY_POKRYWA 3 C Oznaczenie strony pokrywającej koszty przelewu (BEN, OUR, SHA). Pole wymagane. SYSTEM_ ROZLICZEŃ* 2 C System rozliczeń przelewu. Pole opcjonalne. Dostępne wartości: SW (system rozliczeń SWIFT), SE (system rozliczeń Sorbnet-Euro) oraz EE (system rozliczeń EuroElixir). W przypadku, gdy pole nie wystąpi lub nie zostanie zdefiniowana wartość w polu, domyślnie przyjmowany jest system rozliczeń SWIFT. TRYB_REALIZACJI 11 C Dla przelewów zagranicznych SWIFT pole określa tryb realizacji (priorytet) dla płatności. Dostępne opcje: STANDARDOWY, PILNY, EKSPRESOWY. Jeśli pole nie zostanie zdefiniowane w pliku wejściowym dla przelewów zagranicznego SWIFT przyjmowana jest domyślna wartość trybu realizacji jako STANDARDOWY. Pole ignorowane dla przelewów zagranicznych SEPA oraz TARGET2. * pole nie jest wymagane (jest dozwolona pusta wartość) 29

31 Przykładowa zawartość pliku z danymi przelewów zagranicznych w formacie liniowym 200;PLN;DE ;nazwa1;nazwa2;nazwa3;nazwa4;tresc1;tresc2;tresc3;tresc4;BREX PLPW;SHA;SW;STANDARDOWY;10,01;EUR; ;Zagraniczny1;;;;tytul1;;;;ABCADEFF;SHA;SP;; System dokonuje weryfikacji, czy importowane przelewy SWIFT spełniają kryteria przelewu SEPA: waluta EUR, rachunek odbiorcy w formacie IBAN, bank odbiorcy uczestnik SEPA opcja kosztowa SHA, nie może być ustawiony tryb Ekspresowy. W przypadku pozytywnej weryfikacji (przelew SWIFT spełnia warunki przelewu SEPA) system oznaczy taki przelew jako błędny z podaniem przyczyny błędu. Podczas importu dla przelewów SEPA system wyznaczy kod SWIFT odbiorcy na podstawie nr IBAN rachunku odbiorcy przelewu (nr SWIFT podany w pliku będzie ignorowany) 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 ?> <PRZELEWY> <PRZELEW> <RACHUNEK> Numer rachunku odbiorcy w formacie IBAN. Pole jest wymagane. </RACHUNEK> <NAZWA1><NAZWA2><NAZWA3><NAZWA4> Nazwa odbiorcy w formie 4 pola po 35 znaków każde. Pole NAZWA 1 jest polem wymaganym. Pola NAZWA2, NAZWA3, NAZWA 4 to pola opcjonalne. </NAZWA1></NAZWA2></NAZWA3></NAZWA4> <KWOTA> Kwota przelewu. Pole wymagane. </KWOTA> <WALUTA> Waluta przelewu. Pole wymagane. </WALUTA> <TRESC1><TRESC2><TRESC3><TRESC4> Tytuł płatności w formacie 4 pola po 35 znaków każde. Pole TRESC1 jest polem wymaganym. Pola TRESC2, TRESC3, TRESC4 to pola opcjonalne. </TRESC1></TRESC2></TRESC3></TRESC4> <SYSTEM_ROZLICZEN> System rozliczeń przelewu zagranicznego. Pole opcjonalne. Dostępne wartości: SW (system rozliczeń SWIFT), SP (system rozliczeń SEPA) oraz T2 (system rozliczeń Target2). 30

32 W przypadku, gdy pole nie wystąpi lub nie zostanie zdefiniowana wartość, domyślnie przyjmowany jest system rozliczeń SWIFT. </SYSTEM_ROZLICZEN> <BANK_SWIFT> Kod SWIFT banku odbiorcy przelewu. Pole wymagane. Wartość w polu 8 lub 11 znaków. </BANK_SWIFT> <KOSZTY_POKRYWA> Oznaczenie strony pokrywającej koszty przelewu. Pole wymagane. OUR wszystkie koszty oraz prowizje bankowe pokrywa zleceniodawca BEN wszystkie koszty oraz prowizje bankowe pokrywa beneficjent SHA koszty i prowizje po stronie banku zleceniodawcy pokrywa zleceniodawca, a po stronie beneficjenta pokrywa beneficjent </KOSZTY_POKRYWA> <TRYB_REALIZACJI> Dla przelewów zagranicznych SWIFT pole określa tryb realizacji (priorytet) dla płatności. Dostępne opcje: STANDARDOWY, PILNY, EKSPRESOWY. Jeśli pole nie zostanie zdefiniowane w pliku wejściowym przyjmowana jest dla przelewu zagranicznego SWIFT domyślna wartość trybu realizacji jako STANDARDOWY. Dla przelewów zagranicznych SEPA oraz TARGET2 pole ignorowane. </TRYB_REALIZACJI> </PRZELEW> </PRZELEWY> Każde powtórzenie tagów <przelew>... </przelew> oznacza dane nowego przelewu zagranicznego. Plik nie może zawierać polskich znaków diakrytycznych. Przykładowy plik w formacie XML zawierający dane o przelewie zagranicznym <?xml version= 1.0 encoding= iso ?> <PRZELEWY> <PRZELEW> <RACHUNEK>SE </RACHUNEK> <NAZWA1>nazwa1</NAZWA1> <KWOTA>100</KWOTA> <WALUTA>EUR</WALUTA> <TRESC1>faktura</TRESC1> <SYSTEM_ROZLICZEN>SW</SYSTEM_ROZLICZEN> <BANK_SWIFT>ESAAAESSAXX</BANK_SWIFT> <KOSZTY_POKRYWA>SHA</KOSZTY_POKRYWA> <TRYB_REALIZACJI>PILNY</TRYB_REALIZACJI> </PRZELEW> <PRZELEW> <RACHUNEK> SE </RACHUNEK> <NAZWA1>nazwa1</NAZWA1> 31

33 <KWOTA>123</KWOTA> <WALUTA>EUR</WALUTA> <TRESC1>faktura2</TRESC1> <SYSTEM_ROZLICZEN>SP</SYSTEM_ROZLICZEN> <BANK_SWIFT>BAKOAAAWAXX</BANK_SWIFT> <KOSZTY_POKRYWA>SHA</KOSZTY_POKRYWA> </PRZELEW> </PRZELEWY> System dokonuje weryfikacji, czy importowane przelewy SWIFT spełniają kryteria przelewu SEPA: waluta EUR, rachunek odbiorcy w formacie IBAN, bank odbiorcy uczestnik SEPA opcja kosztowa SHA, nie może być ustawiony tryb Ekspresowy. W przypadku pozytywnej weryfikacji (przelew SWIFT spełnia warunki przelewu SEPA) system oznaczy taki przelew jako błędny z podaniem przyczyny błędu. Podczas importu dla przelewów SEPA system wyznaczy kod SWIFT odbiorcy na podstawie nr IBAN rachunku odbiorcy przelewu (nr SWIFT podany w pliku będzie ignorowany) Plik w formacie ISO20022 Do weryfikacji struktury pliku importu przelewów zwykłych w formacie ISO20022 wykorzystywany jest plik XSD w wersji pain Plik ten definiuje: strukturę pliku importu, listę pól i status ich wymagalności, walidację poszczególnych pól na poziomie formalnym (typy poszczególnych pól, dopuszczalne wartości dla pól słownikowych). Interpretacja biznesowa poszczególnych pól zawartych w importowanym pliku zawarta jest w poniższej tabeli: Nazwa elementu Typ Wymagalność Opis Document CstmrCdtTrfInitn GrpHdr MsgId 35x T (1) Dowolna wartość zgodna typem pola. CreDtTm ISODateTime T (1) Dowolna wartość zgodna typem pola. NbOfTxs 15d T Liczba zleceń przekazywana w komunikacie wejściowym. System będzie weryfikował wartość z ilością faktycznie przekazanych przelewów. InitgPty /InitgPty /GrpHdr 32

34 Nazwa elementu Typ Wymagalność Opis /GrpHdr PmtInf Dane przelewu PmtInfId 35x T (1) Dowolna wartość zgodna typem pola. PmtMtd 3!a T Metoda płatności (Payment Method) Wymagana wartość TRF ReqdExctnDt ISODate T (1) Data wykonania/data waluty (Requested Execution Date) Dowolna wartość zgodna z typem pola. Dbtr Dane zleceniodawcy Nm 140x T (1) Dowolna wartość zgodna typem pola. /Dbtr DbtrAcct Id IBAN 34x T Rachunek Zleceniodawcy (Debtor Account). W systemie wartość ignorowana (import odbywa się w kontekście rachunku klienta). /Id /DbtrAcct DbtrAgt FinInstnId /FinInstnId /DbtrAgt CdtTrfTxInf PmtId EndToEndId 35x T Referencje/Sygnatura (Payment Identification Endto End Identification). /PmtId PmtTpInf InstrPrty NORM O Priorytet zlecenia (Instruction Priority): NORM standardowy HIGH ekspresowy Używany wyłącznie dla przelewów SWIFT. Brak parametru: system przyjmuje wartość NORM SvcLvl Cd O Kod typu płatności Dopuszczalne wartości się wartości: SWFT przelew SWIFT SEPA przelew SEPA TRG2 przelew TARGET2 /SvcLvl /PmtTpInf Amt InstdAmt T Kwota przelewu (Amount Instructed Amount). Kod waluty zgodny z ISO Kwota musi być w przedziale od0.01 do /Amt 33

35 Nazwa elementu Typ Wymagalność Opis ChrgBr T Rozliczenie opłat (Charge Bearer). Dopuszczalne kody dla SWIFT i TARGET2: CRED opłatę ponosi Creditor DEBT opłatę ponosi Debtor SHAR opłatą dzielą się po równo Creditor i Debtor Dopuszczalne kody dla SEPA: SLEV opłaty dzielą się po równo CdtrAgt FinInstnId BICFI T Identyfikator (BIC) Banku kontrahenta (Creditor Agent) /FinInstnId /CdtrAgt Cdtr Nm 140x T Nazwa Kontrahenta (Creditor Name). Dopuszcza się przekazanie nazwy składającej się z 2 części po maksymalnie 35 znaków (rozdzielonych separatorem ). PstlAdr AdrLine 70x Adres kontrahenta (ciąg dalszy nazwy). Pole może wystąpić 2 razy. Nazwa wypełniana jest jako 2 pola po 35 znaków. /PstlAdr /Cdtr CdtrAcct Id IBAN T Rachunek kontrahenta (Creditor Account) W systemie wartość ignorowana (import odbywa się w kontekście rachunku klienta). /Id /CdtrAcct RmtInf Ustrd 140x T Tytuł zlecenia (Remittance Information Unstructured) Dopuszcza się przesłanie więcej niż jednego pola. Każde pole będzie stanowić osobną linię. Linie 4 oraz kolejne zostaną połączone w jedną linię. Jeśli linia jest dłuższa niż 35 znaków nadmiarowe znaki zostają przeniesione do kolejnej linii. Jeśli ostatnia linia jest dłuższa niż 35 znaków zostaje skrócona do 35 znaków. /RmtInf /CdtTrfTxInf /PmtInf /CstmrCdtTrfInitn /Document (1) pole wymagalne ze względu na zgodność ze standardem ISO 20022, jednak nie interpretowane w systemie. 34

36 Poniżej przedstawiono przykładowy plik importu przelewu zagranicznego w formacie ISO <?xml version= 1.0 encoding= iso ?> <Document xmlns= urn:iso:std:iso:20022:tech:xsd:pain > <CstmrCdtTrfInitn> <GrpHdr> <MsgId>msgId_1</MsgId> <CreDtTm> T12:12:12</CreDtTm> <NbOfTxs>1</NbOfTxs> <InitgPty> <Nm>Nm_1</Nm> <PstlAdr> <AdrTp>ADDR</AdrTp> <Dept>Dept_1</Dept> <SubDept>SubDept_1</SubDept> <StrtNm>10</StrtNm> <BldgNb>2</BldgNb> <PstCd>PstCd_1</PstCd> <TwnNm>TwnNm_1</TwnNm> <CtrySubDvsn>CtrySubDvsn_1</CtrySubDvsn> <Ctry>PL</Ctry> <AdrLine>AdrLine_1</AdrLine> </PstlAdr> <Id> <OrgId> <Othr> <Id>50DC532V</Id> </Othr> </OrgId> </Id> <CtryOfRes>PL</CtryOfRes> <CtctDtls> <NmPrfx>DOCT</NmPrfx> <Nm>Nm_2</Nm> <!--<PhneNb> </PhneNb>--> <!--<MobNb> </MobNb>--> <!--<FaxNb>str1234</FaxNb>--> < Adr>test@test.pl</ Adr> <Othr>othr</Othr> </CtctDtls> </InitgPty> </GrpHdr> <!-- 1 przelew --> 35

37 <PmtInf> <PmtInfId>Przelew zagraniczny</pmtinfid> <PmtMtd>TRF</PmtMtd> <ReqdExctnDt> </ReqdExctnDt> <Dbtr> <Nm>Dane zleceniodawcy</nm> </Dbtr> <DbtrAcct> <Id> <IBAN>PL </IBAN> </Id> <Ccy>PLN</Ccy> <Nm>Nm_4</Nm> </DbtrAcct> <DbtrAgt> <FinInstnId> <BICFI>BREXPLPWRZE</BICFI> <ClrSysMmbId> <MmbId>MmbId</MmbId> </ClrSysMmbId> <Nm>Nm_5</Nm> <PstlAdr> <AdrTp>ADDR</AdrTp> <Dept>Dept_2</Dept> <SubDept>SubDept_2</SubDept> <StrtNm>15</StrtNm> <BldgNb>3</BldgNb> <PstCd>PstCd_2</PstCd> <TwnNm>TwnNm_2</TwnNm> <CtrySubDvsn>CtrySubDvsn_2</CtrySubDvsn> <Ctry>PL</Ctry> <AdrLine>AdrLine_2</AdrLine> </PstlAdr> <Othr> <Id>Id_1</Id> <Issr>Test</Issr> </Othr> </FinInstnId> </DbtrAgt> <CdtTrfTxInf> <PmtId> <EndToEndId>Test</EndToEndId> </PmtId> 36

38 <PmtTpInf> <InstrPrty>HIGH</InstrPrty> <SvcLvl> <Cd>TRG2</Cd> </SvcLvl> </PmtTpInf> <Amt> <InstdAmt Ccy= EUR >0.01</InstdAmt> </Amt> <ChrgBr>SHAR</ChrgBr> <CdtrAgt> <FinInstnId> <BICFI>DEUTDEFF</BICFI> </FinInstnId> </CdtrAgt> <Cdtr> <Nm>Nazwa kontrahenta John Test Engl trzecia linia ignorowana</nm> <PstlAdr> <AdrLine>Testowa 1</AdrLine> <AdrLine>Miasto</AdrLine> </PstlAdr> </Cdtr> <CdtrAcct> <Id> <IBAN>DE </IBAN> </Id> </CdtrAcct> <RmtInf> <Ustrd>Tytul przelewu zagranicznego 1 </Ustrd> <Ustrd>Tytul przelewu zagranicznego 2</Ustrd> <Ustrd>Tytul przelewu 3</Ustrd> <Ustrd>Tytul przelewu zagranicznego 4</Ustrd> <Ustrd>Tytul przelewu 5</Ustrd> <Ustrd>Tytul przelewu zagranicznego 6</Ustrd> <Ustrd>Tytul przelewu 7</Ustrd> <Ustrd>Tytul przelewu zagranicznego 8</Ustrd> </RmtInf> </CdtTrfTxInf> </PmtInf> <!-- 2gi przelew --> </CstmrCdtTrfInitn> </Document> 37

39 Struktura plików eksportu przelewów krajowych Plik w formacie Elixir Plik wyeksportowanych danych z listą przelewów w formacie Elixir zapisywany jest w pliku 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 oddzielonych separatorem w postaci przecinka (,). Pola występują w ustalonej kolejności zgodnie z poniższym opisem. Pola tekstowe są objęte cudzysłowami te, dla których nie jest przekazywana wartość, są zapisane jako pusty string ( ). Puste pola końcowe rekordu są pomijane. Typy danych stosowane przy opisie pól: Znakiem podziału linii w obrębie pola jest znak. Polskie znaki są kodowane w ISO Rekord danych ma strukturę zgodną ze strukturą pliku przecinkowego Elixir. N pole numeryczne, wartością jest liczba całkowita. D data w formacie RRRRMMDD, gdzie RRRR rok, MM miesiąc, DD dzień. C pole tekstowe. Dozwolone znaki zgodne z wymaganiami systemu Elixir. Rozmiar pola 4*35 oznacza, że pole 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. Kwota nie zawiera żadnych separatorów dla części ułamkowej ani separatorów tysięcy (przykładowo: 150 zł zapisywana jest jako 15000, 10 zł 90 gr jako 1090, zapis 50 oznacza kwotę 50 gr). Kolejność pola w rekordzie Pole wg Elixir 1 Typ komunikatu 2 Data transakcji Format Rozmiar Opis pola N 3 Pole pomijane. D 8 Data zlecenia. Pole opcjonalne, jeśli nie wystąpi, przyjmowana jest data aktualna płatności. 3 Kwota K 15 Kwota zlecenia. Waluta domyślnie przyjmowana jako PLN. 4 Nr jednostki N 8 Pole pomijane. prezentującej 5 Nr jednostki N 8 Pole pomijane. odbierającej 6 Rachunek klienta nadawcy C 34 Numer rachunku, z którego został złożony przelew. 38

40 Kolejność pola w rekordzie Pole wg Elixir 7 Rachunek klienta adresata 8 Nazwa klienta nadawcy 9 Nazwa klienta adresata 10 Numer nadawcy uczestnika pośredniego 11 Numer oddziału finalny adresat 12 Informacje dodatkowe Format Rozmiar Opis pola C 34 Numer rachunku beneficjenta. C 4*35 Dla przelewów zwykłych nazwa oraz dane adresowe nadawcy. W przypadku przelewów US nazwa klienta nadawcy jako płatnika zobowiązania płatnika. 4x35 znaków. Jeśli w polu występują znaki traktowane są jako separatory wierszy. C 4*35 W przypadku przelewów zwykłych nazwa kontrahenta 4x35 znaków. Jeśli w polu występują znaki traktowane są jako separatory wierszy. W przypadku przelewów podatku nazwa oraz adres Urzędu Skarbowego lub innego organu podatkowego. N 8 Pole pomijane. N 8 Pole pomijane. C 4*35 Dla przelewu zwykłego: tytuł płatności przelewu 4x35 znaków. Dla przelewu US: 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. 13 Numer czeku C 10 Pole pomijane. 14 Szczegóły reklamacji C 4*35 Pole pomijane. 15 Dodatkowa C 34 Pole pomijane. identyfikacja spraw 16 Informacje międzybankowe C 16 Pole pomijane. 17 Dowolny tekst C 35 Pole pomijane. 39

41 Przykładowy plik eksportu przelewów krajowych w formacie ELIXIR, ,5500,,, , , AR TURBORUBAR UL. SPORTOWA 34/ WARSZAWA, Anna Test ul. Testowa1/3,,, Wpłata.,, ,10000,,, , , KA TARZYNA JESIENNA, Zakład Ubezpieczeń Społecznych,,, /NIP/ /TI/R /TWP/S/DKL/012010/NRD/01 /DUT/ Plik w formacie XML Struktura pliku eksportu przelewów krajowych w formacie XML jest następująca: <?xml version= 1.0 encoding= ISO ?> <PRZELEWY> <PRZELEW> <DATA> Data przelewu </DATA> <RACHUNEK> NRB rachunku odbiorcy </RACHUNEK> <NAZWA1> Dane odbiorcy </NAZWA1> <NAZWA2> Dane odbiorcy </NAZWA2> <NAZWA3> Dane odbiorcy </NAZWA3> <NAZWA4> Dane odbiorcy </NAZWA4> <KWOTA> Kwota przelewu </KWOTA> <TRESC1> Tytuł płatności </TRESC1> <TRESC2> Tytuł płatności </TRESC2> 40

42 <TRESC3> Tytuł płatności TYTUL_PLATNOSCI_3 </TRESC3> <TRESC4> Tytuł płatności </TRESC4> <NAZWA_NAD1> Dane nadawcy </NAZWA_NAD1> <NAZWA_NAD2> Dane nadawcy </NAZWA_NAD2> <NAZWA_NAD3> Dane nadawcy </NAZWA_NAD3> <NAZWA_NAD4> Dane nadawcy </NAZWA_NAD4> <REFERENCJE> Referencje </REFERENCJE> <WALUTA> Waluta przelewu </WALUTA> </PRZELEW> </PRZELEWY> Przykładowy plik eksportu przelewów krajowych w formacie XML <?xml version= 1.0 encoding= ISO ?> -<PRZELEWY> 41

43 -<PRZELEW> <DATA> </DATA> <RACHUNEK> </RACHUNEK> <NAZWA1>Jan Kowalski</NAZWA1> <NAZWA2>ul. Bosiowa 1</NAZWA2> <NAZWA3> Warszawa</NAZWA3> <NAZWA4/> <KWOTA>0.01</KWOTA> <TRESC1>Faktura 123</TRESC1> <TRESC2/> <TRESC3/> <TRESC4/> <NAZWA_NAD1>JAN BOSSOWSKI</NAZWA_NAD1> <NAZWA_NAD2>al. JANA PAWŁA II 12</NAZWA_NAD2> <NAZWA_NAD3> WARSZAWA</NAZWA_NAD3> <NAZWA_NAD4/> <REFERENCJE/> <WALUTA>PLN</WALUTA> </PRZELEW> </PRZELEWY> Struktura pliku eksportu statusów przelewów krajowych Plik w formacie xml Struktura pliku eksportu statusów przelewów krajowych w formacie XML jest następująca: <?xml version= 1.0 encoding= ISO ?> <PRZELEWY> <PRZELEW> <DATA> Data księgowania lub data realizacji </DATA> <RACHUNEK> Rachunek odbiorcy </RACHUNEK> <NAZWA1> Dane odbiorcy </NAZWA1> 42

44 <NAZWA2> Dane odbiorcy </NAZWA2> <NAZWA3> Dane odbiorcy </NAZWA3> <NAZWA4> Dane odbiorcy </NAZWA4> <KWOTA> Kwota przelewu </KWOTA> <WALUTA> Waluta przelewu </WALUTA> <TRESC1> Tytuł płatności </TRESC1> <TRESC2> Tytuł płatności </TRESC2> <TRESC3> Tytuł płatności </TRESC3> <TRESC4> Tytuł płatności </TRESC4> <NAZWA_NAD1> Dane nadawcy </NAZWA_NAD1> <NAZWA_NAD2> Dane nadawcy </NAZWA_NAD2> <NAZWA_NAD3> Dane nadawcy </NAZWA_NAD3> <NAZWA_NAD4> Dane nadawcy </NAZWA_NAD4> <REFERENCJE> Referencje </REFERENCJE> <STATUS> Status przelewu krajowego </STATUS> <KOMUNIKAT_ODRZUCENIA> Komentarz (pole wypełniane tylko dla przelewów odrzuconych) </KOMUNIKAT_ODRZUCENIA> </PRZELEW> </PRZELEWY> Każde powtórzenie tagów <PRZELEW>... </PRZELEW> oznacza dane kolejnego przelewu. Polskie znaki są kodowane w formacie ISO

45 Przykładowy plik eksportu statusów przelewów krajowych w formacie XML <?xml version= 1.0 encoding= ISO ?> -<PRZELEWY> -<PRZELEW> <DATA> </DATA> <RACHUNEK> </RACHUNEK> <NAZWA1>Jan Kowalski</NAZWA1> <NAZWA2>ul. Bosiowa 1</NAZWA2> <NAZWA3> Warszawa</NAZWA3> <NAZWA4/> <KWOTA>0.01</KWOTA> <TRESC1>Faktura 123</TRESC1> <TRESC2/> <TRESC3/> <TRESC4/> <NAZWA_NAD1>JAN BOSSOWSKI</NAZWA_NAD1> <NAZWA_NAD2>al. JANA PAWŁA II 12</NAZWA_NAD2> <NAZWA_NAD3> WARSZAWA</NAZWA_NAD3> <NAZWA_NAD4/> <REFERENCJE/> <WALUTA>PLN</WALUTA> <STATUS_PRZELEWU>zrealizowany</STATUS_PRZELEWU> <KOMENTARZ_ODRZUCENIA/> </PRZELEW> </PRZELEWY> 44

46 Struktura pliku eksportu potwierdzeń przelewów zagranicznych Plik w formacie xml Struktura pliku eksportu potwierdzeń przelewów zagranicznych w formacie XML jest następująca: <PRZELEWY> <PRZELEW> <DATA_OPERACJI>Data wykonania</data_operacji> <RACHUNEK>Numer rachunku odbiorcy</rachunek> <NAZWA1>Dane_odbiorcy_1</NAZWA1> <NAZWA2>Dane_odbiorcy_2</NAZWA2> <NAZWA3>Dane_odbiorcy_3</NAZWA3> <NAZWA4>Dane_odbiorcy_4</NAZWA4> <KWOTA>Kwota przelewu</kwota> <TRESC1>Tytuł_1</TRESC1> <TRESC2>Tytuł_2</TRESC2> <TRESC3>Tytuł_3</TRESC3> <TRESC4>Tytuł_4</TRESC4> <NAZWA_NAD1>Dane_nadawcy_1</NAZWA_NAD1> <NAZWA_NAD2>Dane_nadawcy_2</NAZWA_NAD2> <NAZWA_NAD3>Dane_nadawcy_3</NAZWA_NAD3> <NAZWA_NAD4>Dane_nadawcy_4</NAZWA_NAD4> <WALUTA>Waluta przelewu</waluta> <STATUS_PRZELEWU>Status przelewu</status_przelewu> <KOMENTARZ_ODRZUCENIA>Powód odrzucenia (pole wypełniane tylko dla przelewów odrzuconych)</ KOMENTARZ_ODRZUCENIA> <NADAWCA_RACHUNEK>Numer rachunku nadawcy</nadawca_rachunek> <NADAWCA_BANK>Nazwa banku nadawcy</nadawca_bank> <BANK_SWIFT>Kod SWIFT banku odbiorcy</bank_swift> <SYSTEM_ROZLICZENIOWY>Wskazanie systemu rozliczeniowego dla przelewu: SEPA, SWIFT, TAR- GET2</ SYSTEM_ROZLICZENIOWY> <KOSZTY_POKRYWA>Oznaczenie strony pokrywającej koszty przelewu</koszty_pokrywa> <RODZAJ_TOWARU_USLUGI>Rodzaj towaru i usługi</rodzaj_towaru_uslugi> <TRYB_REALIZACJI>Tryb realizacji przelewu: Standardowy, Pilny, Ekspresowy</TRYB_REALIZACJI> <ODBIORCA_BANK1>Dane_banku_odbiorcy_1</ODBIORCA_BANK1> <ODBIORCA_BANK2>Dane_banku_odbiorcy_2</ODBIORCA_BANK2> <ODBIORCA_BANK3>Dane_banku_odbiorcy_3</ODBIORCA_BANK3> 45

47 3.2 <ODBIORCA_BANK4>Dane_banku_odbiorcy_4</ODBIORCA_BANK4> </PRZELEW> </PRZELEWY> Każde powtórzenie tagów <PRZELEW>... </PRZELEW> oznacza dane kolejnego przelewu zagranicznego. Polskie znaki są kodowane w formacie ISO Plik w formacie ISO20022 Pliku eksportu potwierdzeń przelewów zagranicznych w formacie ISO20022 generowany jest zgodnie z definicją XSD. Poniżej opis zawartości pliku eksportu: Nazwa elementu Typ Wymagalność Opis Document BkToCstmrAcctRpt GrpHdr MsgId 35x T Identyfikator generowany automatycznie (Message Identification) CreDtTm ISODateTime T Data utworzenia (Creation Date Time) /GrpHdr Rpt Id 35x T Numer wyciągu (Identification). CreDtTm ISO DateTime T Data i czas utworzenia wyciągu (Creation Data and Time). FrToDt FrDtTm ISODateTime N Data wyciągu od (From Date and Time) ToDtTm ISODateTime N Data wyciągu do (To Date and Time) /FrToDt Acct Id IBAN T Numer rachunku (Account). /Id /Acct Ntry Amt 3!a18d T Kwota pozycji (Entry - Amount). Obowiązkowy kod waluty i kwota. Przykład: <Amt Ccy= PLN >66.99</Amt> 46

48 Nazwa elementu Typ Wymagalność Opis CdtDbtInd T Wskaźnik pozycji (Entry Credit Debit Indicator). Dopuszczalny kod CRDT dla wartości 0, DBIT dla wartości < 0 Sts T Status pozycji (Entry Status). Status przelewu zagranicznego BOOK dla zrealizowanych PDNG dla pozostałych (norma ISO zezwala tylko na wyżej wymienione statusy). BkTxCd /BkTxCd NtryDtls TxDtls RltdPties Dbtr Nm 140x N Nazwa Zleceniodawcy (Debtor Name). /Dbtr DbtrAcct Id Othr Id 34x N Rachunek Zleceniodawcy (Debtor Account). /Othr /Id /DbtrAcct Cdtr Nm 140x N Nazwa Kontrahenta (Creditor Name). / Cdtr CdtrAcct Id Othr Id 34x N Rachunek Kontrahenta (Creditor Account). /Othr /Id /CdtrAcct /RltdPties RmtInf Ustrd 140x T Tytuł zlecenia /RmtInf /TxDtls SplmtryData 47

49 Nazwa elementu Typ Wymagalność Opis Envlp 350x O <AddData> <BillingSystem prioritycode= HIGH >system_rozliczeniowy</billingsystem> <TransferStatus>AI</TransferStatus> </AddData> BillingSystem dostępny tylko dla przelewów zagranicznych, dopuszczalne wartości: SWIFT SEPA TARGET2 PriorityCode tylko dla SWIFT, dopuszczalne wartości: NORM [standardowy, pilny] HIGH [ekspresowy] TransferStatus Status przelewu w systemie /NtryDtls /Ntry /Rpt /BkToCstmrAcctRpt /Document Struktura plików eksportu historii rachunku Format TXT (TAB) W pliku eksportu historii operacji na rachunku w formacie TXT (TAB) informacja o pojedynczej transakcji zajmuje jedną linię (rekord) zakończoną znakami <CRLF>. Każda linia składa się z pól zawierających poszczególne dane transakcji. Pola występują w pliku w określonej kolejności. Pola tekstowe są objęte cudzysłowami, a te, dla których nie jest przekazywana wartość, są zapisane jako pusty string ( ). Znakiem podziału linii w obrębie pola jest znak. Zestaw pól opisujących dane operacji wraz z formatem danych dla każdego pola: N pole numeryczne C pole tekstowe. 48