24
РАБОТА С ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA. Оглавление: 1. Введение 2 Объекты и форматы обмена данными 2 Краткое описание форматов обмена данными 2 Краткое описание формата iBank2 2 Краткое описание формата Profix 2 Краткое описание формата BM RS 2 2. Импорт 4 Файлы импорта формата iBank2 4 Структура и примеры файлов импорта в формате iBank2 4 Импорт гривневого платежного поручения 4 Импорт зарплатной ведомости 5 Импорт платежного поручения в иностранной валюте 6 Импорт внутрибанковского платежного поручения в иностранной валюте 9 Импорт заявления о продаже иностранной валюты 10 Импорт заявления о купле иностранной валюты 11 Импорт заявления о конвертации валюты 13 Импорт записей справочника корреспондентов 15 Импорт записей справочника бенефициаров 15 Описание настроек ПО «Клиент-Банк» для импорта файлов формата iBank2 17 Файлы импорта формата банк-клиент 17 Импорт гривневого платежного поручения 17 Импорт зарплатной ведомости 18 3. Экспорт 19 Структура и примеры файлов экспорта в формате iBank2 19 Описание настроек ПО «Клиент-Банк» для экспорта файлов формата iBank2 20 Структура и примеры файлов экспорта в формате Profix 20 Структура и примеры файлов экспорта в формате BM RS 21 Структура и примеры файлов экспорта в формате файл с разделителями CSV 23 Экспорт справочника сотрудников в формате банк-клиент 24

Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

  • Upload
    others

  • View
    9

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

РАБОТА С ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA. Оглавление:

1. Введение 2 Объекты и форматы обмена данными 2 Краткое описание форматов обмена данными 2 Краткое описание формата iBank2 2 Краткое описание формата Profix 2 Краткое описание формата BM RS 2

2. Импорт 4

Файлы импорта формата iBank2 4 Структура и примеры файлов импорта в формате iBank2 4

Импорт гривневого платежного поручения 4 Импорт зарплатной ведомости 5 Импорт платежного поручения в иностранной валюте 6 Импорт внутрибанковского платежного поручения в иностранной валюте 9 Импорт заявления о продаже иностранной валюты 10 Импорт заявления о купле иностранной валюты 11 Импорт заявления о конвертации валюты 13 Импорт записей справочника корреспондентов 15 Импорт записей справочника бенефициаров 15 Описание настроек ПО «Клиент-Банк» для импорта файлов формата iBank2 17

Файлы импорта формата банк-клиент 17 Импорт гривневого платежного поручения 17 Импорт зарплатной ведомости 18

3. Экспорт 19

Структура и примеры файлов экспорта в формате iBank2 19 Описание настроек ПО «Клиент-Банк» для экспорта файлов формата iBank2 20 Структура и примеры файлов экспорта в формате Profix 20 Структура и примеры файлов экспорта в формате BM RS 21 Структура и примеры файлов экспорта в формате файл с разделителями CSV 23 Экспорт справочника сотрудников в формате банк-клиент 24

Page 2: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

2

1. Введение Объекты и форматы обмена данных В таблице 1.1 показаны форматы, в которых можно импортировать и экспортировать

документы, отчеты и справочники в системе iBank2ua. Таблица 1.1 (Возможность импорта и экспорта)

№ Наименование документа Импорт Экспорт

1 Гривневое платежное поручение iBank2, банк-клиент

2 Зарплатная ведомость iBank2, банк-клиент

6 Платежное поручение в иностранной валюте iBank2

7 Внутрибанковское платежное поручение в иностранной валюте

iBank2

8 Заявление о продаже иностранной валюты iBank2

9 Заявление о покупке иностранной валюты iBank2

10 Заявление о конвертации иностранной валюты iBank2

11 Справочник корреспондентов iBank2 iBank2

12 Справочник бенефициаров iBank2 iBank2

13 Выписки Profix, BM RS, файл с

разделителями csv

14 Обороты файл с разделителями csv

15 Справочник сотрудников банк-клиент, файл с

разделителями csv

16 Курсы валют файл с разделителями csv

Краткое описание форматов обмена данных В данном разделе вкратце рассматриваются основные сведения о форматах обмена данных,

поддерживаемых системой: Краткое описание формата iBank2 Формат iBank2 является внутренним форматом импорта и экспорта системы iBank2UA. Наименование файла импорта в формате iBank2 может быть любым, так же как и его

расширение. Описание базовых элементов формата представлено в таблице 1.2. Таблица 1.2 (Базовые элементы импорта/экспорта)

№ Тип элемента Символы

1 Перевод строки В формате Windows – ‘\r\n’, в формате Unix – ‘\n’

2 Служебный символ ‘.’|’,’|‘;’|‘:’ <пробел> |‘!’|‘@’|‘#’|‘$’|‘%’|‘^’|‘&’|’|’|’\’|’<’|’>’|’?’|’ “ ’|’ ’ ’

3 Пробел ‘ ’ | ‘;’

4 Цифра (Integer) ‘0’|’1’|’2’|’3’|’4’|’5’|’6’|’7’|’8’|’9’

5 Буква (Char) ‘A’|’B’|……|’Y’|’Z’|’a’|’b’|……|’y’|’z’|’А’|’Б’|……|’Ю’|’Я’|’а’|’б’|……|’ю’|’я’

6 Денежная сумма (Decimal) *<цифра> ‘.’ 2-4<цифра>

7 Дата (Date) 2<цифра>’.’2<цифра>’.’4<цифра> - дд.мм.гггг

8 Строка (String) *(<буква>|<цифра>|<служебный символ>)

При импорте гривневых платежных поручений и записей справочника корреспондентов

происходит проверка на наличие в текстовых полях недопустимых символов по СЭП (с кодами 0 – 31 в таблице ASCII).

Краткое описание формата Profix В текущей версии системы iBank2UA реализован экспорт выписок в формате Profix. Файлы в

формате Profix имеют расширение .dbf. По своему типу эти файлы соответствуют dbf-файлам dBaseIV. Вследствие этого их можно просмотреть общедоступными программами, в частности программой WinDBFview. Для просмотра файлов экспорта в формате Profix также можно использовать Microsoft Excel.

Краткое описание формата BM RS Система iBank2UA позволяет проводить экспорт выписок в формате BM RS.

Page 3: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

3

- Гривневые и валютные выписки экспортируются в файлы с наименованием vГГММДД.zzz;

- Код валюты для гривневых и валютных выписок – символьный.

Page 4: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

4

2. Импорт Файлы импорта формата iBank2 Файлы импорта в формате iBank2 – это текстовые файлы, содержащие в себе следующие

элементы: · В самом начале файла должно указываться определение вида документа

импортируемого документа или справочника: пара значений Content-Type=<вид документа>.

· Между определением вида документа и блоками пар значений должен обязательно присутствовать перевод строки.

· Основная часть файла состоит из пар значений: <наименование поля>=<значение поля>. Для каждого документа или справочника должно указываться минимально необходимое количество пар значений <наименование поля>=<значение поля>.

Внимание! Наименование полей стандартизировано, значения полей (платежные реквизиты, номера счетов, данные справочников) должны соответствовать параметрам, установленным для клиента.

В файле импорта должны содержаться документы (справочники) только одного типа. Все импортируемые данные должны быть представлены в кодировке Cp1251 (Windows).

Для возможности импортировать одновременно несколько документов в формате iBank2 существует несколько вариантов: создать несколько файлов документов одного типа или в одном файле указать несколько документов, разделителем для которых будет пустая строка.

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

поля Content-Type приведен в таблице 2.1. Таблица 2.1 (Названия документов и справочников для импорта)

№ Вид документа Значение поля Content-Type

1 Гривневое платежное поручение doc/ua_payment

2 Зарплатная ведомость doc/pay_sheet

3 Поручение на продление срока действия карт doc/card_prolongation

4 Поручение на увольнение doc/fire_staff_order

