FILES FORMATS USED IN ING ONLINE

Transcription

1 1 FILES FORMATS USED IN ING ONLINE Cash Management Sales Department, March

2 2 TABLE OF CONTENT: FILES FORMATS USED IN ING ONLINE PLI file format description MT 103 file format description Description of MT 940 ING Online Format

3 3 1. PLI file format description The structure of the PLI file is in accordance to ELIXIR-O file structure (Polish interbank transaction data exchange). Polish characters can be in formats: - ISO Windows Latin IBM 852 The name of PLI file can be any file name, but the extension should always be "TXT". The file PLI does not contain any header. More than one payment order record is allowed in the file. Each payment order starts with a transaction type number (110 = payment order, 220 = debit note). After each transaction record there is an end of line character <CR><LF> (code: 0D0A). Text fields are in inv. commas "". Inverted commas aren t count to length of field. Other fields to be taken in inv. commas are marked: in inv. commas. The fields are delimited with coma character (,). If a field consists of more than one line (within one field) - each line is delimited with character. (HEX 7C). Abbreviations in format description Type: mand. opt. = mandatory = optional Length/format: n = numeric (0-9), a = alphanumeric; content is in the brackets "" (Hex 22); if there is more lines there are characters (Hex 7C) between them. d = date, format: YYYYMMDD F = fixed length V = variable length The example of a transaction record in the PLI file (instead of spacebar there is _ character) with one payment: 110, ,403595, ,0," "," ","OR DERING_PARTY_NAME THE_REST_OF_ORD_PTY_NAME ORD_PTY_STREET WARSAW","CH ARLES_PARKER UL._ZIELONA_ _WARSZAWA",0, ,"DESCRIPTION_OF_A_PAYMENT_1 DESCRIPTION_OF_A_PAYM ENT_2","","","51" 3

4 4 Field description Type Length Example /format Transaction type: mand. 3 n F : payment order, 220: direct debit Payment execution date; mand. 8 d F RRRRMMDD format Amount in groszy (no comas) mand. 15 n V Ordering party's BSC (Bank Sorting Code) mand. 8 n V Not used; mand. 8 n V 0 value = "0" Ordering party account number; mand. 34 a V " " Beneficiary account number; mand. 34 a V " " Ordering party's name and address; mand. 4*35 a "ORDERING_PARTY_N each line is separated with ; in inv.commas V AME THE_REST_OF_O RD_PTY_NAME ORD_P TY_STREET WARSAW" Beneficiary's name and address; mand. 4*35 a "CHARLES_PARKER U each line is separated with ; in inv.commas V L._ZIELONA_ _WARSZAWA" Not used; value = 0 mand. 0 Beneficiary's BSC (Bank Sorting Code) always 8 mand. 8 n V digits (from 3rd to 10th of the 26-digits account number) Description of a payment order; mand. 4*35 an "DESCRIPTION_OF_A_ each line is separated with ; in inv.commas PAYMENT_1 DESCRIPT ION_OF_A_PAYMENT_ 2" Empty field (only inv.commas) mand. 3*2 a F "" Empty field (only inv.commas) mand. 3*2 a F "" "51" if transaction type = 110, mand. 8 a V "51" "01" if transaction type = 220 End of transaction record mand. <CR>< LF> 4

5 5 2. MT 103 file format description ING Online system offered by ING Bank uses MT 103 format for foreign currency and international payments. The name of PLI file can be any file name, but the extension should always be "TXT". Each MT 103 file contains a file header plus the data of payment orders (text blocks). Key to columns in the description of the records: No. / Name = No. and name of the field m / o = Value of the field m = mandatory o = optional Format = Length and format of the field a = alphanumeric field n = numeric field F = fixed number of characters V = Variable no. of characters The following convention applies: The delimiter before each field number, e.g. :01: is the character string <CR><LF> (ASCII ) for electronic file transfer payments. No. / Name m / o Format Description :01: opt. 16 a V File reference No. Reference :02: opt. 17 n V Check sum sum of all payment amounts Total amount from the :32A: field :03: opt. 5 n V Number of payment orders contained in the No. orders file :04: opt. 11 a V BSC the paying bank, Paying Bank :05: mand. 4* 35 a V Ordering party name and address Ordering party :06: opt. 8 a V Ordering party user no. at the paying bank. User no. :07: opt. 12 a V Name under which the file is stored on the File name hard disk; with INT extensions ; e.g. 123.INT *It should be possible to easily change BSC, following the changes of the Bank 5

