CitiDirect Online Banking

Import

CitiService
CitiDirect Helpdesk
Tel. 0 801 343 978, +48 (22) 690 15 21
Monday to Friday 8.00 a.m. – 5.00 p.m.
[email protected]
Contents
CONTENTS ............................................................................................................................................................................. 2
1. INTRODUCTION .......................................................................................................................................................... 3
2. IMPORT PROFILE....................................................................................................................................................... 4
3. RUNNING IMPORT ..................................................................................................................................................... 7
4. FILE FORMATS ........................................................................................................................................................... 9
4.1 MTMS .......................................................................................................................................................................... 10
4.1.1 DOMESTIC FUNDS TRANSFER ................................................................................................................................. 11
4.1.2 SOCIAL SECURITY PAYMENT ................................................................................................................................... 12
4.1.3 INTERNAL REVENUE PAYMENT ................................................................................................................................ 14
4.1.4 CROSS BORDER FUNDS TRANSFER ........................................................................................................................ 16
4.1.5 DIRECT DEBIT .......................................................................................................................................................... 21
4.2 FLAT FILE (CDFF) ..................................................................................................................................................... 22
5. IMPORT ENCRYPTION ............................................................................................................................................ 30
5.1 PUBLIC KEY DOWNLOAD .............................................................................................................................................. 30
5.2 INSTALLING X509 CERTIFICATE................................................................................................................................... 31
5.3 IMPORT PROFILE CONFIGURATION .............................................................................................................................. 31

2
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 1. Introduction

Import tool enables Users to upload transactions from external files.

During the upload process, the system verifies the data in order to detect errors or incomplete information.

Imported records must comply with the applicable structure, provided by Citi Handlowy.
A record means a single transaction which may consist of various numbers of lines (depending on its type).
Each record in a file is qualified as correct or incorrect during import. Correct records are passed to further
processing. Incorrect ones are either re-routed to repair or rejected, depending on error severity.

Transaction upload occurs at the time of running Run Import which may process one or more files. Imported
payments – before they are sent to the Bank – are subject to the same approval process as payments executed
manually.

3
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 2. Import Profile
In order to use import you need to create a profile in which you define location of the uploaded files and select a
map which defines the format and the type of imported payments.

1) Set the mouse cursor over Tools & Preferences in the upper CitiDirect menu and select Import Profile.

2) In the Import Profile Summary click New. A new window will be displayed:

Enter any name and description.

3) Click Add Map to add a map which defines the format of imported data.
Click Search – a search window will open. Next, click Clear.

4
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 4) In Map Name field enter one of the following formats and Run Search.
1. MTMS Format:
a) C MTMS DFT ALL PL v5 – domestic funds transfers
b) C MTMS CBFT PL v05 – cross border funds transfers
c) C MTMS CBFT PL v5 – cross border funds transfers (without fields 23 and 24)
d) C MTMS DD PL – direct debits

2. FLAT FILE Format:

a) C CDFF CEE v10 – ordinary domestic and cross border funds transfers
5) If you want to use polish fonts in the
b) C CDFF PL v5 – Social Security and Internal Revenue Payments import file, select - Cp1250 Windows
Eastern Europe
c) C CDFF SEPA – SEPA transfers

6) Enter file location manually or use

Browse button.

5 7) Click Submit to complete profile

edition.
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
After saving, profile status is Test Required. On this stage, after selecting My Transactions & Services from the
upper menu and, next, Transaction Import, in the Test tab you may perform some test imports or end this stage
without testing by clicking Test Complete.

After completing the tests, profile will need to be authorized. In order to authorize the import profile, set mouse
cursor over Tools & Preferences and select Import Profile. Select the profile you want to authorize and click
Authorize.

Users authorized to create payments are entitled to create and authorize import profiles.
Import profile is reusable. It may be used by many Users, even staying at different places in the company.

6
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 3. Running Import
Set mouse cursor over My Transactions & Services in CitiDirect upper menu and select Import Transaction.

Select the profile you want to use and click Run.

7
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
Follow the instructions on the screen. After selecting a file, there will open a progress bar and a message
confirming running the profile. Click OK and go to Run History tab.

In Run History you will find a report from the run you just started.
Each run has a Status indicating if the import is in progress, if it has finished and if errors were detected.

List of possible Statuses:

Processing – imported file is being processed by CitiDirect,
Complete – import has finished without errors.
Completed with Errors – import failed, errors were detected, check run details.

If imported failed and errors were detected, contact the Bank immediately.

8
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 4. File Formats
The system enables the User to upload transactions from files in one of two formats: MTMS or
FLAT FILE
 MTMS is used to send instructions from accounts in Citi Handlowy in Poland and is supported by many
financial and accounting programs available in the Polish market.

 FLAT FILE enables the User to import instructions debiting accounts in Citi in various countries.
Regardless of the kind of payment, a single record in a file contains the same number of fields. All
payments may be aggregated in one file and imported in one run.

Regardless of the format type, data should be saved in a text file.

File name and extension are irrelevant.

Character Set:
The following characters may be used in any data field of the import file
A B C D E F G H I J K L M
Alphabetical
N O P Q R S T U V W X Y Z
Numeric 0 1 2 3 4 5 6 7 8 9
Control Carriage
CR Line Feed LF
Characters Return
Question Period (Full
? Comma , . Space
Special Mark Stop)
Characters Left Right
( ) Apostrophe ‘
Parenthesis Parenthesis

