Import Export Format

You might also like

Download as pdf or txt
Download as pdf or txt
You are on page 1of 114

Інтерактивна система фронт-офісного

обслуговування клієнтів банку

iFOBS
Формат файлу імпорту / експорту

Інструкція користувача
Опис форматів файлів імпорту та експорту
ЗМІСТ

1.ВСТУП ............................................................................ 5
1.1. Таблиця форматів ........................................................ 5

ВАЛЮТНИХ ДОКУМЕНТІВ..................................................... 5

ВАЛЮТНИХ ДОКУМЕНТІВ..................................................... 5
1.2. Розшифровка типу даних ............................................. 6

2.ІМПОРТ ДОКУМЕНТІВ В НАЦІОНАЛЬНІЙ ВАЛЮТІ ................. 7


2.1. Імпорт з файлів формату DAT, TXT, CSV ......................... 7
2.2. Імпорт з DBF-файлу ..................................................... 9
2.3. Імпорт з XML-файла ................................................... 10
2.4. Імпорт з XLS-файлу ................................................... 12
2.5. Імпорт з файлу даних клієнт-банку SAP R / 3 (МТС) ..... 13
2.6. Імпорт з файлу TXT (SEB) .......................................... 15
2.7. Імпорт з файлу 1С ..................................................... 16
2.8. Імпорт документів інформаційного дебету з TXT-
файлу ................................................................................ 21

3.ІМПОРТ ВАЛЮТНИХ ДОКУМЕНТІВ .................................... 23


3.1. Імпорт з файлу даних клієнт-банку (DAT, TXT) ............. 23
3.1.1. Імпорт валютного платіжного доручення ...................... 23
3.1.2. Імпорт заявки на купівлю валюти................................. 30
3.1.3. Імпорт заявки на продаж валюти ................................. 33
3.1.4. Імпорт заявки на конверсію валюти ............................. 35
3.1.5. Імпорт заявки на розподіл валюти ............................... 38
3.1.6. Імпорт форвардних заявок .......................................... 40
3.2. Імпорт з розширеного файлу даних клієнт-банку
(EXP) ................................................................................ 43
3.2.1. Імпорт валютного платіжного доручення ...................... 43
3.3. Імпорт з файлу даних клієнт-банку
(альтернативний) ..................................................................... 51
3.3.1. Імпорт заявки на покупку валюти ................................ 51
3.3.2. Імпорт заявки на продаж валюти ................................. 54
3.3.3. Імпорт заявки на конверсію валюти ............................. 55
3.4. Імпорт з файлу даних клієнт-банку SAP R / 3 .............. 57
3.4.1. Імпорт валютного платіжного доручення ...................... 57
3.4.2. Імпорт валютного документа........................................ 63
3.5. Імпорт з XLS-файлу ................................................... 64
3.5.1. Імпорт заявки на продаж валюти ................................. 64

4.ЕКСПОРТ ЕЛЕКТРОННОЇ ВИПИСКИ................................... 66


4.1. Експорт електронної виписки в текстовий і BOL-
файл 66
4.2. Експорт електронної виписки в DBF-файл ................... 69
4.3. Експорт електронної виписки в DBF-файл
(альтернативний) ..................................................................... 71
4.4. Експорт електронної виписки в XLS-файл ................... 71
4.5. Експорт електронної виписки в XML-файл ................... 72
4.6. Експорт електронної виписки в файл формату SAP R
/ 3 (МТС) ................................................................................ 74
4.7. Експорт електронної виписки в файл формату 1С ........ 77
4.8. Експорт в файл TXT (SEB) .......................................... 82
4.9. Експорт в файл XLS (SEB) .......................................... 82
4.10. Експорт у форматі МТ94x ........................................... 84
4.10.1. Експорт у форматі MT940............................................. 84
4.10.2. Експорт у форматі MT942............................................. 86

5.ЕКСПОРТ ВАЛЮТНИХ ДОКУМЕНТІВ .................................. 88


5.1. Експорт в файл даних клієнт-банку (DAT, TXT) ............ 88
5.1.1. Експорт валютного платіжного доручення..................... 88
5.1.2. Експорт заявок на покупку валюти............................... 89
5.1.3. Експорт заявок на продаж валюти ................................ 90
5.1.4. Експорт заявок на конверсію валюти ............................ 92
5.1.5. Експорт заявок на розподіл валюти .............................. 92
5.1.6. Експорт форвардних заявок ......................................... 93
5.2. Експорт в розширений файл даних клієнт-банку
(EXP) ................................................................................ 94
5.2.1. Експорт валютного платіжного доручення..................... 94
5.3. Експорт в файл даних клієнт-банку
(альтернативний) ..................................................................... 96
5.3.1. Експорт заявок на покупку валюти ............................... 96
5.3.2. Експорт заявок на продаж валюти ................................ 97
5.3.3. Експорт заявок на конверсію валюти ............................ 97
5.4. Експорт в XML-файл .................................................. 97
5.4.1. Експорт валютного платіжного доручення..................... 98
5.4.2. Експорт заявок на купівлю валюти ............................. 101
5.4.3. Експорт заявок на продаж валюти.............................. 105
5.4.4. Експорт заявок на конверсію валюти .......................... 107
6.ІМПОРТ ДАНИХ ПРО КОРЕСПОНДЕНТІВ ДОКУМЕНТІВ У
НАЦІОНАЛЬНІЙ ВАЛЮТІ З XML-ФАЙЛУ.............................. 110

7.ЕКСПОРТ ЗАЛИШКІВ НА РАХУНКАХ ................................ 111


7.1. Експорт залишків на рахунках в текстовий і BOL-
файл .............................................................................. 111
7.2. Експорт залишків на рахунках в DBF-файл................ 112
7.3. Експорт залишків на рахунках в XLS-файл ................ 112
7.4. Експорт залишків на рахунках в XML-файл ................ 113
1. ВСТУП
В даному документі знаходиться докладний опис форматів файлів імпорту
та експорту в Windows і Web-клієнтських додатках системи iFOBS, а також
форматів імпорту даних iFOBS.

1.1. Таблиця форматів


Нижче наведена таблиця, за допомогою якої ви можете перейти
безпосередньо до опису формату який вас цікавить - для цього слід перейти за
посиланням з номером відповідного розділу:

Підсистема / імпорт імпорт Експорт експорт Експорт


Формат Документ в валютних електронної валютних залишків на
національ- документів виписки документів рахунках
ній валюті
DAT, TXT, BOL 2.1 3.1 4.1 5.1 7.1

DAT, TXT (EXP) 3.2 5.2

DAT, TXT (ALT)1 3.3 5.3

TXT (SEB) 2.6 4.8

TXT (INFO DEBET) 2.8

DBF 0 4.2 7.2

DBF (ALT) 4.3

XLS 2.4 4.4 7.3

XLS (SEB) 4.9

XML 2.3 4.5 5.4 7.4

SAP R / 3 2.5 3.4 4.6 Ошибка!


Источник
ссылки не
найден.

1
1C 2.7 4.7

МТ94x 4.10

Також в таблиці ви можете побачити, в якому клієнтському додатку


доступний кожен формат:

 - Windows-додаток;

 - Web-додаток.

1.2. Розшифровка типу даних


Стовпець «Тип даних» в таблицях описує структуру даних і може набувати
таких значень:
Значення Опис
C поле містить строкове значення, вирівняне по лівому краю
N поле містить ціле число без провідних нулів, вирівняне по
правому краю
D поле містить дату в форматі YYMMDD (дві цифри року, місяця
і дня відповідно)
T поле містить час у форматі HHMMSS (дві цифри години, від 1
до 24, хвилини і секунди відповідно)
2. ІМПОРТ ДОКУМЕНТІВ В НАЦІОНАЛЬНІЙ ВАЛЮТІ

2.1. Імпорт з файлів формату DAT, TXT, CSV


Файли DAT, TXT і CSV є текстовими. Кожен рядок містить інформацію про
один документ. Рядки завершуються послідовністю CR + LF (ASCII-символи 13 і
10). Кожен рядок має фіксовану довжину (594 символу, включаючи символи
перекладу рядка CR + LF) і фіксовану структуру, описану в таблиці нижче. Ці
записи імпортуються з файлів у форматі ANSI.
Особливістю формату CSV є те, що вміст полів файлу вказується через
роздільник крапку з комою «;».
Всі відмічені поля обов'язкові для заповнення.
Деякі поля не мають значення для імпорту. Ці поля позначені прочерком у
таблиці, їх слід залишати порожніми при формуванні файлу електронної виписки.
Поля сірого кольору ігноруються при імпорті, тобто зміст полів не перевіряється
на коректність.
Увага! Зразки файлів додаються до комплекту документації (див.
«2.1.Import_UAH_document.dat», «2.1.Import_UAH_document.txt»,
«2.1.Import_UAH_document.csv»).
№ Найменування поля DAT Найменування поля TXT, CSV Тип даних позиції
пп
МФО банку платника МФО банку А N 1-9
1.
Номер рахунку платника Номер рахунку А N 10-23
2.
МФО банку отримувача МФО банку Б N 24-32
3.
Номер рахунку отримувача Номер рахунку Б N 33-46
4.
Тип фінансової операції Тип фінансової операції C 47-47
5.
Завжди = 1 (кредит)
Сума (в копійках) Сума (в копійках) N 48-63
6.
Вид документа Вид документа N 64-65
7.
Номер документа Номер документа C 66-75
8.
код валюти код валюти N 76-78
9.
Дата документа Дата документа D 79-84
10.
Дата отримання документа в Дата отримання документа в D 85-90
11.
банку банку
Найменування платника Найменування А C 91-128
12.
Назва отримувача Найменування Б C 129-166
13.
Призначення платежу Призначення платежу C 167-326
14.
№ Найменування поля DAT Найменування поля TXT, CSV Тип даних позиції
пп
додаткові реквізити додаткові реквізити C 327-386
15.
Код призначення платежу Код призначення платежу C 387-389
16.

- - C 390-391
17.
Ідентифікаційний код Ідентифікаційний код А (код C 392-405
18.
платника (код ЄДРПОУ) ЄДРПОУ)
Ідентифікаційний код Ідентифікаційний код Б (код C 406-419
19.
отримувача (код ЄДРПОУ) ЄДРПОУ)
Унікальний номер документа Унікальний номер документа N 420-428
20.

- - C 429-434
21.
N 435-436
22. - -

- - C 437-444
23.

- - З 445-508
24.
C 509-520
25. - -

- - N 521-526
26.
T 527-530
27. - -

- - T 531-534
28.

- - C 535-546
29.
N 547-552
30. - -

- - T 553-556
31.
T 557-560
32. - -

- - C 561-572
33.

- - N 573-578
34.
T 579-582
35. - -

- - T 583-586
36.
D 587-592
37. - -

CR + LF CR + LF З 593-594
38.

Нижче наведені пояснення до деяких реквізитів.


1. № 7, «Вид документа». Тип документа з довідника АБС банку;
Примітка. У файлах імпорту слід вказувати значення 1 - платіжне доручення.
2. № 8, «Номер документа». Бухгалтерський номер документа, що
проставляється на платіжному дорученні. Для документів у форматі TXT
заповнення поля необов'язково: якщо номер не вказано, буде
використовуватися автонумерация.
3. № 11, «Дата отримання документа у банку». У файлі імпорту слід
залишати порожнім.
4. № 15, «Додаткові реквізити». У цьому полі вказується код країни
платника / одержувача, якщо платник / одержувач є не резидентом, в
наступному форматі: # nП764О018 #, ( «П» і «О» - російські великі
символи), де «764» - код країни платника, « 018 »- код країни
одержувача.
5. № 20, «Унікальний номер документа». У файлі імпорту може залишатися
порожнім.

2.2. Імпорт з DBF-файлу


Формат платіжного файлу імпорту проводиться з DBF-файлу фіксованої
структури. DBF-файл може імпортуватися в кодуваннях: DOS-866 або Windows-
1251. Файл представляє собою таблицю з наступними значеннями:
№ Найменування поля Опис Тип даних Макс.
пп довжина поля

1. A клієнт А З 80

B клієнт Б З 80
2.
ACCOUNT_A Рахунок клієнта А З 14
3.
ACCOUNT_B Рахунок клієнта Б З 14
4.
MFO_A МФО А З 9
5.
MFO_B МФО Б З 9
6.
OKPO_A ЄДРПОУ А З 14
7.
OKPO_B ЄДРПОУ Б З 14
8.
BANK_A банк А З 38
9.
BANK_B банк Б З 38
10.
CITY_A Місто банку А З 25
11.
CITY_B Місто банку Б З 25
12.
№ Найменування поля Опис Тип даних Макс.
пп довжина поля
AMOUNT сума З 18
13.
Примітка. Сума вказується
в гривнях з роздільником
(точкою) і двома цифрами
після нього (копійки)
NUMBER Номер документа З 10
14.
DETAILS Деталі платежу З 160
15.
UNIVID2 Унікальний код документа C 30
16.

Зразки файлів додаються до комплекту документації (див.


«2.2.Import_UAH_document_DOS.DBF»).

2.3. Імпорт з XML-файла


Ці записи імпортуються з XML-файлу фіксованої структури в форматі ANSI.
Формат файлу наступний:

<? Xml version = "1.0" encoding = "windows-1251»?>


<ROWDATA>
<ROW ... /> - це перший документ в списку
...
<ROW ... /> - це останній документ у списку
</ ROWDATA>

ROWDATA - кореневий вузол XML документа, містить усі імпортовані


документи. Кожному документу відповідає один тег <ROW ... />. Усередині тега
<ROW ... /> повинні бути вказані значення всіх необхідних атрибутів. Допустимі
імена атрибутів і їх призначення наведено в таблиці нижче. Реквізити
необов'язкові для заповнення виділені сірим кольором.

№ Найменування атрибута Опис Особливості формату


пп
1. AMOUNT Сума платежу в копійках Ціле число
CORRSNAME Найменування одержувача
2. -
платежу
DETAILSOFPAYMENT Призначення платежу -
3.
CORRACCOUNTNO № рахунку одержувача
4. -
платежу
ACCOUNTNO № рахунку платника -
5.
CORRBANKID Код банку отримувача
6. -
платежу (МФО)

Додаткова функціональність
№ Найменування атрибута Опис Особливості формату
пп
CORRIDENTIFYCODE Ідентифікаційний код
7.
отримувача платежу -
(ЄДРПОУ)
CORRCOUNTRYID Код країни кореспондента При відсутності автоматично
8.
вибирається Україна (804)
DOCUMENTNO № документа Якщо номер не вказано, буде
9.
використовуватися
автонумерация
VALUEDATE дата валютування -
10.
PRIORITY пріоритет За замовчуванням 50
11.
DOCUMENTDATE Дата документа РРРРММДД
12.
ADDENTRIES Додаткові реквізити
13. -
платежу
PURPOSEPAYMENTID Код призначення платежу Ціле 3-значне число
14.
BANKID Код банку платника (МФО) -
15.

Порядок проходження атрибутів у тегу <ROW ... /> значення не має.


Атрибути, які відрізняються від описаних ігноруються. Регістр написання
атрибута (усі великі літери) враховується при імпорті в Web-додаток iFOBS. У тілі
XML документа допускаються коментарі згідно специфікації XML
(http://www.w3.org/TR/2004/REC-xml-20040204/).
Для успішного проведення процедури імпорту вихідний файл повинен
відповідати стандарту XML (найпростішу перевірку на правильність XML-
документа можна зробити відкривши файл в Internet Explorer).

Приклад файлу, для імпорту 2-х документів:

<? Xml version = "1.0" encoding = "windows-1251»?>


<ROWDATA>
<! -це коментар !!!! `~->
<! - перший документ->
<ROW DOCUMENTDATE= «20051018 » AMOUNT= «15983 »
CORRACCOUNTNO= «35790266 » CORRSNAME= «Найменування корреспондента1
» DETAILSOFPAYMENT= «Плата за видачу виписки согласно з 26001447 і тарифів
банку за період. Без ПДВ. » ACCOUNTNO= «26009126 » CORRBANKID= «32000»
CORRIDENTIFYCODE= «99999 » />

<! - другий документ->


<ROW DOCUMENTDATE= «20051019 » DOCUMENTNO= «3 » AMOUNT=
«93315 » CORRACCOUNTNO= «70208014 » CORRSNAME= «Найменування
корреспондента2 » DETAILSOFPAYMENT= «Нарахування %% за перiод 30-10-
2003-29-10-2003 вiдп. угоди № 281від12 / 09/03 д / у№1 вiд 12-09-2003»
ACCOUNTNO= «26087018 » CORRBANKID= «32000 » CORRIDENTIFYCODE=
«99999 » PRIORITY= «75 »/>
</ROWDATA>
У разі якщо імпорт документа завершується невдало, створюється XML файл
з помилками. Структура файлу помилок така ж, як і структура файлу імпорту,
кореневий вузол називається RowImportErrors, а текст помилки наводиться у
вигляді текстового поля відповідного вузла ROW, наприклад: <ROW ...
>Помилка при обробці значення поля «CorrBankId»: «Банк з кодом
«32000»не знайдений в довіднику банків»</ROW>.
Зразки файлів додаються до комплекту документації (див.
«2.3.Import_UAH_document.xml»).

2.4. Імпорт з XLS-файлу


Ці записи імпортуються з XLS-файлу фіксованої структури. У файлі повинна
бути закладка з назвою cbdocument, перший рядок - шапка таблиці, дані
починаються з другого рядка.
Стовпці у файлі повинні бути розташовані в такому порядку:
№ Найменування і опис поля Тип даних Довжина
пп поля

1. Дата документа D 6

2. Номер документа N 10

3. Сумма N 14
Сума платежу

4. МФО N 9
МФО банку платника

5. Счет N 14
рахунок платника

6. МФО банка корреспондента N 9

7. Счет корреспондента N 14

Ид. код корреспондента C 14


8.
Ідентифікаційний код отримувача
Код страны корреспондента N 3
9.

Корреспондент C 38
10.
Назва отримувача
Дата валютирования D 6
11.

Приоритет N 3
12.

Назначение платежа C 160


13.

Доп. реквизиты C 60
14.
Додаткові реквізити документа
Код НП N 3
15.
Код призначення платежу

Зразки файлів додаються до комплекту документації (див.


«2.4.Import_UAH_document.xls»).
2.5. Імпорт з файлу даних клієнт-банку SAP R / 3 (МТС)
Ім'я файлу імпорту повино мати вигляд RddhhmmN.NNN, де:
 R - вхідні документи. Всі файли імпорту з SAP R / 3 повинні
починатися з літери R;
 dd - дати створення файлу;
 hhmm - часу створення файлу (години та хвилини).
 Смислове навантаження на годинник і хвилини файлу накладає сам
користувач, але слід пам'ятати, що різним файлам повинні
відповідати різні імена;
 NNNN - код клієнта банку (6515).

Файл містить сукупність рядків, що представляють собою розрахункові


документи. Рядки завершуються послідовністю CR-LF (ASCII-символи 13 і 10).
Кожен рядок файлу імпорту складається з полів, обмежених символом «·».
У таблиці наведено структуру одного рядку файлу, отже, кількість таких
рядків буде залежати від того, скільки платежів містить файл імпорту.
№ опис поля Тип даних Мін. і макс.
пп довжина поля
1. Направление маpшpутизации: N 1, 3
0 - вхідний документ
Вид платежного документа. N 1, 4
2.
Для документів в нац. валюті: 1, 2, 9, 10, 11, 75,
76, 2111, 2121;
Для валютних документів: 55, 56, 60, 70, 2211,
2221
Номер платежного документа З 1,10
3.

Дата выписки платежного документа. N 8, 8


4.
У фоpмате РРРРММДД
МФО по дебету N 6, 9
5.

МФО по кpедиту N 6, 9
6.

Номер лицевого счета по дебету N 9,14


7.

Номер лицевого счета по кpедиту N 9,14


8.

Сумма платежа. N 3,17


9.
Для документів в нац. валюті - в копійках.
Для валютних документів - в дpобних одиницях
(без крапки)
Кассовый символ - якщо вид платіжного N 0, 2
10.
документа 2111, 2121, 2211, 2221.
Для всіх інших - поле не заповнюється
Наименование коppеспондента клиента З 5,38
11.
№ опис поля Тип даних Мін. і макс.
пп довжина поля
Назначение платежа. З 10,160
12.

Дата валютирования З 0,10


13.

Код вида акцепта: 1, 2, 3 N 0, 1


14.

Код платежа N 0, 3
15.

Пpизнак пеpедачи (не використовується) N 0, 1


16.

Код ЕГРПОУ коppеспондента клиента З 0,14


17.

Код валюты - якщо вид платіжного документа 55, N 0, 3


18.
56, 2211, 2221.
Для всіх інших - поле не заповнюється

Примітка. Поле № 12 «Призначення платежу документа» в разі платежу до


бюджету (особовий рахунок по кpедиту в середній триаді конференцій містить
номера 100 101 102 120 130 080 081 082 083 (наприклад, ххх110ххх,
ххх081ххх)) повинно мати вигляд:
070; xxxxxxxx; xxx; xx; xx; текст призначення платежу | --1 ---- | -2- | -3 | -4 |
де:
 ; - знак роздільник
 1 - код ЄДРПОУ платника (не більше 8 цифр)
 2 - код розділу платежу (не більше 3 цифр)
 3 - код параграфа платежу (не більше 2 цифр)
 4 - код виду сплати (не більше 2 цифр).
ВИДИ ПЛАТІЖНИХ ДОКУМЕНТІВ

№ Найменування Тип код платежу

1 Платежное извещение кредитовий 11

+2 Платежное поручение кредитовий 01

Приклад:
файл R0910006.515
0 1 61 19971020 300335 328016 013467305 000144007 720790000 0 Маг.
"Черевички" Інкасація за 12/09/94 оголошено 7355000 пеpесчет 147100 Разом
зач. 7207900 ПЕРЕДОПЛАТА 14371869 0
0 1 440 19970709 300335 322498 013467305 100711101 5485 0 АКПБ "Київ"
Пенсія за липень 1997р.Велічко Віктору Олександровичу о / р 5711782
ПЕРЕДОПЛАТА ···14371869 0
0 1 225 19970709 300335 300335 013467305 214130907 62300 0 Віплатній
центр 070; 21504897; 052; 02; 01; Переведення на пенс виплати ПЕРЕДОПЛАТА
···22886300 0

2.6. Імпорт з файлу TXT (SEB)


Файл є текстовим. Ці записи імпортуються з файлів у форматі ANSI. Кожен
рядок містить інформацію про один документ. Всі значення з документа
перераховуються в одному рядку, як роздільник використовується символ «;».
Рядки завершуються послідовністю CR-LF (ASCII-символи 13 і 10). Кожен рядок
має структуру, описану в таблиці нижче.
№ Найменування поля Тип Макс.
пп даних довжина
поля
1 Номер счета получателя N 14
2 МФО банка получателя N 9
3 Идентификационный код получателя (код N 8, 9, 10
ЕГРПОУ)
4 Наименование получателя C 38
5 Номер счета плательщика N 14
6 МФО банка плательщика N 9
7 Идентификационный код плательщика N 8, 9, 10
(код ЕГРПОУ)
8 Наименование плательщика C 38
9 Дата документа D 6
10 Код валюты C 3
11 Сумма (в копейках) З 16
12 Признак дебета/кредита C 1
13 Назначение платежа C 160
14 Номер документа З 10
15 CRLF З 2

Нижче наведені пояснення до деяких реквізитів.


№12, «Ознака Дебет / Кредит». Вказується, яка ознака була визначена при
формуванні документа:
a) D - дебет;
b) З - кредит;
Поля, позначені в таблиці курсивом, в файлі імпорту виділяються лапками.
Наприклад, якщо в файлі імпорту вказано найменування платника "Іванов А.А.",
то при імпорті це значення зміниться на Іванов А.А. Якщо в значенні полів
зустрічається знак лапок, то крім встановлення зовнішніх лапок, внутрішні слід
замінити на два таких же знака - наприклад, запис компанія "EXIM" в файлі
експорту / імпорту матиме вигляд "компанія" "EXIM" "".
Увага! Опис формату файлу імпорту можна отримати безпосередньо на
web-клієнта, клікнувши на посилання з назвою цікавить формату в розділі
довідки на сторінці імпорту документа (Операції з нац. Валютою / Імпорт
документів).
Зразки файлів додаються до комплекту документації (див.
«2.6.Import_UAH_document (SEB) .txt»).

2.7. Імпорт з файлу 1С


Файл є текстовим і містить сукупність рядків, що являють собою
розрахункові документи. Рядки завершуються послідовністю CR-LF (ASCII-
символи 13 і 10). Ці записи імпортуються з файлів у форматі ANSI. Дані по
кожному новому розрахунковому документу починаються з ознаки
«СекціяДокумент = ...», закінчення даних позначається ознакою
«КонецДокумента».
Тип даних,
№ макс.
Найменування реквізиту Опис довжина О/З Примітка
пп
поля
Тема файлу
1CClientBankExchange Внутрішня
1. ознака файлу
обміну
Загальні відомості
ВерсияФормата Номер версії C + Приклад
2. формату заповнення:
обміну ВерсіяФормата = 1.01
Кодировка Кодування C + Можливі значення:
3. файлу DOS, Windows
Отправитель Програма- C + Приклад
4. відправник заповнення:
Відправник = 1С
Получатель Програма- C - Приклад
5. одержувач заповнення:
Одержувач = 1С
ДатаСоздания Дата D -
6. формування (У форматі
файлу дд.мм.рррр)
ВремяСоздания Час T -
7. формування
файлу
Відомості про умови відбору даних, що передаються
ДатаНачала Дата початку D + У цьому інтервалі
8. інтервалу передаються всі
(У форматі
дд.мм.рррр) існуючі документи
ДатаКонца Дата кінця D +
9. інтервалу (У форматі
дд.мм.рррр)
РасчСчет Розрахункови 20 + Зазначений рахунок
10. й рахунок синхронізується в
організації зазначеному інтервалі
(рядків може
Тип даних,
№ макс.
Найменування реквізиту Опис довжина О/З Примітка
пп
поля
бути кілька)
Документ Вид документа C - Можливі значення:
11. (рядків може Платіжне доручення,
бути кілька) Акредитив (Заява на
акредитив), платіжне
вимога, Інкасове
доручення
Секція передачі залишків по розрахунковому рахунку
СекцияРасчСчет Ознака
12. початку секції
ДатаНачала Дата початку D N/A У цьому інтервалі
13. інтервалу передаються всі
(В форматі
дд.мм.рррр) існуючі документи
ДатаКонца Дата кінця D N/A
14. інтервалу (В форматі
дд.мм.рррр)
РасчСчет Розрахункови 20 N/A
15. й рахунок
організації
НачальныйОстаток Початковий грн [.коп] N/A Ці значення
16. залишок використовуються для
ВсегоПоступило Обороти грн [.коп] N/A звірки з обліковими
17. вхідних даними і для
платежів контролю отриманих
документів виписки
ВсегоСписано Обороти грн [.коп] N/A
18. вихідних
платежів
КонечныйОстаток Кінцевий грн [.коп] N/A
19. залишок
КонецРасчСчет Ознака
20. закінчення
секції
Секція платіжного документа
Шапка платіжного документа
СекцияДокумент Ознака Можливі значення:
21. початку секції Платіжне доручення,
містить вид Акредитив (Заява на
документа акредитив), платіжне
вимога, Інкасове
доручення
Номер Номер З +
22. документа
Дата Дата D +
23. документа (В форматі
дд.мм.рррр)
Сумма Сума платежу грн [.коп] +
24.
Тип даних,
№ макс.
Найменування реквізиту Опис довжина О/З Примітка
пп
поля
Квитанція за платіжним документом
КвитанцияДата Дата D N/A Квитанція
25. формування передається тільки з
(В форматі
квитанції дд.мм.рррр) Клієнта в 1С
КвитанцияВремя Час T N/A
26. формування
квитанції
КвитанцияСодержание зміст квитанції З N/A
27.
реквізити платника
ПлательщикСчет Розрахункови 20 + Розрахунковий
28. й рахунок рахунок платника в
платника його банку,
незалежно від того,
прямі розрахунки у
цього банку чи ні
ДатаСписано Дата списання D N/A Вказується, якщо
29. коштів з р / р відомо, що документ
(В форматі
дд.мм.рррр) проведено по
розрахунковому
рахунку платника
Плательщик платник З + Найменування і ідент.
30. код платника (і його
ПлательщикИНН Ідентифік- 20 + банку при непрямих
31. ційний код розрахунках)
платника
У разі непрямих розрахунків:
Плательщик1 Найменування З + Найменування
32. платника, платника
стр.1
Плательщик2 Найменування З - Розрахунковий
33. платника, рахунок платника
стор.2
Плательщик3 Найменування З - банк платника
34. платника,
стор.3
Плательщик4 Найменування З - Місто банку платника
35. платника,
стор.4
ПлательщикРасчСчет Розрахункови 20 + Коррахунок банку
36. й рахунок платника
платника
ПлательщикБанк1 банк платника З + РЦ банку платника
37.
ПлательщикБанк2 Місто банку З + Місто РЦ банку
38. платника платника
ПлательщикБИК БИК банку 9 + БИК РЦ банку
39. платника платника
Тип даних,
№ макс.
Найменування реквізиту Опис довжина О/З Примітка
пп
поля
ПлательщикКорсчет Коррахунок 20 + Коррахунок РЦ банку
40. банку платника
платника
Реквізити банку отримувача (постачальника)
ПолучательСчет Розрахункови 20 + Розрахунковий
41. й рахунок рахунок одержувача в
одержувача його банку,
незалежно від того,
прямі розрахунки у
цього банку чи ні
ДатаПоступило Дата D N/A Вказується, якщо
42. надходження відомо, що документ
(В форматі
коштів на р / р дд.мм.рррр) проведено по
розрахунковому
рахунку одержувача
Получатель одержувач З + Одержувач одним
43. рядком
ПолучательИНН Ідентифік- 20 + Найменування і ідент.
44. ційний код код отримувача (і
одержувача його банку при
непрямих
розрахунках)
У разі непрямих розрахунків:
Получатель1 Назва З + Назва отримувача
45. отримувача
Получатель2 Найменування З - Розрахунковий
46. одержувача, рахунок одержувача
стор. 2
Получатель3 Найменування З - Банк одержувача
47. одержувача,
стор. 3
Получатель4 Найменування З - Місто банку
48. одержувача, отримувача
стор. 4
ПолучательРасчСчет Розрахункови 20 + Коррахунок банку
49. й рахунок одержувача
одержувача
ПолучательБанк1 Банк З + РЦ банку одержувача
50. одержувача
ПолучательБанк2 Місто банку З + Місто РЦ банку
51. отримувача одержувача
ПолучательБИК БИК банку 9 + БИК РЦ банку
52. одержувача одержувача
ПолучательКорсчет Коррахунок 20 + Коррахунок РЦ банку
53. банку одержувача
одержувача
Реквізити платежу
Тип даних,
№ макс.
Найменування реквізиту Опис довжина О/З Примітка
пп
поля
ВидПлатежа Вид платежу З + Можливі значення:
54. Поштою, Телеграфом,
Електронно
ВидОплаты Вид оплати 2 +
55. (вид операції)
У заяві акредитив:
СрокПлатежа Термін D + Термін дії акредитива
56. платежу (В форматі
(акредитива) дд.мм.рррр)
Очередность черговість 2 + Не використовується
57. платежу
НазначениеПлатежа Призначення З - Призначення платежу
58. платежу одним рядком.
Приклад заповнення:
Плата за прод. харч.
согласно накл.235 від
31.07.08р. у т.ч. ПДВ
1024,00 грн.
НазначениеПлатежа1 Призначення З - Призначення
59. платежу, стор. платежу, розбите на
1 рядки самим
НазначениеПлатежа2 Призначення З - користувачем, якщо
60. платежу, стор. програма-відправник
2 допускає введення
багаторядкового
НазначениеПлатежа3 Призначення З - тексту
61. платежу, стор.
3
НазначениеПлатежа4 Призначення З -
62. платежу, стор.
4
НазначениеПлатежа5 Призначення З -
63. платежу, стор.
5
НазначениеПлатежа6 Призначення З -
64. платежу, стор.
6
Додаткові реквізити для окремих видів документів
СрокАкцепта Термін N -
65. акцепту,
кількість днів
ВидАккредитива вид C -
66. акредитива
УсловиеОплаты1 Умови оплати, C -
67. стор. 1
УсловиеОплаты2 Умови оплати, C -
68. стор. 2
Тип даних,
№ макс.
Найменування реквізиту Опис довжина О/З Примітка
пп
поля
УсловиеОплаты3 Умови оплати, C -
69. стор. 3
ПлатежПоПредст Платіж за C -
70. поданням
ДополнУсловия Додаткові C -
71. умови
НомерСчетаПоставщик № рахунки C - Рахунок депонування
72. а постачальника (40901)
ДатаОтсылкиДок Дата D -
73. відсилання (В форматі
документів дд.мм.рррр)
КонецДокумента Ознака
74. закінчення
секції
КонецФайла Ознака кінця
75. файлу

Зразки файлів додаються до комплекту документації (див.


«2.7.Import_UAH_document (SEB) .1C»).

2.8. Імпорт документів інформаційного дебету з TXT-файлу


Імпорт документів інформаційного дебету проводиться з текстового файлу
фіксованої структури в форматі ANSI. Кожен рядок містить інформацію про один
документ. Структура файлу надана в таблиці.

№ Найменування атрибута Опис Тип Позиції


пп даних
1. OURBANKID Код банку платника (МФО) N 4-9
2. ACCOUNTNO Номер рахунку платника N 10-23
3. CORRBANKID Код банку отримувача (МФО) N 27-32
4. CORRACCOUNTNO Номер рахунку отримувача N 33-46
5. CORRIDENTIFYCODE Ідентифікаційний код отримувача C 47-60
6. CORRSNAME Назва отримувача C 61-87
7. AMOUNT Сума (в копійках) N 88-106
8. DOCUMENTNO № документа C 107-116
9. DETAILSOFPAYMENT Призначення платежу C 117-276

Приклад рядка документа інформаційного дебету:


---300003260018000659-----30000326200500445 ---2950895084 ----
Тихоненко Я.В .----------------- 26 ----------------- 11531----- fffffffffffffffff ---,
де - - пробіл.
Зразки файлів додаються до комплекту документації (див.
«2.8.Import_UAH_document_infodebet.txt»).
3. ІМПОРТ ВАЛЮТНИХ ДОКУМЕНТІВ

3.1. Імпорт з файлу даних клієнт-банку (DAT, TXT)


Файл є текстовим файлом. Кожен рядок містить інформацію про один
документ. Рядки завершуються послідовністю CR-LF (ASCII-символи 13 і 10).
Кожен рядок має фіксовану структуру, описану в таблицях. Ці записи
імпортуються з файлів у форматі ANSI.

3.1.1. Імпорт валютного платіжного доручення

Перший рядок файлу імпорту повинна містити опис типу імпортованих


документів, тобто вона свідчить про те, до якого типу відносяться всі наступні
документи. Тип операції слід вказувати один раз в першому рядку імпортованого
файлу:
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
1. Идентификатор Тип документа, який повинен C + 1-13 13
операции мати вигляд:
OperationID = N,
де N - тип операції
імпортованого документа,
який може набувати
наступних значень:
1 - продаж валюти;
2 - купівля валюти;
3 - валютне платіжне
доручення;
4 - конверсія валюти.
2. CRLF CRLF, перехід на наступний C + 14-15 2
рядок для введення
інформації по документу (за
допомогою кнопки Enter)

У наступних рядках файлу імпорту введіть дані валютного платіжного


доручення (кількість таких рядків залежить від кількості імпортованих
документів) відповідно до опису, наведеним в таблиці:
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
1. Номер документа Порядковий номер документа C + 1-10 10
2. Дата документа Дата формування документа D + 11-16 6
3. Код валюты Валюта платіжного C + 17-19 3
документа доручення.
(Трилітерний код валюти
згідно ISO стандарту)
4. Сумма Сума транзакції в копійках N + 20-34 15
(без розділових знаків: ком,
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
крапок і т.п.)
5. Номер валютного Номер валютного рахунку З + 35-48 14
счета платника
6. Основание Поле містить мету і / або C + 49-86 38
підставу платежу
7. Банк-получатель BIC-код банку одержувача C + 87-120 34
(BIC)
8. Банк-получатель Ідентифікатор зі сторони C + 121-154 34
(Par ID) банку-одержувача
(Party identifier)
9. Банк-получатель Значення визначає спосіб C + 155-156 2
(формат) ідентифікації отримувача:
A - по BIC коду і ParID;
D - по ParID і найменуванню
та адресою одержувача
10. Номер счета Номер рахунку отримувача З + 157-190 34
11. Наименование и Поле містить найменування C + 191-336 146
адрес та адресу клієнта, якому
получателя буде зарахована сума
транзакції.
 зазначені вами данні
трьома розділовими комами
розбиваються на не більше
ніж 4-ри рядки;
 кожен рядок (не рахуючи
розділові коми) включає не
більше 34 символів;
 після заповнення поля, вся
решта незаповненних
позицій (до 146)
заповнюються пробілами для
того, щоб не відбулося зсуву
наступних полів файлу;
 якщо рядок містить
внутрішні коми або пробіли,
то вони з обох сторін повинні
виділятися подвійними
лапками;
 у форматі SWIFT перші два
рядки використовуються для
Назви одержувача, а дві
наступні - для Адреси
одержувача.

приклад 1 - поле містить 4


рядки (кожен не більше 34
символів):
рядок1, рядок 2, рядок 3,
рядок 4
приклад 2 - поле містить 3
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
рядки (кожен не більше 34
символів):
рядок1, рядок 2, рядок 3
приклад 3 - поле містить 3
рядки (кожен не більше 34
символів), причому другий
рядок містить внутрішню
кому:
рядок1, "рядок, 2", рядок 3
12. Банк-посередник BIC-код банку-посередника C - 337-370 34
(BIC)
13. Банк-посередник Ідентифікатор зі сторони C - 371-404 34
(Par ID) банку-посередника
(Party identifier)
14. Банк-посередник Значення визначає спосіб C - 405-406 2
(формат) ідентифікації банку-
посередника:
A - по BIC коду і ParID;
D - по ParID і найменуванню
та адресою банку-
одержувача
15. Банк-посередник Поле містить найменування C - 407-552 146
(найменування та адресу фінансової
та адреса) організації, через яку
повинна здійснюватися
поточна транзакція.
 зазначені вами данні
трьома розділовими комами
розбиваються на не більше
ніж 4-ри рядки;
 кожен рядок (не рахуючи
розділові коми) включає не
більше 34 символів;
 після заповнення поля, вся
решта незаповненних
позицій (до 146)
заповнюється пробілами для
того, щоб не відбулося зсуву
наступних полів файлу;
 якщо рядок містить
внутрішні коми або пробіли,
то вони з обох сторін повинні
виділятися подвійними
лапками;
 у форматі SWIFT перші два
рядки використовуються для
Назви банку-посередника, а
дві наступні - для Адреси
банку-посередника.
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
приклад 1 - поле містить 4
рядки (кожен не більше 34
символів):
рядок1, рядок 2, рядок 3,
рядок 4
приклад 2 - поле містить 3
рядки (кожен не більше 34
символів):
рядок1, рядок 2, рядок 3
приклад 3 - поле містить 3
рядки (кожен не більше 34
символів), причому другий
рядок містить внутрішню
кому:
рядок1, "рядок, 2", рядок 3
16. - Значення не - - 553-557 5
використовується при
імпорті. Може бути
заповнене пробілами
17. Код типа Значення визначає, з якої зі C + 558-562 5
списания сторін буде стягуватися
комиссии комісія за транзакцію.
В поле може бути зазначена
тільки одна з наведених
значень: BEN, SHA, FULL,
OUR
18. - Значення не - - 563-566 4
використовується при
імпорті. Може бути
заповнене пробілами
19. Код страны Код країни одержувача N + 567-570 4
получателя (цифровий 3-значний код,
ISO стандарт)
20. Код операции Значення визначає тип C + 571-580 10
1ПБ операції.
Значення з довідника кодів
1ПБ (Довідник для роботи з
валютними документами /
Коди 1ПБ)
21. Назначение Поле визначає деталі угоди, C + 581-726 146
платежа які будуть передані
одержувачу.
 зазначені вами дані трьома
розділовими комами
розбиваються на не більше
ніж 4-ри рядки;
 кожен рядок (не рахуючи
розділові коми) включає не
більше 34 символів;
 після заповнення поля, вся
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
решта незаповненних
позицій (до 146)
заповнюється пробілами для
того, щоб не відбулося зсуву
наступних полів файлу;
 якщо рядок містить
внутрішні коми або пробіли,
то вони з обох сторін повинні
виділятися подвійними
лапками.

приклад 1 - поле містить 4


рядки (кожен не більше 34
символів):
рядок1, рядок 2, рядок 3,
рядок 4
приклад 2 - поле містить 3
рядки (кожен не більше 34
символів):
рядок1, рядок 2, рядок 3
приклад 3 - поле містить 3
рядки (кожен не більше 34
символів), причому другий
рядок містить внутрішню
кому:
рядок1, "рядок, 2", рядок 3
22. Дополнительная У полі зазначаються C - 727-946 220
информация додаткові відомості по
поле 72 документу, які будуть
передані одержувачу.
 зазначені вами данні
трьома розділовими комами
розбиваються на не більше
ніж 6 рядків;
 кожен рядок (не рахуючи
розділові коми) включає не
більше 34 символів;
 після заповнення поля, вся
решта незаповнених позицій
(до 220) заповнюються
пробілами для того, щоб не
відбулося зсуву наступних
полів файлу;
 якщо рядок містить
внутрішні коми або пробіли,
то вони з обох сторін
повинна виділятися
подвійними лапками.

приклад 1 - поле містить 6


рядків (кожен не більше 34
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
символів):
рядок1, рядок 2, рядок 3,
рядок 4, рядок 5, рядок 6
приклад 2 - поле містить 3
рядки (кожен не більше 34
символів):
рядок1, рядок 2, рядок 3
приклад 3 - поле містить 3
рядки (кожен не більше 34
символів), причому другий
рядок містить внутрішню
кому:
рядок1, "рядок, 2", рядок 3
23. Наименование и Поле містить найменування C + 947-1092 146
адрес та адресу власника рахунку,
плательщика з якого буде проводиться
списання коштів за даною
транзакції.
 зазначені вами данні
трьома розділовими комами
розбиваються на не більше
ніж 4-ри рядки;
 кожен рядок (не рахуючи
розділові коми) включає не
більше 34 символів;
 після заповнення поля, вся
решта незаповненних
позицій (до 146)
заповнюється пробілами для
того, щоб не відбулося зсуву
наступних полів файлу;
 якщо рядок містить
внутрішні коми або пробіли,
то вона з обох сторін
повинна виділятися
подвійними лапками;
 у форматі SWIFT перші два
рядки використовуються для
Назви платника, а дві
наступні - для Адреси
платника.

приклад 1 - поле містить 4


рядки (кожен не більше 34
символів):
рядок1, рядок 2, рядок 3,
рядок 4
приклад 2 - поле містить 3
рядки (кожен не більше 34
символів):
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
рядок1, рядок 2, рядок 3
приклад 3 - поле містить 3
рядки (кожен не більше 34
символів), причому другий
рядок містить внутрішню
кому:
рядок1, "рядок, 2", рядок 3
24. Дополнительные Додаткова інформація C - 1093- 146
комментарии стосовно платіжного 1238
доручення
25. Действителен с… Дата, починаючи з якої D + 1239- 6
платіж буде вважатися 1244
дійсним.
Формат дати - ГГММДД
26. Счет комиссии Номер рахунку для списання З + 1245- 14
комісії 1258
27. Банк-получатель Назва та адреса банку C + 1259- 146
(наименование и одержувача 1404
адрес)  зазначені вами данні
трьома розділовими комами
розбиваються на не більше
ніж 4-ри рядки;
 кожен рядок (не рахуючи
розділові коми) включає не
більше 34 символів;
 після заповнення поля, вся
решта незаповненних
позицій (до 146)
заповнюються пробілами для
того, щоб не відбулося зсуву
наступних полів файлу;
 якщо рядок містить
внутрішні коми або пробіли,
то вони з обох сторін повинні
виділятися подвійними
лапками;
 у форматі SWIFT перші два
рядки використовуються для
Назви банку-одержувача, а
два наступні - для Адреси
банку-одержувача.

приклад 1 - поле містить 4


рядки (кожен не більше 34
символів):
рядок1, рядок 2, рядок 3,
рядок 4
приклад 2 - поле містить 3
рядки (кожен не більше 34
символів):
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
рядок1, рядок 2, рядок 3
приклад 3 - поле містить 3
рядки (кожен не більше 34
символів), причому другий
рядок містить внутрішню
кому:
рядок1, "рядок, 2", рядок 3
28. Валюта счета Код валюти рахунку C + 1405- 3
списания списання 1407
(ISO стандарт, 3-літерний
код)
29. Код валюты Код валюти комісії C + 1408- 3
комиссии (ISO стандарт, 3-літерний 1410
код).
Примітка. Згідно з
постановою НБУ, комісія
повинна стягуватися в гривні
(код - UAH)
30. CRLF CRLF, перехід на наступний C + 1411- 2
рядок для введення 1412
інформації по документу (за
допомогою кнопки Enter)

Примітка. Строкові значення (позначені символом «С») будуть


перевірятися на відповідність стандартам SWIFT документів. Система забороняє
імпорт файлів, строкові значення яких містять такі символи: §, ", ¶,", {,}.
Зразки файлів додаються до комплекту документації (див. «3.1.1.
3.1.1.Import_FC_payment.dat», «3.1.1.Import_FC_payment.txt»).

3.1.2. Імпорт заявки на купівлю валюти

Перший рядок файлу імпорту повинен містити опис типу імпортованих


документів, тобто він свідчить про те, до якого типу відносяться всі наступні
документи. Тип операції слід вказувати один раз в першому рядку імпортованого
файлу:
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
1. Идентификатор Тип документа, який повинен C + 1-13 13
операции мати вигляд:
OperationID = N,
де N - тип операції
імпортованого документа,
який може набувати
наступних значень:
1 - продаж валюти;
2 - купівля валюти;
3 - валютне платіжне
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
доручення;
4 - конверсія валюти.
2. CRLF CRLF, перехід на наступний C + 14-15 2
рядок для введення
інформації по документу (за
допомогою кнопки Enter)

У наступних рядках файлу імпорту введіть дані заявки на купівлю валюти


(кількість таких рядків залежить від кількості імпортованих документів)
відповідно до опису, наведеним у таблиці:
№ Найменування Опис Тип О/З Позиції Макс.
пп поля дани довжина
х поля
1. Номер Порядковий номер документа C + 1-10 10
документа
2. Сумма покупки Сума купівлі в копійках (без N + 11-26 16
в копейках розділових знаків: ком,
крапок і т.п.)
3. Код валюты C + 27-29 3
Код валюти транзакції.
(Трилітерний код валюти
згідно ISO стандарту)
4. Дата документа Дата формування документа D + 30-35 6
5. Заявка Дата, до якої документ буде D + 36-41 6
действительна вважатися дійсним
до…
6. Валютный счет Номер валютного рахунку C + 42-55 14
платника
7. Номер счета в Номер рахунку в нац. валюті C + 56-69 14
национальной для списання коштів
валюте
8. Номер счета Номер рахунку для списання C + 70-83 14
комиссии комісії
9. Тип курса Тип курсу валют: N + 84-85 2
0 - ринковий,
1 - фіксований,
2 - за угодою
* Другий символ можна
заповнити пробіломпробілом
10. Курс валют Курс валют N + 86-100 15
11. Процент Відсоткова ставка комісії, N + 101-115 15
комиссии встановлена для поточної
операції
12. Сумма комиссии Сума нарахованої комісії N + 116-130 15
13. Максимальная Максимальна сума комісії N + 131-145 15
сумма комиссии
14. ПФ номер счета Номер рахунку пенсійного C - 146-159 14
№ Найменування Опис Тип О/З Позиції Макс.
пп поля дани довжина
х поля
фонду
15. Код банка для Код банку, в якому N - 160-165 6
ПФ зареєстрований рахунок
комісії
16. Идентифика- Ідентифікаційний код C - 166-179 14
ционный номер рахунку пенсійного фонду
счета ПФ
17. Наименование Найменування пенсійного C - 180-217 38
ПФ фонду
18. Регистрацион- Реєстраційний номер C - 218-231 14
ный номер ПФ пенсійного фонду
19. Примечание к Додаткова інформація по C - 232-485 254
заявке документу.
 інформацію можна розбити
на кілька рядків, за
допомогою розділових ком.
 якщо рядок містить
внутрішні коми або пробіли,
то вона з обох сторін повинна
виділятися подвійними
лапками.
 довжина поля не повинна
перевищувати 254 символи з
урахуванням додаткових ком
і лапок.
20. Тип списания Тип списання комісії: N + 486-487 2
комиссии 0 - утримати з суми на
покупку,
1 - списати з нашого рахунку,
2 - перерахувати на рахунок
в нашому банку
21. Код валюты Код валюти комісії C + 488-490 3
комиссии (Трилітерний код згідно ISO
стандарту)
22. Номер счета Номер рахунку для списання C + 491-504 14
комиссии комісії
* Якщо заявка створена за контрактом, то інформацію за даним контрактом необхідно виділяти
лапками з двох сторін. Тобто в позиції 505 повинен бути знак, що відкривається лапки, потім
перераховані всі поля контракту та знак закривається лапки в позиції 861 (наприклад, "поле1
поле2 поле3").
Якщо контрактів кілька, то вони повинні бути перераховані через кому (наприклад, "поле1 поле2
поле3 ...", "поле1 поле2 поле3 ...").
23. Номер контракта C + 505-555 50
24. Цель покупки N + 556-565 10
25. Дата контракта D + 6
566-571
26. Код основания покупки C - 254
572-825
№ Найменування Опис Тип О/З Позиції Макс.
пп поля дани довжина
х поля
27. Код страны N + 10
826-835
28. Сумма контракта N + 15
836-850
29. Код вида экономической деятельности К110 N
- 10
851-861
23. CRLF CRLF, перехід на наступний C
/ рядок для введення + 505-506 / 2
* 862-863
30. інформації по документу (за
допомогою кнопки Enter)

Зразки файлів додаються до комплекту документації (див.


«3.1.2.Import_FC_purchase.dat», «3.1.2.Import_FC_purchase.txt»).

3.1.3. Імпорт заявки на продаж валюти

Перший рядок файлу імпорту повинен містити опис типу імпортованих


документів, тобто він свідчить про те, до якого типу відносяться всі наступні
документи. Тип операції слід вказувати один раз в першому рядку імпортованого
файлу:
№ Найменування Опис Тип О/З Позиції Макс.
пп поля дани довжина
х поля
1. Идентификатор Тип документа, який повинен C + 1-13 13
операции мати вигляд:
OperationID = N,
де N - тип операції
імпортованого документа,
який може набувати таких
значень:
1 - продаж валюти;
2 - купівля валюти;
3 - валютне платіжне
доручення;
4 - конверсія валюти.
2. CRLF CRLF, перехід на наступний C + 14-15 2
рядок для введення
інформації по документу (за
допомогою кнопки Enter)

У наступних рядках файлу імпорту введіть дані заявки на продаж валюти


(кількість таких рядків залежить від кількості імпортованих документів)
відповідно до опису, наведеного у таблиці:
№ Назва поля Опис Тип О/З Позиції Макс.
пп дани довжина
х поля
1. Номер документа Порядковий номер C + 1-10 10
документа
№ Назва поля Опис Тип О/З Позиції Макс.
пп дани довжина
х поля
2. Сумма продажи Сума продажу в копійках N + 11-26 16
(без розділових знаків: ком,
крапок і т.п.)
3. Код валюты З + 27-29 3
Код валюти транзакції.
(Трилітерний код валюти
згідно ISO стандарту)
4. Дата документа Дата формування D + 30-35 6
документа
5. Заявка Дата, до якої документ буде D + 36-41 6
действительна вважатися дійсним
до…
6. Валютный счет Номер валютного рахунку З + 42-55 14
платника
7. Код банка Код банку платника N + 56-61 6
8. Наименование Найменування контрагента C + 62-99 38
контрагента (одержувача)
9. Идентификацион- Ідентифікаційний код C + 100-113 14
ный код контрагента (одержувача)
контрагента
10. Сумма комиссии Сума нарахованої комісії N - 114-129 16
11. Максимальная Максимальна сума комісії N - 130-144 15
сумма комиссии
12. Тип курса Тип курсу валют: N + 145-146 2
0 - ринковий,
1 - фіксований,
2 - за угодою
* Другий символ можна
заповнити пробілом
13. Минимальный Мінімальний курс валют N - 147-161 15
курс валют
14. Комиссия в Відсоткова ставка комісії, N - 162-176 15
процентах встановлена для поточної
операції
15. Номер счета Номер валютного рахунку З + 177-191 15
16. Тип списания Тип списання комісії: N + 192-193 2
комиссии 0 - утримати з суми на
покупку,
1 - списати з нашого
рахунку,
2 - перерахувати на
рахунок в нашому банку
17. Код валюты Код валюти комісії З + 194-196 3
комиссии (3-літерний код, ISO
стандарт)
18. Номер счета Номер рахунку для З - 197-210 14
комиссии списання комісії
№ Назва поля Опис Тип О/З Позиції Макс.
пп дани довжина
х поля
19. Номер счета Номер рахунку банку, на З - 211-224 14
банка, на який буде зарахована сума
который следует комісії за проведення даної
перечислить транзакції
комиссию
* Якщо заявка створена за контрактом, то інформацію за даним контрактом необхідно виділяти
лапками з двох сторін. Тобто в позиції 225 повинен бути знак, що відкривається лапки, потім
перераховані всі поля контракту та знак закривається лапки в позиції 581 (наприклад, "поле1
поле2 поле3").
Якщо контрактів кілька, то вони повинні бути перераховані через кому (наприклад, "поле1 поле2
поле3 ...", "поле1 поле2 поле3 ...").
20. Номер контракта З + 225-275 50
21. Цель покупки N + 276-285 10
22. Дата контракта D + 286-291 6
23. Код основания покупки C - 292-545 254
24. Код страны N + 546-555 10
25. Сумма контракта N + 556-570 15
26. Код вида экономической деятельности К110
N - 571-581 10
20. CRLF CRLF, перехід на наступний C 225-226 2
/ рядок для введення +
/ * 582-
27. інформації по документу (за 583
допомогою кнопки Enter)

Зразки файлів додаються до комплекту документації (див.


«3.1.3.Import_FC_sale.dat», «3.1.3.Import_FC_sale.txt»).

3.1.4. Імпорт заявки на конверсію валюти

Перший рядок файлу імпорту повинен містити опис типу імпортованих


документів, тобто він свідчить про те, до якого типу відносяться всі наступні
документи. Тип операції слід вказувати один раз в першому рядку імпортованого
файлу:
№ Найменування опис Тип О/З позиції Макс.
пп поля даних довжина
поля
№ Найменування опис Тип О/З позиції Макс.
пп поля даних довжина
поля
1. Идентификатор Тип документа, який повинен C + 1-13 13
операции мати вигляд:
OperationID = N,
де N - тип операції
імпортованого документа,
який може набувати таких
значень:
1 - продаж валюти;
2 - купівля валюти;
3 - валютне платіжне
доручення;
4 - конверсія валюти.
2. CRLF CRLF, перехід на наступний C + 14-15 2
рядок для введення
інформації по документу (за
допомогою кнопки Enter)

У наступних рядках файлу імпорту введіть дані заявки на продаж валюти


(кількість таких рядків залежить від кількості імпортованих документів)
відповідно до опису, наведеного у таблиці:
№ Назва поля Опис Тип О/З Позиції Макс.
пп даних довжина
поля
1. Номер документа Порядковий номер документа C + 1-10 10
2. Дата документа Дата формування документа D + 11-16 6
3. Код продаваемой З + 17-19 3
Код валюти транзакції
валюты
(Трилітерний код валюти
згідно ISO стандарту)
4. Сумма N - 20-34 15
Сума валюти, що продається
продаваемой
в копійках (без розділових
валюты
знаків: ком, крапок і т.п.)
5. Код покупаемой Код валюти, що купується C + 35-37 3
валюты (Трилітерний код валюти
згідно ISO стандарту)
6. Сумма Сума валюти, що купується в N - 38-52 15
покупаемой копійках (без розділових
валюты знаків: ком, крапок і т.п.)
7. Заявка Дата, до якої документ буде D + 53-58 6
действительна вважатися дійсним
до…
8. Номер счета Номер рахунку, на який буде C + 59-72 14
зачисления зарахована валюта
покупаемой
валюты
9. Номер счета Номер рахунку, з якого буде C + 73-86 14
списания списана валюта
продаваемой
№ Назва поля Опис Тип О/З Позиції Макс.
пп даних довжина
поля
10. Процент Відсоткова ставка комісії, N - 87-96 10
комиссии встановлена для поточної
операції
11. Сумма комиссии Сума нарахованої комісії N - 97-111 15
12. Номер счета для Номер банківського рахунку, C + 112-125 14
зачисления на який буде зарахована
продаваемой валюта
валюты
13. Номер Номер банківського рахунку, C + 126-140 14
банковского на який буде зарахована
счета комиссии комісія
14. Номер счета Номер рахунку, з якого C + 141-154 14
списания стягуватиметься комісія за
комиссии проведення поточної операції
15. Режим покупки Режим купівлі: N + 155-156 2
валюты 0 - купуємо на наш рахунок;
1 - купуємо згідно з
платіжним дорученням
16. Номер документа, Номер документа, на підставі C + 157-166 10
на основании якого відбувається купівля
которого валюти.
происходит Слід заповнювати, якщо в
покупка валюты пункті 15 було обрано
значення 1, «Купуємо згідно
з платіжним дорученням»
17. Дата документа, Дата документа, на підставі D + 167-172 6
на основании якого відбувається купівля
которого валюти.
происходит Слід заповнювати, якщо в
покупка валюты пункті 17 було обрано
значення 1, «Купуємо згідно
з платіжним дорученням»
18. Название Назва підприємства C - 173-210 38
предприятия
19. Адрес Адреса підприємства C - 211-270 60
20. Контактная Контактна інформація C - 271-330 60
информация підприємства
21. Цель Мета платежу даного З + 331-490 160
документа
22. CRLF CRLF, перехід на наступний З + 491-492 2
рядок для введення
інформації по документу (за
допомогою кнопки Enter)

Зразки файлів додаються до комплекту документації (див.


«3.1.4.Import_FC_conversion.dat», «3.1.4.Import_FC_conversion.txt»).
3.1.5. Імпорт заявки на розподіл валюти

Перший рядок файлу імпорту повинен містити опис типу імпортованих


документів, тобто він свідчить про те, до якого типу відносяться всі наступні
документи. Тип операції слід вказувати один раз в першому рядку імпортованого
файлу:
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
1. Идентификатор Тип документа, який повинен C + 1-14 14
операции мати вигляд:
OperationID = N,
де N - тип операції
імпортованого документа,
який може набувати таких
значень:
1 - продаж валюти;
2 - купівля валюти;
3 - валютне платіжне
доручення;
4 - конверсія валюти;
23 - розподіл валюти
2. CRLF CRLF, перехід на наступний C + 15-16 2
рядок для введення
інформації по документу (за
допомогою кнопки Enter)

У наступних рядках файлу імпорту введіть дані заявки на розподіл валюти


(кількість таких рядків залежить від кількості імпортованих документів)
відповідно до опису, наведеного в таблиці:
№ Назва поля Опис Тип О/З Позиції Макс.
пп дани довжина
х поля
1. Номер Порядковий номер заявки C + 1-10 10
документа
2. Дата документа Дата формування заявки (у D + 11-16 6
форматі ГГММДД)
3. Сумма Сума коштів в іноземній N + 17-32 16
валютных валюті, що підлягає розподілу
средств (в копійках без розділових
знаків: ком, крапок і т.п.)
4. Код валюты Код валюти транзакції З + 33-35 3
(Трилітерний код валюти
згідно ISO стандарту)
5. Распределитель Номер розподільчого рахунку З + 36-49 14
ный счет клієнта
Дані про суму валютних коштів, що підлягають обов'язковому продажу *.
Якщо заповнене одне із полів 6-9, то всі інші поля секції стають обов'язковими для заповнення
6. Сумма Сума валютних коштів, що N +/- 50-65 16
валютных підлягають обов'язковому
№ Назва поля Опис Тип О/З Позиції Макс.
пп дани довжина
х поля
средств продажу (в копійках без
розділових знаків: ком,
крапок і т.п.)
7. Средства в дата валютування коштів в N +/- 66 1
гривне просим національній валюті. Можливі
зачислить с значення:
датой
0 - сьогодні
валютирования
1 - завтра
2 - спот
3 - сьогодні. терміново
8. Счет Номер рахунку клієнта для З +/- 67-80 14
зарахування коштів у гривні
від обов'язкового продажу
валюти
9. Код банка Код банку, на рахунок в N +/- 81-86 6
якому необхідно
перерахувати кошти в гривні
від обов'язкового продажу
валюти
Дані про суму валютних коштів, що направляються на поточний рахунок *.
Якщо заповнене одне із полів секції (10 або 11), то друге поле секції стає обов'язковими для
заповнення
10. Сумма Сума валютних коштів, що N +/- 87-102 16
валютных направляються на поточний
средств рахунок (у копійках без
розділових знаків: ком,
крапок і т.п.)
11. Счет Номер поточного рахунку З +/- 103-116 14
клієнта, на який
перераховуються кошти з
розподільчого рахунку
12. Информация о Інформація про надходження З + 117-370 254
поступлении іноземної валюти або про
иностранной звільнення від обов'язкового
валюты/освобо продажу валюти
ждение от
обязательной
продажи
13. CRLF CRLF, перехід на наступний C + 371-372 2
рядок для введення
інформації по документу (за
допомогою кнопки Enter)

* Як мінімум одна із секцій повинна бути заповнена.


Зразки файлів додаються до комплекту документації (див.
«3.1.5.Import_FC_allocation.dat», «3.1.5.Import_FC_allocation.txt»).
3.1.6. Імпорт форвардних заявок

№ Назва поля Опис Тип О/З Позиції Макс.


пп даних довжин
а поля
1. Тип заявки Доступні наступні типи N + 1 1
заявок:
 Узгодження на
купівлю валюти на
умовах форвард
(СПО);
 Узгодження на
продаж валюти на
умовах форвард
(СПР);
 Узгодження на
конвертацію валюти
на умовах форвард
(СКП)
2. Номер заявки Номер заявки З + 2 - 11 10
3. Дата создания Дата формування документа D + 12- 17 6
документа
4. Дата D + 18 - 23 6
Дата валютування коштів.
валютирования
Повинна бути більше
поточної дати
5. Сумма продажи Доступно для заявок типу N + 24 - 37 14
СПР і СКО
6. Сумма покупки Доступно для заявок типу N + 38 - 51 14
СПО і СКО
7. Код покупаемой Цифровий код валюти, що N + 52 - 54 3
валюты купується
8. Код продаваемой Цифровий код валюти, що N + 55 - 57 3
валюты продається
9. Курс курс угоди N + 58 - 71 14
10. Сумма в Сума угоди в національній N + 72 - 85 14
эквиваленте валюті
11. Дополнительная додаткова інформація З + 86 -224 139
информация
12. Счет комиссии Номер рахунку списання N +/- 225 -238 14
комісії. Обов'язково до
заповнення, якщо рахунок
списання комісії є
транзитним
№ Назва поля Опис Тип О/З Позиції Макс.
пп даних довжин
а поля
13. Признак, при Вказує, що: N + 239 1
котором счет рахунок списання комісії не є
комиссии транзитним (при значенні
является «0»). У цьому випадку поле
транзитным Рахунок комісії не є
обов'язковим до заповнення;
рахунок списання комісії є
транзитним (при значенні
«1»). У цьому випадку поле
Рахунок комісії є
обов'язковим до заповнення
14. Счет покрытия Номер рахунку списання N +/- 240 - 253 14
першочергового покриття.
Обов'язково до заповнення,
якщо рахунок списання
першочергового покриття є
транзитним
15. Признак, при Вказує, що: N + 254 1
котором счет рахунок списання
покрытия першочергового покриття не
является є транзитним (при значенні
транзитным «0»). У цьому випадку поле
Рахунок покриття не є
обов'язковим до заповнення;
рахунок списання
першочергового покриття є
транзитним (при значенні
«1»). У цьому випадку поле
Рахунок покриття є
обов'язковим до заповнення
16. Дополнительный Номер додаткового рахунку N +/- 255 - 268 14
счет покрытия списання покриття.
Обов'язково до заповнення,
якщо додатковий рахунок
списання покриття є
транзитним
17. Признак, при Вказує, що: N + 269 1
котором додатковий рахунок
дополнительный списання покриття не є
счет покрытия транзитним (при значенні
является «0»). У цьому випадку поле
транзитным Додатковий рахунок
покриття не є обов'язковим
до заповнення;
додатковий рахунок
списання покриття є
транзитним (при значенні
«1»). У цьому випадку поле
Додатковий рахунок
покриття є обов'язковим до
заповнення
№ Назва поля Опис Тип О/З Позиції Макс.
пп даних довжин
а поля
18. Счет возврата Номер рахунку повернення N + 270 - 283 14
покрытия покриття
19. Номер Номер узгодження, умови З - 284 -292 9
согласования, якого змінюються.
условия которого Обов'язково до заповнення,
изменяются якщо активна опція «Зміна
умов»
20. Дата Дата узгодження умов змін. D - 293 -298 6
согласования Обов'язково до заповнення,
условий якщо активна опція «Зміна
изменений умов»
21. Сумма Сума додаткової комісії N - 299 - 312 14
дополнительной
комиссии
22. Сумма комиссии Сума комісії. Поле N + 313 -326 14
заповнюється автоматично
23. Сумма Сума першочергового N + 327 - 340 14
первоочередного покриття. Поле заповнюється
покрытия автоматично значенням з
довідника
24. Процент Відсоток першочергового N + 341 - 354 14
первоочередного покриття. Поле заповнюється
покрытия автоматично значенням з
довідника
25. Сумма Сума першочергового N + 355 - 368 14
первоочередного покриття за рахунок ліміту.
покрытия за счет Поле заповнюється
форвардного автоматично значенням з
лимита довідника
26. Сумма Сума першочергового N + 369 -382 14
первоочередного покриття за рахунок коштів
покрытия за счет
денежных
средств
27. Контактная Для введення даних З + 383 -411 29
личность клиента юридичних осіб
28. Контактный Контактний телефон клієнта З + 412 - 424 13
телефон
29. Доступная сумма Доступна сума форвардного N + 425 - 438 14
лимита ліміту. Поле заповнюється
автоматично значенням з
довідника
30. Общая сумма Загальна сума форвардного N + 439 - 452 14
лимита ліміту. Поле заповнюється
автоматично значенням з
довідника
№ Назва поля Опис Тип О/З Позиції Макс.
пп даних довжин
а поля
31. Сумма Використаний форвардний N + 453 - 466 14
использованного ліміт клієнта на момент
лимита перегляду угоди. Поле
заповнюється автоматично
значенням з довідника
32. Дата последней Дата і час отримання D + 467 - 473 7
синхронизации по актуальних даних по лімітам
лимитам

Зразки файлів додаються до комплекту документації (див.


«3.1.6.Import_FC_forward.txt»).

3.2. Імпорт з розширеного файлу даних клієнт-банку (EXP)


Файл є текстовим. Кожен рядок містить інформацію про один документ.
Рядки завершуються послідовністю CR-LF (ASCII-символи 13 і 10). Кожен рядок
має фіксовану структуру, описану в таблицях нижче. Ці записи імпортуються з
файлів у форматі ANSI.

3.2.1. Імпорт валютного платіжного доручення

Перший рядок файлу імпорту повинен містити опис типу імпортованих


документів, тобто він свідчить про те, до якого типу відносяться всі наступні
документи. Тип операції слід вказувати один раз в першому рядку імпортованого
файлу:
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
1. Идентификатор Тип документа, який повинен C + 1-13 13
операции мати вигляд:
OperationID = N,
де N - тип операції
імпортованого документа,
який може набувати таких
значень:
1 - продаж валюти;
2 - купівля валюти;
3 - валютне платіжне
доручення;
4 - конверсія валюти.
2. CRLF CRLF, перехід на наступний C + 14-15 2
рядок для введення
інформації по документу (за
допомогою кнопки Enter)

У наступних рядках файлу імпорту введіть дані валютного платіжного


доручення (кількість таких рядків залежить від кількості імпортованих
документів) відповідно з описом, наведеним в таблиці:
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
1. Номер документа Порядковий номер документа C +
1-10 10

2. Дата документа Дата формування документа D +


11-16 6
3. Код валюти Валюта платіжного C +
документа доручення. 17-19 3
(Трилітерний код валюти
згідно ISO стандарту)
4. Сумма Сума транзакції в копійках N +
(без розділових знаків: ком, 20-34 15
крапок і т.п.)
5. Номер валютного Номер валютного рахунку З +
счета платника 35-48 14
6. Основание Поле містить мету і / або C +
підставу платежу 49-98 50
7. Банк-получатель BIC-код банку одержувача C +
(BIC) 99-132 34
8. Банк-получатель Ідентифікатор зі сторони C +
(Par ID) банку-одержувача 133-169 37
(Party identifier)
9. Банк-получатель Значення визначає спосіб C +
(формат) ідентифікації отримувача: 170-171 2
A - по BIC коду і ParID;
D - по ParID і найменуванню
та адресою одержувача
10. Номер счета Номер рахунку отримувача З +
172-208 37
11. Наименование и Поле містить найменування C +
адрес та адресу клієнта, якому 209-388 180
получателя буде зарахована сума
транзакції.
 зазначені вами данні
трьома розділовими комами
розбиваються на не більше
ніж 4-ри рядки;
 кожен рядок (не рахуючи
розділові коми) включає не
більше 34 символів;
 після заповнення поля, вся
решта незаповненних позиції
(до 180) заповнюється
пробілами для того, щоб не
відбулося зсуву наступних
полів файлу;
 якщо рядок містить
внутрішні коми або пробіли,
то вони з обох сторін повинні
виділятися подвійними
лапками;
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
 в форматі SWIFT перші два
рядки використовуються для
Назви банку-посередника, а
дві наступні - для Адреси
банку-посередника.

приклад 1 - поле містить 4


рядки (кожен не більше 34
символів):
рядок1, рядок2, рядок3,
рядок4
приклад 2 - поле містить 3
рядки (кожен не більше 34
символів):
рядок1, рядок2, рядок3
приклад 3 - поле містить 3
рядки (кожен не більше 34
символів), причому другий
рядок містить внутрішню
кому:
рядок1, "рядок, 2", рядок3
12. Банк-посредник BIC-код банку-посередника C -
(BIC) 389-422 34
13. Банк-посредник Ідентифікатор боку банку- C -
(Par ID) посередника 423-459 37
(Party identifier)
14. Банк-посредник Значення визначає спосіб C -
(формат) ідентифікації банку- 460-461 2
посередника:
A - по BIC коду і ParID;
D - по ParID і найменуванню
та адресою банку-
одержувача
15. Банк-посредник Поле містить найменування C -
(наименование и та адреса фінансової 462-641 180
адрес) організації, через яку
повинна здійснюватися
поточна транзакція.
 зазначені вами дані трьома
розділовими комами
розбиваються на не більше
ніж 4-ри рядки;
 кожен рядок (не рахуючи
розділові коми) включає не
більше 34 символів;
 після заповнення поля, все
решта незаповнені позиції
(до 180) заповнюються
пробілами для того, щоб не
відбулося зсуву наступних
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
полів файлу;
 якщо рядок містить
внутрішні коми або пробіли,
то вона з обох сторін
повинна виділятися
подвійними лапками;
 в форматі SWIFT перші два
рядки використовуються для
Назви банку-посередника, а
дві наступні - для Адреси
банку-посередника.

приклад 1 - поле містить 4


рядки (кожен не більше 34
символів):
рядок1, рядок2, рядок3,
рядок4
приклад 2 - поле містить 3
рядки (кожен не більше 34
символів):
рядок1, рядок2, рядок3
приклад 3 - поле містить 3
рядки (кожен не більше 34
символів), причому другий
рядок містить внутрішню
кому:
рядок1, "рядок, 2", рядок3
16. - Значення не - -
використовується при 642-646 5
імпорті. Може бути
заповнене пробілами
17. Код типа Значення визначає, з якої зі C +
списания сторін буде стягуватися 647-651 5
комиссии комісія за транзакцію.
В поле може бути зазначена
тільки одна з наведених
значень: BEN, SHA, FULL,
OUR (докладний опис
знаходиться в документації
iFOBS_WinClient_Керівництво
користувача.doc)
18. - Значення не - -
використовується при 652-655 4
імпорті. Може бути
заповнене пробілами
19. Код страны Код країни одержувача N +
получателя (цифровий 3-значний код, 656-659 4
ISO стандарт)
20. Код операции Значення визначає тип C +
1ПБ операції. 660-669 10
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
Значення з довідника кодів
1ПБ (Довідник для роботи з
валютними документами /
Коди 1ПБ)
21. Назначение Поле визначає деталі угоди, C +
платежа які будуть передані 670-849 180
одержувачу.

 зазначені вами дані трьома


розділовими комами
розбиваються на не більше
ніж 4-ри рядки;
 кожен рядок (не рахуючи
розділові коми) включає не
більше 34 символів;
 після заповнення поля, все
решта незаповнені позиції
(до 180) заповнюються
пробілами для того, щоб не
відбулося зсуву наступних
полів файлу;
 якщо рядок містить
внутрішні коми або пробіли,
то вона з обох сторін
повинна виділятися
подвійними лапками;
 в форматі SWIFT перші два
рядки використовуються для
Назви банку-посередника, а
дві наступні - для Адреси
банку-посередника.

приклад 1 - поле містить 4


рядки (кожен не більше 34
символів):
рядок1, рядок2, рядок3,
рядок4
приклад 2 - поле містить 3
рядки (кожен не більше 34
символів):
рядок1, рядок2, рядок3
приклад 3 - поле містить 3
рядки (кожен не більше 34
символів), причому другий
рядок містить внутрішню
кому:
рядок1, "рядок, 2", рядок3
22. Дополнительная У полі зазначаються C -
информация додаткові відомості по 850- 250
поле 72 документу, які будуть 1099
передані одержувачу.
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
 зазначені вами дані трьома
розділовими комами
розбиваються на не більше
ніж 4-ри рядки;
 кожен рядок (не рахуючи
розділові коми) включає не
більше 34 символів;
 після заповнення поля, все
решта незаповнені позиції
(до 250) заповнюються
пробілами для того, щоб не
відбулося зсуву наступних
полів файлу;
 якщо рядок містить
внутрішні коми або пробіли,
то вона з обох сторін
повинна виділятися
подвійними лапками;
 в форматі SWIFT перші два
рядки використовуються для
Назви банку-посередника, а
дві наступні - для Адреси
банку-посередника.

приклад 1 - поле містить 4


рядки (кожен не більше 34
символів):
рядок1, рядок2, рядок3,
рядок4
приклад 2 - поле містить 3
рядки (кожен не більше 34
символів):
рядок1, рядок2, рядок3
приклад 3 - поле містить 3
рядки (кожен не більше 34
символів), причому другий
рядок містить внутрішню
кому:
рядок1, "рядок, 2", рядок3
23. Наименование и Поле містить найменування C +
1100- 180
адрес та адресу власника рахунку,
1279
плательщика з якого буде проводиться
списання коштів за даною
транзакції.
 зазначені вами дані трьома
розділовими комами
розбиваються на не більше
ніж 4-ри рядки;
 кожен рядок (не рахуючи
розділові коми) включає не
більше 34 символів;
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
 після заповнення поля, вся
решта незаповненних
позицій (до 180)
заповнюється пробілами для
того, щоб не відбулося зсуву
наступних полів файлу;
 якщо рядок містить
внутрішні коми або пробіли,
то вони з обох сторін повинні
виділятися подвійними
лапками;
 у форматі SWIFT перші два
рядки використовуються для
Назви банку-посередника, а
два наступні - для Адреси
банку-посередника.

приклад 1 - поле містить 4


рядки (кожен не більше 34
символів):
рядок1, рядок2, рядок3,
рядок4
приклад 2 - поле містить 3
рядки (кожен не більше 34
символів):
рядок1, рядок2, рядок3
приклад 3 - поле містить 3
рядки (кожен не більше 34
символів), причому другий
рядок містить внутрішню
кому:
рядок1, "рядок, 2", рядок3
24. Дополнительные Додаткову інформацію C -
комментарии стосовно цього платіжним 1280- 180
дорученням 1459
25. Действителен с… Дата, починаючи з якої D +
платіж буде вважатися 1460- 6
дійсним. 1465
Формат дати - ГГММДД
26. Счет комиссии Номер рахунку для списання N +
комісії 1466- 14
1479
27. Банк-получатель Назва та адреса банку C +
(наименование и одержувача. 1480- 180
адрес) 1659
 зазначені вами данні
трьома розділовими комами
розбиваються на не більше
ніж 4-ри рядки;
 кожен рядок (не рахуючи
розділові коми) включає не
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
більше 34 символів;
 після заповнення поля, все
решта незаповнені позиції
(до 180) заповнюються
пробілами для того, щоб не
відбулося зсуву наступних
полів файлу;
 якщо рядок містить
внутрішні коми або пробіли,
то вона з обох сторін
повинна виділятися
подвійними лапками;
 в форматі SWIFT перші два
рядки використовуються для
Назви банку-посередника, а
дві наступні - для Адреси
банку-посередника.

приклад 1 - поле містить 4


рядки (кожен не більше 34
символів):
рядок1, рядок2, рядок3,
рядок4
приклад 2 - поле містить 3
рядки (кожен не більше 34
символів):
рядок1, рядок2, рядок3
приклад 3 - поле містить 3
рядки (кожен не більше 34
символів), причому другий
рядок містить внутрішню
кому:
рядок1, "рядок, 2", рядок3
28. Валюта счета Код валюти рахунку C +
списания списання 1660- 3
1662
(ISO стандарт, 3-літерний
код)
29. Код валюты Код валюти комісії C +
комиссии 1663- 3
(ISO стандарт, 3-літерний
1665
код).
Примітка. Відповідно до
постанови НБУ, комісія
повинна стягуватися в
національній валюті гривні
(код - UAH)
30. Комментарий к Коментар до платежу (до 160 C -
платежу символів) 1666- 160
1825
№ Найменування Опис Тип О/З Позиції Макс.
пп поля даних довжина
поля
31. Срочность3 Ознака терміновості N -
платежу: тисяча 1
вісімсот
0 - терміновий;
двадцят
1 - нетерміновий.
ь шість
Примітка. Якщо дане поле
відсутнє, то за
замовчуванням платіж
імпортується як
нетерміновий
32. CRLF CRLF, перехід на наступний C +
рядок для введення 1827- 2
інформації по документу (за 1828
допомогою кнопки Enter)

Примітка. Строкові значення (позначені символом «С») будуть


перевірятися на відповідність стандартам SWIFT документів. Система забороняє
імпорт файлів, строкові значення яких містять такі символи: §, ", ¶,", {,}.
Зразки файлів додаються до комплекту документації (див.
«3.2.1.Import_FC_payment (EXP) .dat», «3.2.1.Import_FC_payment (EXP) .txt»).

3.3. Імпорт з файлу даних клієнт-банку (альтернативний)


Файл даних клієнт-банку є текстовим файлом. Кожен рядок містить
інформацію про один документ. Рядки завершуються послідовністю CR-LF (ASCII-
символи 13 і 10). Кожен рядок має фіксовану структуру, описану в розділах
нижче. Ці записи імпортуються з файлів у форматі ANSI.

3.3.1. Імпорт заявки на покупку валюти

Перший рядок файлу імпорту повинен містити опис типу імпортованих


документів, тобто він свідчить про те, до якого типу відносяться всі наступні
документи. Тип операції слід вказувати один раз в першому рядку імпортованого
файлу:
№ Найменування опис Тип О/З позиції Макс.
пп поля даних довжина
поля
1. Идентификатор Тип документа, який повинен C + 1-13 13
операции мати вигляд:
OperationID = N,
де N - тип операції
імпортованого документа,
який може набувати таких
значень:
1 - продаж валюти;
2 - купівля валюти;
№ Найменування опис Тип О/З позиції Макс.
пп поля даних довжина
поля
3 - валютне платіжне
доручення;
4 - конверсія валюти.
2. CRLF CRLF, перехід на наступний C + 14-15 2
рядок для введення
інформації по документу (за
допомогою кнопки Enter)

Деякі поля не мають значення для імпорту. Ці поля позначені прочерком у


таблиці, їх слід залишати порожніми.
У наступних рядках файлу імпорту введіть дані заявки на купівлю валюти
(кількість таких рядків залежить від кількості імпортованих документів)
відповідно до описом, наведеним в таблиці:

№ Найменування поля Опис Тип О/З Позиції Макс.


пп дани довжина
х поля
1. Номер заявки Порядковий номер заявки C + 1-10 10
2. Сумма покупки в Сума купівлі в копійках N + 11-26 16
копейках (без розділових знаків:
ком, крапок і т.п.)
3. Код валюты C + 27-29 3
Код валюти транзакції.
(Трилітерний код валюти
згідно ISO стандарту)
4. Дата Дата формування заявки D + 30-35 6
5. Заявка Дата, до якої заявка D + 36-41 6
действительна вважається дійсною
до…
6. Валютный счет Номер валютного рахунку C + 42-55 14
платника
7. Номер счета в Номер рахунку в нац. C + 56-69 14
национальной валюті для списання коштів
валюте
8. - - C N/A 70-83 14
9. Тип курса Тип курсу валют: N + 84-85 2
0 - уповноваженого банку,
1 - максимальний,
* Другий символ можна
заповнити пробілом
10. Курс валют Курс купівлю валюти. N +/- 86-100 15
Обов'язково для
заповнення при виборі типу
курсу валюти -
«Максимальний»
11. - - N N/A 101-115 15
12. - - N N/A 116-130 15
№ Найменування поля Опис Тип О/З Позиції Макс.
пп дани довжина
х поля
13. - - N N/A 131-145 15
14. - - C N/A 146-159 14
15. - - N N/A 160-165 6
16. - - C N/A 166-179 14
17. - - C N/A 180-217 38
18. - - C N/A 218-231 14
19. - - C N/A 232-485 254
20. Тип списания Тип списання комісії: N + 486-487 2
комиссии 0 - утримати з суми на
купівлю,
1 - списати з нашого
рахунку,
2 - перерахувати на
рахунок в нашому банку
21. Код валюты Код валюти комісії C + 488-490 3
комиссии (Трилітерний код згідно ISO
стандарту)
22. - - C N/A 491-504 14
23. Срочность Ознака терміновості N - 505 1
платежу:
0 - терміновий;
1 - нетерміновий
24. Номер документа Номер документа, на З + 506-555 50
підставі якого здійснюється
купівля валюти
25. Дата документа Дата документа, на підставі D + 556-561 6
якого здійснюється купівля
валюти
26. Уполномоченное ПІБ співробітника клієнта, C + 562-591 30
лицо уповноваженого на
вирішення питань по заявці
27. Контактный Телефон співробітника C + 592-604 13
телефон клієнта, уповноваженого на
вирішення питань по заявці
28. Другое Додаткова інформація за C - 605-854 250
заявкою
29. CRLF CRLF, перехід на наступний C
рядок для введення + 855- 2
інформації по документу (за 856
допомогою кнопки Enter)

Зразки файлів додаються до комплекту документації (див.


«3.3.1.Import_FC_purchase (alt) .dat», «3.3.1.Import_FC_purchase (alt) .txt»).
3.3.2. Імпорт заявки на продаж валюти

Перший рядок файлу імпорту повинен містити опис типу імпортованих


документів, тобто він свідчить про те, до якого типу відносяться всі наступні
документи. Тип операції слід вказувати один раз в першому рядку імпортованого
файлу:
№ Найменування Опис Тип О/З Позиції Макс.
пп поля дани довжина
х поля
1. Идентификатор Тип документа, який повинен C + 1-13 13
операции мати вигляд:
OperationID = N,
де N - тип операції
імпортованого документа,
який може набувати таких
значень:
1 - продаж валюти;
2 - купівля валюти;
3 - валютне платіжне
доручення;
4 - конверсія валюти
2. CRLF CRLF, перехід на наступний C + 14-15 2
рядок для введення
інформації по документу (за
допомогою кнопки Enter)

У наступних рядках файлу імпорту введіть дані заявки на продаж валюти


(кількість таких рядків залежить від кількості імпортованих документів)
відповідно з описом, наведеним в таблиці:
№ Назва поля Опис Тип О/З Позиції Макс.
пп дани довжина
х поля
14. Номер документа Порядковий номер заявки C + 1-10 10
15. Дата документа Дата формування заявки D + 11-16 6
16. Наименование Найменування клієнта З - 17-54 38
клиента
17. Идентификацион- Ідентифікаційний код З - 55-68 14
ный код клиента клієнта
18. Уполномоченное ПІБ співробітника клієнта, З + 69-98 30
лицо уповноваженого на
вирішення питань по заявці
19. Контактный Телефон співробітника З + 99-111 13
телефон клієнта, уповноваженого на
вирішення питань по заявці
20. Сумма продажи Сума продажу в копійках N + 112-127 16
(без розділових знаків: ком,
крапок і т.п.)
21. Код валюты З + 128-130 3
Код валюти транзакції.
(Трилітерний код валюти
№ Назва поля Опис Тип О/З Позиції Макс.
пп дани довжина
х поля
згідно ISO стандарту)
22. Валютный счет Номер валютного рахунку З + 131-144 14
платника
23. Тип курса Тип курсу валют: N + 145 1
0 - уповноваженого банку,
1 - мінімальний
24. Минимальный Курс продажу валюти. N +/- 146-160 15
курс продажи Обов'язково для
заповнення при виборі типу
курсу валюти -
«Мінімальний»
25. Срочность Ознака терміновості N + 161 1
продажи продажу:
0 - Сьогодні;
1 - Завтра;
2 - Спот;
3 - Сьогодні. терміново
26. Номер счета Номер гривневого рахунку З + 162-176 15
27. Код банка Код банку гривневого N + 177-182 6
рахунку
28. Дополнительная Додаткова інформація за C + 183-436 254
информация заявкою
16. CRLF CRLF, перехід на наступний C 437-438 2
рядок для введення +
інформації по документу (за
допомогою кнопки Enter)

Зразки файлів додаються до комплекту документації (див.


«3.3.2.Import_FC_sale (alt) .dat», «3.3.2.Import_FC_sale (alt) .txt»).

3.3.3. Імпорт заявки на конверсію валюти

Перший рядок файлу імпорту повинна містити опис типу імпортованих


документів, тобто вона свідчить про те, до якого типу відносяться всі наступні
документи. Тип операції слід вказувати один раз в першому рядку імпортованого
файлу:
№ Найменування опис Тип О/З позиції Макс.
пп поля даних довжина
поля
№ Найменування опис Тип О/З позиції Макс.
пп поля даних довжина
поля
1. Идентификатор Тип документа, який повинен C + 1-13 13
операции мати вигляд:
OperationID = N,
де N - тип операції
імпортованого документа,
який може набувати таких
значень:
1 - продаж валюти;
2 - купівля валюти;
3 - валютне платіжне
доручення;
4 - конверсія валюти.
2. CRLF CRLF, перехід на наступний C + 14-15 2
рядок для введення
інформації по документу (за
допомогою кнопки Enter)

У наступних рядках файлу імпорту введіть дані заявки на конверсію валюти


(кількість таких рядків залежить від кількості імпортованих документів)
відповідно до описом, наведеним в таблиці:
№ Назва поля опис Тип О/З позиції Макс.
пп даних довжина
поля
1. Номер документа Порядковий номер заявки C + 1-10 10
2. Дата документа Дата формування заявки D + 11-16 6
3. Код покупаемой З + 17-19 3
Код валюти, що купується
валюты
(Трилітерний код валюти
згідно ISO стандарту)
4. Сумма N + 20-34 15
Сума валюти, що купується в
покупаемой
копійках (без розділових
валюты
знаків: ком, крапок і т.п.)
5. Код продаваемой Код валюти, що продається C + 35-37 3
валюты (Трилітерний код валюти
згідно ISO стандарту)
6. Номер счета Номер рахунку, з якого буде C + 38-51 14
списания списана валюта
продаваемой
валюты
7. Режим покупки Режим вказує, яким чином N + 52 1
валюты слід перерахувати валюту,
що купується:
0 - зарахувати на наш
рахунок;
1 - перерахувати згідно з
платіжним дорученням
№ Назва поля опис Тип О/З позиції Макс.
пп даних довжина
поля
8. Номер счета Номер рахунку, на який буде C +/- 53-66 14
зачисления зарахована валюта.
покупаемой Обов'язково для заповнення
валюты при виборі режиму купівлі
валюти «Зарахувати на наш
рахунок»
9. Номер Номер платіжного C +/- 67-76 10
платежного доручення, згідно з яким
поручения буде перерахована
купується валюта.
Обов'язково для заповнення
при виборі режиму купівлі
валюти «Купуємо згідно з
платіжним дорученням»
10. Дата платежного Дата платіжного доручення, D +/- 77-82 6
поручения згідно з яким буде
перерахована валюта що
купується.
Обов'язково для заповнення
при виборі режиму купівлі
валюти «Купуємо згідно з
платіжним дорученням»
11. Наименование Найменування клієнта C - 83-120 38
клиента
12. Адрес Адреса клієнта C - 121-180 60
13. Номер документа Номер документа, на підставі C + 181-230 50
якого відбувається конверсія
валюти
14. Дата документа Дата документа, на підставі D + 231-236 6
якого відбувається конверсія
валюти
15. Другое Додаткова інформація за З + 237-486 250
заявкою
16. CRLF CRLF, перехід на наступний З + 487-488 2
рядок для введення
інформації по документу (за
допомогою кнопки Enter)

Зразки файлів додаються до комплекту документації (див.


«3.3.3.Import_FC_conversion (alt) .dat», «3.3.3.Import_FC_conversion (alt) .txt»).

3.4. Імпорт з файлу даних клієнт-банку SAP R / 3

3.4.1. Імпорт валютного платіжного доручення

Файл містить сукупність рядків, що являють собою розрахункові документи.


Рядки завершуються послідовністю CR-LF. Ці записи імпортуються з файлів у
форматі UFT8.
Кожен рядок файлу імпорту складається з полів, обмежених символом «·».
У таблиці наведено структуру одного рядку файлу, отже, кількість таких
рядків буде залежати від того, скільки платежів містить файл імпорту.
№ Найменування Опис Тип О/З Макс.
пп поля даних довжина
поля
1. Номер документа Порядковий номер документа C + 10
2. Дата документа Дата формування документа D + 6
3. Код валюты Валюта платіжного доручення. C + 3
документа (Трилітерний код валюти згідно ISO
стандарту)
4. Сумма Сума транзакції в копійках (без N + 15
розділових знаків: ком, крапок і т.п.)
5. Номер валютного Номер валютного рахунку платника З + 14
счета
6. Основание Поле містить мету і / або підставу C + 38
платежу
7. Банк-получатель BIC-код банку одержувача C + 34
(BIC)
8. Банк-получатель Ідентифікатор з боку банку- C + 34
(Par ID) одержувача
(Party identifier)
9. Банк-получатель Значення визначає спосіб C + 2
(формат) ідентифікації отримувача:
A - по BIC коду і ParID;
D - по ParID і найменуванню та
адресою одержувача
10. Номер счета Номер рахунку отримувача З + 34
11. Наименование и Поле містить найменування та адресу C + 146
адрес клієнта, якому буде зарахована сума
получателя транзакції.
 зазначені вами дані трьома
розділовими комами розбиваються на
не більше ніж 4-ри рядки;
 кожен рядок (не рахуючи розділові
коми) включає не більше 34 символів;
 після заповнення поля, вся решта
незаповненних позицій (до 146)
заповнюється пробілами для того, щоб
не відбулося зсуву наступних полів
файлу;
 якщо рядок містить внутрішні коми
або пробіли, то вони з обох сторін
повинні виділятися подвійними
лапками;
 у форматі SWIFT перші два рядки
використовуються для Назви
одержувача, а дві наступні - для
Адреси одержувача.

приклад 1 - поле містить 4 рядки


(кожен не більше 34 символів):
№ Найменування Опис Тип О/З Макс.
пп поля даних довжина
поля
рядок1, рядок2, рядок3, рядок4
приклад 2 - поле містить 3 рядки
(кожен не більше 34 символів):
рядок1, рядок2, рядок3
приклад 3 - поле містить 3 рядки
(кожен не більше 34 символів),
причому другий рядок містить
внутрішню кому:
рядок1, "рядок, 2", рядок3
12. Банк-посредник BIC-код банку-посередника C - 34
(BIC)
13. Банк-посредник Ідентифікатор з боку банку- C - 34
(Par ID) посередника
(Party identifier)
14. Банк-посредник Значення визначає спосіб C - 2
(формат) ідентифікації банку-посередника:
A - по BIC коду і ParID;
D - по ParID і найменуванню та
адресою банку-одержувача
15. Банк-посредник Поле містить найменування та адресу C - 146
(наименование и фінансової організації, через яку
адрес) повинна здійснюватися поточна
транзакція.
 зазначені вами дані трьома
розділовими комами розбиваються на
не більше ніж 4-ри рядки;
 кожен рядок (не рахуючи розділові
коми) включає не більше 34 символів;
 після заповнення поля, все решта
незаповненних позицій (до 146)
заповнюється пробілами для того, щоб
не відбулося зсуву наступних полів
файлу;
 якщо рядок містить внутрішні коми
або пробіли, то він з обох сторін
повинна виділятися подвійними
лапками;
 у форматі SWIFT перші два рядки
використовуються для Назви банку-
посередника, а два наступні - для
Адреси банку-посередника.

приклад 1 - поле містить 4 рядки


(кожен не більше 34 символів):
рядок1, рядок2, рядок3, рядок4
приклад 2 - поле містить 3 рядки
(кожен не більше 34 символів):
рядок1, рядок2, рядок3
приклад 3 - поле містить 3 рядки
№ Найменування Опис Тип О/З Макс.
пп поля даних довжина
поля
(кожен не більше 34 символів),
причому другий рядок містить
внутрішню кому:
рядок1, "рядок, 2", рядок3
16. - Значення не використовується при - - 5
імпорті. Може бути заповнене
пробілами
17. Код типа Значення визначає, з якої зі сторін C + 5
списания буде стягуватися комісія за
комиссии транзакцію.
В полі може бути зазначена тільки
одне з наведених значень: BEN, SHA,
FULL, OUR (докладний опис
знаходиться в документації
iFOBS_WinClient_Керівництво
користувача.doc)
18. - Значення не використовується при - - 4
імпорті. Може бути заповнене
пробілами
19. Код страны Код країни одержувача (цифровий 3- N + 4
получателя значний код, ISO стандарт)
20. Код операции Значення визначає тип операції. C + 10
1ПБ Значення з довідника кодів 1ПБ
(Довідник для роботи з валютними
документами / Коди 1ПБ)
21. Назначение Поле визначає деталі угоди, які будуть C + 146
платежа передані одержувачу.
 зазначені вами дані трьома
розділовими комами розбиваються на
не більше ніж 4-ри рядки;
 кожен рядок (не рахуючи розділові
коми) включає не більше 34 символи;
 після заповнення поля, вся решта
незаповненних позицій (до 146)
заповнюється пробілами для того, щоб
не відбулося зсуву наступних полів
файлу;
 якщо рядок містить внутрішні коми
або пробіли, то він з обох сторін
повинен виділятися подвійними
лапками.

приклад 1 - поле містить 4 рядки


(кожен не більше 34 символів):
рядок1, рядок2, рядок3, рядок4
приклад 2 - поле містить 3 рядки
(кожен не більше 34 символів):
рядок1, рядок2, рядок3
приклад 3 - поле містить 3 рядки
(кожен не більше 34 символів),
№ Найменування Опис Тип О/З Макс.
пп поля даних довжина
поля
причому другий рядок містить
внутрішню кому:
рядок1, "рядок, 2", рядок3
22. Дополнительная У полі зазначаються додаткові C - 220
информация відомості по документу, які будуть
поле 72 передані одержувачу.
 зазначені вами дані трьома
розділовими комами розбиваються на
не більше ніж 6 рядків;
 кожен рядок (не рахуючи розділові
коми) включає не більше 34 символів;
 після заповнення поля, вся решта
незаповненних позицій (до 220)
заповнюється пробілами для того, щоб
не відбулося зсуву наступних полів
файлу;
 якщо рядок містить внутрішні коми
або пробіли, то він з обох сторін
повинен виділятися подвійними
лапками.

приклад 1 - поле містить 6 рядка


(кожен не більше 34 символів):
рядок1, рядок2, рядок3, рядок4,
рядок5, рядок6
приклад 2 - поле містить 3 рядки
(кожен не більше 34 символів):
рядок1, рядок2, рядок3
приклад 3 - поле містить 3 рядки
(кожен не більше 34 символів),
причому другий рядок містить
внутрішню кому:
рядок1, "рядок, 2", рядок3
23. Наименование и Поле містить найменування та адресу C + 146
адрес власника рахунку, з якого буде
плательщика проводиться списання коштів за
даною транзакцією.
 зазначені вами дані трьома
розділовими комами розбиваються на
не більше ніж 4-ри рядки;
 кожен рядок (не рахуючи розділові
коми) включає не більше 34 символів;
 після заповнення поля, вся решта
незаповненних позицій (до 146)
заповнюється пробілами для того, щоб
не відбулося зсуву наступних полів
файлу;
 якщо рядок містить внутрішні коми
або пробіли, то він з обох сторін
повинен виділятися подвійними
№ Найменування Опис Тип О/З Макс.
пп поля даних довжина
поля
лапками;
 в форматі SWIFT перші два рядки
використовуються для Назви
платника, а два наступні - для Адреси
платника.

приклад 1 - поле містить 4 рядки


(кожен не більше 34 символів):
рядок1, рядок2, рядок3, рядок4
приклад 2 - поле містить 3 рядки
(кожен не більше 34 символів):
рядок1, рядок2, рядок3
приклад 3 - поле містить 3 рядки
(кожен не більше 34 символів),
причому другий рядок містить
внутрішню кому:
рядок1, "рядок, 2", рядок3
24. Дополнительные Додаткову інформацію стосовно цього C - 146
комментарии платіжного доручення
25. Действителен с… Дата, починаючи з якої платіж буде D + 6
вважатися дійсним.
Формат дати - РРММДД
26. Счет комиссии Номер рахунку для списання комісії З + 14
27. Банк-получатель Назва та адреса банку одержувача C + 146
(наименование и  зазначені вами дані трьома
адрес) розділовими комами розбиваються на
не більше ніж 4-ри рядки;
 кожен рядок (не рахуючи розділові
коми) включає не більше 34 символів;
 після заповнення поля, вся решта
незаповненої позиції (до 146)
заповнюється пробілами для того, щоб
не відбулося зсуву наступних полів
файлу;
 якщо рядок містить внутрішні коми
або пробіли, то він з обох сторін
повинен виділятися подвійними
лапками;
 у форматі SWIFT перші два рядки
використовуються для Назви банку-
одержувача, а два наступні - для
Адреси банку-одержувача.

приклад 1 - поле містить 4 рядки


(кожен не більше 34 символів):
рядок1, рядок2, рядок3, рядок4
приклад 2 - поле містить 3 рядки
(кожен не більше 34 символів):
№ Найменування Опис Тип О/З Макс.
пп поля даних довжина
поля
рядок1, рядок2, рядок3
приклад 3 - поле містить 3 рядки
(кожен не більше 34 символів),
причому другий рядок містить
внутрішню кому:
рядок1, "рядок, 2", рядок3
28. Валюта счета Код валюти рахунку списання C + 3
списания (ISO стандарт, 3-літерний код)
29. Код валюты Код валюти комісії C + 3
комиссии (ISO стандарт, 3-літерний код).
Примітка. Згідно з постановою НБУ,
комісія повинна стягуватися в гривні
(код - UAH)
30. CRLF CRLF, перехід на наступний рядок для C + 2
введення інформації по документу (за
допомогою кнопки Enter)

Примітка. Строкові значення (позначені символом «С») будуть


перевірятися на відповідність стандартам SWIFT документів. Система забороняє
імпорт файлів, строкові значення яких містять такі символи: §, ", ¶,", {,}.
Зразки файлів додаються до комплекту документації (див.
«3.4.1.Import_FC_payment.dat»).

3.4.2. Імпорт валютного документа

Файл містить сукупність рядків, що представляють собою розрахункові


документи. Рядки завершуються послідовністю CR-LF. Ці записи імпортуються з
файлів у форматі UFT8.
Кожен рядок файлу імпорту складається з полів, обмежених символом «·».
У таблиці наведено структуру одного рядку файлу, отже, кількість таких
рядків буде залежати від того, скільки платежів містить файл імпорту.
№ Опис поля Тип даних Мін. і макс.
пп довжина поля
1. Направление маpшpутизации: N 1, 3

0 - вхідний документ
Вид платежного документа. N 1, 4
2.
Для валютних документів: 55, 56, 60, 70, 2211,
2221
Номер платежного документа З 1,10
3.

Дата выписки платежного документа. N 8, 8


4.
У фоpматі РРРРММДД
МФО по дебету N 6, 9
5.
№ Опис поля Тип даних Мін. і макс.
пп довжина поля
МФО по кpедиту N 6, 9
6.

Номер лицевого счета по дебету N 9,14


7.

Номер лицевого счета по кpедиту N 9,14


8.

Сумма платежа. N 3,17


9.
Для валютних документів - в дpобних одиницях
(без крапки)
Кассовый символ - якщо вид платіжного N 0, 2
10.
документа 2111, 2121, 2211, 2221.
Для всіх інших - поле не заповнюється
Наименование коppеспондента клиента З 5,38
11.

Назначение платежа З 10,160


12.

Дата валютирования З 0,10


13.

Код вида акцепта: 1, 2, 3 N 0, 1


14.

Код платежа N 0, 3
15.

Пpизнак пеpедачи (не використовується) N 0, 1


16.

Код ЕГРПОУ коppеспондента клиента З 0,14


17.

Код валюты - якщо вид платіжного документа 55, N 0, 3


18.
56, 2211, 2221.
Для всіх інших - поле не заповнюється

Зразки файлів додаються до комплекту документації (див.


«3.4.2.Import_FX_document.dat»).

3.5. Імпорт з XLS-файлу

3.5.1. Імпорт заявки на продаж валюти

Ці записи імпортуються з XLS-файлу фіксованої структури. У файлі повинна


бути закладка з назвою cbfxordersell, перший рядок - шапка таблиці, дані
починаються з другого рядка.
Стовпці у файлі повинні бути розташовані в такому порядку:
№ Назва та опис поля Опис Тип О/З Довжина
пп даних поля
1. Номер документа Номер заявки C + 10
2. Дата документа Дата формування заявки D + 6
3. Наименование Найменування контрагента З - 38
контрагента
№ Назва та опис поля Опис Тип О/З Довжина
пп даних поля
4. Идентификацион Ідентифікаційний код клієнта З - 14
ный код клиента
5. Уполномоченное ПІБ співробітника клієнта, З + 30
лицо уповноваженого на вирішення
питань по заявці
6. Контактный Телефон співробітника клієнта, З + 13
телефон уповноваженого на вирішення
питань по заявці
7. Сумма продажи Сума продажу в копійках (без N + 16
розділових знаків: ком, крапок і
т.п.)
8. Код валюты З + 3
Код валюти транзакції.
(Трилітерний код валюти згідно ISO
стандарту)
9. Валютный счет Номер валютного рахунку платника З + 14
10. Тип курса Тип курсу валют: N + 1
0 - уповноваженого банку,
1 - мінімальний
11. Минимальный Курс продажу валюти. N +/- 15
курс продажи Обов'язково для заповнення при
виборі типу курсу валюти -
«Мінімальний»
12. Срочность Ознака терміновості продажу: N + 1
продажи 0 - Сьогодні;
1 - Завтра;
2 - Спот;
3 - Сьогодні. терміново
13. Номер счета Номер гривневого рахунку З + 15
14. Код банка Код банку гривневого рахунку N + 6
15. Дополнительная Додаткова інформація за заявкою C + 254
информация
4. ЕКСПОРТ ЕЛЕКТРОННОЇ ВИПИСКИ
Увага! При експорті електронної виписки за замовчуванням в неї не
потрапляють інформаційні документи.

4.1. Експорт електронної виписки в текстовий і BOL-файл


При експорті документи зберігаються у файли із зазначенням дати запиту у
назві. Якщо було подано запит на формування виписки за певний період, тоді в
результаті вийде стільки файлів, скільки дат відповідає поданому запиту. Дата
вказується у форматі РРММДД. Наприклад, якщо в запиті було вказано число
11.05.2006, назва файлу буде мати вигляд 060511. Якщо ж у запиті було вказано
період, якому відповідає 3 документи: 1.07.2006, 4.07.2006, 6.07.2006, тоді буде
сформовано 3 файли з назвами: 060701, 060704, 060706.
Експортований файл буде містити дані в кодуванні, яка була обрана при
збереженні виписки у файл.
Увага! Експорт виписки виконується у файли з розширенням .dat,
незалежно від того, який формат (текстовий або BOL) був обраний для експорту.
У файлах прикладів розширення змінено на * .txt для наочності у разі експорту в
текстовий файл.
Опис
Файл є текстовим. Кожен рядок містить інформацію про один документ.
Рядки завершуються послідовністю CR-LF (ASCII-символи 13 і 10). Кожен рядок
має фіксовану структуру, описану в таблиці нижче.
Деякі поля не мають значення для «Клієнт-банку». Ці поля позначені
прочерком у таблиці, їх слід залишати порожніми при формуванні файлу
електронної виписки.
№ Найменування поля в Найменування поля в Тип позиції позиції
пп BOL TXT даних (короткійно
мер4)
МФО банка МФО банку А N 1-9 1-9
1.
плательщика
Номер счета рахунок А N 10-23 10-23
2. плательщика
МФО банка МФО банку Б N 24-32 24-32
3. получателя
Номер счета рахунок Б N 33-46 33-46
4. получателя
Тип финансовой Тип фінансової C 47-47 47-47
5. операции операції
Завжди = 1 (див. Опис
під таблицею)

У файлі виписки довжина поля «Номер документа» регулюється


налаштуванням клієнтських місць (за замовчуванням - 32 символи, в режимі
«короткий номер» - 10 символів)
№ Найменування поля в Найменування поля в Тип позиції позиції
пп BOL TXT даних (короткійно
мер4)
Сумма (в копейках) Сума (в копійках) N 48-63 48-63
6.

Вид документа Вид документа N 64-65 64-65


7.

Номер документа Номер документа C 66-97 66-75


8.

Код валюты Код валюти N 98-100 76-78


9.

Дата документа Дата документа D 101-106 79-84


10.

Дата получения Дата отримання D 107-112 85-90


11. документа в банке документа в банку
Наименование Найменування А C 113-150 91-128
12. плательщика
Наименование Найменування Б C 151-188 129-166
13. получателя
Назначение платежа Призначення C 189-348 167-326
14. платежу
Дополнительные Додаткові реквізити C 349-408 327-386
15. реквизиты
Код назначения Код призначення C 409-411 387-389
16. платежа платежу
- - C 412-413 390-391
17.

Идентификационный Ідентифікаційний C 414-427 392-405


18. код плательщика (код код А (код ЄДРПОУ)
ЕГРПОУ)
Идентификационный Ідентифікаційний C 428-441 406-419
19. код получателя (код код Б (код ЄДРПОУ)
ЕГРПОУ)
Уникальный номер Унікальний номер N 442-450 420-428
20. документа документа
- - C 451-456 429-434
21.

- - N 457-458 435-436
22.

- - C 459-466 437-444
23.

- - C 467-530 445-508
24.

- - C 531-542 509-520
25.

- - N 542-548 521-526
26.

- - T 549-552 527-530
27.
№ Найменування поля в Найменування поля в Тип позиції позиції
пп BOL TXT даних (короткійно
мер4)
- - T 553-556 531-534
28.

- - C 557-568 535-546
29.

- - N 569-574 547-552
30.

- - T 575-578 553-556
31.

- - T 579-582 557-560
32.

- - C 583-594 561-572
33.

- - N 595-600 573-578
34.

- - T 601-604 579-582
35.

- - T 605-608 583-586
36.

Дата проводки Дата проведення D 609-614 587-592


37. документа документа
CRLF CRLF C 615-616 593-594
38.

Нижче наведені пояснення до деяких реквізитів:


1. При експорті документа в текстовий файл поле №5 «Тип фінансової
операції» (позиція 47-47) має значення 0 (дебет) або 1 (кредит). Зліва
завжди вказуються реквізити свого рахунку, після нього - реквізити
чужого рахунку (рахунку кореспондента). Якщо тип фінансової операції
0 - це дебетовий документ (списання), якщо 1 - кредитовий
(нарахування).
При експорті документа в BOL-файл поле №5 «Тип фінансової операції»
(позиція 47-47) завжди має значення 1. Реквізити платника та
одержувача в даному випадку можуть мінятися місцями: наприклад,
якщо гроші перераховуються з рахунку А на рахунок Б, то зліва будуть
реквізити А, праворуч - Б; якщо гроші перераховуються з рахунку Б на
рахунок А, тоді ліворуч будуть вказані реквізити Б, праворуч - А.
У файлах електронної виписки додатково може зустрітися значення 0 -
безакцептне списання. «Платником» в такому випадку може бути тільки
уповноважена державна організація, і такий документ означає, що
кошти стягуються з рахунку одержувача за рішенням суду;
2. № 7, «Вид документа». Тип документа, який в файлах електронної
виписки найчастіше набуває таких значень:
a) 1 - Платіжне доручення
b) 2 - Меморіальний ордер
c) 3 - Валютний меморіальний ордер
d) 6 - Вхідний документ
e) 9 - Внутрішньобанківське платіжне доручення
f) 13 - Інформаційний дебет
g) 14 - Міжбанківський меморіальний ордер
h) 15 - Валютне платіжне доручення
i) 30 - Вхідний мемордер по СЕП
j) 33 - Касовий чек
k) 63 - Заява на переказ готівки (грн)
l) 65 - Заява на переказ готівки (вал)
3. № 8, «Номер документа». Бухгалтерський номер документа, що
проставляється на платіжному дорученні.
4. № 11, «Дата отримання документа в банку». У файлі електронної
виписки вказує дату надходження документа в банк платника.
5. № 15, «Додаткові реквізити». У цьому полі вказується код країни
платника / одержувача, якщо платник / одержувач є не резидентом, в
наступному форматі: # nП764О018 #, ( «П» і «О» - російські великі
символи), де «764» - код країни платника, « 018 »- код країни
одержувача.
6. № 16, «Код призначення платежу». Слід зазначати код 070 для платежів
до бюджету і залишати поле порожнім для всіх інших платежів
7. № 20, «Унікальний номер документа». У файлі електронної виписки
містить унікальний номер, присвоєний цьому документу в банку.
Зразки файлів додаються до комплекту документації (див.
«4.1.131101.dat», «4.1.131101.txt», з коротким номером:
«4.1.090930_short.dat», «4.1.090930_short.txt»).

4.2. Експорт електронної виписки в DBF-файл


У назві файлу за замовчуванням буде вказана дата запиту або дати
періоду, за який був поданий запит на формування виписки. Дата вказується у
форматі РРММДД. Наприклад, якщо в запиті було вказано число 11.05.2012,
назва файлу буде мати вигляд «120511». Якщо було подано запит на
формування виписки за певний період, тоді існує 2 варіанти збереження файлу:
1. З розбивкою файлів по датах - в результаті вийде стільки файлів, скільки
дат відповідає поданому запиту. Наприклад, якщо в запиті було вказано
період, якому відповідає 3 документа: 1.07.2012, 4.07.2012, 6.07.2012, тоді
буде сформовано 3 файлу з назвами: «120701», «120704», «120706».
2. В один файл5- в результаті буде створений один файл, в найменуванні
якого в якості першої дати буде вказана мінімальна дата проведення
документа з наявних у списку, в якості другої - максимальна дата. Дата

Додаткова функціональність
вказується у форматі РРРРММДД. Наприклад, поданим запитом відповідає 3
документа: перший проведено 16.05.2013, другий 18.05.2013, третій
23.05.2013. Файл буде мати вигляд «20130516_20130523».
Експортований файл буде містити дані в кодуванні, яка була обрана при
збереженні виписки в файл.
№ Найменування опис Тип даних Макс.
пп поля довжина
поля

1. N_DOC Номер документа C 32/10 *

MFO_DB МФО банку платника N 10


2.

RR_DB рахунок платника C 14


3.

NAIM_D Найменування платника C 40


4.

OKPO_DB Ід. код платника C 14


5.

MFO_CR МФО банку отримувача N 10


6.

RR_K Рахунок отримувача C 14


7.

NAIM_K Назва отримувача C 40


8.

OKPO_CR Ід. код отримувача C 14


9.

SUM Сума документа N 20


10.

SUMEQ Сума документа в гривневому еквіваленті N 20


11.

PRIZN Призначення платежу C 160


12.

DAT Дата документа D 8


13.

DAT_PR Дата проводки D 8


14.

KOD_VAL Код валюти документа N 10


15.

OPERAT Тип операції: 1 - дебет; 2 - кредит N 1


16.

DAT_GN Дата створення файлу експорту D 8


17.

DAT_ARC Поточний операційний день банку D 8


18.

TIM_PR6 Час проведення документа в форматі - hh: C 8


19.
mm: ss

Зразки файлів додаються до комплекту документації (див.


«4.2.090902.dbf», з коротким номером: «4.2.090902_short.dbf»).

Додаткова функціональність
4.3. Експорт електронної виписки в DBF-файл
(альтернативний)

У виписці враховуються тільки документи в нац. валюті.


Опис елементів:
№ пп Назва поля Опис поля виписки довжина
поля
1 DOC_DAY Дата в форматі 'дд / мм / рррр' 10
2 NUMBER Номер документа 10
3 A клієнт А 80
4 B клієнт Б 80
5 OKPO_A ЄДРПОУ А 14
6 OKPO_B ЄДРПОУ Б 14
7 ACCOUNT_A Рахунок клієнта А 14
8 ACCOUNT_B Рахунок клієнта Б 14
9 BANK_A банк А 38
10 BANK_B банк Б 38
11 MFO_A МФО А 9
12 MFO_B МФО Б 9
13 CITY_A Місто банку А 25
14 CITY_B Місто банку Б 25
15 AMOUNT Сума 18
16 DETAILS Деталі платежу 160

Зразки файлів додаються до комплекту документації (див.


«4.3.20080114.DBF»).

4.4. Експорт електронної виписки в XLS-файл


У назві файлу за замовчуванням буде вказана дата запиту або дати періоду,
за який був поданий запит на формування виписки. Дата вказується у форматі
РРРРММДД. У якості першої дати буде вказана мінімальна дата проведення
документа з наявних у списку, в якості другої - максимальна дата. Наприклад,
поданим запитом відповідає 3 документа: перший проведено 16.05.2007, другий
18.05.2007, третій 23.05.2007. Файл буде мати вигляд Doc_20070516_20070523.
№ Найменування поля опис
пп
1. Наш счет В полі відображається рахунок користувача
Операция Поле містить вид операції: дебет або кредит
2.

Счет Поле містить дані про рахунок контрагента


3.

МФО банка Поле містить код банку контрагента


4.
контрагента
Наименование Поле містить найменування контрагента відповідно до запису в
5.
контрагента системі
№ Найменування поля опис
пп
Код контрагента Поле містить інформацію про ідентифікаційний код контрагента
6.

Назначение платежа В полі вказано призначення платежу


7.

Дата проводки Поле містить дату, коли документ був проведений у банку, в
8.
форматі дд.мм.рррр (день.місяць.рік)
Номер документа Поле містить номер документа відповідно до його номеру в системі
9.

Сумма Поле містить інформацію про суму платежу


10.

Валюта В полі відображається тип валюти, в якій здійснювалась оплата


11.

Время проводки Поле містить час проведення документа в банку в форматі гг: мм
12.
(години: хвилини)
Дата документа Поле містить дату документа в форматі дд.мм.рррр
13.
(день.місяць.рік)
Дата архивирования Поле містить дату архівування документа в банку в форматі
14.
дд.мм.рррр (день.місяць.рік)
Ид.код Поле містить інформацію про ідентифікаційний код користувача
15.

Наименование Поле містить найменування користувача відповідно до запису в


16.
системі
МФО Поле містить код банку користувача
17.

Зразки файлів додаються до комплекту документації (див.


«4.4.Doc_20111102-20111214.xls»).

4.5. Експорт електронної виписки в XML-файл


При експорті документи зберігаються у файли із зазначенням дати експорту
в назві у форматі РРРРММДД. Якщо було подано запит на формування виписки
за певний період, тоді в результаті вийде стільки файлів, скільки дат відповідає
поданому запиту. Наприклад, якщо в запиті було вказано число 18.08.2011,
назва файлу буде мати вигляд Doc_20110818. Якщо ж в запиті було вказано
період, якому відповідає 3 документа: 1.07.2006, 4.07.2006, 6.07.2006, тоді буде
сформовано 3 файлу з назвами: Doc_20060701, Doc_20060704, Doc_20060706.
Опис
Формат XML-файлу експорту наступний:

<? Xml version = "1.0" encoding = "windows-1251"?>


<ROWDATA>
<ROW... /> - це перший документ в списку
...
<ROW... /> - це останній документ у списку
</ROWDATA>
ROWDATA - кореневий вузол XML документа, який містить всі експортовані
документи. Кожному документу відповідає один тег <ROW ARCDATE ... />.
усередині тега <ROW ARCDATE ... /> містяться реквізити експортованих документів.
Опис атрибутів і їх призначення наведено в таблиці нижче.

№ Найменування атрибута опис Тип даних


пп
ARCDATE Дата архівування документа в банку D
1.
DOCUMENTNO № документа З
2.
ACCOUNTNO Номер рахунку платника N
3.
CURRENCYID Код валюти документа N
4.
BANKID Код банку платника (МФО) N
5.
CORRBANKID Код банку отримувача (МФО) N
6.
CORRACCOUNTNO Номер рахунку отримувача C
7.
OPERATIONID Ідентифікатор операції: N
8.
0 - дебет
1 - кредит
2 - дебет інформаційний
3 - кредит інформаційний
BANKDATE Дата прийняття документа в банку D
9.
CURRSYMBOLCODE Код валюти платежу (Трилітерний код C
10. валюти згідно ISO стандарту)
DOCSUBTYPESNAME Тип документа C
11.
PLATPURPOSE Призначення платежу C
12.
DOCUMENTDATE Дата створення документа D
13.
CORRBANKNAME Найменування банку одержувача C
14.
CORRIDENTIFYCODE Ідентифікаційний код отримувача N
15.
CORRCONTRAGENTSNAME Найменування контрагента одержувача C
16.
BANKNAME Найменування банку платника C
17.
IDENTIFYCODE Ідентифікаційний код платника N
18.
ACCDESCR опис рахунку C
19.
№ Найменування атрибута опис Тип даних
пп
CONTRAGENTSNAME Найменування контрагента C
20.
ACCOUNTID Внутрішній ідентифікатор рахунку платника N
21.
BOOKEDDATE Дата проведення документа в банку D
22.
DOCUMENTTYPEID Тип документа N
23.
DATAVERSION Версія записи в БД iFOBS C
24.
SUMMAEQ Сума платежу в гривневому еквіваленті (для N
25. платежів в валюті)
SUMMA Сума платежу в копійках N
26.
KODPLATPURPOSE Код призначення платежу N
27.
ACC_OPERATOR Логін операціоніста банку, відповідального за C
28. поточним рахунком
ACC_OPERATOR_FIO ПІБ операціоніста бакна, відповідального за C
29. поточним рахунком
COMMISSION Комісія для гривневих платежів N
30.
AMOUNTEQ Сума документа в гривневому еквіваленті N
31.
(Для платежів в валюті).
Примітка. Якщо дане поле не заповнено і
для виписки задана настройка «Показувати
еквіваленти», сума еквівалента буде
розрахована в поле SUMMAEQ (ця примітка
дійсно тільки для windows-додатки iFOBS)

Зразки файлів додаються до комплекту документації (див.


«4.5.Doc_20120209.xml»).

4.6. Експорт електронної виписки в файл формату SAP R / 3


(МТС)
Найменування файлу визначається датою та часом його генерації.
Якщо в ньому містяться виписки за кілька днів, тоді він матиме вигляд
vyymmdd.hmm, де:
 v - префікс файлу, який вказує, що документ є вихідним. Всі файли
експорту з SAP R / 3 починаються з латинської літери v;
 yymmdd - дата створення файлу в форматі ГГММДД;
 hmm - час створення файлу (години та хвилини).
Годинники у системі можуть позначатися символами 0-9 і AN (А
відповідає 10 годинам, B - 11, C - 12 і т.д. до N - 23).
Якщо у файлі містяться виписки за один день, тоді він матиме вигляд
vyymmdd.zzz, де:
 v - префікс файлу, який вказує, що документ є вихідним. Всі файли
експорту з SAP R / 3 починаються з латинської літери v;
 yymmdd - дата створення файлу в форматі ГГММДД;
 zzz - постійне розширення файлу зазначеного змісту.

Файл містить сукупність рядків, що представляють собою розрахункові


документи. Рядки завершуються послідовністю CR-LF (ASCII-символи 13 і 10).

Кожен рядок файлу складається з полів, обмежених символом «·».


Всі рядки, крім описаних для них полів, мають 0-е класифікаційне поле
довжиною в 1 символ:
«0» - Оборотно-сальдова рядок
Складається з наступних полів:
№ Опис поля Макс. довжина
пп поля
1. Номер рахунку, за яким сформована виписка. 14
Якщо в номері рахунку міститься менше 14 символів, то він
вирівнюється по лівому краю поля, і недостатня кількість
символів заповнюється пробілами до 14 символів
Дата описуваного руху по рахунку 8
2.
Дата попереднього руху по рахунку 8
3.
Залишок на початок дня (В копійках) 19
4.
Тип залишку: 1
5.
«+» - пасивний
«-» - активний
Кількість документів, які пройшли по списанню 6
6.
Сума дебетових оборотів в копійках (документів які 19
7.
пройшли по списанню)
Кількість документів, які пройшли по зарахуванню 6
8.
Сума кредитових оборотів в копійках (документів які 19
9.
пройшли по зарахуванню)
Залишок на кінець дня (В копійках) 19
10.
Тип залишку: 1
11.
«+» - пасивний
«-» - активний

Разом: 115 символів + 1 (класифікаційний) = 116

«1» - Платіжна рядок


Містить реально платіж що пройшов по рахунку (який змінив залишок).
Складається з наступних полів:
№ опис поля Макс. довжина
пп поля
1. Тип платежу: 1
«+» - зарахування
«-» - списання
МФО банку А (відправник платежу) 9
2.
Особовий рахунок клієнта банку А. 14
3.
Якщо в номері рахунку міститься менше 14 символів, то він
вирівнюється по лівому краю поля, і недостатню кількість
символів заповнюється пробілами до 14 символів
Код ЄДРПОУ клієнта банку А. 14
4.
(поле може бути незаповненим)
Найменування клієнта банку А 40
5.
МФО банку Б (одержувач платежу) 9
6.
Особовий рахунок клієнта банку Б. 14
7.
Якщо в номері рахунку міститься менше 14 символів, то він
вирівнюється по лівому краю поля, і недостатню кількість
символів заповнюється пробілами до 14 символів
Код ЄДРПОУ клієнта банку Б. 14
8.
(поле може бути незаповненим)
Найменування клієнта банку Б 40
9.
Вид платежу (зміст не регламентується НБУ) 2
10.
Операційний номер платежу 10
11.
Сума платежу в копійках 19
12.
Дата відправки з банку А. 8
13.
Поле є довідковим, тому може не заповнюватися
Час відправлення з банку А. 4
14.
Поле є довідковим, тому може не заповнюватися
Дата отримання банком Б 8
15.
Поле є довідковим, тому може не заповнюватися
Час отримання банком Б 4
16.
Призначення платежу 255
17.

Разом: 466 символи + 1 (класифікаційний) = 467


Примітка. Якщо платіж дебетовий, то балансовий рахунок буде вказано в
полі №3, якщо кредитовий - в поле №7.

«2» - Платіжний запит


Містить платіжну вимогу, що спрямована клієнту іншим клієнтом для
прийняття рішення про оплату. Ці платежі не проходять по рахунку і є
інформаційними.
Складається з таких же полів, як і рядок «1», Платіжна рядок (див.
Таблицю вище), за винятком зміни першого поля:
Тип документа «+» - платіжний запит клієнта, «-» - платіжний запит
клієнта.
Зразки файлів додаються до комплекту документації (див.
«4.6.v090914.ZZZ»).

4.7. Експорт електронної виписки в файл формату 1С


При експорті документи зберігаються у файли із зазначенням номера
рахунку і періоду запиту виписки у назві. Приклад імені файлу:
«Doc_260023001300_UAH_20001126-20091126.1C», де:
 «Doc» - символьний ідентифікатор документа;
 «260023001300» - номер рахунку користувача;
 «UAH» - код валюти рахунку;
 «20001126-20091126» - початкова і кінцева дати періоду виписки в
форматі РРРРММДД.
При формуванні виписок по декількох рахунках, виписка по кожному
рахунку зберігається в окремий файл. У Web-додатку файли виписок за
окремими рахунками зберігаються в zip-архіві. У Windows-додатку архівація не
проводиться.
Файл є текстовим і містить сукупність рядків, що представляють собою
розрахункові документи. Рядки завершуються послідовністю CR-LF (ASCII-
символи 13 і 10). Дані по кожному новому розрахунковому документу
починаються з ознаки «СекцияДокумент = ...», закінчення даних позначається
ознакою «КонецДокумента».
Тип даних,
№ макс.
Найменування реквізиту Опис довжина О/З Примітка
пп
поля
Тема файлу
1CClientBankExchange Внутрішня
1. ознака файлу
обміну
Загальні відомості
ВерсияФормата Номер версії C + Приклад
2. формату обміну заповнення:
ВерсіяФормата = 1.01
Кодировка Кодування C + Можливі значення:
3. файлу DOS, Windows
Отправитель Програма- C - Приклад
4. відправник заповнення:
Відправник = 1С
Тип даних,
№ макс.
Найменування реквізиту Опис довжина О/З Примітка
пп
поля
Получатель Програма- C + Приклад
5. одержувач заповнення:
Одержувач = 1С
ДатаСоздания Дата D -
6. формування (В форматі
файлу дд.мм.рррр)
ВремяСоздания Час формування T -
7. файлу
Відомості про умови відбору даних, що передаються
ДатаНачала Дата початку D + У цьому інтервалі
8. інтервалу передаються всі
(В форматі
дд.мм.рррр) існуючі документи
ДатаКонца Дата кінця D +
9. інтервалу (В форматі
дд.мм.рррр)
РасчСчет Розрахунковий 20 + Зазначений рахунок
10. рахунок синхронізує-ся в
організації зазначеному інтервалі
(рядків може
бути кілька)
Документ Вид документа C N/A Можливі значення:
11. (рядків може Платіжне доручення,
бути кілька) Акредитив (Заява на
акредитив), платіжне
вимога, Інкасове
доручення
Секція передачі залишків по розрахунковому рахунку
СекцияРасчСчет Ознака початку
12. секції
ДатаНачала Дата початку D + У цьому інтервалі
13. інтервалу передаються всі
(В форматі
дд.мм.рррр) існуючі документи
ДатаКонца Дата кінця D -
14. інтервалу (В форматі
дд.мм.рррр)
РасчСчет Розрахунковий 20 +
15. рахунок
організації
НачальныйОстаток початковий грн [.коп] + Ці значення
16. залишок використовуються для
ВсегоПоступило Обороти вхідних звірки з обліковими
грн [.коп] -
17. платежів даними і для
контролю отриманих
ВсегоСписано Обороти грн [.коп] - документів виписки
18. вихідних
платежів
КонечныйОстаток Кінцевий грн [.коп] -
19. залишок
Тип даних,
№ макс.
Найменування реквізиту Опис довжина О/З Примітка
пп
поля
КонецРасчСчет Ознака
20. закінчення секції
Секція платіжного документа
Шапка платіжного документа
СекцияДокумент Ознака початку Можливі значення:
21. секції містить Платіжне доручення,
вид документа Акредитив (Заява на
акредитив), платіжне
вимога, Інкасове
доручення
Номер Номер документа З +
22.
Дата Дата документа D +
23.
(В форматі
дд.мм.рррр)
Сумма Сума платежу грн [.коп] +
24.
Квитанція за платіжним документом
КвитанцияДата Дата D - Квитанція
25. формування передається тільки з
(В форматі
квитанції дд.мм.рррр) Клієнта в 1С
КвитанцияВремя Час формування T -
26. квитанції
КвитанцияСодержание зміст квитанції З -
27.
реквізити платника
Розрахунковий 20 + Розрахунковий
28. ПлательщикСче рахунок рахунок платника в
т платника його банку,
незалежно від того,
прямі розрахунки у
цього банку чи ні
ДатаСписано Дата списання D + Вказується, якщо
29. коштів з р / с відомо, що документ
(В форматі
дд.мм.рррр) проведено по
розрахунковому
рахунку платника
Плательщик платник З - Найменування і ідент.
30. код платника (і його
ПлательщикИНН Ідентифік-ційний 20 + банку при непрямих
31. код платника розрахунках)
У разі непрямих розрахунків:
Плательщик1 Найменування З - Найменування
32. платника, стр.1 платника
Плательщик2 Найменування З - Розрахунковий
33. платника, стор.2 рахунок платника
Тип даних,
№ макс.
Найменування реквізиту Опис довжина О/З Примітка
пп
поля
Плательщик3 Найменування З - банк платника
34. платника, стор.3
Плательщик4 Найменування З - Місто банку платника
35. платника, стор.4
ПлательщикРасчСчет Розрахунковий 20 - Коррахунок банку
36. рахунок платника
платника
ПлательщикБанк1 банк платника З - РЦ банку платника
37.
ПлательщикБанк2 Місто банку З - Місто РЦ банку
38. платника платника
ПлательщикБИК БИК банку 9 - БИК РЦ банку
39. платника платника
ПлательщикКорсчет Коррахунок 20 - Коррахунок РЦ банку
40. банку платника платника
Реквізити банку отримувача (постачальника)
ПолучательСчет Розрахунковий 20 + Розрахунковий
41. рахунок рахунок одержувача в
одержувача його банку,
незалежно від того,
прямі розрахунки у
цього банку чи ні
ДатаПоступило Дата D + Вказується, якщо
42. надходження відомо, що документ
(В форматі
коштів на р / с дд.мм.рррр) проведено по
розрахунковому
рахунку одержувача
Получатель одержувач З - Одержувач одним
43. рядком
ПолучательИНН Ідентифік-ційний 20 + Найменування і ідент.
44. код одержувача код отримувача (і
його банку при
непрямих
розрахунках)
У разі непрямих розрахунків:
Получатель1 Назва З - Назва отримувача
45. отримувача
Получатель2 Найменування З - Розрахунковий
46. одержувача, рахунок одержувача
стор. 2
Получатель3 Найменування З - Банк одержувача
47. одержувача,
стор. 3
Получатель4 Найменування З - Місто банку
48. одержувача, отримувача
стор. 4
ПолучательРасчСчет Розрахунковий 20 - Коррахунок банку
49. рахунок одержувача
Тип даних,
№ макс.
Найменування реквізиту Опис довжина О/З Примітка
пп
поля
одержувача
ПолучательБанк1 Банк одержувача З - РЦ банку одержувача
50.
ПолучательБанк2 Місто банку З - Місто РЦ банку
51. отримувача одержувача
ПолучательБИК БИК банку 9 - БИК РЦ банку
52. одержувача одержувача
ПолучательКорсчет Коррахунок 20 - Коррахунок РЦ банку
53. банку одержувача
одержувача
Реквізити платежу
ВидПлатежа Вид платежу З - Можливі значення:
54. Поштою, Телеграфом,
Електронно
ВидОплаты Вид оплати (вид 2 -
55. операції)
У заяві акредитив:
СрокПлатежа Термін платежу D - Термін дії акредитива
56. (акредитива) (В форматі
дд.мм.рррр)
Очередность черговість 2 - Не використовується
57. платежу
НазначениеПлатежа Призначення З - Призначення платежу
58. платежу одним рядком.
Приклад заповнення:
Плата за прод. харч.
согласно накл.235 від
31.07.08р. у т.ч. ПДВ
1024,00 грн.
НазначениеПлатежа1 Призначення З - Призначення
59. платежу, стор. 1 платежу, розбите на
НазначениеПлатежа2 Призначення З - рядки самим
60. платежу, стор. 2 користувачем, якщо
програма-відправник
НазначениеПлатежа3 Призначення З - допускає введення
61. платежу, стор. 3 багаторядкового
НазначениеПлатежа4 Призначення З - тексту
62. платежу, стор. 4
НазначениеПлатежа5 Призначення З -
63. платежу, стор. 5
НазначениеПлатежа6 Призначення З -
64. платежу, стор. 6
Додаткові реквізити для окремих видів документів
СрокАкцепта Термін акцепту, N -
65. кількість днів
ВидАккредитива вид акредитива C -
66.
Тип даних,
№ макс.
Найменування реквізиту Опис довжина О/З Примітка
пп
поля
УсловиеОплаты1 Умови оплати, C -
67. стор. 1
УсловиеОплаты2 Умови оплати, C -
68. стор. 2
УсловиеОплаты3 Умови оплати, C -
69. стор. 3
ПлатежПоПредст Платіж за C -
70. поданням
ДополнУсловия Додаткові умови C -
71.
НомерСчетаПоставщик № рахунки C - Рахунок депонування
72. а постачальника (40901)
ДатаОтсылкиДок Дата відсилання D -
73. документів (В форматі
дд.мм.рррр)
КонецДокумента Ознака
74. закінчення секції
КонецФайла Ознака кінця
75. файлу

Зразки файлів додаються до комплекту документації (див.


«4.7.Doc_260033002289_EUR_20001126-20091126.1C»).

4.8. Експорт в файл TXT (SEB)


Файл експорту електронної виписки у формат TXT (SEB) аналогічний файлу
імпорту документів з файлу формату TXT (SEB), описаного в п. «Імпорт з файлу
TXT (SEB)».
При експорті документи зберігаються у файли із зазначенням номера
рахунку і періоду запиту виписки в назві. Приклад імені файлу:
«Doc_260023001300_UAH_20001126-20091126.txt», де:
 «Doc» - символьний ідентифікатор документа;
 «260023001300» - номер рахунку користувача;
 «UAH» - код валюти рахунку;
 «20001126-20091126» - початкова і кінцева дати періоду виписки в
форматі РРРРММДД.
При формуванні виписок по декількох рахунках, виписка по кожному
рахунку зберігається в окремий файл.
Зразки файлів додаються до комплекту документації (див.
«4.8.Doc_260053001231_USD_20001126-20091126.txt»).

4.9. Експорт в файл XLS (SEB)


При експорті документи зберігаються у файли із зазначенням номера
рахунку і періоду запиту виписки в назві. Приклад імені файлу:
«Doc_260023001300_UAH_20001126-20091126.xls», де:
 «Doc» - символьний ідентифікатор документа;
 «260023001300» - номер рахунку користувача;
 «UAH» - код валюти рахунку;
 «20001126-20091126» - початкова і кінцева дати періоду виписки в
форматі РРРРММДД.
При формуванні виписок по декількох рахунках, виписка по кожному
рахунку зберігається в окремий файл. У Web-додатку файли виписок за
окремими рахунками зберігаються в zip-архіві. У Windows-додатку архівація не
проводиться.
Файл експорту містить два рядки заголовка і рядки з параметрами
документів. Перший рядок заголовка містить:
1) період, за який сформована виписка;
2) номер рахунку;
3) валюту рахунку.
Другий рядок заголовка містить найменування параметрів документів
(полів).
Рядки з документами містять такі дані:
№ Найменування поля опис Тип даних
пп

1. Дата Дата документа D

№ документа № документа З
2.
Платник Найменування відправника З
3.
Рахунок Номер рахунку відправника З
4.
Код платника Код відправника C
5.
Код банку МФО банку відправника C
6.
Назва банку Найменування банку відправника C
7.
Отримувач Назва отримувача C
8.
Рахунок Номер рахунку отримувача C
9.
Код отримувача Код отримувача C
10.
Код банку МФО банку отримувача C
11.
Назва банку Найменування банку одержувача C
12.
Призначення платежу Призначення платежу C
13.
Дебет Якщо рахунок клієнта дебетується, то N
14.
вказується сума документа. Інакше - 0
Кредит Якщо рахунок клієнта кредитується, то N
15.
вказується сума документа. Інакше - 0
Зразки файлів додаються до комплекту документації (див.
«4.9.Doc_260023001300_UAH_20001126-20091126.xls»).

4.10. Експорт у форматі МТ94x


При експорті даних в форматі МТ94x, якщо користувач вибрав в якості дати
виписки поточний день, то дані зберігаються в файл формату MT942, при виборі
будь-якої іншої дати зберігається виписка формату MT940. Крім того, користувач
вибирає тип кодування - DOS або Win1251 (за замовчуванням).

4.10.1. Експорт у форматі MT940

Один файл експорту виписки в форматі MT940 відповідає одному рахунку


клієнта в гривні або іноземній валюті. Файл виписки містить повідомлення
заданого формату, яке формується з даних за один банківський день. Якщо при
формуванні виписки обраний період, формуються файли для кожного дня
періоду.
Файл експорту виписки в форматі MT940 містить наступні дані:
Рядок Найменування Зміст Дані О/ Приклад
З заповнення
Блок 1. BASIC HEADER BLOCK
1 F01 - ідентифікатор + : 1:
SWIFT-адреса 8x F01ALFAUAUKAXXX
0001000001
A - LT Code 1х
XXX - Branch Code (за 3х
замовчуванням - XXX)
Номер сесії за поточний день 4х
Номер запису для поточної сесії 6х
Блок 2. APPLICATION HEADER BLOCK
2 I - тип повідомлення (I - Вхідне, O - + : 2:
Вихідне) I9401923230216AL
940 - ідентифікатор FAUAUKBXXX00010
Час відправки, ГГХХ 4n 000011602231923N
Дата відправки, РРММДД, 28x
SWIFT-адреса,
BXXX - ідентифікатори,
номер сесії за поточний день, номер
запису для поточної сесії
Дата прийому, РРММДД 6n
Час прийому, ГГХХ 4n
N -Ідентифікатор (пріоритет
доставки повідомлення)
Блок 3. USER HEADER BLOCK
3 108: + : 3: 108:
Дата (РРММДД) 160223IFOBS00001
'IFOBS'
Номер запису за поточну дату
Блок 4. TEXT BLOCK
20 Transaction Дата і номер виписки (РРММДД - 16x + : 20: 160 930 - 273
Reference Number номер дня в році в тризначному
форматі)
Рядок Найменування Зміст Дані О/ Приклад
З заповнення
25 Account ідентифікатор рахунку 35x + : 25:
Identification 26105070001100
28C Statement Number Номер виписки / номер запису 5n / 4n + : 28: 00047/0000
/ Sequence
Number
60 Opening Balance Перший (F) або проміжний (М) + : 60F:
60F = First початковий баланс: C100304UAH10847,
opening balance - D / C- тип операції (дебет / 1! A 53
60M = кредит) 6! N
Intermediate - Дата (РРММДД) 3! A
opening balance - Код валюти 15d
- Сума
61 Statement Line Дата транзакції (РРММДД) 6! N N / A : 61:
Дата проведення транзакції (MMДД) [4! N] 1507060706D46181
,43NTRFNONREF //
- D / C- тип операції (дебет / 2a 10476
кредит)
сума 15d
Код ідентифікатора транзакції, 4c
Transaction Type Identification Code
(TTIC, NTRF - код не визначений)
Номер документа 16х //
16x
86 Information to Деталі рядки виписки: 6 * 65x + : 86: PANGASISENE
Account Owner - опис транзакції (по MAKSE
documenttypeid) /; / NAME /
- ім'я одержувача / платника; TRANSIIDIKESKUSE
- номер рахунку; AS
- номер платежу; / ACC /
- ід. код; EE53170001700165
- опис платежу 2000 / ORD / 40 /
ID / 10189553
ARVED 1501089,
1501090, 1500289
62 Closing Balance Перший або проміжний кінцевий 1! A6! + : 62F:
62F = Final closing баланс (див. Опис рядка 60) N3! A15d C160216UAH10747,
balance 54
62M =
Intermediate
closing balance
64 Closing Available Доступний залишок (див. Опис 1! A6! N / A : 64:
Balance рядка 60) N3! A15d C150708EUR20999
6,48
У таблиці прийняті наступні позначення для формату і довжини даних:
x - будь-яке значення (4х - дані містять 4 знака, 4 * 35х - дані містять 4 рядки по 35 знаків);
n - цифрове значення;
a - літерне значення (лише великими літерами AZ);
c - літерне значення (великі літери AZ і цифри);
d - десяткове значення;
! - фіксована довжина даних (наприклад, 3! А - дані містять завжди три знаки)
[] - опціональне значення
4.10.2. Експорт у форматі MT942

Один файл експорту виписки в форматі MT942 відповідає одному рахунку


клієнта в гривні або іноземній валюті. Файл виписки містить повідомлення
заданого формату, яке формується з даних за один банківський день.
Структура блоків 1 -3 ідентична опису експорту в форматі MT940.
Блок 4 файлу експорту виписки у форматі MT942 містить наступні дані:

рядок Найменування Зміст Дані О/З


послідовність А
20 Transaction Reference Number Дата і номер виписки (номер дня в 16x +
році в тризначному форматі)
25 Account Identification ідентифікатор рахунку 35х +
28C Statement Number / Номер виписки / номер сторінки 5n / 4n +
Sequence Number виписки
34F Ліміт руху по рахунку код валюти 3! A +
Сума встановленого ліміту 18d
(порогового значення)
13D Дата і час виписки Дата, ГГММДД 6! N +
Час, ГГХХ 4! N
послідовність В
61 Statement Line Рядок виписки, див. «» 6! N4! +
N2a18d4с16х
// 16x
86 Information to Account Owner Деталі рядки виписки, див. «» 6 * 65x +

послідовність З
90D Кількість і сума документів Підсумкова кількість документів за 5n +
за дебетом дебетом
код валюти 3! A
сума документів 18d
90С Кількість і сума документів Підсумкова кількість документів по 5n +
по кредиту кредиту
код валюти 3! A
сума документів 18d
У таблиці прийняті наступні позначення для формату і довжини даних:
x - будь-яке значення (4х - дані містять 4 знака, 4 * 35х - дані містять 4 рядки по 35 знаків);
n - цифрове значення;
a - літерне значення (лише великими літерами AZ);
c - літерне значення (великі літери AZ і цифри);
d - десяткове значення;
! - фіксована довжина даних (наприклад, 3! А - дані містять завжди три знака)
[] - опціональне значення

Якщо за рахунком встановлений Ліміт по дебету і / або за кредитом


рахунку, нижче якого документи не потрапляють у виписку, підсумкова сума і
кількість документів в полях 90D і 90C може відрізнятися від кількості
документів, зазначених в послідовності B.
Зразки файлів додаються до комплекту документації (див.
«4.10.МТ940.txt», «4.10.МТ942.txt»).
5. ЕКСПОРТ ВАЛЮТНИХ ДОКУМЕНТІВ

5.1. Експорт в файл даних клієнт-банку (DAT, TXT)


Файл є текстовим. У першому рядку файлу експорту вказується тип операції
документів, який має вигляд OperationID = N, де на місці N можуть підставлятися
наступні значення:
 1 - продаж валюти;
 2 - купівля валюти;
 3 - валютне платіжне доручення;
 4 - конверсія валюти;
 23 - розподіл валюти.
Далі в кожному рядку міститься інформація про один документ. Рядки
завершуються послідовністю CR-LF (ASCII-символи 13 і 10). Кожен рядок має
фіксовану структуру, описану в наступних розділах.

5.1.1. Експорт валютного платіжного доручення

№ Найменування поля Тип даних позиції


пп
1. Номер документа C 1-10
2. Дата документа D 11-16
3. Код валюти документа C 17-19
4. Сума N 20-34
5. Номер валютного рахунку C 35-48
6. Підстава C 49-86
7. Банк-отримувач (BIC) C 87-120
8. Банк-отримувач (Par ID) C 121-154
9. Банк-отримувач (формат) C 155-156
10. Номер рахунку C 157-190
11. Назва та адреса одержувача C 191-336
12. Банк-посередник (BIC) C 337-370
13. Банк-посередник (Par ID) C 371-404
14. Банк-посередник (формат) C 405-406
15. Банк-посередник (найменування та адреса) C 407-552
16. Код типу списання комісії. З 553-557
Вказується, якщо тип комісії - OUR або SHA, в іншому
випадку поле не заповнюється (докладний опис кодів
типів комісій знаходиться в документації
iFOBS_WinClient_Керівництво користувача.doc)
17. Код типу списання комісії. C 558-562
Вказується, якщо тип комісії - SHA або BEN, в іншому
випадку поле не заповнюється (докладний опис кодів
№ Найменування поля Тип даних позиції
пп
типів комісій знаходиться в документації iFOBS_WinClient_
Керівництво користувача.doc)
18. Код країни відправника N 563-566
19. Код країни одержувача N 567-570
20. Код операції 1ПБ C 571-580
21. Призначення платежу C 581-726
22. Додаткова інформація поле 72 C 727-946
23. Назва та адреса платника C 947-1092
24. Додаткові коментарі C 1093-1238
25. Дійсний з ... D 1239-1244
26. рахунок комісії З 1245-1258
27. Банк-отримувач (найменування та адреса) C 1259-1404
28. Валюта рахунку C 1405-1407
29. Код валюти комісії C 1408-1410
30. CRLF C 1411-1412

Зразки файлів додаються до комплекту документації (див.


«5.1.1.Export_FC_payment.dat», «5.1.1.Export_FC_payment.txt»).

5.1.2. Експорт заявок на покупку валюти

№ Найменування поля Тип даних позиції


пп
1. Номер документа C 1-10
2. Сума покупки в копійках N 11-26
3. код валюти З 27-29
4. Дата документа D 30-35
5. Заявка дійсна до ... D 36-41
6. Валютний рахунок C 42-55
7. Номер рахунку в національній валюті C 56-69
8. Номер рахунку комісії C 70-83
9. Тип курсу (0 - ринковий, 1 - фіксований, 2 - за згодою) N 84-85
10. Курс валют N 86-100
11. Відсоток комісії N 101-115
12. Сума комісії N 116-130
13. Максимальна сума комісії N 131-145
14. ПФ номер рахунку C 146-159
15. Код банку для ПФ N 160-165
№ Найменування поля Тип даних позиції
пп
16. Ідентифікаційний код рахунку ПФ C 166-179
17. Найменування ПФ C 180-217
18. Реєстраційний номер C 218-231
19. Примітка до заявки C 232-485
20. Тип списання комісії (0 - утримати з суми на N 486-487
покупку, 1 - списати з нашого рахунку, 2 -
перерахувати на рахунок в нашому банку)
21. Код валюти комісії З 488-490
22. Номер рахунку комісії C 491-504
* Якщо заявка створена за контрактом, то інформацію за даним контрактом буде виділятися
лапками з двох сторін. Тобто в позиції 505 буде знаходитися знак відкривається лапки, потім
перераховані всі поля контракту та знак закривається лапки в позиції 861 (наприклад, "Номер
Мета Дата ...")
Якщо контрактів кілька, то вони будуть перераховані через кому (наприклад, "Номер1 Цель1
Дата1 ...", "номер2 Цель2 Дата2 ...")
23. Номер контракту C 505-555
24. Мета купівлі N 556-565
25. Дата контракту D
566-
571
26. Код підстави покупки C
572-
825
27. Код країни N
826-
835
28. Сума контракту N
836-
850
29. Код виду економічної діяльності К110 N 851-861
23./ CRLF C
505-506 /
30.
* 862-863

Зразки файлів додаються до комплекту документації (див.


«5.1.2.Export_FC_purchase.dat», «5.1.2.Export_FC_purchase.txt»).

5.1.3. Експорт заявок на продаж валюти

№ Найменування поля Тип даних позиції


пп
1. Номер документа C 1-10
2. Сума продажу в копійках N 11-26
3. Код валюти З 27-29
4. Дата документа D 30-35
№ Найменування поля Тип даних позиції
пп
5. Заявка дійсна до ... D 36-41
6. Валютний рахунок C 42-55
7. Код банку N 56-61
8. Найменування контрагента C 62-99
9. Ідентифікаційний код контрагента C 100-113
10. Сума комісії N 114-129
11. Максимальна сума комісії N 130-144
12. Тип курсу N 145-146
(0 - ринковий, 1 - фіксований, 2 - за згодою)
13. Мінімальний курс валют N 147-161
14. Комісія у відсотках N 162-176
15. Номер рахунку C 177-191
16. Тип списання комісії N 192-193
(0 - утримати з суми на купівлю, 1 - списати з нашого
рахунку, 2 - перерахувати на рахунок в нашому банку)
17. Код валюти комісії З 194-196
18. Номер рахунку комісії C 197- 210
19. Номер рахунку комісії банку C
211-224
* Якщо заявка створена за контрактом, то інформацію за даним контрактом буде виділятися
лапками з двох сторін. Тобто в позиції 225 буде знаходитися знак відкривається лапки, потім
перераховані всі поля контракту та знак закривається лапки в позиції 581 (наприклад, "Номер
Мета Дата ...").
Якщо контрактів кілька, то вони будуть перераховані через кому (наприклад, "Номер1 Цель1
Дата1 ...", "номер2 Цель2 Дата2 ...", ...)
20. Номер контракту C 225-275
21. мета покупки N 276-285
22. Дата контракту D 286-291
23. Код підстави покупки C 292-545
24. Код країни N 546-555
25. Сума контракту N 556-570
26. Код виду економічної діяльності К110 N
571-581
20./
CRLF C 225-226 / *
27.
582-583

Зразки файлів додаються до комплекту документації (див.


«5.1.3.Export_FC_sale.dat», «5.1.3.Export_FC_sale.txt»).
5.1.4. Експорт заявок на конверсію валюти

№ Найменування поля Тип даних Позиції


пп
1. Номер документа C 1-10
2. Дата документа D 11-16
3. Код валюти, що продається З 17-19
4. Сума валюти, що продається N 20-34
5. Код валюти, що купується З 35-37
6. Сума валюти, що купується N 38-52
7. Заявка дійсна до ... D 53-58
8. Номер рахунку, на який буде зарахована валюта C 59-72
9. Номер рахунку, з якого буде списана валюта C 73-86
10. Відсоток комісії N 87-96
11. Сума комісії N 97-111
12. Номер банківського рахунку, на який буде C 112-125
зарахована валюта
13. Номер банківського рахунку, на який буде C 126-140
зарахована комісія
14. Номер рахунку, з якого стягуватиметься комісія C 141-154
15. Режим купівлі: N 155-156
0 - купуємо на рахунок;
1 купуємо згідно платіжному дорученню
16. Номер документа, на підставі якого відбувається C 157-166
купівля валюти
17. Дата документа, на підставі якого відбувається D 167-172
покупка валюти
18. Назва підприємства C 173-210
19. Адреса C 211-270
20. Контактна інформація C 271-330
21. Мета C 331-490
22. CRLF C 491-492

Зразки файлів додаються до комплекту документації (див.


«5.1.4.Export_FC_conversion.dat», «5.1.4.Export_FC_conversion.txt»).

5.1.5. Експорт заявок на розподіл валюти

Файл експорту заявок на розподіл валюти в файл даних клієнт-банку


аналогічний файлу імпорту документів з файлу даних клієнт-банку, описаного в
п. «».
5.1.6. Експорт форвардних заявок

№ Найменування поля Тип даних Позиції


пп
1. Тип заявки N 1
2. Номер заявки З 2 - 11
3. Дата створення документа D 12 - 17
4. Дата валютування D 18 - 23
5. Сума продажу N 24 - 37
6. Сума покупки N 38 - 51
7. Код валюти, що купується N 52 - 54
8. Код валюти, що продається N 55 - 57
9. Курс N 58 - 71
10. Сума в еквіваленті N 72 - 85
11. Додаткова інформація З 86 - 224
12. Рахунок комісії N 225 - 238
13. Ознака, при якому рахунок комісії є транзитним: N 239
0 - не є;
1-є
14. Рахунок покриття N 240 - 253
15. Ознака, при якому рахунок покриття є транзитним: N 254
0 - не є;
1-є
16. Додатковий рахунок покриття N 255 - 268
17. Ознака, при якому додатковий рахунок покриття є N 269
транзитним:
0 - не є;
1-є
18. Рахунок повернення покриття N 270 - 283
19. Номер узгодження, умови якого змінюються З 284 - 292
20. Дата узгодження умов змін D 293 - 298
21. Сума додаткової комісії N 299 - 312
22. Сума комісії N 313 - 326
23. Сума першочергового покриття N 327 - 340
24. Відсоток першочергового покриття N 341 - 354
25. Сума першочергового покриття за рахунок ліміту N 355 - 368
26. Сума першочергового покриття за рахунок N 369 - 382
готівкових коштів
27. Контактна особа клієнта З 383 - 411
28. Контактний телефон З 412 - 424
№ Найменування поля Тип даних Позиції
пп
29. Доступна сума ліміту N 425 - 438
30. Загальна сума ліміту N 439 - 452
31. Сума використаного ліміту N 453 - 466
32. Дата останньої синхронізації за лімітами D 467 - 473

Зразки файлів додаються до комплекту документації (див.


«5.1.6.Export_FC_forward.txt»).

5.2. Експорт в розширений файл даних клієнт-банку (EXP)


Файл є текстовим. У першому рядку файлу експорту вказується тип операції
документів, який має вигляд OperationID = N, де на місці N можуть підставлятися
наступні значення:
 1 - продаж валюти;
 2 - купівля валюти;
 3 - валютне платіжне доручення;
 4 - конверсія валюти.
Далі в кожному рядку міститься інформація про один документ. Рядки
завершуються послідовністю CR-LF (ASCII-символи 13 і 10). Кожен рядок має
фіксовану структуру, описану в таблицях.

5.2.1. Експорт валютного платіжного доручення

№ Найменування поля Тип даних позиції


пп
1. Номер документа C 1-10
2. Дата документа D 11-16
3. Код валюти документа C 17-19
4. Сума N 20-34
5. Номер валютного рахунку C 35-48
6. Підстава C 49-98
7. Банк-отримувач (BIC) C 99-132
8. Банк-отримувач (Par ID) C 133-169
9. Банк-отримувач (формат) C 170-170
10. Номер рахунку C 171-208
11. Назва та адреса одержувача C 209-388
12. Банк-посередник (BIC) C 389-422
13. Банк-посередник (Par ID) C 423-459
14. Банк-посередник (формат) C 460-461
15. Банк-посередник (найменування та адреса) C 462-641
16. Код типу списання комісії. З 642-646
Вказується, якщо тип комісії - OUR або SHA, в іншому
випадку поле не заповнюється (докладний опис кодів
типів комісій знаходиться в документації
№ Найменування поля Тип даних позиції
пп
iFOBS_WinClient_Керівництво користувача.doc)
17. Код типу списання комісії. C 647-651
Вказується, якщо тип комісії - SHA або BEN, в іншому
випадку поле не заповнюється (докладний опис кодів
типів комісій знаходиться в документації
iFOBS_WinClient_Керівництво користувача.doc)
18. Код країни відправника N 652-655
19. Код країни одержувача N 656-659
20. Код операції 1ПБ C 660-669
21. Призначення платежу C 670-849
22. Додаткова інформація поле 72 C 850-1099
23. Назва та адреса платника C 1100-1279
24. додаткові коментарі C 1280-1459
25. Дійсний з ... D 1460-1465
26. рахунок комісії З 1466-1479
27. Банк-отримувач (найменування та адреса) C 1480-1659
28. Валюта рахунку C 1660-1662
29. Код валюти комісії C 1663-1665
30. Коментар до платежу C 1666-1825
31. Ознака терміновості платежу7: N тисяча
0 -Термінова; вісімсот
двадцять
1 - нетерміновий (за замовчуванням)
шість
32. CRLF C 1827-1828

Примітка. Строкові значення (позначені символом «С») будуть


перевірятися на відповідність стандартам SWIFT документів. Система забороняє
імпорт файлів, строкові значення яких містять такі символи: §, ", ¶,", {,}.
Зразки файлів додаються до комплекту документації (див.
«5.2.1.Export_FC_payment (EXP) .dat», «5.2.1.Export_FC_payment (EXP) .txt»).

Додаткова функціональність
5.3. Експорт в файл даних клієнт-банку (альтернативний)8
Файл є текстовим. У першому рядку файлу експорту вказується тип операції
документів, який має вигляд OperationID = N, де на місці N можуть підставлятися
наступні значення:
 1 - продаж валюти;
 2 - купівля валюти;
 3 - валютне платіжне доручення;
 4 - конверсія валюти.
Далі в кожному рядку міститься інформація про один документ. Рядки
завершуються послідовністю CR-LF (ASCII-символи 13 і 10). Кожен рядок має
фіксовану структуру, описану в наступному розділі.

5.3.1. Експорт заявок на покупку валюти

Деякі поля не будуть заповнені при експорті. Ці поля позначені прочерком


у таблиці.
№ Найменування поля Тип даних Позиції
пп
1. Номер заявки C 1-10
2. Сума купівлі в копійках N 11-26
3. Код валюти З 27-29
4. Дата D 30-35
5. Заявка дійсна до ... D 36-41
6. Валютний рахунок C 42-55
7. Номер рахунку в національній валюті C 56-69
8. - C 70-83
9. Тип курсу (0 - уповноваженого банку, 1 - максимальний) N 84-85
10. Курс валют N 86-100
11. - N 101-115
12. - N 116-130
13. - N 131-145
14. ПФ номер рахунку C 146-159
15. Код банку для ПФ N 160-165
16. Ідентифікаційний код рахунку ПФ C 166-179
17. Найменування ПФ C 180-217
18. Реєстраційний номер C 218-231
19. - C 232-485

8
№ Найменування поля Тип даних Позиції
пп
20. Тип списання комісії (0 - утримати з суми на покупку, 1 N 486-487
- списати з нашого рахунку, 2 - перерахувати на рахунок
в нашому банку)
21. Код валюти комісії З 488-490
22. - C 491-504
23. Терміновість N 505
24. Номер документа C 506-555
25. Дата документа D 556-561
26. Уповноважена особа C
562-
591
27. Контактний телефон C
592-
604
28. Інше N
605-
854
29. CRLF C
855-
856

Зразки файлів додаються до комплекту документації (див.


«5.3.1.Export_FC_purchase (alt) .dat», «5.3.1.Export_FC_purchase (alt) .txt»).

5.3.2. Експорт заявок на продаж валюти

Файл експорту заявок на продаж валюти в файл даних клієнт-банку


(альтернативний) аналогічний файлу імпорту документів з файлу даних клієнт-
банку (альтернативний), описаного в п. «».

5.3.3. Експорт заявок на конверсію валюти

Файл експорту заявок на конверсію валюти в файл даних клієнт-банку


(альтернативний) аналогічний файлу імпорту документів з файлу даних клієнт-
банку (альтернативний), описаного в п. «».

5.4. Експорт в XML-файл


Експортується XML-файл фіксованої структури.
На початку файлу експорту знаходиться блок «Metadata», в якому міститься
опис типу даних і структури кожного поля. Кожному полю відповідає один тег
<FIELD attrname = ... /> в якому міститься опис форматів полів, де:
№ Найменування Опис Позначення в
формату таблиці з описом
1. string рядок (0-512 символів) З
2. bin.hek рядок (понад 512 символів) З+
3. r8 ціле число N
4. dateTime дата і час формування документа, мають такий D+T
вигляд: РРРРММДДТЧЧ: ММ: ССССС (РРРР -
рік, ММ - місяць, ДД - день, Т - роздільник між
датою і часом, ГГ -, ММ - хвилини, ССССС -
секунди)

Приклад.
<FIELD attrname = "CURRENCYID" fieldtype = "r8" /> - поле «Код валюти»
має значення рядка (EUR, UAH тощо);
<FIELD attrname = "NAMEADDRESS" fieldtype = "string" WIDTH = "146" /> -
поле «Адреса» має значення рядка, максимально допустима довжина якого - 146
символів;
<FIELD attrname = "ADDCOMMENTSEXT" fieldtype = "bin.hex" SUBTYPE =
"Text" WIDTH = "4000" /> - поле «Коментар» має значення рядка, максимальна
довжина якого становить 4000 символів;
<FIELD attrname = "DOCUMENTDATEEXT" fieldtype = "dateTime" /> - поле
«Дата документа», в форматі дата + час;

Далі йде блок «Rowdata» - кореневий вузол XML документа, який містить всі
імпортовані документи. Кожному документу відповідає один тег<ROW ... />.
усередині тега <ROW ... /> вказані значення всіх необхідних атрибутів експортованого
документа. Допустимі імена атрибутів і їх призначення наведено в таблиці нижче.

<? Xml version = "1.0" encoding = "windows-1251"?>


<ROWDATA>
<ROW ... /> - це перший документ в списку
...
<ROW ... /> - це останній документ у списку
</ROWDATA>
Увага! Поля, вміст яких може переноситися на кілька рядків, крім
основного значення, мають розширений варіант (значення з закінченням «EXT»),
в якому комами вказується місце каретки - перенесення на наступний рядок.

5.4.1. Експорт валютного платіжного доручення

№ Найменування атрибута Опис Тип даних


пп
ID Порядковий номер документа в таблиці N
1.
FXACCOUNTID Внутрішній ідентифікатор рахунку платника N
2.
FEEACCOUNTID Внутрішній ідентифікатор номера рахунку N
3.
комісії
BENCOUNTRYID Код країни одержувача N
4.
PAYREASON Підстава C
5.
№ Найменування атрибута Опис Тип даних
пп
ACCWINSTFMT Банк-отримувач (формат) C
6.
ACCWINSTBIC Банк-отримувач (BIC) C
7.
ACCWINSTPARID Банк-отримувач (Par ID) C
8.
ACCWINSTNAMEADD Назва та адреса банку-посередника C
9.
INTERMEDFMT Банк-посередник (формат) C
10.
INTERMEDBIC Банк-посередник (BIC) C
11.
INTERMEDPARID Банк-посередник (Par ID) C
12.
INTERMEDNAMEADD Назва та адреса банку-посередника C
13.
FEETYPE Код типу списання комісії: N
14.
0 - комісійний збір стягується з платника
(OUR),
1 - комісійний збір стягується з одержувача
(BEN),
2 - комісійний збір стягується як з платника,
так і з одержувача платежу (SHA)
DETAILSOFPAYMENT Призначення платежу C
15.
NAMEADDRESS Назва та адреса банку одержувача C
16.
NAMEADDRESSEXT Назва та адреса банку одержувача C+
17.
(перенесення каретки)
INTERMEDNAMEADDEXT Назва та адреса банку-посередника C+
18.
(перенесення каретки)
DETAILSOFPAYMENTEXT Призначення платежу (перенесення C+
19.
каретки)
SENDTORECINFEXT Додаткові інструкції (перенесення каретки) C+
20.
PAYERNAMEADDREXT Назва та адреса банку клієнта-замовника C+
21.
(перенесення каретки)
ADDCOMMENTSEXT Додаткова інформація (перенесення C+
22.
каретки)
ACCWINSTNAMEADDEXT Назва та адреса банку-посередника C+
23.
(перенесення каретки)
URGENTTYPE Терміновість N
24.
ADDCOMMENTS Додаткова інформація C
25.
PAYERNAMEADDR Назва та адреса банку клієнта-замовника C
26.
SENDTORECINF Додаткові інструкції C
27.
№ Найменування атрибута Опис Тип даних
пп
CURROPERATIONCID Код валютної операції C
28.
VALIDFROM Дата і час, починаючи з якого документ D+T
29.
вважається дійсним
VALIDITYDATE Дата і час валідності документа, тобто D+T
30.
моменту, коли документ був підписаний
необхідною кількістю підписів
REJECTCOMMENT Повідомлення про прийом / Код помилки C
31.
(з'являється, якщо при проведенні
документа виникла помилка)
LASTMODIFIEDUSERID Ідентифікатор користувача, який вніс N
32.
останні зміни
STATEID Код стану документа N
33.
RECEIVEDATE Дата і час прийняття документа в банку D+T
34.
CURRENCYID Ідентифікатор валюти документа N
35.
AMOUNT Сума документа C
36.
DOCUMENTNO Номер документа З
37.
DOCUMENTDATE Дата формування документа (ДДММГГГГ) З
38.
DOCUMENTDATEEXT Дата і час формування документа D+T
39.
NEEDSIG3 Необхідний рівень підписання N
40.
SIGCERTID1 Ідентифікатор сертифіката, який N
41.
використовувався для накладення 1 підпис
SIGCERTID2 Ідентифікатор сертифіката, який N
42.
використовувався для накладення 2 підпис
SIGCERTID3 Ідентифікатор сертифіката, який N
43.
використовувався для накладення 3 підпис
SIG1 Ідентифікатор 1 підпису C
44.
SIG2 Ідентифікатор 2 підпису C
45.
SIG3 Ідентифікатор 3 підпису C
46.
SIGEX1 Ідентифікатор 1 підпис «Сайфер» C
47.
SIGEX2 Ідентифікатор 2 підпис «Сайфер» C
48.
SIGEX3 Ідентифікатор 3 підпис «Сайфер» C
49.
USER1ID Логін користувача, що наклав 1 підпис N
50.
USER2ID Логін користувача, що наклав 2 підпис N
51.
№ Найменування атрибута Опис Тип даних
пп
USER3ID Логін користувача, що наклав 3 підпис N
52.
ACCOUNTNO Номер рахунку клієнта-замовника C
53.
DESCR Найменування організації клієнта-замовника C
54.
SYMBOLCODE Код валюти рахунку клієнта-замовника C
55.
FEEACCOUNTNO Номер рахунку платника для списання C
56.
комісії
FEEDESCR Найменування організації рахунку платника C
57.
для списання комісії
FEESYMBOLCODE Символьне позначення типу комісії C
58.
BENACCOUNTNO Номер рахунку отримувача C
59.
STATENAME Повне найменування стану документа C
60.
STATESNAME Скорочене найменування стану документа C
61.
COUNTRYID Код країни N
62.
FXCURRENCYID Ідентифікатор валюти рахунку клієнта- N
63.
замовника
FEECURRENCYID Ідентифікатор валюти комісії N
64.

Зразки файлів додаються до комплекту документації (див.


«5.4.1.Export_FC_payment.xml»).

5.4.2. Експорт заявок на купівлю валюти

№ Найменування атрибута опис Тип даних


пп
ID ID документа N
1.
AMOUNT Сума купівлі в копійках N
2.
ORDERNO Номер документа З
3.
CURRENCYID Код валюти документа N
4.
SYMBOLCODE Код валюти рахунку клієнта-замовника C
5.
RATEFIXED Фіксований курс валют N
6.
MAXRATE Максимальний курс валют N
7.
ORDERDATE Дата формування документа D+T
8.
№ Найменування атрибута опис Тип даних
пп
VALIDTILL Дата і час, до якого заявка є дійсною D+T
9.
FXAMORTYSETYPE Тип списання валюти: N
10.
0 - з нашого рахунку
1 - згідно з платіжним дорученням
FXACCOUNTID Внутрішній ідентифікатор рахунку платника N
11.
FXACCOUNTNO Номер рахунку платника N
12.
FXORDERNO Номер платіжного доручення N
13.
FXORDERDATE Дата платіжного доручення N
14.
FEEACCOUNTID Внутрішній ідентифікатор номера рахунку N
15.
комісії
FEEACCOUNTNO Номер рахунку платника для списання N
16.
комісії
NCACCOUNTNO Номер рахунку в національній валюті N
17.
NCBANKID Код банку рахунку в національній валюті N
18.
NCIDCODE ідентифікаційний код контрагента N
19.
REJECTCOMMENT Повідомлення про прийом / Код помилки C
20.
(з'являється, якщо при проведенні
документа виникла помилка)
FEERATE Відсоток комісії N
21.
PFBANKID Код банку пенсійного фонду N
22.
PFACCOUNTNO Номер рахунку пенсійного фонду N
23.
PFIDENTIFYCODE Ідентифікаційний код пенсійного рахунку C
24.
PFCONTRAGENTSNAME Найменування пенсійного фонду C
25.
PFREGNO Реєстраційний номер C
26.
COMMISSIONSUM Сума комісії N
27.
COMMISSIONMAXSUM Максимальна сума комісії N
28.
FEECURRENCYID Ідентифікатор валюти комісії N
29.
FEECURRENCYSYMBOLCODE Символьний код валюти комісії З
30.
FEETYPE Код типу списання комісії N
31.
FEEBANKACCOUNTNO Номер рахунку, на який буде зарахована C
32.
комісія
№ Найменування атрибута опис Тип даних
пп
NOTE Примітка З
33.
NEEDSIG3 Необхідний рівень підписання N
34.
USER1ID Ідентифікатор користувача, який наклав 1 N
35.
підпис
USER2ID Ідентифікатор користувача, який наклав 2 N
36.
підпис
USER3ID
37. Ідентифікатор користувача, який наклав 3 N
підпис
SIG1 Ідентифікатор 1 підпису C
38.
SIG2 Ідентифікатор 2 підпису C
39.
SIG3 Ідентифікатор 3 підпису C
40.
SIGEX1 Ідентифікатор 1 підпису «Сайфер» C
41.
SIGEX2 Ідентифікатор 2 підпису «Сайфер» C
42.
SIGEX3 Ідентифікатор 3 підпису «Сайфер» C
43.
SIGCERTID1 Ідентифікатор сертифіката, який N
44.
використовувався для накладення 1 підпису
SIGCERTID2 Ідентифікатор сертифіката, який N
45.
використовувався для накладення 2 підпису
SIGCERTID3 Ідентифікатор сертифіката, який N
46.
використовувався для накладення 3 підпису
RECEIVEDATE Дата і час прийняття документа в банку D+T
47.
VALIDITYDATE Дата і час валідності документа, тобто D+T
48.
моменту, коли документ був підписаний
необхідною кількістю підписів
LASTMODIFIEDUSERID Ідентифікатор користувача, який вніс N
49.
останні зміни
STATEID Код стану документа N
50.
VERSION Версія документа N
51.
STATESNAME Скорочене найменування стану документа. C
52.
Значення використовується для друкованої
версії звіту по документу
STATENAME Повне найменування стану документа. C
53.
Значення використовується для друкованої
версії звіту по документу
NCBANKNAME Найменування банку рахунки в національній C
54.
валюті.
Значення використовується для друкованої
версії звіту по документу
№ Найменування атрибута опис Тип даних
пп
BANKNAME Найменування філії банку рахунки в C
55.
національній валюті.
Значення використовується для друкованої
версії звіту по документу
SUMMASCRIPT Сума прописом. C
56.
Значення використовується для друкованої
версії звіту по документу
CURRENCYNAME Скорочене найменування валюти. C
57.
Значення використовується для друкованої
версії звіту по документу
BANKMFO МФО філії банку. N
58.
Значення використовується для друкованої
версії звіту по документу
FULLBUYERURNAME Повне найменування контрагента. C
59.
Значення використовується для друкованої
версії звіту по документу
ADDRESS Адреса контрагента. C
60.
Значення використовується для друкованої
версії звіту по документу
PHONES Телефон контрагента. C
61.
Значення використовується для друкованої
версії звіту по документу
FAX Факс контрагента. C
62.
Значення використовується для друкованої
версії звіту по документу
PFBANKNAME Найменування банку пенсійного фонду. C
63.
Значення використовується для друкованої
версії звіту по документу
PAYERREGNO Ідентифікаційний код контрагента. N
64.
Значення використовується для друкованої
версії звіту по документу
AMOUNTEQ Еквівалент суми документа у валюті. C
65.
Значення використовується для друкованої
версії звіту по документу
TRANSBANKACCOUNTNO Номер транзитного рахунку, на який буде N
66.
зарахована сума купівлі і комісії
(Вказується, якщо «Код типу списання
комісії» = 0 або 2, утримати з суми на
купівлю / перерахувати на рахунок в банку)
TRANSPFBANKACCOUNTNO Номер транзитного рахунку для зарахування N
67.
суми обов'язкового збору до ПФ
(Вказується, якщо «Код типу списання
комісії» = 0 або 2, утримати з суми на
купівлю / перерахувати на рахунок в банку)
OPER Операціоніст, який прийняв документ C
68.
RECDATE Дата прийняття документа в Б2 C
69.
№ Найменування атрибута опис Тип даних
пп
MANAGER1PHONE Повне ім'я 1 ї особи C
70.
MANAGER1NAME Телефон 1 ї особи C
71.
USERLOGIN1 Логін користувача, який підписав документ C
72.
першим підписом
USERLOGIN2 Логін користувача, який підписав документ C
73.
другим підписом
FEESYMBOLCODE Код валюти комісії C
74.
PASSPORTTYPE Тип ідентифікаційного документа C
75.
контрагента
FOUNDATION Підстава купівлі C
76.
* Якщо заявка створена за контрактом, його дані будуть перераховані в наступному тезі
CONTRACT, в цьому ж рядку; якщо їх декілька, - перераховані через кому.
CONTRACTNO Номер контракту N
77.
BUYINGPURPOSE Мета купівлі N
78.
BUYINGPURPOSEDESC Опис мети купівлі З
79.
CONTRACTDATE Дата контракту D
80.
FOUNDATION Підстава купівлі C
81.
COUNTRYID Код країни N
82.
AMOUNT Сума контракту N
83.
BUSINESSTYPEID Код виду економічної діяльності К110 N
84.

Зразки файлів додаються до комплекту документації (див.


«5.4.2.Export_FC_purchase.xml»).

5.4.3. Експорт заявок на продаж валюти

№ Найменування атрибута Опис Тип даних


пп
ID ID документа N
1.
AMOUNT Сума продажу в копійках C
2.
ORDERNO Номер документа C
3.

ORDERDATE D+T
4. Дата і час формування документа
CURRENCYID Код валюти N
5.
№ Найменування атрибута Опис Тип даних
пп
RATEFIXED Фіксований курс валют N
6.
MINRATE Мінімальний курс валют N
7.
VALIDTILL Дата і час, до якого заявка є дійсною D+T
8.
FXACCOUNTID Внутрішній ідентифікатор рахунку платника N
9.
CONTRAGENTSNAME Найменування контрагента C
10.
CONTRAGENTIDENTIFYCODE Ідентифікаційний номер контрагента C
11.
REJECTCOMMENT Повідомлення про прийом / Код помилки C
12.
(з'являється, якщо при проведенні
документа виникла помилка)
FEERATE Відсоток комісії N
13.
COMMISSIONSUM Сума комісії N
14.
COMMISSIONMAXSUM Максимальна сума комісії N
15.
FEECURRENCYID Код валюти комісії N
16.
FEETYPE Тип списання комісії: N
17.
0 - утримати з суми на покупку,
1 - списати з нашого рахунку,
2 - перерахувати на рахунок в нашому
банку
FEEBANKACCOUNTNO Номер рахунку комісії З
18.
FEEACCOUNTID Код рахунку комісії N
19.
NEEDSIG3 N
20. Необхідний рівень підписання
USER1ID Логін користувача, що наклав 1 підпис N
21.
USER2ID N
22. Логін користувача, що наклав 2 підпис
USER3ID Логін користувача, що наклав 3 підпис N
23.
SIG1 Ідентифікатор 1 підпису C
24.
SIG2 Ідентифікатор 2 підпису C
25.
SIG3 Ідентифікатор 3 підпису C
26.
SIGEX1 Ідентифікатор 1 підпису «Сайфер» C
27.
SIGEX2 Ідентифікатор 2 підпису «Сайфер» C
28.
№ Найменування атрибута Опис Тип даних
пп
SIGEX3 Ідентифікатор 3 підпису «Сайфер» C
29.
SIGCERTID1 Ідентифікатор сертифіката, який N
30.
використовувався для накладення 1 підпису
SIGCERTID2 Ідентифікатор сертифіката, який N
31.
використовувався для накладення 2 підпису
SIGCERTID3 Ідентифікатор сертифіката, який N
32.
використовувався для накладення 3 підпису
STATEID Код стану документа N
33.
RECEIVEDATE D+T
34. Дата і час прийняття документа в банку
VALIDITYDATE D+T
35. Дата і час валідності документа, тобто
моменту, коли документ був підписаний
необхідною кількістю підписів
LASTMODIFIEDUSERID Ідентифікатор користувача, який вніс N
36.
останні зміни
UAHACCOUNTNO Номер рахунку в національній валюті C
37.
UAHBANKID Код банку рахунку в національній валюті N
38.
STATENAME Повне найменування стану документа C
39.
STATESNAME C
40. Скорочене найменування стану документа
ACCOUNTNO Номер рахунку клієнта-замовника C
41.
FEEACCOUNTNO Номер рахунку платника для списання C
42.
комісії

Зразки файлів додаються до комплекту документації (див.


«5.4.3.Export_FC_sale.xml»).

5.4.4. Експорт заявок на конверсію валюти

№ Найменування атрибута Опис Тип даних


пп
ID ID документа N
1.
DOCUMENTNO Номер документа C
2.
DOCUMENTDATE Дата формування документа (ДДММРРРР) C
3.
DOCUMENTDATETXT Дата формування документа (перенесення D+T
4.
каретки)
SELLACCOUNTID Внутрішній ідентифікатор рахунку, з якого N
5.
буде списана валюта
SELLSYMBOLCODE Код валюти, що продається C
6.
№ Найменування атрибута Опис Тип даних
пп
BUYSYMBOLCODE Код валюти, що купується C
7.
STATENAME Повне найменування стану документа C
8.
STATESNAME Скорочене найменування стану документа C
9.
BUYCURRENCYID Ідентифікатор валюти, що купується N
10.
SELLCURRENCYID Ідентифікатор валюти, що продається N
11.
BUYAMOUNT Сума валюти, що купується N
12.
SELLAMOUNT Сума валюти, що продається N
13.
PURPOSE Мета конверсії валюти C
14.
VALIDTILL Дата і час, до якого заявка є дійсною D+T
15.
BUYACCOUNTID Внутрішній ідентифікатор рахунку, на який N
16.
буде зарахована валюта
FEEPERCENT Відсоток комісії N
17.
FEEAMOUNT Сума комісії N
18.
COMPANYSNAME Найменування організації C
19.
ADDRESS Адреса організації C
20.
FXDOCNO Номер документа, на підставі якого C
21.
відбувається купівля валюти
FXDOCDATE Дата і час документа, на підставі якого D+T
22.
відбувається купівля валюти
BUYTYPE Ідентифікатор типу купівлі: N
23.
0 - купуємо на наш рахунок;
1 - купуємо згідно з платіжним дорученням
SELLBANKACCOUNTNO Номер рахунку, на який надійде валюта, C
24.
FEEACCOUNTID Внутрішній код рахунку, з якого стягується N
25.
комісія
FEEBANKACCOUNTNO Номер рахунку, на який буде зарахована C
26.
комісія
REJECTCOMMENT Повідомлення про прийом / Причина C
27.
відмови прийому документа (з'являється,
якщо при проведенні документа виникла
помилка)
NEEDSIG3 Необхідний рівень підписання N
28.
USER1ID Логін користувача, що наклав 1 підпис N
29.
№ Найменування атрибута Опис Тип даних
пп
USER2ID Логін користувача, що наклав 2 підпис N
30.
USER3ID Логін користувача, що наклав 3 підпис N
31.
SIG1 Ідентифікатор 1 підпис C
32.
SIG2 Ідентифікатор 2 підпис C
33.
SIG3 Ідентифікатор 3 підпис C
34.
SIGEX1 Ідентифікатор 1 підпис «Сайфер» C
35.
SIGEX2 Ідентифікатор 2 підпис «Сайфер» C
36.
SIGEX3 Ідентифікатор 3 підпис «Сайфер» C
37.
SIGCERTID1 Ідентифікатор сертифіката, який N
38.
використовувався для накладення 1 підпису
SIGCERTID2 Ідентифікатор сертифіката, який N
39.
використовувався для накладення 2 підпису
SIGCERTID3 Ідентифікатор сертифіката, який N
40.
використовувався для накладення 3 підпису
STATEID Код стану заявки N
41.
RECEIVEDATE Дата і час прийняття документа в банку D+T
42.
VALIDITYDATE Дата і час валідності документа, тобто D+T
43.
моменту, коли документ став готовим до
відправлення в АБС банку
LASTMODIFIEDUSERID Ідентифікатор користувача, вносившего N
44.
останні зміни
FEECURRENCYID Ідентифікатор валюти комісії N
45.
CONTACTINFO Контактна інформація C
46.
BUYACCOUNTNO Номер рахунку купівлі C
47.
SELLACCOUNTNO Номер рахунку продажу C
48.
FEEACCOUNTNO Номер рахунку комісії C
49.

Зразки файлів додаються до комплекту документації (див.


«5.4.4.Export_FC_conversion.xml»).
6. ІМПОРТ ДАНИХ ПРО КОРЕСПОНДЕНТІВ ДОКУМЕНТІВ У
НАЦІОНАЛЬНІЙ ВАЛЮТІ З XML-ФАЙЛУ
Файл імпорту містить інформацію про кореспондентів користувача для
заповнення довідника кореспондентів гривневих документів у Windows-клієнті.
Ці записи імпортуються з XML-файлу фіксованої структури у форматі ANSI.
Формат файлу наступний:
<ROWDATA>
<ROW ACCOUNTNO = "26251000222" IDENTIFYCODE = "56789230" NAME =
"ПП Бондар" BANKID = "351715" />
<ROW ACCOUNTNO = "12789456236" IDENTIFYCODE = "1234567890"
NAME = "ФОП Куликов" BANKID = "триста п'ятьдесят одна тисяча п'ятсот
вісімдесят вісім" COUNTRYID = "642" />
</ ROWDATA>
Файл містить наступні дані про кореспондента:
№ Найменування Опис Тип О/З Довжина
пп атрибута даних поля

1. ACCOUNTNO Номер рахунку З + 14

2. BANKID МФО банку N + 6

3. IDENTIFYCODE Ідентифікаційний код З + 14

4. NAME Найменування З + 38

5. COUNTRYID Код країни N -

Зразки файлів додаються до комплекту документації (див. «6.Import of


correspondents.xml»).
7. ЕКСПОРТ ЗАЛИШКІВ НА РАХУНКАХ
Дані про залишки на рахунках вивантажуються в windows-додатку системи
iFOBS при виконанні операції «Збереження виписки в файл» і встановленому
прапорці «завантажувати залишки на рахунках » (Докладніше див.
«IFOBS_WinClient_Керівництво користувача.doc»).

7.1. Експорт залишків на рахунках в текстовий і BOL-файл


При експорті інформація про залишки на рахунках зберігається у файли із
зазначенням дати запиту в назві. Якщо був заданий період для формування
виписки, тоді в результаті сформується стільки файлів, скільки днів в
зазначеному періоді. Дата вказується у форматі РРММДД. Наприклад, якщо в
запиті було вказано число 11.05.2006, назва файлу буде мати вигляд 060511.
Якщо ж у запиті було вказано період, якому відповідає 3 дні: 1.07.2006,
2.07.2006, 3.07.2006, тоді буде сформовано 3 файлу з назвами: 060701, 060702,
060703.
Експортований файл буде містити дані в кодуванні, яка була обрана при
збереженні виписки в файл.
Увага!Експорт залишків на рахунках виконується в файли з розширенням
.dat, незалежно від того, який формат (текстовий або BOL) був обраний для
експорту. Текстовий та BOL формати є аналогічними.
Опис
Файл є текстовим. Кожен рядок містить інформацію про один документ.
Рядки завершуються послідовністю CR-LF (ASCII-символи 13 і 10). Кожен рядок
має фіксовану структуру, описану в таблиці нижче.
№ Найменування атрибута опис Тип даних позиції
пп
Номер рахунку Номер рахунку C 1-14
1.
Код валюти Цифровий код валюти рахунку N 15-17
2.
Поточний залишок Сума поточного залишку «в N 18-33
3. копійках» в валюті рахунку
Залишок на початок Сума залишку на початок дня N 34-49
4. дня «в копійках» в валюті рахунку
Поточний залишок Сума поточного залишку в N 50-65
5. (еквівалент) копійках в гривневому
еквіваленті
Залишок на початок Сума залишку на початок дня в N 66-81
6. дня (еквівалент) копійках в гривневому
еквіваленті
CRLF CRLF, перехід на наступний C 82-83
7. рядок для введення інформації
по документу

Зразки файлів додаються до комплекту документації (див.


«7.1.100512.dat»).
7.2. Експорт залишків на рахунках в DBF-файл
При експорті інформація про залишки на рахунках зберігається в файли із
зазначенням дати запиту в назві. Якщо був заданий період для формування
виписки, тоді в результаті сформується стільки файлів, скільки днів в
зазначеному періоді. Дата вказується у форматі РРММДД. Наприклад, якщо в
запиті було вказано число 11.05.2006, назва файлу буде мати вигляд 060511.
Якщо ж у запиті було вказано період, якому відповідає 3 дні: 1.07.2006,
2.07.2006, 3.07.2006, тоді буде сформовано 3 файлу з назвами: 060701, 060702,
060703.
Експортований файл буде містити дані в кодуванні, яка була обрана при
збереженні виписки в файл.
№ Найменування атрибута Опис Тип даних Макс.
пп довжина
поля
ACCNO Номер рахунку C 14
1.
CURRID Цифровий код валюти рахунку N 3
2.
SUMNOWEQ Сума поточного залишку в N 20
3. гривневому еквіваленті
SUMBEGEQ Сума залишку на початок дня в N 20
4. гривневому еквіваленті
SUMNOW Сума поточного залишку в N 20
5. валюті рахунку
SUMBEG Сума залишку на початок дня в N 20
6. валюті рахунку

Зразки файлів додаються до комплекту документації (див.


«7.2.100512.dbf»).

7.3. Експорт залишків на рахунках в XLS-файл


У назві файлу за замовчуванням буде вказана дата запиту або дати
періоду, за який був поданий запит на формування виписки. Дата вказується у
форматі РРРРММДД.
№ Найменування поля опис
пп
Дата Дата, за яку відображаються залишки на рахунках
1.
Рахунок Номер рахунку
2.
Валюта Літерний код валюти рахунку
3.
Вхід. залишок Сума залишку на початок дня в валюті рахунку
4.
Вихід. залишок Сума поточного залишку в валюті рахунку
5.
Вхід. ост. екв. Сума залишку на початок дня в гривневому еквіваленті
6.
№ Найменування поля опис
пп
Вихід. ост. екв. Сума поточного залишку в гривневому еквіваленті
7.

Зразки файлів додаються до комплекту документації (див.


«7.3.Acc_20100401-20100512.xls»).

7.4. Експорт залишків на рахунках в XML-файл


У назві файлу за замовчуванням буде вказана дата запиту або дати
періоду, за який був поданий запит на формування виписки. Дата вказується у
форматі РРРРММДД.
Опис
Формат XML-файла експорту наступний:

<? Xml version = "1.0" encoding = "windows-1251"?>


<ROWDATA>
<ROW... /> - це перший документ в списку
...
<ROW... /> - це останній документ у списку
</ROWDATA>

ROWDATA - кореневий вузол XML документа, який містить всі експортовані записи
про залишки на рахунках. Кожного запису відповідає один тег<ROW ARCDATE ... />.
усередині тега <ROW ARCDATE ... /> містяться реквізити експортованих записів. Опис
атрибутів та їх призначення наведено в таблиці нижче.
№ Найменування атрибута Опис Тип даних
пп
ARCDATE Дата, за яку відображаються залишки на D
1. рахунках
ACCOUNTID Внутрішній ідентифікатор рахунку N
2.
ACCOUNTNO Номер рахунку N
3.
CURRENCYID Код валюти рахунку (цифровий код валюти N
4. згідно ISO стандарту)
CURRSYMBOLCODE Код валюти рахунку (трилітерний код валюти C
5. згідно ISO стандарту)
DATELASTMOVE Дата останнього руху за рахунком D
6.
BANKID Код банку (МФО) N
7.
CONTRAGENTSNAME Найменування контрагента C
8.
BANKNAME Назва банку C
9.
№ Найменування атрибута Опис Тип даних
пп
CURRATE Курс валют N
10.
CURBASE Кількість одиниць базової валюти N
11.
DATAVERSION Версія записи в БД iFOBS C
12.
CONTRAGENTIDENTIFYCOD Ідентифікаційний номер контрагента C
13. E
CURRENTBANKDAY Дата ОДБ D
14.
CREDIT_V Сума по кредиту рахунку у валюті рахунку N
15. на початок дня
DEBET_V Сума за дебетом рахунка у валюті рахунку на N
16. початок дня
CREDIT_R Сума переоцінки за кредитом рахунка N
17.
DEBET_R Сума переоцінки за дебетом рахунка N
18.
EQCREDIT Поточна сума по кредиту рахунку в N
19. гривневому еквіваленті
EQDEBET Поточна сума за дебетом рахунка в N
20. гривневому еквіваленті
EQSUMMABEGIN Сума залишку на початок дня «в копійках» в N
21. валюті рахунку
EQSUMMANOW Сума поточного залишку «в копійках» в N
22. валюті рахунку
SUMMANOW Сума поточного залишку в копійках в N
23. гривневому еквіваленті
CREDIT Поточна сума по кредиту рахунку N
24.
DEBET Поточна сума за дебетом рахунка N
25.
SUMMABEGIN Сума залишку на початок дня в копійках в N
26. гривневому еквіваленті

Зразки файлів додаються до комплекту документації (див.


«7.4.Acc_20100501-20100512.xml»).

You might also like