5 Поручение на закрепление карт doc/assign_card_order

6 Платежное поручение в иностранной валюте doc/ua_currency_payment

7 Внутрибанковское платежное поручение в иностранной валюте doc/ua_intrabank_currency_payment

8 Заявление о продаже валюты doc/ua_currency_sale

9 Заявление о покупке иностранной валюты doc/ua_currency_purchase

10 Заявление о конвертации валюты doc/ua_currency_convert

11 Справочник корреспондентов ref/recipient

12 Справочник бенефициаров ref/beneficiar

Структура и примеры файлов импорта в формате iBank2 Импорт гривневого платежного поручения Файл импорта гривневого платежного поручения может иметь любое название и любое

расширение. Файл импорта гривневого платежного поручения обязательно должен быть текстовым файлом,

созданным в кодировке CP1251 (Windows) В таблице 2.2 приведено описание полей импорта гривневого платежного поручения.

Page 5: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

5

Таблица 2.2 (Описание полей файла импорта гривневого платежного поручения)

Наименование Тип1 Обязательность Описание

DATE_DOC Date Да Дата документа

NUM_DOC String (10) Да Номер документа

AMOUNT Decimal (12,2) Да Сумма платежа

CLN_NAME String (40) Да Наименование плательщика

CLN_OKPO String (10) Да ЕГРПОУ плательщика

CLN_ACCOUNT String (14) Да Счет плательщика

CLN_BANK_NAME String (45) Нет Наименование банка плательщика

CLN_BANK_MFO String (6) Да МФО банка плательщика

CLN_COUNTRY_CODE String (3) Нет Код страны банка плательщика

RCPT_NAME String (40) Да Наименование получателя

RCPT_OKPO String (10) Да ЕГРПОУ получателя

RCPT_ACCOUNT String (14) Да Счет получателя

RCPT_BANK_NAME String (45) Нет Наименование банка получателя

RCPT_BANK_MFO String (6) Да МФО банка получателя

RCPT_COUNTRY_CODE String (3) Нет Код страны банка получателя

PAYMENT_DETAILS String (160) Да Назначение платежа

VALUE_DATE Date Нет Дата валютирования

Ниже приведен пример файла импорта гривневого платежного поручения в формате iBank2: Content-Type=doc/ua_payment DATE_DOC=09.01.2013 NUM_DOC=102 AMOUNT=10.002 CLN_NAME=Тест "КРД" CLN_OKPO=04937956 CLN_ACCOUNT=26005000111 CLN_BANK_NAME=АТ РАЙФФАЙЗЕН БАНК АВАЛЬ У М.КИЄВІ CLN_BANK_MFO=380805 RCPT_NAME=Тест "КРД" RCPT_OKPO=04937956 RCPT_ACCOUNT=26005000444 RCPT_BANK_NAME=КРД АТ РАЙФФАЙЗЕН БАНК АВАЛЬ М.КИЇВ RCPT_BANK_MFO=322904 PAYMENT_DETAILS=Тестовый платеж № 2 VALUE_DATE= Импорт зарплатной ведомости Файл импорта зарплатной ведомости может иметь любое название и любое расширение. Файл импорта зарплатной ведомости обязательно должен быть текстовым файлом, созданным

в кодировке CP1251 (Windows) В таблице 2.3 представлено описание полей файла импорта зарплатной ведомости.

1 Здесь и далее в поле Тип поля в скобках будет указано количество символов целой и дробной части, например (12,2)

значит что может быть 12символов целой части, 2 символа дробной части 2 Разделитель целой и дробной части обязательно должен быть символ «.»

Page 6: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

6

Таблица 2.3 (Описание полей файла импорта зарплатной ведомости)

Наименование Тип Обязательность Описание

DATE_DOC Date Да Дата документа

NUM_DOC String (10) Да Номер документа

CLN_NAME String (40) Нет Наименование плательщика

PAYER_BANK_MFO String (6) Да МФО банка плательщика

PAYER_BANK_NAME String (45) Нет Наименование банка плательщика

PAYER_ACCOUNT String (14) Да Счет списания

ONFLOW_TYPE String (65) Да Вид зачисления

AMOUNT Decimal (3,2) Нет Сумма зачисления

PAYER_BANK_ACCOUNT String (14) Нет Счет банка плательщика

COMMISION_PERCENT Decimal (3,2) Нет Процент за РКО

VALUE_DATE Date Нет Дата валютирования

CLN_OKPO String (10) Нет ЕГРПОУ плательщика

CARD_HOLDERS.N1.CARD_NUM String (14) Да Номер карточного счета (СКС)

CARD_HOLDERS.N.CARD_HOLDER String (80) Да ФИО держателя карты

CARD_HOLDERS.N.CARD_HOLDER_INN String (14) Да ИНН держателя карты

CARD_HOLDERS.N.AMOUNT Decimal (12,2) Да Сумма зачисления

CARD_HOLDERS.N.STAFF_ID String (16) Нет ИД сотрудника

CARD_HOLDERS.N.RESIDENT_FLAG String (1) Нет Признак резидента

CARD_HOLDERS.N.CARD_HOLDER_TABN String (20) Нет Таб. № держателя карты

CARD_HOLDERS.N.STATUS Integer (5) Нет Результат зачисления

Ниже приведен пример файла импорта зарплатной ведомости для двух сотрудников: Content-Type=doc/pay_sheet DATE_DOC=09.01.2013 NUM_DOC=15 CLN_NAME= PAYER_BANK_MFO=322904 PAYER_BANK_NAME= PAYER_ACCOUNT=290991144276 ONFLOW_TYPE=Заробітна плата та аванси CARD_HOLDERS.0.CARD_NUM=0189164900 CARD_HOLDERS.0.CARD_HOLDER=ПАРАЦА ВАЛЕНТИНА ЛЕОНТІЇВНА CARD_HOLDERS.0.CARD_HOLDER_INN=1681910881 CARD_HOLDERS.0.AMOUNT=10.00 CARD_HOLDERS.1.CARD_NUM=0345664600 CARD_HOLDERS.1.CARD_HOLDER=БЛІДЧЕНКО-НАЙКО ВІКТОРІЯ ВАСИЛІВНА CARD_HOLDERS.1.CARD_HOLDER_INN=2812605204 CARD_HOLDERS.1.AMOUNT=20.00 Импорт платежного поручения в иностранной валюте Файл импорта платежного поручения в иностранной валюте может иметь любое название и

любое расширение. Файл импорта платежного поручения в иностранной валюте обязательно должен быть

текстовым файлом, созданным в кодировке CP1251 (Windows) В таблице 2.4 представлено описание полей файла импорта платежного поручения в

иностранной валюте.

1 N – номер сотрудника, начинается с «0»

Page 7: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

7

Таблица 2.4 (Описание полей файла импорта платежного поручения в иностранной валюте) Наименование Тип Обязат. Описание

DATE_DOC Date Да Дата документа

NUM_DOC String (10) Да Номер документа

CLN_BNK_NAME String (140) Да Наименование банка плательщика

CLN_BNK_BIC_TYPE String (8) Нет Тип идентификационного кода банка плательщика

CLN_BNK_BIC String (15) Нет Идентификационный код банка плательщика

CLN_BNK_COUNTRY String (70) Да Страна банка плательщика

CLN_BNK_CITY String (70) Да Город банка плательщика

CLN_BNK_ADDR String (140) Нет Адрес банка плательщика

CLN_NAME String (40) Да Наименование плательщика

CLN_COUNTRY String (70) Да Страна плательщика

CLN_CITY String (70) Нет Город плательщика

CLN_ADDR String (80) Да Адрес плательщика

CLN_EMPLOYEE_FIO String (40) Нет ФИО ответственного сотрудника плательщика

CLN_EMPLOYEE_PHONE String (20) Нет Конт. тел. ответственного сотрудника

CLN_ACCOUNT String (14) Да Валютный счет плательщика

