Instrukcja importu / eksportu danych w
Spis treci Wstp... 3 Moliwoci importu i eksportu danych... 3 Formaty plików... 3 Formar Elixir... 4 Format Videotel... 5 Ustawianie formatu plików w systemie... 6 Import struktury dla formatu liniowego... 7 Informacje o strukturze liniowej... 8 Tworzenie struktury dla importu przykad... 9 Struktury Plików... 10 Import przelewów format XML... 10 Import przelewów europejskich format ISO20022... 14 Import przelewów format liniowy... 17 Import patnoci masowych format XML... 19 Import patnoci masowych format liniowy... 20 Import polece zapaty format XML... 21 Import polece zapaty format liniowy... 22 Import kontrahentów format XML... 23 Import kontrahentów format liniowy... 23 Import kontrahentów format Videotel... 24 Eksport statusów przelewów format XML... 25 Eksport statusów przelewów format liniowy... 26 Eksport statusów polece zapaty format XML... 27 Eksport statusów polece zapaty format liniowy... 28 Eksport dziennych zestawie operacji format XML... 29 Eksport dziennych zestawie operacji format liniowy... 31 Eksport dziennych zestawie operacji format MT940 (SWIFT)... 32 Eksport operacji biecych format XML... 32 Eksport operacji biecych format liniowy... 33 Eksport wycigów format MT940... 34 2 /35
Wstp Instrukcja jest dokumentem przeznaczonym dla Klientów korzystajcych z systemu. Opisuje moliwoci i reguy wymiany danych pomidzy a systemem ksigowym wykorzystywanym przez Klienta. Moliwoci importu i eksportu danych import System umoliwia: eksport przelewów zwykaych statusów przelewów przelewów do ZUS ststusów polece zapaty przelewów do US dziennych zestawie operacji przelewów zagranicznych zestawie operacji biecych przelewów europejskich wycigów MT940 polece zapaty patnoci masowych kontrahentów Formaty plików Lp. Rodzaj importu Formaty plików XML 1 Import przelewów zwykych Elixir Liniowy Videotel XML 2 Import przelewów do ZUS Patnik Liniowy Videotel XML 3 Import przelewów US Elixir Liniowy Videotel 4 Import przelewów zagranicznych XML Liniowy XML 5 Import przelewów europejskich Liniowy ISO20022 6 Import polece zapaty XML Liniowy XML 7 Import patnoci masowych Elixir Liniowy Videotel XML 8 Import kontrahentów Liniowy Videotel Lp. Rodzaj eksportu Formaty plików 1 Eksport statusów przelewów XML Liniowy 2 Eksport statusów polece zapaty XML Liniowy XML 3 Eksport dziennych zestawie operacji Liniowy MT940 4 Eksport zestawie operacji biecych XML Liniowy 5 Eksport wycigów MT940 3 /35
System obsuguje format liniowy oraz XML. Dodatkowo, dla niektórych grup importu moliwe jest zastosowanie innych formatów (np. Videotel, Elixir lub ISO20022). Budowa pliku liniowego i XML zostanie szczegóowo omówiona w dalszej czci tekstu. Formar Elixir Elixir to standardowy format stosowany do tworzenia plików patnoci w programach ksigowych. Plik z przelewami zapisany jest w formacie tekstowym. Kade zlecenie przelewu zajmuje jedn lini (jeden rekord) zakoczon znakiem <CRLF>. Kady wiersz jest zoony z 17 pól. Pola s oddzielone separatorem - przecinkiem. Pola wystpuj w ustalonej kolejnoci, opisanej w poniszej tabeli. Pola tekstowe s objte cudzysowami. Pola tekstowe, dla których nie jest przekazywana warto, s zapisane jako:. Znakiem podziau linii w obrbie pola jest znak:. Rekord danych musi mie struktur zgodn ze struktur pliku przecinkowego Elixir. Polskie znaki kodowane s w standardzie ISO8859-2. Typy danych stosowane przy opisie pól: N pole numeryczne, wartoci jest liczba cakowita D data w formacie RRRRMMDD, gdzie RRRR rok, MM miesic, DD dzie (np. 20140501). C pole tekstowe. Rozmiar pola 4*35 oznacza e pole moe zawiera maksymalnie 4 linie po 35 znaków, nie wliczajc znaków podziau linii. K pole zawierajce kwot. Kwota wyraona w groszach. Nie moe zawiera adnych separatorów dla czci uamkowej ani separatorów tysicy. Przykad: 150 z naley zapisa jako 15000, 10 z 90 gr jako 1090, zapis 50 oznacza kwot 50 gr. Do systemu wczytywane s pola o statusie M. Pola o statusie O s pomijane przy wczytywaniu pliku. Kolejno pola w rekordzie 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Pole wg Elixir Format Rozmiar Status pola Pole w systemie Opis pola w systemie Typ komunikatu N 3 O - Pole pomijane przy wczytywaniu do systemu Data transakcji D 8 M DATA Data zlecenia. Pole obowizkowe, konieczne jest przekazanie wanej wartoci. Kwota K 15 M KWOTA Kwota zlecenia. Waluta domylnie przyjmowana jako PLN. Pole obowizkowe, konieczne jest przekazanie wanej wartoci. Nr jednostki prezentujcej Nr jednostki odbierajcej Rachunek klienta nadawcy Rachunek klienta adresata Nazwa klienta nadawcy Nazwa klienta adresata Numer nadawcy uczestnika poredniego Numer oddziau finalny adresat Informacje dodatkowe N 8 O - Pole pomijane przy wczytywaniu do systemu N 8 O - Pole pomijane przy wczytywaniu do systemu C 34 M RACH_OBC Numer rachunku nadawcy. Pole obowizkowe, konieczne jest przekazanie wanej wartoci. C 34 M RACHUNEK Numer rachunku beneficjenta. Pole obowizkowe, konieczne jest przekazanie wanej wartoci. C 4*35 O - Pole pomijane przy wczytywaniu do systemu C 4*35 M NAZWA Nazwa beneficjenta. Pole obowizkowe, konieczne jest przekazanie wanej wartoci. N 8 O - Pole pomijane przy wczytywaniu do systemu N 8 M BANK Bank beneficjenta. Pole nie jest obowizkowe, mona przekaza warto pust. C 4*35 M TRESC Tytu patnoci przelewu. Pole obowizkowe, konieczne jest przekazanie wanej wartoci. Numer czeku C 10 O - Pole pomijane przy wczytywaniu do systemu Data transakcji D 8 M DATA Data zlecenia. Pole obowizkowe, konieczne jest przekazanie wanej wartoci. Kwota K 15 M KWOTA Kwota zlecenia. Waluta domylnie przyjmowana jako PLN. Pole 4 /35
16 17 Nr jednostki prezentujcej Nr jednostki odbierajcej obowizkowe, konieczne jest przekazanie wanej wartoci. N 8 O - Pole pomijane przy wczytywaniu do systemu N 8 O - Pole pomijane przy wczytywaniu do systemu Zapis danych w pliku Elixir moe mie posta: 110,20140515,1256,,,"98191010480000000000000003","48835500000000000000123456","ZESPÓ SZKÓ TESTOWA 1 ","JANKOWSKA TERESA 00-008 WARSZAWA ",,,"zasilenie rachunku ","","","51" Format Videotel Videotel to standardowy format stosowany do tworzenia plików patnoci w programach ksigowych. Format ten moe zosta wykorzystany do zapisania pliku z danymi beneficjentów, co bdzie opisane w dalszej czci, przy omawianiu importu kontrahentów. Plik importu przelewów w formacie Videotel jest plikiem tekstowym. Kade zlecenie przelewu zajmuje jedn lini (jeden rekord) zakoczon znakiem <CRLF>. Kady rekord jest zoony z 14 lub 17 pól. Pola wystpuj w ustalonej kolejnoci, opisanej w tabeli, zamieszczonej poniej. Kade pole w rekordzie musi wystpi. Pola tekstowe, dla których nie jest przekazywana warto, s zapisane jako: "". Poszczególne pola s oddzielone jedn i tylko jedn spacj. Pola tekstowe s objte cudzysowami. Jeeli w tekcie do zaimportowania ma si znale cudzysów, naley zastpi go dwoma cudzysowami. Polskie znaki kodowane s w standardzie ISO8859-2 lub WINDOWS 1250. Uycie innej strony kodowej w importowanym pliku skutkuje odrzuceniem importu z informacj zwrotn: "Importowany plik ma bdne znaki". Znakiem podziau linii w obrbie pola s trzy znaki zapytania:???. Formaty pól: N pole numeryczne, wartoci jest liczba cakowita. Zapis 10N oznacza, e pole moe zawiera maksymalnie 10 cyfr. C pole tekstowe. Zapis 3*35C oznacza e pole moe zawiera maksymalnie 3 linie po 35 znaków, nie wliczajc znaków podziau linii oraz liczc podwójne cudzysowy jako jeden znak. K pole zawierajce kwot. Kwota w formacie z.gr. Separatorem czci uamkowej jest kropka. Nie naley uywa adnych innych separatorów, np. separatora tysicy. D data w formacie RRRR-MM-DD, gdzie RRRR rok, MM miesic, DD dzie, (np. 2014-05-16). Do aplikacji wczytywane s pola o statusie M. Pola o statusie O s pomijane przy wczytywaniu pliku. Kolejno pola w rekordzie Nazwa pola Opis pola Format pola Status pola 1 BBen Nazwa banku beneficjenta 35C O 2 RBen1 Nazwa rachunku beneficjenta 3*35C M 3 NrBen Numer rachunku beneficjenta 34C M 4 REZ12 Klucz N O 5 KW Kwota przelewu K M 6 BNad Nazwa banku nadawcy 35C O 7 RNad Nazwa rachunku nadawcy 35C O 8 NrNad Numer rachunku nadawcy 34C M 9 REF Tytu patnoci. W przypadku przelewów podatku w polu przekazywane s informacje o patnoci podatku typ i zawarto identyfikatora, okres za który dokonywana jest patno, symbol formularza lub tytu patnoci, opis patnoci. W przypadku przelewu ZUS w polu przekazywane s informacje o skadce NIP patnika, typ identyfikatora uzupeniajcego i identyfikator uzupeniajcy patnika, typ wpaty, deklaracja i numer deklaracji, numer decyzji/umowy/tytuu wykonawczego. 5 /35 4*35C M 10 WAL3 Waluta przelewu 3C O 11 NF Nazwa firmy, do której maj by dopisane nowe rachunki beneficjenta, które zostan zaimportowane wraz z przelewami. 12 DNN Nazwa beneficjenta 3*35C M 13 WL Okrelenie rodzaju wasnoci firmy NF "T " jeli firma wasna, N jeli firma obca 14 REZ2 Nazwa systemu finansowego dla przelewu 35C O 35C O O
15 DR Typ drogi realizacji przelewu. "", "N" tryb AUTO, "T " tryb ELIXIR, "S" tryb SORBNET 16 RN Okrelenie rodzaju beneficjenta: ""- nie zainicjowane, "R"-rezydent lub "N"- nierezydent 17 Data Data zlecenia w formacie RRRRMM-DD. Istnieje moliwo zdefiniowania daty przyszej. 35C 1C 10D O O M Uwaga: 1RBen zawarto pola interpretowana przez aplikacj jako nazwa odbiorcy przelewu. 2REZ1 pole moe zawiera dowoln liczb cakowit np.1. 3WAL w aplikacji przyjmowana zawsze warto PLN. W przypadku, gdy rekord skada si z czternastu pól w systemie domylnie zapisywana jest data bieca. Przykadowa zawarto pliku w formacie Videotel prezentuje si nastpujco: "" "JAN KOWALSKI-ROR" "48835500000000000000123456" 0000001 206.96 "" "JANINA KOWALSKA???UL.TESTOWA 5" "86864200000000000000000001" "ZASILENIE RACHUNKU???MARZEC 2014" "PLN" "" "JAN KOWALSKI" "" "" Ustawianie formatu plików w systemie Dla kadego rodzaju pliku mona wybra odrbny format importu lub eksportu danych. Domylnie wszystkie formaty ustawione s jako XML. eby wybra format pliku naley wej w zakadk Zarzdzanie kontem, a nastpnie wybra opcj Zarzdzanie importem i strukturami plików. Wane! Dostp do modyfikacji parametrów aplikacji uzaleniony jest od uprawnie uytkownika. Niektóre ustawienia mog pozwala na ogldanie parametrów aplikacji, ale nie zezwala na modyfikacj. Aby zmieni format wybranego pliku naley w odpowiednim polu wyboru ustawi dany format, a nastpnie nacisn przycisk <Zapisz zmiany>. 6 /35
Import struktury dla formatu liniowego W przypadku wybrania formatu liniowego naley równie zaimportowa struktur rekordów. Struktura taka moe zosta pobrana z pliku w formacie standardowego opisu uywanego przez Administratora róde Danych ODBC w systemach Windows (pliki schema.ini). Wicej szczegóów na ten temat znajd Pastwo w dalszej czci instrukcji. Aby zaimportowa struktur dla formatu liniowego, naley w polu wyboru ustawi format liniowy, zapisa zmiany, a nastpnie nacisn odpowiedni przycisk <Importuj now>. Wywietlone zostanie nowe okno pozwalajce wpisa ciek i nazw pliku struktury lub wybra ten plik poprzez nacinicie przycisku <Wybierz plik>: Po wybraniu pliku i naciniciu przycisku <Importuj> wywietlona zostanie rozwijana lista, zawierajca informacje o odnalezionych w podanym pliku opisach struktur. Naley wybra waciw, a nastpnie nacisn przycisk <Zapisz wybran struktur>. Aby przerwa proces importu struktury, naley nacisn przycisk <Rezygnuj>. Nacinicie przycisku <Zamknij> powoduje zamknicie okna i powrót do okna gównego. Nazwa wybranej struktury pojawia si w polu obok przycisku importu struktury. 7 /35
Informacje o strukturze liniowej Struktura liniowa umoliwia uytkownikom modyfikacj wewntrznego formatu plików importu i eksportu. Zakres modyfikacji dotyczy jedynie kolejnoci wystpowania pól w pliku. Jest to jednak funkcjonalno pozwalajca na dopasowanie plików do zewntrznych systemów. Ustawienie odpowiedniej struktury w systemie odbywa si poprzez zaadowanie pliku zawierajcego opis struktury. Najczciej jest to plik o rozszerzeniu *.ini lub *.txt. W jednym pliku moe znajdowa si kilka struktur, system rozpoznaje poszczególne opisy i pozwala na wybranie odpowiedniego. Opis struktury skada si z nazwy, pól waciwoci i pól opisujcych poszczególne kolumny: [kontrah.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=NAZWA_KR Char Width 20 Col2=NAZWA1 Char Width 35 Col3=NAZWA2 Char Width 35 Col4=NAZWA3 Char Width 35 Col5=NAZWA4 Char Width 35 Col6=RACHUNEK Char Width 34 Col7=BANK Char Width 8 Dokadny opis poszczególnych elementów zawiera ponisza tabela: [kontrah.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Element pliku Col1=NAZWA_KR Char Width 20 Col2=NAZWA1 Char Width 35 Col3=NAZWA2 Char Width 35 Col4=NAZWA3 Char Width 35 Col5=NAZWA4 Char Width 35 Col6=RACHUNEK Char Width 34 Col7=BANK Char Width 8 Opis Nazwa struktury koniecznie w nawiasach kwadratowych. Flaga wskazujca, czy plik zawiera nagówki kolumn. Dozwolone wartoci: True, False. Obecnie parametr moe jedynie przyjmowa warto: False. Parametr okrelajcy typ pliku. Obecnie obsuguje jedynie pliki rozdzielane znakiem. Dozwolone wartoci: Delimited(x), gdzie x oznacza znak rozdzielajcy np. (;). Parametr okrelajcy gboko skanowania w przypadku aplikacji analizujcych struktur. W systemie parametr jest ignorowany. Parametr okrelajcy zestaw znaków uywanych w pliku. Dozwolone wartoci: OEM (domylnie), ANSI. W moe zosta pominity. Opisy kolejnych pól znajdujcych si w pliku danych. Kady wpis skada si z numeru kolejnej kolumny (Coln), nazwy pola (koniecznie duymi literami), typu pola oraz dugoci. Dozwolone typy pól: Integer liczba cakowita, Float liczba rzeczywista, Char cig znaków (naley poda dugo). Kady rodzaj pliku importu i eksportu w systemie posiada zestaw okrelonych pól, które mog lub musz znale si w pliku. Opisy poszczególnych pól zostay zamieszczone w dalszej czci instrukcji. Podczas importu plików o strukturze liniowej, system pobiera kolejne pola z pliku zgodnie z opisem struktury. Aby pomin niektóre pola, mona w strukturze umieci pole o nazwie nieuywanej w systemie na przykad DUMMY albo POMIN. Podczas eksportu dane z systemu zapisywane s do pliku w kolejnoci okrelonej przez struktur. 8 /35
Tworzenie struktury dla importu przykad Poniszy przykad przedstawia krok po kroku proces tworzenia struktury pliku liniowego do importu kontrahentów. Zawarto przykadowego pliku: TESTEX;19101048;DEUTSCHE BANK POLSKA S.A.;14191010480000000000000001;;TESTEX S.A.;ul. Testowa 1;01-001 Testowo FIRMEX;19101048;DEUTSCHE BANK POLSKA S.A.;14191010480000000000000002;;FIRMEX S.A.;ul. Firmowa 2;02-002 Firmowo NOWAK;19101048;DEUTSCHE BANK POLSKA S.A.;14191010480000000000000003;;Jan Nowak;ul. Testowa 3;01-003 Testowo Krok 1 sprawdzenie pliku danych i ustalenie kolejnoci pól. Aby sprawdzi plik danych, naley go otworzy przy uyciu Notatnika, przegldarki internetowej lub innego programu pozwalajcego na przegldanie plików tekstowych. Wane! Do przegldania pliku danych nie powinno si uywa edytorów tekstu typu Word, poniewa formatuj one tekst i mog znieksztaci obraz struktury. Jeeli nie ma moliwoci przygotowania testowego pliku danych, zawierajcego niewielk ilo rekordów, naley sporzdzi kopi pliku rzeczywistego i na nim wykonywa wszystkie testy. Podczas przegldania pliku danych, nie naley go modyfikowa ani zapisywa zmian podczas zamykania. Aby otworzy plik przy pomocy wybranego programu, naley klikn na pliku prawym przyciskiem myszy, a nastpnie z menu kontekstowego wybra Otwórz za pomoc i z listy programów wskaza waciwy. Aby wybra program inny ni zamieszczony na licie, naley klikn na opcj Wybierz program domylny..., a nastpnie w oknie wyboru wskaza dan aplikacj. Podobne okno zostanie otwarte po wybraniu Otwórz za pomoc..., jeeli plik nie jest zarejestrowany w systemie. 9 /35
Po otwarciu pliku naley sprawdzi, jaka jest jego wewntrzna budowa. W pliku liniowym jeden rekord (w tym przypadku dane jednego kontrahenta) powinien znajdowa si w jednej linii. Jeeli tak nie jest, (w jednej linii znajduje si wicej rekordów lub jeden rekord znajduje si w kilku liniach), taki plik nie bdzie móg by zaimportowany do systemu. W przykadowym pliku dane poszczególnych kontrahentów znajduj si w osobnych liniach TESTEX;4234;19101048;DEUTSCHE BANK POLSKA S.A.;14191010480000000000000001;;TESTEX S.A.;ul. Testowa 1;01-001 Testowo FIRMEX;543;19101048;DEUTSCHE BANK POLSKA S.A.;14191010480000000000000002;;FIRMEX S.A.;ul. Firmowa 2;02-002 Firmowo NOWAK;322;19101048;DEUTSCHE BANK POLSKA S.A.;14191010480000000000000003;;Jan Nowak;ul. Testowa 3;01-003 Testowo Wane! Niektóre programy podczas przegldania plików zwijaj wiersze do szerokoci otwartego okna. Podzia ten nie jest równowany z podziaem na linie. Aby wyczy zwijanie, naley znale odpowiedni opcj i j odznaczy. W Notatniku opcja ta znajduje si w menu Format. Nastpnie naley sprawdzi, czy kolejne pola danych s oddzielone od siebie jakim znakiem (na przykad rednikiem). Jeeli nie, najprawdopodobniej jest to plik o staej szerokoci kolumn i nie bdzie móg by zaimportowany do systemu. Struktury Plików Import przelewów pozwala na wczytywanie przelewów z zewntrznych systemów. Moliwy jest import przelewów zwykych, do ZUS, do US oraz przelewów zagranicznych i europejskich, a take patnoci masowych oraz polece zapaty. Import przelewów format XML Pole Dugo Opis <PRZELEWY> - element gówny (root) moe zawiera dowoln ilo elementów - dane kolejnych przelewów <REFERENCJE>* referencje wasne Klienta <RACH_OBC> 34 rachunek do obcienia <BANK>* 8 numer rozliczeniowy banku <RACHUNEK> 34 numer rachunku kontrahenta <DATA>** 10 data przelewu w formacie RRRR-MM-DD jeeli data jest wiksza od biecej, tworzony jest przelew odroczony, jeeli data jest mniejsza od biecej, tworzony jest przelew z dat biec <NAZWA> 140 pena nazwa kontrahenta 4x35 znaków jeli w polu wystpuj znaki traktowane s one jako separatory wierszy zamiast pola <NAZWA> mog wystpowa pola <NAZWA1>, <NAZWA2>, <NAZWA3>, <NAZWA4> o dugoci 35 znaków kade. Dla formatek, gdzie Nazwa i Adres kontrahenta wprowadzane sa w osobne pola w przypadku zastosowania pola <NAZWA> pierwsze 70 znaków to 10 /35
<KWOTA> 26 kwota przelewu Nazwa, kolejne 70 to adres beneficjenta. Jeli uyte sa pola <NAZWA1>, <NAZWA2>, <NAZWA3>, <NAZWA4>tre pierszych dwóch importuje si jako nazwa, tre trzeciego i czwartego jako adres kontrahenta. <TRESC> 140 dla przelewów zwykych, zagranicznych i europejskich: tytu/tre przelewu dla przelewów ZUS: po sowie kluczowym /NIP/ numer NIP po sowie kluczowym /TI/ typ i numer identyfikatora po sowie kluczowym /TWP/ typ wpaty (dozwolone wartoci S, M, U, T, D, E, A, B) po sowie kluczowym /DKL/ deklaracja w formacie MMRRRR po sowie kluczowym /NRD/ numer deklaracji po sowie kluczowym /DUT/ numer decyzji/umowy/tyt. wyk. dla przelewów US: po sowie kluczowym /TI/ typ identyfikatora uzupeniajcego i identyfikator uzupeniajcy po sowie kluczowym /OKR/ oznaczenie okresu nalenoci po sowie kluczowym /SFP/ symbol formularza patnoci po sowie kluczowym /TXT/ opis zobowizania jeli w polu wystpuj znaki traktowane s one jako separatory wierszy zamiast pola <TRESC> mog wystpowa pola <TRESC1>, <TRESC2>, <TRESC3>, <TRESC4> o dugoci 35 znaków kade <BANK_SWIFT> 8 kod SWIFT banku Tylko przelew zagraniczny i opcjonalnie europejski! <BANK_ODDZ> 3 kod oddziau banku Tylko przelew zagraniczny i opcjonalnie europejski! <INFO_DOD>* 35 informacje dodatkowe Tylko przelew zagraniczny! <KOSZTY_POKRYWA> 3 strona pokrywajca koszty innych banków Tylko przelew zagraniczny! SHA koszty podzielone pomidzy zleceniodawc i beneficjenta, OUR koszty pokrywa zleceniodawca, BEN koszty pokrywa odbiorca. <WALUTA> 3 waluta przelewu Tylko przelew zagraniczny! <KRAJ> 2 dwuliterowy symbol kraju Tylko przelew europejski! * dozwolona jest warto pusta lub brak pola ** dozwolony jest brak pola Kade powtórzenie tagów... jest importowane jako nowy przelew. Wane! W jednym pliku powinny znajdowa si przelewy jednego rodzaju (np. przelewy zwyke, przelewy ZUS, przelewy europejskie). Przykadowy plik XML z przelewami zwykymi: <?xml version="1.0" encoding="iso-8859-2"?> <PRZELEWY> <REFERENCJE>test</REFERENCJE> <DATA>2014-05-25</DATA> <BANK>19101048</BANK> <RACHUNEK>60191010480000111122223333</RACHUNEK> <NAZWA>Odbiorca Testowy S.A., ul. Testowa 1/2, 30-300 Testowo</NAZWA> <KWOTA>1,23</KWOTA> <TRESC>tresc</TRESC> <RACHUNEK>60191010480000111122223333</RACHUNEK> <NAZWA>Odbiorca Testowy S.A. ul. Testowa 1/2 30-300 Testowo</NAZWA> <KWOTA>10.20</KWOTA> <TRESC>tresc bez podawania banku</tresc> <DATA>2014-05-25</DATA> 11 /35
<BANK>19101048</BANK> <RACHUNEK>60191010480000111122223333</RACHUNEK> <NAZWA>Odbiorca Testowy S.A. ul. Testowa 1/2 30-300 Testowo</NAZWA> <KWOTA>48,52</KWOTA> <REFERENCJE>test</REFERENCJE> <TRESC>polskie znaki: zaó gl ja</tresc> <DATA>2014-04-30</DATA> <BANK>19101048</BANK> <RACHUNEK>60191010480000111122223333</RACHUNEK> <NAZWA1>Odbiorca Testowy S.A.</NAZWA1> <NAZWA2>ul. Testowa 1/2</NAZWA2> <NAZWA3>30-300</NAZWA3> <NAZWA4>Testowo</NAZWA4> <KWOTA>2.58</KWOTA> <TRESC>dowolny tytu patnoci</tresc> <DATA>2014-05-24</DATA> <BANK>19101048</BANK> <RACHUNEK>60191010480000111122223333</RACHUNEK> <NAZWA1>Odbiorca Testowy S.A.</NAZWA1> <NAZWA2>ul. Testowa 1/2</NAZWA2> <NAZWA3>30-300</NAZWA3> <NAZWA4>Testowo</NAZWA4> <KWOTA>1.11</KWOTA> <TRESC1>zapata</TRESC1> <TRESC2>za</TRESC2> <TRESC3>faktur</TRESC3> <TRESC4>FV 01/14</TRESC4> <DATA>2014-04-25</DATA> </PRZELEWY> Przykadowy plik XML z przelewami ZUS: <?xml version="1.0" encoding="iso-8859-2"?> <PRZELEWY> <RACHUNEK>83101010230000261395100000</RACHUNEK> <NAZWA>ZUS</NAZWA> <KWOTA>1,58</KWOTA> <TRESC>/NIP/1111111111/TI/P81010106007/TWP/S/DKL/042014/NRD/01/DUT/</TRESC> <RACHUNEK>83101010230000261395100000</RACHUNEK> <NAZWA>ZUS</NAZWA> <KWOTA>1.33</KWOTA> <TRESC1>/NIP/1111111111</TRESC1> <TRESC2>/TI/P81010106007/</TRESC2> <TRESC3>/TWP/S/DKL/042014</TRESC3> <TRESC4>/NRD/01/DUT/</TRESC4> <RACHUNEK>83101010230000261395100000</RACHUNEK> <NAZWA>ZUS</NAZWA> <KWOTA>1.44</KWOTA> <TRESC>/NIP/1111111111/TI/P81010106007/TWP/S/DKL/042014/NRD/01/DUT/</TRESC> <DATA>2014-05-24</DATA> </PRZELEWY> Przykadowy plik XML z przelewami US: <?xml version="1.0" encoding="iso-8859-2"?> <PRZELEWY> <REFERENCJE>przelew do us</referencje> <RACHUNEK>80101012700009252223000000</RACHUNEK> <NAZWA>US</NAZWA> 12 /35
<KWOTA>10,00</KWOTA> <TRESC>/TI/P81010106007/OKR/14R/SFP/PIT-37/TXT/deklaracja</TRESC> <RACHUNEK>80101012700009252223000000</RACHUNEK> <NAZWA>US</NAZWA> <KWOTA>40,58</KWOTA> <TRESC1>/TI/P81010106007</TRESC1> <TRESC2>/OKR/14M04</TRESC2> <TRESC3>/SFP/PIT-37</TRESC3> <TRESC4>/TXT/deklaracja</TRESC4> <RACHUNEK>80101012700009252223000000</RACHUNEK> <NAZWA>US</NAZWA> <KWOTA>8.25</KWOTA> <TRESC>/TI/P81010106007/OKR/14R/SFP/PIT-37/TXT/deklaracja</TRESC> <DATA>2014-05-27</DATA> </PRZELEWY> Przykadowy plik XML z przelewami zagranicznymi: <?xml version="1.0" encoding="iso-8859-2"?> <PRZELEWY> <RACHUNEK>DE90160500001111000022</RACHUNEK> <NAZWA>Odbiorca Testowy S.A., ul. Testowa 1/2, 30-300 Testowo</NAZWA> <KWOTA>10.10</KWOTA> <TRESC>przelew zagraniczny</tresc> <BANK_SWIFT>DEUTDE2H</BANK_SWIFT> <BANK_ODDZ>271</BANK_ODDZ> <INFO_DOD>dodatkowe informacje</info_dod> <KOSZTY_POKRYWA>OUR</KOSZTY_POKRYWA> <WALUTA>USD</WALUTA> <REFERENCJE>przelew zagraniczny</referencje> <RACHUNEK>DE90160500001111000022</RACHUNEK> <NAZWA>Odbiorca Testowy S.A. ul. Testowa 1/2 30-300 Testowo</NAZWA> <KWOTA>12,30</KWOTA> <TRESC>TRESC</TRESC> <BANK_SWIFT>DEUTDE2H</BANK_SWIFT> <BANK_ODDZ>271</BANK_ODDZ> <INFO_DOD>info dod</info_dod> <KOSZTY_POKRYWA>SHA</KOSZTY_POKRYWA> <WALUTA>EUR</WALUTA> <RACHUNEK>300000AUD02</RACHUNEK> <NAZWA1>Odbiorca Testowy S.A.</NAZWA1> <NAZWA2>ul. Testowa 1/2</NAZWA2> <NAZWA3>30-300 Testowo</NAZWA3> <KWOTA>1.23</KWOTA> <TRESC>TRESC</TRESC> <BANK_SWIFT>ANZBNZ22</BANK_SWIFT> <BANK_ODDZ>XXX</BANK_ODDZ> <KOSZTY_POKRYWA>BEN</KOSZTY_POKRYWA> <WALUTA>USD</WALUTA> </PRZELEWY> Przykadowy plik XML z przelewami europejskimi: <?xml version="1.0" encoding="iso-8859-2"?> <PRZELEWY> <RACHUNEK>DE90160500001111000022</RACHUNEK> <NAZWA>Odbiorca Testowy S.A., ul. Testowa 1/2, 30-300 Testowo</NAZWA> <KWOTA>20,10</KWOTA> <TRESC>przelew SEPA</TRESC> <BANK_SWIFT>DEUTDE2H</BANK_SWIFT> <BANK_ODDZ>271</BANK_ODDZ> <KRAJ>DE</KRAJ> 13 /35
<REFERENCJE>europejski</REFERENCJE> <RACHUNEK>DE90160500001111000022</RACHUNEK> <NAZWA>Odbiorca Testowy S.A. ul. Testowa 1/2 30-300 Testowo</NAZWA> <KWOTA>12,30</KWOTA> <TRESC>TRESC</TRESC> <KRAJ>DE</KRAJ> <RACHUNEK>IT35B0538713202000001211333</RACHUNEK> <NAZWA1>Odbiorca Testowy S.A.</NAZWA1> <NAZWA2>ul. Testowa 1/2</NAZWA2> <NAZWA3>30-300 Testowo</NAZWA3> <KWOTA>1.23</KWOTA> <TRESC>TRESC</TRESC> <BANK_SWIFT>BPMOIT22</BANK_SWIFT> <BANK_ODDZ>XXX</BANK_ODDZ> <WALUTA>EUR</WALUTA> <KRAJ>IT</KRAJ> </PRZELEWY> Import przelewów europejskich format ISO20022 Do weryfikacji struktury pliku importu przelewów SEPA w formacie ISO20022 wykorzystywany jest plik XSD w wersji pain.001.001.03. W pliku XSD interpretowane s ponisze pola z normy ISO20022: Nazwa pola w systemie Dugo pola w xsd Dugo pola w systemie Status Wymagany/ Opcjonalny 14 /35 Nazwa elementu XML - 3 - W +PmtInf ++PmtMtd - 4 - W +PmtInf + +CdtTrfTxInf +++PmtTpInf ++++SvcLvl +++++Cd Typ identyfikatora nadawcy Numer identyfikacyjny nadawcy Z rachunku 35 O +PmtInf ++Dbtr +++Id ++++OrgId/PrvId +++++Othr ++++++SchmeNm +++++++Prtry 35 35 O +PmtInf ++Dbtr +++Id ++++OrgId/PrvId +++++Othr ++++++Id wybór z listy W +PmtInf + +DbtrAcct +++Id ++++Othr +++++Id Uwagi Metoda patnoci Wymagane podanie wartoci TRF. Moliwe komunikaty bdów: - "Niepoprawna warto w polu Metoda patnoci -PmtInf.PmtMtd (poprawna warto to TRF)" Kod typu patnoci Wymagane podanie wartoci SEPA. Moliwe komunikaty bdów: - "Niepoprawna warto w polu ;Kod tytuu patnoci PmtInf.CdtTrfTxInf.PmtTpInf.SvcLvl. Cd (poprawna warto to SEPA)" Typ identyfikatora dla zleceniodawcy. Pole Prtry okrela typ identyfikatora Klienta: dowód osobisty paszport prawo jazdy Identyfikator 35 35 O +PmtInf Wg standardu jest to pole obowizkowe. Jeeli ma pozosta
Przelewu 15 /35 + +CdtTrfTxInf +++PmtId ++++EndToEndId Data realizacji W +PmtInf + +ReqdExctnDt Kwota przelewu 18 15 W +PmtInf + +CdtTrfTxInf +++Amt ++++InstdAmt Prowizje i koszty 4 - W +PmtInf ++ChrgBr Nazwa odbiorcy 140 2*35 W +PmtInf + +CdtTrfTxInf +++Cdtr ++++Nm Adres odbiorcy 140 2*35 +PmtInf + +CdtTrfTxInf +++Cdtr +++PstlAdr Kraj 2 wybór z listy O +PmtInf + +CdtTrfTxInf +++Cdtr +++PstlAdr ++++Ctry Typ identyfikatora odbiorcy Numer identyfikacyjny odbiorcy 35 35 O +PmtInf ++Cdtr +++Id ++++OrgId/PrvId +++++Othr ++++++SchmeNm +++++++Prtry 35 35 O +PmtInf ++Cdtr +++Id ++++OrgId/PrvId +++++Othr ++++++Id Adres odbiorcy 140 2*35 O +PmtInf + +CdtTrfTxInf +++Cdtr +++PstlAdr ++++AdrLine Numer rachunku odbiorcy 34 34 W +PmtInf + +CdtTrfTxInf +++CdtrAcct ++++Id +++++Othr ++++++Id Tytu 140 4*35 W +PmtInf + +CdtTrfTxInf +++RmtInf ++++Ustrd Kategoria przelewu sownik O +PmtInf + +CdtTrfTxInf +++PmtTpInf ++++CtgyPurp puste to powinno by uzupenione wartoci 'NOT PROVIDED'. akceptuje pust warto tego pola. Wymagane jest podanie waluty przelewu (EUR). <InstdAmt Ccy="EUR">10.00</InstdAmt> db powernet akceptuje maksymalnie 2 miejsca po przecinku. Wymagane jest podanie wartoci 'SLEV'. Moliwe komunikaty bdów: - "Niepoprawna warto w polu (PmtInf.ChrgBr)" Kraj odbiorcy Typ identyfikatora dla odbiorcy Numer identyfikacyjny, interpretacja zalena od wartoci przekazanej w polu Typ identyfikatora odbiorcy Numer w formacie IBAN Czteroznakowy kod kategorii przelewu przykadowo: BONU (Patno Premii)
Przeznaczenie przelewu +++++Cd sownik O +PmtInf + +CdtTrfTxInf +++Purp ++++Cd Czteroznakowy kod przeznaczenia przelewu przykadowo: CBLK (Rozliczenia Kartowe Hurtowe) Przykad pliku importu z przelewami SEPA w formacie ISO20022: <?xml version="1.0" encoding="utf-8"?> <Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.03" xmlns:xsi="http://www.w3.org/2001/xmlschemainstance"> <CstmrCdtTrfInitn> <GrpHdr> <MsgId>?</MsgId> <CreDtTm>2016-06-08T00:00:00</CreDtTm> <NbOfTxs>1</NbOfTxs> <InitgPty> <Id> <PrvtId> <Othr> <Id>?</Id> </Othr> </PrvtId> </Id> </InitgPty> </GrpHdr> <PmtInf> <PmtInfId>?</PmtInfId> <PmtMtd>TRF</PmtMtd> <ReqdExctnDt>2016-12-11</ReqdExctnDt> <Dbtr> <Id> <PrvtId> <Othr> <Id>FG</Id> <SchmeNm> <Prtry>Dowod osobisty</prtry> </SchmeNm> </Othr> </PrvtId> </Id> </Dbtr> <DbtrAcct> <Id> <Othr> <Id>04191010482101000999990001</Id> </Othr> </Id> </DbtrAcct> <DbtrAgt> <FinInstnId> </FinInstnId> </DbtrAgt> <ChrgBr>SLEV</ChrgBr> <CdtTrfTxInf> <PmtId> <EndToEndId>fds</EndToEndId> </PmtId> <PmtTpInf> <SvcLvl> <Cd>SEPA</Cd> </SvcLvl> <CtgyPurp> <Cd>BONU</Cd> </CtgyPurp> </PmtTpInf> <Amt> <InstdAmt Ccy="EUR">1.99</InstdAmt> </Amt> 16 /35
<Cdtr> <Nm>ISO</Nm> <PstlAdr> <Ctry>PL</Ctry> <AdrLine> </AdrLine> </PstlAdr> <Id> <OrgId> <Othr> <Id>1234</Id> <SchmeNm> <Prtry>Paszport</Prtry> </SchmeNm> </Othr> </OrgId> <!--<PrvtId> <Othr> <Id>TMR</Id> <SchmeNm> <Prtry>Dowod tymczasowy</prtry> </SchmeNm> </Othr> </PrvtId>--> </Id> </Cdtr> <CdtrAcct> <Id> <Othr> <Id>DE8937040044053201311</Id> </Othr> </Id> </CdtrAcct> <Purp> <Cd>CBLK</Cd> </Purp> <RmtInf> <Ustrd>Co teraz</ustrd> </RmtInf> </CdtTrfTxInf> </PmtInf> </CstmrCdtTrfInitn> </Document> Import przelewów format liniowy Pole Dugo Typ Opis RACH_OBC 34 C rachunek do obcienia REFERENCJE* 15 C referencje wasne Klienta BANK* 8 N numer rozliczeniowy banku RACHUNEK 34 C numer rachunku kontrahenta DATA** 10 C data przelewu w formacie RRRR-MM-DD 17 /35 jeeli data jest wiksza od biecej, tworzony jest przelew odroczony, jeeli data jest mniejsza od biecej, tworzony jest przelew z dat biec NAZWA 140 C pena nazwa kontrahenta 4x35 znaków jeli w polu wystpuj znaki traktowane s one jako separatory wierszy zamiast pola NAZWA mog wystpowa pola NAZWA1, NAZWA2, NAZWA3, NAZWA4 o dugoci 35 znaków kade Dla formatek, gdzie Nazwa i Adres kontrahenta wprowadzane sa w osobne pola w przypadku zastosowania pola <NAZWA> pierwsze 70 znaków to Nazwa, kolejne 70 to adres beneficjenta. Jeli uyte sa pola <NAZWA1>, <NAZWA2>, <NAZWA3>, <NAZWA4>tre pierszych dwóch importuje si jako nazwa, tre trzeciego i czwartego jako adres kontrahenta.
KWOTA 26 N kwota przelewu TRESC 140 C tytu przelewu 4x35 znaków dla przelewów ZUS: pierwsze 35 znaków (lub pierwszy wiersz): NIP drugie 35 znaków (lub drugi wiersz): typ drugiego identyfikatora i numer drugiego identyfikatora trzecie 35 znaków (lub trzeci wiersz): typ wpaty, deklaracja i numer deklaracji czwarte 35 znaków (lub czwarty wiersz): numer decyzji/umowy/tytuu wykonawczego dla przelewów US: po sowie kluczowym /TI/ typ identyfikatora uzupeniajcego i identyfikator uzupeniajcy po sowie kluczowym /OKR/ oznaczenie okresu nalenoci po sowie kluczowym /SFP/ symbol formularza patnoci po sowie kluczowym /TXT/ opis zobowizania jeli w polu wystpuj znaki traktowane s one jako separatory wierszy zamiast pola TRESC mog wystpowa pola TRESC1, TRESC2, TRESC3, TRESC4 o dugoci 35 znaków kade BANK_SWIFT 8 C kod SWIFT banku Tylko przelew zagraniczny i opcjonalnie europejski! BANK_ODDZ 3 C kod oddziau banku Tylko przelew zagraniczny i opcjonalnie europejski! INFO_DOD* 35 C informacje dodatkowe Tylko przelew zagraniczny! KOSZTY_POKRYWA 3 C strona pokrywajca koszty innych banków Tylko przelew zagraniczny! SHA koszty podzielone pomidzy zleceniodawc i beneficjenta, OUR koszty pokrywa zleceniodawca, BEN koszty pokrywa odbiorca WALUTA 3 C waluta przelewu Tylko przelew zagraniczny! KRAJ 2 C dwuliterowy symbol kraju Tylko przelew europejski! * dozwolona jest warto pusta lub brak pola ** dozwolony jest brak pola Przykadowe opisy rónych struktur plików z przelewami: [przel_lin.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=RACH_OBC Char Width 34 Col2=REFERENCJE Char Width 16 Col3=RACHUNEK Char Width 34 Col4=NAZWA1 Char Width 35 Col5=NAZWA2 Char Width 35 Col6=NAZWA3 Char Width 35 Col7=NAZWA4 Char Width 35 Col8=KWOTA Float Col9=TRESC1 Char Width 35 Col10=TRESC2 Char Width 35 Col11=TRESC3 Char Width 35 Col12=TRESC4 Char Width 35 lub: [przel_zagraniczny.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=RACH_OBC Char Width 34 Col2=REFERENCJE Char Width 16 Col3=RACHUNEK Char Width 34 Col4=NAZWA1 Char Width 35 18 /35
Col5=NAZWA2 Char Width 35 Col6=NAZWA3 Char Width 35 Col7=NAZWA4 Char Width 35 Col8=KWOTA Float Col9=TRESC1 Char Width 35 Col10=TRESC2 Char Width 35 Col11=TRESC3 Char Width 35 Col12=TRESC4 Char Width 35 Col13=BANK_SWIFT Char Width 8 Col14=BANK_ODDZ Char Width 3 Col15=KOSZTY_POKRYWA Char Width 3 Col16=INFO_DOD Char Width 35 Col17=WALUTA Char Width 3 Import patnoci masowych format XML Pole Dugo Opis <PRZELEWY> - element gówny (root) moe zawiera dowoln ilo elementów - dane kolejnych zlece wchodzcych w skad patnoci masowej <REFERENCJE>* referencje wasne Klienta <RACH_OBC> 34 rachunek do obcienia <BANK>* 8 numer rozliczeniowy banku <RACHUNEK> 34 numer rachunku kontrahenta <DATA>** 10 data przelewu w formacie RRRR-MM-DD jeeli data jest mniejsza od biecej, tworzony jest przelew z dat biec, nie mona ustali realizacji patnoci na dat przysz <NAZWA> 140 pena nazwa kontrahenta 4x35 znaków jeli w polu wystpuj znaki traktowane s one jako separatory wierszy zamiast pola <NAZWA> mog wystpowa pola <NAZWA1>, <NAZWA2>, <NAZWA3>, <NAZWA4> o dugoci 35 znaków kade <KWOTA> 26 kwota zlecenia <TRESC> 140 dla przelewów zwykych, tytu/tre przelewu jeli w polu wystpuj znaki traktowane s one jako separatory wierszy zamiast pola <TRESC> mog wystpowa pola <TRESC1>, <TRESC2>, <TRESC3>, <TRESC4> o dugoci 35 znaków kade * dozwolona jest warto pusta lub brak pola ** dozwolony jest brak pola Kade powtórzenie tagów... jest importowane jako nowe zlecenie wchodzce w skad patnoci masowej. Przykadowy plik XML z patnoci masow: <?xml version="1.0" encoding="iso-8859-2"?> <PRZELEWY> <REFERENCJE>test</REFERENCJE> <DATA>2014-04-25</DATA> <BANK>19101048</BANK> <RACHUNEK>60191010480000111122223333</RACHUNEK> <NAZWA>Jan Kowalski</NAZWA> <KWOTA>160,00</KWOTA> <TRESC>Rozliczenie delegacji</tresc> <RACHUNEK>60191010480000111122223333</RACHUNEK> <NAZWA>Janusz Kowalik</NAZWA> <KWOTA>120,00</KWOTA> <TRESC>Rozliczenie delegacji</tresc> <DATA>2014-04-25</DATA> <BANK>19101048</BANK> <RACHUNEK>60191010480000111122223333</RACHUNEK> 19 /35
<NAZWA>Janina Kowal</NAZWA> <KWOTA>160,00</KWOTA> <REFERENCJE>referencje</REFERENCJE> <TRESC>Rozliczenie delegacji</tresc> <DATA>2014-04-25</DATA> <BANK>19101048</BANK> <RACHUNEK>60191010480000111122223333</RACHUNEK> <NAZWA1>Anna Nowak</NAZWA1> <NAZWA2>ul. Testowa 1/2</NAZWA2> <NAZWA3>30-300</NAZWA3> <NAZWA4>Testowo</NAZWA4> <KWOTA>80,00</KWOTA> <TRESC>Rozliczenie delegacji</tresc> <DATA>2014-04-25</DATA> <BANK>19101048</BANK> <RACHUNEK>60191010480000111122223333</RACHUNEK> <NAZWA1>Maria Nowakowska</NAZWA1> <NAZWA2>ul. Testowa 3/2</NAZWA2> <NAZWA3>30-300</NAZWA3> <NAZWA4>Testowo</NAZWA4> <KWOTA>200,00</KWOTA> <TRESC1>Rozliczenie</TRESC1> <TRESC2>delegacji</TRESC2> <DATA>2014-04-25</DATA> </PRZELEWY> Import patnoci masowych format liniowy Pole Dugo Typ Opis RACH_OBC 34 C rachunek do obcienia REFERENCJE* 15 C referencje wasne Klienta BANK* 8 N numer rozliczeniowy banku RACHUNEK 34 C numer rachunku kontrahenta DATA** 10 C data przelewu w formacie RRRR-MM-DD, jeeli data jest mniejsza od biecej, tworzony jest przelew z dat biec nie mona ustali realizacji patnoci na dat przysz NAZWA 140 C pena nazwa kontrahenta 4x35 znaków jeli w polu wystpuj znaki traktowane s one jako separatory wierszy zamiast pola NAZWA mog wystpowa pola NAZWA1, NAZWA2, NAZWA3, NAZWA4 o dugoci 35 znaków kade KWOTA 26 N kwota przelewu TRESC 140 C tytu przelewu 4x35 znaków jeli w polu wystpuj znaki - traktowane s one jako separatory wierszy zamiast pola TRESC mog wystpowa pola TRESC1, TRESC2, TRESC3, TRESC4 o dugoci 35 znaków kade * dozwolona jest warto pusta lub brak pola ** dozwolony jest brak pola Przykadowy opis struktur pliku importu patnoci masowej: [platnosc_masowa.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=RACH_OBC Char Width 34 Col2=REFERENCJE Char Width 16 Col3=RACHUNEK Char Width 34 Col4=NAZWA1 Char Width 35 Col5=NAZWA2 Char Width 35 Col6=NAZWA3 Char Width 35 Col7=NAZWA4 Char Width 35 Col8=KWOTA Float 20 /35
Col9=TRESC1 Char Width 35 Col10=TRESC2 Char Width 35 Col11=TRESC3 Char Width 35 Col12=TRESC4 Char Width 35 Import polece zapaty format XML Pole Dugo Opis <POLECENIA> - element gówny (root) moe zawiera dowoln ilo elementów <POLECENIE> <POLECENIE> - dane kolejnych polece zapaty <RACH_UZN> 34 uznawany rachunek (wasny rachunek) <RACHUNEK> 34 numer rachunku kontrahenta <NAZWA> 140 pena nazwa kontrahenta <KWOTA> 26 kwota operacji zamiast pola <NAZWA> mog wystpowa pola <NAZWA1>, <NAZWA2>, <NAZWA3>, <NAZWA4> o dugoci 35 znaków kade <TRESC> 100 tytu polecenia 4x35 znaków dla polece zapaty: po sowie kluczowym /NIP/ NIP wierzyciela, dugo pola do 10 znaków, po sowie kluczowym /IDP/ identyfikator patnoci, dugo pola do 20 znaków, po sowie kluczowym /TXT/ tytu patnoci, dugo pola do 70 znaków. zamiast pola <TRESC> mog wystpowa pola <TRESC1>, <TRESC2>, <TRESC3>, <TRESC4> o dugoci 35 znaków kade <DATA>** 10 data polecenia w formacie RRRR-MM-DD, jeeli data jest mniejsza od biecej, tworzone jest polecenie z dat biec. * dozwolona pusta warto lub brak pola ** dozwolony jest brak pola Kade powtórzenie tagów <POLECENIE>... </POLECENIE> jest importowane jako nowe polecenie zapaty. Przykadowy plik XML z poleceniem zapaty: <?xml version="1.0" encoding="iso-8859-2"?> <POLECENIA> <POLECENIE> <RACH_UZN>04191010482101000123450001</RACH_UZN> <RACHUNEK>13858900060000001234560001</RACHUNEK> <NAZWA> Adam Nowak</NAZWA> <KWOTA>42.98</KWOTA> <TRESC>/NIP/1111111111/IDP/123</TRESC> <DATA>2014-05-05</DATA> </POLECENIE> <POLECENIE> <RACH_UZN>04191010482101000123450001</RACH_UZN> <RACHUNEK>13858900060000001234560001</RACHUNEK> <NAZWA1>Alina Nowacka</NAZWA1> <NAZWA2>ul. Zielona 23</NAZWA2> <NAZWA3>00-003 Biaa</NAZWA3> <KWOTA>70.52</KWOTA> <TRESC>/NIP/1111111111/IDP/123</TRESC> <DATA>2014-05-05</DATA> </POLECENIE> <POLECENIE> <RACH_UZN>04191010482101000123450001</RACH_UZN> <RACHUNEK>13858900060000001234560001</RACHUNEK> <NAZWA>Jan Nowakowski</NAZWA> <KWOTA>83,53</KWOTA> <TRESC>/NIP/1111111111/IDP/123/</TRESC> </POLECENIE> </POLECENIA> 21 /35
Import polece zapaty format liniowy Pole Dugo Typ Opis RACH_UZN 34 C uznawany rachunek (rachunek wasny) RACHUNEK 34 C numer rachunku kontrahenta NAZWA 140 C pena nazwa kontrahenta 4x35 znaków zamiast pola NAZWA mog wystpowa cztery pola NAZWA1, NAZWA2, NAZWA3, NAZWA4 o dugoci 35 znaków kade KWOTA 26 N kwota przelewu TRESC 140 C tytu polecenia 4x35 znaków dla polece zapaty: po sowie kluczowym /NIP/ NIP wierzyciela, dugo pola do 10 znaków, po sowie kluczowym /IDP/ identyfikator patnoci, dugo pola do 20 znaków, po sowie kluczowym /TXT/ tytu patnoci, dugo pola do 70 znaków. zamiast pola TRESC mog wystpowa cztery pola TRESC1, TRESC2, TRESC3, TRESC4 o dugoci 35 znaków kade DATA** 10 C data polecenia w formacie RRRR-MM-DD, jeeli data jest mniejsza od biecej, tworzone jest polecenie z dat biec * dozwolona jest warto pusta lub brak pola ** dozwolony jest brak pola Przykadowe opisy struktur plików importu polecenia zapaty: [polecenie_lin.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=RACH_UZN Char Width 34 Col2=RACHUNEK Char Width 34 Col3=NAZWA Char Width 140 Col4=KWOTA Float Col5=TRESC Char Width 140 lub: [polecenie_lin.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=RACH_UZN Char Width 34 Col2=RACHUNEK Char Width 34 Col3=NAZWA1 Char Width 35 Col4=NAZWA2 Char Width 35 Col5=NAZWA3 Char Width 35 Col6=NAZWA4 Char Width 35 Col7=KWOTA Float Col8=TRESC Char Width 140 lub: [polecenie_lin.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=RACH_UZN Char Width 34 Col2=RACHUNEK Char Width 34 Col3=NAZWA Char Width 140 Col4=KWOTA Float Col5=DATA Char Width 10 Col6=TRESC Char Width 140 22 /35
Import kontrahentów format XML Pole Dugo Opis <KONTRAHENCI> - element gówny (root) moe zawiera dowoln ilo elementów <KONTRAHENT> <KONTRAHENT> - dane kolejnych kontrahentów <NAZWA_KR>* 20 nazwa skrócona kontrahenta <BANK>* 8 numer rozliczeniowy banku kontrahenta <RACHUNEK> 34 numer rachunku kontrahenta <KRAJ> 2 dwuliterowy symbol kraju <SWIFT> 11 kod SWIFT banku <NAZWA> 140 pena nazwa i adres kontrahenta jeli w polu wystpuj znaki traktowane s one jako separatory wierszy pierwsze 70 znaków wypenia pole Nazwa, pozostae 70 znaków pole Adres zamiast pola <NAZWA> mog wystpowa pola <NAZWA1>, <NAZWA2>, <NAZWA3>, <NAZWA4> o dugoci 35 znaków kade, wtedy dwa pierwsze pola zawieraj dane na temat nazwy kontrahenta, trzecie i czwarte dane adresowe * dozwolona pusta warto Kade powtórzenie tagów <KONTRAHENT>... </KONTRAHENT> jest importowane jako nowy kontrahent. Przykadowy plik XML z kontrahentami: <?xml version="1.0" encoding="iso-8859-2"?> <KONTRAHENCI> <KONTRAHENT> <NAZWA_KR>J.Kowalski</NAZWA_KR> <BANK>10301944</BANK> <RACHUNEK>23103019440000111122223333</RACHUNEK> <NAZWA>Jan Piotr Kowalski</NAZWA> </KONTRAHENT> <KONTRAHENT> <NAZWA_KR>S.Kowalski</NAZWA_KR> <RACHUNEK>44103019440000111122224444</RACHUNEK> <NAZWA1>Stanisaw Kowalski</NAZWA1> <NAZWA2>ul. Biaa 12</NAZWA2> <NAZWA3>10-100 Zielonki</NAZWA3> <NAZWA4>woj. malopolskie</nazwa4> </KONTRAHENT> <KONTRAHENT> <NAZWA_KR>John Doe</NAZWA_KR> <RACHUNEK>IT35B0538713202000001112333</RACHUNEK> <NAZWA>John Doe 23 LONG Av.1231 Farfaraway</NAZWA> <SWIFT>BPMOIT22XXX</SWIFT> </KONTRAHENT> </KONTRAHENCI> Import kontrahentów format liniowy Pole Dugo Typ Opis NAZWA_KR* 20 C skrócona nazwa kontrahenta NAZWA 140 C pena nazwa i adres kontrahenta jeli w polu wystpuj znaki traktowane s one jako separatory wierszy pierwsze 70 znaków wypenia pole Nazwa, pozostae 70 znaków pole Adres zamiast pola NAZWA mog wystpowa pola NAZWA1, NAZWA2, NAZWA3, NAZWA4 o dugoci 35 znaków kade, wtedy dwa pierwsze pola zawieraj dane na temat nazwy kontrahenta, trzecie i czwarte dane adresowe BANK 8 N numer rozliczeniowy banku kontrahenta RACHUNEK 34 C numer rachunku kontrahenta KRAJ 2 C dwuliterowy symbol kraju SWIFT 11 C kod SWIFT banku * dozwolona pusta warto, podstawiane jest 20 pocztkowych znaków z nazwy 23 /35
Przykadowe opisy struktury pliku importu kontrahentów: [kontrah_lin.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=NAZWA_KR Char Width 20 Col2=NAZWA Char Width 140 Col3=BANK Integer Col4=RACHUNEK Char Width 34 lub: [kontrah_lin_zagt.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=NAZWA_KR Char Width 20 Col2=NAZWA Char Width 140 Col3=KRAJ Char Width 2 Col4=RACHUNEK Char Width 34 Col5=SWIFT Char Width 11 Import kontrahentów format Videotel Plik importu kontrahentów w formacie VideoTel jest plikiem tekstowym. Jedna linia zakoczona znakiem <CRLF> zawiera informacje o pojedynczym kontrahencie. Kady rekord jest zoony z 20 pól. Pola wystpuj w ustalonej kolejnoci, opisanej w tabeli poniej. Kade pole w rekordzie musi wystpi, a pola tekstowe, dla których nie jest przekazywana warto, s zapisane jako pusty string "". Poszczególne pola s oddzielone jedn i tylko jedn spacj i s objte cudzysowami. Jeeli w tekcie do zaimportowania ma si znale cudzysów, naley zastpi go dwoma apostrofami. Znakiem podziau linii w obrbie pola s trzy znaki zapytania. Wszystkie rachunki nadawców musz istnie w bazie danych. Polskie znaki kodowane s w standardzie ISO 8859-2 lub WINDOWS 1250. Formaty pól: N - pole numeryczne, wartoci jest liczba cakowita. Zapis 10N oznacza, e pole moe zawiera maksymalnie 10 cyfr. C - pole tekstowe. Zapis 3*35C oznacza e pole moe zawiera maksymalnie 3 linie po 35 znaków, nie wliczajc znaków podziau linii oraz liczc podwójne cudzysowy jako jeden znak. Struktura rekordu: Do wczytywane s pola o statusie M. Pola o statusie O s pomijane przy wczytywaniu pliku. Kolejno pola w rekordzie Nazwa pola Opis pola Format pola Status pola 1 BBen Nazwa banku beneficjenta 35C O 2 RBen Nazwa rachunku beneficjenta 3*35C O 3 NrBen Numer rachunku beneficjenta 34C M 4 REZ12 Klucz N O 5 WAL2 Waluta rachunku 3C O 6 TypRach Typ rachunku (np: RB, RBZ lub inny) 35C O 7 NF3 Nazwa firmy, do której maj by dopisane nowe rachunki beneficjenta, zawarto pola interpretowana jako nazwa skócona kontrahenta 8 ADR Adres 34C O 9 MST Nazwa miasta 34C O 10 KOD Kod pocztowy 34C O 11 NIP Numer NIP 34C O 12 REG Numer REGON 34C O 13 TEL Numer telefonu 34C O 14 DNN4 Domylna nazwa rachunków powizanych z dan firm NF 3*35C M 15 REZ2 Nazwa systemu finansowego 35C O 16 WL Okrelenie rodzaju wasnoci firmy NF "T " jeli firma wasna, N jeli firma obca 24 /35 20C M O
17 KRAJ Symbol kraju 2C O 18 DLUZ N lub T (T oznacza dunika) 1C O 19 IDPI Identyfikator patnoci 20C O 20 RDZIAL Rodzaj dziaalnoci F (dziano gospodarcza), P (pozostae) 1C O Uwagi: REZ1 - pole moe zawiera dowoln liczb cakowit np.1 WAL - w aplikacji przyjmowana zawsze warto PLN NF - zawarto pola interpretowana przez aplikacj jako nazwa skrócona kontrahenta - pole wymagane DNN - zawarto pola interpretowana przez aplikacj jako nazwa kontrahenta wraz z danymi adresowymi - pole wymagane Przykadowy rekord danych z pliku importu kontrahentów w formacie Videotel: "NBP O/Okr. w Warszawie" "Jan Kowalski???ul.Testowa 14???00-900 Warszawa" "64132000060000001111000001" "" "PLN" "RB" "Jan Kowalski" "" "" "" "" "" "" "Jan Kowalski???ul. Testowa 14???00-900 Warszawa" "N" "" "PL" "N" "" "" "BGK II O. w Warszawie" "Twoja Testowa Firma" "48835500001234567890012345" "" "PLN" "RB" "Twoja Testowa Firma" "" "" "" "" "" "" "Twoja Testowa Firma" "T" "" "PL" "N" "" "" Eksport statusów przelewów format XML Pole Dugo Opis <STATUSY> - element gówny (root) moe zawiera dowoln ilo elementów - dane kolejnych przelewów, element posiada atrybut num okrelajcy numer przelewu na licie <STATUS> 2 status przelewu <MODULO> 5 modulo Klienta <NRB> 34 rachunek do obcienia <DATA_WPISU> 10 data ostatniej edycji zlecenia <DATA_ZLECENIA> 10 data zlecenia przelewu <ID> 16 niepowtarzalny identyfikator przelewu w systemie <REFERENCJE> 20 referencje wasne uytkownika <BANK> 8 numer rozliczeniowy banku kontrahenta <RACHUNEK> 34 numer rachunku kontrahenta <KWOTA> 26 kwota przelewu <WALUTA> 3 waluta rachunku obcianego <NAZWA1> 35 nazwa kontrahenta wiersz 1 <NAZWA2> 35 nazwa kontrahenta wiersz 2 <NAZWA3> 35 nazwa kontrahenta wiersz 3 <NAZWA4> 35 nazwa kontrahenta wiersz 4 <TRESC1> 35 tytu przelewu wiersz 1 <TRESC2> 35 tytu przelewu wiersz 2 <TRESC3> 35 tytu przelewu wiersz 3 <TRESC4> 35 tytu przelewu wiersz 4 Kade powtórzenie tagów... jest traktowane jako kolejny przelew z listy. Do pliku przekazywane s przelewy o statusach odrzucone (OD) zrealizowane (ZR), anulowane (NA) lub usunite (AU). Przykadowy plik XML ze statusami przelewów: <?xml version="1.0" encoding="iso-8859-2"?> <STATUSY> <PRZELEW num="1"> <STATUS>AU</STATUS> <NRB>23191010488000222211110005</NRB> <DATA_WPISU>2014-04-25</DATA_WPISU> <DATA_ZLECENIA>2014-04-25</DATA_ZLECENIA> <ID>16832910</ID> <REFERENCJE>przelew</REFERENCJE> <BANK>19101048</BANK> <RACHUNEK>52191010488001329511110001</RACHUNEK> <KWOTA>2000.00</KWOTA> <WALUTA>PLN</WALUTA> <NAZWA1>Jan Kowalski</NAZWA1> 25 /35
<TRESC1>Wynagrodzenie</TRESC1> <PRZELEW num="2"> <STATUS>ZR</STATUS> <NRB>50191010488000293811110005</NRB> <DATA_WPISU>2014-04-25</DATA_WPISU> <DATA_ZLECENIA>2014-04-25</DATA_ZLECENIA> <ID>17302591</ID> <REFERENCJE>test</REFERENCJE> <RACHUNEK>85234000094100109000001414</RACHUNEK> <KWOTA>12.50</KWOTA> <WALUTA>PLN</WALUTA> <NAZWA1>Krzysztof Nowak</NAZWA1> <TRESC1>z</TRESC1> </STATUSY> Eksport statusów przelewów format liniowy Pole Dugo Typ Opis REFERENCJE 16 C referencje wasne uytkownika STATUS 2 status przelewu BLAD 80 C opis bdu w przelewie DATA_WPISU 10 C data ostatniej edycji zlecenia ID 10 C data zlecenia przelewu RACH_OBC 34 C numer rachunku do obcienia kwot przelewu WALUTA 3 C waluta rachunku obcianego NAZWA1 35 C nazwa kontrahenta wiersz 1 NAZWA2 35 C nazwa kontrahenta wiersz 2 NAZWA3 35 C nazwa kontrahenta wiersz 3 NAZWA4 35 C nazwa kontrahenta wiersz 4 RACHUNEK 34 C numer rachunku kontrahenta KWOTA 25 N kwota przelewu TRESC1 35 C tytu przelewu wiersz 1 TRESC2 35 C tytu przelewu wiersz 2 TRESC3 35 C tytu przelewu wiersz 3 TRESC4 35 C tytu przelewu wiersz 4 DATA 10 C data zlecenia Przykadowy opis struktury pliku eksportu statusów przelewów: [statusy_lin.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=REFERENCJE Char Width 16 Col2=STATUS Char Width 2 Col3=BLAD Char Width 80 Col4=DATA_WPISU Char Width 10 Col5=ID Char Width 10 Col6=RACH_OBC Char Width 34 Col7=WALUTA Char Width 3 Col8=NAZWA1 Char Width 35 Col9=NAZWA2 Char Width 35 Col10=NAZWA3 Char Width 35 Col11=NAZWA4 Char Width 35 Col12=RACHUNEK Char Width 34 Col13=KWOTA Float Col14=TRESC1 Char Width 35 Col15=TRESC2 Char Width 35 Col16=TRESC3 Char Width 35 Col17=TRESC4 Char Width 35 Col18=DATA Char Width 10 Do pliku przekazywane s przelewy o statusach: OD odrzucone ZR zrealizowane 26 /35
NA anulowane AU usunite Eksport statusów polece zapaty format XML Pole Dugo Opis <STATUSY> - element gówny (root) moe zawiera dowoln ilo elementów <POLECENIE> - dane kolejnego polecenia zapaty, element posiada atrybut num okrelajcy numer polecenia na licie <STATUS> 2 status przelewu <MODULO> 5 modulo Klienta <NRB> 34 rachunek do obcienia <DATA_WPISU> 10 data ostatniej edycji zlecenia <DATA_ZLECENIA> 10 data zlecenia przelewu <ID> 16 niepowtarzalny identyfikator przelewu w systemie <REFERENCJE> 20 referencje wasne uytkownika <BANK> 8 numer rozliczeniowy banku dunika <RACHUNEK> 34 numer rachunku dunika <KWOTA> 26 kwota polecenia zapaty <WALUTA> 3 waluta polecenia zapaty <NAZWA1> 35 nazwa dunika wiersz 1 <NAZWA2> 35 nazwa dunika wiersz 2 <NAZWA3> 35 nazwa dunika wiersz 3 <NAZWA4> 35 nazwa dunika wiersz 4 <TRESC1> 35 /NIP/ numer identyfikacji podatkowej wierzyciela <TRESC2> 35 /IDP/ identyfikator polecenia zapaty <TRESC3> 35 tytu zobowizania wiersz 1 <TRESC4> 35 tytu zobowizania wiersz 2 Kade powtórzenie tagów <POLECENIE>... </POLECENIE> jest traktowane jako kolejne polecenie z listy. Do pliku przekazywane s polecenia o statusach odrzucone (OD) zakoczone (NA) lub usunite (AU). Przykadowy plik XML ze statusami polece zapaty: <?xml version = '1.0' encoding = 'ISO-8859-2'?> <STATUSY> <POLECENIE num="1"> <STATUS>OD</STATUS> <MODULO>94399</MODULO> <NRB>13191010480009439922220002</NRB> <DATA_WPISU>2014-04-26</DATA_WPISU> <DATA_ZLECENIA>2014-04-26</DATA_ZLECENIA> <ID>3364</ID> <BANK>19101048</BANK> <RACHUNEK>22191010481911222211110002</RACHUNEK> <KWOTA>10</KWOTA> <WALUTA>PLN</WALUTA> <NAZWA1>Test</NAZWA1> <TRESC1>/NIP/1111111111</TRESC1> <TRESC2>/IDP/IDP</TRESC2> </POLECENIE> </STATUSY 27 /35