Professional Documents
Culture Documents
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
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
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)
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.
#$
"
!
!
% &! ' ())! ! * +,
- -
* () !. *# +) &
- - /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
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