Document 3804917

Electronic banking
Document import in TXT.curPaymentISOEx format
files
Version 1.7.F 30.11.2011
Дистанционное Банковское Обслуживание
Импорт документов из файлов в формате TXT.
curPaymentISOEx
Версия 1.7.F от 30.11.2011 г.
Импорт документов из файлов в формате TXT.curPaymentISOEx /
Document import in TXT.curPaymentISOEx format files
Оглавление / Table of Contents
Описание формата ............................................................................................................................... 1
Список полей ......................................................................................................................................... 1
Комментарии: ......................................................................................................................................................... 3
Format description .................................................................................................................................. 3
List of fields ............................................................................................................................................. 3
Comments:............................................................................................................................................................... 4
Пример/Payment example ..................................................................................................................... 5
Описание формата
Данный формат предназначен для импорта документа «Заявление на перевод валюты» из
бухгалтерской/ERP системы в систему Online Banking/PC banking/Business.Online.
Файл формата представляет собой список следующих секций и полей данных:
 Заголовок, содержащий порядковый номер документа в файле и тип формата,
 Секция платёжного документа,
 Заголовок секции данных по обосновывающим документам,
 Заголовок конца данных по обосновывающему документу (если более одного
обосновывающего документа);
 Заголовок конца секции данных по обосновывающим документам,
 Заголовок конца документа.
