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
1
2
3
4
5
6
7
8
9
10
11
12
13
1
2
3
1)
Transaction identifier (always 1 for LCY)
Serial number
Debit account number
Customer reference
Value date
Amount1)
Beneficiary account prefix
Beneficiary account number
Bank code
Constant symbol
Variable symbol
Specific symbol
Message to beneficiary (payment details)
Summary
Transaction identifier (always 9 for Summary)
Serial number
Total amount1)
Mandatory
Mandatory
Mandatory
Optional
Mandatory
Mandatory
Optional
Mandatory
Mandatory
Optional
Optional
Optional
Optional
Format
numeric
numeric
numeric
alphanumeric
date
numeric
numeric
numeric
numeric
numeric
numeric
numeric
alphanumeric
Max. length
1
3
10
10
8
Mandatory
Mandatory
Mandatory
numeric
numeric
numeric
1
3
6
10
4
4
10
10
35
Table of chars allowed
1
1
1
4
1
3
1
1
1
1
1
1
6
1
1
3
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
Note
DDMMYYY
Y
Foreign payment orders/SEPA file format
Field
Field description
Format
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
1
2
3
1)
2)
Transaction identifier (3 for FCY, 4 for SEPA)
Serial number
Debit account number
Customer reference
Value date
Amount1)
Currency code
Beneficiary account number (incl. IBAN)
Beneficiary name and address 1
Beneficiary name and address 2
Beneficiary name and address 3
Beneficiary name and address 4
Beneficiary bank 1 (SWIFT code only)
Beneficiary bank 2
Beneficiary bank 3
Beneficiary bank 4
Payment details 1
Payment details 2
Payment details 3
Payment details 4
Charges option
Advice code2)
Payment title
Summary
Transaction identifier (always 9 for Summary)
Serial number
Total amount1)
Mandatory
Mandatory
Mandatory
Optional
Mandatory
Mandatory
Mandatory
Mandatory
Mandatory
Optional
Optional
Optional
Mandatory
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Mandatory
Optional
Mandatory
numeric
numeric
numeric
alphanumeric
datum
numeric
letters
SWIFT
SWIFT
SWIFT
SWIFT
SWIFT
SWIFT
SWIFT
SWIFT
SWIFT
SWIFT
SWIFT
SWIFT
SWIFT
text
alphanumeric
alphanumeric
Mandatory
Mandatory
Mandatory
numeric
numeric
numeric
Amount must be always provided with two decimal places (e.g. 5000.00 or 500.45)
1 – no advice, 2 – by phone, 3 – by telex
Maximum
length
3
10
10
8
3
35
35
35
35
35
35
35
35
35
35
35
35
35
3
1
7
1
3
Table of characters
Note
allowed
1
1
1
4
1
DDMMYYYY
3
5
6
6
6
6
6
6
6
Mandatory if field 13 (SWIFT) is empty.
Mandatory if field 13 (SWIFT) is empty.
6
6
6
6
6
6
5
SHA/BEN/OUR
1
7
1
1
3
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