You are on page 1of 8

PayLink Cheque and GIRO Thailand

Standard Import Map Name: A GDFF CHQGIRO TH 02

Explanation: R/O/C/N – Required / Optional / Conditional / Not used (leave empty). Code(s) given below are product codes
from CitiDirect. Please refer to comment of field 1 for explanation.
Ref Field Name Format R/O/C/ Comments
No N

PLC
PTA
PTP
Transaction Record
1. Product Code 3X R R R Fixed values, one of the following.
PLC – PayLink Cheque
PTA – PayLink Autopay
PTP – PayLink Payroll
2. Debit Account Country Code 2X R R R Fixed value: TH
3. Debit Account Number 35X C C C Left justified. Specify without leading zero(s). Need to exist in
debit account library. If not provided the default debit account
number configured in Client Preference is used. The account
number should be starting with ‘5’.
4. Payment Currency 3X O O O If not provided, defaulted to THB.
5. Payment Amount 21N C C C Decimal point is optional.
The amount is calculated or verified as Payment Amount =
THB Invoice Amount (Ref no. 97)+ VAT Amount (Ref no.99) -
WHT Amount (Ref no. 100) - Beneficiary Charge (Ref no.
98).
6. Branch Code 3N N N N
7. Value Date 8X R R R May be current for forward date only, limited to 30 days in
advance. If not provided, defaulted to system date. If provided,
format must be YYYYMMDD.
8. Transaction Reference Number 15X C C C CitiDirect follows the Transaction Reference Number
assignment rules established in Client Preference.
If the Client set up in CitiDirect is "Full Auto" or "Prefix
Auto", the system will generate the transaction reference
number. Leave this field blank.
If a Transaction Reference Number is given, it will override
any system-generated number from "Full Auto" or
"Prefix Auto".
If the Client set up in CitiDirect is "Manual" the field is
mandatory.
Transaction Reference Number should be set to ‘Full Auto’ in
Client Preference. It is used as a unique identifier for the
transaction within CitiDirect. If given, any characters must be
uppercase.
9. Pre-format Group Code 16X O O O
10. Pre-format Code 35X O O O If specified, the code must exist in pre-format library.
If a pre-format code is used to make the payment, you need only
specify the following fields in addition to this code.
Product code (Field 2)
Debit account country code (Field 3)
Payment amount (Field 6)
Value date (Field 8)
11. Confidential Indicator 1X O O O Valid values are C for confidential and blank (‘ ‘) for not
confidential. If not specified, the transaction is treated as non-
confidential.
Transactions marked confidential can only be seen or processed
by users with entitlement to confidential payments.
12. Ordering Party [ID/Advice] Type 6X N N N
13. Ordering Party ID 34X O O O Define by Citibank
14. Ordering Party Name 35X R R R Needs to exist in Ordering Party Library. If not provided, default
ordering party configured in Client Preference is used.
Name must be in English.
15. Ordering Party Address 1 35X N N N Auto-populated from the Ordering Party Library.
16. Ordering Party Address 2 35X N N N Auto-populated from the Ordering Party Library.
17. Ordering Party Address 3 35X N N N Auto-populated from the Ordering Party Library.
18. Ordering Party Routing Method 35X N N N Auto-populated from the Ordering Party Library.
19. Ordering Party Routing Code 11X N N N Auto-populated from the Ordering Party Library.
20. Beneficiary Name 70X R R R Supports local language. Thai (CP874)
21. Beneficiary Address 1 35X N N N
22. Beneficiary Address 2 35X N N N

Page 1 of 8 Copyright© 2004 by Citibank N.A. All Rights Reserved.


EBBM Version 1.
Ref Field Name Format R/O/C/ Comments
No N