6 6 Payment Orders No. / Name m / o Format Description :20: mand. 16 a V Reference no. Reference :32A: mand. 24 a V Order description Sub-field 1: Preferred execution date opt. 6 n F Date in format YYMMDD Sub-field 2: Currency mand. 3 a F ISO Currency Code Sub-field 3: Amount mand. 15 n V Amount with comma (,) as decimal sign :50: mand. 4*35 a V Name and address of Ordering party; account Ordering party :52A: mand. no. is inserted in field :52a: Sub-field 1. Ordering party bank Sub-field 1: Prefix 3 a F /C/ = Credit /D/ = Debit Account no. 34 a V Account no. in IBAN form with PL at the beginning Sub-field 2: SWIFT code 11 a V BSC of Ordering party bank :57A: Beneficiary Bank SWIFT Code mand. 11 a V Beneficiary Bank SWIFT Code :59: mand. Beneficiary Sub-field 1: Account no. 34 a V Account no. of Beneficiary Sub-field 2: Address of Beneficiary 4* 35 a V Name and address of Beneficiary :70: mand. 4* 35 a V Payment details 1 to 4 Payment details :71A: mand. 3 a F Fees settled by Fees BEN, OUR or SHA :72: mand./ 3*35 a If in :71A: is OUR or SHA in :72: must be Fees account opt. V account number for fees in IBAN form. Example: :01:245 :02: ,25 :03:3 :04: :05:TEST COMPANY POLAND SP. Z O.O. UL. POZIOMKOWA RZESZOW 6

7 7 :06: :07:INTZV.INT :20: :32A:060330PLN18216,00 :50:TEST COMPANY POLAND SP. Z O.O. UL. POZIOMKOWA RZESZOW :52A:/D/PL :57A:ABAMESM1 :59:/ES FRANZ HAAS WAFFELMASCHINEN 082 PRAGER STRASE 124 WIEN :70:INV CZESCI ZANIENNE :71A:OUR :72:PL :20:Z :32A:060330EUR25059,11 :50:TEST COMPANY POLAND SP. Z O.O. UL. POZIOMKOWA RZESZOW :52A:/D/PL :57A:INGBPLPW :59:/PL PIASTEN SCHOKOLADENFABRIK HOFMANN GMBH CO KG POSTFACH FORCHHEIM :70:INV CZEKOLADKI :71A:BEN :20:2 :32A:060330USD ,14 :50:TEST COMPANY POLAND SP. Z O.O. UL. POZIOMKOWA RZESZOW :52A:/D/PL :57A:INGBNL2A :59:/NL71ABNA TEST COMPANY SCHWEPPES 25 BERKELEY SQUARE LONDON W1X6HT :70:INTEREST ACCUED ON USD :71A:BEN If you can not get the bank SWIFT code from your beneficiary there is possible to fill the name and address of Beneficiary bank in payment order instead of SWIFT. Then the MT103 file should include the field :57D: instead of :57A:. Please find the example below. 7

8 8 No. / Name m / o Format Description :20: mand. 16 a V Reference no. Reference :32A: mand. 24 a V Order description Sub-field 1: Preferred execution date opt. 6 n F Date in format YYMMDD Sub-field 2: Currency mand. 3 a F ISO Currency Code Sub-field 3: Amount mand. 15 n V Amount with comma (,) as decimal sign :50: mand. 4*35 a V Name and address of Ordering party; account Ordering party :52A: mand. no. is inserted in field :52a: Sub-field 1. Ordering party bank Sub-field 1: Prefix 3 a F /C/ = Credit /D/ = Debit Account no. 34 a V Account no. in IBAN form with PL at the Sub-field 2: SWIFT code 11 a V beginning BSC of Ordering party bank :57D: Beneficiary bank mand. Address of Beneficiary 4* 35 a V Name and address of Beneficiary bank bank :59: mand. Beneficiary Sub-field 1: Account no. 34 a V Account no. of Beneficiary Sub-field 2: Address of Beneficiary 4* 35 a V Name and address of Beneficiary In 2 nd line beneficiary s bank country code, in brackets. :70: mand. 4* 35 a V Payment details 1 to 4 Payment details :71A: mand. 3 a F Fees settled by Fees BEN, OUR or SHA :72: mand./ 3*35 a If in :71A: is OUR or SHA in :72: must be Fees account opt. V account number for fees in IBAN form. Example: :01:245 :02:18216,00 :03:1 :04: :05:TEST COMPANY POLAND SP. Z O.O. UL. POZIOMKOWA 31 8