The following characters may only be used subject to the rules shown below
Slash /
Must not be used as the first or last character in a field.
Double Slash //
Hyphen -
Plus Sign + Must not be used as the first character in a field
Colon :

If you want to use Polish fonts, when creating an import profile, in Encoding Set field, select:
- Cp1250 -- Windows Eastern European (see page 5):

Polish fonts may be used in Beneficiary Name/Address and Payment Details fields.

9
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 4.1 MTMS

Key parameters
– A single transaction record consists of several fields (depending on the transaction type).
– Each field has its number and consists of one or more lines.
– Each transaction records starts with „0” and ends with „-1”. There are no blank lines between records.
– Data in fields are to be entered top to bottom starting with the number of the field and the contents in the
subsequent rows.
– The number of lines is constant. For example, if a field consists of four lines and only one has been used, the
remaining three should be left blank.
– Polish fonts are allowed in Beneficiary Name and Payment Details fields.
– A line must not start or end with a space.

Import maps
When creating an import profile (see chapter 2) select a map, depending on the types of transactions you want to
import:

1. C MTMS DFT ALL PL v5 – ordinary domestic funds transfers, internal revenue payment, social security
payment
2. C MTMS CBFT PL v05 – cross border funds transfers and SEPA
3. C MTMS CBFT PL v5 – cross border funds transfers (without fields 23 and 24)
4. C MTMS DD PL – direct debit

ATTENTION! In a single import profile only one map may be selected.

To ensure the import is run properly, some additional settings in the Library are required.
From the upper menu, in Tools & Preferences tab, select Library Maintenance.

10
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
From the preformat list select library for Import Map Definition: File Import Map Definition Rule Set. Next, click
New to add an item:

In the new item fill the fields according to the table:

Map from Map to Category
All Transaction Types
Last digits of the account number
Character sequence used to
without the preceding zeros (base
indicate the debit account in the Debit Account
number + subaccount) e.g.
import file, e.g. 0509000999
509000999
Cross Border Funds Transfer
4 NOADVISE SAAdviseBeneficiary
Y A Bank Beneficiary Type Lookup
N Not a Bank Beneficiary Type Lookup

All data must be entered exactly as in the table – letter case is important.

4.1.1 Domestic Funds Transfer

List of Fields
MAXIMUM NUMBER OF
NUMBER OF
LABEL FIELD NAME CHARACTERS IN A FORMAT
LINES
LINE
0 Transaction Type 1 2 N
Transaction Reference
1 1 10 T
Number
2 Debit Account Number 1 34 N
Beneficiary Bank Routing
3 1 8 N
Code
Beneficiary Account
4 1 26 T
Number
6 Beneficiary Name / Address 3 35 T
7 Amount 1 22 (18.2) N
8 Value Date 1 8 DD/MM/YY
9 Payment Details 4 35 T
N - NUMERIC, T – TEXT

11
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
Sample record of a Domestic Funds Transfer:

0
11
1
REF-1
2
0509000999
3
10301508
4
99103015080000000000000000
6
Beneficiary Name and Address 1
Beneficiary Name and Address 2
Beneficiary Name and Address 3
7
1000.00
8
01/12/10
9
Payment Details line 1
Payment Details line 2
Payment Details line 3
Payment Details line 4
-1

4.1.2 Social Security Payment

List of Fields
MAXIMUM NUMBER OF
NUMBER OF
LABEL FIELD NAME CHARACTERS IN A FORMAT
LINES
LINE
0 Transaction Type 1 2 N
1 Transaction Reference Number 1 10 T
2 Debit Account Number 1 34 N
3 Beneficiary Bank Routing Code 1 8 N
4 Beneficiary Account Number 1 26 T
6 Beneficiary Name / Address 3 35 T
7 Amount 1 22 (18.2) N
8 Value Date 1 8 DD/MM/YY
10 Taxpayer Identification Number 1 10 N
11 Other Identification Type 1 1 T
12 Other Identification Number 1 T
13 Declaration Type 1 1 T
14 Declaration Date 1 6 YYYYMM
15 Declaration Number 1 2 N
23 Decision Number 1 15 T
N - NUMERIC, T – TEXT

12
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
Additional information:

LABEL FIELD NAME DESCRIPTION

This field should contain one character, possible values are: „1”, „2”, „P”, „R”
Other Identification
1 – identity card (series and number)
Type
11 2 – passport (series and number)
P – identification number PESEL
R – identification number REGON
This field contains:
Other Identification for 1: 2 letters + 7 digits or 3 letters + 6 digits
12 Number for 2: passport number length is undefined
for P: 11 digits (without separators like dashes ‘-‘, space, etc.)
for R: 9 or 14 digits (without separators like dashes ‘-‘, space, etc.)
This field should contain one character, possible values are: „A”, „B”, „D”, „E”,
„M”, „S”, „T”, „U”
A – additional fee, person
B – additional fee, institution
Declaration Type D – additional fee
13
E – execution costs
M – period longer than one month
S – payment for one month
T – delayed payment term
U – installments payment
For all Declaration Types this field should contain maximum of 6 numeric
14 Declaration Date
characters in YYYYMM format. Example: 200503
This field should contain 2 digits:
Declaration Number for declaration type = "S" or "M" field should contain a value from 01 to 89
15
for declaration type = "A", "B", "D", "E", "T" or "U" field should contain
values: 01, 40, 51, 70 or 80.
In this field enter additional information received from the Social Security unit.
Decision Number
23 for declaration type = "S" or "M" line should remain blank
for declaration type = "A", "B", "D", "E", "T", "U" content different than space

