Dokumentacja użytkownika systemu Import Eksport Danych Wersja systemu: 2.41.000 Wersja dokumentu: 2 Data wydania dokumentu: 09.10.2017 Przeznaczenie dokumentu: poufny, zewnętrzny Identyfikator dokumentu: D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb Spis treści Spis treści 4 Rozdział 1. Informacje... o dokumencie... 5 Rozdział 2. Konwencje typograficzne Rozdział 3. Wstęp... 6... 7 Rozdział 4. Formaty danych 9 Rozdział 5. Struktury... plików 5.1. Struktury... plików importu przelewów 9 5.1.1. Plik w formacie... liniowym 9 5.1.2. Plik w formacie... XL 11 5.1.3. Plik w formacie... Elixir 13 5.1.4. Plik w formacie... Płatnik 1 5.1.5. Plik w formacie... Telekonto 21 5.1.6. Plik w formacie... Videotel 22 5.2. Struktury... plików importu kontrahentów 2 5.2.1. Plik w formacie... liniowym 2 5.2.2. Plik w formacie... XL 29 5.2.3. Plik w formacie... Telekonto 30 5.2.4. Plik w formacie... VideoTel 31 5.3. Struktury... plików eksportu kontrahentów 33 5.3.1. Plik w formacie... liniowym 33 5.3.2. Plik w formacie... XL 5.4. Struktury... plików eksportu statusów przelewów 36 5.4.1. Plik w formacie... liniowym 36 5.4.2. Plik w formacie... XL 37 5.5. Struktury... plików eksportu wyciągów 3 5.5.1. Plik w formacie... liniowym 3 5.5.2. Plik w formacie... T940 40 5.5.3. Plik w formacie... T940_WIRT 43 5.5.4. Plik w formacie... T940/ulticash 46 5.5.5. Plik w formacie... XL 49 5.6. Struktury... plików eksportu operacji bieżących 50 5.6.1. Plik w formacie... liniowym 50 5.6.2. Plik w formacie... XL 51 5.7. Struktury... plików eksportu operacji na rachunkach wirtualnych 52 5.7.1. Plik w formacie... liniowym 52 5.7.2. Plik w formacie... XL 53 Strona 2 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych Strona 2
Dokumentacja użytkownika systemu def3000/eb Spis treści 5.7.3. Plik w formacie... T942 54 5.7.4. Plik w formacie... T942/ulticash 56 Strona 3 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych Strona 3
Dokumentacja użytkownika systemu def3000/eb Rozdział 1 Informacje o dokumencie Rozdział 1. Informacje o dokumencie Niniejszy dokument jest dokumentacją użytkownika systemu def3000/eb w wersji 2.41.000. Historia zmian: Data Autor Wersja systemu pis zmiany Aktualizacja opisu struktury pliku eksportu wyciągów w formacie T940 - dodanie zapisów związanych z formatem T940_WIRT. Aktualizacja opisu struktury pliku eksportu operacji na rachunkach wirtualnych w formacie T942 oraz T942/ ulticash. Aktualizacja opisu struktury pliku eksportu wyciągów w formacie T942/ulticash. Aktualizacja opisu struktury pliku importu przelewów w formacie Videotel. Aktualizacja opisu struktury pliku eksportu wyciągów w formacie T940 oraz T940_WIRT oraz opisu struktury pliku eksportu operacji na rachunkach wirtualnych w formacie T942 oraz T942/ulticash. 2011-06-10 arzena Biniecka 2.27.000 2012-04-10 arzena Biniecka 2.27.000 2012-04-13 arzena Biniecka 2.27.000 2012-05-09 arzena Biniecka 2.27.000 2012-06-11 arzena Biniecka 2.27.000 2012-09-06 arzena Biniecka 2.27.000 Uzupełnienie dokumentacji. 2014-03-2 arzena Biniecka 2.33.000 Aktualizacja dokumentacji. 2016-10-14 arzena Biniecka 2.37.000 Aktualizacja dokumentacji. 2017-01-16 arzena Biniecka 2.37.000 Uzupełnienie dokumentacji. 2017-10-09 Justyna ichnowicz 2.41.000 Uzupełnienie dokumentacji. Strona 4 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb Rozdział 2 Konwencje typograficzne Rozdział 2. Konwencje typograficzne W dokumentacji stosowane są następujące konwencje typograficzne: Konwencja typograficzna lub znak wizualny pis Standardowy zcionka alibri 10, Kolor czcionki RGB: (0, 0, 0), Justowanie tekstu, Podstawowy tekst dokumentacji Interlinia 1 wiersz Tabela zcionka alibri 9, lub 7, Kolor czcionki RGB: (0, 0, 0) lub (255, 255, 255) Tekst w tabeli Pogrubienie Nowe pojęcia. Wyróżnienie ważnych fragmentów tekstu. Pogrubienie Nazwy parametrów systemowych. Tekst - może zawierać małe i wielkie litery, cyfry oraz znaki specjalne. Kolor czcionki RGB: (0, 164, 224) Pogrubienie Kolor czcionki RGB: (0, 171, 79) Kursywa Uwaga Kolor czcionki RGB: (0, 164, 224) Nazwy uprawnień. Tekst - może zawierać małe i wielkie litery, cyfry oraz znaki specjalne. Pozycje na listach wartości. Komunikaty systemowe. Parametry lub zmienne, których rzeczywiste nazwy lub wartości mają być dostarczane przez użytkownika. Nazwy opcji systemu. Ścieżki, np. Dane archiwalne -> Przeglądanie. Tekst uwagi, komentarza, zastrzeżenia - informacje, na które należy zwrócić uwagę podczas czytania dokumentacji lub pracy z systemem np. 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. strzeżenie Kolor czcionki RGB: (255, 0, 0) Link Kolor czcionki RGB: (0, 0, 255) Kod źródłowy zcionka ourier New, 7 lub 6, Kolor czcionki RGB: (0, 0, 0), Interlinia 1 wiersz Uwaga! Zmiany przeksięgowań nie są kontrolowane przez system i wykonywane są wyłącznie na własną odpowiedzialność operatora! dwołania do innych rozdziałów lub fragmentów tekstu. Adresy URL Fragmenty kodu źródłowego. Przykłady wydruków APS LK 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. TRL+F. [] Nazwy przycisków, np. [zynności] Strona 5 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb Rozdział 3 Wstęp Rozdział 3. Wstęp Niniejszy dokument zawiera opis formatów i struktur plików wykorzystywanych w aplikacji def3000/eb do importu i eksportu danych. Strona 6 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb Rozdział 4 Formaty danych Rozdział 4. Formaty danych System def3000/eb 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: XL, Eliksir, Liniowy, Telekonto, Videotel. Format importu przelewów ZUS: XL, Płatnik/Elixir, Liniowy, Videotel. Format importu przelewów podatku: XL, Eliksir, Liniowy, Videotel. Format importu kontrahentów: XL, Liniowy, Telekonto, Videotel. Format eksportu kontrahentów: XL, Liniowy. Format eksportu statusów przelewów: XL, Liniowy. Format eksportu wyciągów: XL, Liniowy, T940, T940_WIRT T940/ulticash. Format eksportu operacji bieżących: XL, Liniowy. Format eksportu operacji na rachunkach wirtualnych: Strona 7 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb Rozdział 4 Formaty danych XL, Liniowy, T942, T942/ulticash. Strona D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb Rozdział 5. Struktury plików Pliki w formatach XL, Elixir, Płatnik, Telekonto, Videotel, T940, T940/ulticash, T942 oraz T942/ ultisah mają stałą określoną strukturę i użytkownik nie może jej zmieniać. Struktura pliku liniowego jest definiowana w pliku schema.ini i wczytywana w opcji Konfiguracja -> Parametry aplikacji -> Import struktury. Dla danych w formacie XL niedozwolone są następujące znaki: &, <, >. Jeśli w pliku XL wystąpią takie znaki będzie on traktowany jako niepoprawny. Dla powyższych znaków należy koniecznie zastosować następujące zamienniki: & - & < - < > - > 5.1. Struktury plików importu przelewów Aplikacja def3000/eb w procesie importu przelewów dopuszcza wszystkie znaki obsługiwane przez KIR w trzech formatach (azowia, IS 5-2, Windows), przyczym znaki importowane w formatach azowia i Windows automatycznie są konwertowane przez aplikację do formatu IS 5-2. W przypadku kiedy aplikacja nie jest w stanie rozpoznać kodowania (pliki mieszane) przyjmuje, iż plik jest w standardzie IS i zgodnie z tym standardem wszystkie znaki, które standardu nie spełniają zamieniane są na pytajniki. 5.1.1. 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 <RLF>. Każda linia składa się z pól zawierających dane przelewu. Pola występują w pliku w określonej kolejności, zgodnie z opisem struktury ze schema.ini. Pola oddzielone są separatorem (określonym w pliku schema.ini). Polskie znaki są kodowane w IS 59-2 Dopuszczalny zestaw pól opisujących przelew wraz z formatem danych dla każdego pola przedstawiono w poniższej tabeli: Typy danych stosowane przy opisie pól: N - pole numeryczne - pole tekstowe Pole Długość Typ DUL N KNT 25 UWAGA * 11 REFERENJE* 16 pis Pola te stanowią numer rachunku do obciążenia. Zamiast trzech pól (rachunek w formacie modulo - konto - uwaga) może występować pole rach_obc ( typu ) stanowiące numer rachunku w formacie NRB Referencje własne klienta Strona 9 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb NAZWA 140 Pełna nazwa kontrahenta 4x znaków Jeśli w polu występują znaki - traktowane są jako separatory wierszy Zamiast pola nazwa mogą występować pola nazwa1, nazwa2, nazwa3, nazwa4 o długości znaków każde Tytuł przelewu 4x znaków, dla przelewów ZUS: pierwsze znaków: NIP drugie znaków: typ identyfikatora uzupełniającego oraz identyfikator uzupełniający trzecie znaków: typ wpłaty, deklaracja i nr deklaracji czwarte znaków: numer decyzji/umowy/tytułu wykonawczego TRES 140 Dla przelewów US: Po słowie kluczowym /TI/ typ identyfikatora uzupełniającego i identyfikator uzupełniający Po słowie kluczowym /KR/ okres należności Po słowie kluczowym /SFP/ symbol formularza płatności Po słowie kluczowym /TXT/ opis zobowiązania Jeśli w polu występują znaki - traktowane są jako separatory wierszy. Zamiast pola tresc dla przelewów zwykłych mogą wystąpić cztery pola tresc1, tresc2, tresc3, tresc4, każde o długości znaków KWTA 23/2 Kwota przelewu BANK * N Numer rozliczeniowy Banku RAHUNEK 34 Numer rachunku kontrahenta DATA* 6 Data przelewu w formacie RRRRDD *- pole nie wymagane ( jest dozwolona pusta wartość ) Przykładowy opis struktury pliku przelewów wczytany ze "schema.ini": Przelew zwykły [przel_lin.txt] olnameheader=false Format=Delimited(;) axscanrows=25 haracterset=e ol1=rah_b har Width 34 ol2=referenje har Width 16 ol3=nazwa har Width 140 ol4=rahunek har Width 34 ol5=kwta Float ol6=tres1 har Width ol7=tres2 har Width ol=tres3 har Width ol9=tres4 har Width ol10=data har Width 10 Przelew ZUS/Podatku [przel_zus_us.txt] olnameheader=false Format=Delimited(;) Strona 10 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb axscanrows=25 haracterset=e ol1=rah_b har Width 34 ol2=nazwa har Width ol3=rahunek har Width 34 ol4=kwta Float ol5=tres har Width Uwaga: Nazwy pól w opisie struktury powinny być pisane dużymi literami. Rodzaj separatora pól rekordu określa parametr Format. Format= Delimited (x) oznacza, że pola rekordu oddzielone są znakiem x - w powyższym przykładzie średnikiem. Parametry axscanrows oraz haracterset zostały umieszczone w opisie struktury dla zachowania zgodności ze standardem DB. Parametry te są ignorowane przez aplikację def3000/eb i w opisie struktury mogą zostać pominięte. Parametr olnameheader umożliwia wczytanie (wartość False) lub pominięcie podczas wczytywania (wartość True) pierwszego wiersza danych z importowanego pliku. becnie parametr ten może przyjmować tylko wartość False. W przypadku wpisania innej wartości dla parametru lub pominięcia go, aplikacja przyjmuje domyślną wartość parametru - False. Przykładowa zawartość pliku importu przelewów w formacie liniowym: Przelew zwykły: 6 642 0002 3001 400 0446 0001;przelew1;Jan Test;51 1010 1023 1234 567 9012 3456;55.11;Faktura 01/2007;20070130; Przelew ZUS: 66420002300140004460001;ZUS;3101010230000261395100000;123.45;1111111111 1WL1234567 S20070101 ; 66420002300140004460001;ZUS;3101010230000261395100000;23.0;1111111111 1WL1234567 E20070101 egz200601; Przelew podatku: 66420002300140004460001;USAleksandrówKujawski;910101070024112222000000;123.45;/TI/1WL1234567/KR/06R/SFP/VAT-7/TXT/podatek; 5.1.2. Plik w formacie XL Dla pliku przelewów w formacie XL dozwolone jest stosowanie następujących tagów (tekst pisany czcionką bold): <?xml version="1.0" encoding="iso-59-2"?> <przelewy> <przelew> <rach_obc> rachunek obciążany w formacie NRB </rach_obc> <bank> numer banku odbiorcy przelewu Strona 11 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb w przypadku przelewu do ZUS numer banku ZUS (10101023) w przypadku przelewu do US numer banku US </bank> <rachunek> numer rachunku odbiorcy przelewu 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 zwykłego przelewu - treść przelewu dla przelewu do ZUS ( tekst pogrubiony jest stały): /NIP/numer nip/ti/typ identyfikatora numer identyfikatora/twp/typ wpłaty (dozwolone wartości S,, U, T, D, E, A, B)/DKL/deklaracja w formacie RRRR/NRD/numer deklaracji/dut/numer decyzji/umowy/tyt. wyk. dla przelewu do US ( tekst pogrubiony jest stały ): /TI/typ identyfikatora numer identyfikatora/kr/okres w formacie RRTXXxx, gdzie RR - rok, T - oznaczenie typu(r - rok, P- półrocze, K-kwartał, -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> <referencje>referencje własne klienta</referencje> <data> data przelewu</data> </przelew>... </przelewy> Każde powtórzenie tagów <przelew>... </przelew> jest interpretowane przez aplikację jako nowy przelew. Polskie znaki są kodowane w IS 59-2 Przykładowy plik.xml zawierający przelewy: <?xml version="1.0" encoding="iso-59-2"?> <przelewy> <przelew> <rach_obc>3 1130 0007 2001 0000 4444 0003</rach_obc> <bank>1000001</bank> <rachunek>63 100 0001 1232 1232 1154 412</rachunek> <nazwa>janina Test</nazwa> <kwota>123.10</kwota> <referencje> ZW_DR_070101_1</referencje> <tresc>faktura nr 12345</tresc> </przelew> <przelew> <rach_obc>3 1130 0007 2001 0000 4444 0003</rach_obc> <bank>1000001</bank> <rachunek>63 100 0001 1232 1232 1154 412</rachunek> <nazwa>piotr Test ul. Testowa 21</nazwa> <kwota>73.12</kwota> Strona 12 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb <referencje>zw_dr_070101_2</referencje> <tresc>opłata za wynajęcie mieszkania</tresc> <data> 2007-01-01</data> </przelew> </przelewy> Przykładowy plik.xml zawierający przelew ZUS: <?xml version="1.0" encoding="iso-59-2"?> <przelewy> <przelew> <rach_obc>79 1560 110 2006 0000 1065 0002</rach_obc> <bank>10101023</bank> <rachunek>3101010230000261395100000</rachunek> <nazwa>zus</nazwa> <kwota>100.00</kwota> <referencje> ZUS_DR_070101_1</referencje> <tresc>/nip/1111111111/ti/1ab1234567/twp/a/dkl/062005/nrd/01/dut/2</tresc> </przelew> </przelewy> Przykładowy plik.xml zawierający przelew podatku: <?xml version="1.0" encoding="iso-59-2"?> <przelewy> <przelew> <rach_obc>3 1130 0007 2001 0000 4444 0003</rach_obc> <bank>1010107</bank> <rachunek>9 1010 107 0024 1122 2200 0000</rachunek> <nazwa>urząd Skarbowy</nazwa> <kwota>123.10</kwota> <referencje> US_DR_070101_1</referencje> <tresc>/ti/n00000716 /KR/04R/SFP/VAT- /TXT/podatek</tresc> </przelew> </przelewy> 5.1.3. 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< RLF>. Każdy rekord jest złożony z 17 pól. Pola są oddzielone separatorem. Separatorem jest przecinek. Pola występują w ustalonej kolejności, opisanej w części Struktura rekordu. Pola tekstowe są objęte cudzysłowami. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string. Puste pola końcowe rekordu mogą zostać pominięte. Znakiem podziału linii w obrębie pola jest znak. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki są kodowane w IS 59-2. Struktura rekordu: Strona 13 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb Rekord danych musi mieć strukturę zgodną ze strukturą pliku przecinkowego Elixir. Typy danych stosowane przy opisie pól: N - pole numeryczne, wartością jest liczba całkowita D - data w formacie RRRRDD, gdzie RRRR - rok, - miesiąc, DD - dzień (np. 20060501). - pole tekstowe. Dozwolone znaki zgodne z wymaganiami systemu Elixir. Rozmiar pola 4* oznacza że pole może zawierać maksymalnie 4 linie po znaków, nie wliczając znaków podziału linii. K - pole zawierające kwotę. Kwota wyrażona w groszach. Nie może zawierać żadnych separatorów dla części ułamkowej ani separatorów tysięcy. Przykład: 150 zł należy zapisać jako 15000, 10 zł 90 gr jako 1090, zapis 50 oznacza kwotę 50 gr. Do systemu def3000/eb wczytywane są pola o statusie. Pola o statusie są pomijane przy wczytywaniu pliku do systemu def3000/eb. Kolejność Pole wg Elixir Format pola w rekordzie Rozmiar Status Pole w def3000/ pis pola w def3000/ pola EB EB 1 Typ komunikatu N 3-2 Data transakcji D DATA 3 Kwota 15 KWTA 4 Nr jednostki N prezentującej - 5 Nr jednostki odbierającej N - 6 Rachunek klienta nadawcy 34 RAH_B 7 Rachunek klienta adresata 34 RAHUNEK Nazwa klienta nadawcy 4* - 9 Nazwa klienta adresata 4* NAZWA 10 Numer nadawcy - K N Pole pomijane przy wczytywaniu do systemu def3000/eb Data zlecenia. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości Kwota zlecenia. Waluta domyślnie przyjmowana jako PLN. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości Pole pomijane przy wczytywaniu do systemu def3000/eb Pole pomijane przy wczytywaniu do systemu def3000/eb Numer rachunku nadawcy. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości Numer rachunku beneficjenta. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości Pole pomijane przy wczytywaniu do systemu def3000/eb Nazwa beneficjenta. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości Pole pomijane przy wczytywaniu do systemu Strona 14 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb 11 uczestnika pośredniego Numer N oddziału finalny adresat def3000/eb BANK 12 Informacje dodatkowe 4* TRES 13 Numer czeku 10-14 Szczegóły reklamacji 4* - 15 Dodatkowa identyfikacja spraw Informacje międzybankow e 34-16 REFERENJE Dowolny tekst - 16 17 Bank beneficjenta. Pole nie jest obowiązkowe, można przekazać wartość pustą Tytuł płatności przelewu. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości Pole pomijane przy wczytywaniu do systemu def3000/eb Pole pomijane przy wczytywaniu do systemu def3000/eb Pole pomijane przy wczytywaniu do systemu def3000/eb Dodatkowy identyfikator przelewu - referencje. Pole nie jest obowiązkowe- można przekazać wartość pustą Pole pomijane przy wczytywaniu do systemu def3000/eb Przykłady rekordów z pliku przelewów w formacie Elixir: 110,20060526,10,,,"32156000132005000001720001","5110101023123456790123456","", "Spółdzielnia Test Zakład Pracy Test",15600001,10101023,"Zapłata za fakturę nr 2006-01-01","","","51","ref1-2006","",20060527,2000,,,"32156000132005000001720001","450009123456790123456",""," Zakład Test Jan Test Warszawa ul. Testowa1",15600001,10101023,"Zapłata za usługę","","","51","usługa1/2006","" 110,20060527,2000,,,"32156000132005000001720001","450009123456790123456"," ","Telekomunikacja Polska SA",,50009,"Zapłata za usługę","","","","faktura vat 0605/12345","" 110,20060527,2000,,,"32156000132005000001720001","450009123456790123456"," ","Telekomunikacja Polska SA",,,"Usługa instalacyjna","","","","","",20060527,3000,,,"32156000132005000001720001","450009123456790123456",""," Telekomunikacja Polska SA",,,"Usługa instalacyjna" Plik z przelewami podatku Plik z przelewami podatku jest zapisany w formacie tekstowym. Każde zlecenie przelewu zajmuje jedną linię (jeden rekord) zakończoną znakiem <RLF>. Każdy rekord jest złożony z 17 pól. Pola występują w ustalonej kolejności opisanej w części Struktura rekordu. Pola są oddzielone separatorem. Separatorem jest przecinek. Pola tekstowe są objęte cudzysłowami. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string. Puste pola końcowe rekordu mogą zostać pominięte. Znakiem podziału linii w obrębie pola jest znak. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Strona 15 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb Polskie znaki są kodowane w formacie IS 59-2. Struktura rekordu: Rekord danych musi mieć strukturę zgodną ze strukturą pliku przecinkowego Elixir. Typy danych stosowane przy opisie pól: N - pole numeryczne, wartością jest liczba całkowita. D - data w formacie RRRRDD, gdzie RRRR - rok, - miesiąc, DD - dzień (np. 20060501). -pole tekstowe. Dozwolone znaki zgodne z wymaganiami systemu Elixir. Rozmiar pola 4* oznacza że pole może zawierać maksymalnie 4 linie po znaków, nie wliczając znaków podziału linii. K - pole zawierające kwotę. Kwota wyrażona w groszach. Nie może zawierać żadnych separatorów dla części ułamkowej ani separatorów tysięcy. Przykład: 150 zł należy zapisać jako 15000, 10 zł 90 gr jako 1090, zapis 50 oznacza kwotę 50 gr. Do systemu def3000/eb wczytywane są pola o statusie. Pola o statusie są pomijane przy wczytywaniu pliku do systemu def3000/eb. Kolejność pola w rekordzie Pole wg Elixir Format Rozmiar Status Pole w def3000/ pis pola w def3000/ pola EB EB 1 Typ N komunikatu 3-2 Data transakcji D DATA 3 Kwota K 15 KWTA 4 Nr jednostki N prezentując ej Nr jednostki N odbierającej - - 6 Rachunek klienta nadawcy 34 RAH_B 7 Rachunek klienta adresata 34 RAHUNEK Nazwa klienta nadawcy Nazwa klienta adresata 4* - 4* NAZWA 5 9 Pole pomijane przy wczytywaniu do systemu def3000/eb. Data zlecenia. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. Kwota zlecenia. Waluta domyślnie przyjmowana jako PLN. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. Pole pomijane przy wczytywaniu do systemu def3000/eb. Pole pomijane przy wczytywaniu do systemu def3000/eb. Numer rachunku nadawcy. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. Numer rachunku dla płatności podatku. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. Pole pomijane przy wczytywaniu do systemu def3000/eb Nazwa beneficjenta dla płatności podatku. Pole obowiązkowe, konieczne Strona 16 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb 10 Numer N nadawcy uczestnika pośredniego Numer N oddziału finalny adresat - BANK 12 Informacje dodatkowe 4* TRES1 13 Numer czeku 10-14 Szczegóły reklamacji 4* - 15 Dodatkowa identyfikacj a spraw Informacje międzybank owe 34-16 REFERENJE Dowolny tekst - 11 16 17 jest przekazanie ważnej wartości. Pole pomijane przy wczytywaniu do systemu def3000/eb. Bank beneficjenta dla płatności podatku. Pole nie jest obowiązkowe, można przekazać wartość pustą. Informacje o płatności podatku - typ i zawartość identyfikatora, okres za który dokonywana jest płatność, symbol formularza lub tytuł płatności, opis płatności. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. Pole pomijane przy wczytywaniu do systemu def3000/eb Pole pomijane przy wczytywaniu do systemu def3000/eb. Pole pomijane przy wczytywaniu do systemu def3000/eb. Dodatkowy identyfikator przelewu - referencje. Pole nie jest obowiązkowe- można przekazać wartość pustą. Pole pomijane przy wczytywaniu do systemu def3000/eb. 1- Sposób wypełniania pola TRES jest zgodny z zasadami obowiązującymi dla Elixir. W polu należy wprowadzić jednym ciągiem: Słowo kodowe /TI/, typ identyfikatora (1X) i zawartość identyfikatora (14X) Słowo kodowe /KR/ i okres za który dokonywana jest płatność (7X) Słowo kodowe /SFP/ i symbol formularza lub płatności (7X) Słowo kodowe /TXT/ i opcjonalnie tytuł płatności (40X) Przykłady: /TI/N1111111111/KR/0605/SFP/VAT-7/TXT/podatek vat za m-c maj 2006 /TI/1WL1234567/KR/06D0105/SFP/VAT-7/TXT/ Przykłady rekordów z pliku w formacie Elixir: Strona 17 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb 110,20060529,300,,,"32156000132005000001720001","910101070024112222000000",""," Urząd Skarbowy Aleksandrów Kujawski ",15600001,1010107,"/TI/N1111111111/ KR/06R/SFP/VAT-7/TXT/podatek za m-c maj 06","","","71","podatek maj 2006","",20060529,400,,,"32156000132005000001720001","910101070024112222000000",""," Urząd Skarbowy Aleksandrów Kujawski",15600001,1010107,"/TI/N1111111111/ KR/06R/SFP/VAT-7/TXT/","","","","podatek maj 2006","",20060529,500,,,"32156000132005000001720001","910101070024112222000000",""," Urząd Skarbowy Aleksandrów Kujawski",,,"/TI/N1111111111/KR/06R/SFP/VAT-7/ TXT/","","","","","",20060529,500,,,"32156000132005000001720001","910101070024112222000000",""," Urząd Skarbowy Aleksandrów Kujawski",,,"/TI/1WL1234567/KR/06R/SFP/VAT-7/TXT/" 5.1.4. 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 <RLF>. Każdy rekord jest złożony z 17 pól. Pola występują w ustalonej kolejności opisanej w części Struktura rekordu. Pola są oddzielone separatorem. Separatorem jest przecinek. Pola tekstowe są objęte cudzysłowami. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string. Puste pola końcowe rekordu mogą zostać pominięte. Znakiem podziału linii w obrębie pola jest znak. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki są kodowane w IS 59-2. Struktura rekordu: N - pole numeryczne, wartością jest liczba całkowita. D - data w formacie RRRRDD, gdzie RRRR - rok, - miesiąc, DD - dzień (np. 20060501). - pole tekstowe. Rozmiar pola 2* oznacza że pole może zawierać maksymalnie 2 linie po znaków, nie wliczając znaków podziału linii wewnątrz pola. K - pole zawierające kwotę. Kwota wyrażona w groszach. Nie może zawierać żadnych separatorów dla części ułamkowej ani separatorów tysięcy. Przykład: 150 zł należy zapisać jako 15000, 10 zł 90 gr jako 1090, zapis 50 oznacza kwotę 50 gr. Do systemu def3000/eb wczytywane są pola o statusie. Pola o statusie są pomijane przy wczytywaniu pliku do systemu def3000/eb. Plik z przelewami ZUS jest zapisany w formacie tekstowym. Każde zlecenie przelewu zajmuje jedną linię (jeden rekord) zakończoną znakiem <RLF>. Każdy rekord jest złożony z 17 pól. Pola występują w ustalonej kolejności opisanej w części Struktura rekordu. Pola są oddzielone separatorem. Separatorem jest przecinek. Pola tekstowe są objęte cudzysłowami. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string. Puste pola końcowe rekordu mogą zostać pominięte. Znakiem podziału linii w obrębie pola jest znak. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki są kodowane w IS 59-2. Struktura rekordu: N - pole numeryczne, wartością jest liczba całkowita. D - data w formacie RRRRDD, gdzie RRRR - rok, - miesiąc, DD - dzień (np. 20060501). Strona 1 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb - pole tekstowe. Rozmiar pola 2* oznacza że pole może zawierać maksymalnie 2 linie po znaków, nie wliczając znaków podziału linii wewnątrz pola. K - pole zawierające kwotę. Kwota wyrażona w groszach. Nie może zawierać żadnych separatorów dla części ułamkowej ani separatorów tysięcy. Przykład: 150 zł należy zapisać jako 15000, 10 zł 90 gr jako 1090, zapis 50 oznacza kwotę 50 gr. Do systemu def3000/eb wczytywane są pola o statusie. Pola o statusie są pomijane przy wczytywaniu pliku do systemu def3000/eb. Kolejność pola w rekordzie Pole wg Płatnik Format Rozmiar Status pola Pole w def3000/ EB 1 Typ komunikatu N 3-2 Data dokumentu D DATA 3 Kwota K 15 KWTA 4 ddział banku N prowadzącego rachunek płatnika składek ddział banku N prowadzącego rachunek ZUS - BANK Rachunek płatnika składek 34 RAH_B 5 6 pis pola w def3000/eb Pole pomijane przy wczytywaniu do systemu def3000/eb Data zlecenia. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości Kwota zlecenia. Waluta domyślnie przyjmowana jako PLN. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości Pole pomijane przy wczytywaniu do systemu def3000/eb Numer banku prowadzącego rachunek ZUS. Pole jest wczytywane do systemu def3000/eb ale nie jest polem obowiązkowym, nie musi być wypełnione. W polu BANK można przekazać wartość niepustą (aplikacja wczytuje wartość, lecz nie sprawdza jej poprawności ani nie prezentuje na formatkach ekranowych). ożna również w polu przekazać wartość pustą Numer rachunku nadawcy płatnika składki ZUS. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości. Strona 19 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb 7 Rachunek ZUS 9 34 RAHUNEK Nazwa skrócona albo nazwisko i imię płatnika składek 2* NAZWA Nazwa odpowiedniej jednostki ZUS Numer oddziału banku prowadzącego rachunek płatnika składek Numer oddziału prowadzącego rachunek ZUS Informacje dodatkowe o składce dla transakcji ZUS 4* - N - N - 4* TRES1 13 Numer czeku 10-14 Szczegóły reklamacji 4* - 15 Kod dokumentu 2-16 Informacje międzybankowe 16 REFERENJE 10 11 12 Numer rachunku ZUS dla płatności składki. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości Wartością pola powinien być tekst ZUS. Wartość ta jest interpretowana jako nazwa beneficjenta zlecenia. W przypadku innej wartości w polu, aplikacja zamienia ją na wartość "ZUS" Pole obowiązkowe Pole pomijane przy wczytywaniu do systemu def3000/eb Pole pomijane przy wczytywaniu do systemu def3000/eb Pole pomijane przy wczytywaniu do systemu def3000/eb Informacje o składce NIP płatnika, typ identyfikatora uzupełniającego i identyfikator uzupełniający płatnika, typ wpłaty, deklaracja i numer deklaracji, numer decyzji/umowy/ tytułu wykonawczego. Pole obowiązkowe, konieczne jest przekazanie ważnej wartości Pole pomijane przy wczytywaniu do systemu def3000/eb Pole pomijane przy wczytywaniu do systemu def3000/eb Pole pomijane przy wczytywaniu do systemu def3000/eb Dodatkowy identyfikator przelewu referencje. Pole, o ile ma wartość niepustą, jest wczytywane do systemu def3000/eb. Pole nie jest Strona 20 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb 17 Dowolny tekst - obowiązkowe- można przekazać wartość pustą Pole pomijane przy wczytywaniu do systemu def3000/eb 1 - Sposób wypełniania pola TRES: Pole podzielone jest na 4 linie (podpola). Każde z podpól oddzielone znakiem podziału linii wewnątrz pola czyli symbolem. linia1 - NIP płatnika (10X) linia2 - wpisywane bez spacji: typ identyfikatora uzupełniającego (1X), identyfikator uzupełniający płatnika (14X) linia3 - wpisywane bez spacji: typ wpłaty(1x) deklaracja (RRRR, gdzie RRRR- rok, -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","31010102300002613951 00000","ZUS","",,,"1111111111 1WL1234567 S20060501","","","51","przelewZUS","",20060530,3000,,10101023,"32156000132005000001720001","31010102300002613951000 00","ZUS","",,,"1111111111 1WL1234567 S20060501","","","51","przelewZUS","",20060530,4010,,,"32156000132005000001720001","3101010230000261395100000","ZUS ","",,,"1111111111 1WL1234567 E20060501 egz0601","","","","","",20060530,5075,,,"32156000132005000001720001","3101010230000261395100000","zus ","",,,"1111111111 1WL1234567 S20060501" 5.1.5. Plik w formacie Telekonto Plik z przelewami do importu w formacie Telekonto jest plikiem tekstowym. Pierwsza linia pliku stanowi nagłówek. W nagłówku określany jest rodzaj danych w pliku - w przypadku importu danych przelewów należy tam umieścić tekst "Zlecenia" Informacja o pojedynczym przelewie zajmuje jedną linię (jeden rekord) zakończoną znakiem <RLF>. Każda linia pliku składa się z pól oddzielonych znakiem (pionowa kreska). Pola występują w ustalonej kolejności, opisanej w poniżej załączonej tabeli. Każda linia zawiera pola wymagane (muszą być wypełnione) i pola opcjonalne ( wypełnione mogą być, ale nie muszą). 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 IS 59-2. Istnieje możliwość importu danych z polskimi znakami kodowanymi w standardzie azovia. W takim przypadku strona kodowa musi zostać zadeklarowana w nagłówku pliku importu w postaci Zlecenia AZVIA. Uwaga: Dane odbiorców przelewów wczytywanych z pliku importu muszą znajdować się w bazie odbiorców. Strona 21 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb Zestaw pól opisujących dane przelewu wraz z formatem danych: N - pole numeryczne - pole tekstowe D - pole data -format /DD/YY K - pole kwoty. Kwota w formacie Zł.GR. Separatorem części ułamkowej jest kropka. Nie należy używać żadnych innych separatorów, np. separatora tysięcy. Pole Długość Typ pis data D Data operacji kwota 15/2 K Kwota operacji rach_obc 40 Numer rachunku obciążanego rachunek 40 Numer rachunku uznawanego tytulem1 Tytuł płatności tytulem2 Tytuł płatności typ przelewu* 3 Typ przelewu kod waluty* 3 Kod waluty system 1 rozliczeniowy* Droga rozliczeniowa tytulem3* Tytuł płatnosci tytulem4* Tytuł płatności *- pola opcjonalne Przykład pliku importu przelewów w formacie Telekonto: Zlecenia 07/01/07 157.50 450009123456790123456 5110101023123456790123456 zapłata za fakturę nr 01/2006 5.1.6. 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 <RLF>. Każdy rekord jest złożony z 14 pól. Pola występują w ustalonej kolejności, opisanej w tabeli zamieszczonej poniżej. Każde pole w rekordzie musi wystąpić. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string. Poszczególne pola są oddzielone jedną i tylko jedną spacją. Pola tekstowe są objęte cudzysłowami. Jeżeli w tekście do zaimportowania ma się znaleźć cudzysłów, należy zastąpić go dwoma cudzysłowami. Znakiem podziału linii w obrębie pola są trzy znaki zapytania. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki kodowane są w standardzie IS 59-2 lub WINDWS 1250. Strona 22 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb Formaty pól: N - pole numeryczne, wartością jest liczba całkowita. Zapis 10N oznacza, że pole może zawierać maksymalnie 10 cyfr. - pole tekstowe. Zapis 3* oznacza że pole może zawierać maksymalnie 3 linie po znaków, nie wliczając znaków podziału linii oraz licząc podwójne cudzysłowy jako jeden znak. K - pole zawierające kwotę. Kwota w formacie Zł.GR. Separatorem części ułamkowej jest kropka. Nie należy używać żadnych innych separatorów, np. separatora tysięcy. Struktura rekordu: Do systemu def3000/eb wczytywane są pola o statusie. Pola o statusie są pomijane przy wczytywaniu pliku do systemu def3000/eb. Kolejność pola w rekordzie Nazwa pola pis pola Format pola Status pola 1 BBen Nazwa banku beneficjenta 2 RBen1 Nazwa rachunku beneficjenta 3* 3 NrBen Numer rachunku beneficjenta 34 4 REZ12 Klucz N 5 KW Kwota przelewu K 6 BNad Nazwa banku nadawcy 7 RNad Nazwa rachunku nadawcy NrNad Numer rachunku nadawcy 34 9 REF Tytuł płatności 4* 10 WAL3 Waluta przelewu 3 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* Strona 23 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb T jeśli firma własna, N jeśli firma obca 13 WL kreślenie rodzaju własności firmy NF 14 REZ2 Nazwa systemu finansowego dla przelewu 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 Uwaga: W zależności od stanu usługi VIDETEL_NAZWA_Z_2 nazwa kontrahenta pobierana jest z pola 12 lub z pola 2. W przypadku, gdy usługa jest wyłączona nazwa kontrahenta pobierana jest z pola 12 natomiast w przypadku włączenia usługi nazwa kontrahenta pobierana jest z pola 2. Przykładowy rekord danych z pliku importu przelewów w formacie Videotel: "" "JAN TEST-RR" "450009123456790123456" 0000001 206.96 "" "JANINA TEST???UL.TESTWA 5" "66420002300140004460001" "ZASILENIE RAHUNKU???LIPIE 2007" "PLN" "" "JAN TEST" "" "" Plik z przelewami ZUS Plik z przelewami ZUS do importu jest zapisany w formacie tekstowym. Każde zlecenie przelewu zajmuje jedną linię (jeden rekord) zakończoną znakiem RLF. Każdy rekord jest złożony z 14 pól. Pola występują w ustalonej kolejności, opisanej w części Struktura rekordu. Każde pole w rekordzie musi wystąpić. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string. Poszczególne pola są oddzielone jedną i tylko jedną spacją. Pola tekstowe są objęte cudzysłowami. Jeżeli w tekście do zaimportowania ma się znaleźć cudzysłów, należy zastąpić go dwoma cudzysłowami. Znakiem podziału linii w obrębie pola są trzy znaki zapytania. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki są kodowane w IS 59-2. Formaty pól: N - pole numeryczne, wartością jest liczba całkowita. Zapis 10N oznacza, że pole może zawierać maksymalnie 10 cyfr. X - pole tekstowe. Zapis 3*X oznacza że pole może zawierać maksymalnie 3 linie po znaków, nie wliczając znaków podziału linii oraz licząc podwójne cudzysłowy jako jeden znak. R - pole tekstowe zawierające numer rachunku w formacie NRB. K - pole zawierające kwotę. Kwota w formacie Zł.GR. Separatorem części ułamkowej jest kropka. Nie należy używać żadnych innych separatorów, np. separatora tysięcy. Struktura rekordu: Do systemu def3000/eb wczytywane są pola o statusie. Pola o statusie są pomijane przy wczytywaniu pliku do systemu def3000/eb. Kolejność pola w rekordzie Nazwa pola pis pola Format pola Status pola Strona 24 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb 1 BBen Nazwa banku beneficjenta (nazwa banku, w którym prowadzony jest rachunek ZUS) X 2 RBen Nazwa rachunku beneficjenta (nazwa rachunku ZUS) 3*X 3 NrBen Numer rachunku beneficjenta (numer rachunku ZUS) R 4 REZ11 Klucz N 5 KW Kwota przelewu K 6 BNad Nazwa banku nadawcy X 7 RNad2 Dane płatnika składki ZUS 3*34 NrNad Numer rachunku nadawcy R 9 REF3 Informacje o składce ZUS - NIP płatnika, typ i identyfikator uzupełniający, typ wpłaty, deklaracja, numer deklaracji, numer decyzji/umowy/tytułu wykonawczego 4*X 10 WAL4 Waluta przelewu 3X 11 NF Nazwa firmy, do której mają być dopisane nowe rachunki X beneficjenta, które zostaną zaimportowane wraz z przelewami 12 DNN5 Nazwa beneficjenta 3*X 13 WL kreślenie rodzaju własności firmy NF "T" jeśli firma własna, "N" jeśli firma obca 14 REZ2 Nazwa systemu finansowego dla przelewu REZ1 - pole może zawierać dowolną liczbę całkowitą np.1 RNad2 - Pole podzielone na 3 podpola, każde z podpól oddzielone znakiem podziału linii wewnątrz pola czyli symbolem "???". REF3 - Pole podzielone na 4 podpola, każde z podpól oddzielone znakiem podziału linii wewnątrz pola czyli symbolem "???". Sposób wypełniania pola zgodny z Elixir: linia1 - NIP płatnika (10X) linia2 - wpisywane bez spacji: typ identyfikatora uzupełniającego (1X), Strona 25 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb identyfikator uzupełniający płatnika (14X) linia3 - wpisywane bez spacji: typ wpłaty(1x) deklaracja (RRRR, gdzie RRRR- rok, -miesiąc) nr deklaracji (2N) linia4 - numer decyzji/umowy/tytułu wykonawczego (15X) WAL4 - w aplikacji przyjmowana zawsze wartość PLN DNN5 - pole powinno zawierać wartość "ZUS". W przypadku wprowadzenia innej wartości, aplikacja podczas wczytywania pliku zamienia ją na wartość domyślną "ZUS". Przykładowe rekordy danych: "" "" "3101010230000261395100000" 123456790 0.10 "" "JAN TEST???RZESZÓW" "32156000132005000001720001" "1111111111???1WL1234567???S20060101???" "" "" "ZUS" "" "" "" "" "3101010230000261395100000" 123456790 0.10 "" "" "32156000132005000001720001" "1111111111???1WL1234567???E20060101???egz1/234" "" "" "ZUS" "" "" Plik z przelewami podatku Plik z przelewami podatku do importu jest zapisany w formacie tekstowym. Każde zlecenie przelewu zajmuje jedną linię (jeden rekord) zakończoną znakiem RLF. Każdy rekord jest złożony z 14 pól. Pola występują w ustalonej kolejności, opisanej w części Struktura rekordu. Każde pole w rekordzie musi wystąpić. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string. Poszczególne pola są oddzielone jedną i tylko jedną spacją. Pola tekstowe są objęte cudzysłowami. Jeżeli w tekście do zaimportowania ma się znaleźć cudzysłów, należy zastąpić go dwoma cudzysłowami. Znakiem podziału linii w obrębie pola są trzy znaki zapytania. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki są kodowane w IS 59-2. Formaty pól: N - pole numeryczne, wartością jest liczba całkowita. X - pole tekstowe. Zapis 3*X oznacza że pole może zawierać maksymalnie 3 linie po znaków, nie wliczając znaków podziału linii oraz licząc podwójne cudzysłowy jako jeden znak. R - pole tekstowe zawierające numer rachunku w formacie NRB. K - pole zawierające kwotę. Kwota w formacie Zł.GR. Separatorem części ułamkowej jest kropka. Nie należy używać żadnych innych separatorów, np. separatora tysięcy. Struktura rekordu Do systemu def3000/eb wczytywane są pola o statusie. Pola o statusie są pomijane przy wczytywaniu pliku do systemu def3000/eb. Kolejność pola w rekordzie Nazwa pola pis pola Format pola Status pola Strona 26 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb 1 BBen 2 RBen 3 NrBen 4 REZ11 5 Nazwa banku beneficjenta (nazwa banku, w którym prowadzony jest rachunek dla płatności podatkowych) Nazwa rachunku beneficjenta (nazwa rachunku dla płatności podatkowych) Numer rachunku beneficjenta (numer rachunku dla płatności podatkowych) X 3*X R Klucz N KW Kwota przelewu K 6 BNad Nazwa banku nadawcy X 7 RNad2 Dane zobowiązanego 3*34X NrNad Numer rachunku nadawcy R 9 REF3 Informacje o płatności podatku typ i zawartość identyfikatora, okres za który dokonywana jest 4*X płatność, symbol formularza lub tytuł płatności, opis płatności 10 WAL4 Waluta przelewu 11 NF Nazwa firmy, do której mają być dopisane nowe rachunki X beneficjenta, które zostaną zaimportowane wraz z przelewami 12 DNN Nazwa beneficjenta 3*X 13 WL kreślenie rodzaju własności firmy NF T jeśli firma własna, N jeśli firma obca 14 REZ2 Nazwa systemu finansowego dla przelewu 3X REZ1 - pole może zawierać dowolną liczbę całkowitą np.1 Rnad2 - Pole podzielone na 3 podpola, każde z podpól oddzielone znakiem podziału linii wewnątrz pola czyli symbolem???. REF3 - Sposób wypełniania pola zgodny z Elixir. W polu należy wprowadzić jednym ciągiem: Słowo kodowe /TI/, typ identyfikatora (1X) i zawartość identyfikatora (14X) Słowo kodowe /KR/ i okres za który dokonywana jest płatność (7X) Słowo kodowe /SFP/ i symbol formularza lub płatności (7X) Słowo kodowe /TXT/ i opcjonalnie tytuł płatności (40X) Przykłady: Strona 27 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb /TI/N1111111111/KR/0605/SFP/VAT-7/TXT/podatek vat za m-c maj 2006 /TI/1WL1234567/KR/06D0105/SFP/VAT-7/TXT/ WAL4 - w aplikacji przyjmowana zawsze wartość PLN Przykładowe rekordy danych: "Rachunek Urzędu Skarbowego Aleksandrów Kujawski" "VAT" "910101070024112222000000" 123456790 100.10 "BANK TESTWY" "FIRA TEST" "436420002200100260534 0001" "/TI/N1111111111/KR/0605/SFP/VAT-7/TXT/Podatek za m-c maj 2006" "PLN" "" "Urząd Skarbowy" "" "" "" "" "910101070024112222000000" 123456790 200.50 "" "JAN TEST" "4364200022001002605340001" "/TI/1WL1234567/KR/06D0105/SFP/VAT-7/TXT/" "PLN" "" "US" "" "" "" "" "910101070024112222000000" 123456790 300.00 "" "" "4364200022001002605340001" "/TI/1WL7654321/KR/06K01/SFP/VAT-7/TXT/" "" "" "US" "" "" 5.2. Struktury plików importu kontrahentów 5.2.1. Plik w formacie liniowym W formacie liniowym dane kontrahentów importowane są z pliku tekstowego o strukturze opisanej w pliku schema.ini. Informacja o pojedynczym kontrahencie zajmuje jedną linię (rekord) zakończoną znakami <RLF>. Każda linia składa się z pól zawierających dane kontrahenta. Pola występują w pliku w określonej kolejności, zgodnie z opisem struktury ze schema.ini. Pola oddzielone są separatorem (określonym w pliku schema.ini). Polskie znaki są kodowane w IS 59-2. Dopuszczalny zestaw pól opisujących kontrahenta wraz z formatem danych dla każdego pola przedstawiono w tabeli: N - pole numeryczne - pole tekstowe Pole Długość Typ pis NAZWA_KR * 20 Skrócona nazwa kontrahenta NAZWA1 Pełna nazwa kontrahenta - linia1 NAZWA2 Pełna nazwa kontrahenta - linia2 NAZWA3 Pełna nazwa kontrahenta - linia3 NAZWA4 Pełna nazwa kontrahenta - linia4 BANK N Numer rozliczeniowy banku kontrahenta Strona 2 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb RAHUNEK 34 Numer rachunku kontrahenta KD_SWIFT 11 Kod SWIFT kontrahenta zagranicznego * - pole nie jest wymagane ( jest dozwolona pusta wartość, podstawiane jest wtedy 20 początkowych znaków z pola nazwa ) Poniżej przedstawiono przykładowy opis struktury z pliku "schema.ini" definiującej plik z danymi kontrahentów. [kontrah_lin.txt] olnameheader=false Format=Delimited(;) axscanrows=25 haracterset=e ol1=nazwa_kr har Width 20 ol2=nazwa1 har Width ol3=nazwa2 har Width ol4=nazwa3 har Width ol5=nazwa4 har Width ol6=bank Integer ol7=rahunek har Width 34 ol=kd_swift har Width 11 Uwaga: Nazwy pól w opisie struktury powinny być pisane dużymi literami. Rodzaj separatora pól rekordu określa parametr Format. Format= Delimited (x) oznacza, że pola rekordu oddzielone są znakiem x - w powyższym przykładzie średnikiem. Parametry axscanrows oraz haracterset zostały umieszczone w opisie struktury dla zachowania zgodności ze standardem DB. Parametry te są ignorowane przez aplikację def3000/eb i w opisie struktury mogą zostać pominięte. Parametr olnameheader umożliwia wczytanie (wartość False) lub pominięcie podczas wczytywania (wartość True) pierwszego wiersza danych z importowanego pliku. becnie parametr ten może przyjmować tylko wartość False. W przypadku wpisania innej wartości dla parametru lub pominięcia go, aplikacja przyjmuje domyślną wartość parametru - False. Przykładowa zawartość pliku z danymi kontrahentów w formacie liniowym: ZAGRANIZNY;Kontrahent Zagraniczny;ul. Testowa 1/1;00-001 iasto;;10101023;32500090025364010000001;deutplpwxxx; FIRA;Testowa Firma;Ul. Testowa 1;00-100 iasto;;50009;450009123456790123456;; 5.2.2. Plik w formacie XL Dla pliku kontrahentów w formacie XL dozwolone jest stosowanie następujących tagów (tekst pisany czcionką bold): <?xml version = '1.0' encoding = 'IS-59-2'?> <KNTRAHENI> <KNTRAHENT> <NAZWA_KR> Nazwa krótka kontrahenta </NAZWA_KR> Strona 29 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb <NAZWA> Nazwa pełna kontrahenta </NAZWA> <BANK> numer banku kontrahenta </BANK> <RAHUNEK> numer rachunku kontrahenta </RAHUNEK> <KD_SWIFT> kod SWIFT kontrahenta zagranicznego </KD_SWIFT> </KNTRAHENT>... </KNTRAHENI> Każde powtórzenie tagów <KNTRAHENT>... </KNTRAHENT> oznacza dane nowego kontrahenta. Przykładowy plik.xml zawierający dane o kontrahentach: <?xml version = '1.0' encoding = 'IS-59-2'?> <KNTRAHENI> <KNTRAHENT> <NAZWA_KR>ZAGRANIZNY</NAZWA_KR> <NAZWA1>Kontrahent Zagraniczny</NAZWA1> <NAZWA2>ul. Testowa 1/1</NAZWA2> <NAZWA3>00-001 iasto</nazwa3> <BANK>10101023</BANK> <RAHUNEK>32500090025364010000001</RAHUNEK> <KD_SWIFT>DEUTPLPWXXX</KD_SWIFT> </KNTRAHENT> <KNTRAHENT> <NAZWA_KR>JAN</NAZWA_KR> <NAZWA1>JAN TEST</NAZWA1> <NAZWA2>ul. Testowa 2/2</NAZWA2> <NAZWA3>00-222 iasto</nazwa3> <BANK>10101023</BANK> <RAHUNEK>5110101023123456790123456</RAHUNEK> <KD_SWIFT></KD_SWIFT> </KNTRAHENT> </KNTRAHENI> Polskie znaki są kodowane w formacie IS 59-2. 5.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ścić tekst "Kontrahenci" Informacja o pojedynczym kontrahencie zajmuje jedną linię (jeden rekord) zakończoną znakiem <RLF>. Każda linia pliku składa się z pól oddzielonych znakiem " ". Pola występują w ustalonej kolejności opisanej w tabeli poniżej. Strona 30 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych
Dokumentacja użytkownika systemu def3000/eb Każda linia zawiera pola wymagane (muszą być wypełnione) i pola opcjonalne ( wypełnione mogą być, ale nie muszą). 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 IS 59-2. Istnieje możliwość importu danych z polskimi znakami kodowanymi w standardzie azovia. W takim przypadku strona kodowa musi zostać zadeklarowana w nagłówku pliku importu w postaci Kontrahenci AZVIA. Zestaw pól opisujących kontrahenta: - pole tekstowe Pole Długość Typ pis Nazwa1 Nazwa kontrahenta -linia1 Nazwa2* Nazwa kontrahenta - linia2 Adres1* Adres kontrahenta - linia 1 Adres2* Adres kontrahenta - linia2 Numer konta 34 Numer rachunku kontrahenta Nazwa banku1* Nazwa banku kontrahenta - linia1 Nazwa banku2* Nazwa banku kontrahenta - linia2 Adres banku1* Adres banku kontrahenta - linia1 Adres banku2* Adres banku kontrahenta - linia2 Nazwa krótka* 20 Nazwa krótka Kod SWIFT Kod SWIFT 11 * - pole opcjonalne Przykład pliku importu kontrahentów w formacie Telekonto: Kontrahenci Firma Test ul.testowa 1/55 02-045 Warszawa 51 1010 1023 1234 567 9012 3456 NBP Główny ddział Walutowo-Dewiz. 00-532 Warszawa FIRA Nazwa kontrahenta1 Nazwa kontrahenta2 Nazwa kontrahenta3 Nazwa kontrahenta4 xx500090025364000000001 TEST DEUTDEFF502 5.2.4. Plik w formacie VideoTel Plik importu kontrahentów w formacie VideoTel jest plikiem tekstowym. Informacja o pojedynczym kontrahencie zajmuje jedną linię (jeden rekord) zakończoną znakiem <RLF>. Każdy rekord jest złożony z 20 pól. Pola występują w ustalonej kolejności, opisanej w tabeli zamieszczonej poniżej. Każde pole w rekordzie musi wystąpić. Pola tekstowe, dla których nie jest przekazywana wartość, są zapisane jako pusty string "". Poszczególne pola są oddzielone jedną i tylko jedną spacją. Pola tekstowe są objęte cudzysłowami. Jeżeli w tekście do zaimportowania ma się znaleźć cudzysłów, należy zastąpić go dwoma cudzysłowami. Znakiem podziału linii w obrębie pola są trzy znaki zapytania. Wszystkie rachunki nadawców muszą istnieć w bazie danych. Polskie znaki kodowane są w standardzie IS 59-2 lub WINDWS 1250. Strona 31 D.UZT_def3000_EB_2.41.000_Import_Eksport_Danych