9 RZESZOW :06: :07:INTZV.INT :20: :32A:060330PLN18216,00 :50:TEST COMPANY POLAND SP. Z O.O. UL. POZIOMKOWA RZESZOW :52A:/D/PL :57D:CREDITANSTALT-BANKVEREIN ADDRESS 1 ADDRESS 2 :59:/ES FRANZ HAAS WAFFELMASCHINEN 082 (AT) PRAGER STRASE 124 WIEN :70:INV CZESCI ZANIENNE :71A:OUR :72:PL

10 10 3. Description of MT 940 ING Online Format Polish characters can be coded in formats: - ISO Windows Latin IBM 852 MT940 structure description Field No. / use Maximal Format Comments Example :20: 5 AN Fixed text: MT940 MT940 (starting record) <CR><LF>:25: 8/10 N /PL (account number) <CR><LF> 5 N Subsequent number in a :28C: (statement number) given calendar year :20:MT940 :25: /PL :28C: <CR><LF>Field :60F: (starting balance) Subfield Maximal Format Comments Example C or D (balance 1 A C credit balance C or D mark) D debit balance Booking date 6 N Date structure YYMMDD YY year, MM month, DD - day Currency 3 A ISO currency code PLN Amount of balance Max 15 N 1 to 15 numerical signs, ,45 including decimal separator (,) - comma :60F:C030616PLN ,45 <CR><LF>Field :61: (transaction line) Subfield Maximal Format Comments Example Value date 6 N Date structure YYMMDD YY year, MM month, DD - day Booking date 4 N Date structure MMDD 0616 MM month, DD - day C or D 1 A C credit C or D (transaction mark) D - debit Amount Max 15 N 1 to 15 numerical signs, ,45 including decimal separator comma (,) Operation code 4 AN S (fixed) + 3 digits of operation code (floating) or S076 lub SREJ 10

11 11 REJ in case of rejection Transaction N 11 numerical signs reference number Separator 2 A Separator // appears always when MARS number or rejection reason information is in the next field // MARS identification number <CR><LF> Exchange rate or reason for rejection 5-15 N Contracting party identification number (only for Clients using MARS service). 5 to 12 numerical signs Max 33 AN 1. At the beginning there is always word KURS, then after one space the FX rate is given. Decimal separator for FX rates is comma (,). The FX rate can be given with the precision of 6 decimal points. However, ING BSK uses only 4 decimal points. 2. Reason why the transaction was rejected :61: D ,45S // KURS 4, KURS 4,0567 or BLEDNE DANE DLA US <CR><LF> Field :86: (transaction s description) Subfield Maximal Format Comments Example Transaction code 3 N Transaction code from the field 076 :61: FX transactions 6 A A sign preceding an operation /OCMT/ sign amount (it refers to the transactions in which the transaction currency differs from the currency o f the account). Fixed text. Currency 3 A ISO currency code USD Operation amount 14 N Max 14 signs including ,89 decimal separator (,) comma. The transaction currency can be different from the currency o f the account. <CR><LF>:86: 4 AN Repetition of the field :86: :86: Transaction code 3 N Transaction code from the field 076 ~00 Transaction identification :61: 27 AN Field 00 must be preceded with ~ tilde. This separator precedes all of the numerical sub fields from the :86: field Operation code 4 AN Internal code given by the COCG bank Operation code 23 AN Detailed description of the PRZELEW description code ~20-25 Details 6x27 AN Payment details FAKTURA 1/F/03 FAKTURA 2/F/03 ~26-28 details continuation 3x27 AN Payment details continuation ~00 11

