Payment Integration Bulk Cashier’s Order and Cheques
Format Specifications
Prepared by: Group Transaction Banking, Product Management
Electronic Delivery Channels
Date: Nov 2017
Contents
1. Introduction ..................................................................................................................................... 3
2. Payment File Format (from Customer to UOB) ........................................................................ 5
2.1 File Control Header ............................................................................................................... 6 2.2 Batch Header ......................................................................................................................... 6
2.3 Batch Details .......................................................................................................................... 7
2.4 Payment Advice format ........................................................................................................ 9 2.4.1. Payment Advice format (Free Format) ....................................................................... 9
2.4.2. Payment Advice format (Customized Format) .......................................................... 9 2.5 Batch Trailer ......................................................................................................................... 11
3. Fate File Format (from UOB to Customer) .............................................................................. 12 3.1 Batch Header ....................................................................................................................... 13 3.2 Batch Detail .......................................................................................................................... 13
3.3 Batch Trailer ......................................................................................................................... 13 4. Acknowledgment (Applicable to FTS/FileAct) ......................................................................... 14
4.1 Acknowledgement Types ................................................................................................... 14
4.2 File Submission and Acknowledgement Scenarios ....................................................... 14
4.3 Email Alert ............................................................................................................................ 15
5. CO/CHQ Status File/Report ....................................................................................................... 16 5.1 Batch Header ....................................................................................................................... 17
5.2 Batch Detail .......................................................................................................................... 17 5.3 Batch Trailer ......................................................................................................................... 17
5.4 Report Format ...................................................................................................................... 18 6. CO/CHQ Unpresented Status File/Report ............................................................................... 19
6.1 Batch Header ....................................................................................................................... 20
6.2 Batch Detail .......................................................................................................................... 20
6.3 Batch Trailer ......................................................................................................................... 20
6.4 Report Format ...................................................................................................................... 21
Appendix 1 Payment Advice (Free Format) .................................................................................... 22 Appendix 2 Payment Advice (Customized Format) ....................................................................... 25
Appendix 3 Value Date ....................................................................................................................... 26
Appendix 4 Validation for CO/CHQ file with Payment Advice ...................................................... 27
File Control Header Validation ...................................................................................................... 27
Batch Header Validation ................................................................................................................. 27 Batch Detail Validation ................................................................................................................... 27
Batch Trailer Validation .................................................................................................................. 27
Bulk CO-CHQ Format Specification Version 3.05 Page 3 of 27
1. Introduction This document describes the format and mapping definition for the fixed file format of Bulk Cashier’s Order (CO) / Cheques (CHQ). The bulk file can be uploaded through File Transfer Service (FTS), FileAct and BIBPlus. This information is intended for business users and IT departments that use this payment service.
Bulk CO-CHQ Format Specification Version 3.05 Page 4 of 27
LEGEND OF COLUMN
COLUMN NAME EXPLANATION
FIELD DESCRIPTION Indicates the field name.
TYPE
Text
- Left justified with trailing spaces - Alpha-numeric, numeric or characters
Numeric
- Right justified with leading zeros - 2 decimal places without decimal point - Example: 123.45 is presented as 000000000012345
POSITION Indicates the starting position of the field.
LENGTH Indicates the length of the field.
MANDATORY
“Y” indicates a mandatory field “N” indicates an optional field “C” indicates fields which are conditional i.e. mandatory only if certain conditions or other fields are used. Additional information is provided in the Remarks column.
REMARKS List the possible values, constraints, further explanations, etc.
Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27
2. Payment File Format (from Customer to UOB) Record Size : 900 File Structure : File Control Header (1 line) – refer to section 2.1 Batch Header (1 line) – refer to section 2.2 Batch Details (1 to multiple lines) – refer to section 2.3 Payment Advice (optional; multiple lines) – refer to section 2.4 Batch Trailer (1 line) – refer to section 2.5 File Naming : For FTS
File Name: UCPIddmmNN.txt
U UOB
CP CO/CHQ
I Incoming file from customer to bank
ddmm Date and month the file was created
NN Sequence Number, up to 99 payment files per day
Example: UCPI251001.TXT The above is a CO/CHQ payment file sequence number 01 created on the 25
th of October.
For FileAct
File Name: CC_UCPIddmmNN_BIC.txt
CC Country Code
U UOB
CP Telegraphic Payment
I Incoming file from customer to bank
ddmm Date and month the file was created
NN Sequence Number, up to 99 payment files per day
BIC Sender BIC (11 Characters)
Example: SG_UCPI251001_TELPSGS1XXX.txt The above is a CO/CHQ payment file sequence number 01 created on the 25
th of October.
For BIBPlus
Filename need not conform to the above naming convention Filename has to be unique and contain a file extension
Examples: COPayment1.txt, CHQPayment1.txt ……etc
Bulk CO-CHQ Format Specification Version 3.05 Page 6 of 27
2.1 File Control Header
# FIELD
DESCRIPTION TYPE POSITION LENGTH MANDATORY REMARKS
1 Record Type Text 1 1 Y Must be "0".
2 File Name Text 2 10 Y
Must match with filename excluding the “.txt” extension, examples: “UCPI251001” for FTS/FileAct “COPayment1” for BIBPlus
3 File Creation
Date Text 12 8 Y
CCYYMMDD
Must not be later than current date.
Must not be earlier than 30 days from current date.
4 File Creation
Time Text 20 6 Y HHMMSS
5 Company ID Text 26 12 C Mandatory for FTS/FileAct, capital letters only.
6 Check
Summary Numeric 38 15 Y
File check summary (i.e. hash total) for validating the file integrity.
Refer to Appendix 4 for the Hash Algorithm.
7 Company ID Text 53 12 C Mandatory for BIBPlus, this is to be provided by the bank.
8 Filler Text 65 836 N To fill with spaces.
2.2 Batch Header
# FIELD
DESCRIPTION TYPE POSITION LENGTH MANDATORY REMARKS
1 Record Type Text 1 1 Y Must be "1".
2 Batch Number Text 2 20 N For customer’s internal use to reference their bulk file.
3 Payment
Advice Header Line 1
Text 22 105 N Refer to Appendix 1 for Payment Advice.
4 Payment
Advice Header Line 2
Text 127 105 N Refer to Appendix 1 for Payment Advice.
5 Filler Text 232 669 N To fill with spaces.
Bulk CO-CHQ Format Specification Version 3.05 Page 7 of 27
2.3 Batch Details There should be at least one batch detail record.
# FIELD
DESCRIPTION TYPE POSITION LENGTH MANDATORY REMARKS
1 Record Type Text 1 1 Y Must be "2”.
2 Payment Type Text 2 3 Y “CO ” – Cashier’s Order
“CHQ” – Cheques
3 Payment Currency
Text 5 3 Y For CO must be “SGD”
For CHQ must be “SGD” or “USD”
4 Payment Amount Numeric 8 15 Y
5 Value Date Text 23 8 Y
CCYYMMDD
Refer to Appendix 3 for Value Date
6 Beneficiary Name
(Line 1) Text 31 35 Y
7 Beneficiary Name
(Line 2) Text 66 35 N
8 Beneficiary Name
(Line 3) Text 101 35 N
9 Beneficiary
Address (Line 1) Text 136 35 C
Mandatory if Mail to Party is “BEN”
Refer to Appendix 1 for Payment Advice.
10 Beneficiary
Address (Line 2) Text 171 35 N
11 Beneficiary
Address (Line 3) Text 206 35 N
12 Beneficiary Postal Code
Text 241 15 N For printing of Singapore Postal Bar
Code use only
Must be 6 digits format, i.e. 123456
13 Beneficiary
Country Code Text 256 3 N
For local address & printing of Singapore Postal Code, use “SG “
14 Filler Text 259 6 N To fill with spaces.
15 Settlement A/C
No. Numeric 265 20 Y
Debiting A/C no, numeric only no ‘dash’.
Right-justified with leading zeros.
e.g. “00000000001013459872”
16 Settlement Currency
Text 285 3 Y For CO must be in ‘SGD’
For CHQ must be same as payment currency
17 Handling Option Text 288 1 Y
“M” – Mail it
“C” – hold for customer’s collection at processing centre
“A” – Courier To customer.
Bulk CO-CHQ Format Specification Version 3.05 Page 8 of 27
# FIELD
DESCRIPTION TYPE POSITION LENGTH MANDATORY REMARKS
18 Mail To Party Text 289 3 C
Mandatory If Handling Option is “M”.
“BEN” – Beneficiary (refer to Beneficiary Name and Address)
“OTH” – Others (refer to Mailing Name and Address)
19 Mailing Name and Address
(Line 1) Text 292 35 C
Mandatory if Mail to Party is “OTH”
Refer to Appendix 1 for Payment Advice.
20 Mailing Name and Address
(Line 2) Text 327 35 N
21 Mailing Name and Address
(Line 3) Text 362 35 N
22 Mailing Name and Address
(Line 4) Text 397 35 N
23 Mailing Postal
Code Text 432 15 N
For printing of Singapore Postal Bar Code use only
Left-justified with trailing spaces.
Must be 6 digits format, i.e. 123456
24 Mailing Country
Code Text 447 3 N
For local address and printing of Singapore Postal Code, use “SG “
25 Filler Text 450 50 N To fill with spaces.
26 Print Payment
Advice Indicator Text 500 1 N To fill with spaces.
27 Print Mode Text 501 1 Y Default to “P”
28 Beneficiary ID Text 502 20 N
Beneficiary ID (Decided by Customer)
For CO, refer to NRIC/UEN(Unique Entity Number) to be printed on Cashier’s Order below Beneficiary Name.
Refer to Appendix 1 for Payment Advice.
29 Print Advice Instruction
Text 522 1 C For CO, filled with space.
For CHQ, default to “1”
30 Filler Text 523 198 N To fill with spaces.
31 Payer’s name
(line 1) Text 721 35 N
Refer to Appendix 1 for Payment Advice.
32 Payer’s name
(line 2) Text 756 35 N
Refer to Appendix 1 for Payment Advice.
33 Payer’s reference
number Text 791 30 N
Refer to Appendix 1 for Payment Advice.
34 Email Address of
Beneficiary Text 821 50 N To fill with spaces.
35 Facsimile Number of Beneficiary
Text 871 20 N To fill with spaces.
36 Filler Text 891 10 N To fill with spaces.
Bulk CO-CHQ Format Specification Version 3.05 Page 9 of 27
2.4 Payment Advice format
2.4.1. Payment Advice format (Free Format)
# FIELD
DESCRIPTION TYPE
POSITION
LENGTH MANDATORY REMARKS
1 Record Type Text 1 1 Y Must be "4".
2 Spacing Lines Text 2 2 Y
Indicate how many spacing lines to be printed before this advice line.
Value 00 to 30 only, any values greater than 30 is default to 30
3 Payment Advice
Details Text 4 105 Y
Refer to Appendix 1 for Payment Advice.
4 Filler Text 109 792 N To fill with spaces.
Optional; do not populate this record if no payment advice is required.
2.4.2. Payment Advice format (Customized Format)
# FIELD
DESCRIPTION TYPE
POSITION
LENGTH MANDATORY REMARKS
1 Record Type Code 1 1 Y Must be "8".
2 Filler Text 2 2 N To fill with spaces
3 Field 01 Text 4 15 Y Left Justified Printing
4 Field 02 Text 19 15 N Left Justified Printing
5 Field 03 Text 34 50 N Left Justified Printing
6 Field 04 Text 84 50 N Left Justified Printing
7 Field 05 Text 134 80 N Left Justified Printing
8 Field 06 Text 214 80 N Left Justified Printing
9 Field 07 Date 294 8 N
Data to be formatted as YYYYMMDD Printing will be in DD/MM/YYYY format
10 Field 08 Date 302 8 N
Data to be formatted as YYYYMMDD Printing will be in DD/MM/YYYY format
11 Field 09 Amount
(3 decimal) 310 6 N
Data to be formatted in numeric with leading zeros e.g. 345678 and printing will be 345.678 With leading zeroes suppressed. ZZ9.999
Bulk CO-CHQ Format Specification Version 3.05 Page 10 of 27
# FIELD
DESCRIPTION TYPE
POSITION
LENGTH MANDATORY REMARKS
12 Field 10 Amount
(5 decimal)
316 10 N
Data to be formatted in numeric with leading zeros e.g. 0034567890 and printing will be 345.67890 with leading zeroes suppressed. ZZZZ9.99999
13 Field 11 Amount
(2 decimal)
326 10 N
Data to be formatted in numeric with leading zeros e.g. 0003456789 and printing will be 34,567.89 with leading zeroes suppressed. ZZ,ZZZ,ZZ9.99
14 Field 12 Amount
(2 decimal)
336 10 N
Data to be formatted in numeric with leading zeros e.g. 0003456789 and printing will be 34,567.89 with leading zeroes suppressed. ZZ,ZZZ,ZZ9.99
15 Field 13
Amount (no
decimal)
346 11 N
Data to be formatted in numeric with leading zeros e.g. 00000123456 and printing will be 123,456 with leading zeroes suppressed. ZZ,ZZZ,ZZZ,ZZ9
16 Field 14
Amount (no
decimal)
357 11 N
Data to be formatted in numeric with leading zeros e.g. 00000123456 and printing will be 123,456 with leading zeroes suppressed. ZZ,ZZZ,ZZZ,ZZ9
17 Field 15 Amount
(2 decimal)
368 13 N
Data to be formatted in numeric with leading zeros e.g. 0000012345678 and printing will be 123,456.78 with leading zeroes suppressed. ZZ,ZZZ,ZZZ,ZZ9.99
18 Field 16 Amount
(2 decimal)
381 13 N
Data to be formatted in numeric with leading zeros e.g. 0000012345678 and printing will be 123,456.78 with leading zeroes suppressed. ZZ,ZZZ,ZZZ,ZZ9.99
Bulk CO-CHQ Format Specification Version 3.05 Page 11 of 27
# FIELD
DESCRIPTION TYPE
POSITION
LENGTH MANDATORY REMARKS
19 Field 17 Text 394 13 N Right Justified Printing (for Horizontal format)
20 Field 18 Text 407 13 N Right Justified Printing (for Horizontal format)
21 Field 19 Text 420 18 N Right Justified Printing (for Horizontal format)
22 Field 20 Text 438 18 N Right Justified Printing (for Horizontal format)
23
Filler Text 456 445 N To fill with spaces.
Note: For each payment file, both Record Type 8 (Customized Beneficiary Advice) and Record Type 4 (Free Format Beneficiary Advice) cannot co-exist. 2.5 Batch Trailer Total number of transactions and payment amounts in Batch Detail must tally with the trailer counts.
# FIELD
DESCRIPTION TYPE POSITION LENGTH MANDATORY REMARKS
1 Record Type Text 1 1 Y Must be "9".
2 Total Number of
Transactions Numeric 2 8 Y
Total number of transactions in record type “2”.
3 Total Payment
Amount Numeric 10 15 Y
Total of the payment amounts in record type “2”.
4 Filler Text 25 876 N To fill with spaces.
Bulk CO-CHQ Format Specification Version 3.05 Page 12 of 27
3. Fate File Format (from UOB to Customer)
Record Size : 400 File Structure : Batch Header (1 line) – refer to section 3.1 Batch Details (1 to multiple lines) – refer to section 3.2 Batch Trailer (1 line) – refer to section 3.3 File Naming : For FTS
File Name: UCPOddmmNN_uuuuu
U UOB
CP CO/CHQ
O Outgoing file from customer to bank
ddmm Date and month the file was created
NN Sequence Number, up to 99 payment files per day
uuuuu Folder Name
For FileAct
File Name: CC_UCPOddmmNN.txt
CC Country Code
U UOB
CP Telegraphic Payment
O Outgoing file from customer to bank
ddmm Date and month the file was created
NN Sequence Number, up to 99 payment files per day
For BIBPlus
File Name: UCMOxxxxxxxxxxxxxx
U UOB
CM CO/CHQ
O Outgoing file from customer to bank
xxxxxxxxxxxxxx 14-digit BIBPlus reference number
Bulk CO-CHQ Format Specification Version 3.05 Page 13 of 27
3.1 Batch Header
# FIELD DESCRIPTION TYPE POSITION LENGTH REMARKS
1 Record Type Text 1 1 Must be "1".
2 Batch number Text 2 20 Same as incoming file
3 File Name Text 22 10 Same as incoming file
4 File Creation Date Text 32 8
5 File Creation Time Text 40 6
6 Company ID Text 46 12 Same as incoming file
7 Filler Text 58 343 Spaces.
3.2 Batch Detail
# FIELD DESCRIPTION TYPE POSITION LENGTH REMARKS
1 Record Type Text 1 1 Must be “2”.
2 Payment Type Text 2 3 Same as incoming file.
3 Payment Currency Text 5 3 Same as incoming file.
4 Payment Amount Numeric 8 15 Same as incoming file.
5 Value Date Text 23 8 Same as incoming file.
6 Beneficiary Name
(Line 1) Text 31 35 Same as incoming file.
7 Beneficiary Name
(Line 2) Text 66 35 Same as incoming file.
8 Beneficiary Name
(Line 3) Text 101 35 Same as incoming file.
9 Settlement Currency Text 136 3 Same as incoming file.
10 Settlement Amount Numeric 139 15 Total debiting amount including charges.
11 Commission Charge Numeric 154 15 Bank charges including commission
12 Bank Reference No. Text 169 20 CO/CHQ number
13 Imprest A/C No. Numeric 189 20 Applicable to CHQ only
14 Process Status Text 209 2 “0” – Processed successfully “1” – Rejected
15 Process Remarks Text 211 50 Rejection reason.
16 Payment Advice Printed Indicator
Text 261 1 “Y” – printed “N” – not printed due to some errors
17 Reason of not printed Text 262 50 Reason of advice not printed 18 Payer’s Reference No. Text 312 30 Same as incoming file. 19 Beneficiary ID Text 342 20 Same as incoming file.
20 Filler Text 362 39 Spaces.
3.3 Batch Trailer
# FIELD DESCRIPTION TYPE POSITION LENGTH REMARKS
1 Record Type Text 1 1 Must be “9”.
2 Total Number of
Successful Transactions Numeric 2 8
Total number of successfully processed detail records in the file.
3 Total Debiting Amount Numeric 10 15 Total debiting amount including charges in 2 decimal places.
4 Total Number of
Rejected Transactions Numeric 25 8
Total number of rejected detail records in the file.
5 Total Payment Amount
of Rejected Transactions Numeric 33 15
Total payment amount of rejected transactions regardless of payment currency in 2 decimal places.
6 Filler Text 48 353 Spaces.
Bulk CO-CHQ Format Specification Version 3.05 Page 14 of 27
4. Acknowledgment (Applicable to FTS/FileAct)
Customers sending payment files via BIBPlus may ignore this section. 4.1 Acknowledgement Types When customers send payment file via FTS/FileAct, they will receive acknowledgement with regards to the status of the file submission. The table below shows 4 types of acknowledgement from the bank.
ACK TYPE
RESPONSE TIME
ACK FILE NAMING ACK FILE CONTENT
FTS FILEACT
File Received
Within 10 mins from file submission
UCPIddmmNN SG_UCPIddmmNN_TELSGS1XXX 1201,UCPI011201 has
been received
File Accepted
UCPIddmmNN_ACC SG_UCPIddmmNN_ACC 1201,UCPI011201 has
been accepted
File Rejected
UCPIddmmNN_REJ SG_UCPIddmmNN_REJ 1201,UCPI011201,Rec
#:,1,Invalid company ID in control record
File Duplicated
UCPIddmmNN_DUP SG_UCPIddmmNN_DUP 1201,UCPI011201,Rec
#:,1,Duplicate file
With reference to the Ack. File Naming column in the table above, additional file extension will be appended depending on the encrypted software used, e.g. PGP encryption will have the file extension of “.pgp”. With reference to the Ack. File Content column in the table above, the acknowledgement file has a fixed record size of 80 characters and will be in the format of “MMDD,Filename,Message<spaces>” where:
MMDD – file creation month and day
Filename – Payment filename
Message – acknowledgement or rejection messages 4.2 File Submission and Acknowledgement Scenarios The 3 scenarios below depict the types of acknowledgement UOB will send upon receiving your payment file via FTS. Do inform your UOB contact immediately if the acknowledgement files are not returned within the expected response time given in section 4.1.
Scenario 1: Payment File is received and accepted Scenario 2: Payment File is received and rejected
Customer
UOB
UCPI010201.TXT.pgp
UCPI010201.pgp
UCPI010201_ACC.pgp
Customer
UOB
UCPI010201.TXT.pgp
UCPI010201.pgp
UCPI010201_REJ.pgp
Bulk CO-CHQ Format Specification Version 3.05 Page 15 of 27
Scenario 3: Payment File is received and rejected due to duplication
customer uploaded payment file to UOB UOB acknowledged payment file
4.3 Email Alert Customers can also request to receive these acknowledgements via email alerts. Please liaise with your UOB contact if this is required.
Customer
UOB
UCPI010201.TXT.pgp
UCPI010201.pgp
UCPI010201_DUP.pgp
Bulk CO-CHQ Format Specification Version 3.05 Page 16 of 27
5. CO/CHQ Status File/Report
The file/report contains the daily status update of each of the Cheques or Cashier’s Order sent to UOB for issuance.
Frequency : Daily Record Size : 192 File Structure : Batch Header (1 line) – refer to section 5.1 Batch Details (1 to multiple lines) – refer to section 5.2 Batch Trailer (1 line) – refer to section 5.3 File Naming : For FTS/FileAct
File Name: CSF_nnnnnnnnnn_ddmmyy.txt or CSR_nnnnnnnnnn_ddmmyy.txt
C UOB Code
S CO/CHQ
F R
File Report
nnnnnnnnnn Debiting/Settlement Account Number
ddmmyy Date of status
File Naming : For BIBPlus
File Name: report.txt
Bulk CO-CHQ Format Specification Version 3.05 Page 17 of 27
5.1 Batch Header
# FIELD DESCRIPTION TYPE POSITIO
N LENGTH REMARKS
1 Record Type Text 1 1 Must be "1".
2 File Creation Date Text 2 8
3 File Creation Time Text 10 6
4 Company Name Text 16 40 Registered company name
5 Account Number Numeric 56 19 Settlement Account Number
6 Transaction Date Text 75 8
7 Filler Text 83 110 Spaces
5.2 Batch Detail
# FIELD DESCRIPTION TYPE POSITION LENGTH REMARKS
1 Record Type Text 1 1 Must be “2”
2 Service Type Text 2 3 “CO ” – Cashier’s Order
“CHQ” – Cheques 3 Currency Code Text 5 3 CO/CHQ Currency
4 Issuing A/C Number Numeric 8 19 For CHQ, Imprest A/C number
For CO, GL Account
5 CO/Cheque Number Text 27 6 Bank generated number
6 CO/Cheque Amount Numeric 33 13
7 Value Date Text 46 8
8 Beneficiary Name
Line1 Text 54 35
From incoming file
9 Beneficiary ID Text 89 20 From incoming file
10 Payer’s Reference
Number Text 109 30 From incoming file
11 Status Text 139 1
CHQ I – Issued S – Stopped X – Expired P – Presented R - Returned CO I – Issued S – Stopped X – Expired P – Presented R - Refunded
12 Filler Text 140 53 Spaces
5.3 Batch Trailer
# FIELD DESCRIPTION TYPE POSITION LENGTH REMARKS
1 Record Type Text 1 1 Must be “9”.
2 Total record count Numeric 2 9 Total number of CO/CHQ items
3 Total CO/CHQ amount Numeric 11 15 Total amount of CO/CHQ
4 Filler Text 26 167 Spaces
Bulk CO-CHQ Format Specification Version 3.05 Page 18 of 27
5.4 Report Format
REPORT ITEMS REMARKS
Report Date Date of Report
Customer Name Registered company name.
Account Number Settlement Account number
Transaction Date Date of Transaction
Service Type “CO” for Cashier Order.
“CHQ” for Cheque
Currency Code CO/CHQ Currency Issuing A/C Number Imprest A/C number or GL Account (Cashier Order)
CO/Cheque Number Bank generated number
CO/Cheque Amount CO/CHQ Amount
Value Date Value Date
Beneficiary Name Line 1 From incoming file
Beneficiary ID From incoming file
Payer’s Reference Number From incoming file
Status
CHQ I – Issued
S – Stopped X – Expired
P – Presented R –Returned
CO
I – Issued S – Stopped X – Expired
P – Presented R – Refunded
Total Record Count Total number of CO/CHQ items
Total CO/Cheque Amount Total amount of CO/CHQ
Bulk CO-CHQ Format Specification Version 3.05 Page 19 of 27
6. CO/CHQ Unpresented Status File/Report
The file/report contains the update of all unpresented Cheques or Cashier’s Order sent to UOB for issuance.
Frequency : Monthly (default) or Daily Record Size : 192 File Structure : Batch Header (1 line) – refer to section 6.1 Batch Details (1 to multiple lines) – refer to section 6.2 Batch Trailer (1 line) – refer to section 6.3 File Naming : For FTS/FileAct
File Name: CUF_nnnnnnnnnn_ddmmyy.txt or CUR_nnnnnnnnnn_ddmmyy.txt
C UOB Code
U Unpresented CO/CHQ
F R
File Report
nnnnnnnnnn Debiting/Settlement Account Number
ddmmyy Date of status
File Naming : For BIBPlus
File Name: report.txt
Bulk CO-CHQ Format Specification Version 3.05 Page 20 of 27
6.1 Batch Header
# FIELD DESCRIPTION TYPE POSITION LENGTH REMARKS
1 Record Type Text 1 1 Must be "1".
2 File Creation Date Text 2 8 YYYYMMDD
3 File Creation Time Text 10 6 HHMMSS
4 Company Name Text 16 40 Registered company name
5 Account Number Numeric 56 19 Settlement Account Number
6 Transaction Date Text 75 8 YYYYMMDD
7 Filler Text 83 110 Spaces
6.2 Batch Detail
# FIELD DESCRIPTION TYPE POSITION LENGTH REMARKS
1 Record Type Text 1 1 Must be “2”
2 Service Type Text 2 3 “CO” – Cashier’s Order
“CHQ” – Cheques 3 Currency Code Text 5 3 CO/CHQ Currency
4 Issuing A/C Number Numeric 8 19 For CHQ, Imprest A/C number
For CO, GL Account 5 CO/Cheque Number Text 27 6 Bank generated number
6 CO/Cheque Amount Numeric 33 13
7 Value Date Text 46 8
8 Beneficiary Name Line 1 Text 54 35 From incoming file
9 Beneficiary ID Text 89 20 From incoming file
10 Payer’s Reference
Number Text 109 30 From incoming file
11 No. of Calendar Days
Unpresented Text 139 3
No. of days unpresented (from date of issuance)
12 Filler Text 142 51 Spaces 6.3 Batch Trailer
# FIELD DESCRIPTION TYPE POSITION LENGTH REMARKS
1 Record Type Text 1 1 Must be “9”.
2 Total Unpresented
Record Count Numeric 2 9 Total number of unpresented CO/CHQ items
3 Total CO/CHQ
Unpresented Amount Numeric 11 15 Total amount of unpresented CO/CHQ
4 Filler Text 26 167 Spaces
Bulk CO-CHQ Format Specification Version 3.05 Page 21 of 27
6.4 Report Format
REPORT ITEMS REMARKS
Report Date Date of Report
Customer Name Registered company name.
Account Number Settlement Account number
Transaction Date Date of Transaction
Service Type “CO” for Cashier Order.
“CHQ” for Cheque
Currency Code CO/CHQ Currency Issuing A/c Number Imprest A/C number or GL Account (Cashier Order)
CO/Cheque Number Bank generated number
CO/Cheque Amount CO/CHQ Amount
Value Date Value Date
Beneficiary Name Line1 Beneficiary Name Line 1 from incoming file
Beneficiary ID Beneficiary ID from incoming file
Payer’s Reference Number Payer’s reference number from incoming file
No. of calendar days unpresented No. of days unpresented (from date of issuance)
Total unpresented record count Total number of unpresented CO/CHQ items
Total unpresented CO/Cheque amount Total amount of unpresented CO/CHQ
Bulk CO-CHQ Format Specification Version 3.05 Page 22 of 27
Appendix 1 Payment Advice (Free Format) Hardcopy of Payment Advice is printed and mailed to the Beneficiary. Below table describes the print areas of the payment advice.
PRINT AREA DESCRIPTION PAYMENT FILE MAPPING
Top Left Area
For Mail-to-Party = ‘BEN’ Beneficiary Name & Address Line (6 lines)
Section 2.3 field 6 – Beneficiary Name (Line 1) Section 2.3 field 7 – Beneficiary Name (Line 2) Section 2.3 field 8 – Beneficiary Name (Line 3) Section 2.3 field 9 – Beneficiary Address (Line 1) Section 2.3 field 10 – Beneficiary Address (Line 2) Section 2.3 field 11 – Beneficiary Address (Line 3)
For Mail-to-Party = ‘OTH’ Mailing Name & Address Line (4 lines)
Section 2.3 field 19 – Mailing Name and Address (Line 1) Section 2.3 field 20 – Mailing Name and Address (Line 2) Section 2.3 field 21 – Mailing Name and Address (Line 3) Section 2.3 field 22 – Mailing Name and Address (Line 4)
Top Right Area
CASHIER’S ORDER PAYMENT PARTICULARS
Date Section 2.3 field 5 – Value Date in DD/MM/YYYY
Cashier’s Order Generated by the bank
Amount Section 2.3 field 3 – Payment Currency Section 2.3 field 4 – Payment Amount (masked by the bank except the last 3 digits)
Payer’s Name Section 2.3 field 31 – Payer’s name (line 1) Section 2.3 field 32 – Payer’s name (line 2)
Reference No Section 2.3 field 33 – Payer’s reference number
Beneficiary ID Section 2.3 field 28 – Beneficiary ID
CHEQUE PAYMENT PARTICULARS
Date Section 2.3 field 5 – Value Date in DD/MM/YYYY
Cheque Number Generated by the bank
Amount Section 2.3 field 3 – Payment Currency Section 2.3 field 4 – Payment Amount (masked by the bank except the last 3 digits)
Payer’s Name Section 2.3 field 31 – Payer’s name (line 1) Section 2.3 field 32 – Payer’s name (line 2)
Reference No Section 2.3 field 33 – Payer’s reference number
Beneficiary ID Section 2.3 field 28 – Beneficiary ID
Center Area
FIXED TEXT
- The payment advice details are similar for each different printed CO or CHQ. - The fixed text is provided by the customer to be setup by the bank during implementation. - Payment Advice details are not required to be provided in the payment file. - Contact CFS-Implementation Advisor for this setup procedure.
Bulk CO-CHQ Format Specification Version 3.05 Page 23 of 27
PRINT AREA DESCRIPTION PAYMENT FILE MAPPING
FREE TEXT
- Up to 99 pages of Payment Advice can be printed for each payment - For cheques requiring mailing, every 5 pages will be inserted into a separate envelope.
Payment Advice Header (only 2 lines of 105 characters each is allowed)
# Header Lines are optional # This can be used as Header printing at the beginning of each Page # The “header line” if required, is to be provided in the file format under Batch Header Record Type “1” Section 2.2 field 3 – Payment Advice Header Line 1 Section 2.2 field 4 – Payment Advice Header Line 2
Payment Advice Details (multiple lines)
# The “advice details” is to be provided in the file format under Batch Detail Record Type “4” # Each detail line” can consist up to of 105 characters each # A line skip indicator ( value 00 to 30 ) is used to control the spacing between each detail line # Maximum lines that can be printed on First Page ( with the cheque ) are 2 Header Lines & 37 Detail Lines # Maximum lines that can be printed on subsequent Pages is 2 Header Lines & 76 Detail Lines Section 2.4 field 3 – Payment Advice Details - All details will be printed using font “courier” size 8 - Note that there is a maximum file size for each uploaded file.
Please contact your Implementation Officer for more information or clarification.
- Refer to the Next Page for examples of Free Text Payment Advice
Bottom Area (Last Page)
Disclaimer Bank provides this on the last page of the payment advice.
Bulk CO-CHQ Format Specification Version 3.05 Page 24 of 27
Example (1) of Free Text Payment Advice (with Header Lines) S/NO REFERENCE ITEM QUANTITY AMOUNT
DATE UNIT PRICE
1 A-001 HARDDISK 4GB 40 $10,000.00
14/07/2004 250.00
2 B-002 KEYBOARD 101 20 $3,600.00
24/07/2004 180.00
3 C-003 MONITOR COLOR 10 $2,300.00
18/08/2004 230.00
Rec
Type
Payment Advice Header / Details Lines Space
Line
1 S/NO REFERENCE ITEM QUANTITY AMOUNT
1 DATE UNIT PRICE
4 1 A-001 HARDDISK 4GB 40 $10,000.00 01
4 14/07/2004 250.00 00
4 2 B-002 KEYBOARD 101 20 $3,600.00 01
4 24/07/2004 180.00 00
4 3 C-003 MONITOR COLOR 10 $2,300.00 01
4 18/08/2004 230.00 00
Example (2) of Free Text Payment Advice (without Header Lines)
This Cheque is issued in settlement of the following:
Contract Number : 024239/GKG
Account Number : 0120919341
Description : ABC CO. LTD
No. of Units : 1000
Selling Price : 0.15
GST : 7.50
Settlement Amount : 142.50
Rec
Type
Payment Advice Header / Details Lines Space
Line
1
1
4 This Cheque is issued in settlement of the following : 01
4 Contract Number : 024239/GKG 01
4 Account Number : 0120919341 01
4 Description : ABC CO. LTD 01
4 No. of Units : 1000 01
4 Selling Price : 0.15 01
4 GST : 7.50 01
4 Settlement Amount : 142.50 01
Bulk CO-CHQ Format Specification Version 3.05 Page 25 of 27
Appendix 2 Payment Advice (Customized Format)
1. Record Type 8 is used for Customized Beneficiary Advice 2. Setup is required at ROS for the necessary mapping of fields required for the printing 3. There can be one or more record type 8 detail line in a single cheque/cashier order payment record 4. For each payment file, there cannot be co-exist of both Record Type 8 (Customized Beneficiary Advice)
together with Record Type 4 (Free Format Beneficiary Advice)
Notes:
a) For Amount fields setup in ROS that is required for printing, the field must be numeric and not contain spaces, b) For Date fields setup in ROS that is required for printing, the field must be numeric and not contain spaces c) For Text Field 17 to Field 20, applicable for use with edited field e.g. $123,456.78 , d) For Vertical Format Printing,
- Customer can select up to total of 20 fields to be printed for each payment detail (record type 8) - Customer can select the sequence of the fields to be printed. - Field label will print from position 1 and maximum field length for label is 20 characters - customer can determine the starting position for each field to be printed - All fields will be Left Justified for printing.
e) For Horizontal Format Printing,
- Customer can select the required fields to be printed for each payment detail (record type 8) and maximum length must not exceed 105 characters per line
- Customer can select the sequence of the fields to be printed and the starting position of each field. - Maximum field length for each field label is 20 characters
Bulk CO-CHQ Format Specification Version 3.05 Page 26 of 27
Appendix 3 Value Date a) Value Date is the date of printing of the Cheques OR Cashier Orders. b) Value Date is the date printed on the Cheques OR Cashier Orders. c) Value Date is the date of processing where the Settlement Account will be debited d) Value Date cannot fall on a Saturday, Sunday or Public Holiday. e) Files must be submitted ONE working day before the Value Date f) Value Date can be post-dated up to a maximum of 30 calendar days.
Bulk CO-CHQ Format Specification Version 3.05 Page 27 of 27
Appendix 4 Validation for CO/CHQ file with Payment Advice File Control Header Validation
No. Validation Rule
1. First record must be control header record.
2. File name in control header must be same as the incoming file name
3. Company ID must match with the customer ID
4. Creation date cannot be later than current processing date
5. Creation date cannot be 30 calendar days earlier than current processing date
6. Duplicate file – customer cannot use the same file name more than once.
7. Check summary must be correct
Batch Header Validation
No. Validation Rule
1. The second record must be batch header record.
Batch Detail Validation
No. Validation Rule
1. There should be at least one detail record.
Batch Trailer Validation
No. Validation Rule
1. The last record must be trailer record.
2. Computed transaction count and total payment amount must tally with the trailer count and total payment amount.