dla Klienta SGB Import i eksport danych Elektronicznej SGB dla Klientów indywidualnych, MSP jedn
Spis tre ci Spis tre ci Rozdzia... 1. Informacje o dokumencie...4 Rozdzia 2. Konwencje typograficzne... 5 Rozdzia 3. Wst p... 6 Rozdzia 4. Struktura i organizacja dokumentu... 7 Rozdzia 5. Opis funkcji importu i eksportu danych... 8 5.1. Funkcje importu danych...8 5.1.1. Import przelewów zwyk ych...8 5.1.2. Import przelewów ZUS... 9 5.1.3. Import przelewów podatku...11 5.1.4. Import odbiorców...12 5.2. Funkcje eksportu danych...13 5.2.1. Eksport statusów przelewów...13 5.2.2. Eksport listy operacji z historii rachunku...13 Rozdzia 6. Formaty danych i struktury plików...16 6.1. Formaty danych...16 6.2. Struktury plików...16 6.2.1. Struktury plików importu przelewów zwyk ych, ZUS oraz podatku...17 6.2.1.1. Plik w formacie XML...17 6.2.1.2. Plik w formacie Elixir...18 6.2.1.3. Plik w formacie liniowym...22 6.2.1.4. Plik w formacie Telekonto...25 6.2.1.5. Plik w formacie VideoTel...26 6.2.1.6. Plik w formacie P atnik...27 6.2.2. Struktury plików importu odbiorców...29 6.2.2.1. Plik w formacie liniowym...29 6.2.2.2. Plik w formacie XML...30 6.2.2.3. Plik w formacie Telekonto...31 6.2.3. Struktury plików eksportu statusów przelewów...32 6.2.3.1. Format liniowy...32 6.2.3.2. Format XML.33 6.2.4. Struktura plików eksportu operacji z historii rachunku...35 6.2.4.1. Format liniowy...35 6.2.4.2. Format XML.36 6.2.4.3. Plik w formacie MT940...37 6.2.4.4. Plik w formacie MT940/MultiCash... 40... Strona 2
Spis tre ci Rozdzia... 7. Konfiguracja parametrów importu/eksportu danych...42 Strona 3
Rozdzia 1. Informacje o dokumencie Niniejszy dokument jest dokumentacj u ytkownika systemu zakresie importu i eksportu danych. Strona 4
Rozdzia 2. Konwencje typograficzne W dokumentacji stosowane s nast puj ce konwencje typograficzne: Konwencja typograficzna lub znak wizualny Opis Standardowy Czcionka Verdana 8, Kolor czcionki RGB: (70, 72, 71), Justowanie tekstu, Interlinia 1 wiersz Tabela Czcionka Verdana 8, 7 lub 6, Kolor czcionki RGB: (70, 72, 71) lub (255, 255, 255) Pogrubienie Standardowy, Pogrubienie Pogrubienie Standardowy, Pogrubienie, Kolor czcionki RGB: (0, 69, 123) Pogrubienie Standardowy, Pogrubienie, Kolor czcionki RGB: (31, 178, 89) Kursywa Standardowy, Kursywa Podstawowy tekst dokumentacji Tekst w tabeli Nazwy sekcji i pól na formatkach Nazwy parametrów systemowych Nazwy licencji i udost pnie. Nazwy uprawnie cie ki,np.dane archiwalne ->Przegl danie.nazwy opcji systemu. Nazwy formatek i zak adek na formatkach. Nazwy raportów. Nazwy s wników. Warto i parametrów. Pozycje na listach warto i. Komunikaty systemowe. Podkre lenie Oznaczenie przyk adu np. Przyk ad 1. Linki na Standardowy, Podkre lenie formatkach s u ce do przej ia do innej opcji Tekst uwagi, komentarza, zastrze enia - informacje, na które nale y zwróci uwag podczas czytania dokumentacji lub pracy z systemem np. Uwaga Standardowy, Kolor czcionki RGB: (0, 69, 123) Uwaga:Podany powy ej adres internetowy jest przyk adowy. Informacj o adresie strony us ug internetowych udost pnia Bank. Tekst ostrze enia - ostrze enia zawieraj bardzo wa ne informacje, na które nale y zwróci szczególn uwag podczas czytania dokumentacji lub pracy z systemem, np. Ostrze enie Standardowy, Kolor czcionki RGB: (255, 0, 0) Uwaga!Zmiany przeksi gowa nie s kontrolowane przez system i wykonywane s wy cznie na w asn odpowiedzialno operatora! Link Standardowy, Podkre lenie, Kolor czcionki RGB: (0, 0, 255) Kod y Courier New 8, 7 lub 6, Kolor czcionki RGB: (70, 72, 71), Interlinia 1 wiersz CAPS LOCK Standardowy, Wersaliki [ ] Standardowy Odw ania do innych rozdzia w lub fragmentów tekstu. Adresy URL Fragmenty kodu ród wego.przyk ady wydruków Wyró nienie nag wków akapitów. Nazwy klawiszy na klawiaturze - kombinacje klawiszy, które nale y nacisn jednocze nie zawieraj znak "+" pomi dzy, np. CTRL+F Nazwy przycisków, np. [Czynno i] Strona 5
Rozdzia 3 Wst p Rozdzia 3. Wst p Dokument dotyczy funkcjonalno i systemu w zakresie importu i eksportu danych. Opisuje dost pne opcje w systemie oraz sposób ich wykorzystania. Zawiera tak e opis formatów danych, jak i struktury importowanych oraz eksportowanych plików. Strona 6
Rozdzia 4 Struktura i organizacja dokumentu Rozdzia 4. Struktura i organizacja dokumentu Dokumentacja zawiera w kolejnych punktach opis funkcji importu i eksportu danych, sposobu ich wykorzystywania i parametryzacji oraz dost pne formaty i struktury plików. Dokument mo na czyta w naturalnej kolejno i b d si ga do opisu odpowiedniej funkcji w zale no i od potrzeb. Strona 7
Rozdzia 5. Opis funkcji importu i eksportu danych W systemie def3000/reb dost pne s nast puj ce operacje dotycz ce importu i eksportu danych: import przelewów zwyk ych, import przelewów ZUS, import przelewów podatku, import odbiorców, eksport statusów przelewów, eksport zestawie operacji. 5.1. Funkcje importu danych 5.1.1. Import przelewów zwyk ych Import przelewów zwyk ych dost pny jest w opcji Transakcje -> Import przelewów zwyk ych. Po wybraniu opcji importu pojawia si okienko z mo liwo i wybrania pliku z danymi. Po wybraniu pliku z danymi i klikni ciu przycisku [Dalej], plik jest sprawdzany pod wzgl dem zgodno i z ustalon struktur i zapisywany w bazie danych. Kolejne okno informuje o sprawdzeniu pliku. W przypadku wyst pienia b dów w pliku z danymi przelewów system poinformuje o tym fakcie stosownymi komunikatami. Strona 8
Klikni cie przycisku [Zapisz poprawne] spowoduje zapisanie danych oraz dodanie przelewów do koszyk zlece. Przycisk [Anuluj] powoduje rezygnacj z importu przelewu i powrót do formatki umozliwaj cej wybór pliku do importu. 5.1.2. Import przelewów ZUS Import przelewów zwyk ychdost pny jest w opcji Transakcje -> Import przelewów do ZUS. Po wybraniu opcji importu pojawia si okienko z mo liwo i wybrania pliku z danymi. Po wybraniu pliku z danymi i klikni ciu przycisku [Dalej], plik jest sprawdzany pod wzgl dem zgodno i z ustalon struktur i zapisywany w bazie danych. Kolejne okno informuje o sprawdzeniu pliku. Strona 9
W przypadku wyst pienia b dów w pliku z danymi przelewów system poinformuje o tym fakcie stosownymi komunikatami. Klikni cie przycisku [Zapisz poprawne] spowoduje zapisanie danych oraz dodanie przelewów do koszyk zlece. Przycisk [Anuluj] powoduje rezygnacj z importu przelewu i powrót do formatki umozliwaj cej wybór pliku do importu. Strona 10
5.1.3. Import przelewów podatku Import przelewów zwyk ych dost pny jest w opcji Transakcj e -> Importu przelewów podatkowych. Po wybraniu opcji importu pojawia si okienko z mo liwo i wybrania pliku z danymi. Po wybraniu pliku z danymi i klikni ciu przycisku [Dalej], plik jest sprawdzany pod wzgl dem zgodno i z ustalon struktur i zapisywany w bazie danych. Kolejne okno informuje o sprawdzeniu pliku. W przypadku wyst pienia b dów w pliku z danymi przelewów system poinformuje o tym fakcie stosownymi komunikatami. Klikni cie przycisku [Zapisz poprawne] spowoduje zapisanie danych oraz dodanie przelewów do koszyk zlece. Przycisk [Anuluj] powoduje rezygnacj z importu przelewu i powrót do formatki umozliwaj cej wybór pliku do importu. Strona 11
5.1.4. Import odbiorców Import danych kontrahentów dost pny jest w opcji Transakcje ->Import odbiorców.po wybraniu opcji importu pojawia si okienko z mo liwo i wybrania pliku z danymi. Po wybraniu pliku z danymi i klikni ciu przycisku [Importuj plik], plik jest sprawdzany pod wzgl dem zgodno i z ustalon struktur i zapisywany w bazie danych. Klikni cie przycisku [Zapisz poprawne] spowoduje zapisanie danych. Przycisk [Anuluj] anuluje ca akcj i usuwa plik z danymi z bazy danych. W przypadku wyst pienia b dów w pliku z danymi kontrahentów system poinformuje o tym fakcie stosownymi komunikatami. Strona 12
5.2. Funkcje eksportu danych 5.2.1. Eksport statusów przelewów Eksport statusów przelewów dost pny jest w opcji Transakcj e -> Przelewy po zaznaczeniu na li ie przelewów o statusach wykonany lub odrzucony oraz wyborze przycisku [Eksportuj] dost pnego pod list przelewów. Po klikni ciu na przycisk system wy wietli standardowe okno przegl darki. Plik mo na wy wietli na ekranie lub zapisa we wskazanym miejscu. 5.2.2. Eksport listy operacji z historii rachunku Eksport listy operacji z historii rachunku dost pny jest w opcji Rachunki poprzez klikni cie na odno nik Historia rachunku dost pny w bocznym menu opcji lub poprzez wybór odno nika Historia dost pny w kolumnie Akcje dla danego rachunku. Strona 13
W celu wyeksportowania listy operacji nale y na formatce HISTORIA RACHUNKU wybra przycisk [Eksportuj] dostepny pod list operacji. Strona 14
Po klikni ciu na przycisk system wy wietli standardowe okno przegl darki. Plik mo na wy wietli na ekranie lub zapisa we wskazanym miejscu. Strona 15
Rozdzia 6. Formaty danych i struktury plików 6.1. Formaty danych System def3000/reb pozwala na import i eksport danych w ró nych sta ych oraz definiowanych formatach plików. Poni ej przedstawione s dost pne formaty danych przeznaczone dla importu i eksportu danych, z podzia em na poszczególne opcje systemu. Format importu przelewów zwyk ych: XML, Eliksir, Liniowy, Telekonto, Videotel. Format importu przelewów ZUS: XML, P atnik, Liniowy. Format importu przelewów podatku: XML, Eliksir, Liniowy. Format importu kontrahentów: XML, Liniowy, Telekonto. Format eksportu statusów przelewów: XML, Liniowy. Format eksportu operacji: XML, Liniowy, MT940, MT940/MultiCash. Formaty plików XML, Eliksir, P atnik, Videotel, Telekonto, MT940 oraz MT940/MultiCash maj sta okre lon struktur. Format pliku Liniowy zale y od zaimportowanej struktury z pliku "SCHEMA.INI". Dla danych w formacie XML niedozwolone s nast puj ce znaki: <, >. Je li w pliku XML wyst pi takie znaki b dzie on traktowany jako niepoprawny. Dla znaku & nale y zastosowa zamiennik: & - & 6.2. Struktury plików Poni ej opisane s poszczególne struktury plików obs ugiwane przez system wraz dok adnym opisem ka dego pola. Dla ka dej struktury podany jest przyk ad. Strona 16
6.2.1. Struktury plików importu przelewów zwyk ych, ZUS oraz podatku 6.2.1.1. Plik w formacie XML Dla pliku przelewów w formacie XML dozwolone jest stosowanie nast puj cych tagów (tekst pisany czcionk bold): <?xml version="1.0" encoding="iso-8859-2"?> <przelewy> <przelew> <rach_obc>rachunek y w formacie NRB</rach_obc> <bank>numer banku odbiorcy przelewu</bank> <rachunek>numer rachunku odbiorcy przelewu</rachunek> <nazwa>nazwa odbiorcy przelewu</nazwa> <kwota>kwota przelewu</kwota> <tresc> przelewu</tresc> </przelew>... </przelewy> Ka de powtórzenie tagów <przelew>... </przelew> jest interpretowane przez aplikacj jako nowy przelew. Uwaga: Nazwy tagów w opisie struktury powinny by pisane ma ymi literami. Kolejno poszczególnych tagów w pliku musi by zachowana. Przyk adowy plik.xml zawieraj cy przelewy: <?xml version="1.0" encoding="iso-8859-2"?> <przelewy> <przelew> <rach_obc>38 1130 0007 2001 0000 4444 0003</rach_obc> <bank>10800001</bank> <rachunek>63 1080 0001 1232 1232 1154 8412</rachunek> <nazwa>janina Testowa</nazwa> <kwota>123.10</kwota> <tresc>faktura nr 12345</tresc> </przelew> <przelew> > <rach_obc>38 1130 0007 2001 0000 4444 0003</rach_obc> <bank>10800001</bank> <rachunek>63 1080 0001 1232 1232 1154 8412</rachunek> <nazwa>piotr Testowy ul. Nowa 21</nazwa> <kwota>73.12</kwota> a za e mieszkania</tresc> </przelew> </przelewy> Przelewy ZUS i przelewy podatku Dla pliku przelewów ZUS i przelewów podatku w formacie XML dozwolone jest stosowanie nast puj cych tagów (tekst pisany czcionk bold): <?xml version="1.0" encoding="iso-8859-2"?> <przelewy> <przelew> <rach_obc>rachunek y w formacie NRB</rach_obc> <bank> w przypadku przelewu do ZUS numer banku ZUS w przypadku przelewu do US numer banku US Strona 17
</bank> <rachunek> w przypadku przelewu ZUS numer rachunku ZUS w przypadku przelewu US numer rachunku US </rachunek> <nazwa> nazwa odbiorcy przelewu w przypadku przelewu ZUS ZUS w przypadku przelewu US nazwa urz du skarbowego </nazwa> <kwota>kwota na jak przelew jest realizowany</kwota> <tresc> dla przelewu do ZUS ( tekst pogrubiony jest sta y): /NIP/numer nip/ti/typ identyfikatora numer identyfikatora/twp/typ wp aty (dozwolone warto i S, M, U, T, D, E, A, B)/DKL/deklaracja w formacie MMRRRR/NRD/numer deklaracji/dut/numer decyzji/umowy/tyt. wyk. dla przelewu do US (tekst pogrubiony jest sta y): /TI/typ identyfikatora numer identyfikatora/okr/okres w formacie RRTXXxx, gdzie RR rok, T oznaczenie typu(r rok, P pó rocze, K kwarta, M-miesi c, D dekada, J dzie ), XXxx oznaczenie pó rocza, kwarta u, miesi ca, miesi ca i dekady lub miesi ca i dnia/sfp/symbol formularza/txt/identyfikacja wp aty </tresc> </przelew>... </przelewy> Ka de powtórzenie tagów<przelew>... </przelew> jestinterpretowane przez aplikacj jako nowy przelew. Przyk adowy plik.xml zawieraj cy przelew ZUS: <?xml version="1.0" encoding="iso-8859-2"?> <przelewy> <przelew> <rach_obc>98161000192002000103660001</rach_obc> <bank>10101023</bank> <rachunek>83101010230000261395100000</rachunek> <nazwa>zus</nazwa> <kwota>100.00</kwota> <tresc>/nip/1111111111/ti/1ab1234567/twp/a/dkl/062009/nrd/01/dut/2</tresc> </przelew> </przelewy> Przyk adowy plik.xml zawieraj cy przelew podatku: <?xml version="1.0" encoding="iso-8859-2"?> <przelewy> <przelew> <rach_obc>38 1130 0007 2001 0000 4444 0003</rach_obc> <bank>10800001</bank> <rachunek>98 1010 1078 0024 1122 2200 0000</rachunek> d Skarbowy</nazwa> <kwota>123.10</kwota> <tresc>/ti/n8000007816 /OKR/04R/SFP/VAT-8 /TXT/podatek</tresc> </przelew> </przelewy> 6.2.1.2. Plik w formacie Elixir Plik z przelewami zwyk ymi Plik z przelewami do importu jest zapisany w formacie tekstowym. Ka de zlecenie przelewu zajmuje jedn lini (jeden rekord) zako czon znakiem <CRLF>. Ka dy rekord jest z ony z 17 pól. Pola s oddzielone separatorem. Separatorem jest przecinek. Pola wyst puj w ustalonej kolejno i, opisanej w cz i Struktura rekordu. Pola tekstowe s obj te cudzys wami. Pola tekstowe, dla których nie jest przekazywana warto, s zapisane jako pusty string. Puste pola ko cowe rekordu mog zosta pomini te. Strona 18
Znakiem podzia u linii w obr bie pola jest znak. Wszystkie rachunki nadawców musz istnie w bazie danych. Polskie znaki s kodowane w ISO 8859-2. Struktura rekordu: Rekord danych musi mie struktur zgodn ze struktur pliku przecinkowego Elixir. Typy danych stosowane przy opisie pól: N pole numeryczne, warto i jest liczba ca kowita D data w formacie RRRRMMDD, gdzie RRRR rok, MM miesi c, DD dzie (np. 20060501). C pole tekstowe. Dozwolone znaki zgodne z wymaganiami systemu Elixir. Rozmiar pola 4*35 oznacza e pole mo e zawiera maksymalnie 4 linie po 35 znaków, nie wliczaj c znaków podzia u linii. K pole zawieraj ce kwot. Kwota wyra ona w groszach. Nie mo e zawiera adnych separatorów dla cz i u amkowej ani separatorów tysi cy. Przyk ad:150 z nale y zapisa jako 15000, 10 z 90 gr jako 1090, zapis 50 oznacza kwot 50 gr. Do def3000/reb wczytywane s pola o statusie M. Pola o statusie O s pomijane przy wczytywaniu pliku do def3000/reb. Kolejn pola w rekordzie Pole wg Elixir Format Rozmiar Status pola Pole w def3000/reb Opis pola w def3000/reb 1 T yp komunikatu N 3 O - Pole pomijane przy wczytywaniu do def3000/reb 2 Data transakcji D 8 M DA TA Data zlecenia. Pole obowi zkowe, konieczne jest przekazanie wa nej warto ci. 3 Kwota K 15 M KWOTA Kwota zlecenia.waluta domy lnie przyjmowana jako PLN. Pole obowi zkowe,konieczne jest przekazanie wa nej warto ci. 4 Nr jednostki prezentuj c ej 5 Nr jednostki odbieraj c ej 6 Rachunek klienta nadawc y 7 Rachunek klienta adres ata 8 Nazwa klienta nadawc y 9 Nazwa klienta adres ata 10 Numer nadawcy uczestnika po redniego 11 Numer oddzia u finalny adresat 12 Informac je dodatkowe N 8 O - Pole pomijane przy wczytywaniu do def3000/reb N 8 O - Pole pomijane przy wczytywaniu do def3000/reb C 34 M RA C H_O BC Numer rachunku nadawcy. Pole obowi zkowe,konieczne jest przekazanie wa nej warto ci. C 34 M RA C HUNEK Numer rachunku beneficjenta. Pole obowi zkowe,konieczne jest przekazanie wa nej warto ci. C 4*35 O - Pole pomijane przy wczytywaniu do def3000/reb C 4*35 M NA ZWA Nazwa beneficjenta. Pole obowi zkowe,konieczne jest przekazanie wa nej warto ci. N 8 O - Pole pomijane przy wczytywaniu do def3000/reb N 8 M BA NK Bank beneficjenta. Pole nie jest obowi zkowe, mo na przekaza warto pus. C 4*35 M T RESC Tytu p atno ci przelewu.pole obowi zkowe,konieczne jest przekazanie wa nej warto ci. 13 Numer czeku C 10 O - Pole pomijane przy wczytywaniu do def3000/reb 14 Szc zegó y reklamacji C 4*35 O - Pole pomijane przy wczytywaniu do def3000/reb 15 Dodatkowa C 34 O - Pole pomijane przy wczytywaniu do identyfikac ja s praw def3000/reb 16 Informacje mi dzybankowe C 16 M REFERENC JE Dodatkowy identyfikator przelewu referencje. Pole nie jest obowi zkowe- mo na przekaza warto pus. 17 Dowolny tekst C 35 O - Pole pomijane przy wczytywaniu do def3000/reb Strona 19
Przyk ady rekordów z pliku przelewów w formacie Elixir: i a Pracy d Pracy a za nr 2006-01- 01","","","51","ref1-2006","" d Testowy Jan Kowalski Test Warszawa ul. a za " 110,20060527,2000,,,"32156000132005000001720001","48835500091234567890123456","","Telekomun ikacja a za a vat 0605/12345","" 110,20060527,2000,,,"32156000132005000001720001","48835500091234567890123456","","Telekomun ikacja a instalacyjna","","","","","",20060527,3000,,,"32156000132005000001720001","48835500091234567890123456","","telekomunika cja uga instalacyjna" Plik z przelewami podatku Plik z przelewami podatku jest zapisany w formacie tekstowym. Ka de zlecenie przelewu zajmuje jedn lini (jeden rekord) zako czon znakiem <CRLF>. Ka dy rekord jest z ony z 17 pól. Pola wyst puj w ustalonej kolejno i opisanej w cz i Struktura rekordu. Pola s oddzielone separatorem. Separatorem jest przecinek. Pola tekstowe s obj te cudzys wami. Pola tekstowe, dla których nie jest przekazywana warto, s zapisane jako pusty string. Puste pola ko cowe rekordu mog zosta pomini te. Znakiem podzia u linii w obr bie pola jest znak. Wszystkie rachunki nadawców musz istnie w bazie danych. Polskie znaki s kodowane w formacie ISO 8859-2. Struktura rekordu: Rekord danych musi mie struktur zgodn ze struktur pliku przecinkowego Elixir. Typy danych stosowane przy opisie pól: N pole numeryczne, warto i jest liczba ca kowita. D data w formacie RRRRMMDD, gdzie RRRR - rok, MM - miesi c, DD dzie (np. 20060501). C pole tekstowe. Dozwolone znaki zgodne z wymaganiami systemu Elixir. Rozmiar pola 4*35 oznacza e pole mo e zawiera maksymalnie 4 linie po 35 znaków, nie wliczaj c znaków podzia u linii. K pole zawieraj ce kwot. Kwota wyra ona w groszach. Nie mo e zawiera adnych separatorów dla cz i u amkowej ani separatorów tysi cy. Przyk ad:150 z nale y zapisa jako 15000, 10 z 90 gr jako 1090, zapis 50 oznacza kwot 50 gr. Do def3000/reb wczytywane s pola o statusie M. Pola o statusie O s pomijane przy wczytywaniu pliku do def3000/reb. Kolejn pola w rekordzie Pole wg Elixir 1 Typ komunikatu Format Rozmiar Status pola Pole w def3000/reb Opis pola w def3000/reb N 3 O - Pole pomijane przy wczytywaniu do def3000/reb 2 Data transakcji D 8 M DATA Data zlecenia. Pole obowi zkowe, konieczne jest przekazanie wa nej warto i. 3 Kwota K 15 M KWOTA Kwota zlecenia. Waluta domy lnieprzyjmowanajako PLN. Pole obowi zkowe, konieczne jest przekazanie wa nej warto i. 4 Nr jednostki prezentuj cej 5 Nr jednostki odbieraj cej 6 Rachunek klienta nadawcy 7 Rachunek klienta adresata N 8 O - Pole pomijane przy wczytywaniu do def3000/reb N 8 O - Pole pomijane przy wczytywaniu do def3000/reb C 34 M RACH_OBC Numer rachunku nadawcy. Pole obowi zkowe, konieczne jest przekazanie wa nej warto i. C 34 M RACHUNEK Numer rachunku dla p atno i podatku. Pole obowi zkowe, konieczne jest przekazanie wa nej warto i. Strona 20
8 Nazwa klienta nadawcy 9 Nazwa klienta adresata 10 Numer nadawcy uczestnika po redniego 11 Numer oddzia u finalny adresat 12 Informacje dodatkowe C 4*35 O - Pole pomijane przy wczytywaniu do def3000/reb C 4*35 M NAZWA Nazwa beneficjenta dla p atno i podatku. Pole obowi zkowe, konieczne jest przekazanie wa nej warto i. N 8 O - Pole pomijane przy wczytywaniu do def3000/reb N 8 M BANK Bank beneficjenta dla p atno i podatku. Pole nie jest obowi zkowe, mo na przekaza warto pust. C 4*35 M TRESC1 Informacje o p atno i podatku typ i zawarto identyfikatora, okres za który dokonywana jest p atno, symbol formularza lub tytu p atno i, opis p atno i. Pole obowi zkowe, konieczne jestprzekazanie wa nej warto i. 13 Numer czeku C 10 O - Pole pomijane przy wczytywaniu do def3000/reb 14 Szczeg y reklamacji 15 Dodatkowa identyfikacja spraw 16 Informacje mi dzybankow e C 4*35 O - Pole pomijane przy wczytywaniu do def3000/reb C 34 O - Pole pomijane przy wczytywaniu do def3000/reb C 16 M REFERENCJE Dodatkowy identyfikator przelewu referencje. Pole nie jestobowi zkowe-mo na przekaza warto pust. 17 Dowolny tekst C 35 O - Pole pomijane przy wczytywaniu do def3000/reb 1 Sposób wype niania pola TRESC jest zgodny z zasadami obowi zuj cymi dla Elixir. W polu nale y wprowadzi jednym ci giem: wo kodowe /TI/, typ identyfikatora (1X) i zawarto identyfikatora (14X) wo kodowe /OKR/ i okres za który dokonywana jest p atno (7X) wo kodowe /SFP/ i symbol formularza lub p atno i (7X) wo kodowe /TXT/ i opcjonalnie tytu p atno i (40X) Przyk ady: /TI/N1111111111/OKR/06M05/SFP/VAT-7/TXT/podatek vat za m-c maj 2006 /TI/1WL1234567/OKR/06D0105/SFP/VAT-7/TXT/ Przyk ady rekordów z pliku w formacie Elixir: 110,20060529,300,,,"32156000132005000001720001","98101010780024112222000000",""," d Skarbowy Aleksandrów Kujawski ",15600001,10101078,"/TI/N1111111111/OKR/06R/SFP/VAT-7/TXT/ podatek za m-c maj 06","","","71","podatek maj 2006","",20060529,400,,,"32156000132005000001720001","98101010780024112222000000",""," d Skarbowy Aleksandrów Kujawski",15600001,10101078,"/TI/N1111111111/OKR/06R/SFP/VAT-7/ TXT/","","","","podatek maj 2006","",20060529,500,,,"32156000132005000001720001","98101010780024112222000000",""," d Skarbowy Aleksandrów Kujawski",,,"/TI/N1111111111/OKR/06R/SFP/VAT-7/TXT/","","","","","",20060529,500,,,"32156000132005000001720001","98101010780024112222000000",""," d Skarbowy Aleksandrów Kujawski",,,"/TI/1WL1234567/OKR/06R/SFP/VAT-7/TXT/" Strona 21
6.2.1.3. Plik w formacie liniowym W formacie liniowym dane przelewów importowane s z pliku tekstowego o strukturze opisanej w pliku schema.ini. Informacja o pojedynczym przelewie zajmuje jedn lini (rekord) zako czon znakami <CRLF>. Ka da linia sk ada si z pól zawieraj cych dane przelewu. Pola wyst puj w pliku w okre lonej kolejno i, zgodnie z opisem struktury ze schema.ini. Pola oddzielone s separatorem (okre lonym w pliku schema.ini) lub s sta ej d ugo i. Dopuszczalny zestaw pól opisuj cych przelew wraz z formatem danych dla ka dego pola przedstawiono w poni ej tabeli: Typy danych stosowane przy opisie pól: N pole numeryczne C pole tekstowe D data w formacie RRRR-MM-DD, gdzie RRRR rok, MM miesi c, DD dzie, (np. 2010-04-01). Je eli data nie wyst pi przyjmowana jest bie ca data p atno i. K pole zawieraj ce kwot. Kwota w formacie,gr. Separatorem groszy jest przecinek. Opis pól dost pnych w pliku schema.ini dla przelewów zwyk ych: Pole D ug Typ Opis REFERENCJE* 16 C Referencje w asne klienta RACH_OBC 34 C Numer rachunku do obci enia kwot przelewu NAZWA 140 C Pe na nazwa kontrahenta 4x35 znaków Je li w polu wyst puj znaki - traktowane s jako separatory wierszy Zamiastpola NAZWA mog wyst powa pola NAZWA1,NAZWA2,NAZWA3, NAZWA4 o d ugo i 35 znaków ka de RACHUNEK 34 C Numer rachunku kontrahenta KWOTA 12/2 K Kwota przelewu TYTUL DATA* 140 C 10 D Tytu przelewu 4x35 znaków. Je li w polu wyst puj znaki - traktowane s jako separatory wierszy. Zamiast pola TYTULmog wyst pi cztery pola TYTUL1, TYTUL2, TYTUL3, TYTUL4, ka de o d ugo i 35 znaków Data zlecenia. Pole opcjonalne, je li nie wyst pi przyjmowana jest data bie ca p atno i. *- pole nie wymagane ( jest dozwolona pusta warto ) Opis pól dost pnych w pliku schema.ini dla przelewów ZUS: Pole D ug Typ Opis REFERENCJE* 16 C Referencje w asne klienta RACH_OBC 34 C Numer rachunku do obci enia kwot przelewu RACHUNEK 34 C Numer rachunku ZUS NIP 10 N Numer identyfikacji podatkowej p atnika TYP_IDENT 1 C Typ identyfikatora uzupe niaj cego p atnika IDENT 14 C Identyfikatoruzupe niaj cy TYP 1 C Typ wp aty DEKLARACJA 6 N Deklaracja (MMRRRR) NR_DEKLARACJI 2 N Numer deklaracji NR_DECYZJI 15 C Numer decyzji/umowy/tytu u wykonawczego KWOTA 12/2 K Kwota przelewu DATA* 10 D Data zlecenia. Pole opcjonalne, je li nie wyst pi przyjmowana jest data Strona 22
bie ca p atno i. *- pole nie wymagane ( jest dozwolona pusta warto ) Opis pól dost pnych w pliku schema.ini dla przelewów US: Pole D ug Typ Opis REFERENCJE* 16 C Referencje w asne klienta RACH_OBC 34 C Numer rachunku do obci enia kwot przelewu RACHUNEK 34 C Numer rachunku organu podatkowego NAZWA 140 C Nazwa i adres organu podatkowego 4x35 znaków Je li w polu wyst puj znaki - traktowane s jako separatory wierszy Zamiastpola NAZWA mog wyst powa pola NAZWA1,NAZWA2, NAZWA3,NAZWA4 o d ugo i35znaków ka de SYMBOL 6 C Symbol formularza TYP 1 C Typ identyfikatora IDENT 14 C Identyfikator p atnika OKRES_ROK 2 C Rok OKRES_TYP 1 C Typ okresu OKRES_NUMER 4 C Numer okresu IDENT_ZOB 21 C Identyfikacjazobowi zania KWOTA 12/2 K Kwota przelewu DATA* 10 D Data zlecenia. Pole opcjonalne, je li nie wyst pi przyjmowana jest data bie ca p atno i. *- pole nie wymagane ( jest dozwolona pusta warto ) Przyk adowy opis struktury pliku dla przelewów zwyk ych wczytany ze schema.ini: [przel_lin.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=REFERENCJE Char Width 16 Col2=RACH_OBC Char Width 34 Col3=NAZWA1 Char Width 35 Col4=NAZWA2 Char Width 35 Col5=NAZWA3 Char Width 35 Col6=NAZWA4 Char Width 35 Col7=RACHUNEK Char Width 34 Col8=KWOTA Float Col9=TYTUL1 Char Width 35 Col10=TYTUL2 Char Width 35 Col11=TYTUL3 Char Width 35 Col12=TYTUL4 Char Width 35 Col13=DATA Char Width 10 Przyk adowy opis struktury pliku dla przelewów ZUS wczytany ze schema.ini: [przel_zus.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=REFERENCJE Char Width 16 Col2=RACH_OBC Char Width 34 Col3=RACHUNEK Char Width 34 Strona 23
Col4=NIP Char Width 10 Col5=TYP_IDENT Char Width 1 Col6=IDENT Char Width 14 Col7=TYP Char Width 1 Col8=DEKLARACJA Char Width 6 Col9=NR_DEKLARACJI Char Width 2 Col10=NR_DECYZJI Char Width 15 Col11=KWOTA Float Col12=DATA Char Width 10 Przyk adowy opis struktury pliku dla przelewów US wczytany ze schema.ini: [przel_us.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=REFERENCJE Char Width 16 Col2=RACH_OBC Char Width 34 Col3=RACHUNEK Char Width 34 Col4=NAZWA Char Width 140 Col5=SYMBOL Char Width 6 Col6=TYP Char Width 1 Col7=IDENT Char Width 14 Col8=OKRES_ROK Char Width 2 Col9=OKRES_TYP Char Width 1 Col10=OKRES_NUMER Char Width 4 Col11=IDENT_ZOB Char Width 20 Col12=KWOTA Float Col13=DATA Char Width 10 Uwaga:Nazwy pól w opisie struktury powinny by pisane du ymi literami. Rodzaj separatora pól rekordu okre la parametr Format. Format= Delimited (x) oznacza, e pola rekordu oddzielone s znakiem x w powy ym przyk adzie rednikiem. Format =FixedLength oznacza plik sta opozycyjny, w którym pola rekordu maj sta d ugo. W takim przypadku konieczne jest okre lenie d ugo i poszczególnych pól w opisie struktury. Parametry MaxScanRows oraz CharacterSet zosta y umieszczone w opisie struktury dla zachowania zgodno i ze standardem ODBC. Parametry te s ignorowane przez aplikacj def3000/reb i w opisie struktury mog zosta pomini te. Parametr ColNameHeader umo liwia wczytanie (warto False) lub pomini cie podczas wczytywania (warto True) pierwszego wiersza danych z importowanego pliku. Obecnie parametr ten mo e przyjmowa tylko warto False. W przypadku wpisania innej warto i dla parametru lub pomini cia go, aplikacja przyjmuje domy ln warto parametru - False. Przelew zwyk y: Referencje;97161011332003000001230002;nazwa_odb_linia1;nazwa_odb_linia2;nazwa_odb_linia3;na zwa_odb_linia4;48 8355 0009 1234 5678 9012 3456;123,45;tytul_plat_linia1;tytul_plat_linia2;tytul_plat_linia3;tytul_platn_linia4;2010-01- 02 Referencje2;97161011332003000001230002;Jan Testowy;ul.Testowa 1;80-000 Miasto;;51 1010 1023 1234 5678 90123456;55,11;zaplata za fvat 01/2013;2013-01-10 Przelew ZUS: Referencje;97161011332003000001230002;83101010230000261395100000;5540232159;1;WL1234567;S;0 12007;01;;23,80;2014-01-21; Przelew podatku: Referencje 20100324;41161000062002000001690001;34101013970010492222000000;Drugi d Skarbowy;VAT-7;2;AB1234567;09;M;08;Identyfikacja;10,24;2013-03-24 Strona 24
6.2.1.4. Plik w formacie Telekonto Plik z przelewami do importu w formacie Telekonto jest plikiem tekstowym. Pierwsza linia pliku stanowi nag wek. W nag wku okre lany jest rodzaj danych w pliku - w przypadku importu danych przelewów nale y tam umie i tekst "Zlecenia". Informacja o pojedynczym przelewie zajmuje jedn lini (jeden rekord) zako czon znakiem <CRLF>. Ka da linia pliku sk ada si z pól oddzielonych znakiem (pionowa kreska). Pola wyst puj w ustalonej kolejno i, opisanej w poni ej za czonej tabeli. Ka da linia zawiera pola wymagane (musz by wype nione), pola opcjonalne (wype nione mog by, ale nie musz ) oraz pola, które nie s wczytywane do aplikacji def3000/reb. Pojedyncza spacja (pomi dzy separatorami pól) oznacza pole puste. Brak tej spacji oznacza brak pola (pomimo wyst pienia separatorów ). Puste pola ko cowe rekordu mog zosta pomini te. Polskie znaki kodowane s w ISO 8859-2. Istnieje mo liwo importu danych z polskimi znakami kodowanymi w standardzie Mazovia. W takim przypadku strona kodowa musi zosta zadeklarowana w nag wku pliku importu w postaci Zlecenia MAZOVIA. Uwaga: Dane odbiorców przelewów wczytywanych z pliku importu musz znajdowa si w bazie odbiorców. Zestaw pól opisuj cych dane przelewu wraz z formatem danych: N pole numeryczne, C pole tekstowe, D pole data format MM/DD/YY, gdzie MM miesi c, DD dzie YY rok, K pole kwoty. Kwota w formacie.gr. Separatorem cz i u amkowej jest kropka. Nie nale y u ywa adnych innych separatorów, np. separatora tysi cy. Pole D ug Typ Opis data 8 D Data operacji kwota 12/2 K Kwota operacji rach_obc 34 C Numer rachunku obci anego rachunek 34 C Numer rachunku uznawanego tytulem1 35 C Tytu p atno i tytulem2 35 C Tytu p atno i typ przelewu** 3 C Pole pomijane przy wczytywaniu do aplikacji def3000/reb kod waluty** 3 C Pole pomijane przy wczytywaniu do aplikacji def3000/reb system rozliczeniowy** 1 C Pole pomijane przy wczytywaniu do aplikacji def3000/reb tytulem3* 35 C Tytu p atno i tytulem4* 35 C Tytu p atno i * - pole opcjonalne ** - pole pomijane przy wczytywaniu do aplikacji def3000/reb Przyk ad pliku importu przelewów w formacie Telekonto: Zlecenia 09/23/13 157.50 59 1560 0013 2005 0000 0215 0001 48 8355 0009 1234 5678 9012 3456 tytu 1 tytu 2 tytu 3 tytu 4 Strona 25
6.2.1.5. Plik w formacie VideoTel Plik z przelewami zwyk ymi Plik importu przelewów w formacie VideoTel jest plikiem tekstowym. Ka de zlecenie przelewu zajmuje jedn lini (jeden rekord) zako czon znakiem <CRLF>. Ka dy rekord jest o ony z 14 pól. Pola wyst puj w ustalonej kolejno i, opisanej w tabeli zamieszczonej poni ej. Ka de pole w rekordzie musi wyst pi. Pola tekstowe, dla których nie jest przekazywana warto, s zapisane jako pusty string "". Poszczególne pola s oddzielone jedn i tylko jedn spacj. Pola tekstowe s obj te cudzys wami. Je eli w tek ie do zaimportowania ma si znale cudzys w, nale y zast pi go dwoma cudzys wami. Znakiem podzia u linii w obr bie pola s trzy znaki zapytania. Wszystkie rachunki nadawców musz istnie w bazie danych. Polskie znaki kodowane s w standardzie ISO 8859-2 lub WINDOWS 1250. Formaty pól: N pole numeryczne, warto i jest liczba ca kowita. Zapis 10N oznacza, e pole mo e zawiera maksymalnie 10 cyfr. C pole tekstowe. Zapis 3*35C oznacza e pole mo e zawiera maksymalnie 3 linie po 35 znaków, nie wliczaj c znaków podzia u linii oraz licz c podwójne cudzys wy jako jeden znak. K pole zawieraj ce kwot. Kwota w formacie.gr. Separatorem cz i u amkowej jest kropka. Nie nale y u ywa adnych innych separatorów, np. separatora tysi cy. Struktura rekordu: Do aplikacji def3000/reb wczytywane s pola o statusie M. Pola o statusie O s pomijane przy wczytywaniu pliku do def3000/reb. Kolejn 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 p atno i przelewu 4*35C M 10 WAL3 Waluta przelewu 3C O 11 NF Nazwa firmy, do której maj by dopisane nowe rachunki beneficjenta, które zostan zaimportowane wraz z przelewami 35C O Strona 26
12 DNN Nazwa beneficjenta 3*35C M 13 WL Okre lenie rodzaju w asno i firmy NF T je li firma w asna, N je li firma obca O 14 REZ2 Nazwa systemu finansowego dla przelewu 35C O Uwagi: 1RBen zawarto pola interpretowana przez aplikacj jako nazwa odbiorcy przelewu 2REZ1 pole mo e zawiera dowoln liczb ca kowit np.1 3WAL w aplikacji przyjmowana zawsze warto PLN Przyk adowy rekord danych z pliku importu przelewów w formacie VideoTel: "" "JAN TESTOWY-ROR" "48835500091234567890123456" 0000001 206.96 "" "JANINA TEST??? UL.KROTKA 5" "86864200023001840004460001" "ZASILENIE RACHUNKU???LIPIEC 2013" "PLN" "" "JAN TESTOWY" "" "" 6.2.1.6. Plik w formacie P atnik Plik z przelewami ZUS jest zapisany w formacie tekstowym. Ka de zlecenie przelewu zajmuje jedn lini (jeden rekord) zako czon znakiem <CRLF>. Ka dy rekord jest z ony z 17 pól. Pola wyst puj w ustalonej kolejno i opisanej w cz i Struktura rekordu. Pola s oddzielone separatorem. Separatorem jest przecinek. Pola tekstowe s obj te cudzys wami. Pola tekstowe, dla których nie jest przekazywana warto, s zapisane jako pusty string. Puste pola ko cowe rekordu mog zosta pomini te. Znakiem podzia u linii w obr bie pola jest znak. Wszystkie rachunki nadawców musz istnie w bazie danych. Polskie znaki s kodowane w ISO 8859-2. Struktura rekordu: N pole numeryczne, warto i jest liczba ca kowita. D data w formacie RRRRMMDD, gdzie RRRR rok, MM miesi c, DD dzie (np. 20060501). C pole tekstowe. Rozmiar pola 2*35 oznacza e pole mo e zawiera maksymalnie 2 linie po 35 znaków, nie wliczaj c znaków podzia u linii wewn trz pola. K pole zawieraj ce kwot. Kwota wyra ona w groszach. Nie mo e zawiera adnych separatorów dla cz i u amkowej ani separatorów tysi cy. Przyk ad:150 z nale y zapisa jako 15000, 10 z 90 gr jako 1090, zapis 50 oznacza kwot 50 gr. Do def3000/reb wczytywane s pola o statusie M. Pola o statusie O s pomijane przy wczytywaniu pliku do def3000/reb. Kolejn pola w rekordzie Pole wg P atnik 1 Typ komunikatu 2 Data dokumentu Format Rozmia r Status pola Pole w def3000/reb Opis pola w def3000/ REB N 3 O - Pole pomijane przy wczytywaniu do def3000/reb D 8 M DATA Data zlecenia. Pole obowi zkowe, konieczne jest przekazanie wa nej warto i. 3 Kwota K 15 M KWOTA Kwota zlecenia. Waluta domy lnieprzyjmowana jako PLN. Pole obowi zkowe, konieczne jest przekazanie wa nej warto i. 4 Oddzia banku prowadz cego rachunek N 8 O - Pole pomijane przy wczytywaniu do def3000/reb Strona 27
p atnika sk adek 5 Oddzia banku prowadz cego rachunek ZUS 6 Rachunek p atnika sk adek N 8 M BANK Numer banku prowadz cego rachunek ZUS. Pole jest wczytywane do def3000/reb ale nie jest polem obowi zkowym,nie musi by wype nione. W polu BANK mo na przekaza warto niepust (aplikacja wczytuje warto,lecz nie sprawdza jej poprawno i ani nie prezentuje na formatkach ekranowych). Mo na równie w polu przekaza warto pust. C 34 M RACH_OBC Numer rachunku nadawcy p atnika sk adki ZUS. Pole obowi zkowe, konieczne jest przekazanie wa nej warto i. 7 Rachunek ZUS C 34 M RACHUNEK Numer rachunku ZUS dla p atno i sk adki. Pole obowi zkowe, konieczne jest przekazanie wa nej warto i. 8 Nazwa skrócona albo nazwisko i imi p atnika sk adek 9 Nazwa odpowiedniej jednostki ZUS 10 Numer oddzia u banku prowadz cego rachunek p atnika sk adek 11 Numer oddzia u prowadz cego rachunek ZUS 12 Informacje dodatkowe o sk adce dla transakcji ZUS C 2*35 M NAZWA Warto i pola powinien by tekst ZUS.Warto ta jest interpretowana jako nazwa beneficjenta zlecenia. W przypadku innej warto i w polu, aplikacja zamienia j na warto ZUS Pole obowi zkowe. C 4*35 O - Pole pomijane przy wczytywaniu do def3000/reb N 8 O - Pole pomijane przy wczytywaniu do def3000/reb N 8 O - Pole pomijane przy wczytywaniu do def3000/reb C 4*35 M TRESC1 Informacje o sk adce NIP p atnika, typ identyfikatora uzupe niaj cego i identyfikator uzupe niaj cy p atnika, typ wp aty, deklaracja i numer deklaracji, numer decyzji/umowy/ tytu uwykonawczego. Strona 28
Pole obowi zkowe, konieczne jest przekazanie wa nej warto i. 13 Numer czeku C 10 O - Pole pomijane przy wczytywaniu do def3000/reb 14 Szczeg y reklamacji 15 Kod dokumentu 16 Informacje mi dzybankow e C 4*35 O - Pole pomijane przy wczytywaniu do def3000/reb C 2 O - Pole pomijane przy wczytywaniu do def3000/reb C 16 M REFERENCJE Dodatkowy identyfikator przelewu referencje. Pole, o ile ma warto niepust, jestwczytywane do def3000/reb. Pole nie jest obowi zkowemo na przekaza warto pust. 17 Dowolny tekst C 35 O - Pole pomijane przy wczytywaniu do def3000/reb 1 Sposób wype niania pola TRESC: Pole podzielone jest na 4 linie (podpola). Ka de z podpól oddzielone znakiem podzia u linii wewn trz pola czyli symbolem. linia1 NIP p atnika (10X) linia2 wpisywane bez spacji: typ identyfikatora uzupe niaj cego (1X), identyfikator uzupe niaj cy p atnika (14X) linia3 wpisywane bez spacji: typwp aty(1x) deklaracja (RRRRMM, gdzie RRRR rok, MM miesi c) nr deklaracji (2N) linia4 numer decyzji/umowy/tytu u wykonawczego (15X) Przyk ady rekordów z pliku w formacie P atnik: 120,20060530,3000,,10101023,"32156000132005000001720001","83101010230000261395100000","ZUS","",,,"5540232159 1WL1234567 S20060501","","","51","przelewZUS","" 6.2.2. Struktury plików importu odbiorców 6.2.2.1. Plik w formacie liniowym W formacie liniowym dane odbiorców importowane s z pliku tekstowego o strukturze opisanej w pliku schema.ini. Informacja o pojedynczym kontrahencie zajmuje jedn lini (rekord) zako czon znakami <CRLF>. Ka da linia sk ada si z pól zawieraj cych dane kontrahenta. Pola wyst puj w pliku w okre lonej kolejno i, zgodnie z opisem struktury ze schema.ini. Pola oddzielone s separatorem (okre lonym w pliku schema.ini) lub s sta ej d ugo i. Dopuszczalny zestaw pól opisuj cych kontrahenta wraz z formatem danych dla ka dego pola przedstawiono w tabeli: N pole numeryczne C pole tekstowe K pole zawieraj ce kwot. Kwota w formacie,gr. Separatorem groszy jest przecinek. Strona 29
Pole D ug Typ Opis IDENT* 20 C Skrócona nazwa odbiorcy. Pole nie jest obowi zkowe, w przypadku gdy nazwa skrócona nie zostanie zdefiniowana w pliku importu podstawiane jest 20 pocz tkowych znaków z nazwy kontrahenta NAZWA 140 C Pe na nazwa odbiorcy 4x35 znaków Je li w polu wyst puj znaki - traktowane s jako separatory wierszy Zamiast pola NAZWA mog wyst powa pola NAZWA1, NAZWA2, NAZWA3, NAZWA4 o d ugo i 35 znaków ka de RACHUNEK 34 C Numer rachunku kontrahenta * - dozwolona pusta warto Poni ej przedstawiono przyk adowy opis struktury z pliku "schema.ini" definiuj cej plik z danymi odbiorców. [kontrah.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=IDENT 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 Uwaga:Nazwy pól w opisie struktury powinny by pisane du ymi literami. Rodzaj separatora pól rekordu okre la parametr Format. Format= Delimited (x) oznacza, e pola rekordu oddzielone s znakiem x w powy ym przyk adzie rednikiem. Format =FixedLength oznacza plik sta opozycyjny, w którym pola rekordu maj sta d ugo. W takim przypadku konieczne jest okre lenie d ugo i poszczególnych pól w opisie struktury. Parametry MaxScanRows oraz CharacterSet zosta y umieszczone w opisie struktury dla zachowania zgodno i ze standardem ODBC. Parametry te s ignorowane przez aplikacj def3000/reb i w opisie struktury mog zosta pomini te. Parametr ColNameHeader umo liwia wczytanie (warto False) lub pomini cie podczas wczytywania (warto True) pierwszego wiersza danych z importowanego pliku. Obecnie parametr ten mo e przyjmowa tylko warto False. W przypadku wpisania innej warto i dla parametru lub pomini cia go, aplikacja przyjmuje domy ln warto parametru False. Przyk adowa zawarto pliku z danymi odbiorców w formacie liniowym: Jan;Jan Test;ul. Testowa 1;00-001;Miasto;51101010231234567890123456; 6.2.2.2. Plik w formacie XML Dla pliku kontrahentów w formacie XML dozwolone jest stosowanie nast puj cych tagów: <?xml version="1.0" encoding="iso-8859-2"?> <kontrahenci> <kontrahent> <nazwa_kr> Nazwa krótka kontrahenta </nazwa_kr> <nazwa> </nazwa> Nazwa pe na kontrahenta Strona 30
<rachunek> </rachunek> Numer rachunku kontrahenta </kontrahent>... </kontrahenci> Ka de powtórzenie tagów<kontrahent>... </kontrahent> oznacza dane nowego kontrahenta. Uwaga: Nazwy tagów w opisie struktury powinny by pisane ma ymi literami. Kolejno poszczególnych tagów w pliku musi by zachowana. Przyk adowy plik.xml zawieraj cy dane o kontrahentach: <?xml version="1.0" encoding="iso-8859-2"?> <kontrahenci> <kontrahent> <nazwa_kr>test</nazwa_kr> D TESTOWY</nazwa> <rachunek>51101010231234567890123456</rachunek> </kontrahent> <kontrahent> <nazwa_kr>klient</nazwa_kr> <nazwa>klient TESTOWY UL. TESTOWA 11 MIASTO</nazwa> <rachunek>48835500091234567890123456</rachunek> </kontrahent> </kontrahenci> 6.2.2.3. Plik w formacie Telekonto Plik importu kontrahentów w formacie Telekonto jest plikiem tekstowym. Pierwsza linia pliku stanowi nag wek. W nag wku okre lany jest rodzaj danych w pliku - w przypadku importu danych kontrahentów nale y tam umie i tekst "Kontrahenci". Informacja o pojedynczym kontrahencie zajmuje jedn lini (jeden rekord) zako czon znakiem <CRLF>. Ka da linia pliku sk ada si z pól oddzielonych znakiem (pionowa kreska). Pola wyst puj w ustalonej kolejno i opisanej w tabeli poni ej. Ka da linia zawiera pola wymagane (musz by wype nione), pola opcjonalne (wype nione mog by, ale nie musz ) oraz pola, które nie s wczytywane do aplikacji def3000/reb. Pojedyncza spacja pomi dzy separatorami pól oznacza pole puste. Brak tej spacji oznacza brak pola (pomimo wyst powania separatorów ). Puste pola ko cowe rekordu mog zosta pomini te. Polskie znaki s kodowane w formacie ISO 8859-2. Istnieje mo liwo importu danych z polskimi znakami kodowanymi w standardzie Mazovia. W takim przypadku strona kodowa musi zosta zadeklarowana w nag wku pliku importu w postaci Kontrahenci MAZOVIA. Zestaw pól opisuj cych kontrahenta: C pole tekstowe Pole D ug Typ Opis Nazwa1 35 C Nazwa kontrahenta linia1 Nazwa2* 35 C Nazwa kontrahenta linia2 Adres1* 35 C Adres kontrahenta linia 1 Adres2* 35 C Adres kontrahenta linia2 Numer konta 34 C Numer rachunku kontrahenta Nazwa banku1** Nazwa banku2** 35 C Pole pomijane przy wczytywaniu do aplikacji def3000/reb 35 C Pole pomijane przy wczytywaniu do aplikacji def3000/reb Adres 35 C Pole pomijane przy wczytywaniu do aplikacji def3000/reb Strona 31
banku1** Adres banku2** 35 C Pole pomijane przy wczytywaniu do aplikacji def3000/reb Identyfikator * 20 C * - pole opcjonalne ** - pole pomijane przy wczytywaniu do aplikacji def3000/reb Przyk ad pliku importu kontrahentów w formacie Telekonto: Nazwa skrócona kontrahenta. Dozwolona pusta warto, podstawiane jest 20 pocz tkowych znaków z nazwy kontrahenta. Kontrahenci JAN TEST TESTOWA 1 00-123 WARSZAWA 41 8627 0001 2002 3009 0489 0001 JAN PIOTR TEST TESTOWA 2 00-123 WARSZAWA 41 8627 0001 2002 3009 0489 0001 PIOTR 6.2.3. Struktury plików eksportu statusów przelewów 6.2.3.1. Format liniowy W pliku eksportu statusów przelewów w formacie liniowym informacja o pojedynczym przelewie zajmuje jedn lini (rekord) zako czon znakami <CRLF>. Ka da linia sk ada si z pól zawieraj cych poszczególne dane przelewu. Pola wyst puj w pliku w okre lonej kolejno i, zgodnie z opisem struktury zdefiniowanym w pliku schema.ini. Pola oddzielone s separatorem (okre lonym w pliku schema.ini) lub s sta ej d ugo i. Dopuszczalny zestaw pól dla statusów przelewów wraz z formatem danych dla ka dego pola przedstawiono w poni ej tabeli: N pole numeryczne C pole tekstowe D data w formacie RRRR-MM-DD, gdzie RRRR rok, MM - miesi c, DD dzie, (np. 2010-04-01) K pole zawieraj ce kwot. Kwota w formacie.gr. Separatorem groszy jest kropka. Pole D ug Typ Opis STATUS 2 C Status przelewu BLAD 80 C Opis b du w przelewie DATA_WPISU 10 D Data ostatniej edycji przelewu ID 10 C Unikalny identyfikator przelewu w systemie RACH_OBC 34 C Numer rachunku do obci enia kwot przelewu WALUTA 3 C Waluta rachunku obci anego NAZWA1 35 C Nazwa kontrahenta cz 1 NAZWA2 35 C Nazwa kontrahenta cz 2 NAZWA3 35 C Nazwa kontrahenta cz 3 NAZWA4 35 C Nazwa kontrahenta cz 4 RACHUNEK 34 C Numer rachunku kontrahenta KWOTA 12/2 K Kwota przelewu TRESC1 35 C Tytu przelewu cz 1 TRESC2 35 C Tytu przelewu cz 2 TRESC3 35 C Tytu przelewu cz 3 TRESC4 35 C Tytu przelewu cz 4 DATA 10 D Data zlecenia Strona 32
Poni ej przedstawiono przyk adowy opis struktury definiuj cej plik z danymi o statusach przelewów: [statusy_lin.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=STATUS Char Width 2 Col2=BLAD Char Width 80 Col3=DATA_WPISU Char Width 10 Col4=ID Char Width 10 Col5=RACH_OBC Char Width 34 Col6=WALUTA Char Width 3 Col7=NAZWA1 Char Width 35 Col8=NAZWA2 Char Width 35 Col9=NAZWA3 Char Width 35 Col10=NAZWA4 Char Width 35 Col11=RACHUNEK Char Width 34 Col12=KWOTA Float Col13=TRESC1 Char Width 35 Col14=TRESC2 Char Width 35 Col15=TRESC3 Char Width 35 Col16=TRESC4 Char Width 35 Col17=DATA Char Width 10 Uwaga:Nazwy pól w opisie struktury powinny by pisane du ymi literami. Rodzaj separatora pól rekordu okre la parametr Format. Format = Delimited (x) oznacza, e pola rekordu oddzielone s znakiem x w poni ym przyk adzie rednikiem. Format = FixedLength oznacza plik sta opozycyjny, w którym pola rekordu maj sta d ugo. W takim przypadku konieczne jest okre lenie d ugo i poszczególnych pól w opisie struktury. Parametry MaxScanRows oraz CharacterSet zosta y umieszczone w opisie struktury dla zachowania zgodno i ze standardem ODBC. Parametry te s ignorowane przez aplikacj def3000/reb i w opisie struktury mog zosta pomini te. Parametr ColNameHeader mo e przyjmowa tylko warto False. W przypadku wpisania innej warto i dla parametru lub pomini cia parametru w pliku schema.ini, aplikacja przyjmuje domy ln warto parametru False. Przyk ad: ZR;;2013-11-23;3983;70161011332003000069560004;PLN;Jan Test;;;;51101010231234567890123456;0.10;faktura nr 12345;;;;2013-11-23; ZR;;2013-11- 23;3984;70161011332003000069560004;PLN;ZUS;;;;83101010230000261395100000;100.00;/ NIP/1111111111/TI/1AB1234567/TWP/A;/DKL/072006/NRD/01/DUT/2;;;2013-11-23; OD;Odrzucenie zlecenia przelewu z przyczyn technicznych;2013-11- 23;504;97161011332003000069560003;PLN;WIKTOR ;KOWALSKI ;TESTOWA 1;00-123 -03-23; 6.2.3.2. Format XML Plik wyeksportowanych statusów przelewów ma nast puj c struktur : <?xml version = '1.0' encoding = 'ISO-8859-2'?> <statusy> <przelew num= numer kolejny przelewu na > <status>status przelewu</status> <modulo>modulo klienta</modulo> <rach_obc> numer rachunku </rach_obc> <data_wpisu>data wpisu przelewu</data_wpisu> <data>data zlecenia</data> <id>identyfikator przelewu</id> Strona 33
<bank>numer banku odbiorcy</bank> <rachunek>numer rachunku odbiorcy</rachunek> <kwota>kwota przelewu</kwota> <waluta>waluta przelewu</waluta> <nazwa1>nazwa odbiorcy</nazwa1> <nazwa2>nazwa odbiorcy</nazwa2> <nazwa3>nazwa odbiorcy</nazwa3> <nazwa4>nazwa odbiorcy</nazwa4> <tresc1> przelewu</tresc1> <tresc2> przelewu</tresc2> <tresc3> przelewu</tresc3> <tresc4> przelewu</tresc4> </przelew>... </statusy> Ka de powtórzenietagów<przelew>... </przelew> jesttraktowane jakokolejny przelewzlisty. Poni ej przedstawiono przyk ad pliku eksportu statusów przelewów w formacie XML: <<?xml version="1.0" encoding="iso-8859-2"?> <statusy> <przelew num="1"> <status>zr</status> <modulo>651</modulo> <rach_obc>34156000132211000006510001</rach_obc> <data_wpisu>2013-03-28</data_wpisu> <data>2013-03-29</data> <id>2507551</id> <rachunek>55132000061234567890123456</rachunek> <kwota>10.00</kwota> <waluta>pln</waluta> <nazwa1>test</nazwa1> <nazwa2>jan</nazwa2> <nazwa3>ul. Testowa 1/1res</nazwa3> <nazwa4>00-111 Miasto</nazwa4> a testowa 1</tresc1> a testowa 2</tresc2> a testowa 3</tresc3> a testowa 4</tresc4> </przelew> <przelew num="2"> <status>od</status> <modulo>651</modulo> <rach_obc>34156000132211000006510001</rach_obc> <data_wpisu>2013-03-27</data_wpisu> <data>2013-03-27</data> <id>2507561</id> <rachunek>it60x0542811101000000123456</rachunek> <kwota>8.86</kwota> <waluta>pln</waluta> <nazwa1>nazwa 1</nazwa1> <nazwa2>nazwa 2</nazwa2> <nazwa3>ul. Trestowa 2/2</nazwa3> <nazwa4>00-222 Miasto</nazwa4> <tresc1>przelew</tresc1> <tresc2>tytul2</tresc2> <tresc3>tytul3</tresc3> <tresc4>tytul4</tresc4> </przelew> </statusy> Strona 34
6.2.4. Struktura plików eksportu operacji z historii rachunku 6.2.4.1. Format liniowy W pliku eksportu zestawienia operacji z historii rachunku w formacie liniowym informacja o pojedynczej operacji zajmuje jedn lini (rekord) zako czon znakami <CRLF>. Ka da linia sk ada si z pól zawieraj cych poszczególne dane operacji. Pola wyst puj w pliku w okre lonej kolejno i, zgodnie z opisem struktury zdefiniowanym w pliku schema.ini. Pola oddzielone s separatorem (okre lonym w pliku "schema.ini") lub s sta ej d ugo i. Dopuszczalny zestaw pól opisuj cych dane operacji wraz z formatem danych dla ka dego pola przedstawiono w poni ej tabeli. Typy danych stosowane przy opisie pól: N pole numeryczne C pole tekstowe D data w formacie RRRR-MM-DD, gdzie RRRR rok, MM miesi c, DD dzie, (np. 2010-04-01) K pole zawieraj ce kwot.kwota w formacie.gr Pole D ug Typ Opis DA TA 10 D Data waluty RO DZA J 100 C Rodzaj operacji KWO T A 12/2 K Kwota operacji ST RO NA 1 C Strona operacji:d - Debit (Winien),C - Credit (Ma) WA LUTA 3 C Waluta rachunku obci anego NA ZWA 1 35 C Nazwa kontrahenta wiersz 1 NA ZWA 2 35 C Nazwa kontrahenta wiersz 2 NA ZWA 3 35 C Nazwa kontrahenta wiersz 3 NA ZWA 4 35 C Nazwa kontrahenta wiersz 4 TRESC1 35 C Tre operacji wiersz 1 TRESC2 35 C Tre operacji wiersz 2 TRESC3 35 C Tre operacji wiersz 3 T RESC 4 35 C Tre operacji wiersz 4 Przyk adowy opis struktury dla pliku z danymi o operacjach z historii rachunku: [operacje_biez.txt] ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM Col1=DATA Char Width 10 Col2=RODZAJ Char Width 100 Col3=KWOTA Float Col4=STRONA Char Width 1 Col5=WALUTA Char Width 3 Col6=NAZWA1 Char Width 35 Col7=NAZWA2 Char Width 35 Col8=NAZWA3 Char Width 35 Col9=NAZWA4 Char Width 35 Col10=TRESC1 Char Width 35 Col11=TRESC2 Char Width 35 Col12=TRESC3 Char Width 35 Strona 35