PLC
PTA
PTP
23. Beneficiary Address 3 35X N N N
24. Beneficiary Account or Other ID Type 6X N N N
25. Beneficiary Account Number [or 15X N R R Required for Giro payments (product codes PTA, PTP).
Other ID]
26. Beneficiary Reference 35X N N N
27. Beneficiary Bank Name 35X N N N
28. Beneficiary Bank Address 1 35X N N N
29. Beneficiary Bank Address 2 35X N N N
30. Beneficiary Bank Address 3 35X N N N
31. Beneficiary Bank Routing Method 35X N N N Internal: default to T2 for Giro, not applicable for cheque
32. Beneficiary Bank Routing Code 11X N R R Specify local bank code here.
33. Beneficiary Bank Account or Other ID 6X N N N
Type
34. Beneficiary Bank Account 34X N N N
35. Beneficiary Bank Advice Type 10X N N N
36. Payment Details, Line 1 35X O O O Required for cheque (product code PLC).
Supports local language. Thai (CP874)
37. Payment Details, Line 2 35X O O O Supports local language. Thai (CP874).
38. Payment Details, Line 3 35X O O O Supports local language. Thai (CP874).
39. Payment Details, Line 4 35X N N N
40. Beneficiary Is [A Bank] 10X N N N
41. Bank to Bank Information, Line 1 35X N N N
42. Bank to Bank Information, Line 2 35X N N N
43. Bank to Bank Information, Line 3 35X N N N
44. Bank to Bank Information, Line 4 35X N N N
45. Bank to Bank Information, Line 5 35X N N N
46. Bank to Bank Information, Line 6 35X N N N
47. Intermediary Bank Routing Method 35X N N N
48. Intermediary Bank Routing Code 11X N N N
49. Intermediary Bank Name 35X N N N
50. Intermediary Bank Address 1 35X N N N
51. Intermediary Bank Address 2 35X N N N
52. Intermediary Bank Address 3 35X N N N
53. Intermediary Bank Country Code 2X N N N
54. Intermediary Bank Country Name 35X N N N
55. FX Contract 20X N N N
56. Exchange Rate 20X N N N
57. Intra-company [Indicator] 1X N N N
58. Charges Indicator 3X O O O Valid values is OUR
59. Charges Account 34X O O O If not given, debit account is used.
60. Priority Flag 1X N N N
61. Pre-Advice Flag 1X N N N
62. Number of Credit Parties 35X N N N
63. Entry Description 10X N N N
64. Second Intermediary Bank Account 6X N N N
or Other ID Type
65. Second Intermediary Bank Account 34X N N N
or Other ID
66. Second Intermediary Bank Advice 10X N N N
Type
67. Second Intermediary Bank Name 35X N N N
68. Second Intermediary Bank Address 1 35X N N N
69. Second Intermediary Bank Address 2 35X N N N
70. Second Intermediary Bank Address 3 35X N N N
71. Advice To Name 35X O O O Supports local language. Thai (CP874)
72. Advice Media/Bene Advice Type 10X O O O Valid values are FAX, MAIL and INT.
73. Fax Number 15X N O O Valid values are numeric only
74. Alternate Fax Number 15X N N N
75. Contact Phone Number 35X N N N
76. Internet Address – Account Name 50X O O O
77. Internet Address – Domain Name O O O
78. Payment Type 4X N N N Payment type is mapped from product code.
79. Transaction Type 3X N R R Valid values for GIRO:
01 – Salary, Commission, Pension
02 – Dividend

Page 2 of 8 Copyright© 2004 by Citibank N.A. All Rights Reserved.


EBBM Version 1.
Ref Field Name Format R/O/C/ Comments
No N