Импортируемый файл может содержать несколько документов. Для каждого документа используются
свои заголовки.
Необязательные к заполнению поля документа могут передаваться незаполненными.
Каждый документ представляется в виде набора строк, приведённых в строгом порядке в соответствии с
описанием списка полей. В каждой строке передаётся только значение поля, без заголовка.
Особые правила применяются для заполнения данных по обосновывающим документам.
В случае успешного завершения импорта (без ошибок), импортированный документ получает
статус «новый», при наличии ошибок или предупреждений документ получает статус «импортированный».
Тогда для того, чтобы документ принял статус «новый» и был готов к подписанию и отправке в банк, в
документе необходимо исправить ошибки (указанные автоматической системой контролей).
Список полей
Серым цветом выделены поля, не являющиеся обязательными.
№
Описание
поля/Секция
Поле
Пример
Обязательность
Формат
1
Заголовок документа
Startmarker
#1|curPaymentISOEx
Да
2
Дата документа
DocumentDate
12.01.2011
Да
#'{Index}'|curPaymentIS
OEx'
Index – порядковый
номер документа в
файле
| – разделитель
curPaymentISOEx –
тип формата
Date
3
Номер документа
DocumentNumber
147
Да
String
4
Счёт Плательщика
PayerAccount
40702840288881200016
Да
String
5
Имя Бенефициара
BenefName
Beneficiary Royal Oil
Да
String
6
Счёт Бенефициара
BenefAccount
23412146400978144
Да
String
1
13
Описание
поля/Секция
Адрес Бенефициара
Код страны
Бенефициара
Город Бенефициара
Счёт Банка
Бенефициара в БанкеПосреднике
Не обязателен
SWIFT-код Банка
Бенефициара
Не используется
14
Не обязателен
BenBankCountryCode
Нет
String
15
Не обязателен
BenBankName
Нет
String
16
BenBankCity
Нет
String
BenBankAdditional
Да
String
18
Не обязателен
Банк Бенефициара:
Отделение и другие
реквизиты
Банк-посредник
IntBankBIC
MSBKCN22SNT
Да
String
19
Сумма платежа
Amount
42636,70
Да
String
20
Код валюты платежа
Дата Справки о
Валютных Операциях**
Номер Справки о
Валютных Операциях**
Срочность платежа
PaymentCurrency
USD
Да
String
CurTrxRefNoteDate
10.01.2011
Да
Date
CurTrxRefNoteNumber
179
Да
String
Priority
N
Да
Y/N
Назначение платежа
Дополнительные
инструкции
Тип списания комиссии
Счёт списания
комиссии
Код инструкции (Код
операции клиента)
Код услуг (Валютный
Контроль)*
Референс из
сторонней системы
Дата Справки о
Валютных Операциях**
Номер Справки о
Валютных Операциях**
Код услуг (Валютный
Контроль)*
Заголовок секции
данных по
обосновывающим
документам
Обосновывающий
документ: тип
документа
Обосновывающий
документ: данные
документа
Заголовок конца ряда
данных по
обосновывающему
документу***
Заголовок конца секции
данных по
обосновывающим
документам***
Заголовок конца
документа
PaymentDetails
Payment 13486
Да
String
Нет
String
№
7
8
9
10
11
12
17
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
Поле
Пример
BenefAddress
Fifth avenue, 17
Обязательность
Да
BenefCountryCode
040
Да
String
BenefCity
Wien, Austria
Да
String
BenBankAccount
1145130114232
Да
String
Нет
String
Да
String
BenBankClrCode
Нет
String
BenBankAddress
BenBankBIC
BKAUATWW
AuxiliaryDetails
Формат
String
ChargesType
SHA
Да
BEN/OUR/SHA
ChargesAccount
40702840288881200016
Да
String
InstructionCode
40
Нет
String
ServiceCode
119
Нет
String
UserReference
Нет
String
CurrDealInquiryDate
Да
Date
CurrDealIncuiryNumber
Да
String
AddInfoValControl
Нет
String
;NestedTable
Да
;NestedTable
GroundDocuments.Docum
Test passport
entType
Да
String
GroundDocuments.Descri
ption
471441123
Да
String
Nested Table Row
Endmarker
;EndNestedTableRow
Если более 1
обосновыва;EndNestedTableRow
ющего
документа
Nested Table Endmarker
;EndNestedTable
Да
;EndNestedTable
Endmarker
;end
Да
;end
Nested Table Startmarker
2
Комментарии:
*Код услуг ВК можно вводить в любом из отмеченных «*» полей. Сохранится последнее значение.
**Данные Справки можно вводить в любом из отмеченных «**» полей. Сохранятся последние данные.
***Если один обосновывающий документ, то структура файла следующая:
%fields%
;NestedTable
%fields%
;EndNestedTable
;End
Если несколько обосновывающих документов (более 1), то:
%fields%
;NestedTable
%fields%
;EndNestedTableRow
%fields%
;EndNestedTableRow
…
;EndNestedTable
;End
Format description
The given format is intended for document import «the Payment order in foreign currency» from accounting
system (1С/ERP) in Online/PC banking system.
The format file represents the list with following sections and data fields:
 Payment header, including sequence number of the document in import file & format type,
 Payment document,
 Ground documents section header;
 Ground document footer (in case there are more than one ground document);
 Ground documents section footer;
 Payment footer.