Fields 0, 1, 2, 3, 4, 6, 7, 8, 10, 11, 12, 13, 14, 15, 23 are mandatory.

Sample record of a Social Security Payment:

0
12
1
REF-1
2
0509000999
3
10101023
4
83101010230000261395100000
6
BENEFICIARY NAME 1
BENEFICIARY NAME 2
BENEFICIARY NAME 3
7
22.11
8
07/02/05
10
5431264545
11
13
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
P
12
78112800038
13
S
14
200503
15
01
23

-1

4.1.3 Internal Revenue Payment

List of Fields
MAXIMUM NUMBER OF
NUMBER OF
LABEL FIELD NAME CHARACTERS IN A FORMAT
LINES
LINE
0 Transaction Type 1 2 N
Transaction Reference
1 1 10 T
Number
2 Debit Account Number 1 34 N
Beneficiary Bank Routing
3 1 8 N
Code
4 Beneficiary Account Number 1 26 T
6 Beneficiary Name / Address 3 35 T
7 Amount 1 22 (18.2) N
8 Value Date 1 8 DD/MM/YY
16 Identification Type 1 1 N
17 Identification Number 1 14 N/T
18 Year 1 2 RR
19 Period Type 1 1 T
20 Period Range 1 4 N
Form or Payment Symbol
21 1 7 N/T
Order
22 Free Text 1 40 N/T
N - NUMERIC, T – TEXT

Additional information:

LABEL FIELD NAME DESCRIPTION

T This field may contain one digit; possible values are „1”, „2”, „3” „N”,
„P”, „R”
1 - identity card number
2 - passport number
16 Identification Type
3 – other document
N – NIP number
P – PESEL number
R – REGON number
This field may contain up to 14 digits, for a given Identification Type it
contains:
for 1: 2 digits + 7 digits or 3 letter + 6 digits
17 Identification Number for 2: passport number length is undefined
for 3: 14 alphanumeric characters
for N: 10 digits (without separators like dashes ‘-‘, space, etc.)
for P: 11 digits (without separators like dashes ‘-‘, space, etc.)
14
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 for R: 9 or 14 digits (without separators like dashes ‘-‘, space, etc.)
This field may contain one character; possible values are „J”, „D”, „M”,
„K”, „P”, „R”
J – day
D – decade
19 Period Type
M – month
K – quarter
P – half year
R – year
This field may contain up to 4 digits, for a given Period Type it contains:
J – 2 digits for day number, month, e.g. 2704
D – 2 digits for decade number, month, e.g. 0103
Period Range
20 M – 2 digits for month number, e.g.: 03
K – 2 digits for quarter (01,02,03,04)
P – 2 digits for half year number (01,02)
R – leave the field blank
Form or Payment Symbol This field may contain up to 7 characters, indicates the type of tax
21
Order payment, e.g.: PIT4, CIT8.
22 Free Text This field may contain up to 35 characters.

Fields 0, 1, 2, 3, 4, 6, 7, 8, 16, 17, 18, 19, 20, 21, 22 are mandatory.

Sample record of an Internal Revenue Payment:

0
13
1
REF-2
2
0509000999
3
10101212
4
91101012120027852221000000
6
BENEFICIARY NAME 1
BENEFICIARY NAME 2
BENEFICIARY NAME 3
7
12345.11
8
06/03/05
16
1
17
AB1234567
18
05
19
M
20
03
21
CIT8
22

-1

15
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 4.1.4 Cross Border Funds Transfer (including SEPA)
List of Fields

MAXIMUM NUMBER OF
NUMBER OF
LABEL FIELD NAME CHARACTERS IN A FORMAT
LINES
LINE
0 To 1 Citi Handlowy T
1 Payment Method 1 2 T
Transaction Reference
3 1 10 T
Number
4 Currency 1 3 T
5 Amount 1 22 (18.2) N
6 Value Date 1 8 DD/MM/YY
7 Debit Account Number 1 34 T
Beneficiary Account
8 1 34 T
Number
9 Beneficiary Name / Address 4 35 T
Beneficiary’s Bank Name /
10 4 35 T
Address
11 Beneficiary is 1 1 T
12 Ordering Party Name 1 30 T
13 Charges Indicator 1 3 T
14 Charges Account 1 34 T
15 Advise Beneficiary 1 1 N
16 Payment Details line 1 1 35 T
17 Payment Details line 2 1 35 T
18 Payment Details line 3 1 35 T
20 Other Instructions 6 35 T
Beneficiary Bank Routing
21 1 2 T
Method / Code
Beneficiary Bank Routing
22 1 15 T
ID
Ordering Party Account
23 1 34 T
Number
24 Ordering Party Address 3 35 T
N - NUMERIC, T – TEXT

Additional information for Cross Border Funds Transfers:

LABEL FIELD NAME DESCRIPTION
0 To This field should contain: Citi Handlowy.
This field is used to define the type of transaction.
1 Payment Method
Only one type is allowed; you should enter: „TT”.
This field is used in the system as the parameter that identifies the
Transaction Reference
3 payment. Several payments may have the same identifier.
Number
Enter any sequence of up to 16 characters.
Currency This field contains a three-letter currency code, e.g. PLN for the Polish
4
zloty. Upper case is required.
Amount
5 Up to 22 characters with “.” as hundredths separator.
This field includes the exact specification of the day on which the ordering
Value Date
6 party’s account is debited.
The system does not allow back-dating.
7 Debit Account Number Enter the sequence of characters defined in the system as representation of
16
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 a given debited account.
Beneficiary Account Enter the account number in the international format applicable for the
8
Number beneficiary’s country.
Beneficiary Name /
9 The field consists of four lines, up to 35 characters each.
Address
Beneficiary’s Bank The field consists of four lines, up to 35 characters each.
10
Name / Address At least two lines of text are required.
Enter one of the following options:
N – beneficiary is not a bank
11 Beneficiary is
Y – beneficiary is a bank
Upper case is required.
12 Ordering Party Name The field may contain up to 30 characters.
The field contains one of the tree options:
Charges Indicator BEN – the beneficiary pays all costs
13
OUR – the ordering party pays all costs
COL – each party pays the costs charged by its bank
Charges Account
This field should contain the 10-digit number of an account at Citi Handlowy
14 Number
to which the transfer fees will be charged.
15 Beneficiary advice This field should contain instruction ‘4’, i.e. no advice required.
16 Payment Details line 1 The field may contain up to 35 characters.
17 Payment Details line 2 The field may contain up to 35 characters.
The field may contain up to 35 characters.
18 Payment Details line 3
Other instructions
20 Other instructions field must contain 6 lines up to 35 characters each.
Enter one of the following options:
IS = SWIFT
Routing Method FW = FedWire Routing Number
21
AT = Austrian Bankenstammdaten
IE = Irish Sort Code
SC = Chaps Branch Sort Code
The field should contain the code of the beneficiary’s bank in accordance
22 Routing Code
with the remittance method selected in Field 21.
Ordering Party Account
23 This field should consist of one line, up to 34 alphanumeric characters.
Number
Ordering Party Address
24 The field may consist of 3 lines, up to 35 alphanumeric characters each.

Fields 0, 1, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16, 17, 18 are mandatory.

Additional information for SEPA Cross Border Funds Transfers

LABEL FIELD NAME DESCRIPTION

This field should contain the name of the branch to which the payment instruction
0 To
is sent. przelewu. In this case it should be: Citi Handlowy
This field is used to define the type of transaction.
1 Payment Method
Only one type is allowed; you should enter: „TT”.
This field is used in the system as the parameter that identifies the payment.
Transaction
3 Several payments may have the same identifier.
Reference Number
Enter any sequence of up to 10 characters (digits or letters).
Currency
4 For SEPA payments the currency code must always be EUR.
This field may contain up to 13 digits with maximum of 2 digits after the period
Amount character. Specified in this field is the amount designated in the selected
5
currency. If this amount exceeds the limits specified for the particular User
importing this transaction, the transaction will be rejected and redirected to be

17
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 repaired. It may be repaired by a person with entitlement to repair transactions of
such an amount.
This field includes the exact specification of the day on which the payment
Value Date
6 instruction should be carried out. Date should be in DD/MM/YY format.
The system does not allow back-dating.
Enter the sequence of characters defined in the system as representation of a
Debit Account given debited account. Enter the last 10 digits of the account number. This
7
Number number must be corresponding to any of the accounts at Citi Handlowy. E.g.
0509000999
Beneficiary This field must contain one line of up to 34 characters (digits and letters). Please
8
Account Number enter the Beneficiary Account Number in IBAN format.
Beneficiary Name /
9 This field should contain 4 lines, each line up to 35 characters.
Address
Beneficiary’s Bank This field for SEPA transfers in its first line should contain only the SWIFT code of
10
Name / Address the Beneficiary Bank – no additional text should be entered.
Enter one of the following options:
N – beneficiary is not a bank
11 Beneficiary is
Y – beneficiary is a bank
Upper case is required.
Ordering Party
12 The field may contain up to 30 characters.
Name
Charges Indicator COL phrase should be entered. This means that the charges are divided
13
between the ordering party and the beneficiary.
Charges Account
This field should contain the 10-digit number of an account at Citi Handlowy to
14 Number
which the transfer fees will be charged.
15 Beneficiary advice This field should contain instruction ‘4’, i.e. no advice required.
Payment Details
16 The field may contain up to 35 characters.
line 1
Payment Details
17 The field may contain up to 35 characters.
line 2
Payment Details
The field may contain up to 35 characters.
18 line 3
Other instructions
20 For SEPA transfer this field should remain empty.
Routing Method
21 For SEPA transfer this field should remain empty.
Routing Code
22 For SEPA transfer this field should remain empty.
Ordering Party This field should consist of one line, up to 34 alphanumeric characters. The field
23
Account Number is not required in case of using the C MTMS CBFT PL v5 import map.
Ordering Party
The field may consist of 3 lines, up to 35 alphanumeric characters each. The field
24 Address
is not required in case of using the C MTMS CBFT PL v5 import map.

Fields 0, 1, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16, 17, 18 are required.

18
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
Sample record of a Cross Border Funds Transfer:

0
Bank Handlowy w Warszawie S.A.
1
TT
3
REF - 1
4
EUR
5
55.55
6
29/05/05
7
0509000999
8
123456789012345
9
SHOE CO.
1 STREET
MIDDLESVILLE
U.S.A.
10
NATIONAL BANK OF MIDDLESVILLE
STREET
CITY
XYZ
11
N
12
CHA PROFESSIONAL SYSTEM LTD.
13
BEN
15
4
16
NO 1234/2005
17
PAYMENT DETAILS
18
PAYMENT DETAILS
20

