Hal E-Bank Foreign payments (Format of export/import files)

Transcription

1 Hal E-Bank Foreign payments (Format of export/import files) Hal E-Bank Foreign payments: format of export/import files Version: 17.x.x.20 Author: HALCOM d.d., Ljubljana Editor: HALCOM a.d., Beograd, July Halcom d.d., Ljubljana

2 Contents 1. Payment orders Payment orders using subaccounts Inflow Currency exchange rate lists The Address book import/export data-file format Table of figures Table 1: Structure record of payment order VP Table 2: Structure record of payment order VP 70 with sub-accounts... 8 Table 3: Structure record of inflow... 9 Table 4: Structure record of currency exchange rate list header row Table 5: Structure record of currency exchange rate list currency row Table 6: Structure record of address book entry row... 12

3 1. Payment orders There can be any number of orders in the file (*.txt). Each row contains data for single payment order. Rows and fields have fixed lengths of characters. Table 1 describes the structure of data for single payment order (imported or exported from Hal E-Bank): No. Field Beginning Length Mandatory Comment 1. Unique order ID 1 16 Disregarded during import 2. Client`s bank registration number Usually empty 3. Client`s registration number Disregarded during import. If entered, is replaced by Hal-Bank user`s registration number 4. Document type 41 2 * Fixed text (without quotes): "70" 5. Payment instrument code 43 1 * Number in Payment instrument codes list (1 to 6 is used) (page 29) 6. Reference of the person in charge Usually empty 7. Reference Up to 8 characters allowed (the rest are blanks) 8. Mode of payment realization Text (Cheque, Cash, Wage) or any other text 9. Mode of payment realization 89 2 Number (0 - Cheque, 1 - Cash, 2 - Wage) 10. Beneficiary s account * 11. Beneficiary s name * 12. Beneficiary s address * 13. Beneficiary s city * 14. Beneficiary s country Country name in Country codes list (ISO 3166) 15. Country code * Country code in Country codes list (ISO 3166) 16. Name of Beneficiary s bank * 17. Beneficiary s bank address Beneficiary`s bank city * 19. Beneficiary s bank country Country name in Country codes list (ISO 3166) 20. Beneficiary s bank BIC *

4 No. Field Beginning Length Mandatory Comment 21. Beneficiary s bank country code * Country code in Country codes list (ISO 3166) 22. Currency code Currency code number in Currency codes list (ISO 4127) 23. Currency label * Currency label in Currency codes list (ISO 4127) 24. Amount * Left aligned (decimal separator is ",") 25. Payment purpose * This field (or the next one, two or three field(s)) must be filled. These fields can have up to 16 characters. 26. Payment purpose Mandatory only if the previous field (payment purpose 1) is not filled 27. Payment purpose Previous field sequel 28. Payment purpose Previous field sequel 29. Domestic commission * N - Debtor U - Creditor 30. Foreign commission * N - Debtor U - Creditor Available commission combinations: NN OUR (Our) NU SHA (Shared) UU BEN (Beneficiary) 31. Special instructions Additional comments 32. Special instructions Additional comments 33. Payment code Fixed text (without quotes): "000" 34. Loan number and loan year Format: yyyy-nnnnnn (yyyy year of the loan, nnnnnn 1 to 6 characters of number of the loan). If year and number of the loan are not given, then "-" replaces them. 35. Loan description * Fixed text (without quotes): "LOAN REG. NUMBER AND LOAN YEAR-" 36. Amount Fixed text (without quotes): "0,00" 37. Statistics: Payment code * Mandatory payment code in reference codes list, if amount 1 is not zero. (page 2) 38. Statistics: number of the loan Same as field Statistics: Payment description * Mandatory payment description in reference codes list, if