PLC
PTA
PTP
03 – Interest
04 – Goods and Services Payment
05 – Stock Selling
06 – Tax Refund
80. Mail To Name 35X O O O Required for cheque AND Giro payments if cheque is to be
mailed (delivery method MAIL or RET). In case of MAIL, put
beneficiary name/address, for RET, put ordering party name/
address.
Supports local language. Thai (CP874)
81. Mail To Address 1 35X O O O Required for cheque and Giro payments if cheque is to be
mailed (delivery method MAIL or RET).
Supports local language. Thai (CP874)
82. Mail To Address 2 35X O O O Required for cheque and Giro payments if cheque is to be
mailed (delivery method MAIL or RET).
Supports local language. Thai (CP874)
83. Mail To Address 3 35X O O O Required for cheque and Giro payments if cheque is to be
mailed (delivery method MAIL or RET).
Supports local language. Thai (CP874)
84. Mail To Address 4 35X O O O Required for cheque and Giro payments if cheque is to be
mailed (delivery method MAIL or RET).
Supports local language. Thai (CP874)
85. Mail To Country Code 2X N N N
86. Mail To Country Name 35X N N N
87. Beneficiary Country Code 2X N N N
88. Beneficiary Country Name 35X N N N
89. Clearing Country Code 2X N N N
90. Clearing Country Name 35X N N N
91. Delivery Method 5X R N N Required for cheque payments (product code PLC). Do not
specify for Giro payments (product codes PTA, PTP). The
following values are valid.
MAIL - mailed to beneficiary by Citibank
RET - returned to ordering party
C/R - “counter with receipt”, disburse on disbursement days
and also do matching of all docs with customer’s vendor
C/OR - “counter without receipt”, disbursement at counter but no
matching ( for check express with government only)

92. Payable At Location 9X O N N For cheque (product code PLC) only.


Valid value is THA
93. PDC Discounting 10X N N N
94. Custom field 1 70X N N N
95. Processing Date 70X N N N Internal: Processing Date always equal to value date.
96. Beneficiary Tax ID 70X O O O Beneficiary Tax ID required 10 digits
97. Invoice Amount 21N R R R THB Invoice Amount. Format “x.xx”.
98. Beneficiary Charge Amount 21N O O O Beneficiary Charge Amount Format “x.xx”.
99. Total VAT Amount 21N O O O Total VAT Amount Format “x.xx”.
100. Total WHT Amount 21N O O O Total WHT Amount Format “x.xx”.
101. Custom field 8 70X N N N
102. Custom field 9 70X N N N
103. Custom field 10 70X N N N
104. Custom field 11 70X N N N
105. Custom field 12 70X N N N
106. Custom field 13 70X N N N
107. Custom field 14 70X N N N
108. Custom field 15 70X N N N
109. Custom field 16 70X N N N
110. Custom field 17 70X N N N
111. Custom field 18 70X N N N
112. Custom field 19 70X N N N
113. Subsidiary Identifier 5X O O O Subsidiary Identifier same as client code.

Invoice details (optional)


1. Product Code 3X R R R Fixed Value: INV
2. Invoice Data Up to O O O Free format text. Supports local language. Thai (CP874)
75X If Thailand Tax sub-form is to be used, please refer to Thailand
Tax section below.

Page 3 of 8 Copyright© 2004 by Citibank N.A. All Rights Reserved.


EBBM Version 1.
Ref Field Name Format R/O/C/ Comments
No N

PLC
PTA
PTP
R/O/C/N – Required / Optional / Conditional / Not used (leave empty)

General Information.
The file described is a plain text file that uses (carriage return and) line feed characters to distinguish
between lines. It contains multiple transactions. One transaction comprises a transaction header record and,
optionally, one to 9999 invoice line records.
Each record is represented by one line. The fields in each record are separated by at-sign (@). They can be
any length up to the stated maximum length for each field. The assignment to the format layout is by
position. If the line ends before all fields have been filled, the remaining fields are empty.
The following regulations apply for the formatting of the field values.
All fields are given as string values.
Date format is YYYYMMDD.
Amount fields give the value with a decimal point with format “x.xx”. Specifying a decimal point is not
required for integer values (e.g. SGD 23.00 and SGD 23 are both accepted).
Due to the delimiter @, the e-mail address is split into two fields (No. 76 and 77). Either provide account
name and domain name separately in these fields or treat both field as one. In the latter case, an @
must be put in the (combined) field in case there is no e-mail address.