21
IS
22
LGPBPLPW
23
ORDERING PARTY ACCOUNT NUMBER
24
ORDERING PARTY ADDRESS

-1

19
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
Sample record of a SEPA Cross Border Funds Transfer:

0
Bank Handlowy w Warszawie S.A.
1
TT
3
REF - 1
4
EUR
5
55.55
6
29/05/05
7
0509000999
8
123456789012345
9
CESKA POSTA
PRAHA KOOSPOL
EVROPSKA 100

10
CITICZPP

11
N
12
CHA PROFESSIONAL SYSTEM LTD.
13
COL
15
4
16
NO 1234/2005
17
SZCZEGOLY PLATNOSCI
18
SZCZEGOLY PLATNOSCI
20

21

22

23
NUMER RACHUNKU STRONY ZAMAWIAJĄCEJ
24
ADRES ZLECENIODAWCY

-1

20
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 4.1.5 Direct Debit

List of Fields
MAXIMUM NUMBER OF
NUMBER OF
LABEL FIELD NAME CHARACTERS IN A FORMAT
LINES
LINE
0 Transaction Reference Number 1 10 T
1 Debtor Account Number 1 26 N
2 Debtor Bank Routing Code 1 8 N
3 Creditor Account Number 1 34 T
4 Debtor Details 3 35 T
6 Amount 1 22 (18.2) N
7 Payment Date 1 8 DD/MM/YY D
8 Payment Details 2 1x20; 1x35 T
N- NUMERIC, T – TEXT

Additional information:

LABEL FIELD NAME DESCRIPTION

Transaction This field should contain up to 10 characters (digits or letters). Content of this field
0 Reference should contain reference number or other description which will enable to identify the
Number transaction.
Debtor This field should contain up to 35 characters (digits).
1 Account Example: IBAN Account Number: 02124011091111000000000000
Number
This field should contain up to eight characters. In this field enter beneficiary bank
Debtor Bank
2 routing code. Only numbers listed in Polish Banks Library are acceptable, otherwise
Routing Code
the transaction will be sent to repair.
Creditor Field should contain 10 digits.
3 Account Account with this number in Citi Handlowy will be credited for this transaction –it must
Number be one of User’s accounts. Example: 0509000999
This field should contain 3 lines up to 35 characters each.
4 Debtor Details
This field should contain information about the debtor: name and address
This field may contain up to 13 digits with maximum of 2 digits after decimal point.
This is the transaction amount in PLN. If the amount exceeds limit set for the User
6 Amount
who imports a given transaction, transaction will be sent to repair. It may be repaired
by the person authorized to repair transaction up to that amount.
This field should contain an exact specification of the day, on which the transaction
7 Payment Date will be processed. Date format should be DD/MM/YY. The system does not allow
back-dating.
First line should contain payment identification (up to 20 characters) – exactly the
Payment
8 same as on the direct debit mandate.
Details
Second line should contain invoice number (up to 35 characters).

Sample record of a Direct Debit:

0
ref 1
1
02124011091111000000000000
2
12401109

21
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
3
0509000999
4
DEBTOR NAME AND ADDRESS
DEBTOR NAME AND ADDRESS
DEBTOR NAME AND ADDRESS
6
123.45
7
16/07/05
8
A1234B1234D1234
test-citidirect dd l1
-1

4.2 FLAT FILE (CDFF)

Key Parameters

– Each transaction, regardless of its type, is one line in the file and consists of up to 89 fields.
– Separator between fields is „#”.
– Fields that are not used remain blank but have to be included in the record of the transaction.
– Record ends after the last field. Separator is not required.
– Record may end after any last field which contains data.
– Polish fonts are allowed in the Beneficiary Name and Payment Details fields.
– Field nr 1 is blank. The first character of each record is „#”.
– A field must not start or end with a space.

Import Maps

When creating an import profile (see chapter 2) select a map:

1. C CDFF CEE v10 – Domestic and Cross Border Funds Transfers
2. C CDFF SEPA – SEPA transfers
3. C CDFF PL v5 – Social Security and Internal Revenue Payments

ATTENTION! In a single profile both maps may be selected. It will result in a possibility to import all the
transactions in one file.

22
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
List of Fields for all transaction types:

Transaction Type
LABEL FIELD NAME Social Internal Cross
Domestic SEPA
Security Revenue Border
2 Country Code PL PL PL PL PL
3 Payment Method DFT DFT DFT EFT SEPA
M, M, M, M, M,
4 Value Date
YYYYMMDD YYYYMMDD YYYYMMDD YYYYMMDD YYYYMMDD
Preformat Group
6 O, 16 T O, 16 T O, 16 T O, 16 T
Code
7 Preformat Code O, 35 T O, 35 T O, 35 T O, 35 T
8 Payment Type M, 12 M, 13 O, 6
9 Currency M, 3 T ISO M, 3 T ISO M, 3 T ISO M, 3 T ISO
10 Amount M, (18.2) N M, (18.2) N M, (18.2) N M, (18.2) N M, (18.2) N
Debit Account M, 10 N
12 M, 35 T M, 35 T M, 35 T M, 35 T
Number
22 Charge Indicator M, 3 T
Ordering Party „PL”
23
Country Code
25 Identification M, 10 T M, 10 T M, 10 T M, 16 T
Client Reference O, 35 T
26
Number
Ordering Party O, 2 N
29
Organization ID Type
Ordering Party C, 6 – 35 T
30
Organization ID
31 Issuer C, 35 T
37 Ordering Party Name M, 30 T
Ordering Party
38 O, 35 T
Address line 1
Ordering Party
39 O, 35 T
Address line 2
42 Beneficiary is M, 10 T
43 Ordering Party Name O, 70 T
Ordering Party
Beneficiary Account Address line 1
44 M, 34 T M, 34 T M, 34 T M, 34 T
Number
O, 70 T
Ordering Party
Address line 2
45 Beneficiary Name M, 35 T M, 35 T M, 35 T M, 35 T
O, 70 T
Beneficiary Address
47 O, 35 T O, 35 T O, 35 T O, 35 T
line 1
Beneficiary Address
48 O, 35 T O, 35 T O, 35 T O, 35 T
line 2
Beneficiary
Beneficiary Address Country Code
49 O, 35 T
line 3
C, 2 T
Beneficiary
Account
Beneficiary Bank Number
50 C, 2 T
Routing Method
M, 34
(IBAN format)
23
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 Bemeficiary
Beneficiary Bank Name
51 M, 8 N M, 8 N M, 8 N C, 11 X
Routing Code
M, 70 T
Beneficiary Address
53
line 1 O, 70 T
Beneficiary Address
54
line 2 O, 70 T
Taxpayer
Identification
Beneficiary Bank Identification
55 Type C, 35 T
Name Number
M, 1 T
M, 10 T
Other
Identification
Beneficiary Bank Identification
56 Number C, 35 T
Address line 1 Type
M, 35 T
M, 1 T
Beneficiary
Bank Routing
Numer dodatk.
Beneficiary Bank Year Code
57 identyfikatora O, 35 T
Address line 2 C, 2 T
M, 35 T
M, (SWIFT)

Declaration
Beneficiary Bank Period Type
58 Type O, 35X
Address line 3 C, 1X
M, 1X
Declaration
Intermediary Bank Period O, 2 T
59 Date
Routing Method C, 4 T (IS - SWIFT)
M, 6 T
Declaration
Intermediary Bank Form Identifier
60 Number O 11 T
Routing Code M, 7 T
M, 2 T
Decision
Intermediary Bank Free Text
61 Number O, 35 T
Name O, 42 T
O, 15 T
Intermediary Bank
62 O, 35 T
Address line 1
Intermediary Bank
63 O, 35 T
Address line 2
Intermediary Bank
64 O, 35 T
Address line 3
Beneficiary
Organization
Payment Details line
72 O, 35 T M, 35 T ID Type
1
O, 2T
Beneficiary
Organization
Payment Details line
73 O, 35 T O, 35 T ID
2
C, 6-35 T
Issuer
Payment Details line
74 O, 35 T O, 35 T
3
C, 35 T
Payment Details line
75 O, 35 T
4
Charges Account
76 C, 35 T
Number
Advise for
77 M, 8 T
Beneficiary
84 Other Instructions O, 35 T
24
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 line 1
Other Instructions
85 O, 35 T
line 2
Other Instructions
86 O, 35 T
line 3
Other Instructions
87 O, 35 T
line 4
Other Instructions
88 O, 35 T
line 5
Payment
details line 1
Other Instructions
89 O, 35 T
line 6
O, 35 T

Payment details O, 35 T
90
line 2
Payment details O, 35 T
91
line 3
Payment details O, 35 T
92
line 4
C
94 Payment Title Code
Value selected
from the list.
C
Payment Title
95
Description Value selected
from the list.
End of the record Record may end after the last field which contains data.
M – MANDATORY, C – CONDITIONAL, O – OPTIONAL; N – NUMERIC, T – TEXT
Digits stand for maximum number of characters in a given field.
Fields: 1, 5, 11, 13 – 21, 24, 27, 28, 32-36, 40, 41, 46, 52, 65 – 71, 78 – 83, 93 – are blank.
They are not mentioned in the table but they need to be included in the record.

Additional information:

LABEL FIELD NAME DESCRIPTION

This field specifies the day on which the ordering party account is debited.
4 Value Date
The system does not allow back-dating.
Field used to connect data from the record with preformat saved in the
6 Preformat Group Code
system base. Used only in connection with field nr 7.
Field used to connect data from the record with the preformat saved in the
7 Preformat Code system base. Enter full code or its unique fragment (part of the name,
which does not appear in any other preformat).
Field used to choose the processing mode for SEPA payments.
Available options:

SEPACT – if you want to make a standard SEPA payment that will be

processed on the next day from selected Value Date.
8 Payment Type SEPADT – if you want to make an urgent SEPA payment that will be
processed on the same day as selected Value Date (provided the cut off
time has not been exceeded).

Lack of information in this field – the payment will be processed as

standard SEPA payment (SEPACT).
9 Currency 3-letter currency code, e.g. PLN – for polish zloty.
10 Amount Up to 22 characters. Hundredths separator – „.”
Debit Account Number Enter last digits of the account number (base number + subaccount)
12
without the preceding zeros (10 last digits of the account number).
25
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 Enter one of three options:
BEN – beneficiary covers all the costs
22 Charge Indicator
OUR – ordering party covers all the costs
COL – each party covers the costs of their bank
Content of the field is unrestricted and is used – for example – as a
25 Identification parameter to search for payments. Several payments may have the same
identification. Enter any sequence of characters.
In this field you should enter the appropriate ID from the list below:

 BIC
 BEI
 EANGLN