5 No. Field Beginning Length Mandatory Comment amount 1 is not zero. (page 2) 40. Statistics: Amount * Amount can be negative. 41. Statistics: Payment code Statistics: number of the loan Statistics: Payment description Statistics: Amount Statistics: Payment code Statistics: number of the loan Statistics: Payment description Statistics: Amount Statistics: Payment code Statistics: number of the loan Statistics: Payment description Statistics: Amount Statistics: Payment code Statistics: number of the loan Statistics: Payment description Statistics: Amount Statistics: Payment code Statistics: number of the loan Statistics: Payment description Statistics: Amount Statistics: Payment code Statistics: number of the loan Statistics: Payment description Statistics: Amount Covering YUM account Covering YUM amount Foreign exchange cover account Foreign exchange cover currency code * The same as for Statistics 1 applies to all other statistics! Total value of statistics items has to be equal to value of field value 24, otherwise the input is invalid! The same as for Statistics 1 applies to all other statistics! Total value of statistics items has to be equal to value of field value 24, otherwise the input is invalid! The same as for Statistics 1 applies to all other statistics! Total value of statistics items has to be equal to value of field value 24, otherwise the input is invalid! The same as for Statistics 1 applies to all other statistics! Total value of statistics items has to be equal to value of field value 24, otherwise the input is invalid! The same as for Statistics 1 applies to all other statistics! Total value of statistics items has to be equal to value of field value 24, otherwise the input is invalid! The same as for Statistics 1 applies to all other statistics! Total value of statistics items has to be equal to value of field value 24, otherwise the input is invalid! Not used Mandatory, if foreign exchange cover is in foreign currency. Currency code in Currency codes list (ISO 4127)

6 No. Field Beginning Length Mandatory Comment 69. Foreign exchange cover currency label * Mandatory, if foreign exchange cover is in foreign currency. Currency code label in Currency codes list (ISO 4127) 70. Cover status Commission amount Left aligned (decimal separator is ","). Default is 0, Name of intermediary bank BIC of intermediary bank Account of intermediary bank Address of intermediary bank City of intermediary bank Country code of intermediary bank Country code in Country codes list (ISO 3166) 78. Country name of intermediary bank Country name in Country codes list (ISO 3166) 79. Requested date of payment Format: yyyymmdd (year, month, day without delimiters) 80. End of line * 0x0D, 0x0A (line feed, carriage return) Table 1: Structure record of payment order VP 70

7 2. Payment orders using subaccounts Some banks support the entry of sub-account cover for payment orders. In this case, the data on sub-account cover when import/export files are ignored. There can be any number of orders in the file (*.txt). Each row contains data for single payment order with sub-account cover. Record structure is the same as for the payment order without sub-account (see Table 1 without field 80), with the expansion of additional fields per specification shown in Table 2: No. Field Beginning Length Mandatory Comment 80. Subaccount: account number * 81. Subaccount: account currency label * Currency code label in Currency codes list (ISO 4127) 82. Subaccount: Client type Not used! 83. Subaccount: account value * Left aligned (decimal separator is ","). Default is 0, Subaccount: account number Subaccount: account currency label Subaccount: Client type Subaccount: account value Subaccount: account number Subaccount: account currency label Subaccount: Client type Subaccount: account value Subaccount: account number Subaccount: account currency label Subaccount: Client type Subaccount: account value Subaccount: account number Subaccount: account currency label Subaccount: Client type Subaccount: account value Subaccount: account number Subaccount: account currency label

8 No. Field Beginning Length Mandatory Comment 102. Subaccount: Client type Subaccount: account value Subaccount: account number Subaccount: account currency label Subaccount: Client type Subaccount: account value Subaccount: account number Subaccount: account currency label Subaccount: Client type Subaccount: account value Subaccount: account number Subaccount: account currency label Subaccount: Client type Subaccount: account value Subaccount: account number Subaccount: account currency label Subaccount: Client type Subaccount: account value End of line * 0x0D, 0x0A (line feed, carriage return) Table 2: Structure record of payment order VP 70 with sub-accounts