AMOUNT Decimal (14,4) Да Сумма платежа

AMOUNT_CURRENCY String (3) Да Буквенный код валюты счета (USD, EUR, DEM…)

AMOUNT_CURRENCY_CODE String (3) Да Цифровой код валюты платежа

CURRENCY_DATE Date Нет Дата валютирования

INTERMED_BNK_NAME String (140) Нет Наименование банка-посредника

INTERMED_BNK_BIC_TYPE String (8) Нет Тип идентификационного кода банка-посредника

INTERMED_BNK_BIC String (15) Да Идентификационный код банка-посредника

INTERMED_BNK_COUNTRY String (70) Нет Страна банка-посредника

INTERMED_BNK_CITY String (70) Нет Город банка-посредника

INTERMED_BNK_ADDR String (140) Нет Адрес банка-посредника

RCPT_BNK_NAME String (140) Да Наименование банка бенефициара

RCPT_BNK_BIC_TYPE String (8) Нет Тип идентификационного кода банка бенефициара

RCPT_BNK_BIC String (15) Да Идентификационный код банка бенефициара

RCPT_BNK_ACCOUNT String (50) Нет Номер счета банка бенефициара

RCPT_BNK_COUNTRY String (70) Да Страна банка бенефициара

RCPT_BNK_CITY String (70) Да Город банка бенефициара

RCPT_BNK_ADDR String (140) Да Адрес банка бенефициара

RCPT_NAME String (140) Да Наименование бенефициара

RCPT_ACCOUNT String (50) Нет Номер счета бенефициара

RCPT_COUNTRY String (70) Да Страна бенефициара

RCPT_CITY String (70) Да Город бенефициара

RCPT_ADDR String (140) Да Адрес бенефициара

PAYMENT_DETAILS String (140) Да Назначение платежа

EXPENSE_TYPE String (80) Да

Расходы и комиссия по платежу может принимать значения: «за рахунок платника», «за рахунок бенефіціара», «за рахунок платника і бенефіціара»

EXPENSE_ACCOUNT String (14) Нет Счет для списания комиссии, заполняется в случае, если расходы по переводу лежат на плательщике (OUR) или на обоих (SHA)

PAYMENT_SPEED String (13) Да Срочность платежа, может принимать значения «Обычный», «Срочный», «Сверхсрочный»

PAYMENT_ADDED_INFO String (140) Нет Дополнительная информация

CLN_OKPO String (10) Нет Код ЕГРПОУ плательщика

RCPT_BNK_IBAN String (35) Нет IBAN-код банка бенефициара

INTERMED_BNK_COUNTRY_CODE String (3) Нет Код страны банка-посредника

RCPT_BNK_COUNTRY_CODE String (3) Да Код страны банка бенефициара

Page 8: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

8

Таблица 2.4 (Продолжение)

Наименование Тип Обязат. Описание

RCPT_COUNTRY_CODE String (3) Да Код страны бенефициара

INTERMED_BNK_ACCOUNT String (50) Нет Номер счета банка-посредника

CLN_BNK_MFO String (6) Нет МФО банка плательщика

OPCODE String (4) Нет Код операции

CLN_RESIDENT String (1) Нет Признак того, что клиент является резидентом

RCPT_RESIDENT String (1) Нет Признак того, что бенефициар является резидентом

Ниже приведен пример файла импорта платежного поручения в иностранной валюте: Content-Type=doc/ua_currency_payment DATE_DOC=10.01.2013 NUM_DOC=30 CLN_BNK_NAME=Raiffeisen Bank Aval CLN_BNK_BIC_TYPE=SWIFT CLN_BNK_BIC=AVALUAUK CLN_BNK_COUNTRY=Ukraine CLN_BNK_CITY=kiev CLN_BNK_ADDR=Leskova, 9 CLN_NAME=Test KRD CLN_COUNTRY=Ukraine CLN_CITY=Kiev CLN_ADDR=kiev CLN_EMPLOYEE_FIO=Иванов И. И. CLN_EMPLOYEE_PHONE=0506213308 CLN_ACCOUNT=26005000111 AMOUNT=1000.00 AMOUNT_CURRENCY=USD AMOUNT_CURRENCY_CODE=840 RCPT_BNK_NAME=JSC "Aizkraukles banka" RCPT_BNK_BIC_TYPE=SWIFT RCPT_BNK_BIC=AIZKLV22 RCPT_BNK_COUNTRY=LATVIA RCPT_BNK_CITY=Riga RCPT_BNK_ADDR=Latvia RCPT_NAME=Latymer Corporation Limited RCPT_ACCOUNT=LV22AIZK0001140064536 RCPT_COUNTRY=UNITED KINGDOM RCPT_CITY=BUSINESS CENTRE,152-178Kingston Ro RCPT_ADDR=REGISTERED OFFICE UNIT 90,Kingspark PAYMENT_DETAILS=PAYMENT FOR CTR №3/09 DD 11.09.09 for building instrument EXPENSE_TYPE=за рахунок платника (OUR) EXPENSE_ACCOUNT=26005000111 PAYMENT_SPEED=Терміновий PAYMENT_ADDED_INFO= CLN_OKPO=04937956 RCPT_BNK_COUNTRY_CODE=428 RCPT_COUNTRY_CODE=826 CLN_BNK_MFO=380805

Page 9: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

9

Импорт внутрибанковского платежного поручения в иностранной валюте Файл импорта внутрибанковского платежного поручения в иностранной валюте может иметь

любое название и любое расширение. Файл импорта внутрибанковского платежного поручения в иностранной валюте обязательно

должен быть текстовым файлом, созданным в кодировке CP1251 (Windows) В таблице 2.6 представлено описание полей файла импорта внутрибанковского платежного

поручения в иностранной валюте. Таблица 2.6 (Описание полей файла импорта внутрибанковского платежного поручения в

иностранной валюте)

Наименование Тип Обязат. Описание

DATE_DOC Date Дата документа

NUM_DOC String (10) Номер документа

AMOUNT Decimal (14,4) Сумма платежа

CLN_NAME String (40) Наименование плательщика

CLN_OKPO String (10) Код ЕГРПОУ плательщика

CLN_ACCOUNT String (14) Счет плательщика

CLN_BNK_NAME String (45) Наименование банка плательщика

CLN_BANK_MFO String (6) МФО банка плательщика

RCPT_NAME String (140) Наименование получателя

RCPT_OKPO String (10) Код ЕГРПОУ получателя

RCPT_ACCOUNT String (14) Номер счета получателя

RCPT_BNK_NAME String (140) Наименование банка получателя

RCPT_BANK_MFO String (6) МФО банка получателя

PAYMENT_DETAILS String (220) Назначение платежа

CURRENCY_DATE Date Нет Дата валютирования

AMOUNT_CURRENCY String (3) Да Валюта платежа (USD, RUB, EUR, DEM, …)

RCPT_RESIDENT String (1) Признак резидента, может принимать значения «0» - получатель является нерезидентом, «1» - получатель является резидентом

COMISSION_ACCOUNT String (14) Счет плательщика для оплаты комиссии

Ниже приведен пример файла импорта заявки о продаже иностранной валюты: Content-Type=doc/ua_intrabank_currency_payment DATE_DOC=16.02.2013 NUM_DOC=12 AMOUNT=100.05 CLN_NAME=Тест "КРД" CLN_OKPO=04937956 CLN_ACCOUNT=26005000111 CLN_BNK_NAME=АТ "РАЙФФАЙЗЕН БАНК АВАЛЬ" У М.КИЄВІ CLN_BANK_MFO=380805 RCPT_NAME=ТОВ "Нібулон" RCPT_OKPO=12345678 RCPT_ACCOUNT=2600123456789 RCPT_BNK_NAME=МОД "РАЙФФАЙЗЕН БАНК АВАЛЬ",М.МИКОЛАЇВ RCPT_BANK_MFO=326182 PAYMENT_DETAILS=Оплата согласно договора № 1 от 01.01.2013 CURRENCY_DATE= AMOUNT_CURRENCY=USD RCPT_RESIDENT=1 COMISSION_ACCOUNT=26005000111