Ordering Party
29  CHIPS
Organization ID Type
 DUNS
 Bank Party ID
 Tax ID
 Proprietary ID

Ordering Party This field is required if a valid value has been provided for the Ordering
30
Organization ID Party Organization ID Type (field 29).
This field is required if value for “Proprietary ID” has been provided for
31 Issuer
Ordering Party Organization ID Type (field 29).
Enter one of the options:
Not a Bank – beneficiary is not a bank
42 Beneficiary is
A Bank – beneficiary is a bank
Upper case is required.
For Domestic Funds Transfer, Social Security and Internal Revenue
Payments you should enter account number in NRB format (26 digits).
Beneficiary Account
44
Number
For Cross Border Funds Transfer enter number in international format
applicable for beneficiary’s country.
49 Beneficiary Country Code This field is required if Beneficiary Address has been provided.
You may enter one of the following options:
IS – SWIFT (international code)
SC – Chaps Branch Sort Code(United Kingdom)
FW – FedWire Routing Number (USA)
Beneficiary Bank Routing AT – Austrian Bankenstammdaten (Austria)
50
Method IE – Irish Sort Code (Irland)
If in doubt, contact CitiDirect HelpDesk.

In case of SEPA transfer this field should contain Beneficiary Account

Number in IBAN format.
1. For Domestic Funds Transfers, Social Security and Internal
Revenue Payments enter bank code contained in the beneficiary
account number. Those are digits from 3 to 10.
51 Kod banku beneficjenta 2. For Cross Border Funds Transfer enter bank code in the routing
method selected in field 50.
In the Cross Border Funds Transfer, if fields 50 and 51 are filled,
fields 55-58 may remain blank.
1. In the Social Security Payment enter Taxpayer Identification Number
of a person / institution the payment concerns.
2. In the Internal Revenue Payment:
• Field may contain one character, possible values are: „1”, „2”, „3”,
Taxpayer Identification
„N”, „P”, „R”:
Number/Identification
55 1 – identity card number
Type:
2 – passport number
3 – other document
N – Taxpayer Identification Number (NIP)
P – PESEL
R – REGON

26
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 1. In the Social Security Payment:
• This field should contain one character, possible values are: „1”, „2”,
„P”, „R”
1 – identity card (series and number)
2 – passport (series and number)
P – identification number PESEL
R – identification number REGON
Other Identification
2. In the Internal Revenue Payment:
56 Type/Identification
• Field may contain up to 14 characters, for a given type of identification it
Number:
contains:
1 – 2 letters + 7 digits or 3 letters + 6 digits
2 – passport number length is not limited
3 – 14 alphanumeric characters
N - 10 digits (without separators such as minus ‘-‘, space, etc.)
P - 11 digits (without separators such as minus ‘-‘, space, etc.)
R – 9 or 14 digits (without separators such as minus ‘-‘, space, etc.)
1. In the Social Security Payment:
• The field should contain one character, possible values are: „1”, „2”,
„P”, „R”
1 – 2 letters + 7 digits or 3 letters + 6 digits
2 – passport number length is not limited
Other Identification P – 11 digits (without separators such as minus ‘-‘, space, etc.)
57
Number/Year: R – 9 or 14 digits (without separators such as minus ‘-‘, space, etc.)
2. In the Internal Revenue Payment:
Enter last two digits of the year, to which the payment is related.

3. In SEPA transfer this field should contain Beneficiary Bank Code –

the only value that should be entered here is phrase “SWIFT”.
1. In the Social Security Payment:
• The field should contain one character, possible values are: „A”, „B”,
„D”, „E”, „M”, „S”, „T”, „U”
A – additional fee, person
B – additional fee, institution
D – additional fee
E – execution costs
M – time period longer than one month
S – payment for one month
T – delayed payment term
Declaration Type/Period
58 U – installments payment
Type:
2. In the Internal Revenue Payment:
• The field may contain one character, possible values are „J”, „D”, „M”,
„K”, „P”, „R”
J – day
D – ten days of a month
M – month
K – quarter of a year
P – half a year
R – year

1. In the Social Security Payment:

• For all Declaration Types this field must contain up to 6 numeric
characters in YYYYMM format. E.g.: 200503
2. In the Internal Revenue Payment:
• This field may contain up to 4 digits, for a given type of time period it
contains:
59 Declaration Date/Period:
J – 2 digits for a day number, month, e.g. 2704
D – 2 digits for a decade number, month, e.g. 0103
M – 2 digits for a month number, e.g. 03
K – 2 digits for a quarter, e.g. 01,02,03,04
P – 2 digits for a half year, e.g. 01,02
R – leave the field blank

27
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 1. In the Social Security Payment:
• Enter 2 digits:
- for payment type = "S" or "M" field contains a value from 01 to 89
- for payment type = "A", "B", "D", "E", "T" or "U" field contains one of
Declaration Number/Form
60 the values: 01, 40, 51, 70 or 80.
Identifier
2. In the Internal Revenue Payment:
• This field may contain up to 7 characters, indicates the type of a tax
payment, e.g. PIT4, CIT8.
1. In the Social Security Payment:
• In this field enter additional information received from the Social Security
unit:
Decision Number/Free - for Declaration Type = "S" or "M" the line should remain blank
61
Text - for Declaration Type = "A", "B", "D", "E", "T", "U" content other than
spacebar character.
2. In the Internal Revenue Payment:
• This field may contain up to 40 characters.
In this field you should enter the appropriate ID from the list below:

 BIC
 BEI
 EANGLN
