iFOBS.eSalary Підсистема перерахування коштів на банківські
картки співробітників підприємства
Опис форматів файлів
імпорту та експорту
Версія Б2 3.37.Х.Х
Версія iFOBS 2.1.7.X
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 2 из 83
ЗМІСТ
1. ВСТУП ...................................................................... 4
1.1. Ідентифікація документу ......................................... 4
1.2. Таблиці форматів ..................................................... 4
1.3. Розшифрування типу даних ..................................... 5
2. ФОРМАТИ ФАЙЛІВ ІМПОРТУ ТА ЕКСПОРТУ В IFOBS.ESALARY ................................................................. 6
2.1. Імпорт даних про співробітників ............................. 6
2.1.1. Імпорт з XML-файлу .................................................. 6
2.1.2. Імпорт з XML-файлу (eFOUR) ................................... 9
2.1.3. Імпорт з DBF-файлу ................................................ 13
2.1.4. Імпорт з DBF-файлу (eFOUR) .................................. 16
2.1.5. Імпорт з XLS-файлу ................................................ 19
2.1.6. Імпорт з CSV-файлу ................................................ 22
2.2. Імпорт зарплатної відомості .................................. 24
2.2.1. Імпорт з XML-файлу ................................................ 24
2.2.2. Імпорт з DBF-файлу ................................................ 27
2.2.3. Імпорт з XLS-файлу ................................................ 29
2.2.4. Імпорт з текстового файлу 1С ................................ 31
2.3. Імпорт нарахувань по зарплатній відомості .......... 33
2.3.1. Імпорт з XLS-файлу ................................................ 33
2.3.2. Імпорт з текстового файлу ..................................... 33
2.3.3. Імпорт з DBF-файлу ................................................ 34
2.4. Імпорт/експорт розрахункових листів .................. 35
2.4.1. Імпорт з текстового файлу ..................................... 35
2.4.2. Експорт до текстового файлу ................................. 35
2.5. Експорт даних про співробітників.......................... 35
2.5.1. Експорт до XML-файлу ............................................ 35
2.5.2. Експорт до XLS-файлу ............................................. 39
2.5.3. Експорт до TXT-файлу ............................................. 41
2.5.4. Експорт до HTML-файлу .......................................... 43
2.5.5. Експорт реєстру звільнених співробітників ........... 45
2.6. Експорт даних про рахунки співробітників ........... 46
2.6.1. Експорт до DBF-файлу ............................................ 46
2.6.2. Експорт до CSV-файлу ............................................ 46
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 3 из 83
3. ФОРМАТИ ФАЙЛІВ ІМПОРТУ ТА ЕКСПОРТУ, ВИКОРИСТОВУВАНІ В АБС Б2 ........................................ 48
3.1. Імпорт даних про співробітників ........................... 48
3.1.1. Імпорт з XML-файлу ................................................ 48
3.1.2. Імпорт з TXT-файлу (Майстер підключення) ......... 51
3.2. Імпорт даних про рахунки співробітників ............. 52
3.2.1. Імпорт з XML-файлу ................................................ 52
3.2.2. Імпорт з DBF-файлу, сформованого модулем BCZ Card v.3.0 53
3.3. Експорт даних про співробітників.......................... 54
3.3.1. Експорт для вивантаження до системи «Transmaster» ............................................................................ 54
3.3.2. Експорт до XML–файлу ........................................... 62
3.3.3. Експорт до формату IS-Card ................................... 64
3.3.4. Експорт до DBF-файлу для модуля BCZ Card .......... 74
3.3.5. Експорт до XML–файлу (Transfer Project) .............. 77
3.4. Експорт платіжного файлу ..................................... 79
3.4.1. Експорт до XML-файлу ............................................ 79
3.4.2. Експорт для вивантаження до IS-Card (P-файл) ... 81
3.4.3. Експорт до DBF-файлу (структура №1) .................. 82
3.4.4. Експорт до DBF-файлу (структура №2) .................. 83
3.4.5. Експорт до DBF-файлу (структура №3) .................. 83
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 4 из 83
1. ВСТУП
1.1. Ідентифікація документу
У цьому документі знаходиться докладний опис форматів файлів імпорту та експорту, які використовуються при роботі з підсистемою iFOBS.eSalary.
1.2. Таблиці форматів
Нижче наведено таблицю, використовуючи яку ви можете перейти безпосередньо
до опису потрібного формату - для цього слід перейти за посиланням з номером відповідного розділу:
Формати файлів у iFOBS.eSalary
Підсистема / Формат
XML XML (eFOUR)
DBF DBF (eFOUR)
XLS CSV TXT/
HTML
Імпорт даних про
співробітників
2.1.1
2.1.2
2.1.3
2.1.4
2.1.5
2.1.6
Імпорт зарплатної відомості
2.2.1
2.2.2
2.2.3
Імпорт нарахувань по зарплатній
відомості
2.3.3
2.3.1
2.3.2
Імпорт розрахункових листів
2.4.1
Експорт даних про співробітників
2.5.1
2.5.2
2.5.3
Експорт даних
про рахунки співробітників
2.6.1
Також у таблиці ви можете побачити, в якому клієнтському додатку є доступним кожен формат:
– Windows-додаток;
- Web-додаток.
Формати файлів в АБС Б2
Підсистема / Формат XML DBF (BCZ Card)
DBF IS-Card “Trans-master”
TXT
Імпорт даних про 3.1.1 3.1.2
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 5 из 83
Підсистема / Формат XML DBF (BCZ Card)
DBF IS-Card “Trans-master”
TXT
співробітників
Імпорт даних про рахунки
співробітників
3.2.1 3.2.2
Експорт даних про співробітників
3.3.2
3.3.5
3.3.4 3.3.3 3.3.1
Експорт платіжного файлу 3.4.1 3.4.3 3.4.4 3.4.2
1.3. Розшифрування типу даних
Стовпчик «Тип даних» у таблицях визначає структуру даних та може набувати таких значень:
Значення Опис
C Поле містить рядкове значення, вирівняне по лівому краю
N Поле містить ціле число без провідних нулів, вирівняне по правому краю
D Поле містить дату в форматі YYMMDD (дві цифри року, місяця та дня,
відповідно)
T Поле містить час у форматі HHMMSS (дві цифри години, від 1 до 24, хвилини та секунди, відповідно)
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 6 из 83
2. ФОРМАТИ ФАЙЛІВ ІМПОРТУ ТА ЕКСПОРТУ В iFOBS.eSalary
2.1. Імпорт даних про співробітників
2.1.1. Імпорт з XML-файлу
Файл імпорту даних про співробітників підприємства містить інформацію про підприємства клієнта та його співробітників і формується з бухгалтерської програми клієнта. Імпорт виконується з файлів у форматі ANSI.
Приклад:
<?xml version="1.0" encoding="windows-1251"?>
<DATAPACKET Version="2.0">
<ENTERPRISEINFO NAME="ООО 'Фірма'" IDENTIFYCODE="12345678"
NALOGREGISTERDATE="01/01/2005" NALOGREGISTERNO="" ADDRESS="Місто, вулиця,
дім" CONTACTPHONES="01, 02, 03" CONTACTINFO="Петя" FAX="-" EMAIL="-">
<EMPLOYEES>
<EMPLOYEE ID="1" IDENTIFYCODE="1234567890" LASTNAME="Прізвище"
FIRSTNAME="Ім’я" MIDDLENAME="По батькові" EMBOSSIGLI="FAMILIA" SEX="Ж"
PASSPORTNO="ББ111111" PASSPORTISSUEDATE="01/01/2000"
PASSPORTISSUEPLACE="РОГУ МВД У" BIRTHDAY="01/01/1980" BIRTHPLACE="Город"
CITIZENSHIP="804" ADDRESS="Город, улица, дом" ADDR_COUNTRYID="804"
ADDR_POSTCODE="61000" ADDR_REGION="Область" ADDR_DISTRICT="Район"
ADDR_CITY="Город" ADDR_STREET="Улица" ADDR_HOUSENO="01" ADDR_FLAT="01"
JURADDR_COUNTRYID="804" JURADDR_POSTCODE="61000"
JURADDR_REGION="Область" JURADDR_DISTRICT="Район" JURADDR_CITY="Город"
JURADDR_STREET="Улица" JURADDR_HOUSENO="01" JURADDR_FLAT="01"
ACCEPTANCEDATE="01/01/2008" HOMEPHONE="+380571112233"
WORKPHONE="+380574445566" MOBILEPHONE="+380507778899" />
…
</EMPLOYEES>
</ENTERPRISEINFO>
</DATAPACKET>
№ Найменування поля Призначення/опис Тип
даних
Довжи
на поля
О/З
Інформація про підприємство містить наступні значення
1. NAME
(*при імпорті не враховується)
Назва підприємства.
Якщо потрібні подвійні лапки ", їх слід замінити на ' або "
C 30 -
2. IDENTIFYCODE Ідентифікаційний код підприємства N 10 -
3. NALOGREGISTERDATE
Дата реєстрації підприємства у податковій (у форматі ДД/ММ/РРРР)
D 8 -
4. NALOGREGISTERNO Номер реєстрації підприємства у N 10 -
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 7 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
податковій
5. ADDRESS Повна адреса підприємства.
Якщо поле не заповнено або в ньому встановлений прочерк (знак
мінус "-"), тоді при збереженні запису про співробітника в адресі буде зазначено «Не визначено»
C 254 -
6. CONTACTPHONES Номер контактного телефону підприємства
C 20 -
7. CONTACTINFO Контактна інформація C 200 -
8. FAX Номер факсу підприємства C 20 -
9. EMAIL Адреса електронної пошти підприємства
C 100 -
Інформація про співробітників містить такі значення
10. ID Порядковий номер співробітника N 10 -
11. IDENTIFYCODE Ідентифікаційний код співробітника N 10 +
12. LASTNAME Прізвище співробітника С 38 +
13. FIRSTNAME Ім’я співробітника С 38 +
14. MIDDLENAME По батькові співробітника С 38
15. EMBOSSIGLI Транслітерація прізвища та імені співробітника для нанесення на картку. Альтернативний варіант
написання цього поля EMBOSSINGLIT дозволяє замінювати
деякі параметри співробітника, якщо він вже був внесений
С 26
16. SEX Стать співробітника (M або F) C 1
17. PASSPORTNO Номер паспорта співробітника старого зразка в форматі ББ999999
або нового зразка в форматі 123456789 для резидентів
С 25 +
18. PASSPORTISSUEDAT
E
Дата видачі паспорта співробітника
в форматі ДД/ММ/РРРР
D 8
19. PASSPORTISSUEPLA
CE
Місце видачі паспорта співробітника C 120
20. BIRTHDAY Дата народження співробітника в
форматі ДД/ММ/РРРР
D 8
21. BIRTHPLACE Місце народження співробітника C 60
22. CITIZENSHIP Код країни громадянства співробітника (для України 804)
N 3
23. ADDRESS Повна домашня адреса
співробітника. Якщо заповнюється це поле, тоді всі
інші поля, що стосуються адреси співробітника (25-32), можна не зазначати.
Примітка. Можливість зазначення адреси в даному полі регулюється внутрішніми налаштуваннями банку
С 254
24. JURADDRESS Повна адреса розсилки. Якщо заповнюється це поле, тоді всі
інші поля, що стосуються адреси розсилки (33-40), можна не зазначати.
Примітка. Можливість зазначення адреси в даному полі регулюється
внутрішніми налаштуваннями банку
С 254
25. ADDR_COUNTRYID Цифровий код країни домашньої адреси співробітника
N 3
26. ADDR_POSTCODE Поштовий індекс домашньої адреси C 6
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 8 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
співробітника
27. ADDR_REGION Область домашньої адреси
співробітника
С 40
28. ADDR_DISTRICT Район домашньої адреси
співробітника
C 40
29. ADDR_CITY Населений пункт домашньої адреси
співробітника
C 40
30. ADDR_STREET Вулиця домашньої адреси співробітника
C 40
31. ADDR_HOUSENO Номер будинку домашньої адреси співробітника
C 10
32. ADDR_FLAT Номер квартири домашньої адреси співробітника
C 10
33. JURADDR_COUNTRYID
Адреса для кореспонденції. Цифровий код країни
N 3
34. JURADDR_POSTCOD
E
Адреса для кореспонденції.
Поштовий індекс
C 6
35. JURADDR_REGION Адреса для кореспонденції.
Найменування області
С 40
36. JURADDR_DISTRICT Адреса для кореспонденції.
Найменування району
C 40
37. JURADDR_CITY Адреса для кореспонденції. Населений пункт
C 40
38. JURADDR_STREET Адреса для кореспонденції. Вулиця
C 40
39. JURADDR_HOUSENO Адреса для кореспонденції. Номер дома
C 10
40. JURADDR_FLAT Адреса для кореспонденції. Номер квартири
C 10
41. ACCEPTANCEDATE Дата прийому співробітника на
роботу в форматі ДД/ММ/РРРР
D 8
42. HOMEPHONE Домашній телефон співробітника в
форматі +380999999999 (обов'язково повинен бути зазначений хоча б один телефон -
домашній, мобільний або робочий)
C 30
43. WORKPHONE Робочий телефон співробітника в
форматі +380999999999 (обов'язково повинен бути зазначений хоча б один телефон -
домашній, мобільний або робочий)
C 30
44. MOBILEPHONE Мобільний телефон співробітника в
форматі +380999999999 (обов'язково повинен бути зазначений хоча б один телефон -
домашній, мобільний або робочий)
C 30
45. TABNO Табельний номер співробітника.
Заповнюється в таблиці прив’язки співробітника до номера підприємства
С 15 -
46. JOB Займана посада. Заповнюється в таблиці прив'язок співробітника до
номера підприємства (параметр «Деталі»)
C 40 -
47. EMAIL Електронна пошта співробітника C 60
48. SECURITYQUESTION Секретне питання C 60
49. SECURITYANSWER Секретна відповідь C 60
50. RESIDENTCOUNTRYID
Цифровий код країни резидентності N 3
51. REGBYSELFBUSY Ознака того, що співробітник «Зареєстрований як самозайнята
N 1
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 9 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
ФО»: 0 – ні
1 – так
52. RESIDENTTYPEID Резидентність (K030):
1- резидент,
2 – нерезидент.
Якщо поле не заповнено, за умовчанням в анкету співробітника
підставляється значення «1-
резидент»
N 1
53. PASSPORTCHIP Ознака наявності чіпу в паспорті
нового зразка:
0 - ні
1 - так
Примітка. Можливість задавати
значення в даному полі є додатковою функціональністю і регулюється окремими
налаштуваннями банку
N 1
54. PASSPORTLASTDATE
Дата закінчення терміну дії паспорта нового зразка (ID карти) в форматі
ДД/ММ/РРРР
Примітка. Можливість задавати значення в даному полі є
додатковою функціональністю і регулюється окремими
налаштуваннями банку
D 8
55. PASSPORTRECNO Унікальний номер запису в
демографічному реєстрі ФО
Примітка. Можливість задавати
значення в даному полі є додатковою функціональністю і
регулюється окремими
налаштуваннями банку
С 14
Примітка. Обов'язковість заповнення полів, що не позначені в таблиці як обов'язкові або необов'язкові, регулюється внутрішніми налаштуваннями банку.
Зразки файлів додаються до комплекту документації (див. «2.1.1.Import_Employees.xml»).
2.1.2. Імпорт з XML-файлу (eFOUR)
Файл імпорту даних про співробітників підприємства містить інформацію про підприємства клієнта та його співробітників і формується з бухгалтерської програми клієнта. Імпорт виконується з файлів у форматі ANSI.
Приклад:
<?xml version="1.0" encoding="WINDOWS-1251"?>
<DATAPACKET>
<ENTERPRISEINFO SNAME="Umbr" IDENTIFYCODE="04591423"
NALOGREGISTERDATE="20081101" NALOGREGISTERNO="2345124" ADDRESS="45899,
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 10 из 83
Київська обл., м. Київ, вул.Оболонська, 34" CONTACTPHONES="" CONTACTINFO=""
FAX="" EMAIL=""
<EMPLOYEES>
<EMPLOYEE ID="103" IDENTIFYCODE="3333211117"
LASTNAME="БайнанэКлондва" FIRSTNAME="Ім’я" MIDDLENAME="Прізвище"
PASSPORTNO="мм333327" PASSPORTISSUEDATE="11.11.2007"
PASSPORTISSUEPLACE="Харків" BIRTHDAY="05.04.1991" ADDR_COUNTRYID="804"
ADDR_POSTCODE="12332" ADDR_REGION="Харківська область" ADDR_CITY="c.
Зайцеве" ADDR_DISTRICT="Харківський р-н" ADDR_STREET="Домашня вулиця"
ADDR_HOUSENO="3" ADDR_FLAT="1" JURADDR_COUNTRYID="804"
JURADDR_POSTCODE="61400" JURADDR_REGION="Харківська обл."
JURADDR_CITY="Дергачі" JURADDR_DISTRICT="Дергачівський район"
JURADDR_STREET="Поштова вулиця" JURADDR_HOUSENO="5" JURADDR_FLAT="6"
EMBOSSIGLI="BAINANE NAME" SEX="М" BIRTHPLACE="Место рождения"
CITIZENSHIP="804" HOMEPHONE="11111" WORKPHONE="2222222"
MOBILEPHONE="3333333" ADDRESS="Дом. адрес, одной строкой, 30 10"
JURADDRESS="Корр. адрес, одной строкой, 50 60" RESIDENTTYPEID="1"
ADDR_REGIONID="5" JURADDR_REGIONID="1" RESIDENTCOUNTRYID="804"
HOMECOUNTRYPHONECODE="380" HOMEZONEPHONECODE="5555"
WORKCOUNTRYPHONECODE="840" WORKZONEPHONECODE="55"
MOBILCOUNTRYPHONECODE="643" MOBILEZONEPHONECODE="66"
ACCEPTANCEDATE="11.11.2005" TABNO="123"/>
</EMPLOYEES>
</ENTERPRISEINFO>
</DATAPACKET>
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
Інформація про підприємство містить такі значення:
1. SNAME
(*при імпорті не
враховується)
Назва підприємства.
Якщо потрібні подвійні лапки ", їх
слід замінити на ' або "
C 30 -
2. IDENTIFYCODE Ідентифікаційний код підприємства N 10 -
3. NALOGREGISTERDAT
E
Дата реєстрації підприємства у
податковій (в форматі ДД/ММ/РРРР)
D 8 -
4. NALOGREGISTERNO Номер реєстрації підприємства у
податковій
N 10 -
5. ADDRESS Повна адреса підприємства.
Якщо поле не заповнено або в
ньому встановлений прочерк (знак мінус «-»), тоді при збереженні запису про співробітника в адресі
буде вказано значення «Не
C 254 -
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 11 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
визначено»
6. CONTACTPHONES Номер контактного телефону
підприємства C 20 -
7. CONTACTINFO Контактна інформація C 200 -
8. FAX Номер факсу підприємства C 20 -
9. EMAIL Адреса електронної пошти
підприємства C 100 -
Інформація про співробітників містить такі значення
10. ID Порядковий номер співробітника N 10 -
11. IDENTIFYCODE Ідентифікаційний код співробітника N 10 +
12. LASTNAME Прізвище співробітника С 38 +
13. FIRSTNAME Ім’я співробітника С 38 +
14. MIDDLENAME По батькові співробітника С 38
15. EMBOSSIGLI Транслітерація прізвища та імені
співробітника для нанесення на картку. Альтернативний варіант написання цього поля
EMBOSSINGLIT дозволяє замінювати деякі параметри співробітника,
якщо він вже був внесений
С 26
16. SEX Стать співробітника (M або F) C 1
17. PASSPORTNO Номер паспорта співробітника в
форматі ББ999999 для резидентів С 25 +
18. PASSPORTISSUEDATE Дата видачі паспорта співробітника
в форматі ДД/ММ/РРРР D 8
19. PASSPORTISSUEPLAC
E
Місце видачі паспорта співробітника C 120
20. BIRTHDAY Дата народження співробітника в
форматі ДД/ММ/РРРР
D 8
21. BIRTHPLACE Місце народження співробітника C 60
22. CITIZENSHIP Код країни громадянства
співробітника (для України 804) N 3
23. ADDRESS Повна домашня адреса
співробітника. Якщо заповнюється це поле, тоді всі інші поля, що стосуються адреси
співробітника (25-32), можна не зазначати.
Примітка. Можливість зазначення адреси в даному полі регулюється
внутрішніми налаштуваннями банку
С 254
24. JURADDRESS Повна адреса розсилки.
Якщо заповнюється це поле, тоді всі
інші поля, що стосуються адреси розсилки (33-40), можна не
зазначати. Примітка. Можливість зазначення адреси в даному полі регулюється
внутрішніми налаштуваннями банку
С 254
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 12 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
25. ADDR_COUNTRYID Цифровий код країни домашньої
адреси співробітника N 3
26. ADDR_POSTCODE Поштовий індекс домашньої адреси
співробітника
C 6
27. ADDR_REGIONID Цифровий код області домашньої
адреси співробітника з довідника
областей
N 2
28. ADDR_REGION Область домашньої адреси
співробітника С 40
29. ADDR_DISTRICT Район домашньої адреси
співробітника
C 40
30. ADDR_CITY Населений пункт домашньої адреси
співробітника
C 40
31. ADDR_STREET Вулиця домашньої адреси
співробітника C 40
32. ADDR_HOUSENO Номер дома домашньої адреси
співробітника C 10
33. ADDR_FLAT Номер квартири домашньої адреси
співробітника C 10
34. JURADDR_COUNTRYI
D Адреса для кореспонденції.
Цифровий код країни
N 3
35. JURADDR_POSTCODE Адреса для кореспонденції.
Поштовий індекс
C 6
36. JURADDR_REGIONID Адреса для кореспонденції.
Цифровий код області з довідника
областей
N 2
37. JURADDR_REGION Адреса для кореспонденції.
Найменування області
С 40
38. JURADDR_DISTRICT Адреса для кореспонденції.
Найменування району
C 40
39. JURADDR_CITY Адреса для кореспонденції.
Населений пункт
C 40
40. JURADDR_STREET Адреса для кореспонденції.
Вулиця
C 40
41. JURADDR_HOUSENO Адрес для кореспонденції.
Номер дома
C 10
42. JURADDR_FLAT Адреса для кореспонденції.
Номер квартири
C 10
43. ACCEPTANCEDATE Дата прийому співробітника на
роботу в форматі ДД/ММ/РРРР D 8 -
44. HOMECOUNTRYPHON
ECODE
Код країни для домашнього
телефону співробітника
С 5
45. HOMEZONEPHONECO
DE
Код міста для домашнього телефону
співробітника
С 5
46. HOMEPHONE Домашній телефон співробітника
(обов'язково повинен бути
зазначений хоча б один телефон -
домашній, мобільний або робочий)
C 30
47. WORKCOUNTRYPHON
ECODE
Код країни для робочого телефону
співробітника С 5
48. WORKZONEPHONECO Код міста для робочого телефону С 5
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 13 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
DE співробітника
49. WORKPHONE Робочий телефон співробітника
(обов'язково повинен бути зазначений хоча б один телефон -
домашній, мобільний або робочий)
C 30
50. MOBILCOUNTRYPHON
ECODE
Код країни для мобільного телефону
співробітника С 5
51. MOBILEZONEPHONEC
ODE
Код оператора для мобільного
телефону співробітника
С 5
52. MOBILEPHONE Мобільний телефон співробітника
(обов'язково повинен бути
зазначений хоча б один телефон -
домашній, мобільний або робочий)
C 30
53. TABNO Табельний номер співробітника.
Заповнюється в таблиці прив’язки
співробітника до номера
підприємства
С 15 -
54. RESIDENTCOUNTRYI
D Цифровий код країни резидентності N 3
55. RESIDENTTYPEID Резидентність (К030) N 1
56. EMAIL Електронна пошта співробітника C 60
Примітка. Обов’язковість заповнення полів, що не позначені в таблиці як обов’язкові або необов’язкові, регулюється внутрішніми налаштуваннями банку.
Зразки файлів додаються до комплекту документації (див. «2.1.2.Import_Employees (eFOUR).xml»).
2.1.3. Імпорт з DBF-файлу
Файл імпорту даних про співробітників підприємства містить інформацію про співробітників клієнта та формується з бухгалтерської програми клієнта або на боці процесінгу.
DBF-файл може імпортуватися в кодуваннях: DOS формату DBASE-IV або Windows-1251. Для коректного відображення українських символів І і Ї ї Ґ ґ має бути використано кодування Windows-1251.
Кожен рядок файлів має фіксовану структуру, описану в таблиці нижче.
№ Найменування поля
Призначення/опис Тип даних
Довжина
поля
О/З
1. BRANCHPART*
(*зараз поле не використовується та
не впливає на імпорт
.dbf файлу)
МФО філії, у якій будуть
обслуговуватися клієнти
N 10 -
2. FIO Прізвище, ім’я та по батькові
співробітника, які введено через один
пробіл. При імпорті має розбиратися на три поля LASTNAME, FIRSTNAME та
MIDDLENAME
C 120 +
3. SEX Стать співробітника.
Заповнюється літрами Ч або Ж
C 1
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 14 из 83
№ Найменування поля
Призначення/опис Тип даних
Довжина
поля
О/З
4. LATFIO Латинська транслітерація прізвища та
імені співробітника, яка ембосується
на міжнародних картках
C 26
5. BIRTHDAY Дата народження співробітника в
форматі DD/MM/YYYY D 8
6. RESIDENT Резидентність (K030):
1- резидент,
2 – нерезидент.
Якщо поле не заповнено, за умовчанням в анкету співробітника
підставляється значення «1-резидент»
N 1
7. PASSPSER Серія паспорта співробітника C 20
8. PASNOM Номер паспорта співробітника C 20 +
9. PASDAT Дата видачі паспорта в форматі
DD/MM/YYYY D 8 +
10. PASPLACE Місце видачі паспорта C 120
11. INN Ідентифікаційний код співробітника C 10 +
12. COUNTRY Домашня адреса. Цифровий код
країни (К040) N 3
13. ZIP Домашня адреса. Поштовий індекс C 6
14. OBL Домашня адреса. Код області країни
співробітника. З довідника областей,
що надає НБУ
N 2
15. RN Домашня адреса. Найменування
району C 40
16. TNP Домашня адреса. Тип населеного
пункту: м., с., смт тощо C 4
17. NP Домашня адреса. Найменування
населеного пункту. При імпорті поля
TNP та NP збираються та зберігаються
в поле населений пункт
C 36
18. STREET Домашня адреса. Вулиця C 40
19. BUILDING Домашня адреса. Дім C 10
20. FLAT Домашня адреса. Квартира C 10
21. PHONE Домашній телефон (обов'язково
повинен бути зазначений хоча б один телефон - домашній, мобільний або
робочий)
C 20
22. MOBPHONE Мобільний телефон (обов'язково
повинен бути зазначений хоча б один телефон - домашній, мобільний або
робочий)
C 20
23. JOBPHONE Робочий телефон (обов'язково
повинен бути зазначений хоча б один телефон - домашній, мобільний або
робочий)
C 20
24. CCOUNTRY Адреса для кореспонденції. Цифровий
код країни N 3
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 15 из 83
№ Найменування поля
Призначення/опис Тип даних
Довжина
поля
О/З
25. CZIP Адреса для кореспонденції. Поштовий
індекс C 6
26. COBL Адреса для кореспонденції. Код
області з довідника областей, що
надає НБУ
N 2
27. CRN Адреса для кореспонденції.
Найменування району C 40
28. CTNP Адреса для кореспонденції. Тип
населеного пункту C 4
29. CNP Адреса для кореспонденції.
Найменування населеного пункту C 36
30. CSTREET Адреса для кореспонденції. Вулиця C 40
31. CBUILDING Адреса для кореспонденції. Дім C 10
32. CFLAT Адреса для кореспонденції.. Квартира C 10
33. ADRESS Повна домашня адреса співробітника.
Якщо заповнюється це поле, тоді всі інші поля, що стосуються адреси співробітника (25-32), можна не
зазначати. Якщо поле не заповнено або в ньому встановлений прочерк (знак мінус "-
"), тоді при збереженні запису про співробітника в адресі буде зазначено
«Не визначено».
Примітка. Можливість зазначення
адреси в даному полі регулюється
внутрішніми налаштуваннями банку
C 254
34. CADRESS Юридична адреса підприємства
співробітника.
Примітка. Можливість зазначення адреси в даному полі регулюється
внутрішніми налаштуваннями банку
C 254
35. TABNOM Табельний номер співробітника.
Заповнюється в таблиці прив’язки
співробітника до номера підприємства
С 15 -
36. JOB Займана посада. Заповнюється в
таблиці прив'язок співробітника до
номера підприємства
C 40 -
37. BIRTHPLACE Місце народження C 60
38. RCOUNTRY Код країни резидентності N 3
39. REGBYSEL Ознака того, що співробітник
«Зареєстрований як самозайнята ФО»:
0 – ні
1 – так
N 1
40. PPCHIP Ознака наявності чіпу в паспорті
нового зразка:
0 - ні
1 - так
Примітка. Можливість задавати значення в даному полі є додатковою функціональністю і регулюється
N 1
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 16 из 83
№ Найменування поля
Призначення/опис Тип даних
Довжина
поля
О/З
окремими налаштуваннями банку
41. PPRECNO Унікальний номер запису в
демографічному реєстрі ФО
Примітка. Можливість задавати значення в даному полі є додатковою
функціональністю і регулюється
окремими налаштуваннями банку
C 14
42. PLASTDAT Дата закінчення терміну дії паспорта
нового зразка (ID карти) в форматі
ДД/ММ/РРРР
Примітка. Можливість задавати
значення в даному полі є додатковою функціональністю і регулюється
окремими налаштуваннями банку
D 8
Примітка. Обов’язковість заповнення полів, що не позначені в таблиці як обов’язкові або необов’язкові, регулюється внутрішніми налаштуваннями банку.
Нижче наведено правила заповнення деяких полів файлу.
1. При імпорті вважаємо, що в разі, якщо інформація про громадянство співробітника відсутня, то прийняття рішення про вибір коду країни здійснюється за таким принципом:
якщо співробітник резидент, то заповнюємо поле громадянства –Україна;
якщо співробітник нерезидент, то аналізуємо коди країн адрес (якщо країна домашньої адреси не Україна, то в якості громадянства вказуємо її, інакше дивимося на країну адреси для кореспонденції - якщо вона не Україна, то підставляємо в якості
громадянства її; якщо країни в обох адресах - Україна, то зазначаємо громадянство <Не визначено>).
2. За дату прийому на роботу зазначаємо дату імпорту файлу.
3. Залежно від налаштувань банку можливо обов'язкове зазначення адреси в
полях ADRESS та CADRESS в наступній послідовності: індекс (за умовчуванням заповнюється «31000»), область, район, населений пункт, вулиця, номер будинку, квартира. Адресні дані розділені сепаратором «;», якщо будь-яке з полів не заповнено, сепаратор «;» все одно ставиться.
4. Номера телефонів імпортуються таким чином:
якщо номер телефону <12 символів, починається на "+380", то він імпортується без змін;
якщо номер телефону <12 символів, починається на "0", то до номера телефону
додається '+38';
якщо номер телефону <12 символів, починається на цифру (крім "0"), то до номера телефону додається '+380';
якщо номер телефону> = 12 символів, то він імпортується без змін
Зразки файлів додаються до комплекту документації (див. «2.1.3.Import_Employees.DBF»).
2.1.4. Імпорт з DBF-файлу (eFOUR)
Файл імпорту даних про співробітників підприємства містить інформацію про співробітників клієнта та формується з бухгалтерської програми клієнта або на боці процесінгу.
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 17 из 83
DBF-файл може імпортуватися в кодуваннях: DOS-формату DBASE-IV або Windows-1251. Для коректного відображення українських символів І і Ї ї Ґ ґ має бути використано кодування Windows-1251.
Кожен рядок файлів має фіксовану структуру, описану в таблиці нижче.
№ Найменування
поля
Призначення/опис Тип
даних
Довжи
на поля
О/З
1. BRANCHPART*
(*зараз поле не використовується та
не впливає на імпорт
.dbf файлу)
МФО філії, у якій будуть
обслуговуватися клієнти
N 10 -
2. FIO Прізвище, ім’я та по батькові
співробітника, які введено через один
пробіл. При імпорті має розбиратися на три поля LASTNAME, FIRSTNAME та
MIDDLENAME
C 120 +
3. SEX Стать співробітника.
Заповнюється літрами Ч або Ж
C 1
4. LATFIO Латинська транслітерація прізвища та
імені співробітника, яка ембосується
на міжнародних картках
C 26
5. BIRTHDAY Дата народження співробітника в
форматі DD/MM/YYYY
D 8
6. RESIDENT Резидентність (K030):
1- резидент,
2 – нерезидент
N 1
7. PASSPSER Серія паспорта співробітника C 20 +
8. PASNOM Номер паспорта співробітника C 20 +
9. PASDAT Дата видачі паспорта в форматі
DD/MM/YYYY
D 8
10. PASPLACE Місце видачі паспорта C 120
11. INN Ідентифікаційний код співробітника C 10 +
12. COUNTRY Домашня адреса. Цифровий код країни
(К040)
N 3
13. ZIP Домашня адреса. Поштовий індекс C 6
14. OBL Домашня адреса. Код області країни
співробітника. З довідника областей,
що надає НБУ
N 2
15. RN Домашня адреса. Найменування
району C 40
16. TNP Домашня адреса. Тип населеного
пункту: м., с., смт тощо C 4
17. NP Домашня адреса. Найменування
населеного пункту. При імпорті поля TNP та NP збираються та зберігаються
в поле населений пункт
C 36
18. STREET Домашня адреса. Вулиця C 40
19. BUILDING Домашня адреса. Дім C 10
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 18 из 83
№ Найменування поля
Призначення/опис Тип даних
Довжина
поля
О/З
20. FLAT Домашня адреса. Квартира C 10
21. HOMECODEC Код країни для домашнього телефону
співробітника
C 5
22. HOMECODEZ Код міста для домашнього телефону
співробітника
C 5
23. PHONE Домашній телефон співробітника
(обов'язково повинен бути зазначений хоча б один телефон - домашній,
мобільний або робочий)
C 20
24. MOBCODEC Код країни для мобільного телефону
співробітника
C 5
25. MOBCODEZ Код оператора для мобільного
телефону співробітника
C 5
26. MOBPHONE Мобільний телефон (обов'язково
повинен бути зазначений хоча б один
телефон - домашній, мобільний або
робочий)
C 20
27. JOBCODEC Код країни для робочого телефону
співробітника
C 5
28. JOBCODEZ Код міста для робочого телефону
співробітника
C 5
29. JOBPHONE Робочий телефон співробітника
(обов'язково повинен бути зазначений хоча б один телефон - домашній,
мобільний або робочий)
C 20
30. CCOUNTRY Адреса для кореспонденції. Цифровий
код країни
N 3
31. CZIP Адреса для кореспонденції. Поштовий
індекс C 6
32. COBL Адреса для кореспонденції. Код області
з довідника областей, що надає НБУ N 2
33. CRN Адреса для кореспонденції.
Найменування району C 40
34. CTNP Адреса для кореспонденції. Тип
населеного пункту C 4
35. CNP Адреса для кореспонденції.
Найменування населеного пункту C 36
36. CSTREET Адреса для кореспонденції. Вулиця C 40
37. CBUILDING Адреса для кореспонденції. Дім C 10
38. CFLAT Адреса для кореспонденції. Квартира C 10
39. ADRESS Повна домашня адреса співробітника.
Якщо заповнюється це поле, тоді всі інші поля, що стосуються адреси співробітника (12-32), можна не
зазначати.
Якщо поле не заповнено або в ньому встановлений прочерк (знак мінус "-"), тоді при збереженні запису про
співробітника в адресі буде зазначено
«Не визначено».
Примітка. Можливість зазначення
C 254
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 19 из 83
№ Найменування поля
Призначення/опис Тип даних
Довжина
поля
О/З
адреси в даному полі регулюється
внутрішніми налаштуваннями банку
40. CADRESS Юридична адреса підприємства
співробітника.
Якщо поле не заповнено або в ньому
встановлений прочерк (знак мінус "-"), тоді при збереженні запису про співробітника в адресі буде зазначено
«Не визначено».
Примітка. Можливість зазначення адреси в даному полі регулюється
внутрішніми налаштуваннями банку
C 254
41. TABNOM Табельний номер співробітника.
Заповнюється в таблиці прив’язки
співробітника до номера підприємства
С 15 -
42. JOB Займана посада. Заповнюється в
таблиці прив'язок співробітника до
номера підприємства
C 40 -
43. BIRTHPLACE Місце народження C 60
Примітка. Обов’язковість заповнення полів, що не позначені в таблиці як
обов’язкові або необов’язкові, регулюється внутрішніми налаштуваннями банку.
При імпорті вважаємо, що в разі, якщо інформація про громадянство співробітника відсутня, то прийняття рішення про вибір коду країни здійснюється за наступним принципом:
якщо співробітник резидент, то заповнюємо поле громадянства – Україна;
якщо співробітник нерезидент, то аналізуємо коди країн адрес (якщо країна домашньої адреси не Україна, то в якості громадянства вказуємо її, інакше дивимося на країну адреси для кореспонденції - якщо вона не Україна, то підставляємо в якості
громадянства її; якщо країни в обох адресах - Україна, то зазначаємо громадянство <Не визначено>).
За дату прийому на роботу зазначаємо дату імпорту файлу.
Зразки файлів додаються до комплекту документації (див. «2.1.4.Import_Employes (eFOUR).dbf»).
2.1.5. Імпорт з XLS-файлу
Файл імпорту даних про співробітників підприємства містить інформацію про співробітників клієнта та формується з бухгалтерської програми клієнта або на боці процесінгу. Файл являє собою таблицю Excel, що складається з однієї вкладки «EMPLOYEES».
Кожен рядок файлів має фіксовану структуру, описану в таблиці нижче.
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
1. GENDER Стать співробітника.
Заповнюється літерами Ч або Ж
C 1
2. NAME Прізвище, ім’я, по батькові
контрагента, що введені через один
пробіл. При імпорті повинно розбиратися на три поля LASTNAME,
FIRSTNAME та MIDDLENAME
C - +
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 20 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
Примітка. Можна ввести необмежену кількість символів, яка
після розбиття на прізвище/ім'я/по батькові буде обрізано до допустимої
довжини відп. полів - по 38 символів
3. EMBOSSING_NAME Латинська транслітерація прізвища
та імені співробітника, яка
ембосується на міжнародних картках
C 26
4. BIRTHDATE Дата народження співробітника в
форматі DD/MM/YYYY
D 8
5. CITY Місце народження співробітника C 40
6. ADDRESS Повна адреса підприємства.
Якщо поле не заповнено або в ньому
встановлений прочерк (знак мінус "-"), тоді при збереженні запису про співробітника в адресі буде
зазначено «Не визначено»
C 254
7. PASSPORT_NUMBER Номер паспорта співробітника C 20 +
8. PASP_SERIES Серія паспорта співробітника C 20 +
9. PASSPORT ISSUER Місце видачі паспорта C 120
10. PASSPORT_ISSUE_DATE
Дата видачі паспорта в форматі DD/MM/YYYY
D 8
11. COUNTRY Код країни прописки N 3
12. CITY_REGISTRATION Місто прописки С 36
13. ZIP Індекс прописки С 6
14. TEL_HOME Контактний номер телефону в
форматі 0671234567 (не повинен
містити пробіли, рисочки, плюси або дужки) Примітка. В файлі експорту номер
телефону вивантажується в форматі +380999999999
С 20
15. CODEWORD Кодове слово для картки.
Примітка. Залежно від налаштування клієнтських місць
SalIsCardTemplates значення зберігається або в поле Кодове
слово в зв'язці «Підприємство-співробітник», або в поле Секретна відповідь в анкеті співробітника
C 20 -
16. ISRESIDENT Чи є співробітник резидентом:
1 – так
2 – ні
N 1 -
17. IDENTIFYCODE Ідентифікаційний номер N 10 +
18. ID_Is_Card ID шаблону угоди в IS-Card N 10 -
19. ID_B2 ID продукту в Б2 N 10 -
20. CURRENCY Код валюти (на цей момент може
буди тільки гривня)
С 3 -
21. DATE_START_WORK Дата прийому співробітника на
роботу в форматі ДД/ММ/РРРР
D 8 -
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 21 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
Домашня адреса
22. Addr_CountryID Країна N 3
23. Addr_Postcode Індекс C 6
24. ADDR_RegionID Область N 10
25. Addr_District Район C 40
26. Addr_City Місто C 40
27. Addr_Street Вулиця C 40
28. Addr_Houseno Дім C 10
29. Addr_Flat Квартира C 10
Адреса для кореспонденції
30. JurAddr_CountryID Країна N 3
31. JurAddr_Postcode Індекс C 6
32. JurAddr_RegionID Область N 10
33. JurAddr_District Район C 40
34. JurAddr_City Місто C 40
35. JurAddr_Street Вулиця C 40
36. JurAddr_Houseno Дім C 10
37. JurAddr_Flat Квартира C 10
38. TABNO Табельний номер співробітника.
Заповнюється в таблиці прив’язки співробітника до номера
підприємства
С 15 -
39. RESIDENTCOUNTRYID
Код країни резидентності N 3
40. JOB Займана посада. Заповнюється в
таблиці прив’язки співробітника до
номера підприємства (параметр «Подробиці»)
C 40
41. REGBYSEL Ознака того, що співробітник
«Зареєстрований як самозайнята ФО»:
0 – ні 1 – так
N 1
42. PASSPORTCHIP Ознака наявності чіпу в паспорті
нового зразка:
0 - ні
1 - так
Примітка. Можливість задавати значення в даному полі є
додатковою функціональністю і
N 1
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 22 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
регулюється окремими
налаштуваннями банку
43. PASSPORTLASTDATE Дата закінчення терміну дії паспорта
нового зразка (ID карти) в форматі
ДД/ММ/РРРР
Примітка. Можливість задавати значення в даному полі є додатковою функціональністю і
регулюється окремими
налаштуваннями банку
D 8
44. PASSPORTRECNO Унікальний номер запису в
демографічному реєстрі ФО
Примітка. Можливість задавати
значення в даному полі є додатковою функціональністю і регулюється окремими
налаштуваннями банку
C 14
Примітка. Обов’язковість заповнення полів, що не позначені в таблиці як обов’язкові або необов’язкові, регулюється внутрішніми налаштуваннями банку.
Зразки файлів додаються до комплекту документації (див. «2.1.5.Import_Employees.xls»).
2.1.6. Імпорт з CSV-файлу
Файл імпорту даних про співробітників підприємства в CSV-форматі містить
інформацію про співробітників підприємства. У якості роздільника використовується «;». Імпорт виконується з файлів у форматі ANSI.
Кожен рядок файлу має фіксовану структуру, описану в таблиці нижче.
№ Найменування поля Призначення/опис Тип даних
Довжина поля
О/З
1. IDENTIFYCODE Ідентифікаційний код співробітника N 10 +
2. LASTNAME Прізвище співробітника С 38 +
3. FIRSTNAME Ім’я співробітника С 38 +
4. MIDDLENAME По батькові співробітника С 38
5. PASSPORTNO Номер паспорта співробітника
старого зразка в форматі ББ999999
або нового зразка в форматі
123456789 для резидентів
С 20 +
6. PASSPORTISSUEDAT
E
Дата видачі паспорта співробітника в
форматі ДД/ММ/РРРР D 8
7. PASSPORTISSUEPLA
CE Місце видачі паспорта співробітника C 120
8. BIRTHDAY Дата народження співробітника в
форматі ДД/ММ/РРРР D 8
9. EMBOSSIGLI Транслітерація прізвища та імені
співробітника для нанесення на картку. Альтернативний варіант написання цього поля EMBOSSINGLIT
дозволяє замінювати деякі параметри співробітника, якщо він
С 26
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 23 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина поля
О/З
вже був внесений
10. SEX Стать співробітника (M або F) C 1
11. BIRTHPLACE Місце народження співробітника C 60
12. CITIZENSHIP Код країни держави співробітника
(для України 804) N 3
13. RESIDENTTYPEID Резидентність (1- резидент, 2 -
нерезидент)
N 1
14. RESIDENT_COUNTRY
ID
Код країни резидентності
співробітника (для України 804)
N 3
15. ADDRESS Повна домашня адреса
співробітника. Якщо заповнюється це поле, тоді всі
інші поля, що стосуються адреси співробітника, можна не зазначати.
Примітка. Можливість зазначення адреси в даному полі регулюється
внутрішніми налаштуваннями банку
С 254
16. ADDR_COUNTRYID Цифровий код країни домашньої
адреси співробітника N 3
17. ADDR_POSTCODE Почтовий індекс домашньої адреси
співробітника
C 6
18. ADDR_REGION Область домашньої адреси
співробітника
C 40
19. ADDR_DISTRICT Район домашньої адреси
співробітника C 40
20. ADDR_CITY Населений пункт домашньої адреси
співробітника C 36
21. ADDR_STREET Вулиця домашньої адреси
співробітника C 40
22. ADDR_HOUSENO Номер дома домашньої адреси
співробітника
C 10
23. ADDR_FLAT Номер квартири домашньої адреси
співробітника
C 10
24. JURIDICALADDRESS Повна адреса розсилки.
Якщо заповнюється це поле, тоді всі
інші поля, що стосуються адреси співробітника, можна не зазначати. Примітка. Можливість зазначення
адреси в даному полі регулюється
внутрішніми налаштуваннями банку
С 254
25. JURADDR_COUNTRYI
D
Адреса для кореспонденції.
Цифровий код країни
N 3
26. JURADDR_POSTCOD
E
Адреса для кореспонденції.
Поштовий індекс
C 6
27. JURADDR_REGION Адреса для кореспонденції.
Найменування області
C 40
28. JURADDR_DISTRICT Адреса для кореспонденції.
Найменування району
C 40
29. JURADDR_CITY Адреса для кореспонденції.
Населений пункт
C 36
30. JURADDR_STREET Адреса для кореспонденції.
Вулиця
C 40
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 24 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина поля
О/З
31. JURADDR_HOUSENO Адреса для кореспонденції.
Номер дома
C 10
32. JURADDR_FLAT Адреса для кореспонденції.
Номер квартири
C 10
33. ACCEPTANCEDATE Дата прийому співробітника на
роботу в форматі ДД/ММ/РРРР D 8
34. HOMEPHONE Домашній телефон співробітника в
форматі +380999999999 C 20
35. WORKPHONE Робочий телефон співробітника в
форматі +380999999999 C 20
36. MOBILEPHONE Мобільний телефон співробітника в
форматі +380999999999
C 20
37. TABNO Табельний номер співробітника.
Примітка. При імпорті не враховується
С 15
38. PASSPORTCHIP Ознака наявності чипу в паспорті
нового зразка:
0 – ні
1 – так
Примітка. Можливість задавати значення в даному полі є
додатковою функціональністю і регулюється окремими
налаштуваннями банку
N 1
39. PASSPORTLASTDATE Дата закінчення терміну дії паспорту
нового зразка (ID картки) в форматі
ДД/ММ/РРРР
Примітка. Можливість задавати значення в даному полі є додатковою функціональністю і
регулюється окремими
налаштуваннями банку
D 8
40. PASSPORTRECNO Унікальний номер запису в
демографічному реєстрі ФЛ
Примітка. Можливість задавати значення в даному полі є
додатковою функціональністю і регулюється окремими
налаштуваннями банку
C 14
Примітка. Обов’язковість заповнення полів, що не позначені в таблиці як обов’язкові або необов’язкові, регулюється внутрішніми налаштуваннями банку.
Зразки файлів додаються до комплекту документації (див. «2.1.6.Import_Employees.csv»).
2.2. Імпорт зарплатної відомості
2.2.1. Імпорт з XML-файлу
Файл імпорту зарплатної відомості підприємства містить інформацію про нараховану працівникам зарплату та інші платежі. Файл вивантажується з бухгалтерської програми на стороні клієнта. Імпорт виконується з файлів у форматі ANSI.
Приклад:
<?xml version="1.0" encoding="windows-1251"?>
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 25 из 83
<DATAPACKET Version="2.0">
<SCHEDULEINFO SHEDULE_DATE="01/01/2008"
SHEDULE_NUMBER="С0000000006" CLIENT_NAME="ООО 'Фирма'"
PAYER_BANK_BRANCHID="100001" PAYER_BANK_NAME="Банк"
PAYER_BANK_ACCOUNTNO="26209800054" PAYER_ACCOUNTNO="26209800076"
ONFLOW_TYPE="Премия" TOTAL_SHEDULE_AMOUNT="150,00"
COMMISSION_PERSENT="">
<EMPLOYEES>
<EMPLOYEE IDENTIFYCODE="1234567890" TABNO="01"
CARDACCOUNTNO="262076005403" LASTNAME="Прізвище" FIRSTNAME="Ім’я"
MIDDLENAME="По батькові" AMOUNT="150,00"/>
…
</EMPLOYEES>
</SCHEDULEINFO>
</DATAPACKET>
№ Найменування поля Призначення/опис О/З
Інформація про зарплатну відомість містить такі значення
1. SHEDULE_DATE Дата зарплатної відомості в форматі
ДД/ММ/РРРР +
2. SHEDULE_NUMBER Номер зарплатної відомості +
3. CLIENT_NAME Назва підприємства платника -
4. PAYER_BANK_BRANCHID МФО банку, в якому відкрито рахунок
платника +
5. PAYER_BANK_NAME Назва банку, в якому відкрито рахунок
платника -
6. PAYER_BANK_ACCOUNTN
O
Рахунок платника в банку (транзитний).
Примітка. Якщо адміністратор виконав налаштування системи таким чином, що
транзитний рахунок буде визначатися автоматично, то це поле буде необов'язковим
для заповнення
+
7. PAYER_ACCOUNTNO Рахунок для списання коштів +
8. ONFLOW_TYPE Вид нарахування по зарплатній відомості.
Значення з поля імпортується при умові його відповідності даним з довідника "Види
нарахувань". В іншому випадку в зарплатну відомість буде підставлений вид нарахування
з кодом «1» з довідника
-
9. TOTAL_SHEDULE_AMOUN
T
Загальна сума зарплатної відомості в форматі
ГРН,КОП
+
10. COMMISSION_PERSENT Процент комісії -
11. PAYER_EXTACCOUNT Ознака списання коштів з рахунку в іншому
банку:
0 – кошти списуються з рахунку в цьому ж
банку, номер рахунку вказується в полі
PAYER_ACCOUNTNO;
-
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 26 из 83
№ Найменування поля Призначення/опис О/З
1 – кошти будуть списані з рахунку в іншому
банку.
Примітка. Якщо в файлі, що імпортується,
встановлено ознаку списання коштів з рахунку в іншому банку, та, відповідно, не
вибрано рахунок для списання коштів, визначення підприємства відбувається за
кодом ЗКП
12. CONTRAGENT_CODEZKP Код зарплатного проекту.
Примітка. Зазначається лише для банків, що
використовують ЗКП.
Дане поле може бути не заповнено, якщо:
1. Для підприємства визначено один ЗКП,
його код проставляється автоматично;
2. Для підприємства визначено декілька ЗКП, користувачеві необхідно зазначити ЗКП
відомості з доступного списку ЗКП, за якими
працює підприємство.
Якщо за підприємством не визначено жодного
ЗКП, то при імпорті система видасть помилку
+
13. COMMENTS Додатковий коментар до зарплатної відомості -
Інформація про нараховану співробітнику суму містить такі значення
14. IDENTIFYCODE Ідентифікаційний код співробітника +
15. TABNO Табельний номер співробітника.
Якщо в ід. коді вказано значення 000000000 (співробітник нерезидент або відмовився від
присвоєння коду), це поле є обов'язковим
для заповнення
+
16. CARDACCOUNTNO Номер карткового (або іншого) рахунку
співробітника.
Якщо поле не заповнено, автоматично підставляється рахунок співробітника, за
яким в системі зазначена ознака «за умовчанням». Якщо рахунків «за
умовчанням» у одного співробітника декілька, підставляється перший зі списку. Якщо за співробітником не визначено жодного
рахунку з ознакою «за умовчанням» та поле CARDACCOUNTNO не заповнено, при імпорті
файлу виникне помилка.
Примітка. Якщо підприємство використовує
ЗКП, та для співробітника в рамках одного ЗКП по підприємству відкритий тільки один картковий рахунок, то його заповнення в
файл, що імпортується, не обов'язково, тому що рахунок буде підставлений автоматично.
Якщо по співробітнику в рамках одного ЗКП відкрито декілька рахунків, то в файлі, що імпортується, необхідно вказати номер
карткового рахунку співробітника, на який
виконується нарахування
-
17. LASTNAME Прізвище співробітника -
18. FIRSTNAME Ім’я співробітника -
19. MIDDLENAME По батькові співробітника -
20. AMOUNT Сума для зарахування на рахунок
співробітника в форматі ГРН,КОП
+
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 27 из 83
Зразки файлів додаються до комплекту документації (див. «2.2.1.Import_Payroll.xml»).
2.2.2. Імпорт з DBF-файлу
Для імпорту файлу DBF-формату має бути сформовано два файли: ScheduleInfo.dbf і Amounts.dbf, які являють собою файли з інформацією про зарплатні відомості та нараховані співробітникам зарплати, відповідно.
Крім того, файл с інформацією про зарплатну відомість може мати назву Sched_ХХХХХХХХХХ.dbf, при цьому файл з нарахуваннями по співробітникам може мати
назву Am_ХХХХХХХХХХ.dbf, де «ХХХХХХХХХХ» - довільна інформація, яка може містити від 1 до 10 символів (літер та цифр)*.
DBF-файл має імпортуватися в DOS-кодуванню та форматі DBASE-IV.
Кожен рядок файлів має фіксовану структуру, описану в таблиці нижче.
№ Найменування
поля
Призначення/опис Тип
даних
Довжин
а поля
О/З
Інформація про зарплатну відомість містить такі значення
1. SHED_DATE Дата зарплатної відомості в форматі
ДД/ММ/РРРР
D 8 +
2. SCHED_NO Номер зарплатної відомості C 10 +
3. CLIENTNAME Назва підприємства платника С 100 -
4. BANK_MFO МФО банку, в якому відкрито рахунок
платника
N 6 +
5. BANK_NAME Назва банку, в якому відкрито рахунок
платника
C 30 -
6. BANK_ACCNO Рахунок платника в банку (транзитний).
Примітка. Якщо в файлі, що
імпортується, рахунок не зазначено, то виконується пошук транзитного рахунку в
БД. Якщо поле BANK_ACCNO не зазначено, транзитний рахунок не знайдено в БД, система буде виводити
помилку при спробі імпорту зарплатної
відомості.
Примітка. Якщо адміністратор виконав налаштування системи таким чином, що
транзитний рахунок буде визначатися автоматично, то це поле буде
необов'язковим для заповнення
C 14 +
7. ACCOUNTNO Рахунок для списання коштів C 14 +
8. SCHED_SUM Загальна сума зарплатної відомості в
форматі ГРН.КОП
N 19.2 +
9. ISEXTACC Ознака списання коштів з рахунку в
іншому банку:
0 – кошти списуються з рахунку в цьому
ж банку, номер рахунку вказується в полі
ACCOUNTNO;
1 – кошти будуть списані з рахунку в
іншому банку.
Примітка. Якщо в файлі, що імпортується, встановлено ознаку
N 1 -
* Додаткова функціональність
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 28 из 83
№ Найменування поля
Призначення/опис Тип даних
Довжина
поля
О/З
списання коштів з рахунку в іншому банку, та, відповідно, не вибрано рахунок
для списання коштів, визначення
підприємства відбувається за кодом ЗКП
10. CODEZKP Код зарплатного проекту.
Примітка. Зазначається лише для банків,
що використовують ЗКП.
Дане поле може бути не заповнено, якщо:
1. Для підприємства визначено один ЗКП,
його код проставляється автоматично;
2. Для підприємства визначено декілька ЗКП, користувачеві необхідно зазначити ЗКП відомості з доступного списку ЗКП, за
якими працює підприємство.
Якщо за підприємством не визначено
жодного ЗКП, то при імпорті система
видасть помилку
N 10 +
11. COMMENTS Додатковий коментар до зарплатної
відомості
С 180 -
12. FLOWTYPE Вид нарахування по зарплатній відомості.
Значення з поля імпортується при умові його відповідності даним з довідника
"Види нарахувань". В іншому випадку в зарплатну відомість буде підставлений
вид нарахування з кодом «1» з довідника
С 100 -
Інформація про нараховану співробітнику суму містить такі значення
13. IDCODE Ідентифікаційний код співробітника C 10 +
14. TABNO Табельний номер співробітника.
Якщо в ід. коді вказано значення 000000000 (співробітник нерезидент або відмовився від присвоєння коду), це поле
є обов'язковим для заповнення
C 15 +
15. ACCOUNTNO Номер карткового (або іншого) рахунку
співробітника.
Якщо поле не заповнено, автоматично підставляється рахунок співробітника, за яким в системі зазначена ознака «за
умовчанням». Якщо рахунків «за умовчанням» у одного співробітника
декілька, підставляється перший зі списку. Якщо за співробітником не визначено жодного рахунку з ознакою
«за умовчанням» та поле ACCOUNTNO не заповнено, при імпорті файлу виникне
помилка.
Примітка. Якщо підприємство
використовує ЗКП, та для співробітника в рамках одного ЗКП по підприємству відкритий тільки один картковий рахунок,
то його заповнення в файл, що імпортується, не обов'язково, тому що рахунок буде підставлений автоматично.
Якщо по співробітнику в рамках одного ЗКП відкрито декілька рахунків, то в
файлі, що імпортується, необхідно вказати номер карткового рахунку співробітника, на який виконується
C 14 -
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 29 из 83
№ Найменування поля
Призначення/опис Тип даних
Довжина
поля
О/З
нарахування
16. LASTNAME Прізвище співробітника C 38 -
17. FIRSTNAME Ім’я співробітника C 38 -
18. MIDDLENAME По батькові співробітника C 38 -
19. AMOUNT Сума для зарахування на рахунок
співробітника в форматі ГРН.КОП
N 19.2 +
Зразки файлів додаються до комплекту документації (див. «2.2.2.Amounts.DBF», «2.2.2.ScheduleInfo.dbf»).
2.2.3. Імпорт з XLS-файлу
Файл імпорту зарплатної відомості підприємства містить інформацію про нараховану працівникам зарплату та інші платежі. Файл вивантажується з бухгалтерської програми на стороні клієнта та являє собою таблицю Excel, що складається з двох вкладок: 1 – інформація про ЗП відомості, 2 - дані про співробітників.
Для створення файлу імпорту зарплатної відомості XLS необхідно:
1. Створити вкладку «SheduleInfo»;
Перший рядок даної вкладки повинен містити назви полів зарплатної відомості, розташовані в такому порядку:
№ Найменування поля Призначення/опис О/З
1. SHEDULE_DATE Дата зарплатної відомості.
Рекомендується встановити формат дати ДД.ММ.РРРР. Така дата буде коректно
імпортуватися до windows- та web-додатків
системи. Тип клітинки в Excel має бути «Дата»
+
2. SHED_NUMBER Номер зарплатної відомості +
3. CLIENTNAME Найменування підприємства платника -
4. BANK_MFO МФО банку, в якому відкрито рахунок платника +
5. BANK_NAME Назва банку, в якому відкрито рахунок платника -
6. BANK_ACCNO Рахунок платника в банку (транзитний).
Примітка. Якщо адміністратор виконав налаштування системи таким чином, що транзитний рахунок буде визначатися
автоматично, то це поле буде необов'язковим для
заповнення
+
7. ACCOUNTNO Рахунок для списання коштів +
8. SHED_SUM Загальна сума зарплатної відомості в форматі
ГРН,КОП
+
9. EXTACCOUNT Ознака списання коштів з рахунку в іншому
банку:
0 – кошти списуються з рахунку в цьому ж банку,
номер рахунку вказується в полі ACCOUNTNO;
1 – кошти будуть списані з рахунку в іншому
банку.
Примітка. Якщо в файлі, що імпортується,
встановлено ознаку списання коштів з рахунку в
-
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 30 из 83
№ Найменування поля Призначення/опис О/З
іншому банку, та, відповідно, не вибрано рахунок
для списання коштів, визначення підприємства
відбувається за кодом ЗКП
10. CONTRAGENT_ZKP Код зарплатного проекту.
Примітка. Зазначається лише для банків, що
використовують ЗКП.
Дане поле може бути не заповнено, якщо:
1. Для підприємства визначено один ЗКП, його
код проставляється автоматично;
2. Для підприємства визначено декілька ЗКП,
користувачеві необхідно зазначити ЗКП відомості з доступного списку ЗКП, за якими працює
підприємство.
Якщо за підприємством не визначено жодного
ЗКП, то при імпорті система видасть помилку
+
11. COMMENTS Додатковий коментар до зарплатної відомості
12. ONFLOWTYPE Вид нарахування по зарплатній відомості.
Значення з поля імпортується при умові його відповідності даним з довідника "Види
нарахувань". В іншому випадку в зарплатну відомість буде підставлений вид нарахування з
кодом «1» з довідника
-
Другий рядок призначено для введення значень зарплатної відомості;...
2. Створити другу вкладку – «Amounts»;
Перший рядок даної вкладки повинен містити назви полів про співробітників та нарахування:
№ Найменування поля Призначення/опис О/З
1. IDCODE Ідентифікаційний код співробітника
Примітка. Якщо співробітник є нерезидентом або він
відмовився від присвоєння ід. коду, то це поле має бути заповнено значенням 9 нулів (клітинка
відформатована як текст), або замість ід. коду допускається введення пробілу. Якщо це поле відформатовано як число, в ід. код співробітника буде
підставлене значення 0, та пошук співробітника
відбуватиметься некоректно
+
2. TABNO Табельний номер співробітника.
Якщо в ід. коді вказано значення 000000000 (співробітник нерезидент або відмовився від присвоєння коду), це поле є обов'язковим для
заповнення
+
3. ACCOUNTNO Номер карткового (або іншого) рахунку співробітника.
Якщо поле не заповнено, автоматично підставляється
рахунок співробітника, за яким в системі зазначена ознака «за умовчанням». Якщо рахунків «за умовчанням» у одного співробітника декілька,
підставляється перший зі списку. Якщо за співробітником не визначено жодного рахунку з
ознакою «за умовчанням» та поле ACCOUNTNO не
заповнено, при імпорті файлу виникне помилка.
Примітка. Якщо підприємство використовує ЗКП, та для співробітника в рамках одного ЗКП по
-
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 31 из 83
№ Найменування поля Призначення/опис О/З
підприємству відкритий тільки один картковий
рахунок, то його заповнення в файл, що імпортується, не обов'язково, тому що рахунок буде підставлений
автоматично. Якщо по співробітнику в рамках одного ЗКП відкрито декілька рахунків, то в файлі, що імпортується, необхідно вказати номер карткового
рахунку співробітника, на який виконується
нарахування
4. LASTNAME Прізвище співробітника -
5. FIRSTNAME Ім’я співробітника -
6. MIDDLENAME По батькові співробітника -
7. AMOUNT Сума для зарахування на рахунок співробітника в
форматі ГРН,КОП
+
Другий та наступні рядки призначено для введення значень відповідних полів.
Після введення всіх необхідних даних сформований XLS-файл є готовим для імпорту.
Зразки файлів додаються до комплекту документації (див. «2.2.3.Import_Payroll.xls»).
2.2.4. Імпорт з текстового файлу 1С
Файл є текстовим та містить сукупність рядків, що являють собою інформацію про нарахування на рахунки співробітників підприємства. Рядки завершуються
послідовністю CR-LF (ASCII-символи 13 та 10). Ці записи імпортуються з файлів у форматі ANSI. Дані по кожному новому нарахуванню мають свій порядковий номер. Нумерація починається з 0.
№
стор Найменування реквізиту Опис
Тип даних,
макс.
довжина
поля
О/
З Примітка
Заголовок файлу
1. Content-Type
Ознака файлу
відомості
+ Можливі значення:
doc/pay_sheet
2. Пустий
рядок
+
Шапка відомості
3. DATE_DOC Дата
відомості
D
(в формате
DD.MM.YYYY)
Приклад заповнення:
DATE_DOC=11.11.2016
4. NUM_DOC
Номер відомості
Приклад заповнення:
NUM_DOC=723
5. CLN_NAME Назва
Організації
6. PAYER_BANK_MFO МФО Банку
7. PAYER_BANK_NAME Назва банку
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 32 из 83
№
стор Найменування реквізиту Опис
Тип даних, макс.
довжина
поля
О/
З Примітка
8. PAYER_ACCOUNT Номер
рахунку
Інформація про нарахування
9. CARD_HOLDERS.N.CARD_NUM Номер
рахунку
співробітник
а N
+ Приклад заповнення:
CARD_HOLDERS.0.CARD
_NUM=26259010015125
10. CARD_HOLDERS.N.CARD_HOL
DER
Ім’я співробітник
а N
Приклад заповнення:
CARD_HOLDERS.0.CARD_HOLDER=Попова Марія
Володимирівна
11. CARD_HOLDERS.N.STATUS Статус + Можливі значення:
0
12. CARD_HOLDERS.N.CARD_HOL
DER_INN
Ід. номер співробітник
а N
13. CARD_HOLDERS.N.AMOUNT Сума до
виплати співробітник
у N
грн.коп +
Кінцівка відомості
14. ONFLOW_TYPE Вид
нарахування за зарплатною
відомістю
Значення з поля
імпортується за умови його відповідності даним з довідника
"Види нарахувань". В іншому випадку в зарплатну відомість
буде підставлений вид нарахування з кодом
«1» з довідника
15. AMOUNT Всього сума
до виплати
грн.коп
16. BEGIN_MONTH Номер
місяця
нарахування
MM
17. BEGIN_YEAR Рік
документу
нарахування
YYYY
Приклад:
Content-Type=doc/pay_sheet
DATE_DOC=11.11.2016
NUM_DOC=723
CLN_NAME=ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ "Ромашка"
PAYER_BANK_MFO=300006
PAYER_BANK_NAME=ПАТ "БАНК", м. Харків
PAYER_ACCOUNT=2650700000000
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 33 из 83
CARD_HOLDERS.0.CARD_NUM=26259010015125
CARD_HOLDERS.0.CARD_HOLDER=Косівцова Катерина Павлівна
CARD_HOLDERS.0.STATUS=0
CARD_HOLDERS.0.CARD_HOLDER_INN=3225023067
CARD_HOLDERS.0.AMOUNT=151.07
CARD_HOLDERS.1.CARD_NUM=26254010015227
CARD_HOLDERS.1.CARD_HOLDER=Ільніцька Олена Андріївна
CARD_HOLDERS.1.STATUS=0
CARD_HOLDERS.1.CARD_HOLDER_INN=3411302806
CARD_HOLDERS.1.AMOUNT=151.07
ONFLOW_TYPE=Заробітна плата та аванси
AMOUNT=302.14
BEGIN_MONTH=09
BEGIN_YEAR=2016
2.3. Імпорт нарахувань по зарплатній відомості
2.3.1. Імпорт з XLS-файлу
Файл імпорту містить інформацію про нарахування співробітникам по зарплатній відомості підприємства. Файл вивантажується з бухгалтерської програми на стороні клієнта та являє собою таблицю Excel, що складається з однієї вкладки «Amounts»,
перший рядок файлу повинен містити заголовки колонок (ігноруються при імпорті), наступні рядки містять дані про нарахування по зарплатній відомості.
Файл імпорту нарахувань по зарплатній відомості має наступну структуру:
№ Найменування поля
Призначення/опис Тип даних
Довжина
поля
О/З
1. ФИО
ПІБ співробітника.
Для кожного значення - прізвища, імені, по батькові - допускається 38 символів,
роздільник між ними - один пробіл. Дозволеними символами є лише великі та маленькі кириличні літери, а також додаткові
символи: "пробіл", `, '', ", -
C 118 -
2. ИНН Ідентифікаційний код співробітника C 10 +
3. ACCOUNTNO Номер банківського (карткового) рахунку
співробітника N 10 +
4. AMOUNT Сума платежу (в копійках) N 15 +
Зразки файлів додаються до комплекту документації (див. «2.3.1.Import_Payroll_Accruals.xls»).
2.3.2. Імпорт з текстового файлу
Файл імпорту містить інформацію про нарахування на карткові рахунки
співробітників по зарплатній відомості підприємства. Файл має назву виду: PCxxxxxx.nnn, де:
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 34 из 83
xxxxxx – код клієнта (останні 6 цифр розрахункового рахунку клієнта);
nnn – розширення назви файлу, має бути унікальним. Наприклад, це може бути наскрізна нумерація файлів (000 ... 999) або порядковий номер дня в році (001 ... 366).
Файл є текстовим, всі поля фіксованої довжини вирівняні вліво, доповнені
праворуч пробілами, кожен рядок закінчується символами кінця рядка (chr(13) + chr(10)). Файл складається із заголовного рядка та інформаційних рядків. Імпорт виконується з файлів у форматі ANSI.
Кожен рядок файлу має фіксовану структуру, описану нижче:
Головний рядок містить інформацію про файл.
№ Найменування Тип Довж
ина Позиція
1. Ім’я файлу
12 1
2. Код клієнта
N 6 13
3. Час формування файлу (в форматі yyyymmddhhmi)
12 19
4. Кількість інформаційних рядків в файлі
N 6 31
5. Сума всіх платежів в файлі в копійках
N 15 37
Всі наступні рядки – інформаційні, та кожен новий рядок містить інформацію
про платіж на певний картковий рахунок.
№ Найменування Тип Довж
ина
Позиція
1. Номер інформаційного рядка
N 6 1
2. Код валюти
С 3 7
3. Сума платежу в копійках
N 15 10
4. Номер картки співробітника
N 32 25
5. Призначення платежу
С 32 57
Зразки файлів додаються до комплекту документації (див. «2.3.2.PC300001.026»).
2.3.3. Імпорт з DBF-файлу
Файл імпорту нарахувань по зарплатній відомості з формату DBF аналогічний
файлу імпорту нарахувань по зарплатній відомості «Amounts.dbf» див. «Імпорт з DBF-файлу».
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 35 из 83
2.4. Імпорт/експорт розрахункових листів
2.4.1. Імпорт з текстового файлу
Файл імпорту містить рахунок співробітника підприємства, на який виконується нарахування зарплати, та інформацію для виведення на розрахунковий лист. Файл має назву виду:NNNNNNNN_YYMMDD-XХХ.dat, де:
NNNNNNNN – код підприємства (ЄДРПОУ);
YYMMDD – дата створення файлу;
XХХ – порядковий номер файлу за день.
Файл є текстовим. Імпорт виконується з файлів в форматі ANSI. Кожен набір даних для друку розрахункового листа являє собою запис файлу. Максимальна кількість полів, з яких складається запис, - 50. За роздільник між полями використовується символ «;».
Кожен запис файлу закінчується символами кінця рядка CR+LF (ASCII-символи 13 та 10).
Кожен запис файлу має фіксовану структуру, описану нижче:
№ Найменування
поля
Призначення/опис Тип
даних
Макс.
довжина
поля
О/З
1. Номер рахунку Номер рахунку співробітника для виплати
заробітної плати (2625…) в АБС Б2
N 36 +
2./
49. Рядки розрахунковог
о листа
Довільна інформація для виведення на чек банкомату
C 36 -
Зразки файлів додаються до комплекту документації (див. «2.4.1.04591423_130824-006.dat»).
2.4.2. Експорт до текстового файлу
Файл експорту відхилених розрахункових листів є аналогічним файлу імпорту
розрахункових листів з текстового файлу, див. «Імпорт з текстового файлу». При експорті користувач задає довільну назву файлу.
2.5. Експорт даних про співробітників
Увага! Експорт даних про співробітників в файли форматів XML, XLS, TXT, HTML є додатковою функціональністю та потребує встановлення окремого плагіна.
2.5.1. Експорт до XML-файлу
Файл експорту даних про співробітників підприємства містить інформацію про підприємства клієнта та його співробітників та вивантажується з системи iFOBS.eSalary для роботи в зовнішніх системах.
Приклад:
<?xml version="1.0" encoding="WINDOWS-1251"?>
<DATAPACKET>
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 36 из 83
<ENTERPRISEINFO EMAIL="" FAX="" CONTACTINFO="" CONTACTPHONES=""
ADDRESS="" NALOGREGISTERNO="1245" NALOGREGISTERDATE="20000309"
IDENTIFYCODE="7845121245" SNAME="ООО Дом">
<EMPLOYEES>
<EMPLOYEE ADDRESS="58000, обл. Чернівецька, м. Чернівці, вул. Центральна,
буд. 77Б, кв. 46" IDENTIFYCODE="3102507918" ACCEPTANCEDATE="01.09.2009"
RESIDENTCOUNTRYID="804" JURADDR_REGIONID="24" ADDR_REGIONID="24"
RESIDENTTYPEID="1" MOBILEPHONE="+382123213546" WORKPHONE="+384125555555"
HOMEPHONE="+380255663222" CITIZENSHIP="804" BIRTHPLACE="Черновцы" SEX="Ч"
EMBOSSINGLI="SKAKUN ANDRIY" JURADDR_HOUSENO="77Б"
JURADDR_STREET="Центральна" JURADDR_DISTRICT="м.Чернівці"
JURADDR_CITY="Чернiвцi" JURADDR_REGION="Чернівецька область"
JURADDR_POSTCODE="58000" JURADDR_COUNTRYID="804" ADDR_HOUSENO="77Б"
ADDR_STREET="Центральна" ADDR_DISTRICT="м.Чернівці" ADDR_CITY="Чернiвцi"
ADDR_REGION="Чернівецька область" ADDR_POSTCODE="58000"
ADDR_COUNTRYID="804" BIRTHDAY="10.12.1984" PASSPORTISSUEPLACE="1-м відділом
ЧМВ УМВС України в Чернівецькій обл." PASSPORTISSUEDATE="02.02.1999"
PASSPORTNO="КР689053" MIDDLENAME="Степанович" FIRSTNAME="Андрій"
LASTNAME="Скакун" ID="9C86E484EF0C4A7BAC5938690A761266" TABNO="14785522"
JURADDRESS="58000, обл. Чернівецька, м. Чернівці, вул. Центральна, буд. 77Б, кв. 46"
JURADDR_FLAT="46" ADDR_FLAT="46"/>
</EMPLOYEES>
</ENTERPRISEINFO>
</DATAPACKET>
№ Найменування поля Призначення/опис Тип
даних
Довжи
на
поля
Інформація про підприємство містить такі значення:
1. SNAME Назва підприємства C 30
2. IDENTIFYCODE Ідентифікаційний код підприємства N 10
3. NALOGREGISTERDATE Дата реєстрації підприємства у
податковій (в форматі YYYYMMDD)
D 8
4. NALOGREGISTERNO Номер реєстрації підприємства у
податковій
N 10
5. ADDRESS Повна адреса підприємства.
Якщо поле не заповнено або в ньому встановлений прочерк (знак мінус "-"),
тоді при збереженні запису про співробітника в адресі буде зазначено
«Не визначено»
C 254
6. CONTACTPHONES Номер контактного телефону
підприємства C 20
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 37 из 83
№ Найменування поля Призначення/опис Тип
даних
Довжи
на
поля
7. CONTACTINFO Контактна інформація C 200
8. FAX Номер факсу підприємства C 20
9. EMAIL Адреса електронної пошти
підприємства C 100
Інформація про співробітників містить такі значення
10. ID Порядковий номер співробітника N 10
11. IDENTIFYCODE Ідентифікаційний код співробітника N 10
12. LASTNAME Прізвище співробітника С 38
13. FIRSTNAME Ім’я співробітника С 38
14. MIDDLENAME По батькові співробітника С 38
15. EMBOSSIGLI Транслітерація прізвища та імені
співробітника для нанесення на картку
С 26
16. SEX Стать співробітника (M або F) C 1
17. PASSPORTNO Номер паспорту співробітника в
форматі ББ999999 для резидентів С 25
18. PASSPORTISSUEDATE Дата видачі паспорту співробітника в
форматі DD.MM.YYYY D 8
19. PASSPORTISSUEPLACE Місце видачі паспорта співробітника C 120
20. BIRTHDAY Дата народження співробітника в
форматі DD.MM.YYYY D 8
21. BIRTHPLACE Місце народження співробітника C 60
22. CITIZENSHIP Код країни громадянства співробітника
(для України 804) N 3
23. ADDRESS Повна домашня адреса співробітника.
Якщо заповнюється це поле, тоді всі
інші поля, що стосуються адреси співробітника (25-32), можна не
зазначати. Примітка. Можливість зазначення адреси в даному полі регулюється
внутрішніми налаштуваннями банку
С 254
24. JURADDRESS Повна адреса розсилки.
Якщо заповнюється це поле, тоді всі інші поля, що стосуються адреси
розсилки (33-40), можна не зазначати. Примітка. Можливість зазначення
адреси в даному полі регулюється
внутрішніми налаштуваннями банку
С 254
25. ADDR_COUNTRYID Цифровий код країни домашньої
адреси співробітника N 3
26. ADDR_POSTCODE Поштовий індекс домашньої адреси
співробітника C 6
27. ADDR_REGIONID Цифровий код країни домашньої
адреси співробітника з довідника
областей
N 2
28. ADDR_REGION Область домашньої адреси
співробітника С 40
29. ADDR_DISTRICT Район домашньої адреси співробітника C 40
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 38 из 83
№ Найменування поля Призначення/опис Тип
даних
Довжи
на
поля
30. ADDR_CITY Населений пункт домашньої адреси
співробітника C 40
31. ADDR_STREET Вулиця домашньої адреси
співробітника C 40
32. ADDR_HOUSENO Номер будинку домашньої адреси
співробітника C 10
33. ADDR_FLAT Номер квартири домашньої адреси
співробітника C 10
34. JURADDR_COUNTRYID Адреса для кореспонденції.
Цифровий код країни N 3
35. JURADDR_POSTCODE Адреса для кореспонденції.
Поштовий індекс C 6
36. JURADDR_REGIONID Адреса для кореспонденції.
Цифровий код області з довідника
областей
N 2
37. JURADDR_REGION Адреса для кореспонденції.
Найменування області С 40
38. JURADDR_DISTRICT Адреса для кореспонденції.
Найменування району C 40
39. JURADDR_CITY Адреса для кореспонденції.
Населений пункт C 40
40. JURADDR_STREET Адреса для кореспонденції.
Вулиця C 40
41. JURADDR_HOUSENO Адреса для кореспонденції.
Номер дома C 10
42. JURADDR_FLAT Адреса для кореспонденції.
Номер квартири C 10
43. ACCEPTANCEDATE Дата прийому співробітника на роботу
в форматі DD.MM.YYYY
D 8
44. HOMEPHONE Домашній телефон співробітника в
форматі +380999999999 (обов'язково повинен бути зазначений
хоча б один телефон - домашній,
мобільний або робочий)
C 30
45. WORKPHONE Робочий телефон співробітника в
форматі +380999999999
(обов'язково повинен бути зазначений хоча б один телефон - домашній,
мобільний або робочий)
C 30
46. MOBILEPHONE Мобільний телефон співробітника в
форматі +380999999999 (обов'язково повинен бути зазначений хоча б один телефон - домашній,
мобільний або робочий)
C 30
47. TABNO Табельний номер співробітника.
Заповнюється в таблиці прив’язки
співробітника до номера підприємства
С 15
48. RESIDENTCOUNTRYID Цифровий код країни резидента N 3
49. RESIDENTTYPEID Резидентність (К030) N 1
50. REGBYSELFBUSY Ознака того, що співробітник
«Зареєстрований як самозайнята ФО»: 0 – ні
1 – так
N 1
Зразки файлів додаються до комплекту документації
(див. «2.5.1.Export_Employees.xml»).
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 39 из 83
2.5.2. Експорт до XLS-файлу
Файл експорту даних про співробітників в формат XLS містить інформацію про співробітників клієнта. Файл являє собою таблицю Excel, що складається з однієї вкладки «EMPLOYEES».
Кожен рядок файлів має фіксовану структуру, описану в таблиці нижче.
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
1. GENDER Стать співробітника (M або F) C 1
2. NAME Прізвище, ім’я та по батькові
співробітника, які введено через
один пробіл. При імпорті має розбиратися на три поля LASTNAME, FIRSTNAME та MIDDLENAME
Примітка. Можна ввести необмежену кількість символів, яка після розбиття на прізвище/ім'я/по
батькові буде обрізано до допустимої довжини відп. полів - по 38 символів
C - +
3. EMBOSSING_NAME Латинська транслітерація прізвища
та імені співробітника, яка ембосується на міжнародних картках
C 26
4. BIRTHDATE Дата народження співробітника в
форматі DD.MM.YYYY D 8
5. CITY Місце народження співробітника C 40
6. ADDRESS Повна адреса підприємства.
Якщо поле не заповнено або в ньому встановлений прочерк (знак мінус "-
"), тоді при збереженні запису про співробітника в адресі буде зазначено «Не визначено»
C 254
7. PASSPORT_NUMBER Номер паспорта співробітника C 20 +
8. PASP_SERIES Серія паспорта співробітника C 20 +
9. PASSPORT ISSUER Місце видачі паспорта C 120
10. PASSPORT_ISSUE_D
ATE
Дата видачі паспорта в форматі
DD.MM.YYYY
D 8
11. COUNTRY Код країни прописки N 3
12. CITY_REGISTRATION Місто прописки С 36
13. ZIP Індекс прописки С 6
14. TEL_HOME Контактний номер телефону в
форматі 0671234567 (не повинен містити пробіли, рисочки, плюси або
дужки) Примітка. В файлі експорту номер телефону вивантажується в форматі
+380999999999
С 20
15. CODEWORD Кодове слово для картки.
Примітка. Залежно від налаштування клієнтських місць SalIsCardTemplates значення
зберігається або в поле Кодове
C 20 -
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 40 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
слово в зв'язці «Підприємство-співробітник», або в поле Секретна
відповідь в анкеті співробітника
16. ISRESIDENT Чи є співробітник резидентом:
1 – так 2 – ні
N 1 -
17. IDENTIFYCODE Ідентифікаційний номер N 10 +
18. ID_Is_Card ID шаблону угоди в IS-Card N 10 -
19. ID_B2 ID продукту в Б2 N 10 -
20. CURRENCY Код валюти (на цей момент може
бути тільки гривня) С 3 -
21. DATE_START_WORK Дата прийому співробітника на оботу
в форматі DD.MM.YYYY D 8 -
Домашня адреса
22. Addr_CountryID Країна N 3
23. Addr_Postcode Індекс C 6
24. ADDR_RegionID Область N 10
25. Addr_District Район C 40
26. Addr_City Місто C 40
27. Addr_Street Вулиця C 40
28. Addr_Houseno Дім C 10
29. Addr_Flat Квартира C 10
Адреса для кореспонденції
30. JurAddr_CountryID Країна N 3
31. JurAddr_Postcode Індекс C 6
32. JurAddr_RegionID Область N 10
33. JurAddr_District Район C 40
34. JurAddr_City Місто C 40
35. JurAddr_Street Вулиця C 40
36. JurAddr_Houseno Дім C 10
37. JurAddr_Flat Квартира C 10
38. TABNO Табельний номер співробітника.
Заповнюється в таблиці прив’язки співробітника до номера підприємства
С 15 -
39. RESIDENTCOUNTRYID
Код країни резидентності N 3
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 41 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
40. JOB Займана посада. Заповнюється в
таблиці прив'язок співробітника до
номера підприємства (параметр «Деталі»).
Примітка. Це поле є доступним тільки при експорті даних з web-клієнта
C 40
41. REGBYSELFBUSY Ознака того, що співробітник
«Зареєстрований як самозайнята
ФО»: 0 – ні 1 – так
N 1
Примітка. Обов’язковість заповнення полів, що не позначені в таблиці як обов’язкові або необов’язкові, регулюється внутрішніми налаштуваннями банку.
Зразки файлів додаються до комплекту документації (див. «2.5.2.Export_Employees.xls»).
2.5.3. Експорт до TXT-файлу
Файл експорту даних про співробітників підприємства в формат TXT містить інформацію про його співробітників підприємства та вивантажується з системи iFOBS.eSalary для роботи в зовнішніх системах.
Кожен рядок файлу має фіксовану структуру, описану в таблиці нижче.
№ Найменування поля Призначення/опис Тип
даних
Довжин
а поля
О/З
1. IDENTIFYCODE Ідентифікаційний код співробітника N 10 +
2. LASTNAME Прізвище співробітника С 38 +
3. FIRSTNAME Ім’я співробітника С 38 +
4. MIDDLENAME По батькові співробітника С 38
5. PASSPORTNO Номер паспорта співробітника в
форматі ББ999999 для резидентів С 20 +
6. PASSPORTISSUEDAT
E
Дата видачі паспорта співробітника в
форматі DDMMYYYY D 8
7. PASSPORTISSUEPLA
CE
Місце видачі паспорта співробітника C 120
8. BIRTHDAY Дата народження співробітника в
форматі DDMMYYYY
D 8
9. EMBOSSIGLI Транслітерація прізвища та імені
співробітника для нанесення на картку. Альтернативний варіант
написання цього поля EMBOSSINGLIT дозволяє замінювати деякі
параметри співробітника, якщо він
вже був внесений
С 26
10. SEX Стать співробітника (M або F) C 1
11. BIRTHPLACE Місце народження співробітника C 60
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 42 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
12. CITIZENSHIP Код країни держави співробітника
(для України 804) N 3
13. RESIDENTTYPEID Резидентність (1- резидент, 2 -
нерезидент)
N 1
14. RESIDENT_COUNTRY
ID
Код країни резидентності
співробітника (для України 804)
N 3
15. ADDRESS Повна домашня адреса
співробітника. Якщо заповнюється це поле, тоді всі
інші поля, що стосуються адреси співробітника, можна не зазначати. Примітка. Можливість зазначення
адреси в даному полі регулюється
внутрішніми налаштуваннями банку
С 254
16. ADDR_COUNTRYID Цифровий код країни домашньої
адреси співробітника N 3
17. ADDR_POSTCODE Почтовий індекс домашньої адреси
співробітника
C 6
18. ADDR_REGION Область домашньої адреси
співробітника
C 40
19. ADDR_DISTRICT Район домашньої адреси
співробітника C 40
20. ADDR_CITY Населений пункт домашньої адреси
співробітника C 36
21. ADDR_STREET Вулиця домашньої адреси
співробітника C 40
22. ADDR_HOUSENO Номер дома домашньої адреси
співробітника
C 10
23. ADDR_FLAT Номер квартири домашньої адреси
співробітника
C 10
24. JURIDICALADDRESS Повна адреса розсилки.
Якщо заповнюється це поле, тоді всі
інші поля, що стосуються адреси співробітника, можна не зазначати. Примітка. Можливість зазначення
адреси в даному полі регулюється
внутрішніми налаштуваннями банку
С 254
25. JURADDR_COUNTRYI
D
Адреса для кореспонденції.
Цифровий код країни
N 3
26. JURADDR_POSTCOD
E
Адреса для кореспонденції.
Поштовий індекс
C 6
27. JURADDR_REGION Адреса для кореспонденції.
Найменування області
C 40
28. JURADDR_DISTRICT Адреса для кореспонденції.
Найменування району
C 40
29. JURADDR_CITY Адреса для кореспонденції.
Населений пункт
C 36
30. JURADDR_STREET Адреса для кореспонденції.
Вулиця
C 40
31. JURADDR_HOUSENO Адреса для кореспонденції.
Номер дома
C 10
32. JURADDR_FLAT Адреса для кореспонденції.
Номер квартири
C 10
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 43 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
33. ACCEPTANCEDATE Дата прийому співробітника на
роботу в форматі DDMMYYYY D 8
34. HOMEPHONE Домашній телефон співробітника в
форматі +380999999999
C 20
35. WORKPHONE Робочий телефон співробітника в
форматі +380999999999
C 20
36. MOBILEPHONE Мобільний телефон співробітника в
форматі +380999999999 C 20
37. TABNO Табельний номер співробітника С 15
Примітка. Обов’язковість заповнення полів, що не позначені в таблиці як обов’язкові або необов’язкові, регулюється внутрішніми налаштуваннями банку.
Зразки файлів додаються до комплекту документації (див. «2.5.3.Export_Employees.txt»).
2.5.4. Експорт до HTML-файлу
Файл експорту даних про співробітників підприємства в формат HTML містить інформацію про його співробітників підприємства та вивантажується з системи iFOBS.eSalary для роботи в зовнішніх системах.
Кожен рядок файлу має фіксовану структуру, описану в таблиці нижче.
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
1. IDENTIFYCODE Ідентифікаційний код співробітника N 10 +
2. LASTNAME Прізвище співробітника С 38 +
3. FIRSTNAME Ім’я співробітника С 38 +
4. MIDDLENAME По батькові співробітника С 38
5. PASSPORTNO Номер паспорта співробітника в
форматі ББ999999 для резидентів
С 20 +
6. PASSPORTISSUEDAT
E
Дата видачі паспорта співробітника в
форматі DD.MM.YYYY
D 8
7. PASSPORTISSUEPLA
CE Місце видачі паспорта співробітника C 120
8. BIRTHDAY Дата народження співробітника в
форматі DD.MM.YYYY D 8
9. EMBOSSIGLI Транслітерація прізвища та імені
співробітника для нанесення на
картку. Альтернативний варіант написання цього поля EMBOSSINGLIT
дозволяє замінювати деякі параметри співробітника, якщо він
вже був внесений
С 26
10. SEX Стать співробітника (M або F) C 1
11. BIRTHPLACE Місце народження співробітника C 60
12. CITIZENSHIP Код країни громадянства
співробітника (для України 804) N 3
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 44 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
13. RESIDENTTYPEID Резидентність (1- резидент, 2 -
нерезидент) N 1
14. RESIDENT_COUNTRY
ID
Код країни резидентності
співробітника (для України 804)
N 3
15. ADDRESS Повна домашня адреса
співробітника. Якщо заповнюється це поле, тоді всі
інші поля, що стосуються адреси співробітника, можна не зазначати. Примітка. Можливість зазначення
адреси в даному полі регулюється
внутрішніми налаштуваннями банку
С 254
16. ADDR_COUNTRYID Цифровий код країни домашньої
адреси співробітника N 3
17. ADDR_POSTCODE Почтовий індекс домашньої адреси
співробітника C 6
18. ADDR_REGION Область домашньої адреси
співробітника
C 40
19. ADDR_DISTRICT Район домашньої адреси
співробітника
C 40
20. ADDR_CITY Населений пункт домашньої адреси
співробітника C 36
21. ADDR_STREET Вулиця домашньої адреси
співробітника C 40
22. ADDR_HOUSENO Номер дома домашньої адреси
співробітника C 10
23. ADDR_FLAT Номер квартири домашньої адреси
співробітника
C 10
24. JURIDICALADDRESS Повна адреса розсилки.
Якщо заповнюється це поле, тоді всі інші поля, що стосуються адреси
співробітника, можна не зазначати. Примітка. Можливість зазначення
адреси в даному полі регулюється
внутрішніми налаштуваннями банку
С 254
25. JURADDR_COUNTRYI
D
Адреса для кореспонденції.
Цифровий код країни
N 3
26. JURADDR_POSTCOD
E
Адреса для кореспонденції.
Поштовий індекс
C 6
27. JURADDR_REGION Адреса для кореспонденції.
Найменування області
C 40
28. JURADDR_DISTRICT Адреса для кореспонденції.
Найменування району
C 40
29. JURADDR_CITY Адреса для кореспонденції.
Населений пункт
C 36
30. JURADDR_STREET Адреса для кореспонденції.
Вулиця
C 40
31. JURADDR_HOUSENO Адреса для кореспонденції.
Номер дома
C 10
32. JURADDR_FLAT Адреса для кореспонденції.
Номер квартири
C 10
33. ACCEPTANCEDATE Дата прийому співробітника на
роботу в форматі DD.MM.YYYY D 8
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 45 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
34. HOMEPHONE Домашній телефон співробітника в
форматі +380999999999 C 20
35. WORKPHONE Робочий телефон співробітника в
форматі +380999999999
C 20
36. MOBILEPHONE Мобільний телефон співробітника в
форматі +380999999999
C 20
37. TABNO Табельний номер співробітника.
Примітка. При імпорті не враховується. Це поле є доступним
тільки при експорті даних з web-клієнта
С 15
Примітка. Обов’язковість заповнення полів, що не позначені в таблиці як обов’язкові або необов’язкові, регулюється внутрішніми налаштуваннями банку.
Зразки файлів додаються до комплекту документації (див. «2.5.4.Export_Employees.html»).
2.5.5. Експорт реєстру звільнених співробітників
Файл експорту реєстру звільнених співробітників формується для автоматичного розсилання інформації про звільнених співробітників в банк.
Приклад:
<?xml version="1.0" encoding="UTF-8"?>
<DATAPACKET Version="2.0">
<FIREDEMPLOYEESINFO FIREDATE="01/01/2008">
<EMPLOYEES>
<EMPLOYEE B2ID="12345" IDENTIFYCODE="1234567890"
PASSPORTNO="МП123456" TABNO="01" CARDACCOUNTNO="262076005403"
LASTNAME="Прізвище" FIRSTNAME="Ім’я" MIDDLENAME="По батькові"/>
…
</EMPLOYEES>
</FIREDEMPLOYEESINFO>
</DATAPACKET>
№ Найменування
поля
Призначення/опис О/З
Інформація про дату звільнення, за якою сформовано файл
1. FIREDATE Дата звільнення співробітників в форматі
ДД/ММ/РРРР
+
Інформація про співробітників, звільнених на дату, зазначену в файлі
2. B2ID Ідентифікатор контрагента по співробітнику в
АБС Б2
+
3. IDENTIFYCODE Ідентифікаційний код співробітника +
4. PASSPORTNO Серія та номер паспорта співробітника +
5. TABNO Табельний номер співробітника. +
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 46 из 83
№ Найменування
поля Призначення/опис О/З
Якщо в ід. коді вказано значення 000000000 (співробітник нерезидент або відмовився від
присвоєння коду), це поле є обов'язковим для
заповнення
6. CARDACCOUNTNO Номер карткового (або іншого) рахунку
співробітника -
7. LASTNAME Прізвище співробітника +
8. FIRSTNAME Ім’я співробітника +
9. MIDDLENAME По батькові співробітника -
Зразки файлів додаються до комплекту документації (див. «2.5.5.Export_Fired_Employees.xml»).
2.6. Експорт даних про рахунки співробітників
2.6.1. Експорт до DBF-файлу
Файл експорту даних про рахунки співробітників містить список рахунків співробітників та вивантажується з системи iFOBS.eSalary для роботи в зовнішніх системах.
DBF-файл вивантажується в DOS-кодуванні та форматі DBASE-IV.
Кожен рядок файлів має фіксовану структуру, описану в таблиці нижче.
№ Найменування поля Призначення/опис Тип даних
Довжина поля
1. INN Ідентифікаційний код співробітника C 10
2. PASSPORTNO Номер паспорту співробітника C 25
3. ACCOUNTNO Номер карткового рахунку співробітника С 14
4. CURRENCYID Код валюти карткового рахунку N 20
5. BRANCHID МФО банку, в якому відкрито рахунок N 14
6. STATEID Стан рахунку N 3
Зразки файлів додаються до комплекту документації (див. «2.6.1.Export_Accounts.dbf»).
2.6.2. Експорт до CSV-файлу
Файл експорту даних про рахунки співробітників підприємства в CSV-форматі містить інформацію про рахунки співробітників підприємства. За роздільник використовується «;». Експорт здійснюється у форматі ANSI.
Файлу експорту привласнюється ім'я виду «МФО_USER.csv», де:
МФО – МФО банку;
USER – логін користувача iFOBS, що виконує експорт;
Приклад: 380526_S00876.csv
Кожен рядок файлу має структуру, описану в таблиці нижче.
№ Найменування поля Призначення/опис О/З
1. Картковий рахунок Номер карткового рахунку співробітника +
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 47 из 83
№ Найменування поля Призначення/опис О/З
2. ПIБ
ПІБ співробітника.
Прізвище, ім'я, по батькові розділені одним пробілом
+
3. IПН Ід. код співробітника +
4. ЗКП Код ЗКП +
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 48 из 83
3. ФОРМАТИ ФАЙЛІВ ІМПОРТУ ТА ЕКСПОРТУ, ВИКОРИСТОВУВАНІ В АБС Б2
3.1. Імпорт даних про співробітників
3.1.1. Імпорт з XML-файлу
Файл імпорту даних про співробітників підприємства містить інформацію про підприємства клієнта та його співробітників та формується з бухгалтерської програми клієнта.
Приклад:
<?xml version="1.0" encoding="windows-1251"?>
<DATAPACKET Version="2.0">
<ENTERPRISEINFO NAME="ООО 'Фирма'" IDENTIFYCODE="12345678"
NALOGREGISTERDATE="01/01/2005" NALOGREGISTERNO="" ADDRESS="Город, улица,
дом" CONTACTPHONES="01, 02, 03" CONTACTINFO="спросить Петю" FAX="-" EMAIL="-
">
<EMPLOYEES>
<EMPLOYEE ID="1" IDENTIFYCODE="1234567890" LASTNAME="Прізвище"
FIRSTNAME="Ім’я" MIDDLENAME="По батькові" EMBOSSIGLI="FAMILIA" SEX="M"
PASSPORTNO="ББ111111" PASSPORTISSUEDATE="01/01/2000"
PASSPORTISSUEPLACE="РОГУ МВД У" BIRTHDAY="01/01/1980" BIRTHPLACE="Город"
CITIZENSHIP="804" ADDRESS="Город, улица, дом" ADDR_COUNTRYID="804"
ADDR_POSTCODE="61000" ADDR_REGION="Область" ADDR_DISTRICT="Район"
ADDR_CITY="Город" ADDR_STREET="Улица" ADDR_HOUSENO="01" ADDR_FLAT="01"
JURADDR_COUNTRYID="804" JURADDR_POSTCODE="61000"
JURADDR_REGION="Область" JURADDR_DISTRICT="Район" JURADDR_CITY="Город"
JURADDR_STREET="Улица" JURADDR_HOUSENO="01" JURADDR_FLAT="01"
ACCEPTANCEDATE="01/01/2008" HOMEPHONE="+380571112233"
WORKPHONE="+380574445566" MOBILEPHONE="+380507778899" />
…
</EMPLOYEES>
</ENTERPRISEINFO>
</DATAPACKET>
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
Інформація про підприємство містить такі значення
1. NAME (*при імпорті не
враховується)
Назва підприємства. Якщо потрібні подвійні лапки ", їх
слід замінити на ' або "
C 30 -
2. IDENTIFYCODE Ідентифікаційний код підприємства N 10 -
3. NALOGREGISTERDA Дата реєстрації підприємства у D 8 -
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 49 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
TE податковій (в форматі ДД/ММ/РРРР)
4. NALOGREGISTERNO Номер реєстрації підприємства у
податковій
N 10 -
5. ADDRESS Повна адреса підприємства.
Якщо поле не заповнено або в ньому встановлений прочерк (знак мінус "-"), тоді при збереженні
запису про співробітника в адресі буде зазначено «Не визначено»
C 254 -
6. CONTACTPHONES Номер контактного телефону підприємства
C 20 -
7. CONTACTINFO Контактна інформація C 200 -
8. FAX Номер факсу підприємства C 20 -
9. EMAIL Адреса електронної пошти підприємства
C 100 -
10. SITEID МФО банку анкети співробітника, а
також контрагента-підприємства. Якщо параметр не заповнено, то
зазначається значення МФО банку поточного користувача АБС Б2
N 6 -
Інформація про співробітників містить такі значення
11. ID Порядковий номер співробітника N 10 -
12. IDENTIFYCODE Ідентифікаційний код співробітника (для нерезидентів, а також для резидентів, що відмовилися від
присвоєння ідентифікаційного коду, заповнюється значенням
«000000000»)
N 10 +
13. LASTNAME Прізвище співробітника С 38 +
14. FIRSTNAME Ім’я співробітника С 38 +
15. MIDDLENAME По батькові співробітника С 38
16. EMBOSSIGLI Транслітерація прізвища та імені
співробітника для нанесення на картку. Альтернативний варіант
написання цього поля EMBOSSINGLIT дозволяє замінювати деякі параметри співробітника, якщо
він вже був внесений
С 26
17. SEX Стать співробітника (M або F) C 1
18. PASSPORTNO Номер паспорту співробітника в форматі ББ999999 для резидентів
С 25 +
19. PASSPORTISSUEDAT
E
Дата видачі паспорту співробітника
в форматі ДД/ММ/РРРР
D 8
20. PASSPORTISSUEPLA
CE
Місце видачі паспорта співробітника C 120
21. BIRTHDAY Дата народження співробітника в
форматі ДД/ММ/РРРР
D 8
22. BIRTHPLACE Місце народження співробітника C 60
23. CITIZENSHIP Код країни громадянства
співробітника (для України 804)
N 3
24. ADDRESS Повна домашня адреса
співробітника. Якщо заповнюється це поле, тоді всі інші поля, що стосуються адреси
співробітника (25-32), можна не зазначати
С 254
25. JURADDRESS Повна адреса розсилки. Якщо заповнюється це поле, тоді всі інші поля, що стосуються адреси
розсилки (33-40), можна не
С 254
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 50 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
зазначати
26. ADDR_COUNTRYID Цифровий код країни домашньої
адреси співробітника
N 3
27. ADDR_POSTCODE Поштовий індекс домашньої адреси
співробітника
C 6
28. ADDR_REGION Область домашньої адреси
співробітника
С 40
29. ADDR_DISTRICT Район домашньої адреси співробітника
C 40
30. ADDR_CITY Населений пункт домашньої адреси співробітника
C 40
31. ADDR_STREET Вулиця домашньої адреси співробітника
C 40
32. ADDR_HOUSENO Номер будинку домашньої адреси співробітника
C 10
33. ADDR_FLAT Номер квартири домашньої адреси
співробітника
C 10
34. JURADDR_COUNTRY
ID
Адреса для кореспонденції.
Цифровий код країни
N 3
35. JURADDR_POSTCOD
E
Адреса для кореспонденції.
Поштовий індекс
C 6
36. JURADDR_REGION Адреса для кореспонденції. Найменування області
С 40
37. JURADDR_DISTRICT Адреса для кореспонденції. Найменування району
C 40
38. JURADDR_CITY Адреса для кореспонденції. Населений пункт
C 40
39. JURADDR_STREET Адреса для кореспонденції. Вулиця
C 40
40. JURADDR_HOUSENO Адреса для кореспонденції.
Номер дома
C 10
41. JURADDR_FLAT Адреса для кореспонденції.
Номер квартири
C 10
42. ACCEPTANCEDATE Дата прийому співробітника на роботу в форматі ДД/ММ/РРРР
D 8
43. HOMEPHONE Домашній телефон співробітника в форматі +380999999999
(обов'язково повинен бути зазначений хоча б один телефон - домашній, мобільний або робочий)
C 30
44. WORKPHONE Робочий телефон співробітника в форматі +380999999999
(обов'язково повинен бути зазначений хоча б один телефон - домашній, мобільний або робочий)
C 30
45. MOBILEPHONE Мобільний телефон співробітника в форматі +380999999999
(обов'язково повинен бути зазначений хоча б один телефон - домашній, мобільний або робочий)
C 30
46. RESIDENT_COUNTRYID
Код країни резидентності співробітника.
Якщо цей параметр відсутній або не заповнений, за умовчанням заповнюється значенням цифрового
коду країни домашньої адреси співробітника (поле
ADDR_COUNTRYID). Якщо поле ADDR_COUNTRYID не заповнено, за умовчанням код України - «804»
N 3 -
47. REGBYSELFBUSY Ознака того, що співробітник N 1
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 51 из 83
№ Найменування поля Призначення/опис Тип даних
Довжина
поля
О/З
«Зареєстрований як самозайнята ФО»:
0 – ні
1 – так
48. SECURITYANSWER Секретна відповідь C 60
49. DESCRIPTION Додаткова інформація з прив’язки
співробітника до підприємства (для поля Примітка)
С 100 -
Примітка. Обов’язковість заповнення полів, що не позначені в таблиці як обов’язкові або необов’язкові, регулюється внутрішніми налаштуваннями банку.
Зразки файлів додаються до комплекту документації (див. «3.1.1.Import_Employees.xml»).
3.1.2. Імпорт з TXT-файлу (Майстер підключення)
В системі передбачено можливість імпорту файлів даних про співробітників підприємства до Майстра підключення (Документы/Внешние системы/IFOBS/ Зарплатный проект/Настройки/Привязка зарплатных проектов к контрагентам).
Кожен рядок файлу має фіксовану структуру, описану нижче:
Перший рядок текстового файлу має містити інформацію про підприємство та зарплатний проект, за яким буде заповнюватися інформація про співробітників.
№ Найменування Тип Довж
ина
Положення у
рядку
1. Ідентифікаційний код контрагента-
підприємства С 14 1 –14
2. Код зарплатного проекту N 10 15-24
Усі наступні рядки – інформаційні та кожен новий рядок містить інформацію про одного співробітника.
№ Найменування Тип Довж
ина
Положення у
рядку
1. Ідентифікаційний код співробітника С 14 1 – 14
2. Серія та номер паспорту співробітника С 25 15-39
3. Рахунок співробітника в АБС С 14 40-53
4. Валюта рахунку співробітника N 3 54-56
При імпорті файлу передбачено ряд додаткових перевірок, від результатів яких залежить подальша поведінка Майстра підключення:
1. Якщо у файлі імпорту не зазначено номер рахунку:
Перевірка номера рахунку не виконується;
Запис імпортується без номера рахунку;
Перелік записів, імпортованих без номера рахунку, буде відображено у
протоколі;
Операціоніст відмічає рахунок, що підключається, в ручному режимі.
2. Якщо у файлі імпорту номер рахунку зазначено:
Виконується перевірка наявності рахунку та відповідності його номера контрагенту співробітника, а також його статус;
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 52 из 83
Якщо у контрагента співробітника зазначений рахунок відсутній або рахунок було закрито, запис не імпортується;
Перелік записів, що не було імпортовано, буде відображено в протоколі;
Операціоніст може внести зміни в файл та імпортувати його ще раз.
3. Перевірка валюти рахунку:
Якщо валюта рахунку не зазначена, приймається значення за умовчанням – 980 (гривня);
Якщо зазначено валюту рахунку, що відрізняється від 980 (гривня), запис не імпортується;
Перелік записів, що не було імпортовано, буде відображено в протоколі;
Операціоніст може внести зміни в файл та імпортувати його ще раз.
Зразки файлів додаються до комплекту документації (див. «3.1.2.Import_Employees.txt»).
3.2. Імпорт даних про рахунки співробітників
3.2.1. Імпорт з XML-файлу
Файл імпорту даних про рахунки співробітників підприємства містить інформацію про співробітників підприємства, зареєстрованих в зарплатному проекті на стороні банка з інформацією про створені карткові рахунки співробітників в системі емісії платіжних карток.
Приклад:
<?xml version="1.0" encoding="windows-1251"?>
<DATAPACKET Version="2.0">
<ENTERPRISEINFO CLIENTID="2008" NAME="ООО Папа" IDENTIFYCODE="112233445">
<EMPLOYEES>
<EMPLOYEE IDENTIFYCODE="000000000" CARDACCOUNTNO="262512345678"
CURRENCYID="980" BRANCHID="123456" LASTNAME="Иванов" FIRSTNAME="Иван"
MIDDLENAME="Иванович" />
</EMPLOYEES>
</ENTERPRISEINFO>
</DATAPACKET>
Опис:
В XML файл може бути включено додатковий заголовок, в якому міститься така інформація:
version="1.0" – версія використовуваного XML парсера;
encoding="windows-1251" – кодування Windows, що підтримує цей формат;
DATAPACKET Version="2.0" – робоча версія підсистеми iFOBS.eSalary.
№ Найменування поля Призначення/опис
Інформація про підприємство містить такі значення
1. CLIENTID ID код клієнта в підсистемі iFOBS.eSalary
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 53 из 83
№ Найменування поля Призначення/опис
2. NAME Найменування підприємства
3. IDENTIFYCODE Ідентифікаційний код
Інформація про рахунки співробітників містить такі значення
4. IDENTIFYCODE Ідентифікаційний код співробітника
5. CARDACCOUNTNO Номер карткового (або іншого) рахунку
співробітника
6. CURRENCYID Код валюти рахунку
7. BRANCHID МФО банку, якому відкрито рахунок
8. PASSPORTNO Серія та номер паспорту співробітника (обов’язково для заповнення, якщо в
ідентифікаційному коді зазначено 000000000)
9. LASTNAME Прізвище співробітника
10. FIRSTNAME Ім’я співробітника
11. MIDDLENAME По батькові співробітника
12. SALARYPROJECTCODE Код зарплатного карткового проекту, в рамках якого обслуговується співробітник. Якщо параметр заповнений, рахунок імпортується тільки для цього
ЗКП, інакше - для всіх ЗКП.
Примітка. Зазначається тільки для банків, що
використовують ЗКП
Зразки файлів додаються до комплекту документації (див. «3.2.1.Import_Accounts.xml»).
3.2.2. Імпорт з DBF-файлу, сформованого модулем BCZ Card v.3.0
Файл імпорту даних про рахунки співробітників підприємства містить інформацію про співробітників підприємства, зареєстрованих в зарплатному проекті на стороні банку з інформацією, та створених карткових рахунків співробітників в системі емісії платіжних карток.
DBF-файл має імпортуватися в DOS-кодуванні та форматі DBASE-IV.
Нижче описано послідовність полів для імпортованого файлу:
№ Найменування поля Призначення/опис Тип
даних
Довжина
поля
1. SBK_ID Ідентифікаційний код співробітника N 10
2. SBK_FIO Прізвище, ім’я та по батькові
співробітника C 40
3. SBK_PNO Номер паспорту співробітника (якщо поле SBK_PNO не заповнено, пошук співробітника виконується за ід.
кодом)
С 8
4. SBK_NUM Номер карткового рахунку (валюта
рахунку - гривня) C 20
5. SBK_SUM Сума зарахування N 10,2
6. SBK_SPC Код зарплатного карткового проекту,
в рамках якого обслуговується співробітник. Якщо параметр
заповнено, рахунок імпортується тільки для даного ЗКП, інакше - для
всіх ЗКП.
Примітка. Зазначається тільки для
банків, що використовують ЗКП
С 10
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 54 из 83
Зразки файлів додаються до комплекту документації (див. «3.2.2.Import_Accounts.dbf»).
3.3. Експорт даних про співробітників
3.3.1. Експорт для вивантаження до системи «Transmaster»
В системі АБС Б2 реалізовано можливість вивантаження даних про співробітників у форматі файлу «Transmaster» для його подальшого імпорту в однойменну систему емісії карток.
Файл містить інформацію про співробітників підприємств, у яких зазначено зарплатний проект. Інформація буде імпортуватися в систему «Transmaster».
Файлу експорту інформації про співробітників для вивантаження в «Transmaster» привласнюється назва виду «IMDDDNNN.BBG», де:
IM – імпорт (ознака, яка вказує, що файл далі буде імпортуватися в зовнішні системи);
DDD – порядковий номер дня в році (001 .. 366);
NNN – номер файлу в день;
BB – код банку;
G – ідентифікатор банку.
Приклад назви файлу: im187001.02a.
Кожен рядок файлу має фіксовану структуру, описану в таблиці нижче.
Заголовок
Перший рядок файлу експорту являє собою заголовок документа та містить наступні дані:
№ Назва поля Опис Тип дани
х
Позиції Макс. довжина поля
1. Code Код файлу.
Завжди заповнюється значенням «00» С 1 2
2. Row number Номер рядка.
Для заголовку завжди заповнюється значенням «000001»
N 3 6
3. Filename (without extension)
Ім’я файлу без розширення С 9 8
4. Structure version Завжди заповнюється значенням «0105» С 17 4
5. File date Дата створення файлу в форматі
ДДММРРРР D 21 8
Запис типу 10 (реєстрація клієнта)
Примітка. Поля, позначені в таблиці сірим кольором, імпортуватися в «Transmaster» не будуть, тому їх можна заповнювати пробілами.
№ Назва поля Опис Тип
дани
х
Позиції Макс.
довжин
а поля
1. Code Код запису. Завжди заповнюється значенням «10»
С 1 2
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 55 из 83
№ Назва поля Опис Тип дани
х
Позиції Макс. довжин
а поля
2. Row Number Номер рядку в файлі.
Для першого клієнта буде значення «000002».
N 3 6
3. Order number Номер заказу. Завжди заповнюється значенням «1»
N 9 20
4. Action Тип дії:
01 – введення нового клієнта, 02 – оновлення даних клієнта.
Завжди заповнюється значенням «01»
C 29 2
5. Client_b Код клієнта в банківській системі. заповнюється або наскрізним лічильником
«100001», або рахунком співробітника 2625% з АБС Б2 – залежно від константи
SAL_ACCOUNTSANALYTICS
C 31 16
6. Cl_Type Тип клієнта: 1 – Фіз. особа,
2 – Юр. особа. Завжди заповнюється значенням «1», тому
що всі зарплатні клієнти в Трансмастері вважаються фіз. особами
C 47 1
7. Cln_Cat Категорія клієнта.
Завжди заповнюється значенням «101» - фіз. особа, тому що всі зарплатні клієнти в
Трансмастері вважаються фіз. особами
C 48 3
8. F_Names Ім’я та по батькові співробітника з картки контрагента
C 51 34
9. Surname Прізвище співробітника з карточки контрагента
C 85 20
10. M_Name Пароль. заповнюється значенням параметра
«Секретна відповідь» з картки співробітника
C 105 20
11. B_Date Дата народження співробітника в форматі ддммрррр
D 125 8
12. Person_Code Ідентифікаційний код співробітника C 133 20
13. Title Титул клієнта.
Завжди заповнюється значенням «01»
C 153 2
14. Sex Стать співробітника:
1 - чоловік 2 - жінка
C 155 1
15. Marital_Statu
s
Сімейний стан співробітника.
Не враховується при імпорті
C 156 1
16. Cmp_Name Назва підприємства, де працює співробітник C 157 34
17. Cmpg_Name Не враховується при імпорті C 191 24
18. Reg_Nr Не враховується при імпорті C 215 25
19. C_Since Не враховується при імпорті C 240 4
20. Resident Резидентність співробітника: 1-резидент
2- нерезидент
C 244 1
21. Resident_Sinc
e
Резидент з якого часу.
Не враховується при імпорті
D 245 8
22. Doc_Type Тип ідентифікаційного документу.
Завжди заповнюється значенням «001»
C 253 3
23. Id_Card Номер паспорту. Для громадянина України заповнюється
номером паспорту. Для не громадянина України заповнюється значенням параметру
«серія та номер паспорта» з картки співробітника
C 256 16
24. Serial_No Серія паспорта.
Для громадянина України заповнюється серією паспорту. Для не громадянина
C 272 15
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 56 из 83
№ Назва поля Опис Тип дани
х
Позиції Макс. довжин
а поля
України Не враховується при імпорті
25. Doc_Since Дата видачі паспорту в форматі ДДММРРРР D 287 8
26. Issued_By Місце видачі документа C 295 120
27. Comp_Code Реєстраційний номер (код) компанії – місця роботи співробітника.
заповнюється значенням, зазначеним операціоністом при вивантаженні файлу (з довідника «Организация (зарплатный
проект)» (Організація (зарплатний проект))
C 415 5
28. R_Street Юр. адреса підприємства – «Вулиця», «Номер дома», «Квартира» (с закладки «Адреса для кореспонденції» из картки
співробітника). Якщо в картці співробітника параметри адреси заповнено тільки в параметрі
«Адреса», то вноситься саме це значення
C 420 60
29. R_City Юр. адреса підприємства – «Населений
пункт»
C 480 20
30. R_Cntry Юр. адреса підприємства – «Країна» C 500 3
31. R_Pcode Юр. адреса підприємства – «Поштовий індекс»
C 503 7
32. Region Юр. адреса підприємства – «Область» C 510 2
33. R_Phone Домашній номер телефону співробітника C 512 15
34. R_E_Mails E-mail співробітника C 527 100
35. R_Mob_Phone Мобільний телефон співробітника C 627 15
36. R_Fax Не враховується при імпорті C 642 15
37. Position Не враховується при імпорті C 657 26
38. Emp_Name Місце роботи співробітника. заповнюється значенням параметра
«Підприємство» з прив’язки співробітника до підприємства, за яким вивантажується файл
C 683 34
39. Emp_Date Дата прийому співробітника на зазначене
підприємство в форматі ДДММРРРР
D 717 8
40. Work_Phone Робочій телефон співробітника C 725 15
41. Emp_Adr Не враховується при імпорті C 740 120
42. Emp_Fax Не враховується при імпорті C 860 15
43. Emp_E_Mails Не враховується при імпорті C 875 100
44. Cnt_Name Не враховується при імпорті C 975 25
45. Cnt_Title Не враховується при імпорті C 1000 2
46. Cnt_Positon Не враховується при імпорті C 1002 26
47. Cnt_Phone Не враховується при імпорті C 1028 15
48. Cnt_Fax Не враховується при імпорті C 1043 15
49. Cnt_Mob_Pho
ne
Не враховується при імпорті C 1058 15
50. Cnt_E_Mails Не враховується при імпорті C 1073 100
51. Mng_Name Не враховується при імпорті C 1173 25
52. Mng_Title Не враховується при імпорті C 1198 2
53. Mng_Posit Не враховується при імпорті C 1200 25
54. Mng_Phone Не враховується при імпорті C 1225 15
55. Mng_Fax Не враховується при імпорті C 1240 15
56. Mng_Mob_Phone
Не враховується при імпорті C 1255 15
57. Mng_E_Mails Не враховується при імпорті C 1270 100
58. Year_Inc Не враховується при імпорті N 1370 14
59. Ccy_For_Incom
Не враховується при імпорті C 1384 3
60. Imm_Prop_V Не враховується при імпорті N 1387 14
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 57 из 83
№ Назва поля Опис Тип дани
х
Позиції Макс. довжин
а поля
alue
61. U_Cod1 Не враховується при імпорті C 1401 3
62. U_Cod2 Не враховується при імпорті C 1404 6
63. U_Cod3 Не враховується при імпорті C 1410 6
64. U_Field1 Не враховується при імпорті C 1416 20
65. U_Field2 Не враховується при імпорті C 1436 20
66. Comment Не враховується при імпорті C 1456 100
67. Call_Id Не враховується при імпорті C 1556 10
68. Status Статус клієнта. Завжди заповнюється значенням «10» -
активний
C 1566 2
69. Product_code Не враховується при імпорті C 1568 10
70. F_name1 По батькові співробітника. Поле використовується тільки коли в системі
«Transmaster» встановлено можливість ввести ім’я по батькові клієнта. При цьому значення поля «F_names» не
використовується
C 1578 20
71. Midle_name Ім’я та по батькові клієнта.
Поле використовується тільки коли в системі «Transmaster» встановлено можливість ввести ім’я по батькові клієнта
C 1598 20
72. Mb_Client Не враховується при імпорті N 1618 1
73. Mb_Merchant Не враховується при імпорті C 1619 15
74. Future Use Не враховується при імпорті С 1634 490
Запис типу 20 (реєстрація договору)
№ Найменування
поля Опис Тип
дани
х
Позиції Макс. довжин
а поля
38. Code Код запису.
Завжди заповнюється значенням «20»
C 1 2
39. Row Number Номер рядку в файлі.
Наприклад, якщо був тільки один клієнт,
буде вказано значення «000003»
N 3 6
40. Order number Номер замовлення.
Завжди заповнюється значенням «1»
N 9 20
41. Action Тип дії:
01 – введення нового клієнта,
02 – оновлення даних клієнта.
Завжди заповнюється значенням «01»
C 29 2
42. Client_b Код клієнта в банківській системі.
Заповнюється або наскрізним лічильником
«100001», або рахунком співробітника 2625% з АБС Б2 – залежно від константи
SAL_ACCOUNTSANALYTICS
C 31 16
43. Branch Філія Банку - емітента, що уклав договір з
клієнтом.
Заповнюється значенням, отриманим
конкатенацією значень «02» та коду філії, зазначеного операціоністом при вивантаженні файлу (з довідника «Филиал
банка» (філія банку).
C 47 5
44. Bincod BIN-код. C 52 9
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 58 из 83
№ Найменування
поля Опис Тип
дани
х
Позиції Макс. довжин
а поля
Заповнюється значенням, зазначеним
операціоністом при вивантаженні файлу (з
довідника «BIN-код»).
45. Enrolled Дата укладення угоди в форматі ДДММРР D 61 8
46. Contract Не враховується при імпорті C 69 15
47. Risk_Level Не враховується при імпорті C 84 1
48. Rep_Lang Мова формування звітів клієнту:
1 – English;
2 – Latvian
3 – Русский
4 – Lithuanian
Завжди заповнюється значенням «3»
C 85 1
49. Distrib_Mode Не враховується при імпорті C 86 2
50. Street Поштова адреса співробітника – «Вулиця», «Дім» з закладення «Домашня адреса» на
картці співробітника
C 88 60
51. City Поштова адреса співробітника – «Населений пункт» з закладення
«Домашня адреса» на картці співробітника
C 148 20
52. Country Поштова адреса співробітника – «Країна» з закладення «Домашня адреса» на картці
співробітника
C 168 3
53. Post_Ind Поштова адреса співробітника –
«Індекс» з закладення «Домашня адреса»
на картці співробітника
C 171 7
54. E_Mails Поштова адреса співробітника –
«E-mail співробітника» с закладення
«Телефони» з картки співробітника
C 178 100
55. Isurance_Type Не враховується при імпорті C 278 2
56. U_Cod4 Не враховується при імпорті C 280 3
57. U_Code5 Не враховується при імпорті C 283 6
58. U_Code6 Не враховується при імпорті C 289 6
59. U_Field3 Не враховується при імпорті C 295 20
60. U_Field4 Не враховується при імпорті C 315 20
61. Comment Не враховується при імпорті C 335 100
62. Status Статус клієнта.
Завжди заповнюється значенням «10» -
активний
C 435 2
63. Card_acct Не враховується при імпорті C 437 20
64. Risk_Level Не враховується при імпорті C 457 5
65. Product_code Код продукту.
Якщо договір новий, то параметр завжди
зазначається (значення «02»)
C 462 10
66. Office Не враховується при імпорті C 472 8
67. branch Не враховується при імпорті C 480 7
68. Card_acct Не враховується при імпорті C 487 34
69. Future Use Не враховується при імпорті C 521 485
Запис типу 30 (дані про картковий рахунок)
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 59 из 83
№ Найменування
поля Опис Тип
дани
х
Позиції Макс. довжин
а поля
1. Code Код запису.
Завжди заповнюється значенням «30»
С 1 2
2. Row Number Номер рядку в файлі.
Наприклад, якщо був тільки один клієнт,
буде вказано значення «000004»
N 3 6
3. Order number Номер замовлення.
Завжди заповнюється значенням «1»
N 9 20
4. Action Тип дії:
01 – введення нового клієнта,
02 – оновлення даних клієнта
Завжди заповнюється значенням «01»
C 29 2
5. Client_b Код клієнта в банківській системі.
Заповнюється або наскрізним лічильником «100001», або рахунком співробітника
2625% з АБС Б2 – залежно від константи
SAL_ACCOUNTSANALYTICS
C 31 16
6. Bin BIN-код.
заповнюється значенням, зазначеним операціоністом при вивантаженні файлу (з
довідника «BIN-код»).
C 47 9
7. Contract Не враховується при імпорті C 56 15
8. Card_Acct Не враховується при імпорті C 71 20
9. Ccy Валюта рахунку.
Завжди заповнюється значенням «UAH»
C 91 3
10. Cond_Set Набір умов рахунку.
Заповнюється значенням, зазначеним операціоністом при вивантаженні файлу (з
довідника «Условия счета» (умови
рахунку)).
C 94 3
11. Account type Тип рахунку.
Завжди заповнюється значенням «00»
C 97 2
12. Adjust_Flag Індикатор генерації регулювальних
транзакції:
0 – вимкнено
1 – увімкнено
Завжди заповнюється значенням «0»
C 99 1
13. Stat_Change Режим змінення статусу рахунку.
Завжди заповнюється значенням «1»
C 100 1
14. Crd Дозволений кредит.
Завжди заповнюється значенням «0»
N 101 14
15. Min_Bal Мінімальний баланс.
Завжди заповнюється значенням «0»
N 115 12
16. Non_Reduce_B
al Незнижуваний залишок.
Завжди заповнюється значенням «0»
N 127 14
17. Tranz_Acct Не враховується при імпорті C 141 20
18. Auth_Bonus Не враховується при імпорті N 161 14
19. Ab_Expirity Не враховується при імпорті D 175 8
20. Deposit_Accou
nt Не враховується при імпорті C 183 20
21. Deposit Не враховується при імпорті N 203 14
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 60 из 83
№ Найменування
поля Опис Тип
дани
х
Позиції Макс. довжин
а поля
22. Deposit_Come
nt Не враховується при імпорті C 217 30
23. U_Cod7 Не враховується при імпорті C 247 3
24. U_Cod8 Не враховується при імпорті C 250 6
25. Ufield_5 Не враховується при імпорті C 256 20
26. U_Field6 Не враховується при імпорті C 276 25
27. Message Не враховується при імпорті C 301 120
28. Agr_amount Не враховується при імпорті N 421 12
29. Dep_exp_date Не враховується при імпорті D 433 8
30. Dep_open_f Не враховується при імпорті C 441 1
31. Dep_front_f Не враховується при імпорті C 442 1
32. R_card_acct Не враховується при імпорті C 443 20
33. R_card_oper_a
cct Не враховується при імпорті C 463 20
34. R_card_oper_c
cy Не враховується при імпорті C 483 3
35. R_card_acctb Не враховується при імпорті C 486 1
36. R_card_bacct Не враховується при імпорті C 487 21
37. Crd_expiry Не враховується при імпорті C 508 8
38. Card Acct Не враховується при імпорті C 516 34
39. Tranz_Acct Не враховується при імпорті C 550 34
40. Future Use Не враховується при імпорті C 584tr 68
41. cicle Завжди заповнюється значенням «1» N 652 1
42. - Не враховується при імпорті (резерв) - 653 431
Запис типу 50 (дані про картку)
№ Найменування
поля Опис Тип
дани
х
Позиції Макс. довжин
а поля
1. Code Код запису.
Завжди заповнюється значенням «50»
С 1 2
2. Row Number Номер рядку в файлі.
Наприклад, якщо був тільки один клієнт,
буде вказано значення «000005»
N 3 6
3. Order number Завжди заповнюється значенням «1» N 9 20
4. Action Номер замовлення.
Завжди заповнюється значенням «01»
C 29 2
5. Client_b Код клієнта в банківській системі.
заповнюється або наскрізним лічильником «100001», або рахунком співробітника
2625% з АБС Б2 – залежно від константи
SAL_ACCOUNTSANALYTICS
C 31 16
6. Card Не враховується при імпорті C 47 19
7. Card expiry Не враховується при імпорті C 66 4
8. Bin BIN-код.
Заповнюється значенням, зазначеним
операціоністом при вивантаженні файлу (з
довідника «BIN-код»).
C 70 9
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 61 из 83
№ Найменування
поля Опис Тип
дани
х
Позиції Макс. довжин
а поля
9. Card_Type Тип картки.
Завжди заповнюється значенням «01»
C 79 2
10. Base_Supp Інформація про пріоритетності картки:
1 - основна
2 - додаткова
Завжди заповнюється значенням «1»
C 81 1
11. Cond_Set Набор умов картки.
Заповнюється значенням, зазначеним операціоністом при вивантаженні файлу (з
довідника «Условия карт» (умови карток)).
C 82 3
12. Auth_Limit Авторизаційний ліміт [0..9].
Поле обов’язково заповнювати, якщо
довжина BIN-коду – 6 символів.
Завжди заповнюється значенням «0»
C 85 1
13. Risk_Level Рівень риску.
Завжди заповнюється значенням «А»
C 86 1
14. Pin Flag Інформація про генерації PIN-коду:
1 – PIN-код генерується,
0 - PIN-код не генерується.
Завжди заповнюється значенням «1»
C 87 1
15. Card_Name Ім’я та прізвище власника картки.
Заповнюється значенням параметра «Транслітерація імені клієнта» з картки
співробітника
C 88 24
16. M_Name Пароль карти.
Заповнюється значенням параметру
«Секретна відповідь» з картки
співробітника
C 112 20
17. Relation Не враховується при імпорті C 132 25
18. Id_Card Не враховується при імпорті C 157 16
19. B_Date Дата народження власника картки.
Заповнюється значенням параметру «День
народження» з картки співробітника
D 173 8
20. Cmpg_Name Назва підприємства співробітника.
Заповнюється значенням параметру«Підприємство» з прив’язки співробітника до підприємства, за яким
вивантажується файл
C 181 24
21. Insuranc_Type Не враховується при імпорті C 205 2
22. Crd_Hold_Msg Не враховується при імпорті C 207 99
23. U_Cod9 Не враховується при імпорті C 306 3
24. U_Cod10 Не враховується при імпорті C 309 6
25. U_Field7 Не враховується при імпорті C 315 20
26. U_Field8 Не враховується при імпорті C 335 20
27. Call_Id Не враховується при імпорті C 355 10
28. Card_Acct Не враховується при імпорті C 365 20
29. F_names Не враховується при імпорті C 385 34
30. Surname Не враховується при імпорті C 419 20
31. Doc_since Не враховується при імпорті C 439 8
32.
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 62 из 83
№ Найменування
поля Опис Тип
дани
х
Позиції Макс. довжин
а поля
33. Rrisk_Level Не враховується при імпорті C 447 5
34. Old_Client Не враховується при імпорті C 452 16
35. Card_services_
set Не враховується при імпорті C 468 16
36. F_name1
Не враховується при імпорті C 484 20
37. Midle_name Не враховується при імпорті C 504 20
38. Serial_no Не враховується при імпорті C 524 10
39. App_id Не враховується при імпорті N 534 10
40. Design_id Не враховується при імпорті N 544 10
41. Off_cond_set Не враховується при імпорті C 554 3
42. Mb_Card Не враховується при імпорті N 557 1
43. Mb_Phone Не враховується при імпорті C 558 15
44. PARTNER_ID Не враховується при імпорті C 573 20
45. SURNAME Не враховується при імпорті C 593 24
46. Insurance flag Не враховується при імпорті C 617 1
47. Effective date Не враховується при імпорті C 618 4
48. Card_acct Не враховується при імпорті C 622 34
49. Future Use Не враховується при імпорті 656 463
Хвостовик
№ Название поля Опис Тип дани
х
Позиции Макс. довжин
а поля
1. Code Код запису.
Завжди заповнюється значенням «99»
С 1 2
2. Row number Номер рядку в файлі.
Якщо був тільки один клієнт, то повинно
бути заповнене значенням «000006»
N 3 6
3. Checksum Кількість рядків у файлі (не беручі до
уваги заголовок та хвостовик) N 9 6
Зразки файлів додаються до комплекту документації (див. «3.3.1.im018001.02a»).
3.3.2. Експорт до XML–файлу
Файл експорту даних про співробітників підприємства містить інформацію про підприємства клієнта та його співробітників.
Приклад:
<DATAPACKET>
<ENTERPRISEINFO NAME="Umbr" IDENTIFYCODE="04591423"
NALOGREGISTERDATE="01/11/2008" NALOGREGISTERNO="2345124"
CONTACTPHONES="-" CONTACTINFO="-" FAX="-" EMAIL="-">
<EMPLOYEES>
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 63 из 83
<EMPLOYEE ID="1665" IDENTIFYCODE="2407500011" LASTNAME="Ушаков"
FIRSTNAME="Григорий" MIDDLENAME="Николаевич" EMBOSSIGLI="USHAKOV
GRIGORIY" SEX="M" PASSPORTNO="АК301101" PASSPORTISSUEDATE="22/11/2000"
PASSPORTISSUEPLACE="Дмитрiвка" BIRTHDATE="30/11/1965" BIRTHPLACE="Дмитрiвка"
CITIZENSHIP="804" ADDRESS="-" ADDR_COUNTRYID="804" ADDR_POSTCODE="123321"
ADDR_REGION="Вінницька область" ADDR_DISTRICT="Перший район"
ADDR_CITY="Дмитрiвка" ADDR_STREET="Молодіжна" ADDR_HOUSENO="2"
ADDR_FLAT="34" JURIDICALADDRESS="-" JURADDR_COUNTRYID="804"
JURADDR_POSTCODE="123321" JURADDR_REGION="Вінницька область"
JURADDR_DISTRICT="Перший район" JURADDR_CITY="Вінниця"
JURADDR_STREET="Шевченко" JURADDR_HOUSENO="54" JURADDR_FLAT="12"
ACCEPTANCEDATE="14/11/2011" HOMEPHONE="-" WORKPHONE="-"
MOBILEPHONE="+380669514256"/>
</EMPLOYEES>
</ENTERPRISEINFO>
</DATAPACKET>
№ Найменування поля Призначення/опис
Інформація про підприємство містить такі значення
1. NAME
Назва підприємства.
2. IDENTIFYCODE Ідентифікаційний код підприємства
3. NALOGREGISTERDA
TE Дата реєстрації підприємства у податковій (в форматі
ДД/ММ/РРРР)
4. NALOGREGISTERNO Номер реєстрації підприємства у податковій
5. CONTACTPHONES Номер контактного телефону підприємства
6. CONTACTINFO Контактна інформація
7. FAX Номер факсу підприємства
8. EMAIL Адреса електронної пошти підприємства
Інформація про співробітниках містить такі значення
9. ID Порядковий номер співробітника
10. IDENTIFYCODE Ідентифікаційний код співробітника
11. LASTNAME Прізвище співробітника
12. FIRSTNAME Ім’я співробітника
13. MIDDLENAME По батькові співробітника
14. EMBOSSIGLI Транслітерація прізвища та імені співробітника для нанесення на
картку. Альтернативний варіант написання поля EMBOSSINGLIT дозволяє замінювати деякі параметри співробітника, якщо він вже
був внесений
15. SEX Стать співробітника (M або F)
16. PASSPORTNO Номер паспорту співробітника в форматі ББ999999 для резидентів
17. PASSPORTISSUEDAT
E Дата видачі паспорту співробітника в форматі ДД/ММ/РРРР
18. PASSPORTISSUEPLA
CE Місце видачі паспорту співробітника
19. BIRTHDATE Дата народження співробітника в форматі ДД/ММ/РРРР
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 64 из 83
№ Найменування поля Призначення/опис
20. BIRTHPLACE Місце народження співробітника
21. CITIZENSHIP Код країни громадянства співробітника (для України 804)
22. ADDRESS Повна домашня адреса співробітника.
Якщо заповнюється це поле, тоді всі інші поля щодо адреси
співробітника (25-32) можна не зазначати.
Примітка. Можливість вказівки адреси в даному полі регулюється
внутрішніми налаштуваннями банку
23. JURIDICALADDRESS Повна адреса розсилки.
Якщо заповнюється це поле, тоді всі інші поля щодо адреси
розсилки (32-39) можна не зазначати.
Примітка. Можливість вказівки адреси в даному полі регулюється
внутрішніми налаштуваннями банку
24. ADDR_COUNTRYID Цифровий код країни домашньої адреси співробітника
25. ADDR_POSTCODE Поштовий індекс домашньої адреси співробітника
26. ADDR_REGION Область домашньої адреси співробітника
27. ADDR_DISTRICT Район домашньої адреси співробітника
28. ADDR_CITY Населений пункт домашньої адреси співробітника
29. ADDR_STREET Вулиця домашньої адреси співробітника
30. ADDR_HOUSENO Номер дома домашньої адреси співробітника
31. ADDR_FLAT Номер квартири домашньої адреси співробітника
32. JURADDR_COUNTRY
ID Адреса для кореспонденції.
Цифровий код країни
33. JURADDR_POSTCOD
E Адреса для кореспонденції.
Поштовий індекс
34. JURADDR_REGION Адреса для кореспонденції.
Найменування області
35. JURADDR_DISTRICT Адреса для кореспонденції. Найменування району
36. JURADDR_CITY Адреса для кореспонденції. Населений пункт
37. JURADDR_STREET Адреса для кореспонденції.
Вулиця
38. JURADDR_HOUSENO Адреса для кореспонденції.
Номер дома
39. JURADDR_FLAT Адреса для кореспонденції.
Номер квартири
40. ACCEPTANCEDATE Дата прийому співробітника на роботу в форматі ДД/ММ/РРРР
41. HOMEPHONE Домашній телефон співробітника в форматі +380999999999
42. WORKPHONE Робочій телефон співробітника в форматі +380999999999
43. MOBILEPHONE Мобільний телефон співробітника в форматі +380999999999
Зразки файлів додаються до комплекту документації (див. «3.3.2.XML_EMPLOYEES_ООО МММ.xml»).
3.3.3. Експорт до формату IS-Card
Файл експорту даних до системи IS-Card містить інформацію про клієнтів-фізичних осіб для реєстрації в системі IS-Card.
Файлу експорту даних до системи IS-Card привласнюється найменування виду ReYYMDNNN.prv де:
Re – префікс файлу;
YY – рік (00 – 99);
М – номер місяця:1, 2, 3, 4, 5, 6, 7, 8, 9, A (10), B (11), C (12);
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 65 из 83
D – порядковий номер дня в місяці, який позначається цифрою, відповідно до порядкового номеру дня для перших 9 днів, та літерою для інших чисел місяця:
1 A – 10 L – 21
2 B – 11 M – 22
3 C – 12 N – 23
4 D – 13 O – 24
5 E – 14 P – 25
6 F – 15 Q – 26
7 G – 16 R – 27
8 H – 17 S – 28
9 I – 18 T – 29
J – 19 U – 30
K – 20 V – 31
NNN – число в 36-ричній системі, N – символ з набору [0-9;A-Z]
При формуванні імені файлу символи YYMD визначають календарну дату формування файлу, NNN – порядковий номер файлу в поточній календарній даті.
Кожний запис файлу закінчується символами CR+LF.
Кожний рядок файлу має фіксовану структуру, що описана в таблиці нижче.
Заголовок
Перший рядок експорту являє собою заголовок документу та містить такі дані:
№ Назва поля Опис Позиції Макс.
довжина поля
О/З
1 FileName Повне ім’я файлу(з розширенням)
1 12 +
2 FileStructVersion Номер версії формату (005)
13 3 +
3 Date Дата створення файлу (YYYYMMDD)
16 8 +
Тіло файлу
№ Назва поля Опис Позиції
Макс. довжи
на поля
О/З для
файлу вивантаженн
я
О/З заповн
ення в Б2
Коментар
Основна секція (підтримується клієнтським модулем)
1. RefNr Унікальний номер запису
в файлі 1 9
2. ComandID Ідентифікатор команди 10 3 + Автоматично заповнюється
значенням з поля «Ознака готовності до
вивантаження» картки
контрагента
3. AgrParTplID Ідентифікатор шаблона 13 5 - Не заповнюється
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 66 из 83
4. Surname Прізвище клієнта 18 30 + + Заповнюється значенням з поля «Паспорт
/Прізвище» картки
контрагента
5. Name Ім’я клієнта 48 30 + + Заповнюється
значенням з поля «Паспорт/Ім’я»
картки
контрагента
6. Fname По батькові клієнта 78 30 - - Заповнюється значенням з поля
«Паспорт/ По батькові» картки
контрагента
Для нерезидента може не
заповнюватись
7. BirthDate Дата народження клієнта
(YYYYMMDD) 108 8 - + Заповнюється
значенням з поля «Паспорт/Дата
народження» картки
контрагента
8. IdentCode Код ідентифікації 116 20 + + Заповнюється
значенням з поля «Ідентифікаційний код» картки
контрагента с можливим
перетворенням
9. Passport Ідентифікаційні дані 136 100 - Не заповнюється
10. Hphone Домашній телефон
клієнта 236 20 - + Заповнюється
значенням з поля «Домашній
телефон» картки
контрагента
11. Hstreet Поштова адреса клієнта 256 100 + + Формується за допомогою
конкатенації значень полів закладки Адреса
картки контрагента:
«Область, Район, Місто, Вулиця, Будинок,
Квартира».
Роздільник – кома
12. HcityID Ідентифікатор міста 356 5 + Регулюється
константою Б2:
SAL_ISCARD_HO
MECITYID
13. Hdistrictid Ідентифікатор району
всередині області України
361 5 + Регулюється
константою Б2:
SAL_ISCARD_HO
MEDISTRICTID
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 67 из 83
14. HregionID Ідентифікатор області
всередині України 366 2 + Регулюється
константою Б2:
SAL_ISCARD_HO
MEREGIONID
15. HcountryID Ідентифікатор країни 368 2 + Регулюється
константою Б2:
SAL_ISCARD_HO
MECOUNTRYID
16. HzipCode Поштовий індекс 370 7 + + Заповнюється
значенням з поля «Адреса/Індекс» картки
контрагента
17. MarriedID Ідентифікатор сімейного
статусу 377 1 - Не заповнюється
18. Children Кількість дітей 378 2 - Не заповнюється
19. Car Марка машини, колір 380 20 - Не заповнюється
20. Dog Порода собаки 400 15 - Не заповнюється
21. Pswrd Кодове слово для
ідентифікації за
телефоном
415 50 - Заповнюється
значенням з поля «Ідентифікаційний код» з картки
контрагента
22. ClPosition Посада клієнта 465 25 - Не заповнюється
23. EmpDate
Дата вступу на останнє
місце роботи 490 8
- Не заповнюється
24. Ework Назва підприємства 498 30
- Не заповнюється
25. Estreet Адреса підприємства
приватного клієнта
528 100 - Не
заповнюється
26. EcityID Ідентифікатор міста
підприємства
628 5 - Не
заповнюється
27. Edistrictid
Ідентифікатор району
всередині області України 633 5
- Не заповнюється
28. EregionID
Ідентифікатор області
всередині України 638 2
- Не заповнюється
29. EcountryID
Ідентифікатор країни
двохсимвольний 640 2
- Не заповнюється
30. EzipCode
Поштовий індекс 642 7 - Не
заповнюється
31. HasOtherCard
Чи має картки інших
банків
649 1 - Не
заповнюється
32. Csince З якого року є клієнтом
банку
650 4 - Не
заповнюється
33. ResidentID
Мешкання 654 1 + Визначаєтьс
я за типом контрагента та кодом країни
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 68 из 83
34. InfluenceID
Ідентифікатор ступеню впливовості клієнта в
банку
655 2 + Визначаєтьс
я за реквізитом контрагента К060
35. Pserie Паспорт: серія 657 6
+ + При вивантаженні
видаляються всі пробіли
36. Pnumber
Паспорт: номер 663 6 + + При
вивантаженні
видаляються всі пробіли
37. Pissued Паспорт: коли виданий 669 8
+ + Заповнюється значенням з
поля «Паспорт/Дата видачі» з картки
контрагента
38. Pissuer Паспорт: ким та коли
виданий 677 50
+ + Заповнюється
значенням з поля
«Паспорт/Місце видачі» з картки
контрагента
39. NetLogin
Логін доступу клієнта до
даних через INET 727 20
- Не заповнюється
40. NetPswrd
Пароль доступу клієнта
до даних через INET 747 32
- Не заповнюється
41. Latsurname Прізвище клієнта
латинкою 779 30
- + З картки контрагента
42. Latname Ім’я клієнта латинкою 809 30
- + З картки контрагента
43. Latfname По батькові клієнта
латинкою
839 30 - Не
заповнюється
44. Identdate Дата податкової
реєстрації 869 8
- Не заповнюється
45. Identkodobli
d
Код області податкової
реєстрації 877 3
- Не заповнюється
46. Identtemp Прапорець «Тимчасова
податкова реєстрація» 880 1
- Не заповнюється
47. Enrolled Дата укладання договору 881 8
+ + Не заповнюється
48. AgrExp Дата закінчення договору 889 8
- Не заповнюється
49. MainAccCcy Валюта основного
рахунку 897 3
- Не заповнюється
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 69 из 83
50. AddAccCcy Валюта додаткового
рахунку 900 3
- Не заповнюється
51. BranchID Ідентифікатор філії
(дирекції) 903 4
- Не заповнюється
52. ContractNum Номер договору 907 10
- Не заповнюється
53. LegalContrac
tNum
Юридичний номер
договору
917 32 - Не
заповнюється
54. BaseCardNa
me
Ім’я власника для
ембосування на картці
(латинкою)
949 24 - Не
заповнюється
55. BaseMcName Ім’я, що закодоване на
магнітній стрічці карки (в
форматі ПРІЗВИЩЕ/ІМ’Я)
(латинкою)
973 26 - Не
заповнюється
56. BaseRiskClas
sID
Ідентифікатор виду керування ризиками
карток
999 5 - Не
заповнюється
57. BaseCardKin
dID
Ідентифікатор виду
картки 1004 1
- Не заповнюється
58. BaseCardPsw
rd
Кодове слово для
ідентифікації клієнта 1005 50
- Не заповнюється
59. BaseInformat
ion
Додаткова інформація
про клієнта 1055 40
- Не заповнюється
60. BaseSoftStop
ModeID
Ідентифікатор засобу постановки карток до
стоп-списку в разі несанкціонованої
перевитрати
1095 1 - Не
заповнюється
61. Supp1CardNa
me
Ім’я власника для
ембосування на картці
(латинкою)
1096 24 - Не
заповнюється
62. Supp1McNam
e
Ім’я, що закодоване на магнітній стрічці карки (в
форматі ПРІЗВИЩЕ/ІМ’Я)
(латинкою)
1120 26 - Не
заповнюється
63. Supp1RiskCla
ssID
Ідентифікатор виду керування ризиками
карток
1146 5 - Не
заповнюється
64. Supp1CardKi
ndID
Ідентифікатор виду
картки 1151 1
- Не заповнюється
65. Supp1Relatio
n
Відносини між основним та додатковим
власниками картки
1152 25 - Не
заповнюється
66. Supp1CardPs
wrd
Певне кодове слово для
ідентифікації клієнта
1177 50 - Не
заповнюється
67. Supp1Inform
ation
Додаткова інформація
про клієнта
1227 40 - Не
заповнюється
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 70 из 83
68. Supp1SoftSto
pModeID
Ідентифікатор засобу постановки карток до стоп-списку в разі
несанкціонованої
перевитрати
1267 1 - Не
заповнюється
69. Supp2CardNa
me
Ім’я власника для ембосування на картці
(латинкою)
1268 24 - Не
заповнюється
70. Supp2McNam
e
Ім’я, що закодоване на магнітній стрічці карки (в форматі ПРІЗВИЩЕ/ІМ’Я)
(латинкою)
1292 26 - Не
заповнюється
71. Supp2RiskCla
ssID
Ідентифікатор виду керування ризиками
карток
1318 5 - Не
заповнюється
72. Supp2CardKi
ndID
Ідентифікатор виду
картки
1323 1 - Не
заповнюється
73. Supp2Relatio
n
Відносини між основним
та додатковим
власниками картки
1324 25 - Не
заповнюється
74. Supp2CardPs
wrd
Кодове слово для
ідентифікації клієнта 1349 50
- Не заповнюється
75. Supp2Inform
ation
Додаткова інформація
про клієнта 1399 40
- Не заповнюється
76. Supp2SoftSto
pModeID
Ідентифікатор засобу
постановки карток до стоп-списку в разі несанкціонованої
перевитрати
1439 1 - Не
заповнюється
77. Supp3CardNa
me
Ім’я власника для ембосування на картці
(латинкою)
1440 24 - Не
заповнюється
78. Supp3McNam
e
Ім’я, що закодоване на
магнітній стрічці карки (в форматі ПРІЗВИЩЕ/ІМ’Я)
(латинкою)
1464 26 - Не
заповнюється
79. Supp3RiskCla
ssID
Ідентифікатор виду керування ризиками
карток
1490 5 - Не
заповнюється
80. Supp3CardKi
ndID
Ідентифікатор виду
картки 1495 1
- Не заповнюється
81. Supp3Relatio
n
Відносини між основним та додатковим
власниками картки
1496 25 - Не заповнюється
82. Supp3CardPs
wrd
Кодове слово для
ідентифікації клієнта
1521 50 - Не заповнюється
83. Supp3Inform
ation
Додаткова інформація
про клієнта 1571 40 - Не заповнюється
84. Supp3SoftSto
pModeID
Ідентифікатор засобу постановки карток до
стоп-списку в разі несанкціонованої
перевитрати
1611 1 - Не заповнюється
85. BASENAMEC
ORP
Назва підприємства на
основній картці
1612 24 - Не заповнюється
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 71 из 83
86. SUPP1NAMEC
ORP
Назва підприємства на 1
дод. картці 1636 24 - Не заповнюється
87. SUPP2NAMEC
ORP
Назва підприємства на 2
дод. картці 1660 24 - Не заповнюється
88. SUPP3NAMEC
ORP
Назва підприємства на 3
дод. картці 1684 24 - Не заповнюється
Додаткова секція
89. Reserved1 Поле заміни 1 1708 20 - Не заповнюється
90. Reserved2 Поле заміни 2 1728 32 - Не заповнюється
91. Reserved3 Поле заміни 3 1760 32 - Не заповнюється
92. Reserved4 Поле заміни 4 1792 32 - Не заповнюється
93. Reserved5 Поле заміни 5 1824 32 - Не заповнюється
94. Reserved6 Поле заміни 6 1856 32 - Не заповнюється
95. Reserved7 Поле заміни 7 1888 32 - Не заповнюється
96. Reserved8 Поле заміни 8 1920 32 - Не заповнюється
97. Reserved9 Поле заміни 9 1952 32 - Не заповнюється
98. Reserved10 Поле заміни 10 1984 32 - Не заповнюється
99. FinancestateI
D
Ідентифікатор
фінансового стану 2016 4 - Не заповнюється
100. DebtserviceI
D
Ідентифікатор стану
обслуговування кредиту 2020 4 - Не заповнюється
101. StatementMo
deID
Ідентифікатор виду отримання виписок
клієнтами
2024 1 - + Не заповнюється
102. EmailAddress Адреса електронної пошти для отримання
виписки
2025 50 - Не заповнюється
103. PermAddress Постійна (основна)
поштова адреса для
надсилання виписки
2075 50 - Не заповнюється
104. TempAddress Тимчасова (додаткова) поштова адреса для
надсилання виписки
2125 50 - Не заповнюється
105. TempStart Дата початку
використання тимчасової поштової адреси для надсилання виписки
(включно)
2175 8 - Не заповнюється
106. TempFinish Дата закінчення використання тимчасової поштової адреси для
надсилання виписки
(включно)
2183 8 - Не заповнюється
107. PrefixID Префікс картки 2191 6 - Не заповнюється
108. AuthRangeID Ідентифікатор шаблона альтернативної
авторизації
2197 1 - Не заповнюється
109. CodeCardID Ідентифікатор виду
обслуговування картки
2198 5 - Не заповнюється
110. Mbal Мінімальний баланс (в
копійках/центах) 2203 12 - Не заповнюється
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 72 из 83
111. FGRem Плаваюча страхова сума
(%*100) 2215 5 - Не заповнюється
112. ScrAmt Страхова сума (в
копійках/центах) 2220 12 - Не заповнюється
113. DscrAmt Зниження страхової суми
(%*100) 2232 5 - Не заповнюється
114. Clim Дозволений кредит (в
копійках/центах)
2237 12 - Не заповнюється
115. Ecre Додатковий кредит (в
копійках/центах)
2249 12 - Не заповнюється
116. EcreStartDat
e
Дата надання
додаткового кредиту
2261 8 - Не заповнюється
117. EcreExpDate Дата спливання терміну надання додаткового
кредиту
2269 8 - Не заповнюється
118. RepCr Повернення кредиту
(%*100) 2277 5 - Не заповнюється
119. AvlOver Сума санкціонованої
перевитрати без штрафу, стоп-списку (в
копійках/центах)
2282 12 - Не заповнюється
120. BillingCycleT
ypeID
Ідентифікатор типу
розрахункових циклів
2294 2 - Не заповнюється
121. AllowCharge
UAHOffUSD
Прапорець дозволу
списання коштів з додаткового рахунку при
нестачі на основному
2296 1 - Не заповнюється
122. PercCondID Ідентифікатор відсоткової
ставки
2297 5 - Не заповнюється
123. GracePeriodt
ypeID
Ідентифікатор типу
безкоштовного періоду 2302 5 - Не заповнюється
124. AccModelID Ідентифікатор облікової
схеми 2307 5 - Не заповнюється
125. FremMin Мінімальне значення плаваючої страхової суми
(в копійках, центах)
2312 12 - Не заповнюється
126. AvlAmtBlk Корекція доступної суми 2324 12 - Не заповнюється
127. Scramtexp Дата мінімізації страхової
суми 2336 8 - Не заповнюється
128. Projectid Ідентифікатор проекту 2344 5 - Не заповнюється
129. ALLOWUSESC
RAMT
Прапорець списання з
стр. суми 2349 1 - Не заповнюється
130. ParameterID Ідентифікатор параметра 2350 5 - Не заповнюється
131. CondID Ідентифікатор умови
ведення рахунку РКО
2355 5 - Не заповнюється
132. CONDID2 Ідентифікатор умови
ведення рахунку
транзиту
2360 5 - Не заповнюється
133. CONDID3 Ідентифікатор умови
ведення рахунку конв. 2365 5 - Не заповнюється
134. RISKGROUPI
D
Ідентифікатор Категорії
ризику
2370 1 - Не заповнюється
135. MOBILEOPID ID мобільного оператора 2371 5 - Не заповнюється
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 73 из 83
Хвостовик
№ Назва поля Опис Позиції Макс. довжина
поля
О/З
1. FileName Повне ім’я файлу(з розширенням) 1 12 +
2. Number Число записів у файлі (заголовок та
хвостовик включно) 13 8 +
3. Control Контрольна сума 21 14 +
Нижче наведені правила заповнення деяких полів файлу.
1. № 8, «Код ідентифікації». Для клієнтів, що не мають ідентифікаційних кодів, записується значення «0000000000».
2. № 33, «Ідентифікатор постійності мешкання». Значення поля автоматично визначається за такими реквізитами контрагента: «Тип контрагента», Країна (К040). Поле може набувати одного із значень:
a) 1 - Громадянин України, резидент
b) 2 - Громадянин іншої країни, резидент
c) 3 - Громадянин іншої країни, нерезидент
d) 4 - Громадянин України, нерезидент
3. № 34, «Ступінь впливовості клієнта в банку». Значення поля визначається значенням параметра К060 контрагента – власника угоди:
a) Контрагент: «К060» = 99 (інші особи) -> «Ступінь впливовості» = 1
b) Контрагент: «К060» = 3 (Контролер) -> «Ступінь впливовості» = 2
c) Контрагент: «К060» = 2 (управлінський персонал) -> «Ступінь впливовості» = 3
d) Контрагент: «К060» = 1 (власник істотн. участі) -> «Ступінь впливовості» = 9
e) Контрагент: «К060» = 4 (керівник або контролер спорідн. особи) -> «Ступінь впливовості» = 9
f) Контрагент: «К060» = 5 (асоційована особа) -> «Ступінь впливовості» = 9
4. № 35 та 36. «Серія та номер паспорта». У IS-Card контролюється унікальність серії та номеру паспорта.
a) Для контрагентів - громадян України значення серії та номеру паспорта, що
містяться в одному полі картки контрагента Б2, розділяються та записуються до 2 полів файлу.
b) Для контрагентів – не громадян Україні до поля файлу записуються такі значення:
i. Поле 35 – ідентифікатор контрагента Б2;
136. PHONENUMB
ER № мобільного телефону 2376 7 - Не заповнюється
137. STARTDATE Початок дії додаткових
параметрів угоди 2383 8 - Не заповнюється
138. ISSUETYPE Тип терміновості картки 2391 4 - Не заповнюється
139. CREDITCOMM
ITTEELEVELI
D
Рівень кредитного
комітету, що приймав остаточне рішення щодо
видачі кредиту
2395 4 - Не заповнюється
140. SchemeID Ідентифікатор схеми 2399 4 - Не заповнюється
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 74 из 83
ii. Поле 36 – ідентифікатор контрагента Б2;
iii. Поле 9 – серія та номер паспорта.
Зразки файлів додаються до комплекту документації (див. «3.3.3.Re131I01.prv»).
3.3.4. Експорт до DBF-файлу для модуля BCZ Card
Файл містить інформацію про співробітників підприємств, яка буде надалі імпортуватися до системи BCZ Card.
Файлу експорту інформації про співробітників для вивантаження до BCZ Card
привласнюється назва виду: [Ім’я файлу, визначене користувачем]_[МФО підприємства, на якому працює співробітник]_[Код підприємства, на якому працює співробітник]_[Код ЗКП, в рамках якого обслуговується співробітник підприємства].dbf. Наприклад – «Співробітники_300006_565_902.dbf».
Кожний рядок файлу має фіксовану структуру, що описана в таблиці нижче.
№ Поле Призначення/опис Тип
даних
Довжин
а О/З
1. BRANCHPART Код відділення банку підприємства-контрагента, де
працює клієнт.
Заповнюється значенням з поля
"ТОБО" форми «Зарплатні
проекти».
Якщо код ТОБО для ЗКП не визначений, в якості значення для
поля BRANCHPART визначається
«1»
N 11 -
2. DATEFIL Не заповнюється D 8 -
3. FIO Прізвище, ім’я та по батькові співробітника, що введені через один пробіл. Заповнюється з
анкети співробітника шляхом конкатенації трьох параметрів
анкет співробітника «Прізвище», «Ім’я» та «По батькові» через
один пробіл
C 40 +
4. SEX Стать співробітника. Заповнюється
з анкети співробітника значенням параметру «Стать» (російська
літера М або Ж)
C 1 +
5. LATFIO Латинська транслітерація прізвища та імені співробітника, яка
ембосується на міжнародних картках (спочатку прізвище, а
потім ім’я). Заповнюється з анкети співробітника значенням параметра «Транслітерація імені
клієнта»
C 40 +
6. BIRTHDAY Дата народження співробітника. Заповнюється з анкети співробітника значенням
параметра «День народження»
D 8 +
7. LANGUAGE Мова спілкування клієнта. Заповнюється усталеним
значенням – «ru»
C 2 -
8. PASSPSER Серія паспорта співробітника. Заповнюється з анкети
співробітника:
C 20 +
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 75 из 83
№ Поле Призначення/опис Тип
даних
Довжин
а О/З
- для громадян України першими двома символами параметра
«Номер паспорта»;
- для не громадян України –
значенням «-»
9. PASNOM Номер паспорта співробітника. Заповнюється з анкети
співробітника:
- для громадян України –
значенням параметра «Номер паспорта» без перших двох
символів;
- для не громадян України - значенням параметра «Номер
паспорта»
C 20 +
10. PASDAT Дата видачі паспорта. Заповнюється з анкети співробітника значенням
параметра «Дата видачі» з
паспортних даних
D 8 +
11. PASPLACE Місце видачі паспорта. Заповнюється з анкети
співробітника значенням
параметра «Місце видачі»
C 120 +
12. INN Ідентифікаційний код. Заповнюється з анкети
співробітника значенням
параметра «Ід. код»
C 10 +
13. RESIDENT Резидентність (K030). Заповнюється з анкети
співробітника:
- для резидентів значенням «1»;
- для нерезидентів значенням «2»
N 1 +
14. COUNTRY Домашня адреса. Цифровий код країни (К040). Заповнюється з
анкети співробітника значенням параметра «Країна» вкладки
«Домашня адреса»
N 3 +
15. ZIP Домашня адреса. Поштовий
індекс. Заповнюється з анкети співробітника значенням параметра «Індекс» вкладки
«Домашня адреса»
C 6 -
16. OBL Домашня адреса. Код області
країни співробітника. Заповнюється кодом області з
довідника /НБУ/Фін.моніторинг/Налаштуванн
я/Код області України (K_DFM11)
N 2 -
17. RN Домашня адреса. Найменування
району. Заповнюється з анкети співробітника значенням параметра «Район» вкладки
«Домашня адреса»
C 80 +
18. TNP Домашня адреса. Тип населеного
пункту. Можливі значення: м., с., смт. або інше. Заповнюється
усталеним значенням – «м.»
C 4 -
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 76 из 83
№ Поле Призначення/опис Тип
даних
Довжин
а О/З
19. NP Домашня адреса. Найменування населеного пункту. Заповнюється
з анкети співробітника значенням параметра «Населений пункт»
вкладки «Домашня адреса»
C 80 +
20. STREET Домашня адреса. Вулиця.
Заповнюється з анкети співробітника значенням параметра «Вулиця» вкладки
«Домашня адреса»
C 200 -
21. BUILDING Домашня адреса. Будинок. Заповнюється з анкети співробітника значенням
параметра «Номер будинку»
вкладки «Домашня адреса»
C 20 -
22. FLAT Домашня адреса. Квартира. Заповнюється з анкети
співробітника значенням параметра «Квартира» вкладки
«Домашня адреса»
C 20 -
23. PHONE Домашній телефон. Заповнюється
з анкети співробітника значенням параметра «Домашній телефон»
вкладки «Телефони»
C 20 -
24. COMPANY Код підприємства-контрагента, де
працює клієнт.
Заповнюється значенням з поля
"Код підприємства у BCZ" на вкладці «Додаткові параметри» з
прив’язки ЗКП до контрагентів
N 7 +
25. CEH Код підрозділу в організації.
Використовується для зазначення коду підрозділу підприємства, де працює співробітник.
Використовується для зарплатних проектів. Підрозділ має бути
заздалегідь введеним до системи
N 7 +
26. TABNOM Табельний номер співробітника.
Використовується для зарплатних проектів. Може перевірятися при
зарахуванні/списанні коштів. Заповнюється з прив’язки співробітника до підприємства
значенням параметра «Табельний
номер»
C 20 -
27. JOB Займана посада. Заповнюється з прив’язки співробітника до
підприємства значенням
параметра «Подробиці»
C 40 -
28. JOBPHONE Робочий телефон. Заповнюється з анкети співробітника значенням
параметра «Робочий телефон»
вкладки «Телефони»
C 20 -
29. MOTHERFIO Дівоче прізвище матері або інше кодове слово. Заповнюється
значенням «-»
C 40 -
30. PAN Не заповнюється C 20 -
31. MBR Не заповнюється C 3 -
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 77 из 83
№ Поле Призначення/опис Тип
даних
Довжин
а О/З
32. CONTRACTNO Не заповнюється C 20 -
33. PASSPTYPE Тип посвідчення особи. Заповнюється значенням паспорта
– «1»
N 1 +
34. SPCONTRNO Код ЗКП. Заповнюється значенням
коду зарплатного проекту з форми «Зарплатні проекти», в рамках якого обслуговуються
співробітники
С 20 +
Значення для поля COMPANY визначається наступним чином:
1. Якщо для підприємства, за яким вивантажується файл, визначений один ЗКП з заповненим кодом підприємства BCZ, то цей код підприємства BCZ буде підставлений в поле COMPANY;
2. Якщо для підприємства, за яким вивантажується файл, визначені декілька ЗКП з заповненим кодом підприємства BCZ і ці коди співпадають, то цей код підприємства BCZ буде підставлений в поле COMPANY;
3. Якщо для підприємства, за яким вивантажується файл, визначені декілька ЗКП з заповненим кодом підприємства BCZ і ці коди є різними, то система виведе помилку "Для підприємства визначено більше одного коду підприємства BCZ на формі".
Зразки файлів додаються до комплекту документації (див. «3.3.4.Export_Employees_300009_229_902.dbf»).
3.3.5. Експорт до XML–файлу (Transfer Project)
Файл експорту даних про співробітників підприємства містить інформацію про підприємства клієнта та його співробітниках.
Файлу експорту до Transfer Project привласнюється ім’я виду «XML_Umbr_Employees.xml», де «Umbr» – найменування підприємства.
Приклад:
<?xml version="1.0" encoding="WINDOWS-1251"?>
<DATAPACKET>
<ENTERPRISEINFO EMAIL="-" FAX="-" CONTACTINFO="-" CONTACTPHONES="" NALOGREGISTERNO="" NALOGREGISTERDATE="30/12/1899" IDENTIFYCODE="232786840" NAME="ОАО "Мегабуд"">
<EMPLOYEES><EMPLOYEE IDENTIFYCODE="5272101113"
MOBILEPHONE="+381234567890" WORKPHONE="" HOMEPHONE="+381234567890" ACCEPTANCEDATE="11/11/2013" JURADDR_FLAT="2" JURADDR_HOUSENO="12" JURADDR_STREET="Новгородская" JURADDR_CITY="Берестове" JURADDR_DISTRICT="Артемівський район" JURADDR_REGION="Донецька область"
JURADDR_POSTCODE="610023" JURADDR_COUNTRYID="804" JURIDICALADDRESS="-" ADDR_FLAT="2" ADDR_HOUSENO="12" ADDR_STREET="Новгородская" ADDR_CITY="Берестове" ADDR_DISTRICT="Артемівський район" ADDR_REGION="Донецька область" ADDR_POSTCODE="610023" ADDR_COUNTRYID="804" ADDRESS="-" CITIZENSHIP="804" BIRTHPLACE="Украина" BIRTHDAY="26/10/1980" PASSPORTISSUEPLACE="киевская область" PASSPORTISSUEDATE="28/09/2000" PASSPORTNO="ФИ123454" SEX="M" EMBOSSIGLI="CHARLEY MENSON" MIDDLENAME="Гаррри" FIRSTNAME="Чарли" LASTNAME="Менсон" ID="33142"/>
</EMPLOYEES>
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 78 из 83
</ENTERPRISEINFO>
</DATAPACKET>
№ Найменування поля Призначення/опис
Інформація про підприємство містить такі значення
1. NAME Назва підприємства
2. IDENTIFYCODE Ідентифікаційний код підприємства
3. NALOGREGISTERDA
TE Дата реєстрації підприємства в податковій (в форматі ДД/ММ/РРР)
4. NALOGREGISTERNO Номер реєстрації підприємства в податковій
5. CONTACTPHONES Номер контактного телефону підприємства
6. CONTACTINFO Контактна інформація
7. FAX Номер факсу підприємства
8. EMAIL Адреса електронної пошти підприємства
Інформація про співробітників містить такі значення
9. ID Порядковий номер співробітника
10. IDENTIFYCODE Ідентифікаційний код співробітника
11. LASTNAME Прізвище співробітника
12. FIRSTNAME Ім’я співробітника
13. MIDDLENAME По батькові співробітника
14. EMBOSSIGLI Транслітерація прізвища та імені співробітника для нанесення на картку. Альтернативний варіант написання цього поля
EMBOSSINGLIT дозволяє замінити деякі параметри співробітника,
якщо він вже був внесений
15. SEX Стать співробітника (M або F)
16. PASSPORTNO Номер паспорта співробітника в форматі ББ999999 для резидентів
17. PASSPORTISSUEDAT
E Дата видачі паспорта співробітника в форматі ДД/ММ/РРРР
18. PASSPORTISSUEPLA
CE Місце видачі паспорта співробітника
19. BIRTHDAY Дата народження співробітника в форматі ДД/ММ/РРРР
20. BIRTHPLACE Місце народження співробітника
21. CITIZENSHIP Код країни громадянства співробітника (для України 804)
22. ADDRESS Повна домашня адреса співробітника
Якщо заповнюється це поле, тоді усі інші поля, що мають відношення до адреси співробітника (25-32), можливо не
зазначати.
Примітка. Можливість зазначення адреси в цьому полі
регулюється внутрішніми налаштуваннями банку
23. JURIDICALADDRESS Повна адреса розсилки.
Якщо заповнюється це поле, тоді усі інші поля, що мають
відношення до адреси розсилки (32-39), можливо не зазначати.
Примітка. Можливість зазначення адреси в цьому полі
регулюється внутрішніми налаштуваннями банку
24. ADDR_COUNTRYID Цифровий код країни домашньої адреси співробітника
25. ADDR_POSTCODE Поштовий індекс домашньої адреси співробітника
26. ADDR_REGION Область домашньої адреси співробітника
27. ADDR_DISTRICT Район домашньої адреси співробітника
28. ADDR_CITY Населений пункт домашньої адреси співробітника
29. ADDR_STREET Вулиця домашньої адреси співробітника
30. ADDR_HOUSENO Номер дома домашньої адреси співробітника
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 79 из 83
№ Найменування поля Призначення/опис
31. ADDR_FLAT Номер квартири домашньої адреси співробітника
32. JURADDR_COUNTRY
ID Адреса для кореспонденції.
Цифровий код країни
33. JURADDR_POSTCOD
E Адреса для кореспонденції.
Поштовий індекс
34. JURADDR_REGION Адреса для кореспонденції.
Найменування області
35. JURADDR_DISTRICT Адреса для кореспонденції. Найменування району
36. JURADDR_CITY Адреса для кореспонденції. Населений пункт
37. JURADDR_STREET Адреса для кореспонденції.
Вулиця
38. JURADDR_HOUSENO Адреса для кореспонденції.
Номер дома
39. JURADDR_FLAT Адреса для кореспонденції.
Номер квартири
40. ACCEPTANCEDATE Дата приймання співробітника на роботу в форматі ДД/ММ/РРРР
41. HOMEPHONE Домашній телефон співробітника в форматі +380999999999
42. WORKPHONE Робочий телефон співробітника в форматі +380999999999
43. MOBILEPHONE Мобільний телефон співробітника в форматі +380999999999
Зразки файлів додаються до комплекту документації (див. «3.3.5.XML_ОАО Мегабуд_Employees.xml»).
3.4. Експорт платіжного файлу
3.4.1. Експорт до XML-файлу
Платіжний файл для системи емісії платіжних карток містить інформацію щодо нарахованих за зарплатною відомістю сумах, які мають бути перераховані на карткові рахунки співробітників. Файл вивантажується до АБС Б2 під час переведення зарплатної відомості до статусу «Проведений».
Файлу експорту платіжного файлу привласнюється назва виду «PCCCYYYYDDMMNN.XML», де:
CCC – код клієнта;
YYYYDDMM – дата створення файлу;
NN – порядковий номер файлу протягом дня.
Приклад:
<?xml version="1.0" encoding="windows-1251"?>
<DATAPACKET Version="2.0">
<SCHEDULEINFO FILENAME ="P0112006151123.XML"
DATE="05/11/2006" TIME="09:10:11" NUMBER="11/1" CLIENTID="11"
CLIENT_NAME="Найменування клієнта" PAYER_BANK_BRANCHID="МФО банку платника"
PAYER_BANK_NAME="Банк платника" PAYER_BANK_ACCOUNTNO="123456878"
PAYER_ACCOUNTNO="290015267485" ONFLOW_TYPE="1"
TOTAL_SHEDULE_AMOUNT="250000" OPERATOR ="IVANOV" COMMENT= "Аванс за
листопад 2007 г." FILE_NUMBER="023">
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 80 из 83
<EMPLOYEES>
<EMPLOYEE IDENTIFYCODE="1234567890" CARDACCOUNTNO="262512345678"
CURRENCYID="980" BRANCHID="123456" LASTNAME="Петренко"
FIRSTNAME="Іван" MIDDLENAME="Петрович" AMOUNT="152000"/>
…
</EMPLOYEES>
</SCHEDULEINFO>
</DATAPACKET>
№ Найменування поля Призначення/опис
Інформація щодо зарплатної відомості містить такі значення
1. FILENAME Ім’я файлу для системи емісії
2. SCHEDULE_DATE Дата зарплатної відомості
3. SCHEDULE_TIME Час зарплатної відомості
4. SCHEDULE_NUMBER Номер зарплатної відомості
5. CLIENTID ID код клієнта в підсистемі iFOBS.eSalary
6. CLIENT_NAME Найменування клієнта
7. PAYER_BANK_BRANCHI
D МФО банку платника
8. PAYER_BANK_NAME Найменування банку платника
9. PAYER_BANK_ACCOUNT
NO Номер рахунку банку платника
10. PAYER_ACCOUNTNO Рахунок для списання грошових коштів
11. ONFLOW_TYPE Тип нарахування
12. TOTAL_SHEDULE_AMOU
NT Загальна сума зарплатної відомості
13. OPERATOR Оператор, що прийняв зарплатну відомість
14. COMMENT Коментар до відомості (приклад: Зарахування на ПК
згідно авансового звіту від 05/11/2006 № 15)
15. FILE_NUMBER Порядковий номер файлу за день
Інформація щодо нарахованої співробітнику суми містить такі значення
16. IDENTIFYCODE Ідентифікаційний код співробітника
17. CARDACCOUNTNO Номер карткового (або іншого) рахунку співробітника
18. CURRENCYID Код валюти рахунку
19. BRANCHID МФО банку, в якому відкритий рахунок
20. LASTNAME Прізвище співробітника
21. FIRSTNAME Ім’я співробітника
22. MIDDLENAME По батькові співробітника
23. AMOUNT Сума для зарахування на картковий рахунок
Зразки файлів додаються до комплекту документації (див. «3.4.1.P71520111511121.xml»).
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 81 из 83
3.4.2. Експорт для вивантаження до IS-Card (P-файл)
В системі реалізована можливість формування платіжного файлу для системи емісії платіжних карток IS-card в форматі ФАЙЛУ НАРАХУВАННЯ системи IS-card (формат V. 002).
Файл містить інформацію щодо нарахованих за зарплатною відомістю сумах, які
мають бути перераховані на карткові рахунки співробітників. Файл вивантажується до АБС Б2 під час переведення платіжного доручення на оплату зарплатної відомості до статусу «Проведений» вручну або автоматично.
Константа SAL_CREATE_PFILE регулює механізм формування назви P-файлу. Якщо
SAL_CREATE_PFILE=0, діє стандартний механізм. Файлу привласнюється унікальна назва в межах всіх відомостей АБС Б2. Приклад імені файлу: «P0003612.ISS», де:
«Р» - символьній ідентифікатор документа;
«000» - ведучі нулі перед номером коду проекту;
«361» - код зарплатного проекту;
«2» - порядковий номер відомості.
Якщо існує можливість повторного вивантаження файлу для опрацьованої відомості – файл кожного разу має бути вивантажений під однаковим ім’ям, що є відповідним до цієї відомості.
Якщо SAL_CREATE_PFILE=1, задіяний альтернативний механізм. Платіжний файл формується з ім’ям P[код проекту]S.DDD, де:
[код проекту] – 6 цифр. Код проекту доповнюється нулем з лівого боку, якщо містить менше 6 цифр;
S – 1 символ, це порядковий номер відомості за день в межах одного зарплатного проекту, може набувати значень від 0 до 9 та від A до Z, не прив’язаний до № відомості;
DDD- 3 символи, це порядковий номер дня в році від 001 до 365 (366).
Порядковий номер відомості формується наступним чином:
обчислюється кількість відомостей за даним ЗКП з такою ж датою та
ознакою вивантаження;
якщо значення перебуває в діапазоні 0..9, то використовується це значення, інакше використовується велика літера латинської абетки за порядком, наприклад, 10 це A, 11 це B і т.д.
Цей варіант забезпечує унікальність імені файлу для об’єму до 36 відомостей за ЗКП за день включно (10 цифр + 26 літер латинської абетки).
Кожний рядок файлів має фіксовану структуру, що описана в таблиці нижче.
Структура файлу: Заголовок
№ Поле Опис Позиція Довжин
а
Тип
даних
1. FileName Повне ім’я файлу(з
розширенням)
1 12 C
2. FileStructVer
sion
Номер версії (для нового
формату)
13 3 N
3. Date Дата створення файлу (YYYYMMDD)
16 8 D
Структура файлу: Тіло
№ Поле Опис Позиція Довжин
а
Тип
даних
1. CommandID Код операції.
Примітка. Наразі доступними є такі коди
1 3 N
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 82 из 83
CommandID: 200–299, 900–999.
2. AccNum Номер карткового рахунку 4 14 C
3. Amount Сума нарахування (в центах або копійках без роздільника)
18 12 N
4. Ccy Код валюти суми нарахування (UAH, USD)
30 3 C
5. PayDate Дата платежу (YYYYMMDD) 33 8 D
6. PayTime Час платежу (hhmm) 41 4 C
7. CardNum Пусте значення
45 19 C
8. Operator Ім’я оператора, що виставив
статус відомості як «Проведений»
64 10 C
9. RefNR Унікальний номер за філіалом 74 15 C
10.
Comment Коментар – призначення платежу
89 160 C
Хвостовик
№ Поле Опис Позиція Довжин
а
Тип
даних
1. FileName Повне ім’я файлу(з
розширенням)
1 12 C
2. Number Кількість записів у файлі
(заголовок та хвостовик включно)
13 8 N
3. Control Контрольна сума 21 14 N
Зразки файлів додаються до комплекту документації (див. «3.4.2.P0000281.ISS»).
3.4.3. Експорт до DBF-файлу (структура №1)
Платіжний файл з інформацією щодо нарахувань за співробітниками підприємства містить інформацію щодо нарахованих за зарплатною відомістю сумах, які мають бути перераховані на карткові рахунки співробітників. Файл вивантажується до АБС Б2 під час переведення платіжного доручення на оплату зарплатної відомості до статусу «Проведений» вручну або автоматично.
Файлу експорту платіжного DBF файлу привласнюється назва виду «pКОД_КОНТРАГЕНТА_ВВВВВВВВВВ_ИИИИИИИИИИ», де:
Р – символьний ідентифікатор документа;
КОД_КОНТРАГЕНТА – код контрагента за підприємством;
ВВВВВВВВВВ – № відомості;
ИИИИИИИИИИ – ID відомості;
Кожний рядок файлу має фіксовану структуру, що описана в таблиці нижче.
№ Найменування поля Призначення/опис Тип
даних
Довжина
поля
1. SBK_ID Ідентифікаційний код співробітника N 10
2. SBK_FIO Прізвище, ім’я та по батькові співробітника
C 40
3. SBK_NUM Номер карткового рахунку C 20
4. SBK_SUM Сума зарахування N 10,2
Зразки файлів додаються до комплекту документації (див. «3.4.3.P235_0000007780_0000137028.dbf»).
iFOBS.eSalary Опис форматів файлів імпорту та експорту
Страница 83 из 83
3.4.4. Експорт до DBF-файлу (структура №2)
Платіжний файл містить інформацію щодо нарахувань співробітникам підприємства за зарплатною відомістю на карткові рахунки, що не ведуться в Б2. Файл формується з найменуванням «oper.dbf». Якщо файл з таким найменуванням вже існує, то операціоніст може перезаписати файл, або зберегти файл с іншим ім’ям та/або до іншої папки.
Кожний рядок файлу має фіксовану структуру, що описана в таблиці нижче.
№ Найменування поля Призначення/опис Тип
даних
Довжина
поля
1. CURRENCY Валюта транзакції (символьний код валюти з довідника R030)
С 3
2. CARD_ACCT Номер карткового рахунку
C 10
3. TRAN_DATE Дата транзакції. Поле заповнюється датою формування
DBF-файлу у відповідності до поточного операційного дня
D 8
4. AMOUNT Сума в валюті транзакції (у вигляді
грн.коп.)
N 15,2
Зразки файлів додаються до комплекту документації (див. «3.4.4.oper.dbf»).
3.4.5. Експорт до DBF-файлу (структура №3)
Платіжний файл з інформацією щодо нарахувань за співробітниками підприємства містить інформацію щодо нарахованих за зарплатною відомістю сумах, які мають бути перераховані на карткові рахунки співробітників. Файл вивантажується до АБС Б2. Операція є доступною для відомостей у статусах «Прийнятий» та «Проведений».
Файлу експорту платіжного DBF файлу привласнюється назва виду «pКОД_КОНТРАГЕНТА_ВВВВВВВВВВ_ИИИИИИИИИИ», де:
Р – символьний ідентифікатор документа;
КОД_КОНТРАГЕНТА – код контрагента за підприємством;
ВВВВВВВВВВ – № відомості;
ИИИИИИИИИИ – ID відомості;
Кожний рядок файлу має фіксовану структуру, що описана в таблиці нижче.
№ Найменування поля Призначення/опис Тип
даних
Довжина
поля
1. SBK_INN Ідентифікаційний код співробітника CHAR 10
2. SBK_FIO Прізвище, ім’я та по батькові
співробітника
CHAR 40
3. SBK_NUM Номер карткового рахунку CHAR 20
4. SBK_SUM Сума зарахування NUMBER 10,2
Top Related