Import Eksport Danych - SGB

Transkrypt

Załącznik do Przewodnika
po Usługach Bankowości Elektronicznej SGB24
Import danych w Usłudze Bankowości
Elektronicznej SGB24 dla Klientów
indywidualnych, MSP oraz osób
prowadzących jednoosobową działalność
Dokumentacj a użytkownika systemu def3000_CEB
Spis treści
Spis treści
Rozdział 1. Informacje o dokumencie ............................................................. 3
Rozdział 2. Wstęp .......................................................................................... 4
Rozdział 3. Konwencje typograficzne ............................................................. 5
Rozdział 4. Struktura i organizacja dokumentu .............................................. 6
Rozdział 5. Formaty danych i struktury plików ............................................... 7
5.1 Formaty danych ................................................................................... 7
5.2 Struktury plików .................................................................................. 8
5.3 Struktury plików importu odbiorców .......................................................26
Plik w formacie liniowym.................................................................................................... 26
Plik w formacie XML ........................................................................................................ 27
Plik w formacie Telekonto .................................................................................................. 27
Strona 2
Rozdział 2 Wstęp
Rozdział 1. Informacje o dokumencie
Niniejszy dokument jest
w zakresie importu danych.
dokumentacją
użytkownika
systemu
Bankowości
Elektronicznej
SGB24
Strona 3
Rozdział 2 Wstęp
Rozdział 2. Wstęp
Dokument dotyczy funkcjonalności systemu w zakresie importu danych. Opisuje dostępne opcje
w systemie oraz sposób ich wykorzystania. Zawiera także opis formatów danych, jak i struktury importowanych
oraz plików.
Strona 4
Rozdział 3
Konwencje typograf iczne
Rozdział 3. Konwencje typograficzne
W dokumentacji stosowane są następujące konwencje typograficzne:
Konwencja typograficzna lub znak wizualny
Opis
Standardowy
Czcionka Calibri 10, Kolor czcionki RGB: (0, 0, 0), Justowanie tekstu,
Interlinia 1 wiersz
Podstawowy tekst dokumentacji
Tabela
Czcionka Calibri 9, 8 lub 7, Kolor czcionki RGB: (0, 0, 0) lub (255, 255, Tekst w tabeli
255)
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
Kursywa
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
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
Link
Uwaga! Zmiany przeksięgowań nie są kontrolowane
przez system i wykonywane są wyłącznie na własną
odpowiedzialność operatora!
Odwołania do innych rozdziałów lub fragmentów tekstu. Adresy
URL
Kod źródłowy
Czcionka Courier New 8, 7 lub 6, Kolor czcionki RGB: (0, 0, 0),
Interlinia 1 wiersz
Fragmenty kodu źródłowego. Przykłady wydruków
CAPS LOCK
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ści]
Strona 5
Rozdział 4 Struktura i organizacja dokumentu
Rozdział 4. Struktura i organizacja dokumentu
Dokumentacja
zawiera
w
kolejnych
punktach
opis
funkcji
importu
danych,
sposobu
ich wykorzystywania i parametryzacji oraz dostępne formaty i struktury plików.
Dokument można czytać w naturalnej kolejności bądź sięgać do opisu odpowiedniej funkcji w zależności od
potrzeb.
Strona 6
Rozdział 6 Formaty danych i struktury plików
Rozdział 5. Formaty danych i struktury plików
5.1 Formaty danych
System def3000/CBP pozwala na import danych w różnych stałych oraz definiowanych formatach
plików. Poniżej przedstawione są dostępne formaty danych przeznaczone dla importu 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 odbiorców:
XML,
Liniowy,
Telekont
o.
Formaty plików XML, Eliksir, Płatnik, Videotel, Telekonto 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:
‘&’ - &
Strona 7
5.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.
Struktury plików importu przelewów zwykłych, ZUS,podatku oraz
SEPA
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>
<REFERENCJE>referencje własne klienta</REFERENCJE>
<RACH_OBC>rachunek obciążany 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>treść przelewu</TRESC>
<DATA>data przelewu</DATA>
</PRZELEW>
...
</PRZELEWY>
Każde powtórzenie tagów <PRZELEW> ... </PRZELEW> jest interpretowane przez aplikację jako nowy przelew.
Przykładowy plik .xml zawierający przelewy:
<przelewy>
<przelew>
<referencje>ReferencjeZwykły1</referencje>
<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>
<data>2016-12-17</data>
</przelew>
<przelew>
<referencje>ReferencjeZwykły2</referencje>
<rach_obc>38 1130 0007 2001 0000 4444 0003</rach_obc>
<bank>10800001</bank>
<nazwa>Piotr Testowy ul. Nowa 21</nazwa>
<tresc>opłata za wynajęcie mieszkania</tresc>
<data>2016-12-18</data>
</przelew>
</przelewy>
Strona 8
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):
<PRZELEWY>
<PRZELEW>
<REFERENCJE>referencje własne klienta</REFERENCJE>
<RACH_OBC>rachunek obciążany w formacie NRB</RACH_OBC>
<BANK>
w przypadku przelewu do ZUS numer banku ZUS
w przypadku przelewu do US numer banku US
</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ści S, M, U, T,
D, E, A, B)/DKL/deklaracja w formacie MMRRRR/NRD/numer deklaracji/DUT/numer decyzji/umowy/tyt. wyk.
dla przelewu do US (tekst pogrubiony jest stały):
/TI/typ identyfikatora numer identyfikatora/OKR/okres w formacie RRTXXxx, gdzie RR – rok, T – oznaczenie
typu(R – rok, P – półrocze, K – kwartał, M-miesiąc, D – dekada, J – dzień), XXxx – oznaczenie półrocza,
kwartału, miesiąca, miesiąca i dekady lub miesiąca i dnia/SFP/symbol formularza/TXT/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 przelew ZUS:
<?xml version="1.0" encoding="iso-8859-2" ?>
<przelewy>
<przelew>
<referencje>ReferencjeZUS</referencje>
<rach_obc>98161000192002000103660001</rach_obc>
<bank>10101023</bank>
<rachunek>83101010230000261395100000</rachunek>
<nazwa>ZUS</nazwa>
<tresc>/NIP/1111111111/TI/1AB1234567/TWP/A/DKL/062009/NRD/01/DUT/2</tresc >
</przelew>
</przelewy>
Strona 9
Przykładowy plik .xml zawierający przelew podatku:
<przelewy>
<przelew>
<referencje>ReferencjeUS</referencje>
<rach_obc>38 1130 0007 2001 0000 4444 0003</rach_obc>
<bank>10800001</bank>
<nazwa>Urząd Skarbowy</nazwa>
<tresc>/TI/N8000007816|/OKR/04R/SFP/VAT-8|/TXT/podatek</tresc>
</przelew>
</przelewy>
Przelewy SEPA
Do weryfikacji struktury pliku importu przelewów SEPA w formacie ISO20022 wykorzystywany jest plik XSD w wersji
pain.001.001.03.
W pliku XSD interpretowane są poniższe pola z normy ISO20022:
Nazwa pola w
systemie def3000/CEB
Długość
pola w
xsd
Długoś
ć pola
w CEB
Wymaga
ny/Opcj
onalny
-
3
-
W
-
Osoba do kontaktu
Telefon kontaktowy
Informacje dodatkowe
Kod identyfikacyjny
zleceniodawcy
4
140
35
-
35
20
140
32
Status
W
W
O
Nazwa
elementu
XML
+PmtInf
++PmtMtd
+PmtInf
++CdtTrfTxInf
+++PmtTpInf
++++SvcLvl
+++++Cd
+PmtInf
++CdtTrfTxInf
+++InstrForDb
trAgt
+GrpHdr
++InitgPty
Uwagi
Metoda płatności
Wymagane podanie wartości TRF
Możliwe komunikaty błędów:
- „Brak lub niepoprawna wartość w polu
PmtInf.PmtMtd”
Kod typu płatności
Wymagane podanie wartości SEPA
- „Brak lub niepoprawna wartość w polu Typ
płatności
(PmtInf.CdtTrfTxInf.PmtTpInf.SvcLvl.Cd)”
Dane osoby do kontaktu podane w formie:
‘[..]CONTACT_TELECOM="osoba
do
kontaktu";"telefon lub email";”Informacje
dodatkowe”’
System odczyta dane poszukując treści
CONTACT_TELECOM=”
Dane do kolejnego wystąpienia tekstu ”;”
przypisane będą jako ‘Osoba do kontaktu’
Kolejne dane do wystąpienia tekstu ”;”
przypisane będą jako ‘Telefon kontaktowy’.
Kolejne dane do wystąpienia tekstu ”
przypisane
będą
jako
‘Informacje
dodatkowe’
PmtInf.CdtTrfTxInf.InstrForDbtrAgt”
- „Niepoprawne znaki w polu
PmtInf.CdtTrfTxInf.InstrForDbtrAgt”
- „Niepoprawne znaki w polu Kod
Strona 10
Rachunek
obciążenia
Referencje
użytkownika
do
własne
Kwota przelewu
Prowizje i koszty
Nazwa beneficjenta
35
18
4
wybór
z listy
W
16
O
15
-
140
W
W
70
+PmtInf
++CdtTrfTxInf
+++Amt
++++InstdAmt
+PmtInf
++ChrgBr
W
+PmtInf
++CdtTrfTxInf
+++Cdtr
++++Nm
O
+PmtInf
++CdtTrfTxInf
+++Cdtr
+++PstlAdr
++++AdrLine
+PmtInf
++CdtTrfTxInf
+++Cdtr
+++PstlAdr
++++Ctry
35
35
Adres beneficjenta
+++Id
++++PrvtId
+++++Othr
++++++Id
+PmtInf
++DbtrAcct
+++Id
++++Othr
+++++Id
+PmtInf
++CdtTrfTxInf
+++PmtId
++++EndToEn
dId
35
35
Kraj beneficjenta
2
Wybie
rany z
listy
W
Numer
rachunku
beneficjenta
34
34
W
+PmtInf
++CdtTrfTxInf
+++CdtrAcct
++++Id
identyfikacyjny
zleceniodawcy
(GrpHdr.InitgPty.Id.PrvtId.Othr.Id)”
Rachunek do obciążenia
(PmtInf.DbtrAcct.Id.Othr.Id)”
Wg standardu jest to pole obowiązkowe.
Jeżeli ma pozostać puste to powinno być
uzupełnione wartością 'NOT PROVIDED'.
def3000/CEB akceptuje pustą wartość tego
pola.
- „Niepoprawne znaki w polu Referencje
własne użytkownika
(PmtInf.CdtTrfTxInf.PmtId.EndToEndId)”
Wymagane jest podanie waluty przelewu
(EUR).
<InstdAmt Ccy="EUR">10.00</InstdAmt>
def3000/CEB CEB akceptuje max 2 miejsca
po przecinku
Kwota przelewu
(PmtInf.CdtTrfTxInf.Amt.InstdAmt)”
Wymagane jest podanie wartości ‘SLEV’.
Prowizje i koszty (PmtInf.ChrgBr)”
- „Brak pola Nazwa beneficjenta
(PmtInf.CdtTrfTxInf.Cdtr.Nm)”
- „Niepoprawne znaki w polu Nazwa
beneficjenta (PmtInf.CdtTrfTxInf.Cdtr.Nm)”
- „Niepoprawne znaki w polu Adres
beneficjenta
(PmtInf.CdtTrfTxInf.Cdtr.PstlAdr.AdrLine)”
Kod kraju beneficjenta.
Kraj beneficjenta
(PmtInf.CdtTrfTxInf.Cdtr.PstlAdrCtry)” (w
przypadku nie spełnienia przez to pole
maski ”[A-Z]{2,2} ")
Nr w formacie IBAN.
- „Brak lub niepoprawna wartość w polu nr
rachunku beneficjenta
Strona 11
Szczegóły płatności
140
35
35
35
35
W
Rachunek do pobrania
kosztów
34
wybór
z listy
W
+++++Othr
++++++Id
+PmtInf
++CdtTrfTxInf
+++RmtInf
++++Ustrd
+PmtInf
++ChrgsAcct
++++Id
+++++Othr
++++++Id
(PmtInf.CdtTrfTxInf.CdtrAcct.Id.Othr.Id)”
- „Brak pola Szczegóły płatności
(PmtInf.CdtTrfTxInf.RmtInf.Ustrd)”
- „Niepoprawne znaki w polu Szczegóły
płatności (PmtInf.CdtTrfTxInf.RmtInf.Ustrd)”
Rachunek
do
pobrania
kosztów
(PmtInf.ChrgsAcct.Id.Othr.Id)”
Przykładowy plik .xml zawierający przelewy SEPA:
<?xml version="1.0" encoding="utf-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.03"
xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance">
<CstmrCdtTrfInitn>
<GrpHdr>
<MsgId>?</MsgId>
<CreDtTm>2000-01-01T00:00:00</CreDtTm>
<NbOfTxs>1</NbOfTxs>
<InitgPty>
<Id>
<PrvtId>
<Othr>
<Id>Kod identyfikacyjny zleceniodawcy</Id>
</Othr>
</PrvtId>
</Id>
</InitgPty>
</GrpHdr>
<PmtInf>
<PmtInfId>?</PmtInfId>
<PmtMtd>TRF</PmtMtd>
<ReqdExctnDt>2000-01-01</ReqdExctnDt>
<Dbtr>
</Dbtr>
<DbtrAcct>
<Id>
<Othr>
<Id>83101010230000261395100000</Id>
</Othr>
</Id>
</DbtrAcct>
<DbtrAgt>
<FinInstnId>
</FinInstnId>
</DbtrAgt>
<ChrgBr>SLEV</ChrgBr>
<ChrgsAcct>
<Id>
Strona 12
<Othr>
<Id>83101010230000261395100000</Id>
</Othr>
</Id>
</ChrgsAcct>
<CdtTrfTxInf>
<PmtId>
<EndToEndId>realizacja01 </EndToEndId>
</PmtId>
<PmtTpInf>
<SvcLvl>
<Cd>SEPA</Cd>
</SvcLvl>
</PmtTpInf>
<Amt>
<InstdAmt Ccy="EUR">1.99</InstdAmt>
</Amt>
<Cdtr>
<Nm>Nazwa beneficjenta</Nm>
<PstlAdr>
<Ctry>XX</Ctry>
<AdrLine>Adres beneficjenta</AdrLine>
</PstlAdr>
</Cdtr>
<CdtrAcct>
<Id>
<Othr>
<Id>NRB beneficjenta</Id>
</Othr>
</Id>
</CdtrAcct>
<InstrForDbtrAgt>CONTACT_TELECOM="osoba do kontaktu";"telefon
lub email";"Informacje dodatkowe"</InstrForDbtrAgt>
<RmtInf>
<Ustrd>Szczegoly platnosci</Ustrd>
</RmtInf>
</CdtTrfTxInf>
</PmtInf>
</CstmrCdtTrfInitn>
</Document>
Każde powtórzenie tagów < PmtInf> ... </ PmtInf > jest interpretowane przez aplikację jako nowy przelew.
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ł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 ISO 8859-2.
Strona 13
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 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ęś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 def3000/CEB wczytywane są pola o statusie M. Pola o statusie O są pomijane przy wczytywaniu pliku do
def3000/CEB.
Kolejność
Status
Pole
Opis pola
pola w
Pole wg Elixir Format Rozmiar
pola w def3000/CEB
w def3000/CEB
rekordzie
1
Typ komunikatu N
3
O
Pole pomijane przy
wczytywaniu
do def3000/CEB
2
Data transakcji
D
8
M
DATA
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ącej
N
8
O
-
Pole pomijane przy
wczytywaniu do def3000/CEB
5
Nr jednostki
odbierającej
N
8
O
-
Pole pomijane przy
6
Rachunek
klienta nadawcy
C
34
M
RACH_OBC
Numer rachunku nadawcy.
Pole obowiązkowe, konieczne
jest przekazanie ważnej
wartości.
7
Rachunek
klienta adresata
C
34
M
RACHUNEK
Numer rachunku
beneficjenta. Pole
8
Nazwa klienta
nadawcy
C
4*35
O
-
Pole pomijane przy
9
Nazwa klienta
adresata
C
4*35
M
NAZWA
Nazwa beneficjenta. Pole
10
Numer nadawcy N
uczestnika
pośredniego
Numer oddziału N
– finalny adresat
8
O
-
Pole pomijane przy
8
M
BANK
Bank beneficjenta. Pole nie
jest obowiązkowe, można
przekazać wartość pustą.
12
Informacje
dodatkowe
C
4*35
M
TRESC
Tytuł płatności przelewu. Pole
13
Numer czeku
C
10
O
-
Pole pomijane przy
14
Szczegóły
reklamacji
C
4*35
O
-
Pole pomijane przy
11
Strona 14
15
16
17
Dodatkowa
identyfikacja
spraw
Informacje
międzybankowe
C
34
O
-
Pole pomijane przy
C
16
M
REFERENCJE
Dodatkowy identyfikator
przelewu – referencje. Pole
nie jest obowiązkowe- można
Dowolny tekst
C
35
O
-
Pole pomijane przy
Przykłady rekordów z pliku przelewów w formacie Elixir:
110,20060526,10,,,"32156000132005000001720001","511 01010231234567890123456","","Spódzielni
a Pracy Testowa|Zakład Pracy Chronionej",15600001,10101023,"Zapłata za fakturę| nr 2006-0101","","","51","ref1-2006",""
,20060527,2000,,,"32156000132005000001720001","48835500091234567890123456","","Zakła d
Testowy| Jan
Kowalski
Test|
Warszawa ul. D1",15600001,10101023,"Zapłata
za
usługę","","","51","usługa1/2006",""
110,20060527,2000,,,"32156000132005000001720001","48835500091234567890123456","","Telekomun
ikacja Polska",,83550009,"Zapłata za usługę","","","","Faktura vat 0605/12345",""
110,20060527,2000,,,"32156000132005000001720001","48835500091234567890123456","","Telekomun
ikacja Polska",,,"Usługa instalacyjna","","","","",""
,20060527,3000,,,"32156000132005000001720001","48835500091234567890123456","","Telekomun ika
cja Polska",,,"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 <CRLF>.
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 formacie ISO 8859-2.
Struktura rekordu:
Rekord danych musi mieć strukturę zgodną ze strukturą pliku przecinkowego Elixir.
N – pole numeryczne, wartością jest liczba całkowita.
D – data w formacie RRRRMMDD, gdzie RRRR - rok, MM - miesiąc, DD – dzień (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.
Przykład: 150 zł należy zapisać jako 15000, 10 zł 90 gr jako 1090, zapis 50 oznacza kwotę 50 gr.
def3000/CEB.
Kolejność
pola w
rekordzie
Pole wg Elixir
Format Rozmiar
Status
Pole
pola w def3000/CEB
Opis pola
w def3000/CEB
1
Typ komunikatu
N
3
O
-
Pole pomijane przy
2
Data transakcji
D
8
M
DATA
Data zlecenia. Pole
3
Kwota
K
15
M
KWOTA
domyślnie przyjmowana
jako PLN. Pole obowiązkowe,
ważnej wartości.
Strona 15
4
Nr jednostki
prezentującej
N
8
O
-
Pole pomijane przy wczytywaniu
do def3000/CEB
5
Nr jednostki
odbierającej
N
8
O
-
do def3000/CEB
6
Rachunek
klienta nadawcy
C
34
M
RACH_OBC
Numer rachunku nadawcy. Pole
7
Rachunek
klienta adresata
C
34
M
RACHUNEK
Numer rachunku dla płatności
podatku. Pole obowiązkowe,
ważnej wartości.
8
Nazwa klienta
nadawcy
C
4*35
O
-
do def3000/CEB
9
Nazwa klienta
adresata
C
4*35
M
NAZWA
Nazwa beneficjenta dla
płatności podatku. Pole
10
Numer
nadawcy
uczestnika
pośredniego
N
8
O
-
do def3000/CEB
11
Numer oddziału
– finalny
adresat
N
8
M
BANK
Bank beneficjenta dla płatności
podatku. Pole nie jest
obowiązkowe, można przekazać
wartość pustą.
12
Informacje
dodatkowe
C
4*35
M
TRESC1
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
13
Numer czeku
C
10
O
-
do def3000/CEB
14
Szczegóły
reklamacji
C
4*35
O
-
Pole pomijane przy
wczytywaniu
do def3000/CEB
15
Dodatkowa
identyfikacja
spraw
C
34
O
-
Pole pomijane przy
wczytywaniu
do def3000/CEB
16
Informacje
międzybankowe
C
16
M
REFERENCJE
Dodatkowy identyfikator
przelewu – referencje. Pole nie
jest obowiązkowe- można
17
Dowolny tekst
C
35
O
-
Pole pomijane przy
wczytywaniu
do def3000/CEB
1 – Sposób wypełniania pola TRESC 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 /OKR/ i okres za który dokonywana jest płatność (7X)
Słowo kodowe /SFP/ i symbol formularza lub płatności (7X)
Słowo kodowe /TXT/ i opcjonalnie tytuł płatności (40X)
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/
Strona 16
Przykłady rekordów z pliku w formacie Elixir:
110,20060529,300,,,"32156000132005000001720001","98101010780024112222000000","", "Urzą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","", "
Urząd
Skarbowy|Aleksandrów
Kujawski",15600001,10101078,"/TI/N1111111111/OKR/06R/SFP/VAT-7/
TXT/","","","","podatek maj 2006",""
,20060529,500,,,"32156000132005000001720001","98101010780024112222000000","", "
Urząd
Kujawski",,,"/TI/N1111111111/OKR/06R/SFP/VAT-7/TXT/","","","","",""
,20060529,500,,,"32156000132005000001720001","9810101078002411222 2000000","","
Urząd
Kujawski",,,"/TI/1WL1234567/OKR/06R/SFP/VAT-7/TXT/"
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ści,
zgodnie z opisem struktury ze schema.ini. Pola oddzielone są separatorem (określonym w pliku schema.ini) lub
są stałej długości.
Dopuszczalny zestaw pól opisujących przelew wraz z formatem danych dla każdego pola przedstawiono
w poniższej 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). Jeżeli data
nie wystąpi przyjmowana jest bieżąca data płatności.
K – pole zawierające kwotę. Kwota w formacie Zł,GR. Separatorem groszy jest przecinek.
Opis pól dostępnych w pliku schema.ini dla przelewów zwykłych:
Pole
Długość
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
Zamiast pola NAZWA mogą występować pola NAZWA1, NAZWA2,
NAZWA3, NAZWA4 o długości 35 znaków każde
RACHUNEK
34
C
Numer rachunku kontrahenta
KWOTA
12/2
K
Kwota przelewu
TYTUL
140
C
Tytuł przelewu 4x35 znaków.
Jeśli w polu występują znaki | - traktowane są jako separatory wierszy.
Zamiast pola TYTUL mogą wystąpić cztery pola TYTUL1, TYTUL2,
TYTUL3, TTYTUL4, każde o długości 35 znaków
DATA*
10
D
Data zlecenia. Pole opcjonalne, jeśli nie wystąpi przyjmowana jest
data bieżąca płatności.
*- pole nie wymagane ( jest dozwolona pusta wartość )
Opis pól dostępnych w pliku schema.ini dla przelewów ZUS:
Pole
Długość
Typ
Opis
REFERENCJE*
16
C
RACH_OBC
34
C
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
Strona 17
IDENT
14
C
Identyfikator uzupeł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
bieżąca płatności.
Opis pól dostępnych w pliku schema.ini dla przelewów US:
Pole
Długość
Typ
Opis
REFERENCJE*
16
C
RACH_OBC
34
C
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 Zamiast pola NAZWA mogą występować pola NAZWA1,
NAZWA2, NAZWA3, NAZWA4 o długości 35 znakó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
Identyfikacja zobowią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ści.
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
Col7=RACHUNEK Char Width 34
Col8=KWOTA Float
Col9=TYTUL1 Char Width 35
Col13=DATA Char Width 10
Przykładowy opis struktury pliku dla przelewów ZUS wczytany ze schema.ini:
Strona 18
[przel_ZUS.txt]
ColNameHeader=False
Format=Delimited(;)
MaxScanRows=25
CharacterSet=OEM
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
Przykładowy opis struktury pliku dla przelewów US wczytany ze schema.ini:
[przel_US.txt]
ColNameHeader=False
Format=Delimited(;)
MaxScanRows=25
CharacterSet=OEM
Col4=NAZWA Char Width 140
Col5=SYMBOL Char Width 6
Col6=TYP Char Width 1
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
Strona 19
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.
Format =FixedLength oznacza plik stałopozycyjny, w którym pola rekordu mają stałą długość. W takim
przypadku konieczne jest określenie długości poszczególnych pól w opisie struktury.
Parametry MaxScanRows oraz CharacterSet zostały umieszczone w opisie struktury dla zachowania
zgodności ze standardem ODBC. Parametry te są ignorowane przez aplikację def3000/CEB 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ści 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;201001-02
Referencje2;97161011332003000001230002;Jan Testowy;ul.Bydgoska 1;80-000 Bydgoszcz;;51 1010
1023 1234 5678 90123456;55,11;zaplata za fVAT 01/2007;2010-01-10
Przelew ZUS:
Referencje;97161011332003000001230002;83101010230000261395100000;5540232159;1;WL1234567;S;0
12007;01;;23,80;2010-03-24;
Przelew podatku:
Referencje 20100324;41161000062002000001690001;34101013970010492222000000;Drug i Urząd
Skarbowy;VAT-7;2;AB1234567;09;M;08;Identyfikacja;10,24;2010-03-24
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 <CRLF>.
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), pola opcjonalne (wypełnione mogą być, ale nie
muszą) oraz pola, które nie są wczytywane do aplikacji def3000/CEB.
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 Zł.GR. Separatorem części ułamkowej jest kropka. Nie należy używać
żadnych innych separatorów, np. separatora tysięcy.
Strona 20
Pole
Długość
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ści
tytulem2
35
C
Tytuł płatności
typ przelewu**
3
C
Pole pomijane przy wczytywaniu do
aplikacji def3000/CEB
kod waluty**
3
C
system
rozliczeniowy**
1
C
tytulem3*
35
C
Tytuł płatności
tytulem4*
35
C
Tytuł płatności
* - pole opcjonalne
** - pole pomijane przy wczytywaniu do aplikacji def3000/CEB
Przykład pliku importu przelewów w formacie Telekonto:
Zlecenia
07/01/09|157.50|59 1560 0013 2005 0000 0215 0001|48 8355 0009 1234 5678 9012 3456|tytuł 1|
tytuł 2||||tytuł 3|tytuł 4
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 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 ISO 8859-2 lub WINDOWS 1250.
Formaty pól:
N – pole numeryczne, wartością 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ł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 aplikacji def3000/CEB wczytywane są pola o statusie M. Pola o statusie O są pomijane przy wczytywaniu pliku
do def3000/CEB.
Kolej ność
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
Strona 21
3
NrBen
4
REZ12
5
Numer rachunku beneficjenta
34C
M
Klucz
N
O
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ści przelewu
4*35C
M
10
WAL3
Waluta przelewu
C
O
11
NF
Nazwa firmy, do której mają być
dopisane nowe rachunki beneficjenta,
które zostaną zaimportowane wraz z
przelewami
35C
O
12
DNN
Nazwa beneficjenta
3*35C
M
13
WL
Określenie rodzaju własności 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 2009" "PLN" "" "JAN
TESTOWY" "" ""
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ł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 ISO 8859-2.
Struktura rekordu:
N – pole numeryczne, wartością 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.
Przykład:
150 zł należy zapisać jako 15000, 10 zł 90 gr jako 1090, zapis 50 oznacza kwotę 50 gr.
def3000/CEB.
Strona 22
Kolejność
pola w
rekordzie
1
Format
Rozmiar
Status
pola
Typ komunikatu
N
3
O
-
2
Data
dokumentu
D
8
M
DATA
3
Kwota
K
15
M
KWOTA
4
Oddział banku
prowadzącego
rachunek
płatnika składek
Oddział banku
prowadzącego
rachunek ZUS
N
8
O
-
N
8
M
BANK
Numer banku
prowadzącego rachunek
ZUS. Pole jest
wczytywane do
def3000/CEB 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). Można
również w polu
przekazać wartość
pustą.
6
Rachunek
płatnika
składek
C
34
M
RACH_OBC
Numer rachunku
nadawcy – płatnika
składki ZUS. Pole
obowiązkowe,
konieczne jest
przekazanie ważnej
wartości.
7
Rachunek ZUS
C
34
M
RACHUNEK
8
Nazwa skrócona
albo nazwisko i
imię płatnika
składek
C
2*35
M
NAZWA
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.
5
Pole
wg Płatnik
Pole w
def3000/CEB
Opis pola w def3000/
CEB
Pole pomijane przy
wczytywaniu do
def3000/CEB
Data zlecenia. Pole
obowiązkowe,
konieczne jest
przekazanie ważnej
wartości.
domyślnie przyjmowana
jako PLN. Pole
obowiązkowe,
konieczne jest
przekazanie ważnej
wartości.
Pole pomijane przy
wczytywaniu do
def3000/CEB
Strona 23
9
Nazwa
odpowiedniej
jednostki ZUS
C
4*35
O
-
Pole pomijane przy
wczytywaniu do
def3000/CEB
10
Numer oddziału
banku
prowadzącego
rachunek
płatnika składek
Numer oddziału
prowadzącego
rachunek ZUS
N
8
O
-
Pole pomijane przy
wczytywaniu do
def3000/CEB
N
8
O
-
Pole pomijane przy
wczytywaniu do
def3000/CEB
12
Informacje
dodatkowe o
składce dla
transakcji ZUS
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łu wykonawczego.
Pole obowiązkowe,
konieczne jest
przekazanie ważnej
wartości.
13
Numer czeku
C
10
O
-
14
Szczegóły
reklamacji
C
4*35
O
-
15
Kod dokumentu
C
2
O
-
Pole pomijane przy
wczytywaniu do
def3000/CEB
Pole pomijane przy
wczytywaniu do
def3000/CEB
Pole pomijane przy
wczytywaniu do
def3000/CEB
16
Informacje
międzybankowe
C
16
M
REFERENCJE
Dodatkowy
identyfikator przelewu –
referencje. Pole, o ile
ma wartość niepustą,
jest wczytywane do
def3000/CEB. Pole nie
jest obowiązkowemożna przekazać
wartość pustą.
17
Dowolny tekst
C
35
O
-
Pole pomijane przy
wczytywaniu do
def3000/CEB
11
1 – Sposób wypełniania pola TREŚĆ:
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 (RRRRMM, gdzie RRRR – rok, MM – miesiąc)
nr deklaracji (2N)
linia4 – numer decyzji/umowy/tytułu wykonawczego (15X)
Strona 24
Przykłady rekordów z pliku w formacie Płatnik:
120,20060530,3000,,10101023,"32156000132005000001720001","83101010230000261395100000","ZUS
"
,"",,,"5540232159|1WL1234567|S20060501","","","51","przelewZUS"," "
Strona 25
5.3 Struktury plików importu odbiorców
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 <CRLF>.
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) lub
są stałej długości.
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 Zł,GR. Separatorem groszy jest przecinek.
Pole
Długość
Typ
Opis
IDENT*
20
C
Skrócona nazwa kontrahenta. 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 kontrahenta 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ści 35
znaków każde
RACHUNEK
34
C
LIMIT_J*
12/2
K
Kwota limitu jednorazowego dla kontrahenta
* - dozwolona pusta wartość
Poniżej przedstawiono przykładowy opis struktury z pliku schema.ini definiującej plik z danymi kontrahentów.
[kontrah.txt]
ColNameHeader=False
Format=Delimited(;)
MaxScanRows=25
CharacterSet=OEM
Col7=LIMIT_J Float
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.
Format =FixedLength oznacza plik stałopozycyjny, w którym pola rekordu mają stałą długość. W takim
przypadku konieczne jest określenie długości poszczególnych pól w opisie struktury.
Parametry MaxScanRows oraz CharacterSet zostały umieszczone w opisie struktury dla zachowania
zgodności ze standardem ODBC. Parametry te są ignorowane przez aplikację def3000/CEB 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ści dla parametru lub pominięcia go, aplikacja przyjmuje
domyślną wartość parametru – False.
Strona 26
Przykładowa zawartość pliku z danymi kontrahentów w formacie liniowym:
Jan;Jan Test;ul. Testowa 1;00-001;Miasto;51101010231234567890123456;6000;
Plik w formacie XML
Dla pliku kontrahentów w formacie XML dozwolone jest stosowanie następujących tagów (tekst pisany czcionką
bold):
<kontrahenci>
<kontrahent>
<nazwa_kr>
Nazwa krótka kontrahenta
<nazwa_kr>
</nazwa>
Nazwa pełna kontrahenta
</nazwa>
<rachunek>
<rachunek>
<limit_j>
Limit jednorazowy dla kontrahenta
<limit_j>
</kontrahent>
...
</kontrahenci>
Każde
powtórzenie
tagów <kontrahent> ... </kontrahent> oznacza
dane
nowego
kontrahenta.
Przykładowy plik .xml zawierający dane o kontrahentach:
<kontrahenci>
<kontrahent>
<nazwa_kr>TEST</nazwa_kr>
<nazwa>ZAKŁAD TESTOWY</nazwa>
<limit_j>5000</limit_j>
</kontrahent>
<kontrahent>
<nazwa_kr>KLIENT</nazwa_kr>
<nazwa> KLIENT TESTOWY|UL. TESTOWA 11|MIASTO</nazwa>
<limit_j>10000</limit_j>
</kontrahent>
</kontrahenci>
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 <CRLF>.
Każda linia pliku składa się z pól oddzielonych znakiem „|” (pionowa kreska). Pola występują w ustalonej
kolejności 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/CEB. 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.
Strona 27
Zestaw pól opisujących kontrahenta:
C – pole tekstowe
Pole
Długość
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
Nazwa banku1**
35
C
Pole pomijane przy wczytywaniu do aplikacji def3000/CEB
Nazwa banku2**
35
C
Adres banku1**
35
C
Adres banku2**
35
C
Identyfikator*
20
C
Nazwa skrócona kontrahenta. Dozwolona pusta wartość,
podstawiane jest 20 początkowych znaków z nazwy kontrahenta.
* - pole opcjonalne
** - pole pomijane przy wczytywaniu do aplikacji def3000/CEB
Przykład pliku importu kontrahentów w formacie Telekonto:
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
Strona 28

Import Eksport Danych - SGB

Transkrypt

Podobne dokumenty

Wdrożenie systemu informatycznego do obsługi oraz

Wdrożenie kompleksowego rozwiązania w Meritum Bank.

A\XjlVmXecT_aX Że‰W b XaXeZ\\

Centralny System Bankowy w Banku Ochrony Środowiska

Pobierz PDF

Automatyczna – półautomatyczna linia do

FmlU^b jlWT]X`l ŧebW^\ m H8

plik pdf

def3000/CEB - Bank Spółdzielczy Raszyn