9 3. Inflow Information on inflow can only be exported from Hal E-Bank system. Each inflow creates one row in an export file. All rows and fields have fixed lengths. The structure record of exported inflow is shown in Table 3: No. Field Beginning Length Comment 1. Bank reference 1 12 Leading characters are spaces 2. Code of sender country BIC of sender bank Name of sender bank Leading characters are spaces 5. Name of sender Leading characters are spaces 6. Purpose of inflow Leading characters are spaces 7. Purpose Leading characters are spaces 8. Currency label Amount Leading characters are spaces 10. Date of inflow yyyymmdd (for example ) 11. Original inflow amount End of line x0D, 0x0A (line feed, carriage return) Table 3: Structure record of inflow

10 4. Currency exchange rate lists Currency exchange rate lists can only be exported from Hal E-Bank system. Export file has following rows: First row is a record that contains currency exchange rate list header. Following rows are records that contain currency exchange rates; a separate row for each currency. No. Field Beginning Length Comment 1. Ordinal number of Central bank`s exchange rates list Date of the list (from date) 5 8 Format: yyyymmdd (for example ) 3. Date of the list (to date) 12 8 Format: yyyymmdd 4. End of line x0D, 0x0A (line feed, carriage return) Table 4: Structure record of currency exchange rate list header row No. Field Beginning Length Comment 1. Currency short name Currency code Number of units or Buying rate of CB Leading zeroes 5. Middle rate of CB Leading zeroes 6. Selling rate of CB Leading zeroes 7. Buying rate of the bank Leading zeroes 8. Selling rate of the bank Leading zeroes 9. End of line x0D, 0x0A (line feed, carriage return) Table 5: Structure record of currency exchange rate list currency row

11 5. The Address book import/export data-file format Each record contains information about business partner and one of his accounts. An example a record for import into personal Address Book is shown in the frame. (One complete record is shown in the frame, which, due to its length is divided into multiple rows): " LEGAL ENTITY","STREET AND STREET 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 THE REFERENCE NUMBER OF THE BANK","BANK`S ACCOUNT NUMBER AT THE CB",0, "<IDTP>0</IDTP>"," " Record format description: Each row contains 18 fields / columns, Content of each field is enclosed by quotation marks, except field 16, Delimiter between fields is comma, Empty fields are represented by double quotation marks (""), Fields with key information cannot be empty, Each row ends with 0x0D, 0x0A (line feed, carriage return). Note: Double quotation mark within the field is displayed as a single quotation mark. E.g. "THIS IS """ is imported as THIS IS ". Information is divided into three groups by their contents: o Fields 1 to 5 and 16 to 18 contain information about the beneficiary. o Fields 6 and 14 contain information about the account model and the reference number. o Fields between 7 and 13, and field 15 contain information about the bank with which the account is held. The information about the bank is compared with the Address Book of banks data during importing. In fields 6 and 13, allowed characters are only digits from 0 to 9 and hyphen" " The address book is organized also to include information about beneficiary's account in foreign banks. This additional data Hal E-Bank program does not use for domestic payment operations.

12 Optional and mandatory fields and maximum width of fields are shown in Table 6. If Field 6 (account number) is empty, only the information about beneficiary is imported into the Address Book. If Field 6 is filled, then fields 7, 9, 10 have to be filled as well. No. Mandatory Maximum width (characters) Field contents 1. * 35 Beneficiary name Beneficiary street and home number 3. * 35 Beneficiary postal code and town 4. * 35 Beneficiary country Beneficiary comment Beneficiary account number in the form Bank name, which holds the account (in field 6) Bank street and street number Bank postal code and town Bank country Account comment Bank BIC address Country 2-character alpha code in Country codes list (ISO 3166) (e.g. RS Serbia, DE Germany ) Model (first two characters) and call of the account Bank account number in NBS 16. * 1 User type (always is 0). This field is entered without quotes! Serialized record. Not used during import (always empty "") Beneficiary tax number 19. * 2 0x0D, 0x0A (line feed, carriage return) Table 6: Structure record of address book entry row