MultiCash PRO Opis formatu pliku wyciągów STA (pochodnym

BANKOWOŚĆ ELEKTRONICZNA
MultiCash PRO
Opis formatu pliku wyciągów STA
(pochodnym TBS SAT)
Wersja 2008-01-30
SPIS TREŚCI
1. Opis formatu pliku STA
3
1.1 Ogólne informacje o pliku STA
3
1.1.1 Czym jest plik *.STA?
3
1.1.2 Czym różnią się wyciągi (plik. *.STA)
od operacji w drodze (Plik *.VML)?
3
1.1.3 Jak rozmieszczona jest informacja w
pliku STA?
3
1.1.4 W jaki sposób prezentowane S.A.
szczegóły operacji? (pola :61: i :86:)
4
1.1.5 Jakiego typu kody są dostępne dla
operacji?
5
1.2 Specyfikacja formatu STA
5
1.2.1 Oznaczenia użyte w opisie formatu
5
1.2.2 Opis formatu bloku wyciągów MT940 6
1.2.2.1 Nagłówek wyciągu
6
1.2.2.2 Blok operacji
6
1.2.2.3 Blok końca wyciągu
8
1.2.3 Rozmieszczenie informacji w bloku
MT940
9
1.2.4 Przykład pliku sta zawierającego wyciąg
MT940 z 4 operacjami
9
2. Informacje dodatkowe
11
-2-
1. Opis formatu pliku STA
1.1
OGÓLNE INFORMACJE O PLIKU STA
Dokument ten jest przeznaczony dla Klientów tworzących interfejs pomiędzy systemem
MultiCash a systemem ERP. Specyfikuje format plików wyciągów STA, udostępnianych
przez Bank BPH i zawierających wyciągi w formacie MT940
1.1.1 CZYM JEST PLIK *.STA?
System MultiCash wykorzystuje pliki *.STA jako źródło informacji o operacjach na
rachunkach Klienta. Pliki STA są pobierane z serwera bankowego i po skończonej transmisji
dane zawarte w tych plikach są automatycznie importowane do baz MultiCash. Natomiast
pliki źródłowe STA pozostają niezmienione w katalogu ...\MCCWIN.
Ściśle określony format pliku STA w połączeniu z kodami operacji oznacza możliwość
automatycznego księgowania operacji w systemie finansowo-księgowym.
Plik STA jest plikiem tekstowym o ściśle określonej strukturze, zawierającym dokładne dane
o operacjach na rachunkach. Plik zawiera bloki wyciągów na zamknięcie dnia dla
poszczególnych rachunków (end of day) oparte na formacie SWIFT MT940.
Operacje w drodze (Intraday - operacje w ciągu dnia) są dostarczane osobną sesją VML, aby
nie powodować dublowania operacji w pliku.
1.1.2 CZYM RÓŻNIĄ SIĘ WYCIĄGI (PLIK. *.STA) OD OPERACJI W
DRODZE (PLIK *.VML)?
Tylko dane z pliku STA mogą być wykorzystywane do automatycznego księgowania.
Natomiast głównym zadaniem pliku VML (operacji w drodze) jest jak najszybsze
poinformowanie Klienta o ruchach na rachunku i aktualnym saldzie. Wyciąg STA jest
pełnym zestawieniem transakcji za poprzedni dzień. Natomiast plik VML z operacjami w
drodze jest generowany w ciągu dnia (co godzinę, gdy występuje ruch na rachunku lub na
żądanie, po połączeniu sesją XVM).
1.1.3 JAK ROZMIESZCZONA JEST INFORMACJA W PLIKU STA?
:20:data wyciągu
:25:numer rachunku 1
:28C:numer wyciągu
:NS:22 właściciel rachunku
:60F:saldo początkowe
:61:transakcja 1
:NS:19 godz. księgowania transakcji 1
:86:szczególy transakcji 1
:61:transakcja 2
:NS:19 godz. księgowania transakcji 2
-3-
Blok wyciągu MT940.
Zawiera pełne zestawienie transakcji za ubiegły dzień, saldo
otwarcia, zamknięcia i dostępne
:86:szczególy transakcji 2
:61:transakcja 3
:NS:19 godz. księgowania transakcji 3
:86:szczegoly transakcji 3
:62F:saldo końcowe
:64:saldo dostępne
:86:Informacje dodatkowe
:20:data wyciągu
:25:numer rachunku 2
:28C:numer wyciągu
:NS:22 właściciel rachunku
:60F:saldo początkowe
:61:transakcja 4
:NS:19 godz. księgowania transakcji 4
:86:szczególy transakcji 4
:61:transakcja 5
:NS:19 godz. księgowania transakcji 5
:86:szczególy transakcji 5
:62F:saldo końcowe
:64:saldo dostępne
:86:Informacje dodatkowe
Blok wyciągu MT940.
Zawiera pełne zestawienie transakcji za ubiegły dzień, saldo
otwarcia , zamknięcia i dostępne
1.1.4 W JAKI SPOSÓB PREZENTOWANE
OPERACJI? (POLA :61: I :86:)
S.A.
SZCZEGÓŁY
Szczegóły pojedynczej transakcji prezentowane są w liniach :61: , :NS:19 oraz :86:
Linia :61: zawiera dane dotyczące daty waluty , daty księgowania, kwoty oraz waluty
operacji, linia :NS19: godzinę księgowania, natomiast linia :86: prezentuje tytuł operacji,
dane kontrahenta oraz zawiera kody operacji.
:61:0203260326DN5312,00NTRF
:NS19:1259
:86:020<00Wyplata-(dysp/przel)<10numer transakcji
<20 linia 1 tytułu operacji
<21 linia 2 tytułu operacji
<22 linia 3 tytułu operacji
<23 linia 4 tytułu operacji
<24 linia 5 tytułu operacji
<25 linia 6 tytułu operacji
<27NAZWA KONTRAHENTA 1
<28NAZWA KONTRAHENTA 2
<29ADRES KONTRAHENTA 1
<30numer rozliczenowy banku kontrahenta<31numer rachunku kontrahenta
<32NAZWA I ADRES KONTRAHENTA 1<33NAZWA I ADRES KONTRAHENTA 2 do 27 znaków
<38 IBAN lub NRB kontrahenta
<60ADRES KONTRAHENTA 2
<61ID TRANSAKCJI W FK KLIENTA do 35 zn.
<62ID KONTRAHENTA W FK KLIENTA do 35 zn.
<63REF5898327000090031789
-4-
1.1.5 JAKIEGO TYPU KODY SĄ DOSTĘPNE DLA OPERACJI?
Szczegóły operacji zawierają 2 rodzaje kodów:
Kody operacji: w zależności od typu operacji każdej nadawany jest kod wg.
standardów SWIFT i GVC. Dla przykładu standardowe polecenie przelewu ma kod
SWIFT TRF, i kod GVC 020. Dzięki temu możliwe jest rozpoznanie czy
zaksięgowana operacja to polecenie przelewu , czy koszt odsetek. Pełna lista kodów
znajduje się na stronie www.bph.pl/multicash/erp
Kody zwrotne (do rekoncyliacji). Każda płatność wychodząca może być opatrzona
indywidualnym kodem, czy ciągiem znaków, który zostanie zwrócony w określonym
miejscu na wyciągu. Dzięki temu możliwe jest rozpoznawanie, czy np. zlecenie
pochodzi z ERP i którego kontrahenta dotyczy. Możliwe jest też nadawanie każdej
wychodzącej transakcji unikalnego numeru. Gdy nadejdzie wyciąg, zawierający
transakcję o danym numerze, system ERP odznaczy zlecenie, jako wykonane.
1.2
SPECYFIKACJA FORMATU STA
Każdy plik STA może zawierać jeden lub kilka wyciągów MT940. Ilość wyciągów
zawartych w pliku *.STA zależy od częstotliwości pobierania danych przez Klienta.
W pliku STA nie znajdują się operacje w drodze, które dostarczane są osobną sesją
VML.
Każdy wyciąg(MT940) składa się z nagłówka, bloku zawierającego poszczególne
transakcje oraz bloku końcowego.
Strona kodowa dla polskich znaków to CP852.
Przed każdą linią stosuje się ciąg znaków <CR><LF> (ASCII 13 + 10).
Poszczególne wyciągi oddzielone są <CR><LF> -
1.2.1 OZNACZENIA UŻYTE W OPISIE FORMATU
Status
Format
n
a
c
x
M- obowiązkowy, O – opcjonalny
tylko cyfry
tylko litery
alfanumeryczne
dowolne znaki alfanumeryczne łącznie z przecinkami,
spacjami , itp.
Kwota z przecinkiem jako znak dziesiętny
d
Przykład
2n - do dwóch cyfr;
3!a - zawsze 3 litery;
4*35x - do 4 linii po 35 znaków
-5-
1.2.2 OPIS FORMATU BLOKU WYCIĄGÓW MT940
1.2.2.1
NAGŁÓWEK WYCIĄGU
Nr / Nazwa
Pola
:20:
Referencje
Format
Opis
M
7n
:25:
Numer
rachunku
M
2!a26!n
:28C:
Numer
wyciągu
M
5n
Referencje w postaci daty wyciągu w formacie DDDHHMM, gdzie DDD
jest numerem dnia w roku, HHMM czasem generacji wyciągu.
Np. :20:1372359
Numer rachunku w postaci IBAN
gdzie
IBAN = PLSSBBBBBBBBRRRRRRRRRRRRRRRR
PL = kod kraju dług. 2!a
SS= cyfry kontrolne 2!n
BBBBBBBB = NrB krajowy identyfikator jednostki banku dług. 8!n
RRRRRRRRRRRR= IdR identyfikator rachunku w jednostce banku dług.
16!n
Np. :25:PL52106000760000321000055801
Numer wyciągu
Np. :28C:57
:NS:22
M
35x
:60F:
Saldo
otwarcia
Debet
Kredyt
Data
Waluta
Kwota
M
1.2.2.2
Status
/
Skrócona nazwa właściciela rachunku
Typ salda
F = Saldo początkowe
M
1!a
M
M
M
6!n
3!a
15d
C = kredyt (saldo kredytowe)
D = debet (saldo debetowe)
Data salda otwarcia w formacie YYMMDD
Kod waluty ISO
Kwota z przecinkiem (,) jako znak dziesiętny.
Przykład dla całej linii :60F:
:60F:C070126PLN28228378,38
BLOK OPERACJI
Nr / Nazwa
Pola
:61:
Linia
operacji
Data
efektywna
Data
księgowania
Debet
/
Kredyt
Status
Format
Opis
M
M
6!n
Data efektywna w formacie YYMMDD
M
4!n
Data księgowania w formacie MMDD
M
2a
3-cia litera
kodu waluty
M
1!a
C = kredyt (uznanie)
D = debet (obciążenie)
RC = storno kredytu
RD = storno debetu
3-cia litera kodu waluty ISO
Np. N dla PLN
Kwota
M
15d
Kwota z przecinkiem (,) jako znak dziesiętny.
-6-
Kod
transakcji
wg SWIFT
Referencje
klienta
M
N3!c
M
16x
Referencje
banku
M
(//)16x
Referencje
banku
M
34x
:NS:19
:86:
Szczegóły
operacji
M
M
4!n
patrz
opis
Stała N wraz z kodem transakcji SWIFT (pełna lista w tabeli kodów na
stronie www.bph.pl/multicash/erp )
Np. NTRF
Referencje klienta:
Dla płatności wychodzących:
PLI – pierwsza linia KB-Info (przeniesione ostatnie 16 znaków z 35)
PLA – pole :20: (referencje klienta –16 znaków)
INT- pole :20: (referencje klienta – 16 znaków)
Dla płatności przychodzących:
Referencje: o ile są podane w odpowiednich polach
Referencje banku
Dla płatności wychodzących:
Ostatnie 16 cyfr numeru referencyjnego transakcji w systemie TBS
Np. 0122MCI_16574549
Opis kodu GVC – Typ operacji
Druga linia referencji banku (po <CR><LF>)
Np. Przelew krajowy MultiCash (-)
Godzina księgowania operacji w formacie HHMM, np. 1059 dla 10:59
Linia szczegółów operacji. (patrz opis poniżej)
Ogólne założenia dotyczące pola :86:
Separator subpól <
Jeżeli subpole jest puste (brak informacji), całe subpole, łącznie ze znacznikiem nie
jest prezentowane
Kod subpola
Początek
pola
<00
Status
M
Format
3!n
M
27a
<10
M
10n
<20
<21
<22
<23
<24
O
O
O
O
O
35x
35x
35x
35x
35x
<25
<26
<27
<28
<29
<30
<31
O
O
O
O
O
O
O
35x
35x
35x
35x
35x
10x
24x
<32
O
27x
<33
O
27x
Opis
Kod operacji GVC. Pełna lista kodów na stronie www.bph.pl/multicash/erp
Np. 020
Typ operacji [Booking text]
Wypl/przelew - opis księgowania w Profile, identyczny z wyciągiem
papierowym
Numer referencyjny
Kolejny numer operacji na rachunku
Np. <1024755
1. Linia tytułu operacji
2. Linia tytułu operacji
3. Linia tytułu operacji
4. Linia tytułu operacji
5. Linia tytułu operacji
Dla płatności przychodzących, zewnętrznych: DORN - Data obciążenia
rachunku nadawcy
Np. <24DORN=26/01/2007
6. Linia tytułu operacji
7. Linia tytułu operacji
Nazwa kontrahenta 1
Nazwa kontrahenta 2
Adres kontrahenta 1
Identyfikator jednostki bankowej kontrahenta (BSC lub SWIFT BIC)
Identyfikator rachunku kontrahenta (skrócony) dla prezentacji MultiCash
W przypadku rachunku NRB w tym polu przedstawiane są znaki od 11 do 26
Skrócona nazwa i adres kontrahenta (linia 1) dla celów prezentacyjnych
MultiCash
Skrócona nazwa i adres kontrahenta (linia 2) dla celów prezentacyjnych
-7-
<38
<60
O
O
34x
35x
<61
O
35x
<62
O
35x
<63
M
35x
<64
O
35x
<65
O
35x
1.2.2.3
Kod rekoncyliacji 1
Wartość przeniesiona z pierwszej linii pola KB_info (informacje KlientBank) dla płatności wychodzących MultiCash PLI , PLA, INT
Kod rekoncyliacji 2
Wartość przeniesiona z drugiej linii pola KB_info (informacje Klient-Bank)
dla płatności wychodzących PLI , PLA, INT
Pełny numer referencyjny transakcji w głównym systemie bankowym
(Profile 5.1) z przedimkiem REF
Np. <63REF5898327000090031789
Kod rekoncyliacji 3
Wartość przeniesiona z trzeciej linii pola KB_info (informacje Klient-Bank)
dla płatności wychodzących PLI , PLA, INT
Informacja o opłatach i prowizjach (wyłącznie dla zleceń walutowych) ze
słowami kodowymi /OCMT/
Np. <65/OCMT/EUR 1450,00/
BLOK KOŃCA WYCIĄGU
Nr / Nazwa
Pola
:62F:
Saldo
końcowe
Debet
Kredyt
Data
Waluta
Kwota
MultiCash
Rachunek kontrahenta
Adres kontrahenta 2
Status
Format
M
/
Opis
Typ salda F
Saldo końcowe
M
1!a
M
M
M
6!n
3!a
15d
C = kredyt (saldo kredytowe)
D = debet (saldo debetowe)
Data salda końcowego w formacie YYMMDD
Kod waluty ISO
Kwota z przecinkiem (,) jako znak dziesiętny.
Przykład dla całej linii :62F:
:62F:C070126PLN28088772,29
:64:
Saldo
dostępne
Debet
Kredyt
Data
Waluta
Kwota
M
/
Saldo dostępne
M
1!a
M
M
M
6!n
3!a
15d
M
6*65x
O
Bez
ogranicz
eń
x
C = kredyt (saldo kredytowe)
D = debet (saldo debetowe)
Data salda dostępnego w formacie YYMMDD
Kod waluty ISO
Kwota z przecinkiem (,) jako znak dziesiętny.
Przykład dla całej linii :64:
:64:C070126PLN28088772,29
:86:
Dodatkowe
Informacje z
wyciągu
Blok :OS:04
Informacja z wyciągu. MultiCash PRO (3.0) wyświetla dodatkowe informacje
dotyczące całego wyciągu, (6 linii po 65 znaków), jeżeli są one umieszczone w linii
:86: na końcu wyciągu. Uwaga: nie należy mylić pola :86: na końcu bloku MT940,
dotyczącego całego wyciągu, z polem :86: (szczegóły operacji po linii :61)
Informacja tekstowa lub plik dołączony do wyciągu. Jeżeli MultiCash podczas
wczytywania pliku STA napotka rekord :OS:04, plik tekstowy wyświetla w
Menedżerze Informacji, w przypadku innego pliku (patch’a), umieszcza go w jednym
z folderów MCC.
Początek rozpoczyna się nazwą pliku :OS:04_długość pliku w bajtach_nazwa pliku.
Parser powinien ignorować plik, wielkość obszaru do zignorowania jest podana w
polu :OS:04, Etykieta pola :OS:0400003163DMIMCPRO.TXT oznaca, iż dołączony
plik DMIMCPRO.TXT ma długość 3163 bajtów i tak długi fragment pliku STA
należy zignorować podczas parsowania.
Np. :OS:0400003163DMIMCPRO.txt
Szanowni Państwo, pragniemy poinformować...
-8-
1.2.3 ROZMIESZCZENIE INFORMACJI W BLOKU MT940
:20:data wyciągu
:25:numer rachunku
:28C:numer wyciągu
:NS:22właściciel rachunku
:60F:saldo otwarcia
:61:transakcja (data waluty, data księgowania, waluta, kwota)
:NS:19godz. księgowania transakcji
:86:kod GVC<00typ operacji<10numer operacji
<20linia 1 tytułu operacji
<21linia 2 tytułu operacji
<22linia 3 tytułu operacji
<23linia 4 tytułu operacji
<24linia 5 tytułu operacji
<25linia 6 tytułu operacji
<27nazwa kontrahenta 1
<28nazwa kontrahenta 2
<29adres kontrahenta 1
<30numer rozliczeniowy banku kontr.<31id rachunku kontrah.
<32nazwa i adres kontrah. skrócona1<33nazwa i adres kontrah. skrócona2
<38rachunek kontrahenta
<60adres kontrahenta 2
<61kod rekoncyliacji 1
<63referencje banku
....(następna transakcja)...
............................
:62F:saldo końcowe
:64:saldo dostępne
:86:informacje o rachunku
-
1.2.4 PRZYKŁAD PLIKU STA ZAWIERAJĄCEGO WYCIĄG MT940
Z 4 OPERACJAMI
:20:262359
:25:PL52106000760000321000055801
:28C:10
:NS:22Test 03 MC TBS
:60F:C070126PLN28228378,38
:61:0701260126DN5912,00NTRF200701260001//0126MCI_16574654
Przelew krajowy MultiCash (-)
:NS:190906
:86:020<00Przelew MultiCash<1014551
<20ZAPLATA ZA OPAKOWANIA DO KINESKOPŕW
<2117 I 21 CALI Z
<22NADRUKIEM LOGO FIRMY
<23FVT 2368/2989284/2006
<27OPAKOWANIA SP. Z O.O
<29UL. ROMAăSKA 24
<3010901102<310000999999874157
<32OPAKOWANIA SP. Z O.O UL. R<33OMAăSKA 24
<3821109011020000999999874157
<6080-253 GDAăSK
<61200701260001
<62KOD RECONCYLIACJI 000008
<63REF6065627001791911001
<64WPROWADZIť W SAP ID25012
:61:0701260126DN1550,00NTRF200701260002//0126MCI_16574655
-9-
Przelew krajowy MultiCash (-)
:NS:190906
:86:020<00Przelew MultiCash<1014552
<20ZAPťATA ZA WYSYLK¨ TOWARU
<21DO NL DIGITAL, EINDHOVEN
<22HOLLAND GRUDZIEă 2006
<23INV. 6/2006FVT 2323/0394/2006
<27SPEDYTOR SP. Z O.O.
<29WYNALAZEK 6
<3010600076<310000321000095502
<32SPEDYTOR SP. Z O.O. WYNALA<33ZEK 6
<3872106000760000321000095502
<6002-787 WARSZAWA
<61200701260002
<62KOD RECONCYLIACJI 000009
<63REF6065627001791912001
<64WPROWADZIť W SAP ID24021
:61:0701260126DN120000,00NTRF200701260003//0126MCI_16574656
Przelew krajowy MultiCash (-)
:NS:190906
:86:020<00Przelew MultiCash<1014553
<20FVT 25/2006 ZAPťATA ZA KATODY DO
<21LAMP KIENSKOPOWYCH SZT. 1100
<22FVT 26/2006 ZAPLATA ZA UKLADY
<23ODCHYLAJACE SZT. 1100
<27ELEKTRONIKA SP. Z. O.O.
<28PODZESPOťY ELEKTRONICZNE
<29KILIăSKIEGO 27
<3010600076<310000321000095503
<32ELEKTRONIKA SP. Z. O.O. POD<33ZESPOťY ELEKTRONICZNE KILIă
<3845106000760000321000095503
<6030-308 KRAKŕW
<61200701260003
<62KOD RECONCYLIACJI 000010
<63REF6065627001791913001
<64WPROWADZIť W SAP ID25053
:61:0701260126DN1356,12NTRF200701260004//0126MCI_16574657
Przelew krajowy MultiCash (-)
:NS:190906
:86:020<00Przelew MultiCash<1014554
<20ZAPťATA ZA PALIWO GRUDZIEă 06
<21FAKTURA 6547/2006
<27STACJA PALIW MIKOťAJCZYK
<29ZAMKOWA 8
<3010600076<310000321000095505
<32STACJA PALIW MIKOťAJCZYK Z<33AMKOWA 8
<3888106000760000321000095505
<6032-020 WIELICZKA
<61200701260004
<62KOD RECONCYLIACJI 000011
<63REF6065627001791914001
<64WPROWADZIť W SAP ID25012
:62F:C070126PLN28099560,26
:64:C070126PLN28099560,26
:86:20070126 2359
DOT=24/01/2006 INTC=0.05000
:OS:0400000237INFK0709.PTK
Dear Customers,
we would like to inform that we introduce
new STA statement file format . BTW: 0000000237 is length of this file in bytes
We hope that it will meet your expectations.
Regards,
Electronic Banking Department
Bank BPH
- 10 -
2. Informacje dodatkowe
Kody transakcji SWIFT i GVC znajdują się w osobnym załączniku. Dalsze informacje na
stronie www.bph.pl/multicash/erp
W przypadku jakichkolwiek pytań związanych z formatem plików zleceń w systemie
MultiCash PRO prosimy o kontakt z HotLine MultiCash:
HotLine MultiCash
tel.
0 801 676 662
tel.
+48 12 682 81 67
fax: +48 12 688 31 50
e-mail: [email protected]
Internet: www.bph.pl/multicash
- 11 -