Thailand Tax.
WHT Tax details must be specified in the first thirty-three lines of the invoice data. In order to do that, the
Invoice Data field (field 4 of Invoice Details) must be structured as follows. The fields are fixed-length, not
delimited. In lines 34 to 999 the invoice details need to be specified in the format defined below.

Line 1
1 Bank Branch Code and Province 70X O Required for check upcountry.
Line 2
1 Identifier 3X R Fixed value FAX.
2 Fax Number 15X O Required for beneficiary fax advising
Line 3
1 Identifier 70X R Blank or any information
Line 4
1 Identifier 3X R Fixed value WHT.
2 Tax Type Code 6X R 010100 = 1
010101 = 1
020000 = 2
020100 = 2
030000 = 3
030100 = 3
530000 = 53
3 Tax Type Description 30X O Populate from tax type code.
Supports local language (Thai CP874).
4 Tax Document No 20X O If blank, Citibank will not be generated any document no.
5 Tax Sequence No 5X O Must be validated to ensure that it is unique for each record and
tax type, if blank will be generated from Citibank per month.
Line 5
1 Identifier 3X R Fixed value WHT.
2 Tax ID 10X R Required 10 Digits for Corporate Tax ID or Personal Tax ID with
10 Digits only.
3 Citizen ID 13X O
Line 6
1 Identifier 3X R Fixed value WHT.
2 Name Title 70X O Supports local language (Thai CP874).
Line 7
1 Identifier 3X R Fixed value WHT.
2 Beneficiary First Name 1 70X R Supports local Language (Thai CP874).
Line 8
1 Identifier 3X R Fixed value WHT.
2 Beneficiary First Name 2 70X O Supports local language (Thai CP874).
Line 9
1 Identifier 3X R Fixed value WHT.

Page 4 of 8 Copyright© 2004 by Citibank N.A. All Rights Reserved.


EBBM Version 1.
2 Beneficiary Last Name 72X O Supports local language (Thai CP874).
Line 10
1 Identifier 3X R Fixed value WHT.
2 Beneficiary Address Line 1 70X R Print WHT address line 1.Supports local language (Thai CP874).
Line 11
1 Identifier 3X R Fixed value WHT.
2 Beneficiary Address Line 2 70X O Print WHT address line 2. Supports local language (Thai CP874).
Line 12
1 Identifier 3X R Fixed value WHT.
2 Beneficiary Address Line 3 70X O Print WHT address line 3. Supports local language (Thai CP874).
Line 13
1 Identifier 3X R Fixed value WHT.
2 Beneficiary Address Line 4 70X O Print WHT address line 4. Supports local language (Thai CP874).
Line 14
1 Identifier 3X R Fixed value WHT.
2 Compound Name 30X O Building / Village. Supports local language (Thai CP874).
For Revenue Department with tax online payment
3 Room Number 10X O For Revenue Department with tax online payment
4 Floor 3X O For Revenue Department with tax online payment
5 Bank A/C Number 15X O For Revenue Department with tax online payment
Line 15
1 Identifier 3X R Fixed value WHT.
2 Address Number 20X O For Revenue Department with tax online payment
3 Moo 2X O For Revenue Department with tax online payment.
Supports local language (Thai CP874).
4 Soi 30X O For Revenue Department with tax online payment.
Supports local language (Thai CP874).
Line 16
1 Identifier 3X R Fixed value WHT.
2 Street 30X O For Revenue Department with tax online payment.
Supports local language (Thai CP874).
Line 17
1 Identifier 3X R Fixed value WHT.
2 Sub District / Tumbon 30X O For Revenue Department with tax online payment.
Supports local language (Thai CP874).
3 District / Amphur 30X O For Revenue Department with tax online payment.
Supports local language (Thai CP874).
Line 18
1 Identifier 3X R Fixed value WHT.
2 Province 40X O For Revenue Department with tax online payment.
Supports local language (Thai CP874).
3 Postcode 5X O For Revenue Department with tax online payment
Line 19
1 Identifier 3X R Fixed value WHT.
2 Tax Description1 Line 1 60X O Populate from tax code1 except Tax Code 1 = 99000000.
Supports local language (Thai CP874).
3 Tax Code 1 8X R Tax Code information

