Формат ІБІС: як влаштований файл імпорту платежів
ІБІС — текстовий формат обміну платіжними документами, який досі приймають клієнт-банки на платформі iBank 2 UA і старіші банківські системи. Формат компактний, але з трьома підступами: незвичним роздільником полів, DOS-кодуванням і сумою в копійках. Розбираємо по деталях, щоб файл пройшов імпорт з першого разу.
Потрібен готовий файл, а не спека? ScanPay генерує коректний ІБІС-файл із фото чи PDF квитанцій — з роздільниками, кодуванням і копійками вже як треба.
Згенерувати файлТри речі, через які ІБІС-файли не проходять імпорт
- Роздільник полів — не крапка. Поля в рядку розділяються символом «·» з кодом ASCII 250. Візуально він схожий на крапку посередині рядка, і якщо замінити його звичайною крапкою (ASCII 46) — файл не розбереться.
- Кодування — DOS-івське. Файл має бути в
CP-1125(українська версія DOS-кодування) абоOEM-866. Збережений в UTF-8 файл банк не прочитає — імена одержувачів перетворяться на нечитабельні символи. - Сума — в копійках. 1 234,56 грн у файлі — це
123456. Передасте «1234.56» — імпорт або відхилить документ, або створить платіжку на іншу суму.
Імʼя файлу
ІБІС-файл традиційно називається за шаблоном r{ДД}{ГГХХ}{N.NNN}: літера «r», день місяця, час і будь-які чотири цифри. Наприклад, файл, створений 14-го числа о 03:07 — r1403071.111.
Структура рядка
Один рядок = один документ. Поля йдуть за фіксованими позиціями (нумерація з нуля). Ключові позиції для гривневої платіжної інструкції:
| № | Поле | Вимоги |
|---|---|---|
| 0 | Сервісне | Завжди 0 |
| 1 | Тип документа | 1 — платіжна інструкція |
| 2 | Номер документа | До 35 символів |
| 3 | Дата документа | РРРРММДД, напр. 20260817 |
| 4–5 | МФО платника / одержувача | 6 цифр; ігноруються, якщо задані IBAN |
| 6 | IBAN платника | 29 символів |
| 7 | IBAN одержувача | Строго 29 символів, валідний за MOD-97 |
| 8 | Сума | У копійках, до 18 цифр |
| 9 | Символ касової | 0 |
| 10 | Найменування одержувача | Текст у CP-1125 |
| 11 | Призначення платежу | 3–420 символів |
| 12 | Дата валютування | РРРРММДД, необовʼязкова |
| 16 | ЄДРПОУ одержувача | 8–10 цифр |
| 18 | Пріоритет | 1 або 2 |
| 47–52 | Бюджетні поля | BP_TAXCODE, BP_ADD_INFO, BP_ACCOUNT та ін. — для платежів у бюджет (МФО 899998) |
Чек-лист перед імпортом
- Роздільник — ASCII 250, не крапка і не крапка з комою.
- Кодування — CP-1125 або 866 (перевірте, що українські літери читаються у DOS-переглядачі, а не в блокноті).
- Суми — в копійках, без роздільників.
- Дати —
РРРРММДДбез крапок. - IBAN одержувача — 29 символів, контрольні цифри валідні.
- Кінець рядка — CR-LF.
Часті питання
Чим ІБІС відрізняється від формату iBank 2?
Обидва приймаються системами iBank 2 UA. iBank 2 — сучасніший формат «ПОЛЕ=значення» в UTF-8/Win-1251, його простіше створювати і читати. ІБІС — позиційний DOS-формат, потрібний переважно для сумісності зі старими обліковими системами. Якщо ваш банк приймає обидва — беріть iBank 2.
Як побачити символ ASCII 250 у редакторі?
У більшості редакторів він виглядає як «·» (середня крапка). Головне — не «виправляти» його на звичайну крапку і не давати редактору перекодувати файл в UTF-8 при збереженні.
Чи створює імпорт платежі автоматично?
Імпорт створює чернетки платіжних доручень у кабінеті. Ви їх переглядаєте і підписуєте ключем — без підпису нічого нікуди не йде.
ІБІС-файл без ручної збірки
Завантажте квитанції — ScanPay розпізнає реквізити, перевірить їх за держреєстрами і збере файл ІБІС з правильним роздільником, кодуванням і копійками.
Спробувати безкоштовно