21. Formaty plików
21.3. Struktura pliku importu przelewów w formacie XML
Aby zaimportować przelewy należy przygotować plik, w którym dane o przelewach zapisane są w formacie XML. W przypadku pliku z przelewami dozwolone jest stosowanie następujących tagów:
<?xml version="1.0" encoding="iso-8859-2"?> <przelewy> <przelew> <rach_obc>
rachunek obciążany w formacie NRB </rach_obc> <bank>
numer banku odbiorcy przelewu
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 - Zakład Ubezpieczeń Społecznych 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ściS, 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), XXxx -oznaczenie półrocza, kwartału, miesiąca lub miesiąca i dekady/SFP/symbol formularz/TXT/identyfikacja wpłaty
</tresc> </przelew>
</przelewy>
Każde powtórzenie tagów <przelew> ... </przelew> jest interpretowane przez aplikację jako nowy przelew.
Przykładowy plik .xml zawierający przelewy: <?xml version="1.0" encoding=Miso-8859-2M?>
<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 Kowalska</nazwa>
<kwota>123.10</kwota>
<tresc>faktura nr 12345</tresc> </przelew> <przelew>
Uwaga! Przy imporcie z formatu liniowego, gdy określona (zaimportowana) jest struktura z pliku
SCHEMA.INI nazwy pól w opisie struktury powinny być pisane dużymi literami.
Przykład:
Col2=NAZWA Char Width 140 Col3=BANK Integer Col4=RACHUNEK Char Width 34 21.5. Struktura pliku importu kontrahentów w formacie XML
Aby zaimportować dane o kontrahentach należy przygotować plik, w którym dane o odbiorcach zapisane są w formacie XML. W przypadku pliku z kontrahentami dozwolone jest stosowanie następujących tagów:
<?xml version="1.0" encoding="iso-8859-2"?> <kontrahenci> <kontrahent> <nazwa_kr>
Nazwa krótka kontrahenta
Każde powtórzenie tagów <kontrahent> ... </kontrahent> jest importowane jako nowy kontrahent.
Przykładowy plik .xml zawierający dane o kontrahentach: <?xml version="1.0" encoding=M iso-8859-2M?> <kontrahenci> <kontrahent>
<nazwa_kr>Jan Kowalski</nazwa_kr>
<bank>10800001 </bank>
<rachunek>45154648-12345001 -41</rachunek>
<nazwa>Jan Piotr Kowalski</nazwa>
<tresc>faktura nr 12345</tresc> </kontrahent> <kontrahent>
<nazwa_kr>Zakład Energetyczny Koluszki</nazwa_kr> <bank>10800001 </bank>
<rachunek>19876541-87654320-1212</rachunek>
<nazwa>Zakład energetyczny Koluszki Górne ulica Inna 11</nazwa>
<tresc>zapłata za energię elektryczną</tresc> </kontrahent> </kontrahenci>
21.6. Struktura pliku eksportu kontrahentów w formacie liniowym
W wyeksportowanym pliku z kontrahentami mogą występować pola wymienione w poniższej tabeli:
Lista pól będzie zgodna z listą zdefiniowaną w pliku schema.ini Przykład:
DENEB;Pracownia DENEB;10500086;31105000861000002273644241;
21.7. Struktura pliku eksportu kontrahentów w formacie XML W wyeksportowanym pliku z kontrahentami mogą występować następujące tagi:
<KONTRAHENCI> <KONTRAHENT > <NAZWA_KR>
<NAZWA1>Pracownia DENEB</NAZWA 1 > <BANK>10500086</BANK>
<RACHUNEK>31105000861000002273644241 </RACHUNEK>
</KONTRAHENT> </KONTRAHENCI>
21.8. Struktura pliku eksportu statusów przelewów w formacie liniowym
Przy eksporcie pliku ze statusami przelewów, będą w nim występować pola wymienione w poniższej tabeli:
Przelewy mogą posiadać następujące statusy:
AI - nowe,
AD - zaakceptowane, GT - gotowe,
ZK - przekazane do realizacji, WR - w realizacji,
ZR - zrealizowane, OD - odrzucone, AU - usunięte
Uwaga! Przy eksporcie do formatu liniowego, gdy określona (zaimportowana) jest struktura z pliku
SCHEMA.INI nazwy pól w opisie struktury powinny być pisane dużymi literami.
Przykład:
[statusy_lin.txt]
ColNameHeader=False Format=Delimited(;) MaxScanRows=25 CharacterSet=OEM
Col1=MODULO Integer Col2=KONTO Char Width 25 Col3=UWAGA Char Width 11 Col4=REFERENCJE Char Width 16 Col5=STATUS Char Width 2 Col6=RACHUNEK Char Width 34 Col7=KWOTA Float Col8=BANK Integer
Col9=RACHUNEK Char Width 16
21.9. Struktura pliku eksportu statusów przelewów w formacie XML Plik eksportu statusów przelewów ma następującą strukturę:
<?xml version = '1.0' encoding = 'ISO-8859-2'?> <STATUSY> <PRZELEW num="numer na liście">
<STATUS>Status przelewu</STATUS> <MODULO>modulo klienta</MODULO>
<KONTO>konto</KONTO> <UWAGA>uwaga</UWAGA> <NRB>rachunek klienta w formacie NRB</NRB> <DATA_WPISU>data wpisu przelewu</DATA_WPISU>
<DATA_ZLECENIA>data zlecenia</DATA_ZLECENIA>
<ID>identyfikator przelewu</ID> <BANK>numer banku odbiorcy</BANK>
<RACHUNEK>rachunek nadawcy</RACHUNEK> <KWOTA>kwota przelewu</KWOTA>
<WALUTA>waluta przelewu</WALUTA>
<NAZWA1>nazwa odbiorcy </NAZWA1> <TRESC1>treść przelewu</TRESC1>
<TRESC2>treść przelewu cd.</TRESC2>
</PRZELEW> </STATUSY>
Każde powtórzenie tagów <przelew> ... </przelew> jest traktowane jako kolejny przelew z listy
21.10. Struktura pliku eksportu statusów wyciągów w formacie liniowym Przy eksporcie wyciągów bankowych (operacji) w pliku występują następujące pola:
Przykład:
Col1=ID_TR_DEF Integer Col2=DATA_WALUTY Char Width 10 Col3=TRESC_D Char Width 20 Col4=BANK Integer
Col5=RACHUNEK Char Width 34 Col6=KWOTA Float
Col7=STRONA Char Width 1 Col8=WALUTA Char Width 3
Przy eksporcie do formatu MT940 (SWIFT) pola komunikatu są wypełniane w następujący sposób:
w sekcji nr 1 po znakach {1:F01 - modulo klienta
w sekcji nr 2 po znakach {2:O940 - modulo klienta w sekcji nr 4:
pole :20: - data wyciągu / modulo klienta pole :25: - modulo-konto-uwaga
pole :28: - id wyciągu / część wyciągu
pole :60F: - strona, data początkowa wyciągu, waluta, saldo początkowe wyciągu pole :61: - data waluty, strona, kwota operacji FMSCNONREF //liczba porządkowa opis operacji
pole :86: kontrahent_linia_1 kontrahent_linia_2
kontrahent_linia_1 kontrahent_linia_2 tresc_operacji_linia_1 tresc_operacji_linia_2 tresc_operacji_linia_3 tresc_operacji_linia_4
pole :62F: - strona, data końcowa wyciągu, waluta, saldo końcowe wyciągu
Jeśli w wyciągu jest więcej niż 10 operacji - zostaje podzielony na części i wtedy pojawiają się zamienne pola:
pole :60M: - strona, data początkowa część wyciągu, waluta, saldo początkowe części wyciągu pole :62M: - strona, data końcowa część wyciągu, waluta, saldo końcowe części wyciągu