#$
"
!

!
% &! ' ())! ! * +,
- -
* () !. *# +) &
- - /0!
%
$1/0*0
($+ *
- - -
/0!
% $1/0*0
( $+ *
, , ' 23 4) 0
5# 6

- 7 $8/
9 : / $+;*: 6"
; )&
<< "=
<< , )! " )!>
"* ?'"
! ' " ;* , ':
#!
<< "= +
%
Line 20
1 Identifier 3X R Fixed value WHT.
2 Tax Description1 Line 2 70X O Supports local language (Thai CP874).
Line 21

Page 5 of 8 Copyright© 2004 by Citibank N.A. All Rights Reserved.


EBBM Version 1.
1 Identifier 3X R Fixed value WHT.
2 Tax Description1 Line 3 70X O Supports local language (Thai CP874).
Line 22
1 Identifier 3X R Fixed value WHT.
2 Tax Rate 1 6X R 9(4)V99
3 Taxable Amount1 17X R 9(15)V99
4 Tax Amount 1 17X R 9(15)V99
5 Tax Deduction Date 1 10X R DD/MM/YYYY
Line 23
1 Identifier 3X R Fixed value WHT.
2 Payer Code 1 1X R Payer Code Information
1=)!> "*
- > ()@ > () ! . *#
, > 5 () $
< =
3 Payer Description 1 60X O Populate from Payer Code1.
Supports local language (Thai CP874).
Line 24
1 Identifier 3X R Fixed value WHT.
2 Tax Description2 Line 1 60X O Populate from tax code 2 except Tax Code 2 = 99000000.
Supports local language (Thai CP874).
3 Tax Code 2 8X O Same as line 19 field 3
Line 25
1 Identifier 3X R Fixed value WHT.
2 Tax Description2 Line 2 70X O Supports local language (Thai CP874).
Line 26
1 Identifier 3X R Fixed value WHT.
2 Tax Description2 Line 3 70X O Supports local language (Thai CP874).
Line 27
1 Identifier 3X R Fixed value WHT.
2 Tax Rate 2 6X O 9(4)V99
3 Taxable Amount 2 17X O 9(15)V99
4 Tax Amount 2 17X O 9(15)V99
5 Tax Deduction Date 2 10X O DD/MM/YYYY
Line 28
1 Identifier 3X R Fixed value WHT.
2 Payer Code 2 1X O Same as line 23 field 2
3 Payer Description 2 60X O Populate from payer code 2.
Supports local language (Thai CP874).
Line 29
1 Identifier 3X R Fixed value WHT.
2 Tax Description3 Line 1 60X O Populate from tax code 3 except Tax Code 3 = 99000000.
Supports local language (Thai CP874).
3 Tax Code 3 8X O Same as line 19 field 3
Line 30
1 Identifier 3X R Fixed value WHT.
2 Tax Decription3 Line 2 70X O Supports local language (Thai CP874).
Line 31
1 Identifier 3X R Fixed value WHT.
2 Tax Description3 Line 3 60X O Supports local language (Thai CP874).
Line 32
1 Identifier 3X R Fixed value WHT.
2 Tax Rate 3 6X O 9(4)V99
3 Taxable Amount 3 17X O 9(15)V99
4 Tax Amount 3 17X O 9(15)V99
5 Tax Deduction Date 3 10X O DD/MM/YYYY
Line 33
1 Identifier 3X R Fixed value WHT.
2 Payer Code 3 1X O Same as line 23 field 2
3 Payer Description 3 60X O Populate from Payer Code 3.
Supports local language (Thai CP874).
Line 34 – 999
1 Invoice Number 10X O Left justified.
2 Blank 2X N
3 Invoice Date 10X O Left justified. Format DD/MM/YYYY.
4 Blank 2X N
5 Invoice Amount 12N O Right justified. Format “x.xx”.
6 Blank 2X N
7 VAT Amount 8N O Right justified. Format “x.xx”.
8 Blank 2X N

