FILE FORMAT OF PAYMENT ORDERS ACCEPTED BY CITIBANK EUROPE PLC FOR CITIBUSINESS DIRECT INTERNET BANKING FILE FORMAT OF PAYMENT ORDERS for Citibank Europe plc, organizační složka CitiBusiness Direct Internet Banking, version May 2014
File Format Files with commands for Citibank Europe plc processed using internet banking (IB) are created as ASCII comma delimited (comma separated fielads). All fields except ID and transaction amount are enclosed in quotation marks. Each command consists of one record (recording sentence) in the file. The last sentence of each file is given aggregate sentence. Maximum number of commands in a single file is 999. Each file can contain only one type of command of the following five options: - Domestic payment order - Domestic SDV payment order (express) - Foreign payment order - Foreign SDV payment order (express) - SEPA Recommended (not mandatory) file name logic should be TTT-XXXXXXXXXX-YYYYMMDD-SSS.txt where TTT - is LCY for domestic payment orders FCY for foreign payment orders SEP for SEPA XXXXXXXXXX 10 digits of your account number YYYYMMDD file creation date (format yyyymmdd) SSS serial number in the file creation date Txt extention to standard text files File name is the key to avoid duplicate file (Czech characters are not allowed). File name samples LCY-2599950318-20140402-001.txt - file created on Apr 2, 2014 consisting of LCY for acc 2599950318. It is the first file as of Apr 2, 2014. FCY-2599950406-20140412-005.txt - file created on Apr 12, 2014 consisting of FCY for acc 2599950406. It is the fifth file as of Apr 12, 2014. FILE FORMAT OF PAYMENT ORDERS for Citibank Europe plc, organizační složka CitiBusiness Direct Internet Banking, version May 2014
Domestic payment orders file format Field Field description Format Max. length Table of chars allowed Note 1 Transaction identifier (always 1 for LCY) Mandatory numeric 1 1 3 Debit account number Mandatory numeric 10 1 4 Customer reference Optional alphanumeric 10 4 5 Value date Mandatory date 8 1 DDMMYYY 6 Amount 1) Mandatory numeric 3 Y 7 Beneficiary account prefix Optional numeric 6 1 8 Beneficiary account number Mandatory numeric 10 1 9 Bank code Mandatory numeric 4 1 10 Constant symbol Optional numeric 4 1 11 Variable symbol Optional numeric 10 1 12 Specific symbol Optional numeric 10 1 13 Message to beneficiary (payment details) Optional alphanumeric 35 6 Summary 1 Transaction identifier (always 9 for Summary) Mandatory numeric 1 1 3 Total amount 1) Mandatory numeric 3 1) Amount must be always provided with two decimal places (e.g. 5000.00 or 500.45) Sample of import file with domestic payment orders 1,"001","2501234567","2040000765","29042014",30000.00,"","2671500267","0100","0008","0020040676","","KRIZ LADISLAV" 1,"002","2501234567","2040000981","29042014",50000.00,"","0420923389","0800","0008","0002004129","","BRUNI CARLA" 1,"003","2501234567","2040000607","29042014",112368.50,"","0650445271","0100","0008","1000004564","","NOVAK JAN" 1,"004","2501234567","2340000889","29042014",13242.00,"","0047443191","0100","0308","0000013304","","DODAVATEL" 1,"005","2501234567","2440000201","29042014",46707.50,"","2500020103","2600","0308","0111067504","","SPOJE " 1,"006","2501234567","2340001009","29042014",11662.00,"","9391320247","0100","0308","0000131991","","KOMUNIKACE" 1,"007","2501234567","2340001020","29042014",3145.17,"","9391320247","0100","0308","0000132449","","KOMUNIKACE" 1,"008","2501234567","2340001030","29042014",2380.00,"","9391320247","0100","0308","0000132389","","KOMUNIKACE" 1,"009","2501234567","2340000988","29042014",2981.00,"","0391742561","0100","0308","0000533804","","VYLISKY" 9,"010",272486.17
Foreign payment orders/sepa file format Field Field description Format Maximum Table of characters length allowed Note 1 Transaction identifier (3 for FCY, 4 for SEPA) Mandatory numeric 1 3 Debit account number Mandatory numeric 10 1 4 Customer reference Optional alphanumeric 10 4 5 Value date Mandatory datum 8 1 DDMMYYYY 6 Amount 1) Mandatory numeric 3 7 Currency code Mandatory letters 3 5 8 Beneficiary account number (incl. IBAN) Mandatory SWIFT 35 6 9 Beneficiary name and address 1 Mandatory SWIFT 35 6 10 Beneficiary name and address 2 Optional SWIFT 35 6 11 Beneficiary name and address 3 Optional SWIFT 35 6 12 Beneficiary name and address 4 Optional SWIFT 35 6 13 Beneficiary bank 1 (SWIFT code only) Mandatory SWIFT 35 6 14 Beneficiary bank 2 Optional SWIFT 35 6 Mandatory if field 13 (SWIFT) is empty. 15 Beneficiary bank 3 Optional SWIFT 35 6 Mandatory if field 13 (SWIFT) is empty. 16 Beneficiary bank 4 Optional SWIFT 35 6 17 Payment details 1 Optional SWIFT 35 6 18 Payment details 2 Optional SWIFT 35 6 19 Payment details 3 Optional SWIFT 35 6 20 Payment details 4 Optional SWIFT 35 6 21 Charges option Mandatory text 3 5 SHA/BEN/OUR 22 Advice code 2) Optional alphanumeric 1 1 23 Payment title Mandatory alphanumeric 7 7 Summary 1 Transaction identifier (always 9 for Summary) Mandatory numeric 1 1 3 Total amount 1) Mandatory numeric 3 1) Amount must be always provided with two decimal places (e.g. 5000.00 or 500.45) 2) 1 no advice, 2 by phone, 3 by telex
Sample of import file with foreign payment orders 3,"001","2501234576","","29042014",1930.00,"EUR","994404-940233015","SPOLECNOST","ULICE 1","MESTO",,"GIBACZPX","CESKA SPORITELNA","MESTO","CZ","40304009","","","","SHA","1","122RCZ5" 3,"002","2501234576","","29042014",1354.00,"EUR"," CZ5255000000001014030387","SPOLECNOST","ULICE 2","MESTO","", "RZBCCZPP","RAIFFEISENBANK","","CZ","30204009","","","","SHA","1","122RCZ5" 3,"003","2501234576","","29042014",2547.00,"USD","1014030387","SPOLECNOST","ULICE 3","MESTO","CZ","","RAIFFEISENBANK A.S.","MESTO","CZ","20204009","","","","OUR","1","122RCZ5" 3,"004","2501234576","","29042014",71.00,"EUR","1920810","LEASINGOVA SPOL.","NAMESTI 1","PRAHA","","BACXCZPP", "UNICREDIT BANK CZECH REPUBLIC PRAHA","","CZ","1102168600","","","","SHA","1","122RCZ5" 9,"005",5902.00 Sample of import file with SEPA payment orders 4,"001","2501234576","","29042014",1930.00,"EUR","CZ0308000994404940233015","SPOLECNOST","ULICE 1","MESTO",,"GIBACZPX","CESKA SPORITELNA"," MESTO ","CZ","40304009","","","","SHA","1","122RCZ5" 4,"002","2501234576","","29042014",1354.00,"EUR","CZ5255000000001014030387","SPOLECNOST","ULICE 2","MESTO","","RZBCCZPP", "RAIFFEISENBANK ","","CZ","30204009","","","","SHA","1","122RCZ5" 4,"003","2501234576","","29042014",2547.00,"EUR","DE24760700120010140303","TESTER AG","HAUPTSTRASSE 5","BAMBERG", "DEUTSCHLAND","DEUTDEMM762","DEUTSCHE BANK AG","BAMBERG","DE","20204009","","","","SHA","1","122NDE5" 4,"004","2501234576","","29042014",71.00,"EUR","SK9911110000000001920810","LEASING POL.","NAMESTIE 1","BRATISLAVA","SLOVAKIA", "UNCRSKBX"," UNICREDIT BANK","","SK","1102168600","","","","SHA","1","122RSK5" 9,"005",5902.00 TABLE OF CHARACTERS ALLOWED Table 1 numbers only (0-9) Table 2 numbers (0-9), alphabet capital letters only (A - Z), Czech characters not allowed Table 3 numbers and decimal point Table 4 - numbers (0-9), alphabet capital letters only (A - Z), Czech characters not allowed Table 5 alphabet - capital letters only (A - Z), Czech characters not allowed Table 6 ABCDEFGHIJKLMNOPQRSTUVWXYZ.0123456789?-:/ <space> Czech characters not allowed Table 7 - numbers (0-9), alphabet capital letters only (A - Z), Czech characters not allowed
INITIAL INDIVIDUAL FIELDS DATA CHECK PERFORMED BY CITIBANK EUROPE PLC, ORGANIZAČNÍ SLOŽKA Two types of data checks are performed: 1. Format checks Any errors in the format check cause that the entire input file as a whole is excluded from processing. Each format checks are: 1.1 Uniform file name 1.2 The file contains data for that type of item 1.3 Input sequence of serial numbers of orders in the file is uninterrupted 1.4 All mandatory fields are listed 1.5 All fields do not exceed its maximum length 1.6 Debit account number validation 1.7 Figure in the summary (total amount of all payments in the file) corresponds to the calculated value 1.8 Check of split file into individual records and individual fields 1.9 Check of the maximum number of entries in the file 2. Logical checks Any errors in the logical checks cause that only entire payment order is excluded from processing. Various logic checks are as follows: 2.1 Modulo 11 (CZ clearing format) check at domestic account number (prefix and basic account number) 2.2 Valid numeric bank code (domestic payment orders) 2.3 Value date must be logically correct and equal or higher than current business date 2.4 Transaction amount must be higher than zero (caution: decimal separator is a dot) 2.5 All fields must only contain characters defined in Tables of characters allowed 2.6 Transaction amount must not exceed available balance on the account 2.7 Debit and credit account numbers must not be the same 2.8 Valid currency code (SWIFT format) for foreign payments and SEPA 2.9 Valid SWIFT in field 13 or full beneficiary bank address at least in fields 14 and 15 if field 13 is empty FILE FORMAT OF PAYMENT ORDERS for Citibank Europe plc, organizační složka CitiBusiness Direct Internet Banking, version May 2014