Page 10: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

10

Импорт заявления о продаже иностранной валюты Файл импорта заявления о продаже иностранной валюты может иметь любое название и

любое расширение. Файл импорта заявления о продаже иностранной валюты обязательно должен быть текстовым

файлом, созданным в кодировке CP1251 (Windows) В таблице 2.7 представлено описание полей файла импорта заявления о продаже иностранной

валюты. Таблица 2.7 (Описание полей файла импорта заявления о продаже иностранной валюты)

Наименование Тип Обязат. Описание

DATE_DOC Date Да Номер документа

NUM_DOC String (10) Да Дата документа

CLN_NAME String (40) Да Наименование клиента

CLN_ADDR String (80) Да Адрес клиента

CLN_PHONES String (20) Да Контактный телефон клиента

CLN_EMPLOYEE_FIO String (40) Нет ФИО ответственного сотрудника клиента

CLN_EMPLOYEE_PHONE String (20) Нет Конт. Телефон ответственного сотрудника

BNK_NAME String (45) Да Наименование уполномоченного банка

BNK_MFO String (6) Да МФО уполномоченного банка

SALE_SUM Decimal (14,4) Нет Сумма продаваемой иностранной валюты

SALE_CURRENCY String (3) Да Код продаваемой иностранной валюты

SALE_ACCOUNT String (14) Да Счет для списания валюты

SALE_KIND String (1) Нет Флаг перечисления на банковский счет для продажи иностранной валюты

SALE_BNK_ACCOUNT String (14) Нет Банковский счет для продажи иностранной валюты

SALE_BNK_NAME String (45) Да Наименование банка для продажи иностранной валюты

SALE_BNK_BIC String (6) Да МФО банка для продажи иностранной валюты

SALE_RATE_KIND String (30) Да Вариант выбора курса продажи иностранной валюты, может принимать значения «по курсу уполномоченного банка», «по курсу».

SALE_RATE Decimal (8,4) Нет Курс продажи иностранной валюты

PURCHASE_SUM Decimal (12,2) Нет Сумма гривен для зачисления

PURCHASE_ACCOUNT String (14) Да Счет клиента для зачисления гривен

PURCHASE_BNK_NAME String (45) Да Наименование банка, в котором открыт счет клиента для зачисления гривен

PURCHASE_BNK_MFO String (6) Да МФО банка, в котором открыт счет клиента для зачисления гривен

COMMISSION Decimal (7,2) Нет Комиссия уполномоченного банка

RETURN_ACCOUNT String (14) Да Счет клиента для возврата иностранной валюты

EXPERIENCE_DATE Date Нет Срок действия заявления

CURRENCY_DATE Date Нет Дата валютирования

SALE_CODE_REASON String (2) Да Код причины продажи валюты

SALE_REASON String (140) Да Причина продажи валюты

VALUE_DATE String (10) Нет Дата валютирования, может принимать значения «сегодня», «завтра», «спот»

CLN_OKPO String (10) Да Код ЕГРПОУ клиента

Ниже приведен пример файла импорта заявки о продаже иностранной валюты: Content-Type=doc/ua_currency_sale DATE_DOC=10.02.2013 NUM_DOC=10 CLN_NAME=Тест "КРД" CLN_ADDR=м. Київ, вул. Прорізна, 6 CLN_PHONES=235-86-23 CLN_EMPLOYEE_FIO=Иванов И.И.

Page 11: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

11

CLN_EMPLOYEE_PHONE=0506213308 BNK_NAME=АТ "РАЙФФАЙЗЕН БАНК АВАЛЬ" У М.КИЄВІ BNK_MFO=380805 SALE_SUM=10.0500 SALE_CURRENCY=USD SALE_ACCOUNT=26005000111 SALE_KIND=0 SALE_BNK_NAME=КРД АТ "РАЙФАЙЗЕН БАНК АВАЛЬ" SALE_BNK_ACCOUNT=2900623 SALE_BNK_BIC=322904 SALE_RATE_KIND=за курсом уповноваженого банку SALE_RATE= PURCHASE_SUM= PURCHASE_ACCOUNT=26005000111 PURCHASE_BNK_NAME=АТ "РАЙФФАЙЗЕН БАНК АВАЛЬ" У М.КИЄВІ PURCHASE_BNK_MFO=380805 COMMISSION=3.00 RETURN_ACCOUNT=26005000111 SALE_CODE_REASON=19 SALE_REASON=продано кредитні кошти, отримані клієнтом банку від нерезидента CLN_OKPO=04937956 Импорт заявления о купле иностранной валюты Файл импорта заявления о купле иностранной валюты может иметь любое название и любое

расширение. Файл импорта заявления о купле иностранной валюты обязательно должен быть текстовым

файлом, созданным в кодировке CP1251 (Windows). В таблице 2.8 представлено описание полей файла импорта заявления о купле иностранной

валюты. Таблица 2.8 (Описание полей файла импорта заявления о купле иностранной валюты)

Наименование Тип Обязат. Описание

NUM_DOC String (10) Да Номер документа

DATE_DOC Date Да Дата документа

CLN_NAME String (40) Да Наименование клиента

CLN_ADDR String (80) Да Адрес клиента

CLN_PHONES String (20) Да Контактный телефон клиента

CLN_EMPLOYEE_FIO String (40) Нет ФИО ответственного сотрудника банка

CLN_EMPLOYEE_PHONE String (20) Нет Конт. Телефон ответственного сотрудника банка

PURCHASE_REASON String (225) Да Основание для купли иностранной валюты

BNK_NAME String (45) Да Наименование уполномоченного банка

BNK_MFO String (6) Да МФО уполномоченного банка

BNK_ADDR String (80) Да Адрес уполномоченного банка

SALE_SUM Decimal (12,2) Да Сумма покупаемой иностранной валюты

SALE_ACCOUNT_FROM String (14) Да Текущий счет клиента

SALE_ACCOUNT String (14) Да Транзитный счет клиента

SALE_BNK_NAME String (45) Да Наименование банка, где открыт транзитный счет

SALE_BNK_MFO String (6) Да МФО банка, где открыт транзитный счет

PURCHASE_SUM Decimal (14,4) Да Сумма покупаемой иностранной валюты

PURCHASE_CURRENCY String (3) Да Код покупаемой иностранной валюты (USD, EUR, …)

PURCHASE_RATE_KIND String (30) Да Вариант выбора курса продажи иностранной валюты, может принимать значения «по курсу уполномоченного банка», «по курсу».

PURCHASE_RATE Decimal (8,4) Нет Курс покупки иностранной валюты

PURCHASE_ACCOUNT String (14) Да Счет клиента для зачисления покупаемой иностранной валюты

Page 12: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

12

Таблица 2.8 (Продолжение)

Наименование Тип Обязат. Описание

PURCHASE_BNK_NAME String (45) Да Наименование банка, где открыт счет клиента для зачисления покупаемой иностранной валюты

PURCHASE_BNK_MFO String (6) Да МФО банка, где открыт счет клиента для зачисления покупаемой иностранной валюты

COMMISSION Decimal (7,2) Нет Комиссия уполномоченного банка

RETURN_ACCOUNT String (14) Да Счет клиента для возврата средств в случае невозможности покупки иностранной валюты

RETURN_BNK_NAME String (45) Да Наименование банка, где открыт счет для возврата средств

RETURN_BNK_MFO String (6) Да МФО банка, где открыт счет для возврата средств

PENSION_TAX_KIND String (80) Нет Вариант выбора оплаты сбора на обязательное государственное пенсионное страхование

PENSION_CLN_NUMBER String (11) Нет Регистрационный номер клиента в государственном Пенсионном Фонде

FUND_NAME String (40) Нет Наименование отделения Пенсионного Фонда

