Hal E-Bank
(Format of export/import files Montenegro)
Hal E-Bank – Domestic payments: format of export/import files
Version: 15.x.x.40
Author: HALCOM d.d., Ljubljana
Editor: HALCOM a.d., Beograd
© 2011 Halcom d.d., Ljubljana
Contents
1
Hal E-Bank: Domestic payments formats ........................................................................................ 3
1.1
Payment orders - export .......................................................................................................... 3
1.2
Payment orders - import .......................................................................................................... 4
1.3
Transactions and statement ..................................................................................................... 5
1.4
Statement recapitulation .......................................................................................................... 6
1.5
The Address book import/export data-file format ................................................................ 6
2
1 Hal E-Bank: Domestic payments formats
1.1 Payment orders - export
Files of exported payment orders (chapter Settings of domestic
payment of payment orders) are composed of rows with header
sentence, row with summary sentence and one or more rows with
individual sentences containing payment orders data.
The line of header sentence has the format as follows:
Position Length Type
Contents
1
18
N
Ordering party account
number
1
5
- Numeric bank code
Account number,
6
3
- Account from the general
name and location
ledger
are copied from
9
3
-Control number (module 11)
first order in the
12
7
-Individual account (last digit is
file.
the check digit)
19
35
C
Ordering party name
54
10
C
Ordering party city
64
6
D
Value date – only if value date is the same for all
orders(ddmmyy)
70
168
180
181
98
12
1
2
C
N
C
Empty (space, " ")
Spaces or string „MULTI E-BANK“
Sentence type (0 – header sentence)
End of line (0x0D – carriage return, 0x0A – Line feed)
The line of summary sentence has the format as follows:
Position Length Type
1
18
N
Ordering party
account number
Contents
1
5
- Numeric bank code
6
3
9
3
- Account from the general
ledger
-Check digits (module 11)
12
7
-Individual account (last digit
is the check digit)
19
54
64
35
10
15
C
C
N
79
84
180
181
5
96
1
2
N
N
C
Account number,
name and location
are copied from
first order in the
file.
Ordering party name
Ordering party city
Summ of amounts of all orders (last 2 digits
are decimal digits without a decimal point)
Number of debit orders
Empty (space, " ")
Sentence type (9 – summary sentence)
End of line (0x0D – carriage return, 0x0A – Line feed)
3
The line of individual sentence has the following format:
Position Length Type
Contents
1
18
N
Beneficiary account number
1
6
5
3
- Numeric bank code
- Account from the general ledger
9
3
-Check digits (module 11)
12
7
-Individual account (last digit is the check
digit)
19
54
64
65
67
89
125
130
131
35
10
1
2
23
36
5
1
1
C
C
132
2
C
134
1
N
135
136
1
13
N
149
151
173
179
2
23
6
1
N
C
D
N
180
1
N
N
C
C
C
Mandatory
*
Beneficiary name
Beneficiary city
Filled with "0"
Model of debit reference
Debit reference
Payment details
Filled with "00000"
Empty (blank, " ")
Form of payment (always "1" )
*
Payment code (according to
code table collection trn.dat)
Form of payment (empty space
" "–for transfer or compensation
or "9" – for return of funds
Empty (spaces, " ")
Amount - value with pars with
two decimal places, without a
comma (justified right) E.g.:
2546400 = 25.464,00
Model of credit reference
Credit reference
Value date (DDMMGG)
Document type “1” - payment
order, “4” - compensation
Sentence type ( "1" – individual
*
*
*
*
*
*
sentence)
181
2
C
End of line
(0x0D – carriage return,
0x0A – Line feed)
*
Files ends with 0x1A.
1.2 Payment orders - import
Imported orders should be in the same format as described in the previous
chapter.
4
1.3 Transactions and statement
The line for export transactions and statements has the following content:
Position Length Type
1
18
N
Contents
Partner’s account (debit or credit – depends of
transaction type)
1
6
5
3
- Numeric bank`s code
- Account from general ledger
9
3
-Check digits (module 11)
12
7
-Individual account (last digit is the check digit)
19
21
29
31
66
67
73
2
8
2
35
1
6
18
C
D
C
C
D
N
Type of payment(„10“ – debit, „20“ – credit)
Processing date – booking date ( DD.MM.YY)
Transaction reversal (S), otherwise empty
Ordering party name
Empty (spaces, " ")
Value date (DDMMYY)
Ordering party account number
1
6
5
3
- Numeric bank`s code
- Account from the general ledger
9
3
-Check digits (module 11)
12
7
-Individual account (last digit is the check digit)
91
15
N
106
107
108
110
1
1
2
2
C
C
C
112
2
N
114
22
C
136
2
C
138
22
C
160
196
206
241
263
36
10
35
22
18
C
C
C
C
N
Amount - value with two decimal
digits, without a decimal point (justified right)
E.g.: 2546400 = 25.464,00
Empty (space, “ ”)
Form of payment
Code of payment
Empty (space, " ")
Model of Debit reference ("0", "00" or the value
sent by the bank)
Debit reference (empty or the value sent by the
bank)
Model of Credit reference ("0", "00" or the value
sent by the bank)
Credit reference(empty or the value sent by the
bank)
Paymeny details
Beneficiary address
Beneficiary name
Transaction reference number
Beneficiary account number or empty
1
6
5
3
- Numeric bank`s code
- Account from general ledger
9
3
-Check digits (module 11)
12
7
-Individual account (last digit is check digit)
281
2
C
End of line (0x0D, 0x0A)
File ends with symbol 0x1A.
5
Statement recapitulation
Format of the recapitulation statement line is:
Position Dength Type
Contents
1
2
N
Type of sentence: 01 – account balance
3
18
N
Ordering party account number
21
29
37
55
61
79
85
103
121
127
145
148
1
6
5
3
- Numeric bank`s code
- Account from the general ledger
9
3
-Check digits (module 11)
12
7
-Individual account (last digit isthe check digit)
8
8
18
6
18
6
18
18
6
18
3
2
File ends with
D
D
N
N
N
N
N
N
N
N
N
C
symbol
Processing date – booking date (DD.MM.YYYY)
Previous statement date (DD.MM.YYYY)
Previous statement balance
Number of debit transactions
Sum of debit transactions per day
Number of credit transactions
Sum of credit transactions per day
Closing balance
Number of transactions waiting for funds
Summary amount of waiting transactions
Statement number
End of line (0x0D – carriage return, 0x0A – Line feed)
0x1A.
1.4 The Address book import/export data-file format
The file in each record contains information about a business
partner and one of his accounts. An example of a text file record for
import into the personal Address Book of partners is shown in the
frame. (One complete record is in the frame, which, due to its length is split
in rows):
"NAME OF LEGAL ENTITY","STREET AND HOME NUMBER","POSTAL CODE
AND TOWN","COUNTRY","COMMENT","ACCOUNT NUMBER","NAME OF THE
BANK, WITH WHICH THE ACCOUNT IS HELD","STREET AND STREET NUMBER
OF THE BANK","POSTAL CODE AND TOWN OF THE BANK","COUNTRY OF THE
BANK","COMMENT OF THE BANK","BANK`S BIC CODE","MODEL AND
REFERENCE"
Record format description:

each section contains 15 fields/columns,

the content of each field is between two double quotation marks,

separation between the fields is marked by a comma,

empty fields are represented by two double-quotation marks („“),

fields with key information cannot be empty
6
Note: Double-quotation mark within the field is displayed as two double-quotation
marks. Thus, for example "THIS IS """ is imported as THIS IS ".
Information is divided into three groups:
• Fields 1 to 5 contain information about the beneficiary.
• Fields 6 and 13 contain information about the account model and reference
(usually empty).
• Fields between 7 and 12, and field 15 contain information about
the bank with which the account is held. The information about
the bank is compared with the Banks Address Book
• In fields 6 and 13, allowed characters are only numbers from 0 to
9 and a hyphen "-".
Note: The address book is organized to include information about the beneficiary's
account in foreign banks, which the Hal E-Bank program
does not use for domestic payment operations.
Optional and mandatory fields and maximum width of fields are shown in the
table below. Mandatory fields, which must not be empty, are specially marked with
an M. If the field 6 (account number) is empty, only the information about the
beneficiary is imported into the Address Book. If the field 6 is not empty, then
fields 7, 9, 10 must not be empty either.
Field
number
Length
1
35
2
3
4
5
6
35
35
35
140
34
7
35
8
35
9
35
10
35
11
2
12
140
13
11
14
24
15
35
16
2
Mandatory
M
M
M
Field contents
Name of legal entity or name and
surname of physical entity
Street and home number
Postal code and town
Country
Comment
Account number
Name of the bank, with which the
account is held
Street and street number of the bank
with which the account is held
Postal code and town of the bank
with which the account is held
Country of the bank with which the
account is held
Country code (RS, HR, DE...)
Comment of the bank with which the
account is held
BIC code of the bank, with which the
account is held
Model (first two characters) and
reference of the account
Account number of the bank with
which the account is held
0x0D, 0x0A (line feed, carriage
return)
7