The imported file can contain several payment documents. Each document has its own headers.
Optional fields can be empty, or even missed.
Each document is presented as set of rows, with field data.
Fields must be listed in file in described order.
Special rules are applied for filling data about ground documents (described below).
In case of successful import (without errors), the imported document receives the status «New». If there
are any error or warning then document receives the status «imported». It is required to fix errors in document to
change its status to «New». When document has status «New» it is ready to signing and sending into the bank.
List of fields
Optional to filling fields are highlighted as grey.
№
Field description/
Section
Field
Example
Mandatory/
Optional
Format
#'{Index}'|curPaymentISOEx'
Index – serial number of
payment in file
| – separator
curPaymentISOEx – import
format type
Date
1
Payment header
Startmarker
#1|curPaymentISOEx
M
2
Payment date
DocumentDate
12.01.2011
M
3
Payment number
DocumentNumber
String
4
Payer account
PayerAccount
5
Beneficiary name
BenefName
147
M
407028402888812000
M
16
Beneficiary Royal Oil
M
6
Beneficiary account
BenefAccount
23412146400978144
M
String
7
Beneficiary address
BenefAddress
Fifth avenue, 17
M
String
String
String
3
BenefCountryCode
40
Mandatory/
Optional
M
BenefCity
Wien, Austria
M
String
BenBankAccount
1145130114232
M
String
O
String
M
String
13
Beneficiary city
Beneficiary bank account
in Intermediary bank
Not required
Beneficiary bank SWIFTcode
Not used
BenBankClrCode
O
String
14
Not required
BenBankCountryCode
O
String
15
Not required
BenBankName
O
String
16
Not required
Beneficiary bank additonal
information
Intermediary Bank SWIFTcode
Amount
BenBankCity
O
String
BenBankAdditional
M
String
23
Payment Currency
Inquiry of Currency Deal
Date**
Inquiry of Currency Deal
Number**
Priority
24
Payment Details
PaymentDetails
25
Auxiliary Details
AuxiliaryDetails
26
Charges Type
ChargesType
27
Charges Account
ChargesAccount
№
8
9
10
11
12
17
18
19
20
21
22
28
29
30
31
32
33
34
35
36
37
38
39
Field description/
Section
Beneficiary country code
Instruction Code (Client's
operation code)
Service Code (for
Currency Control
services)*
UserReference
Inquiry of Currency Deal
Date**
Inquiry of Currency Deal
Number**
Additional Information for
Currency Control*
Nested Table (for gorund
documents) Startmarker
Ground Document:
document type
Ground Document:
description
Field
Example
BenBankAddress
BenBankBIC
BKAUATWW
Format
String
IntBankBIC
MSBKCN22SNT
M
String
Amount
42636,70
M
String
PaymentCurrency
USD
M
String
CurTrxRefNoteDate
10.01.2011
M
Date
M
String
M
Y/N
M
String
O
String
CurTrxRefNoteNumbe
179
r
Priority
N
Payment 13486
SHA
M
407028402888812000
M
16
BEN/OUR/SHA
InstructionCode
40
O
String
ServiceCode
119
O
String
UserReference
O
String
CurrDealInquiryDate
M
Date
CurrDealIncuiryNumbe
r
M
String
AddInfoValControl
O
String
M
;NestedTable
M
String
M
String
;EndNestedTableRow
If there are
more than 1
ground
document
;EndNestedTableRow
;EndNestedTable
M
;EndNestedTable
;end
M
;end
Nested Table
;NestedTable
Startmarker
GroundDocuments.Do
Test passport
cumentType
GroundDocuments.De
471441123
scription
Nested Table Row
Endmarker***
Nested Table Row
Endmarker
Nested Table
Endmarker***
Endmarker
Nested Table
Endmarker
Endmarker
String
Comments:
*Service Code for Currency Control can be inputted in any of marked “*” fields, last inserted value will be
stored.
**Information about Inquiry of Currency Deal can be inputted into any of marked “**” fields, inputted value in
last field will be stored.
***
If only one ground document exist, then import file structure is:
%fields%
;NestedTable
4
%fields%
;EndNestedTable
;End
If it is required to input set of ground documents (more than 1), then:
%fields%
;NestedTable
%fields%
;EndNestedTableRow
%fields%
;EndNestedTableRow
…
;EndNestedTable
;End
Пример/Payment example
Данный пример содержит информацию о банке-посреднике, Справке о Валютных Операциях, два
обосновывающих документа.
The given example including information about intermediary bank, Inquiry about Currency Deal, two ground
documents.
#1|curPaymentISOEx
12.01.2011
147
40702840288881200016
Beneficiary Royal Oil
23412146400978144
Fifth avenue, 17
040
Wien, Austria
1145130114232
BKAUATWW
MSBKCN22SNT
42636,70
USD
10.01.2011
179
N
##. 13486
SHA
40702840288881200016
40
119
;NestedTable
Test passport
471441123
;EndNestedTableRow
Test Inquiry
149
;EndNestedTable
;End
5