FUND_EDRPOU String (8) Нет Код ЕГРПОУ отделения Пенсионного Фонда

FUND_ACCOUNT String (14) Нет Расчетный счет отделения Пенсионного Фонда

FUND_BNK_NAME String (45) Нет Наименование банка отделения Пенсионного Фонда

FUND_BNK_MFO String (6) Нет МФО банка отделения Пенсионного Фонда

EXPERIENCE_DATE Date Нет Срок действия заявления

CURRENCY_DATE Date Нет Дата валютирования

PENSION_TAX Decimal (7,2) Нет Процент сбора на пенсионное страхование

TRANSFER_BNK_ADDR String (80) Да Адрес банка, в котором открыт транзитный счет клиента

CLN_OKPO String (10) Да Код ЕГРПОУ клиента

Ниже приведен пример файла импорта заявки о продаже иностранной валюты: Content-Type=doc/ua_currency_purchase DATE_DOC=21.02.2013 NUM_DOC=3050 CLN_NAME=Тест "КРД" CLN_ADDR=м. Київ, вул. Прорізна, 6 CLN_PHONES=235-86-23 CLN_EMPLOYEE_FIO=Иванов И.И. CLN_EMPLOYEE_PHONE=0506213308 PURCHASE_REASON=покупка валюты для погашения кредитной задолженности согласно

договора № 1 от 01.01.2013 BNK_NAME=АТ "РАЙФФАЙЗЕН БАНК АВАЛЬ" У М.КИЄВІ BNK_MFO=380805 BNK_ADDR=м. Київ, вул. Лєскова, 9 SALE_SUM= SALE_ACCOUNT_FROM=26005000111 SALE_ACCOUNT=29009323323266 SALE_BNK_NAME=КРД АТ"РАЙФФАЙЗЕН БАНК АВАЛЬ"М.КИЇВ SALE_BNK_MFO=322904 PURCHASE_SUM=1000,00 PURCHASE_CURRENCY=USD PURCHASE_RATE_KIND=за курсом уповноваженого банку PURCHASE_RATE= PURCHASE_ACCOUNT=26005000111 PURCHASE_BNK_NAME=АТ "РАЙФФАЙЗЕН БАНК АВАЛЬ" У М.КИЄВІ PURCHASE_BNK_MFO=380805 COMMISSION= RETURN_ACCOUNT=26005000111

Page 13: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

13

RETURN_BNK_NAME=АТ "РАЙФФАЙЗЕН БАНК АВАЛЬ" У М.КИЄВІ RETURN_BNK_MFO=380805 TRANSFER_BNK_ADDR=м. Київ, вул. Лєскова, 9 CLN_OKPO=04937956 Импорт заявления о конвертации валюты Файл импорта заявления о конвертации валюты может иметь любое название и любое

расширение. Файл импорта заявления о конвертации валюты обязательно должен быть текстовым файлом,

созданным в кодировке CP1251 (Windows). В таблице 2.9 представлено описание полей файла импорта заявления о конвертации валюты.

Таблица 2.9 (Описание полей файла импорта заявления о конвертации валюты)

Наименование Тип Обязат. Описание

DATE_DOC Date Да Дата документа

NUM_DOC String (10) Да Номер документа

CLN_NAME String (40) Да Наименование клиента

CLN_ADDR String (80) Да Адрес клиента

CLN_PHONES String (20) Да Контактный телефон клиента

CLN_EMPLOYEE_FIO String (40) Нет ФИО ответственного сотрудника

CLN_EMPLOYE_PHONE String (20) Нет Конт. Телефон ответственного сотрудника

PURCHASE_REASON String (255) Да Цель конвертации валюты

BNK_NAME String (45) Да Наименование уполномоченного банка

BNK_MFO String (6) Да МФО уполномоченного банка

BNK_ADDR String (80) Да Адрес уполномоченного банка

SALE_SUM Decimal (14,4) Да Сумма продажи иностранной валюты

SALE_ACCOUNT String (14) Да Счет клиента для списания продаваемой валюты

PURCGASE_SUM Decimal (14,4) Да Сумма покупки иностранной валюты

PURCHASE_CURRENCY String (3) Да Код покупаемой иностранной валюты (USD, EUR, …)

PURCHASE_RATE_KIND String (30) Да Вариант выбора курса продажи иностранной валюты, может принимать значения «по курсу уполномоченного банка», «по курсу».

PURCHASE_RATE Decimal (8,4) Нет Курс покупки иностранной валюты

PURCHASE_ACCOUNT String (14) Да Счет клиента для зачисления покупаемой валюты

SALE_CURRENCY String (3) Да Код продаваемой иностранной валюты (USD, EUR, …)

COMMISSION Decimal (7,2) Нет Процент отчисляемой комиссии

EXPERIENCE_DATE Date Нет Срок действия заявления

CURRENCY_DATE Date Нет Дата валютирования

PURCHASE_BNK_NAME String (45) Да Наименование банка, в котором открыт счет для зачисления покупаемой валюты

PURCHASE_BNK_MFO String (6) Да МФО банка, в котором открыт счет для зачисления покупаемой валюты

SALE_BNK_NAME String (45) Да Наименование банка, в котором открыт счет для списания продаваемой валюты

SALE_BNK_MFO String (6) Да МФО банка, в котором открыт счет для списания продаваемой валюты

TRANSIT_ACCOUNT String (14) Да Транзитный счет для перечисления суммы, необходимой для покупки

TRANSIT_BNK_NAME String (45) Да Наименование банка, в котором открыт счет для перечисления суммы, необходимой для покупки

TRANSIT_BNK_MFO String (6) Да МФО банка, в котором открыт счет для перечисления суммы, необходимой для покупки

TRANSIT_BNK_ADDR String (80) Да Адрес банка, в котором открыт счет для перечисления суммы, необходимой для покупки

COMMISSION_ACCOUNT String (14) Да Счет в гривне для списания комиссии

Page 14: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

14

Таблица 2.9 (Продолжение)

Наименование Тип Обязат. Описание

COMMISSION_BNK_NAME String (45) Да Наименование банка, в котором открыт счет для списания комиссии

COMMISSION_BNK_MFO String (6) Да МФО банка, в котором открыт счет для списания комиссии

COMMISSION_BNK_ADDR String (80) Да Адрес банка, в котором открыт счет для списания комиссии

TRANSIT_KIND String (70) Да Способ перечисления суммы на покупку, обязательно принимает значение «обязуемся перечислить»

CLN_OKPO String (10) Да Код ЕГРПОУ клиента

RETURN_ACCOUNT String (14) Да Счет клиента для возврата суммы

Ниже приведен пример файла импорта заявки о конвертации валюты: Content-Type=doc/ua_currency_convert DATE_DOC=21.02.2013 NUM_DOC=300 CLN_NAME=Тест "КРД" CLN_ADDR=м. Київ, вул. Прорізна, 6 CLN_PHONES=235-86-23 CLN_EMPLOYEE_FIO=Иванов И.И. CLN_EMPLOYEE_PHONE=0506213308 PURCHASE_REASON=для оплаты согласно договора № 2 BNK_NAME=АТ "РАЙФФАЙЗЕН БАНК АВАЛЬ" У М.КИЄВІ BNK_MFO=380805 BNK_ADDR=м. Київ, вул. Лєскова, 9 SALE_SUM=123,45 SALE_ACCOUNT=26005000111 PURCHASE_SUM= PURCHASE_CURRENCY=USD PURCHASE_RATE_KIND=за курсом банку PURCHASE_RATE= PURCHASE_ACCOUNT=26005000111 SALE_CURRENCY=EUR COMMISSION= PURCHASE_BNK_NAME=АТ "РАЙФФАЙЗЕН БАНК АВАЛЬ" У М.КИЄВІ PURCHASE_BNK_MFO=380805 SALE_BNK_NAME=АТ "РАЙФФАЙЗЕН БАНК АВАЛЬ" У М.КИЄВІ SALE_BNK_MFO=380805 TRANSIT_ACCOUNT=29009323323266 TRANSIT_BNK_NAME=КРД АТ"РАЙФФАЙЗЕН БАНК АВАЛЬ"М.КИЇВ TRANSIT_BNK_MFO=322904 TRANSIT_BNK_ADDR=м. Київ COMMISSION_ACCOUNT=26005000111 COMMISSION_BNK_NAME=АТ "РАЙФФАЙЗЕН БАНК АВАЛЬ" У М.КИЄВІ COMMISSION_BNK_MFO=380805 COMMISSION_BNK_ADDR=м. Київ, вул. Лєскова, 9 TRANSIT_KIND= Обязуемся перечислить CLN_OKPO=04937956 RETURN_ACCOUNT=26005000111

