27
Payment Integration Bulk Cashier’s Order and Cheques Format Specifications Prepared by: Group Transaction Banking, Product Management Electronic Delivery Channels Date: Nov 2017

Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

  • Upload
    others

  • View
    8

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

Payment Integration Bulk Cashier’s Order and Cheques

Format Specifications

Prepared by: Group Transaction Banking, Product Management

Electronic Delivery Channels

Date: Nov 2017

Page 2: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 3: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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.

Page 4: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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.

Page 5: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 6: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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.

Page 7: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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.

Page 8: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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.

Page 9: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 10: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 11: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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.

Page 12: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 13: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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.

Page 14: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 15: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 16: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 17: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 18: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 19: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 20: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 21: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 22: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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.

Page 23: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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.

Page 24: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 25: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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

Page 26: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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.

Page 27: Payment Integration Bulk Cashier’s Order and Cheques ......Bulk CO-CHQ Format Specification Version 3.05 Page 5 of 27 2. Payment File Format (from Customer to UOB) Record Size :

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.