BANKOWOŚĆ ELEKTRONICZNA PROFFICE\ ulticash PRO Opis formatu pliku wyciągów STA (pochodnym SA 2) Zawiera opis zmian związanych z migracją do systemu Banku Pekao SA Wersja 20080325
SPIS TREŚCI 1. OPIS FORATU PLIKU STA 3 1.1 OGÓLNE INFORACJE O PLIKU STA 3 1.1.1 Czym różnią się wyciągi (T940) od operacji w drodze (T942)? 3 1.1.2 Jak rozmieszczona jest informacja w pliku STA? 3 1.1.3 W jaki sposób prezentowane są szczegóły operacji? (pola :61: i :86:) 4 1.2 SPECYFIKACJA FORATU STA 4 1.2.1 Oznaczenia użyte w opisie formatu 4 1.2.2 Opis formatu bloku wyciągów T940 5 1.2.3 Opis formatu bloku operacji w drodze T942 7 1.2.4 Rozmieszczenie informacji w bloku T940 8 1.2.5 Przykład pliku STA zawierającego wyciąg T940 z 4 operacjami 8 1.3 RÓŻNICE W FORACIE WYCIĄGU 10 1.4 ZIANY W TABELI KODÓW GVC/SWIFT 10 2. INFORACJE DODATKOWE 11 2
1. Opis formatu pliku STA 1.1 OGÓLNE INFORACJE O PLIKU STA Dokument ten jest przeznaczony dla Klientów tworzących interfejs pomiędzy systemem ulticash\proffice a systemem ERP. Specyfikuje format plików wyciągów STA, udostępnianych przez Bank Pekao i zawierających wyciągi dzienne (T940) oraz operacje w drodze (T942). Na końcu dokumentu umieszczony został opis zmian związanych z migracją do systemu Banku Pekao SA. 1.1.1 CZY RÓŻNIĄ SIĘ WYCIĄGI (T940) OD OPERACJI W DRODZE (T942)? Blok wyciągu (T940) zawiera oprócz informacji o transakcjach także saldo otwarcia, zamknięcia oraz numer wyciągu. Tylko dane z T940 powinny być wykorzystywane do automatycznego księgowania. Natomiast głównym zadaniem operacji w drodze (T942) jest jak najszybsze poinformowanie Klienta o ruchach na rachunku. Jeżeli zostanie zaksięgowana operacja, tak szybko jak to jest możliwe generowany jest T942 i appendowany do pliku STA. Podczas parsowania pliku STA należy więc dokładnie rozróżnić T940 od T942, w przeciwnym przypadku transakcja zostanie zaksięgowana podwójnie. Podsumowując: wyciąg T940 jest pełnym zestawieniem transakcji za poprzedzi dzień (okres), z saldem początkowym i końcowym. Natomiast operacja w drodze (T942) jest generowana w ciągu dnia (intraday), każdorazowo, gdy występuje ruch na rachunku. To, czy dany fragment STA jest T940, czy T942 jest łatwo rozróżnialne po znaczniku STARTDISP w linii :20: 1.1.2 JAK ROZIESZCZONA JEST INFORACJA W PLIKU STA? :20:data wyciągu :25:numer rachunku :28C:numer wyciągu :60F:saldo początkowe :61:transakcja 1 :86:szczególy transakcji 1 :61:transakcja 2 :86:szczególy transakcji 2 :61:transakcja 3 :86:szczegoly transakcji 3 :62F:saldo końcowe :64:saldo dostępne :20:STARTDISP :25:numer rachunku :13:data i godzina wygenerowania informacji :61:transakcja 4 :86:szczególy transakcji 4 :20:STARTDISP :25:numer rachunku :13:data i godzina wygenerowania informacji :61:transakcja 5 :86:szczególy transakcji 5 Blok wyciągu T940. Zawiera pełne zestawienie transakcji za ubiegły dzień, saldo otwarcia, zamknięcia i dostępne Blok operacji w drodze T942. W dniu dzisiejszym system zaksięgował dwie transakcje (oznaczone tu numerem 4 i 5). Klient został poinformowany o transakcji tak szybko, jak to jest możliwe :20:data wyciągu 3
:25:numer rachunku :28C:numer wyciągu :60F:saldo początkowe :61:transakcja 4 :86:szczególy transakcji 4 :61:transakcja 5 :86:szczególy transakcji 5 :62F:saldo końcowe :64:saldo dostępne Blok wyciągu T940. Zawiera pełne zestawienie transakcji za ubiegły dzień, saldo otwarcia, zamknięcia i dostępne 1.1.3 W JAKI SPOSÓB PREZENTOWANE SĄ SZCZEGÓŁY OPERACJI? (POLA :61: I :86:) Szczegóły pojedynczej transakcji prezentowane są w liniach :61: oraz :86: Linia :61: zawiera dane dotyczące daty efektywnej, daty księgowania, kwoty oraz waluty operacji, natomiast linia :86: prezentuje tytuł operacji, dane kontrahenta oraz zawiera kody operacji. :61:0802190219DN5312,00NTRF :86:020<00PRZELEW BETA/INTEGRA <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 KONTRAHENTA1<33NAZWA I ADRES KONTRAHENTA 2 do 27 znaków <34<38 IBAN lub NRB kontrahenta <60ADRES KONTRAHENTA 2 <63REF 5898327000090031789 <66kod księgowania Rocket 1.2 SPECYFIKACJA FORATU STA Każdy plik STA może zawierać jeden lub kilka wyciągów T940 i bloków operacji w drodze T942. Ilość wyciągów/ bloków operacji zawartych w pliku *.STA zależy od częstotliwości pobierania danych przez Klienta. Każdy wyciąg (T940) składa się z nagłówka, bloku zawierającego poszczególne transakcje oraz bloku końcowego. Operacje w drodze (T942) zawierają charakterystyczny nagłówek i blok operacji. 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 FORATU Status Format n a c x d Przykład 2n do dwóch cyfr; obowiązkowy, O opcjonalny tylko cyfry tylko litery alfanumeryczne dowolne znaki alfanumeryczne łącznie z przecinkami, spacjami, itp. Kwota z przecinkiem jako znak dziesiętny 4
3!a zawsze 3 litery; 4*35x do 4 linii po 35 znaków 1.2.2 OPIS FORATU BLOKU WYCIĄGÓW T940 1.2.2.1 NAGŁÓWEK WYCIĄGU Nr / Nazwa Pola :20: Referencje :25: Numer rachunku :28C: Numer wyciągu Status Format Opis 6!n Referencje w postaci daty wyciągu w formacie YYDD, Np. :20:080218 2!a26! Numer rachunku w postaci IBAN n 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:PL42124046501111000001095509 5n/2n Numer wyciągu/numer strony Np. :28C:00035/01 :60F: Saldo otwarcia Debet / Typ salda F = Saldo początkowe 1!a C = kredyt (saldo kredytowe) D = debet (saldo debetowe) Kredyt Data 6!n Data salda otwarcia w formacie YYDD Waluta 3!a Kod waluty ISO Kwota 15d Kwota z przecinkiem (,) jako znak dziesiętny. Przykład dla całej linii :60F: :60F:C080215PLN86353,56 1.2.2.2 BLOK OPERACJI Nr / Nazwa Pola :61: Linia operacji Data efektywna Data księgowani a Debet / Kredyt 3cia litera kodu waluty Status Format Opis 6!n Data efektywna w formacie YYDD 4!n Data księgowania w formacie DD 2a C = kredyt (uznanie) D = debet (obciążenie) RC = storno kredytu RD = storno debetu 1!a 3cia litera kodu waluty ISO Np. N dla PLN Kwota 15d Kwota z przecinkiem (,) jako znak dziesiętny. 5
Kod transakcji wg SWIFT Referencje banku Referencje banku :86: Szczegóły operacji N3!c Stała N wraz z kodem transakcji SWIFT Np. NTRF NONR EF //16x Stała NONREF wraz z referencją banku Np. NONREF//2408021810000008 Referencja banku prezentowana jest tylko dla zleceń wysłanych z systemu PROFFICE 34x Typ operacji Druga linia referencji banku (po <CR><LF>) Np. Przelew ulticash TBS patrz opis 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 Status Format Opis subpola Początek pola 3!n Kod operacji GVC. Np. 020 <00 27a Typ operacji [Booking text] Np. PRZELEW BETA/INTEGRA opis księgowania w Rocket <20 O 27x 1. Linia tytułu operacji <21 O 27x 2. Linia tytułu operacji <22 O 27x 3. Linia tytułu operacji <23 O 27x 4. Linia tytułu operacji <24 O 27x 5. Linia tytułu operacji <25 O 27x 6. Linia tytułu operacji <26 O 35x Rachunek kontrahenta <27 O 35x Nazwa kontrahenta 1 <28 O 35x Nazwa kontrahenta 2 <29 O 35x Adres kontrahenta 1 <30 O 10x Identyfikator jednostki bankowej kontrahenta <31 O 24x Identyfikator rachunku kontrahenta (skrócony) dla prezentacji ulticash W przypadku rachunku NRB w tym polu przedstawiane są znaki od 11 do 26 <32 O 27x Skrócona nazwa i adres kontrahenta (linia 1) dla celów prezentacyjnych ulticash <33 O 27x Skrócona nazwa i adres kontrahenta (linia 2) dla celów prezentacyjnych ulticash <34 3!n Kod operacji GVC. Np. 020 <38 O 34x Rachunek kontrahenta <60 O 35x Adres kontrahenta 2 <63 35x Numer referencyjny transakcji z przedimkiem REF Np. <63REF 2408021810000008 Uwaga! Numer referencyjny transakcji prezentowany jest tylko dla zleceń wysłanych z systemu PROFFICE <66 35x Kod księgowania w systemie Rocket 6
1.2.2.3 BLOK KOŃCA WYCIĄGU Nr / Nazwa Status Format Opis Pola :62F: Saldo końcowe Typ salda F Saldo końcowe Debet / 1!a C = kredyt (saldo kredytowe) Kredyt D = debet (saldo debetowe) Data 6!n Data salda końcowego w formacie YYDD Waluta 3!a Kod waluty ISO Kwota 15d Kwota z przecinkiem (,) jako znak dziesiętny. Przykład dla całej linii :62F: :62F:C080218PLN220879,72 :64: Saldo dostępne Saldo dostępne Debet / 1!a C = kredyt (saldo kredytowe) Kredyt D = debet (saldo debetowe) Data 6!n Data salda dostępnego w formacie YYDD Waluta 3!a Kod waluty ISO Kwota 15d Kwota z przecinkiem (,) jako znak dziesiętny. Przykład dla całej linii :64: :64:C080218PLN1720879,72 Blok :OS:04 O Bez ograni czeń x Informacja tekstowa lub plik dołączony do wyciągu. Jeżeli ulticash podczas wczytywania pliku STA napotka rekord :OS:04, plik tekstowy wyświetla w enedżerze Informacji, w przypadku innego pliku (patch a), umieszcza go w jednym z folderów CC. 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:0400003163DICPRO.TXT oznaca, iż dołączony plik DICPRO.TXT ma długość 3163 bajtów i tak długi fragment pliku STA należy zignorować podczas parsowania. Np. :OS:0400003163DICPRO.txt Szanowni Państwo, pragniemy poinformować... 1.2.3 OPIS FORATU BLOKU OPERACJI W DRODZE T942 1.2.3.1 NAGŁÓWEK OPERACJI W DRODZE Nr / Nazwa Pola :20: Referencje :25: Numer rachunku Status Format Opis 9!c Słowo kodowe STARTDISP Np. :20:STARTDISP 2!a26! Numer rachunku w postaci IBAN n 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 7
:13: Data i godzina wygenerow ania informacji RRRRRRRRRRRR= IdR identyfikator rachunku w jednostce banku dług. 16!n Np. :25:PL42124046501111000001095509 10!n Data i godzina wygenerowania informacji w formacie RRDDGG. Np. :13:0802191020 1.2.3.2 BLOK OPERACJI :61: Linia operacji patrz opis :86: Szczegóły operacji patrz opis :OS: O Bez ogranicz eń x Linia operacji. :61: Linia szczegółów operacji. pola :86: Informacja tekstowa lub plik dołączony do wyciągu. Np. :OS:0400003163DICPRO.txt 1.2.4 ROZIESZCZENIE INFORACJI W BLOKU T940 :20:data wyciągu :25:numer rachunku :28C:numer wyciągu :60F:saldo otwarcia :61:transakcja (data waluty, data księgowania, waluta, kwota) :86:kod GVC<00typ operacji <20linia 1 szczegółów płatności<21linia 2 szczegółów płatności <22linia 3 szczegółów płatności<23linia 4 szczegółów płatności <24linia 5 szczegółów płatności<25linia 6 szczegółów płatności <26Rachunek kontrahenta <27nazwa kontrahenta 1 <28nazwa kontrahenta 2 <29Adres kontrahenta 1 <30numer rozliczeniowy banku kontr.<31rachunek kontrah. <32nazwa i adres kontrah. skrócona1<33nazwa i adres kontrah. skrócona2 <34kod GVC<38IBAN/NRB kontrah. <60Adres kontrahenta 2 <63referencje banku <66kod księgowania TRN Rocket :62F:saldo końcowe :64:saldo dostępne 1.2.5 PRZYKŁAD PLIKU STA ZAWIERAJĄCEGO WYCIĄG T940 Z 4 OPERACJAI :20:080218 :25:PL42124046501111000001095509 :28C:00035/01 :60F:C080215PLN86353,56 :61:0802180218CN142680,00NTRFNONREF//2408021810000001 8
Przelew PT :86:055<00PRZELEW <20FRA 4762/2007 ZAPťATA ZA<21DOSTAW KINESKOPŕW <22GRUDZIEă 20<2307 <2682124066541111000001055901 <27BLACKTRONIX FABRYKA TELEWIZORŕW <28GťOGOWSKA 248 <2960010 POZNAă <3012406654<311111000001055901 <32BLACKTRONIX FABRYKA TELEWIZ<33ORŕW GťOGOWSKA 248 <34055<3882124066541111000001055901 <63REF 2408021810000001 <662300 :61:0802180218CN20000,00NTRFNONREF//2408021810000003 Przelew PT :86:055<00PRZELEW <20FAKTURA 1/2008<21DOSTAWA KINESKOPŕW <22BLACK 17' 2<235 SZT. BLA <24CK 21' 30 SZT <2622124064071111000001055902 <27ATRIX WYTWŕRNIA SPRZ TU TV I AGD <28PUťAWSKA 65 <2900950 WARSZAWA <3012406407<311111000001055902 <32ATRIX WYTWŕRNIA SPRZ TU TV<33I AGD PUťAWSKA 65 <34055<3822124064071111000001055902 <63REF 2408021810000003 <662300 :61:0802180218DN19587,57NTRFNONREF//2408021810000008 Przelew ulticash TBS :86:020<00PRZELEW BETA/INTEGRA <20FRA 3242342234/2006<21ZA PREFABRYKATY DO <22TUB PRŕ NIOWYCH <2645124062921111000001095501 <27HUTA SZKťA TOPIK <28PRZEYSťOWA 67 <2950505 WROCťAW <3012406292<311111000001095501 <32HUTA SZKťA TOPIK<33PRZEYSťOWA 67 <34020<3845124062921111000001095501 <63REF 2408021810000008 <666310 :61:0802180218DN8566,27NTRFNONREF//2008021810000007 Przelew ulticash TBS :86:020<00PRZELEW I DZYBANKOWY BETA/ <20FRA 7611/2006 TERIN 070130<21ZA REONT ZAKťADOWY <22CH POIESZCZEă<23AGAZYNOWYCH <2602105014451000002252037854 <27USťUGI REONTOWE SP. Z O.O. <28JAN KOWALSKI <29STR KOWA 3A <3010501445<311000002252037854 <32USťUGI REONTOWE SP. Z O.O.<33JAN KOWALSKI <34020<3802105014451000002252037854 <6031345 KRAKŕW <63REF 2008021810000007 <666410 :62F:C080218PLN220879,72 :64:C080218PLN1720879,72 9
1.3 RÓŻNICE W FORACIE WYCIĄGU Różnice w formacie wyciągów dostarczanych z systemu księgowego Banku Pekao: Data prezentowana w polu :60F: (saldo otwarcia) jest datą poprzedniego wyciągu, dotychczas była data bieżącego wyciągu Saldo zerowe prezentowane w polach :60F: :62F: i :64: jest saldem debetowym (Debet /Kredyt D), dotychczas było prezentowane jako saldo kredytowe (Debet/Kredyt C) przykład: było: :62F:C080222PLN0,00 jest: :62F:D080222PLN0,00 W polu :61: Referencja banku prezentowana jest tylko dla zleceń wysłanych z systemu PROFFICE W polu :86: nie będzie prezentowane subpole <10 W polu :86: nie będą prezentowane subpola <61 i <62 kody zwrotne (do rekoncyliacji) W polu :86: w subpolu <63 Numer referencyjny transakcji prezentowany jest tylko dla zleceń wysłanych z systemu PROFFICE Zmieniona prezentacja szczegółów płatności dla specyficznych typów operacji np. płatności ZUS, płatności skarbowe, itd. Zmiany w tabeli kodów GVC 1.4 ZIANY W TABELI KODÓW GVC/SWIFT Zmiany w tabeli kodów GVC/SWIFT na wyciągach dostarczanych z systemu księgowego Banku Pekao: Operacje Polecenie zapłaty () i Odwołanie polecenia zapłaty() księgowane są kodem GVC 005, dotychczas: Polecenie zapłaty () kod GVC 005, Odwołanie polecenia zapłaty () kod GVC 009 Płatności ZUS i Płatności skarbowe księgowane są kodem GVC 020, dotychczas: Płatności ZUS kod GVC 030, Płatności skarbowe kod GVC 031 Operacje Odwołanie polecenia zapłaty (+) księgowane są kodem GVC 055 i kodem SWIFT TRF, dotychczas: Odwołanie polecenia zapłaty (+) kod GVC 059 i kod SWIFT DDT Operacje Polecenia zapłaty (+) księgowane są kodem GVC 055 i kodem SWIFT TRF, dotychczas: Polecenia zapłaty (+) kod GVC 071 i kod SWIFT DDT Operacje POS Płatność dewizowa () księgowane są kodem GVC 022, dotychczas: kod GVC 201 Operacje Zakup waluty (+) księgowane są kodem GVC 055 i kodem SWIFT TRF, dotychczas: Zakup waluty (+) kod GVC 411 i kod SWIFT FEX Operacje Sprzedaż waluty () księgowane są kodem GVC 024 i kodem SWIFT TRF, dotychczas: Sprzedaż waluty () kod GVC 412 i kod SWIFT FEX Operacje wypłaty gotówkowej księgowane są kodem GVC 021, dotychczas kody GVC 702, 704, 711 Operacje wpłaty gotówkowej księgowane są kodem GVC 053 i 054, dotychczas kody GVC 701, 703, 710 Operacje asowe Przetwarzanie Transak (+) księgowane są kodem GVC 055, dotychczas kod GVC 720 Operacje Transakcja kartą (+/) księgowane są kodem GVC 022 i kodem SWIFT TRF, dotychczas kod GVC 801 i kod SWIFT SC Operacje Depozyt terminowy () księgowane są kodem GVC 024 i kodem SWIFT TRF, dotychczas kod GVC 823 i kod SWIFT LDP Nie będą prezentowane następujące kody GVC 059, 750, 751, 752, 753, 754, 755, 756, 757 10
2. Informacje dodatkowe Kody transakcji SWIFT i GVC znajdują się w osobnym załączniku. W przypadku jakichkolwiek pytań związanych z formatem plików zleceń prosimy o kontakt: Hotline Pekao SA Tel. 0 801 362 274 Fax. +48 (12) 618 66 86 email: proffice@pekao.com.pl http://korporacje.pekao.com.pl 11