Page 15: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

15

Импорт записей справочника корреспондентов Файл импорта записей справочника корреспондентов может иметь любое название и любое

расширение. Файл импорта записей справочника корреспондентов обязательно должен быть текстовым

файлом, созданным в кодировке CP1251 (Windows). В таблице 2.10 представлено описание полей файла импорта записей справочника

корреспондентов. Таблица 2.10 (Описание полей файла импорта записей справочника корреспондентов)

Наименование Тип Обязат. Описание

RCPT_INN String (14) Да Код ЕГРПОУ корреспондента

RCPT_NAME String (40) Да Наименование корреспондента

RCPT_ACCOUNT String (14) Да Счет корреспондента

RCPT_BANK_BIC String (6) Да МФО банка корреспондента

PAYMENT_DETAILS String (220) Нет Назначение платежа

NOTE String (210) Нет Примечание

Ниже приведен пример файла импорта записей справочника корреспондентов для одного

корреспондента: Content-Type=ref/recipient RCPT_INN=22485297 RCPT_NAME=Одеська дирекція УДППЗ "Укрпошта" RCPT_ACCOUNT=26002012 RCPT_BANK_BIC=328351 PAYMENT_DETAILS=Оплата за доставку почты Импорт записей справочника бенефициаров Файл импорта записей справочника бенефициаров может иметь любое название и любое

расширение. Файл импорта записей справочника бенефициаров обязательно должен быть текстовым

файлом, созданным в кодировке CP1251 (Windows). В таблице 2.11 представлено описание полей файла импорта записей бенефициаров.

Таблица 2.11 (Описание полей файла импорта записей справочника бенефициаров)

Наименование Тип Обязат. Описание

RCPT_NAME String (160) Да Наименование бенефициара

RCPT_ACCOUNT String (50) Да Номер счета бенефициара

INTERMED_BNK_NAME String (140) Нет Наименование банка-посредника

INTERMED_BNK_BIC String (15) Нет Идентификационный код банка-посредника

INTERMED_BNK_BIC_TYPE String (8) Нет Тип идентификационного кода банка-посредника

INTERMED_BNK_COUNTRY_CODE Char (3) Нет Код страны банка-посредника

INTERMED_BNK_COUNTRY String (40) Нет Страна банка-посредника

INTERMED_BNK_CITY String (60) Нет Город банка-посредника

INTERMED_BNK_ADDR String (255) Нет Адрес банка-посредника

RCPT_BNK_NAME String (140) Да Наименование банка бенефициара

RCPT_BNK_ACCOUNT String (50) Нет Номер счета банка бенефициара

RCPT_BNK_BIC String (15) Нет Идентификационный код банка бенефициара

RCPT_BNK_BIC_TYPE String (8) Нет Тип идентификационного кода банка бенефициара

RCPT_BNK_COUNTRY_CODE Char (3) Да Код страны банка бенефициара

RCPT_BNK_COUNTRY String (40) Да Страна банка бенефициара

RCPT_BNK_CITY String (60) Да Город банка бенефициара

RCPT_BNK_ADDR String (255) Нет Адрес банка бенефициара

RCPT_COUNTRY_CODE Char (3) Да Код страны бенефициара

RCPT_COUNTRY String (40) Да Страна бенефициара

RCPT_CITY String (60) Да Город бенефициара

RCPT_ADDR String (255) Да Адрес бенефициара

Page 16: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

16

Ниже приведен пример файла импорта записей справочника бенефициаров для двух записей: Content-Type=ref/beneficiar RCPT_NAME=TOWERHILL MANAGEMENT LTD RCPT_ACCOUNT=CY23018000030000201100058227 INTERMED_BNK_NAME=EFG EUROBANK ERGASIAS S.А INTERMED_BNK_BIC=EFGBGRAA INTERMED_BNK_BIC_TYPE=SWIFT INTERMED_BNK_COUNTRY_CODE=300 INTERMED_BNK_COUNTRY=GREECE INTERMED_BNK_CITY=Athens INTERMED_BNK_ADDR= RCPT_BNK_NAME=Eurobank EFG Cyprus Ltd. RCPT_BNK_ACCOUNT=201100058227 RCPT_BNK_BIC=EFGBCY2N RCPT_BNK_BIC_TYPE=SWIFT RCPT_BNK_COUNTRY_CODE=196 RCPT_BNK_COUNTRY=CYPRUS RCPT_BNK_CITY=Nicosia RCPT_BNK_ADDR=41 Arch. Makarioc Avenue RCPT_COUNTRY_CODE=092 RCPT_COUNTRY=VIRGIN ISLANDS, BRITISH RCPT_CITY=Road Town RCPT_ADDR=Mill Mall Tower, 2-nd Floor, Wickha RCPT_NAME=Mondottica Limited, Company RCPT_ACCOUNT=GB38 LOYD 3015 9911 531352 RCPT_BNK_NAME=LLOYDS TSB BANK PLC RCPT_BNK_ACCOUNT= RCPT_BNK_BIC=LOYDGB21021 RCPT_BNK_BIC_TYPE=SWIFT RCPT_BNK_COUNTRY_CODE=826 RCPT_BNK_COUNTRY=UNITED KINGDOM RCPT_BNK_CITY=GILLINGHAM RCPT_BNK_ADDR=CITY OFFICE,ORCARD BRAE,KENT RCPT_COUNTRY_CODE=826 RCPT_COUNTRY=UNITED KINGDOM RCPT_CITY=Nottingham RCPT_ADDR=Michael H., Riverside BP, HG2 1RX

Page 17: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

17

Описание настроек ПО «Клиент-Банк» для импорта файлов формата iBank2 Для правильного импорта файлов формата

iBank2 в системе «Клиент-Банк» необходимо провести настройки системы, чтобы это сделать необходимо зайти в пункт меню «Сервис» «Настройки», как показано на рисунке 2.1.

В открывшемся окне необходимо выбрать перейти на вкладку «Обмен данными», блок «Импорт», в котором необходимо выбрать следующие параметры:

«Формат» – необходимо выбрать «iBank2» «Каталог» – прописывается путь к папке, в которой хранятся файлы импорта документа,

который необходимо импортировать в систему. «Кодировка» – выбор кодировки импортируемого файла (можно не редактировать). Пример показан на рисунке 2.2. После установки всех

необходимых настроек в «Клиент-Банке» необходимо в дереве документов выбрать тип документа, который необходимо импортировать и нажать на кнопку «Импорт» (

) или выбрать пункт меню «Документы» «Импорт».

В случае успешного импорта файла система выдаст соответствующее окно с перечнем всех импорти-рованных документов.

Аналогичные настройки используются для всех остальных форматов импорта.

Файлы импорта формата банк-клиент Импорт гривневого платежного поручения Фалы импорта гривневого платежного поручения в формате банк-клиент – это текстовые

файлы, название которых должно состоять иметь вид RddhhmmN.NNN где: · R – всегда латинская буква «R»; · dd – два символа для указания даты создания файла (день); · hhmm – четыре символа для указания времени создания файла – часы и минуты

создания файла, не обязательно точно указывать время создания · NNNN – код клиента банка (необходимо узнать у службы поддержки), если код клиента