Beneficiary Organization
72  CHIPS
ID Type
 DUNS
 Bank Party ID
 Tax ID
 Proprietary ID

This field is required if valid value has been provided for field Beneficiary
Beneficiary Organization
73 Organization ID Type. The maximum allowed length for this field depends
ID
on the type of ID specified in field 72.
This field is required if value for “Proprietary ID” has been provided for
74 Issuer
Beneficiary Organization ID Type (field 72).
This field is taken into account only if you entered OUR or COL in field 22.
76 Charges Account Number If this field is unfilled, debit account will be considered as charges
account.
This field should contain „NOADVISE”, which means: Advice not
77 Beneficiary Advice
required.
94 Payment Title Code This field should be filled if amount of transaction exceeds 100 000 EUR.
95 Payment Description This field should be filled if amount of transaction exceeds 100 000 EUR.

Sample single record of a Domestic Funds Transfer:

#PL#DFT#20110103#####PLN#123.00##6146002#############ABCDE12345############
#######14160012440004061150911111#BENEFICIARY NAME##ADDRESS 1#ADDRESS
2###16001244#####################I150458

Sample single record of a Social Security Payment:

#PL#DFT#20101103####12#PLN#2.02##500156123#############SS1###################8310101023000
0261395100000#ZAKLAD UBEZPIECZEN SPOLECZNYCH##Czerniakowska 16#00-701
WARSZAWA###10101023####5262764847#R#000000000#S#200902#01

Sample single record of an Internal Revenue Payment:

#PL#DFT#20101103####13#PLN#1.01##500156123#############IR1###################67101010100164
212222000000#Pierwszy Mazowiecki Urzad Skarbowy##ul.Mazowiecka 9#Warszawa,NA,00-
052###10101010####N#7010080398#09#M#02#VAT-7#FREE TEXT OR NULL

28
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
Sample single record of a Cross Border Funds Transfer:
#PL#EFT#20101108#####GBP#4.04##500156123##########OUR###REFERE############BENEFICIARY
NAME#STREET AND CODE####Not a Bank##152-614657-221#NAME#####IS#HSBCSGSG####NAME
1#HSBC SINGAPORE, CLAYMOR PREMIER#BRANCH, 6 CLAYMORE HILL, 02-01,#CLAYMORE PLAZA,
SINGAPORE 229571##############SALARY#FOREX RATE: GBP1 - 4,7065####NOADVISE

Sample single record of a SEPA transfer:

#PL#SEPA#20160914####SEPACT#EUR#20000.10##63 1030 1508 0000 0008 1638
7019##########PL#################### ###ORDERING PARTY
NAME####PL#PL48103015080000000100035014#BENEFICIARY NAME##BENEFICIARY ADDRESS
1#BENEFICIARY ADDRESS 2###COBADEDD################################Payment Details Line 1
(Remittance Information Unstructured Line 1)#Payment Details Line 2 (Remittance Information Unstructured Line
2)# Payment Details Line 3 (Remittance Information Unstructured Line 3)#Payment Details Line 4 (Remittance
Information Unstructured Line 4)###

29
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 5. Import Encryption
It is possible to secure the imported transaction files by encrypting and signing them.
To do that, you need:
- Application for encryption and signing compatible with S/MIME (PKCS-7) standard
- Public key PKCS7 for encryption
- X509 certificate v. 3 for signing
Certificate X509 may be downloaded from following providers:
®
- VeriSign
- Thawte Consulting
- Società per iServici Bancari – SSB S.p.A.
- Internet Publishing Services
- Certisign Certification Digital Ltda
- GlobalSign
- British Telecommunications

Public key PKCS7 is available for download from CitiDirect.

To receive a properly signed and encrypted file, you need to attach the public key PKCS7 and X509 certificate in
the encrypting application. In addition, you need to install X509 certificate in CitiDirect.

5.1 Public Key Download

Go to Tools & Preferences in Main Menu, and select S/MIME Security Admin.
Click Download Citibank Certificate. Select PKCS7 format and save the certificate with any name.

30
www.citihandlowy.pl
Bank Handlowy w Warszawie S.A.
 5.2 Installing X509 Certificate

Go to Tools & Preferences in Main Menu, and select S/MIME Security Admin.
Click New and enter any name for the certificate. Click Browse and select an appropriate file with the certificate.
Click Submit.

5.3 Import Profile Configuration

Go to Tools & Preferences in Main Menu, and select Import Profile. Create a new profile or edit an existing one.
In In-Session Profile Parameters section, in Security Method field, select S/MIME – signed and encrypted.
Click an arrow next to the Certificate Name field and select the X509 certificate from the list. Click Submit.

Citi and Citi Handlowy are registered trademarks of Citigroup Inc., used under license. Citigroup Inc. and its subsidiaries are also entitled to
rights to certain other trademarks contained herein. Bank Handlowy w Warszawie S.A. with its registered office in Warsaw at ul. Senatorska
16, 00-923 Warszawa, entered in the Register of Entrepreneurs of the National Court Register by the District Court for the capital c ity of
Warsaw in Warsaw, 12th Commercial Department of the National Court Register, under KRS No. 000 000 1538, NIP 526-030-02-91; the
share capital is PLN 522,638,400, fully paid-up. This advertising material has been published solely for information purposes and it does not
constitute an offer within the meaning of Article 66 of the Civil Code.