|
|
Electronic banking
|
Дистанционное Банковское Обслуживание
|
Document import in TXT.curPaymentISOEx format files
|
Импорт документов из файлов в формате TXT. curPaymentISOEx
|
Version 1.7.F 30.11.2011
|
Версия 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
|
Да
|
#'{Index}'|curPaymentISOEx'
Index – порядковый номер документа в файле
| – разделитель
curPaymentISOEx – тип формата
|
2
|
Дата документа
|
DocumentDate
|
12.01.2011
|
Да
|
Date
|
3
|
Номер документа
|
DocumentNumber
|
147
|
Да
|
String
|
4
|
Счёт Плательщика
|
PayerAccount
|
40702840288881200016
|
Да
|
String
|
5
|
Имя Бенефициара
|
BenefName
|
Beneficiary Royal Oil
|
Да
|
String
|
6
|
Счёт Бенефициара
|
BenefAccount
|
23412146400978144
|
Да
|
String
|
№
|
Описание поля/Секция
|
Поле
|
Пример
|
Обязатель-ность
|
Формат
|
7
|
Адрес Бенефициара
|
BenefAddress
|
Fifth avenue, 17
|
Да
|
String
|
8
|
Код страны Бенефициара
|
BenefCountryCode
|
040
|
Да
|
String
|
9
|
Город Бенефициара
|
BenefCity
|
Wien, Austria
|
Да
|
String
|
10
|
Счёт Банка Бенефициара в Банке-Посреднике
|
BenBankAccount
|
1145130114232
|
Да
|
String
|
11
|
Не обязателен
|
BenBankAddress
|
|
Нет
|
String
|
12
|
SWIFT-код Банка Бенефициара
|
BenBankBIC
|
BKAUATWW
|
Да
|
String
|
13
|
Не используется
|
BenBankClrCode
|
|
Нет
|
String
|
14
|
Не обязателен
|
BenBankCountryCode
|
|
Нет
|
String
|
15
|
Не обязателен
|
BenBankName
|
|
Нет
|
String
|
16
|
Не обязателен
|
BenBankCity
|
|
Нет
|
String
|
17
|
Банк Бенефициара: Отделение и другие реквизиты
|
BenBankAdditional
|
|
Да
|
String
|
18
|
Банк-посредник
|
IntBankBIC
|
MSBKCN22SNT
|
Да
|
String
|
19
|
Сумма платежа
|
Amount
|
42636,70
|
Да
|
String
|
20
|
Код валюты платежа
|
PaymentCurrency
|
USD
|
Да
|
String
|
21
|
Дата Справки о Валютных Операциях**
|
CurTrxRefNoteDate
|
10.01.2011
|
Да
|
Date
|
22
|
Номер Справки о Валютных Операциях**
|
CurTrxRefNoteNumber
|
179
|
Да
|
String
|
23
|
Срочность платежа
|
Priority
|
1
|
Да
|
1 срочный / пусто - обычный
|
24
|
Назначение платежа
|
PaymentDetails
|
Payment 13486
|
Да
|
String
|
25
|
Дополнительные инструкции
|
AuxiliaryDetails
|
|
Нет
|
String
|
26
|
Тип списания комиссии
|
ChargesType
|
SHA
|
Да
|
BEN/OUR/SHA
|
27
|
Счёт списания комиссии
|
ChargesAccount
|
40702840288881200016
|
Да
|
String
|
28
|
Код инструкции (Код операции клиента)
|
InstructionCode
|
40
|
Нет
|
String
|
29
|
Код услуг (Валютный Контроль)*
|
ServiceCode
|
119
|
Нет
|
String
|
30
|
Референс из сторонней системы
|
UserReference
|
|
Нет
|
String
|
31
|
Дата Справки о Валютных Операциях**
|
CurrDealInquiryDate
|
|
Да
|
Date
|
32
|
Номер Справки о Валютных Операциях**
|
CurrDealIncuiryNumber
|
|
Да
|
String
|
33
|
Код услуг (Валютный Контроль)*
|
AddInfoValControl
|
|
Нет
|
String
|
34
|
Заголовок секции данных по обосновывающим документам
|
Nested Table Startmarker
|
;NestedTable
|
Да
|
;NestedTable
|
35
|
Обосновывающий документ: тип документа
|
GroundDocuments.DocumentType
|
Test passport
|
Да
|
String
|
36
|
Обосновывающий документ: данные документа
|
GroundDocuments.Description
|
471441123
|
Да
|
String
|
37
|
Заголовок конца ряда данных по обосновывающему документу***
|
Nested Table Row Endmarker
|
;EndNestedTableRow
|
Если более 1 обосновыва-ющего документа
|
;EndNestedTableRow
|
38
|
Заголовок конца секции данных по обосновывающим документам***
|
Nested Table Endmarker
|
;EndNestedTable
|
Да
|
;EndNestedTable
|
39
|
Заголовок конца документа
|
Endmarker
|
;end
|
Да
|
;end
|
Комментарии:
*Код услуг ВК можно вводить в любом из отмеченных «*» полей. Сохранится последнее значение.
**Данные Справки можно вводить в любом из отмеченных «**» полей. Сохранятся последние данные.
***Если один обосновывающий документ, то структура файла следующая:
%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
|
1
|
Payment header
|
Startmarker
|
#1|curPaymentISOEx
|
M
|
#'{Index}'|curPaymentISOEx'
Index – serial number of payment in file
| – separator
curPaymentISOEx – import format type
|
2
|
Payment date
|
DocumentDate
|
12.01.2011
|
M
|
Date
|
3
|
Payment number
|
DocumentNumber
|
147
|
M
|
String
|
4
|
Payer account
|
PayerAccount
|
40702840288881200016
|
M
|
String
|
5
|
Beneficiary name
|
BenefName
|
Beneficiary Royal Oil
|
M
|
String
|
6
|
Beneficiary account
|
BenefAccount
|
23412146400978144
|
M
|
String
|
7
|
Beneficiary address
|
BenefAddress
|
Fifth avenue, 17
|
M
|
String
|
№
|
Field description/
Section
|
Field
|
Example
|
Mandatory/
Optional
|
Format
|
8
|
Beneficiary country code
|
BenefCountryCode
|
40
|
M
|
String
|
9
|
Beneficiary city
|
BenefCity
|
Wien, Austria
|
M
|
String
|
10
|
Beneficiary bank account in Intermediary bank
|
BenBankAccount
|
1145130114232
|
M
|
String
|
11
|
Not required
|
BenBankAddress
|
|
O
|
String
|
12
|
Beneficiary bank SWIFT-code
|
BenBankBIC
|
BKAUATWW
|
M
|
String
|
13
|
Not used
|
BenBankClrCode
|
|
O
|
String
|
14
|
Not required
|
BenBankCountryCode
|
|
O
|
String
|
15
|
Not required
|
BenBankName
|
|
O
|
String
|
16
|
Not required
|
BenBankCity
|
|
O
|
String
|
17
|
Beneficiary bank additonal information
|
BenBankAdditional
|
|
M
|
String
|
18
|
Intermediary Bank SWIFT-code
|
IntBankBIC
|
MSBKCN22SNT
|
M
|
String
|
19
|
Amount
|
Amount
|
42636,70
|
M
|
String
|
20
|
Payment Currency
|
PaymentCurrency
|
USD
|
M
|
String
|
21
|
Inquiry of Currency Deal Date**
|
CurTrxRefNoteDate
|
10.01.2011
|
M
|
Date
|
22
|
Inquiry of Currency Deal Number**
|
CurTrxRefNoteNumber
|
179
|
M
|
String
|
23
|
Priority
|
Priority
|
N
|
M
|
Y/N
|
24
|
Payment Details
|
PaymentDetails
|
Payment 13486
|
M
|
String
|
25
|
Auxiliary Details
|
AuxiliaryDetails
|
|
O
|
String
|
26
|
Charges Type
|
ChargesType
|
SHA
|
M
|
BEN/OUR/SHA
|
27
|
Charges Account
|
ChargesAccount
|
40702840288881200016
|
M
|
String
|
28
|
Instruction Code (Client's operation code)
|
InstructionCode
|
40
|
O
|
String
|
29
|
Service Code (for Currency Control services)*
|
ServiceCode
|
119
|
O
|
String
|
30
|
UserReference
|
UserReference
|
|
O
|
String
|
31
|
Inquiry of Currency Deal Date**
|
CurrDealInquiryDate
|
|
M
|
Date
|
32
|
Inquiry of Currency Deal Number**
|
CurrDealIncuiryNumber
|
|
M
|
String
|
33
|
Additional Information for Currency Control*
|
AddInfoValControl
|
|
O
|
String
|
34
|
Nested Table (for gorund documents) Startmarker
|
Nested Table Startmarker
|
;NestedTable
|
M
|
;NestedTable
|
35
|
Ground Document: document type
|
GroundDocuments.DocumentType
|
Test passport
|
M
|
String
|
36
|
Ground Document: description
|
GroundDocuments.Description
|
471441123
|
M
|
String
|
37
|
Nested Table Row Endmarker***
|
Nested Table Row Endmarker
|
;EndNestedTableRow
|
If there are more than 1 ground document
|
;EndNestedTableRow
|
38
|
Nested Table Endmarker***
|
Nested Table Endmarker
|
;EndNestedTable
|
M
|
;EndNestedTable
|
39
|
Endmarker
|
Endmarker
|
;end
|
M
|
;end
|
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
%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
|