Page 6 of 8 Copyright© 2004 by Citibank N.A. All Rights Reserved.


EBBM Version 1.
9 WHT Amount 8N O Right justified. Format “x.xx”.
10 Blank 2X N
11 Net Payment 12N O Right justified. Format “x.xx”.

Sample Import file.


!"!#$%$&'( &)! *
* + + + ,
+ $%- !)&$. /0)&$" 1- +&$. &)! +&$. //'!22 +&$. //'!22 +&$. //'!22 + 1&3
$/ &21 #$!./
4
4 ,
4
4 4 4 4 + 4 5
4
4 6 6
4 6 6
4
4
4 77777777777777777777777777777777777777777777777777777777777777777
!" &)! 8109&( 33
33 &()!"1 !1&$. &()!"1 !1&$. &()!"1 !1&$.
$%- !)&$. /0)&$" 2: +&$. 10 &)! //'!22 //'!22 //'!22

4
4 ,
4
4 4 4 4 + 4 5
4
4 6 6
4 6 6
4
4
4 77777777777777777777777777777777777777777777777777777777777777777
!" &)! 8109&( 33
33 &()!"1 !1&$. &()!"1 !1&$. &()!"1 !1&$.
$%- !)&$. /0)&$" 2: +&$. 10 &)! //'!22 //'!22 //'!22

4
4 ,
4
4 4 4 4 + 4 5
4
4 6 6
4 6 6
4
4
4 77777777777777777777777777777777777777777777777777777777777777777
+
+ + + + ;; + ;; + ;
+
4
4 ,
4
4 5
4 5
4 5
4 5 +
4 5
4 5
4 5 ;;
4 5 ;;
4 5 ;;
4 5 ;;
4 5
4 5
4 5
4 5
4 5
4 5 ; 4 ;
4 5
4 5
4 5 6 6
4 5
4 5
4 5
4 5
4 5
4 5
4 5
4 5
4 5
4 5
4 5
4
4 4 4 4 + 4 5
4
4 6 6
4 6 6
4
4
4 77777777777777777777777777777777777777777777777777777777777777777
+
+ + + + ;; + ;;
+ ;;
4
4
4
4 5
4 5
4 5
4 5 +
4 5
4 5
4 5 ;;
4 5 ;;
4 5 ;;
4 5 ;;
4 5
4 5
4 5

Page 7 of 8 Copyright© 2004 by Citibank N.A. All Rights Reserved.


EBBM Version 1.
4 5
4 5
4 5 ; 4 ;
4 5
4 5
4 5 6 6
4 5
4 5
4 5
4 5
4 5 6 6
4 5
4 5
4 5
4 5
4 5
4 5
4
4 4 4 4 + 4 5
4
4 6 6
4 6 6
4
4
4 77777777777777777777777777777777777777777777777777777777777777777
+
+ + + + ;; + ;;
+ ;;
4 < <
4
4
4 5
4 5
4 5
4 5 +
4 5
4 5
4 5 ;;
4 5 ;;
4 5 ;;
4 5 ;;
4 5
4 5
4 5
4 5
4 5
4 5 ; 4 ;
4 5
4 5
4 5 6 6
4 5
4 5
4 5
4 5
4 5 6 6
4 5
4 5
4 5
4 5
4 5 6 6
4 5
4
4 4 4 4 + 4 5
4
4 6 6
4 6 6
4
4
4 77777777777777777777777777777777777777777777777777777777777777777

Page 8 of 8 Copyright© 2004 by Citibank N.A. All Rights Reserved.


EBBM Version 1.

You might also like