12 12 ~29 Beneficiary s account number ~30 Beneficiary s bank sorting code ~31 Beneficiary s account number ~32 Name of the contracting party ~33 Name of the contracting party ~34 Transaction code ~38 Contracting party full account number ~60 Transaction fee information ~61 Transaction exchange rate ~62-63 Contracting party (continuation) 26 N The field should be field in only when the account of the contracting party in the bank in Poland is in the NRB standard: 26 numerical signs (2 signs of a control number, 8 signs of the bank code, 16 signs of the account number) 8-12 AN Exactly 8 signs. In case of foreign banks (located outside Poland). The sorting code may be different than 8 signs (max. 12) Max 24 AN 1. Number of the contracting party s account recorded in NRB standard 16 signs long. 2. For the account s standard other than NRB max 24 signs AN 1st. line KONTRAHENT SP. Z O.O. 27 AN 2nd. line 3 N Transaction code from the field :61: 34 AN Number of bank account in IBAN: there is 2 sign country code preceding 26 signs account number. Max 27 AN The field is filled in optionally for chosen transactions. At the beginning of the field the following words are always used: OPŁATA ZA PRZELEW, then, after one space the fee amount is given. Max 27 AN Optional. At the beginning of the field always there s KURS word, then after one space the FX rate is given (the structure admits precision of up to 6 decimal points, but the bank uses only 4 of it). The separator is comma (,). 2x27 AN Contracting party additional data :86:076/OCMT/USD ,89 :86:076~00COCGPRZELEW ~20 FAKTURA 1/F/03 ~21 FAKTURA 2/F/03 ~23~24 ~25 ~ ~ ~ ~32 KONTRAHENT SP. Z O.O. ~33 ~34076 ~38 PL ~60OPŁATA ZA PRZELEW 5,00~61KURS 4, PL OPŁATA ZA PRZELEW 5,00 KURS 4,0567 Ul. GRZYBOWSKA WARSZAWA 12

13 13 ~62 Ul. GRZYBOWSKA 12 ~ WARSZAWA Pole :61: (transaction s line) it appears only with the first transaction from the specific day Subfield Maximal Format Comments Example Value date 6 N Date structure YYMMDD YY year, MM month, DD - day Booking date 4 N Date structure MMDD 0616 MM month, DD - day C 1 A C positive (fixed value) C Amount 4 N Fixed value 0,00 0,00 Operation code 4 AN S940 (fixed value) S940 Operation code 6 A NONREF (fixed value) NONREF description :61: C0,00S940NONREF <CR><LF>Pole :86: (account information) it appears only with the first transaction from the specific day Subfield Maximal Format Comments Example Operation code 3 N 940 (fixed value) 940 ~00 23 A Fixed text Informacje szczegółowe: Content of the ~00 4 AN Empty field subfield <CR><LF>:86: 4 AN Fixed value :86: (available and current balance) Operation code 3 N 940 (fixed value) 940 ~20 (available 12 AN Fixed text Saldo dost.: balance) Amount of the Max 15 AN Max 15 signs including ,82 balance decimal separator comma (,) and two last digits behind the separator ~21 (current 12 AN Fixed text Saldo bież.: balance) Amount of the balance Max 13 AN Max 13 signs including decimal separator comma (,) and two last digits behind the separator ,82 4 AN Fixed value :86: <CR><LF>:86: (blockades) Operation code 3 N 940 (fixed value) 940 ~22 (blockades 10 AN Fixed text Kw blokad: information) Amount of the Max 17 AN Max 17 signs including ,00 blockaded decimal separator comma (,) resources and two last digits behind the separator :61: C0,00S940NONREF :86:940~00Informacje szczegółowe: :86:940~20Saldo dost.: ,82~21saldo bież.: ,82 :86:940~22Kw blokad: ,00 13

