Professional Documents
Culture Documents
Import Export Format
Import Export Format
Import Export Format
iFOBS
Формат файлу імпорту / експорту
Інструкція користувача
Опис форматів файлів імпорту та експорту
ЗМІСТ
1.ВСТУП ............................................................................ 5
1.1. Таблиця форматів ........................................................ 5
ВАЛЮТНИХ ДОКУМЕНТІВ..................................................... 5
ВАЛЮТНИХ ДОКУМЕНТІВ..................................................... 5
1.2. Розшифровка типу даних ............................................. 6
1
1C 2.7 4.7
МТ94x 4.10
- Windows-додаток;
- Web-додаток.
- - 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. 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.
Додаткова функціональність
№ Найменування атрибута Опис Особливості формату
пп
CORRIDENTIFYCODE Ідентифікаційний код
7.
отримувача платежу -
(ЄДРПОУ)
CORRCOUNTRYID Код країни кореспондента При відсутності автоматично
8.
вибирається Україна (804)
DOCUMENTNO № документа Якщо номер не вказано, буде
9.
використовуватися
автонумерация
VALUEDATE дата валютування -
10.
PRIORITY пріоритет За замовчуванням 50
11.
DOCUMENTDATE Дата документа РРРРММДД
12.
ADDENTRIES Додаткові реквізити
13. -
платежу
PURPOSEPAYMENTID Код призначення платежу Ціле 3-значне число
14.
BANKID Код банку платника (МФО) -
15.
1. Дата документа D 6
2. Номер документа N 10
3. Сумма N 14
Сума платежу
4. МФО N 9
МФО банку платника
5. Счет N 14
рахунок платника
7. Счет корреспондента N 14
Корреспондент C 38
10.
Назва отримувача
Дата валютирования D 6
11.
Приоритет N 3
12.
Доп. реквизиты C 60
14.
Додаткові реквізити документа
Код НП N 3
15.
Код призначення платежу
МФО по кpедиту N 6, 9
6.
Код платежа N 0, 3
15.
Приклад:
файл 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
0 - вхідний документ
Вид платежного документа. N 1, 4
2.
Для валютних документів: 55, 56, 60, 70, 2211,
2221
Номер платежного документа З 1,10
3.
Код платежа N 0, 3
15.
- - 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.
Додаткова функціональність
вказується у форматі РРРРММДД. Наприклад, поданим запитом відповідає 3
документа: перший проведено 16.05.2013, другий 18.05.2013, третій
23.05.2013. Файл буде мати вигляд «20130516_20130523».
Експортований файл буде містити дані в кодуванні, яка була обрана при
збереженні виписки в файл.
№ Найменування опис Тип даних Макс.
пп поля довжина
поля
Додаткова функціональність
4.3. Експорт електронної виписки в DBF-файл
(альтернативний)
Дата проводки Поле містить дату, коли документ був проведений у банку, в
8.
форматі дд.мм.рррр (день.місяць.рік)
Номер документа Поле містить номер документа відповідно до його номеру в системі
9.
Время проводки Поле містить час проведення документа в банку в форматі гг: мм
12.
(години: хвилини)
Дата документа Поле містить дату документа в форматі дд.мм.рррр
13.
(день.місяць.рік)
Дата архивирования Поле містить дату архівування документа в банку в форматі
14.
дд.мм.рррр (день.місяць.рік)
Ид.код Поле містить інформацію про ідентифікаційний код користувача
15.
№ документа № документа З
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»).
послідовність З
90D Кількість і сума документів Підсумкова кількість документів за 5n +
за дебетом дебетом
код валюти 3! A
сума документів 18d
90С Кількість і сума документів Підсумкова кількість документів по 5n +
по кредиту кредиту
код валюти 3! A
сума документів 18d
У таблиці прийняті наступні позначення для формату і довжини даних:
x - будь-яке значення (4х - дані містять 4 знака, 4 * 35х - дані містять 4 рядки по 35 знаків);
n - цифрове значення;
a - літерне значення (лише великими літерами AZ);
c - літерне значення (великі літери AZ і цифри);
d - десяткове значення;
! - фіксована довжина даних (наприклад, 3! А - дані містять завжди три знака)
[] - опціональне значення
Додаткова функціональність
5.3. Експорт в файл даних клієнт-банку (альтернативний)8
Файл є текстовим. У першому рядку файлу експорту вказується тип операції
документів, який має вигляд OperationID = N, де на місці N можуть підставлятися
наступні значення:
1 - продаж валюти;
2 - купівля валюти;
3 - валютне платіжне доручення;
4 - конверсія валюти.
Далі в кожному рядку міститься інформація про один документ. Рядки
завершуються послідовністю CR-LF (ASCII-символи 13 і 10). Кожен рядок має
фіксовану структуру, описану в наступному розділі.
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
Приклад.
<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 ... /> вказані значення всіх необхідних атрибутів експортованого
документа. Допустимі імена атрибутів і їх призначення наведено в таблиці нижче.
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.
комісії
4. NAME Найменування З + 38
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. гривневому еквіваленті