состоит из 4 цифр, тогда имя файла имеет вид RddhhmmN.NNN, если код клиента состоит из 7 цифр, тогда имя файла имеет вид RddhhmmN.NNNNNN.

Файл импорта гривневого платежного поручения обязательно должен быть текстовым файлом, созданным в кодировке СР866 (MS-DOS).

Файл импорта содержит совокупность строк, представляющих расчетные документы, каждая строка – это новый документ.

Каждая строка в файле импорта состоит из полей, ограниченных символом «·». Список полей файла импорта в формате банк-клиент приведен в таблице 2.12.

Рис. 2.1 (Вход в меню настроек «Клиент-Банк»)

Рис. 2.2 (Пример настроек импорта файла в формате iBank2)

Page 18: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

18

Таблица 2.12 (Описание полей файла импорта в формате банк-клиент)

Номер поля

Тип значения

Обязат. Содержание поля

0 Integer (1) Нет Служебное поле, значение всегда «0»

1 Integer (2) Да Вид платежного документа, значение всегда «1»

2 Integer (10) Да Номер платежного документа

3 Integer (8) Да Дата платежного документа в формате ГГГГММДД

4 Integer (6) Да МФО банка плательщика

5 Integer (6) Да МФО банка получателя

6 Integer (14) Да Номер текущего счета плательщика

7 Integer (14) Да Номер текущего счета получателя

8 Integer (12) Да Сумма платежа в копейках

9 Integer (1) Нет Символ кассовой операции, значение всегда «0»

10 String (40) Да Наименование получателя

11 String (160) Да Назначение платежа

12 Integer (8) Нет Дата оказания услуги в формате ДДММГГГГ

13 Integer (1) Нет Код вида акцепта: 1, 2, 3

14 Integer (3) Нет Код платежа

15 Integer (1) Нет Признак передачи

16 Integer (14) Да Код ЕГРПОУ получателя средств

17 Integer (3) Нет Код валюты

Ниже приведен пример файла импорта гривневого платежного поручения в формате банк-

клиент для двух платежных поручений. Имя файла r2215450.444.

0·1·1·20130222·380805·322904·26005000111·26005000444·1000·0·тест "КРД"·Оплата комиссионных·····04937956·· 0·1·2·20130222·380805·300335·26005000111·2600123456·3050·0·ТОВ «Премьера»·Оплата услуг·····04937956··

Импорт зарплатной ведомости в формате банк-клиент При импорте зарплатной ведомости в формате банк-клиент необходимо указать dbf-файл, из

которого будут выгружаться данные. Описание полей dbf-файла импорта зарплатной ведомости в формате банк-клиент

представлено в таблице 2.13. Таблица 2.13 (Описание полей файла импорта зарплатной ведомости)

Наименование Тип Обязательность Описание

ACCT_CARD String (10) Да Номер карточного счета

FIO String (50) Да ФИО сотрудника

ID_CODE String (10) Да ИНН сотрудника

SUMA Decimal (10,2) Да Сумма зачисления в гривнах

Пример структуры dbf-файла для импорта зарплатной ведомости с начислением денежных средств двум сотрудникам приведен на рисунке 2.3.

Рис. 2.3 (Пример импорта зарплатной ведомости)

После того, как данные из файла были импортированы, документ Зарплатная ведомость

открывается в режиме редактирования, что позволяет внести необходимые изменения или дополнения. После редактирования следует сохранить документ.

Page 19: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

19

3. Экспорт Структура и примеры файлов экспорта в формате iBank2 В формате iBank2 есть возможность экспортировать следующие типы документов:

· Справочник корреспондентов; · Справочник бенефициаров.

Файлы экспорта в формате iBank2 – это текстовые файлы, содержащие в себе следующие элементы:

· В самом начале файла должно указываться определение вида документа импортируемого документа или справочника: пара значений Content-Type=<вид документа> (для справочника корреспондентов это поле имеет название Content-Type=ref/recipient, для справочника бенефициаров - Content-Type=ref/beneficiar).

· Между определением вида документа и блоками пар значений должен обязательно присутствовать перевод строки.

· Основная часть файла состоит из пар значений: <наименование поля>=<значение поля>. Для каждого справочника будет указываться количество пар значений <наименование поля>=<значение поля>, которые были внесены в систему «Клиент-банк».

Описание полей для файла экспорта справочника корреспондентов указано в пункте Импорт записей справочника корреспондентов.

Описание полей для файла экспорта справочника бенефициаров указано в пункте Импорт записей справочника бенефициаров.

Ниже приведены примеры файлов экспорта данных справочников: Корреспондент: Content-Type=ref/recipient RCPT_INN=22485297 RCPT_NAME=Одеська дирекція УДППЗ "Укрпошта" RCPT_ACCOUNT=26002012 RCPT_BANK_BIC=328351 PAYMENT_DETAILS=Оплата за доставку почты Бенефициар: Content-Type=ref/beneficiar RCPT_NAME=TOWERHILL MANAGEMENT LTD RCPT_ACCOUNT=CY23018000030000201100058227 INTERMED_BNK_NAME=EFG EUROBANK ERGASIAS S.А INTERMED_BNK_BIC=EFGBGRAA INTERMED_BNK_BIC_TYPE=SWIFT INTERMED_BNK_COUNTRY_CODE=300 INTERMED_BNK_COUNTRY=GREECE INTERMED_BNK_CITY=Athens INTERMED_BNK_ADDR= RCPT_BNK_NAME=Eurobank EFG Cyprus Ltd. RCPT_BNK_ACCOUNT=201100058227 RCPT_BNK_BIC=EFGBCY2N RCPT_BNK_BIC_TYPE=SWIFT RCPT_BNK_COUNTRY_CODE=196 RCPT_BNK_COUNTRY=CYPRUS RCPT_BNK_CITY=Nicosia RCPT_BNK_ADDR=41 Arch. Makarioc Avenue RCPT_COUNTRY_CODE=092 RCPT_COUNTRY=VIRGIN ISLANDS, BRITISH

Page 20: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

20

RCPT_CITY=Road Town RCPT_ADDR=Mill Mall Tower, 2-nd Floor, Wickha Описание настроек ПО «Клиент-Банк» для экспорта файлов формата iBank2

Для правильного

экспорта файлов формата iBank2 в системе «Клиент-Банк» необходимо провести настройки системы, чтобы это сделать необходимо зайти в пункт меню «Сервис» «Настройки», как показано на рисунке 2.1.

В открывшемся окне необходимо выбрать перейти на вкладку «Обмен данными», блок «Экспорт», в котором необходимо выбрать следующие параметры:

«Формат» – необходимо выбрать «iBank2»

«Каталог» – прописывается путь к папке, в которую будут выгружаться файлы экспорта документа.

«Кодировка» – выбор кодировки импортируемого файла (можно не редактировать). Пример показан на рисунке 3.1. После установки всех необходимых настроек в «Клиент-Банке» необходимо в дереве

документов выбрать тип документа, который необходимо экспортировать и нажать на кнопку

«Экспорт» или выбрать пункт меню «Документы» «Экспорт». После нажатия этой кнопки откроется окно, в котором необходимо задать имя файла экспорта. Аналогично система настраивается для других форматов.

Структура и примеры файлов экспорта в формате Profix Формат Profix используется только для экспорта выписок из системы «Клиент-банк». По умолчанию, выписки экспортируются в файл с именем export.dbf, при этом клиент не имеет

возможности изменить имя файла. При каждом новом экспорте файл перезаписывается. Для правильного отображения данных необходимо использовать кодировку Ср-1125. Наименование полей всегда отображается в верхнем регистре. Описание полей файла экспорта в формате Profix приведено в таблице 3.1.

Таблица 3.1 (Описание полей файла экспорта формата Profix)

Наименование Описание

MFO МФО банка плательщика

MFO_NM Наименование банка плательщика

