У якому кодуванні має бути DBF-файл із платіжками?

Текстові поля — у Windows-1251 (тоді у службовому полі CODE пишеться Win) або в CP-1125. UTF-8 класичні банківські системи в DBF не розуміють.

Як записується сума у DBF-файлі платіжки?

У колонці SUMMA сума вказується в копійках цілим числом: 1 234,56 грн — це 123456. Крапки і коми не використовуються.

DBF-файл із платіжками: структура полів і кодування

DBF — табличний формат родом із dBase/FoxPro, який бухгалтерські програми і клієнт-банки використовують для обміну платіжними дорученнями десятиліттями. Тут — структура DBF-файлу платіжок, сумісного з системами iBank 2 UA: назви колонок, типи, кодування і місця, де найчастіше ламається імпорт.

Не хочеться розбиратися в колонках? ScanPay збере валідний DBF із фото чи PDF квитанцій — з правильним кодуванням і сумами в копійках.

Зібрати DBF

Структура таблиці

Один запис (рядок) таблиці = одне платіжне доручення. Колонки для гривневої платіжної інструкції:

Колонка	Тип	Що містить
`CODE`	C(5)	Службове поле кодування: `Win` — якщо текст у Windows-1251
`ACCCLI`	C(29)	IBAN платника (ваш рахунок)
`ACCCOR`	C(29)	IBAN одержувача — 29 символів, валідний за MOD-97
`MFOCOR`	C(10)	МФО одержувача (ігнорується — банк визначається з IBAN)
`OKPOCOR`	C(10)	ЄДРПОУ/ІПН одержувача, 8–10 цифр
`NAMECOR`	C(140)	Найменування одержувача
`NDOC`	C(35)	Номер документа
`SUMMA`	N(18)	Сума в копійках
`NAZN`	C(253)	Перші 253 символи призначення платежу
`NAZN2`	C(167)	Продовження призначення (символи 254–420)
`DATEV`	D(8)	Дата документа
`DV`	D(8)	Дата валютування (необовʼязкова)
`BP_ADDINFO`, `BP_TAXCODE`, `BP_ACCOUNT`, `BP_TAXMSG`, `BP_IN_CODE`, `ADDINFO`	C	Бюджетні поля — тільки для платежів у бюджет (МФО одержувача 899998)

На чому найчастіше ламається DBF-імпорт

Сума в гривнях замість копійок. У колонці SUMMA сума 1 234,56 грн — це число 123456. Жодних крапок і ком.
Кодування тексту. Текстові поля — у Windows-1251 (тоді у CODE пишеться Win) або в CP-1125. UTF-8 у DBF класичні системи не розуміють.
Довге призначення не розбите на два поля. Призначення до 420 символів ділиться: перші 253 — у NAZN, решта — у NAZN2. Якщо запхати все в NAZN, хвіст обріжеться.
IBAN з помилкою. ACCCOR має бути рівно 29 символів з коректними контрольними цифрами — швидка перевірка тут.
Застарілий підтип DBF. Якщо ваша програма пише dBase IV+ з мемо-полями, а банк чекає простий dBase III — імпорт не побачить записів. Експортуйте в найпростіший варіант без мемо-файлів.

Різні банки — різні DBF. Описана структура відповідає специфікації iBank 2 UA (Райффайзен, Укрсиббанк, ОТП, ПУМБ та інші банки цієї платформи). Системи інших розробників (iFOBS, iTiny, Приват24 для бізнесу) використовують власні набори колонок — звіряйтеся з документацією свого банку.

Часті питання

Чим відкрити або перевірити DBF-файл?

Швидко глянути вміст можна у LibreOffice Calc (він питає кодування при відкритті — виберіть «Кирилиця Windows-1251»). Але зберігати з нього обережно: офісні пакети люблять змінювати підтип DBF і кодування.

DBF чи текстовий iBank 2 — що обрати?

Якщо файл споживає лише клієнт-банк — текстовий iBank 2 простіший і прозоріший: його можна відкрити блокнотом і перевірити очима. DBF доречний, коли той самий файл читає ще й бухгалтерська програма, яка розуміє тільки його.

Чи виконуються платежі одразу після імпорту DBF?

Ні — імпорт створює чернетки платіжних доручень. Ви переглядаєте їх у кабінеті і підписуєте ключем; без підпису гроші нікуди не рухаються.

Готовий DBF із стосу квитанцій

Розпізнавання реквізитів, перевірка IBAN і ЄДРПОУ за держреєстрами, коректні копійки і кодування — автоматично.

Спробувати безкоштовно