14 14 <CR><LF> Field :62F: (ending balance) Subfield Maximal Format Comments Example Transaction mark 1 A C credit balance C or D D debit balance Booking date 6 N Date structure YYMMDD YY year, MM month, DD - day Currency 3 AN ISO standard currency PLN Amount Max 15 N Max 15 characters after ,00 which a comma (,) separator is given with two additional digits. :62F:C030616PLN ,00 <CR><LF> Field :64: (available balance) Subfield Maximal Format Comments Example Transaction mark 1 A C credit balance C or D D debit balance Booking date 6 N Date structure YYMMDD YY year, MM month, DD - day Currency 3 AN ISO standard currency PLN Amount Max 15 N Max 15 characters after ,00 which a separator is given (,) comma with two additional digits. :64:C030616PLN ,00 <CR><LF> Field :86: (account owner Id) Subfield Maximal Format Comments Example :NAME ACCOUNT OWNER:: 20 AN Fixed text :NAME ACCOUNT OWNER:: Account owner identification Max 35 AN Data from the PETROCHEMPL bank s system <CR><LF>:ACCOUNT DESCRIPTION: 21 AN Fixed text :ACCOUNT DESCRIPTION: Account type Max 35 AN Account CURRENT ACCOUNT description :86:NAME ACCOUNT OWNER:PETROCHEMPL ACCOUNT DESCRIPTION:CURRENT ACCOUNT All sections example for MT940: :20:MT940 :25:/PL :28C: :60F:C030616PLN ,45 :61: D ,45S KURS 4,0567 :86:076/OCMT/USD ,89 14

15 15 :86:076~00COCGPRZELEW ~20 FAKTURA 1/F/03 ~21 FAKTURA 2/F/03 ~23~24 ~25 ~ ~ ~ ~32 KONTRAHENT SP. Z O.O. ~33 ~34076 ~38 PL ~60OPŁATA ZA PRZELEW 5,00~61KURS 4,0567 ~62 Ul. GRZYBOWSKA 12 ~ WARSZAWA :61: C0,00S940NONREF :86:940~00Informacje szczegółowe: :86:940~20Saldo dost.: ,82~21saldo bież.: ,82 :86:940~22Kw blokad: ,00 :62F:C030616PLN ,00 :64:C030616PLN ,00 :86:NAME ACCOUNT OWNER:PETROCHEMPL ACCOUNT DESCRIPTION:CURRENT ACCOUNT 15

16 16 1. MT940 domestic-outgoing: :20:MT940 :25:/PL :28C:00129 :60F:C030122PLN100,00 :61: D1,20S :86:076 :86:076~00COCGPRZELEW ~20FAKTURA 17/F/03 ~21FAKTURA 18/F/03 ~23~24 ~25 ~ ~ ~ ~32NAZWA KONTRAHENTA ~33 ~34076 ~38PL ~62ULICA KONTRAHENTA ~63MIEJSCOWOSC KONTRAHENTA :62F:C030122PLN98,80 :64:C030122PLN98,80 :86:NAME ACCOUNT OWNER:JAN KOWALSKI ACCOUNT DESCRIPTION: CURRENT ACCOUNT 2. MT940 foreign-outgoing :20:MT940 :25:/PL :28C:00001 :60F:C030611PLN200000,00 :61: D375,80S KURS 3,7580 :86:025/OCMT/USD100,00 :86:025~00MI07OBC.RACH.BIEŻ.PŁ.I BZ-MIDAS ~20INV 200/03/F ~21~22 ~23~24 ~30CHASUS33 ~ ~32NAZWA KONTRAHENTA~33NAZWA KONTRAHENTA 2 ~34025 ~61KURS 3,7580 ~62DODATKOWE DANE KONTRAHENTA ~63DODATKOWE DANE KONTRAHENTA2 :62F:C030611PLN199900,00 :64:C030611PLN199900,00 :86:NAME ACCOUNT OWNER: FIRMAPL ACCOUNT DESCRIPTION: CURRENT ACCOUNT Additional information: A = alpha literal N = numeric AN = alphanumeric The first sign met after the code of an operation before the 00 field key becomes the separator of the structure of the fields 86. At present ING Bank Śląski makes use of ~ sign as a separator. 16