KL_NM Наименование плательщика

KL_OKP Код ЕГРПОУ плательщика

KL_CHK Текущий счет плательщика

CUR_ID Идентификатор валюты счета (в числовом формате «ХХХ»)

MFO_K МФО банка получателя

MFO_NM_K Наименование банка получателя

KL_NM_K Наименование получателя

KL_OKP_K Код ЕГРПОУ получателя

CL_CHK_K Текущий счет получателя

ND Номер документа

DK Признак платежа по дебету или кредиту (1 – дебет, 2 – кредит)

Рис. 3.1 (Пример настроек экспорта файла в формате iBank2)

Page 21: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

21

Таблица 3.1 (Продолжение)

Наименование Описание

VOB Служебное поле (по умолчанию 1)

S Сумма платежа

DATA Дата операции в формате ДД.ММ.ГГ

DATA_S Дата операции в формате ДД.ММ.ГГ

TIME_S Время операции в формате ЧЧ.ММ

ADATEOPL Дата документа в формате ДД.ММ.ГГ

N_P Назначение платежа

Ниже находится пример файла экспорта формата Profix:

Структура и примеры файлов экспорта в формате BM RS Файл экспорта в формате BM RS представляет собой текстовый файл определенной структуры,

созданный в кодировке CP-866 (DOS). Наименование файла экспорта определяется датой операции по счету, за которую составляется

выписка. Наименование файлов имеет вид vГГММДД.zzz, где: · v – постоянный префикс файла, содержащего выписки; · ГГММДД – дата операции по счету (ГГ – год, ММ – месяц, ДД – день); · zzz – постоянное расширение файла указанного содержания.

Код валюты для выписок по счетам в гривне и для выписок по счетам в валюте – символьный. Файл экспорта состоит из неопределенного количества строк, разделенных символами 0x0D

0x0A, минимальное количество строк – 1. Все строки имеют кроме описанных для них полей 0-е квалификационное поле: 0 – оборотно-сальдовая строка, в которой представлены данные о счете клиента, по которому

сформирована выписка, а также суммах, прошедших по дебету и по кредиту по данному счету; 1 – платежная строка, предоставляет подробную информацию об операциях по счету (может

принимать значения «1+» – кредит, «1-» – дебет). В таблице 3.2 указано описание полей оборотно-сальдовой строки.

Page 22: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

22

Таблица 3.2 (описание полей оборотно-сальдовой строки)

№ поля Ширина Пример Описание

1 6 322904 МФО счета по которому сформирована выписка

2 14 290991144276 Счет, по которому сформирована выписка, если счет менее 14 символов, то он выравнивается по левому краю поля и до конца поле заполняется пробелами до 14 символов.

3 3 UAH Символьный код валюты счета

4 8 20121217 Дата описываемого движения по счету в формате ГГГГММДД

5 8 20121213 Дата предыдущего движения по счету в формате ГГГГММДД

6 19 5186269 Остаток на начало дня, указывается в копейках

7 1 + или - Тип остатка: «+» - пассивный, «-» - активный

8 6 1 Количество документов прошедших по списанию

9 19 5041000 Сумма дебетовых оборотов (документов прошедших по списанию)

10 6 0 Количество документов прошедших по зачислению

11 19 0 Сумма кредитовых оборотов (документов, прошедших по зачислению)

12 19 145269 Остаток на конец дня

13 1 + или - Тип остатка «+» - пассивный, «-» - активный

14 10 04937956 Код ЕГРПОУ владельца счета

15 40 Тест "КРД" Наименование компании

Все суммы остатков в файле экспорта всегда положительные числа, указанные в копейках.

Отрицательный или положительный остаток задается полями «тип остатка». В таблице 3.3 указано описание полей платежной строки.

Таблица 3.3 (Описание полей платежной строки)

№ поля

Ширина Пример Описание

1 1 + или - Если платеж прошел по дебету ставится «-», по кредиту – «+»

2 6 322904 МФО банка плательщика

3 14 290991144276

Текущий счет плательщика, если счет состоит менее 14 символов, то он выравнивается по левому краю поля и до конца поле заполняется пробелами до 14 символов

4 10 04937956 Код ЕГРПОУ плательщика

5 40 Тест "КРД" Наименование плательщика

6 6 322904 МФО банка получателя

7 14 26256322904

Счет получателя платежа, если счет состоит менее 14 символов, то он выравнивается по левому краю поля и до конца поле заполняется пробелами до 14 символов

8 10 23494105 Код ЕГРПОУ получателя платежа

9 40 КРД АТ"РАЙФФАЙЗЕН БАНК

АВАЛЬ"М.КИЇВ Наименование получателя платежа

10 2 01 Вид платежа

11 10 44/3 Операционный номер платежа

12 19 5041000 Сумма платежа в гривнах

13 19 5041000 Сумма платежа в валюте счета

14 8 20121217 Дата отправки платежа банком плательщика

15 8 20121217 Дата получения платежа банком получателя

16 255

/PB01BIFIT_BO087_20121217_112907.352/ Зарахування коштів - Заробiтна плата та

аванси на СКР працівників Відділ культури Переяслав-Хм. міськради згідно

відомостІ № 44 від 13.12.2012

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

Page 23: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

23

Ниже приведен пример файла экспорта гривневой выписки за 17 декабря 2012. Для предоставления файла в данном документе строки разбиты на несколько частей. Наименование файла v121217.zzz.

Оборотно-сальдовая строка 0 322904290991144276 UAH2012121720121213 0 5186269+ 1 0 5041000 0 0 0 0 145269+ 04937956 Тест "КРД"

Платежная строка 1- 322904290991144276 04937956Тест "КРД" 32290426256322904 23494105КРД АТ"РАЙФФАЙЗЕН БАНК АВАЛЬ"М.КИ°В 01 44/3 5041000 504100020121217 20121217 /PB01BIFIT_BO087_20121217_112907.352/ Зарахування коштів - Заробiтна плата та аванси на СКР працівників Відділ культури Переяслав-Хм. міськради згідно відомості № 44 від 13.12.2012

Структура и примеры файлов экспорта в формате файл с разделителями CSV Система «Клиент-банк» позволяет экспортировать данные по оборотам, выпискам,

сотрудникам и справочнику курсов валют в формате csv. Файл данного формата можно просмотреть, например, в Microsoft Excel.

Наименование файла задается пользователем при экспорте данных. Файл экспорта сохраняется в директорию по пути, указанному в настройках.

Ниже приведены примеры содержания файлов экспорта данных документов в формате файл с разделителями csv.

Оборотно-сальдовая ведомость

Выписка

Page 24: Р ИМПОРТОМ И ЭКСПОРТОМ В СИСТЕМЕ IBANK2UA … · cln_bank_mfo string (6) Да МФО банка плательщика cln_country_code string (3) Нет

24

Справочник сотрудников

Справочник курсов валют

Экспорт справочника сотрудников в формате банк-клиент Система «Клиент-банк» позволяет экспортировать данные из справочника сотрудников в dbf-

файл. Файл данного формата можно просмотреть, например, в Microsoft Excel. Наименование файла экспорта справочника сотрудников формируется следующим образом:

0NNNN.dbf, где NNNN – внешний ID клиента (если внешний ID клиента не указан, то наименование файла будет 0000.dbf). Файл экспорта сотрудников сохраняется в папку по пути указанному в настройках «Клиент-Банка».

Экспортированный справочник сотрудников содержит в себе следующие поля (Таблица 3.4). Таблица 3.4 (Описание полей файла экспорта справочника сотрудников)

Номер поля

Наименование поля Описание поля

1 ACCT_CARD Карточный счет сотрудника

2 FIO ФИО сотрудника

3 ID_CODE Идентификационный код сотрудника

4 SUMA Сумма зачислений. Значение данного поля в файле экспорта всегда 0,00

Пример содержания файла экспорта справочника сотрудников в формате банк-клиент

представлено ниже: