SPIS TREŚCI 1. WSTĘP 2 2. OPIS FUNKCJI IMPORTU I EKSPORTU DANYCH 2 2.1. FUNKCJE IMPORTU DANYCH 2 2.1.1. IMPORT PRZELEWÓW KRAJOWYCH 2 2.1.2. IMPORT PRZELEWÓW ZAGRANICZNYCH 4 2.2. FUNKCJE EKSPORTU DANYCH 7 2.2.1. EKSPORT LISTY PRZELEWÓW KRAJOWYCH 7 2.2.2. EKSPORT STATUSÓW PRZELEWÓW KRAJOWYCH 9 2.2.3. EKSPORT POTWIERDZEŃ PRZELEWÓW ZAGRANICZNYCH 11 2.2.4. EKSPORT HISTORII RACHUNKU LISTA TRANSAKCJI 13 3. FORMATY DANYCH I STRUKTURY PLIKÓW 15 3.1. FORMATY DANYCH 15 3.2. STRUKTURY PLIKÓW 16 3.2.1. STRUKTURY PLIKÓW IMPORTU PRZELEWÓW KRAJOWYCH 16 3.2.1.1. PLIK W FORMACIE LINIOWYM 16 3.2.1.2. PLIK W FORMACIE ELIXIR 18 3.2.1.3. PLIK W FORMACIE XML 21 3.2.2. STRUKTURA PLIKÓW IMPORTU PRZELEWÓW ZAGRANICZNYCH 24 3.2.2.1. PLIK W FORMACIE LINIOWYM 24 3.2.2.2. PLIK W FORMACIE XML 25 3.2.3. STRUKTURA PLIKÓW EKSPORTU LISTY PRZELEWÓW KRAJOWYCH 27 3.2.3.1. PLIK W FORMACIE LINIOWYM 27 3.2.3.2. PLIK W FORMACIE XML 29 3.2.4. STRUKTURA PLIKU EKSPORTU STATUSÓW PRZELEWÓW KRAJOWYCH 31 3.2.4.1. PLIK W FORMACIE XML 31 3.2.5. STRUKTURA PLIKU EKSPORTU POTWIERDZEŃ PRZELEWÓW ZAGRANICZNYCH 34 3.2.5.1. PLIK W FORMACIE XML 34 3.2.6. STRUKTURA PLIKÓW EKSPORTU LISTY TRANSAKCJI 36 3.2.6.1. FORMAT TXT (TAB) 36 3.2.6.2. FORMAT CSV 37 3.2.6.3. FORMAT QIF 38 3.2.6.4. FORMAT XML 39 3.2.6.5. FORMAT PDF 41 1
1. 2. 1. 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, ZUS), import przelewów zagranicznych, eksport przelewów krajowych, eksport statusów przelewów krajowych, eksport potwierdzeń przelewów zagranicznych, eksport historii rachunku. 2.1. 2.1. FUNKCJE IMPORTU DANYCH 2.1.1. IMPORT PRZELEWÓW KRAJOWYCH Import przelewów krajowych w PLN (przelew zwykły, przelew podatku/cła, przelew do ZUS) 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: ELIXIR, XML lub o strukturze liniowej. 2
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 lub XML, 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
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ę. 2.1.2. 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 XML lub o strukturze liniowej. 4
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 lub XML, 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
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
2.2. 2.2. FUNKCJE EKSPORTU DANYCH 2.2.1. 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
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
2.2. 2.2.2. 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
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
2.2. 2.2.3. 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 w formacie XML po uruchomieniu przycisku [eksportuj]. Opcja Transakcje Przelewy import/eksport Eksport potwierdzeń przelewów zagranicznych. 11
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. Plik można wyświetlić na ekranie lub zapisać we wskazanym miejscu. Opcja Transakcje Przelewy import/eksport Eksport potwierdzeń przelewów zagranicznych. 12
2.2. 2.2.4. 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 oraz PDF. Opcja Rachunki Historia rachunku. 13
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
3. 3. FORMATY DANYCH I STRUKTURY PLIKÓW 3.1. 3.1. 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, ZUS, podatku/cła ELIXIR, liniowy, XML. Format importu przelewów zagranicznych liniowy, XML. Format eksportu przelewów krajowych ELIXIR, XML. Format eksportu statusów przelewów krajowych XML. Format eksportu potwierdzeń przelewów zagranicznych XML. Format eksportu historii rachunku TXT (TAB), CSV, QIF, XML, PDF. 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: & & < < > >. 15
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. 3.2.1. STRUKTURY PLIKÓW IMPORTU PRZELEWÓW KRAJOWYCH 3.2.1.1. 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 8859-2. 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
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. W przypadku przelewów do ZUS pole jest pomijane przy wczytywaniu. 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 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. 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 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. 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
Przykładowa zawartość pliku importu w formacie liniowym Przelew zwykły: ;08.01.2010;33.34;;;;16 1540 1131 2001 6200 2297 0001;;Jan Kowalski ul. Koszarowa 3 87-100 Toruń;;;Tresc 1 Tresc 2 Tresc 3 Tresc 4;;;;Referencje; ;;;; Przelew ZUS: ;06.01.2010;18.18;;;;83101010230000261395100000;;JanKowalski ul. Koszarowa1 87-100 Toruń;;;/NIP/5540232159/TI/1dx1111111/TWP/M/DKL/122009/NRD/40/DUT/;;;;ReferencjeZUS;N azwanad1;nazwanad2;nazwanad3;nazwanad4; Przelew podatku/cła: ;01.06.2010;12.35;;;;51 1010 1078 0024 1122 2100 0000;;Urząd Skarbowy;;;/TI/N5540232159/OKR/04R/SFP/CIT2;;;;Referencje US;NazwaNad1;NazwaNad2;NazwaNad3;NazwaNad4; 3.2.1.2. 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 8859-2. 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
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 oraz do ZUS 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. Dla przelewu ZUS: 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. 19
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). Dla przelewu do ZUS pole TRESC podzielone jest na 4 linie (podpola). Każde z podpól oddzielone jest 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ładowa zawartość pliku importu w formacie Elixir Przelew zwykły:,20100110,210,,,, 16154011312001620022970001,, JanKowalski ul.testowa 1 00-100 Warszawa,,, Opłata1 Opłata2 Opłata3 Opłata4,,,,, Przelew podatku/cła:,20100111,0114,,,, 48101017040059332222000000,,,,, /TI/N1111111111/OKR/06R/SF P/VAT-7/TXT/podatek za m-c maj,,,, Przelew do ZUS:,20102201,029,,,, 83101010230000261395100000,,,,, /NIP/5540232159/TI/1dx111111 1/TWP/M/DKL/121999/NRD/40/DUT/,,,, 20
3.2.1.3. 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> <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 ZUS numer rachunku ZUS. 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. Dla przelewów ZUS pole przy wczytywaniu jest ignorowane. </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 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/ </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
</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-8859-2?> <PRZELEWY> <PRZELEW> <DATA>23.01.2010</DATA> <KWOTA>100</KWOTA> <RACHUNEK>24904300023001004640750004</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> Przelew do ZUS: <?xml version= 1.0 encoding= ISO-8859-2?> <PRZELEWY> <PRZELEW> <DATA>23.01.2010</DATA> <KWOTA>50,50</KWOTA> <RACHUNEK>83101010230000261395100000</RACHUNEK> 22
<NAZWA1>Anna Test</NAZWA1> <NAZWA2>ul. Testowa 1</NAZWA2> <NAZWA3>87-100</NAZWA3> <NAZWA4>Toruń</NAZWA4> <TRESC1>/NIP/5540232159/TI/1dx1111111/TWP/M</TRESC1> <TRESC2>/DKL/122009/NRD/40/DUT/</TRESC2> <TRESC3></TRESC3> <TRESC4></TRESC4> <REFERENCJE>Referencje ZUS</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> Przelew podatku/cła: <?xml version= 1.0 encoding= ISO-8859-2?> <PRZELEWY> <PRZELEW> <DATA>23.01.2010</DATA> <KWOTA>50,50</KWOTA> <RACHUNEK>51 1010 1078 0024 1122 2100 0000</RACHUNEK> <NAZWA1>Urząd Skarbowy</NAZWA1> <NAZWA2>ul. Podatkowa 1</NAZWA2> <NAZWA3>00-100</NAZWA3> <NAZWA4>Warszawa</NAZWA4> <TRESC1>/TI/N5540232159/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
3.2.2. STRUKTURA PLIKÓW IMPORTU PRZELEWÓW ZAGRANICZNYCH 3.2.2.1. 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. * pole nie jest wymagane (jest dozwolona pusta wartość) 24
Przykładowa zawartość pliku z danymi przelewów zagranicznych w formacie liniowym 200;PLN;48835500091234567;nazwa1;nazwa2;nazwa3;nazwa4;tresc1;tresc2;tresc3;tresc4;BREXPLP- W;SHA;SW;10,01;EUR;99999978;Zagraniczny1;;;;tytul1;;;;ABCADEFF;SHA;SE; 3.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> <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). 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> </PRZELEW> </PRZELEWY> 25
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-8859-2?> <PRZELEWY> <PRZELEW> <RACHUNEK>SE1250000000000006</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> </PRZELEW> <PRZELEW> <RACHUNEK> SE1250000000000006</RACHUNEK> <NAZWA1>nazwa1</NAZWA1> <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> 26
3.2.3. STRUKTURA PLIKÓW EKSPORTU PRZELEWÓW KRAJOWYCH 3.2.3.1. 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 8859-2. 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. 27
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 ZUS oraz 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. W przypadku przelewu ZUS wpis: Zakład Ubezpieczeń Społecznych. 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. Dla przelewu ZUS: 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. 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. 28
Przykładowy plik eksportu przelewów krajowych w formacie ELIXIR,20100111,5500,,, 73154011313001620031480001, 24904300023001004640750004, AR TURBORUBAR UL. SPORTOWA 34/32 12-345 WARSZAWA, Anna Test ul. Testowa1/3,,, Wpłata.,,20100108,3131,,, 73154011313001620031480001, 83101010230000261395100000, Płat nik1 Płatnik 3 Płatnik 3 Płatnik 4, Zakład Ubezpieczeń Społecznych,,, /NIP/5540232159/TI/1 dx1111111 /TWP/M/DKL/122009/NRD/40 /DUT/,,20100203,10000,,, 16154011312001620022000001, 83101010230000261395100000, KA TARZYNA JESIENNA, Zakład Ubezpieczeń Społecznych,,, /NIP/5540232159/TI/R690336820 /TWP/S/DKL/012010/NRD/01 /DUT/ 3.2.3.2. PLIK W FORMACIE XML Struktura pliku eksportu przelewów krajowych w formacie XML jest następująca: <?xml version= 1.0 encoding= ISO-8859-2?> <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> 29
<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-8859-2?> -<PRZELEWY> -<PRZELEW> <DATA>29.02.2016</DATA> <RACHUNEK>7000101023000000000000000</RACHUNEK> <NAZWA1>Zakład Ubezpieczeń Społecznych</NAZWA1> <NAZWA2/> <NAZWA3/> <NAZWA4/> <KWOTA>0.02</KWOTA> <TRESC1>/NIP/8000000000/TI/P70010210483</TRESC1> <TRESC2>/TWP/S/DKL/102015/NRD/10</TRESC2> <TRESC3>/DUT/</TRESC3> <TRESC4/> <NAZWA_NAD1>Płatnik Jan Kowalski</NAZWA_NAD1> <NAZWA_NAD2/> <NAZWA_NAD3/> <NAZWA_NAD4/> <REFERENCJE/> <WALUTA>PLN</WALUTA> 30
</PRZELEW> -<PRZELEW> <DATA>29.02.2016</DATA> <RACHUNEK>60000020040000000111110111</RACHUNEK> <NAZWA1>Jan Kowalski</NAZWA1> <NAZWA2>ul. Bosiowa 1</NAZWA2> <NAZWA3>00-832 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> 00-124 WARSZAWA</NAZWA_NAD3> <NAZWA_NAD4/> <REFERENCJE/> <WALUTA>PLN</WALUTA> </PRZELEW> </PRZELEWY> 3.2.4. STRUKTURA PLIKU EKSPORTU STATUSÓW PRZELEWÓW KRAJOWYCH 3.2.4.1. 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-8859-2?> <PRZELEWY> <PRZELEW> <DATA> Data księgowania lub data realizacji </DATA> <RACHUNEK> Rachunek odbiorcy </RACHUNEK> <NAZWA1> Dane odbiorcy </NAZWA1> 31
<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 8859-2. 32
Przykładowy plik eksportu statusów przelewów krajowych w formacie XML <?xml version= 1.0 encoding= ISO-8859-2?> -<PRZELEWY> -<PRZELEW> <DATA>29.02.2016</DATA> <RACHUNEK>67114020040000350268910363</RACHUNEK> <NAZWA1>Jan Kowalski</NAZWA1> <NAZWA2>ul. Bosiowa 1</NAZWA2> <NAZWA3>00-832 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> 00-124 WARSZAWA</NAZWA_NAD3> <NAZWA_NAD4/> <REFERENCJE/> <WALUTA>PLN</WALUTA> <STATUS_PRZELEWU>zrealizowany</STATUS_PRZELEWU> <KOMENTARZ_ODRZUCENIA/> </PRZELEW> </PRZELEWY> 33
3.2.5. STRUKTURA PLIKU EKSPORTU POTWIERDZEŃ PRZELEWÓW ZAGRANICZNYCH 3.2.5.1. 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 </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> <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> 34
3.2 <WALUTA> Waluta przelewu </WALUTA> <STATUS> Status przelewu </STATUS> <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> <KOSZTY_POKRYWA> Oznaczenie strony pokrywającej koszty przelewu (SHA, BEN, OUR) </KOSZTY_POKRYWA> <RODZAJ_TOWARU_USLUGI> Rodzaj towaru i usługi </RODZAJ_TOWARU_USLUGI> <ODBIORCA_BANK1> Dane banku odbiorcy </ODBIORCA_BANK1> <ODBIORCA_BANK2> Dane banku odbiorcy </ODBIORCA_BANK2> <ODBIORCA_BANK3> Dane banku odbiorcy </ODBIORCA_BANK3> <ODBIORCA_BANK4> Dane banku odbiorcy </ODBIORCA_BANK4> </PRZELEW> </PRZELEWY> Każde powtórzenie tagów <PRZELEW>... </PRZELEW> oznacza dane kolejnego przelewu zagranicznego. Polskie znaki są kodowane w formacie ISO 8859-2. Przykładowy plik eksportu potwierdzeń przelewów zagranicznych w formacie XML <?xml version= 1.0 encoding= ISO-8859-2?> -<PRZELEWY> -<PRZELEW> <DATA_OPERACJI>2016-02-29</DATA_OPERACJI> <RACHUNEK>ES7200000000111001111111</RACHUNEK> <NAZWA1>Jan Bosiowy</NAZWA1> <NAZWA2>ul. Bosiowa</NAZWA2> <NAZWA3>00-010 WARSZAWA</NAZWA3> <NAZWA4/> 35
<KWOTA>15.00</KWOTA> <TRESC1>Faktura</TRESC1> <TRESC2/> <TRESC3/> <TRESC4/> <NAZWA_NAD1>Anna Bossowska</NAZWA_NAD1> <NAZWA_NAD2>al. JANA PAWLA II 12</NAZWA_NAD2> <NAZWA_NAD3> 00-124 WARSZAWA</NAZWA_NAD3> <NAZWA_NAD4/> <WALUTA>EUR</WALUTA> <STATUS_PRZELEWU>zrealizowany</STATUS_PRZELEWU> <KOMENTARZ_ODRZUCENIA></KOMENTARZ_ODRZUCENIA> <NADAWCA_RACHUNEK>PL14154011111000000000000001</NADAWCA_RACHUNEK> <NADAWCA_BANK>nazwa banku</nadawca_bank> <BANK_SWIFT>BSCHESMMXXX</BANK_SWIFT> <KOSZTY_POKRYWA>SHA</KOSZTY_POKRYWA> <RODZAJ_TOWARU_USLUGI/> <ODBIORCA_BANK1/> <ODBIORCA_BANK2/> <ODBIORCA_BANK3/> <ODBIORCA_BANK4/> </PRZELEW> </PRZELEWY> 3.2.6. STRUKTURA PLIKÓW EKSPORTU HISTORII RACHUNKU 3.2.6.1. 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. 36
Pole Długość Typ Opis Data transakcji 10 N Data wykonania transakcji w systemie w formacie RRRR-MM-DD. Data księgowania 10 N Data przetworzenia transakcji przez system bankowy w formacie RRRR-MM-DD. Nazwa transakcji 20 C Opis rodzaju/typu operacji. Odbiorca/Nadawca 35 C Nazwa odbiorcy lub nadawcy transakcji. Kwota transakcji 22/2 N Kwota transakcji. W przypadku obciążenia kwota prezentowana jest ze znakiem minus. Waluta 3 C Waluta rachunku obciążanego transakcją. Saldo po transakcji 22/2 C Kwota środków na rachunku po wykonaniu transakcji. Waluta 3 C Waluta rachunku obciążanego. Przykładowy plik eksportu historii rachunku w formacie TXT (TAB) 2009-12-24 2009-12-24 78101010110000111111100000 Spłata 33101010110000111111100000 Spłata dowolnego zadłużenia karty MAREK KARTOWY UL. KARTOWA 1/3 01-123 WARSZAWA -10.00 PLN 245.50-10.00 PLN 2008-12-19 2008-12-19 wpłata gotówkowa 78101010110000111111100000 wpłata gotówkowa 55000,00 PLN 128553,39 55000,00 PLN 2008-12-18 2008-12-18 78101010110000111111100000 przelew ZUS 44101010110000111111100000 Składka ZUS ID.PŁ.: 8000000000 R-900007300 ID.SKŁ.: U/200706/01 NRDECYZJI/UMOWY: 4444 ZUS -9,00 PLN 47241,10-9,00 PLN 2008-12-17 2008-12-17 prowizja za prowadzenie rachunku wpis opł.za prow -30,00 PLN 128434,78-30,00 2008-12-17 2008-12-17 78101010110000111111100000 przelew US 55101010110000111111100000 Przelew do US PESEL: 70000100000 SYMBOL PŁATNO CI: CIT OKRES: 02R Urząd Skarbowy Aleksandrów Kujawski -50,01 PLN 891804,85-50,01 PLN 3.2.6.2. FORMAT CSV W formacie CSV wyeksportowane transakcje zapisywane są do programu MS Excel. Pola występują w pliku w określonej kolejności, rozdzielane separatorem w postaci średnika (;) Zawartość danych w poszczególnych kolumnach jest adekwatna jak w przypadku opisu dla formatu TXT (TAB). Pola tekstowe są objęte cudzysłowami, a te dla których nie jest przekazywana wartość, są zapisane jako pusty string ( ). 37
3.2.6.3. FORMAT QIF W pliku eksportu w formacie QIF dla każdej transakcji dane prezentowane są w dwóch sekcjach. Sekcja pierwsza rozpoczyna się od nagłówka!account. W ramach tej sekcji prezentowany jest numer rachunku odbiorcy transakcji. Sekcja druga rozpoczyna się od nagłówka!type:bank. W ramach tej sekcji prezentowane są poszczególne dane dla pojedynczej transakcji. Każde pole z danymi prezentowane jest w odrębnej linii. Każdą sekcję zamyka znak ^. Układ sekcji i ich pól dla formatu QIF:!Account N78101010110000111111100000 ^!Type:Bank D24/12/2008 T10.04 MOpłata testowa PJanTEST UL. TESTOWA 135-222 RZESZÓW L[75154011111001110010000001] ^!Account N78101010110000111111100000^!Type:Bank D24/12/2008 T-50.50 MSpłata dowolnego zadłużenia karty PJanBossowski UL. TESTOWA 1 35-222 RZESZÓW L[75154011111001110010000001] ^!Account N78101010110000111111100000 ^!Type:Bank D1/11/2008 T-20.0 MSkładka ZUS 52 Id.pł. 7111111111 2-AS12345 Id.skł. A/200908/01 Nr decyzji/umowy: test PJAN KOWALSKI L[95154011111000000000000003] ^ 38
Etykieta Opis!Account Nagłówek sekcji 1. N Numer NRB rachunku odbiorcy. Przykład: N41154011313001620030470031!Type:Bank Nagłówek sekcji 2. D T M P L Data transakcji w formacie DD/MM/RRRR. Przykład: D24/12/2008 Kwota transakcji. Separatorem kwoty jest kropka. Kwota obciążenia prezentowana jest ze znakiem minus. Przykład: T-20.0 Opis operacji. 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. Dla przelewu ZUS: 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. Przykład: MWpłata własna MSkładka ZUS 52 Id.pł. 7941409802 2-AS12345 Id.skł. A/200908/01 Nr decyzji/umowy: test Dane nadawcy, w tym również dane adresowe. Przykład: PJanTEST UL. TESTOWA 1/123 35-222 RZESZÓW Numer NRB rachunku nadawcy. Rachunek otwierają i zamykają znaki klamry:[ ] Przykład: L[75154011313001620030470001] 3.2.6.4. FORMAT XML Struktura pliku eksportu operacji w formacie XML jest następująca: <OPERACJE> <OPERACJA> <DATA_TRANSAKCJI> Data transakcji </DATA_TRANSAKCJI> <DATA_KSIEGOWANIA> Data księgowa transakcji </DATA_KSIEGOWANIA> <RACHUNEK_NADAWCY> Rachunek nadawcy </RACHUNEK_NADAWCY> <RACHUNEK_ODBIORCY> Rachunek odbiorcy </RACHUNEK_ODBIORCY> <NAZWA_TRANSAKCJI> Nazwa transakcji </NAZWA_TRANSAKCJI> 39
<TYTUL_PLATNOSCI> Tytuł transakcji </TYTUL_PLATNOSCI> <ODBIORCA_NADAWCA> Dane nadawcy/ odbiorcy </OBIORCA_NADAWCA> <KWOTA_TRANSAKCJI> Kwota transakcji </KWOTA_TRANSAKCJI> <SALDO_PO_TRANSAKCJI> Saldo po wykonaniu transakcji </SALDO_PO_TRANSAKCJI> <KWOTA_W_WALUCIE_UMOWY> Kwota przelewu </WALUTA_W_WALUCIE_UMOWY> <WALUTA_UMOWY> Waluta umowy </WALUTA_UMOWY> </OPERACJA> </OPERACJE> Każde powtórzenie tagów <OPERACJA>... </OPERACJA> oznacza dane kolejnej operacji. Polskie znaki są kodowane w formacie ISO 8859-2. Przykładowy plik eksportu historii rachunku w formacie XML <?xml version= 1.0 encoding= ISO-8859-2?> -<OPERACJE> -<OPERACJA> <DATA_TRANSAKCJI>2016-02-29</DATA_TRANSAKCJI> <DATA_KSIEGOWANIA>2016-02-29</DATA_KSIEGOWANIA> <RACHUNEK_NADAWCY>14154000002000011111100001</RACHUNEK_NADAWCY> <RACHUNEK_ODBIORCY>78154000002000011111100001</RACHUNEK_ODBIORCY> <NAZWA_TRANSAKCJI>Przelew ZUS</NAZWA_TRANSAKCJI> <TYTUL_PLATNOSCI>Typ wpłaty: S Składka za 1 m-c; Deklaracja: 102015; Nr deklaracji: 10 NIP:8000000000; Typ ident.:pesel Identyf. uzup.:70000000000; Dane płat.:płatnik Jan Kowalski</ TYTUL_PLATNOSCI> <ODBIORCA_NADAWCA>Zakład Ubezpieczeń Społecznych</ODBIORCA_NADAWCA> <KWOTA_TRANSAKCJI>-0.02</KWOTA_TRANSAKCJI> <WALUTA_TRANSAKCJI>PLN</WALUTA_TRANSAKCJI> <SALDO_PO_TRANSAKCJI>30.55</SALDO_PO_TRANSAKCJI> <KWOTA_W_WALUCIE_UMOWY>-0.02</KWOTA_W_WALUCIE_UMOWY> <WALUTA_UMOWY>PLN</WALUTA_UMOWY> </OPERACJA> </OPERACJE> 40
3.2.6.5. FORMAT PDF W celu wygenerowania historii rachunku w formacie PDF, z poziomu zakładki Rachunki Historia rachunku należy wybrać rachunek, a następnie format eksportu PDF. Przy użyciu przycisku [eksportuj historię do pliku] wygenerować plik w formacie PDF. Dla każdej operacji, w pliku prezentowane są następujące dane: Data transakcji, Data księgowania, Nazwa transakcji typ operacji, Dane Odbiorcy/Nadawcy, Tytuł płatności, Kwota transakcji, Saldo po transakcji. Zakładka Rachunki Historia rachunku, opcja Historia rachunku lista transakcji historia transakcji na rachunku w formacie PDF. 41