iFOBS.eSalary - KredoBank › public › upload › 27bd2f8244c... · Підсистема перерахування коштів на банківські картки співробітників

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.4. Імпорт з текстового файлу 1С ................................ 31

2.3. Імпорт нарахувань по зарплатній відомості ......... 33


2.3.2. Імпорт з текстового файлу ..................................... 33


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



3. ФОРМАТИ ФАЙЛІВ ІМПОРТУ ТА ЕКСПОРТУ,

ВИКОРИСТОВУВАНІ В АБС Б2 ........................................ 48

3.1. Імпорт даних про співробітників .......................... 48


3.1.2. Імпорт з TXT-файлу (Майстер підключення) ......... 51

3.2. Імпорт даних про рахунки співробітників ............ 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





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



Підсистема / Формат 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, хвилини та секунди, відповідно)



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 (*при імпорті не враховується)

Назва підприємства. Якщо потрібні подвійні лапки ", їх слід замінити на ' або &quot

C 30 -

2. IDENTIFYCODE Ідентифікаційний код підприємства N 10 -

3. NALOGREGISTERDATE

Дата реєстрації підприємства у податковій (у форматі ДД/ММ/РРРР)

D 8 -

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. 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. PASSPORTISSUEDATE

Дата видачі паспорта співробітника в форматі ДД/ММ/РРРР

D 8

19. PASSPORTISSUEPLACE

Місце видачі паспорта співробітника 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




Довжина

поля

О/З

співробітника

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_POSTCODE

Адреса для кореспонденції. Поштовий індекс

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




Довжина

поля

О/З

ФО»: 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,



Київська обл., м. Київ, вул.Оболонська, 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

(*при імпорті не враховується)

Назва підприємства.

Якщо потрібні подвійні лапки ", їх слід замінити на ' або &quot

C 30 -



Дата реєстрації підприємства у податковій (в форматі ДД/ММ/РРРР)

D 8 -

4. NALOGREGISTERNO Номер реєстрації підприємства у

податковій N 10 -

5. ADDRESS Повна адреса підприємства.

Якщо поле не заповнено або в ньому встановлений прочерк (знак мінус «-»), тоді при збереженні запису про співробітника в адресі буде вказано значення «Не

C 254 -




Довжина

поля

О/З

визначено»

6. CONTACTPHONES Номер контактного телефону

підприємства C 20 -



9. EMAIL Адреса електронної пошти

підприємства C 100 -







15. EMBOSSIGLI Транслітерація прізвища та імені

співробітника для нанесення на картку. Альтернативний варіант написання цього поля EMBOSSINGLIT дозволяє замінювати деякі параметри співробітника, якщо він вже був внесений

С 26


17. PASSPORTNO Номер паспорта співробітника в

форматі ББ999999 для резидентів С 25 +

18. PASSPORTISSUEDATE Дата видачі паспорта співробітника

в форматі ДД/ММ/РРРР D 8



20. BIRTHDAY Дата народження співробітника в

форматі ДД/ММ/РРРР D 8


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 Район домашньої адреси


30. ADDR_CITY Населений пункт домашньої адреси


31. ADDR_STREET Вулиця домашньої адреси


32. ADDR_HOUSENO Номер дома домашньої адреси


33. ADDR_FLAT Номер квартири домашньої адреси



Адреса для кореспонденції.

Цифровий код країни

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. HOMECOUNTRYPHONECODE

Код країни для домашнього телефону співробітника

С 5

45. HOMEZONEPHONECODE

Код міста для домашнього телефону співробітника

С 5

46. HOMEPHONE Домашній телефон співробітника

(обов'язково повинен бути зазначений хоча б один телефон - домашній, мобільний або робочий)

C 30

47. WORKCOUNTRYPHONECODE

Код країни для робочого телефону співробітника

С 5

48. WORKZONEPHONECO Код міста для робочого телефону С 5




Довжина

поля

О/З

DE співробітника

49. WORKPHONE Робочий телефон співробітника


C 30

50. MOBILCOUNTRYPHONECODE

Код країни для мобільного телефону співробітника

С 5

51. MOBILEZONEPHONECODE

Код оператора для мобільного телефону співробітника

С 5

52. MOBILEPHONE Мобільний телефон співробітника


C 30

53. TABNO Табельний номер співробітника.

Заповнюється в таблиці прив’язки співробітника до номера підприємства

С 15 -


Цифровий код країни резидентності 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





Довжина

поля

О/З

4. LATFIO Латинська транслітерація прізвища та

імені співробітника, яка ембосується на міжнародних картках

C 26


форматі DD/MM/YYYY D 8

6. RESIDENT Резидентність (K030):


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





Довжина

поля

О/З

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





Довжина

поля

О/З

окремими налаштуваннями банку

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)

Файл імпорту даних про співробітників підприємства містить інформацію про співробітників клієнта та формується з бухгалтерської програми клієнта або на боці процесінгу.



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



6. RESIDENT Резидентність (K030):


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





Довжина

поля

О/З

20. FLAT Домашня адреса. Квартира C 10

21. HOMECODEC Код країни для домашнього телефону


22. HOMECODEZ Код міста для домашнього телефону


23. PHONE Домашній телефон співробітника


C 20

24. MOBCODEC Код країни для мобільного телефону


25. MOBCODEZ Код оператора для мобільного

телефону співробітника C 5

26. MOBPHONE Мобільний телефон (обов'язково


C 20

27. JOBCODEC Код країни для робочого телефону


28. JOBCODEZ Код міста для робочого телефону


29. JOBPHONE Робочий телефон співробітника


C 20

30. CCOUNTRY Адреса для кореспонденції. Цифровий

код країни N 3

31. CZIP Адреса для кореспонденції. Поштовий

індекс C 6

32. COBL Адреса для кореспонденції. Код області

з довідника областей, що надає НБУ N 2

33. CRN Адреса для кореспонденції.


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





Довжина

поля

О/З

адреси в даному полі регулюється внутрішніми налаштуваннями банку

40. CADRESS Юридична адреса підприємства

співробітника.

Якщо поле не заповнено або в ньому встановлений прочерк (знак мінус "-"), тоді при збереженні запису про співробітника в адресі буде зазначено «Не визначено».


C 254

41. TABNOM Табельний номер співробітника.


С 15 -


таблиці прив'язок співробітника до номера підприємства

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 - +




Довжина

поля

О/З

Примітка. Можна ввести необмежену кількість символів, яка після розбиття на прізвище/ім'я/по батькові буде обрізано до допустимої довжини відп. полів - по 38 символів

3. EMBOSSING_NAME Латинська транслітерація прізвища

та імені співробітника, яка ембосується на міжнародних картках

C 26

4. BIRTHDATE Дата народження співробітника в


5. CITY Місце народження співробітника C 40


Якщо поле не заповнено або в ньому встановлений прочерк (знак мінус "-"), тоді при збереженні запису про співробітника в адресі буде зазначено «Не визначено»

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 -




Довжина

поля

О/З

Домашня адреса

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



С 15 -


Код країни резидентності N 3


таблиці прив’язки співробітника до номера підприємства (параметр «Подробиці»)

C 40

41. REGBYSEL Ознака того, що співробітник


N 1

42. PASSPORTCHIP Ознака наявності чіпу в паспорті


0 - ні

1 - так

Примітка. Можливість задавати значення в даному полі є додатковою функціональністю і

N 1




Довжина

поля

О/З

регулюється окремими налаштуваннями банку

43. PASSPORTLASTDATE Дата закінчення терміну дії паспорта

нового зразка (ID карти) в форматі ДД/ММ/РРРР


D 8

44. PASSPORTRECNO Унікальний номер запису в

демографічному реєстрі ФО


C 14


Зразки файлів додаються до комплекту документації (див. «2.1.5.Import_Employees.xls»).

2.1.6. Імпорт з CSV-файлу

Файл імпорту даних про співробітників підприємства в CSV-форматі містить інформацію про співробітників підприємства. У якості роздільника використовується «;». Імпорт виконується з файлів у форматі ANSI.

Кожен рядок файлу має фіксовану структуру, описану в таблиці нижче.


Довжина поля

О/З





5. PASSPORTNO Номер паспорта співробітника

старого зразка в форматі ББ999999 або нового зразка в форматі 123456789 для резидентів

С 20 +



D 8




форматі ДД/ММ/РРРР D 8


співробітника для нанесення на картку. Альтернативний варіант написання цього поля EMBOSSINGLIT дозволяє замінювати деякі параметри співробітника, якщо він

С 26





О/З

вже був внесений



12. CITIZENSHIP Код країни держави співробітника

(для України 804) N 3

13. RESIDENTTYPEID Резидентність (1- резидент, 2 -

нерезидент) N 1

14. RESIDENT_COUNTRYID

Код країни резидентності співробітника (для України 804)

N 3


співробітника. Якщо заповнюється це поле, тоді всі інші поля, що стосуються адреси співробітника, можна не зазначати. Примітка. Можливість зазначення адреси в даному полі регулюється внутрішніми налаштуваннями банку

С 254



17. ADDR_POSTCODE Почтовий індекс домашньої адреси














24. JURIDICALADDRESS Повна адреса розсилки.

Якщо заповнюється це поле, тоді всі інші поля, що стосуються адреси співробітника, можна не зазначати. Примітка. Можливість зазначення адреси в даному полі регулюється внутрішніми налаштуваннями банку

С 254




N 3




C 6



C 40



C 40



C 36


Вулиця

C 40





О/З

31. JURADDR_HOUSENO Адреса для кореспонденції.

Номер дома

C 10



C 10


роботу в форматі ДД/ММ/РРРР D 8

34. HOMEPHONE Домашній телефон співробітника в

форматі +380999999999 C 20

35. WORKPHONE Робочий телефон співробітника в

форматі +380999999999 C 20

36. MOBILEPHONE Мобільний телефон співробітника в

форматі +380999999999 C 20


Примітка. При імпорті не враховується

С 15

38. PASSPORTCHIP Ознака наявності чипу в паспорті


0 – ні 1 – так


N 1

39. PASSPORTLASTDATE Дата закінчення терміну дії паспорту

нового зразка (ID картки) в форматі ДД/ММ/РРРР


D 8

40. PASSPORTRECNO Унікальний номер запису в

демографічному реєстрі ФЛ


C 14


Зразки файлів додаються до комплекту документації (див. «2.1.6.Import_Employees.csv»).

2.2. Імпорт зарплатної відомості


Файл імпорту зарплатної відомості підприємства містить інформацію про нараховану працівникам зарплату та інші платежі. Файл вивантажується з бухгалтерської програми на стороні клієнта. Імпорт виконується з файлів у форматі ANSI.

Приклад:





<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_ACCOUNTNO

Рахунок платника в банку (транзитний).

Примітка. Якщо адміністратор виконав налаштування системи таким чином, що транзитний рахунок буде визначатися автоматично, то це поле буде необов'язковим для заповнення

+

7. PAYER_ACCOUNTNO Рахунок для списання коштів +

8. ONFLOW_TYPE Вид нарахування по зарплатній відомості.

Значення з поля імпортується при умові його відповідності даним з довідника "Види нарахувань". В іншому випадку в зарплатну відомість буде підставлений вид нарахування з кодом «1» з довідника

-

9. TOTAL_SHEDULE_AMOUNT

Загальна сума зарплатної відомості в форматі ГРН,КОП

+

10. COMMISSION_PERSENT Процент комісії -

11. PAYER_EXTACCOUNT Ознака списання коштів з рахунку в іншому банку:

0 – кошти списуються з рахунку в цьому ж банку, номер рахунку вказується в полі PAYER_ACCOUNTNO;

-




1 – кошти будуть списані з рахунку в іншому банку.

Примітка. Якщо в файлі, що імпортується, встановлено ознаку списання коштів з рахунку в іншому банку, та, відповідно, не вибрано рахунок для списання коштів, визначення підприємства відбувається за кодом ЗКП

12. CONTRAGENT_CODEZKP Код зарплатного проекту.

Примітка. Зазначається лише для банків, що використовують ЗКП.

Дане поле може бути не заповнено, якщо:

1. Для підприємства визначено один ЗКП, його код проставляється автоматично;

2. Для підприємства визначено декілька ЗКП, користувачеві необхідно зазначити ЗКП відомості з доступного списку ЗКП, за якими працює підприємство.

Якщо за підприємством не визначено жодного ЗКП, то при імпорті система видасть помилку

+

13. COMMENTS Додатковий коментар до зарплатної відомості -

Інформація про нараховану співробітнику суму містить такі значення

14. IDENTIFYCODE Ідентифікаційний код співробітника +


Якщо в ід. коді вказано значення 000000000 (співробітник нерезидент або відмовився від присвоєння коду), це поле є обов'язковим для заповнення

+

16. CARDACCOUNTNO Номер карткового (або іншого) рахунку співробітника.

Якщо поле не заповнено, автоматично підставляється рахунок співробітника, за яким в системі зазначена ознака «за умовчанням». Якщо рахунків «за умовчанням» у одного співробітника декілька, підставляється перший зі списку. Якщо за співробітником не визначено жодного рахунку з ознакою «за умовчанням» та поле CARDACCOUNTNO не заповнено, при імпорті файлу виникне помилка.

Примітка. Якщо підприємство використовує ЗКП, та для співробітника в рамках одного ЗКП по підприємству відкритий тільки один картковий рахунок, то його заповнення в файл, що імпортується, не обов'язково, тому що рахунок буде підставлений автоматично. Якщо по співробітнику в рамках одного ЗКП відкрито декілька рахунків, то в файлі, що імпортується, необхідно вказати номер карткового рахунку співробітника, на який виконується нарахування

-

17. LASTNAME Прізвище співробітника -

18. FIRSTNAME Ім’я співробітника -

19. MIDDLENAME По батькові співробітника -

20. AMOUNT Сума для зарахування на рахунок співробітника в форматі ГРН,КОП

+



Зразки файлів додаються до комплекту документації (див. «2.2.1.Import_Payroll.xml»).


Для імпорту файлу 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;


Примітка. Якщо в файлі, що імпортується, встановлено ознаку

N 1 -

* Додаткова функціональність





Довжина

поля

О/З

списання коштів з рахунку в іншому банку, та, відповідно, не вибрано рахунок для списання коштів, визначення підприємства відбувається за кодом ЗКП

10. CODEZKP Код зарплатного проекту.






N 10 +

11. COMMENTS Додатковий коментар до зарплатної відомості

С 180 -

12. FLOWTYPE Вид нарахування по зарплатній відомості.


С 100 -

Інформація про нараховану співробітнику суму містить такі значення

13. IDCODE Ідентифікаційний код співробітника C 10 +



C 15 +

15. ACCOUNTNO Номер карткового (або іншого) рахунку співробітника.

Якщо поле не заповнено, автоматично підставляється рахунок співробітника, за яким в системі зазначена ознака «за умовчанням». Якщо рахунків «за умовчанням» у одного співробітника декілька, підставляється перший зі списку. Якщо за співробітником не визначено жодного рахунку з ознакою «за умовчанням» та поле ACCOUNTNO не заповнено, при імпорті файлу виникне помилка.

Примітка. Якщо підприємство використовує ЗКП, та для співробітника в рамках одного ЗКП по підприємству відкритий тільки один картковий рахунок, то його заповнення в файл, що імпортується, не обов'язково, тому що рахунок буде підставлений автоматично. Якщо по співробітнику в рамках одного ЗКП відкрито декілька рахунків, то в файлі, що імпортується, необхідно вказати номер карткового рахунку співробітника, на який виконується

C 14 -





Довжина

поля

О/З

нарахування

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»).


Файл імпорту зарплатної відомості підприємства містить інформацію про нараховану працівникам зарплату та інші платежі. Файл вивантажується з бухгалтерської програми на стороні клієнта та являє собою таблицю 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;


Примітка. Якщо в файлі, що імпортується, встановлено ознаку списання коштів з рахунку в

-




іншому банку, та, відповідно, не вибрано рахунок для списання коштів, визначення підприємства відбувається за кодом ЗКП

10. CONTRAGENT_ZKP Код зарплатного проекту.






+

11. COMMENTS Додатковий коментар до зарплатної відомості

12. ONFLOWTYPE Вид нарахування по зарплатній відомості.


-

Другий рядок призначено для введення значень зарплатної відомості;...

2. Створити другу вкладку – «Amounts»;

Перший рядок даної вкладки повинен містити назви полів про співробітників та нарахування:


1. IDCODE Ідентифікаційний код співробітника

Примітка. Якщо співробітник є нерезидентом або він відмовився від присвоєння ід. коду, то це поле має бути заповнено значенням 9 нулів (клітинка відформатована як текст), або замість ід. коду допускається введення пробілу. Якщо це поле відформатовано як число, в ід. код співробітника буде підставлене значення 0, та пошук співробітника відбуватиметься некоректно

+



+

3. ACCOUNTNO Номер карткового (або іншого) рахунку співробітника.

Якщо поле не заповнено, автоматично підставляється рахунок співробітника, за яким в системі зазначена ознака «за умовчанням». Якщо рахунків «за умовчанням» у одного співробітника декілька, підставляється перший зі списку. Якщо за співробітником не визначено жодного рахунку з ознакою «за умовчанням» та поле ACCOUNTNO не заповнено, при імпорті файлу виникне помилка.

Примітка. Якщо підприємство використовує ЗКП, та для співробітника в рамках одного ЗКП по

-




підприємству відкритий тільки один картковий рахунок, то його заповнення в файл, що імпортується, не обов'язково, тому що рахунок буде підставлений автоматично. Якщо по співробітнику в рамках одного ЗКП відкрито декілька рахунків, то в файлі, що імпортується, необхідно вказати номер карткового рахунку співробітника, на який виконується нарахування

4. LASTNAME Прізвище співробітника -

5. FIRSTNAME Ім’я співробітника -


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 Назва банку



№ стор

Найменування реквізиту Опис

Тип даних, макс.

довжина

поля

О/З Примітка

8. PAYER_ACCOUNT Номер

рахунку

Інформація про нарахування

9. CARD_HOLDERS.N.CARD_NUM Номер

рахунку співробітника N

+ Приклад заповнення:

CARD_HOLDERS.0.CARD_NUM=26259010015125

10. CARD_HOLDERS.N.CARD_HOLDER

Ім’я співробітника N


CARD_HOLDERS.0.CARD_HOLDER=Попова Марія Володимирівна

11. CARD_HOLDERS.N.STATUS Статус + Можливі значення:

0

12. CARD_HOLDERS.N.CARD_HOLDER_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




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_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. Імпорт нарахувань по зарплатній відомості


Файл імпорту містить інформацію про нарахування співробітникам по зарплатній відомості підприємства. Файл вивантажується з бухгалтерської програми на стороні клієнта та являє собою таблицю 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, де:



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»).


Файл імпорту нарахувань по зарплатній відомості з формату DBF аналогічний файлу імпорту нарахувань по зарплатній відомості «Amounts.dbf» див. «Імпорт з DBF-

файлу».



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 для роботи в зовнішніх системах.

Приклад:


<DATAPACKET>



<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



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



співробітника для нанесення на картку С 26


17. PASSPORTNO Номер паспорту співробітника в

форматі ББ999999 для резидентів С 25

18. PASSPORTISSUEDATE Дата видачі паспорту співробітника в

форматі DD.MM.YYYY D 8

19. PASSPORTISSUEPLACE Місце видачі паспорта співробітника C 120




22. CITIZENSHIP Код країни громадянства співробітника

(для України 804)

N 3

23. ADDRESS Повна домашня адреса співробітника.

Якщо заповнюється це поле, тоді всі інші поля, що стосуються адреси співробітника (25-32), можна не зазначати. Примітка. Можливість зазначення адреси в даному полі регулюється внутрішніми налаштуваннями банку

С 254

24. JURADDRESS Повна адреса розсилки.

Якщо заповнюється це поле, тоді всі інші поля, що стосуються адреси розсилки (33-40), можна не зазначати. Примітка. Можливість зазначення адреси в даному полі регулюється внутрішніми налаштуваннями банку

С 254



26. ADDR_POSTCODE Поштовий індекс домашньої адреси


27. ADDR_REGIONID Цифровий код країни домашньої

адреси співробітника з довідника областей

N 2



С 40

29. ADDR_DISTRICT Район домашньої адреси співробітника C 40




даних

Довжина

поля





32. ADDR_HOUSENO Номер будинку домашньої адреси




C 10

34. JURADDR_COUNTRYID Адреса для кореспонденції.

Цифровий код країни N 3

35. JURADDR_POSTCODE Адреса для кореспонденції.

Поштовий індекс C 6

36. JURADDR_REGIONID Адреса для кореспонденції.

Цифровий код області з довідника областей

N 2


Найменування області С 40




Населений пункт C 40


Вулиця

C 40


Номер дома C 10


Номер квартири C 10

43. ACCEPTANCEDATE Дата прийому співробітника на роботу

в форматі DD.MM.YYYY D 8


форматі +380999999999 (обов'язково повинен бути зазначений хоча б один телефон - домашній, мобільний або робочий)

C 30



C 30



C 30



С 15

48. RESIDENTCOUNTRYID Цифровий код країни резидента N 3

49. RESIDENTTYPEID Резидентність (К030) N 1

50. REGBYSELFBUSY Ознака того, що співробітник


N 1

Зразки файлів додаються до комплекту документації (див. «2.5.1.Export_Employees.xml»).



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 Дата народження співробітника в


5. CITY Місце народження співробітника C 40



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 Дата прийому співробітника на оботу

в форматі 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



С 15 -


Код країни резидентності N 3




Довжина

поля

О/З


таблиці прив'язок співробітника до номера підприємства (параметр «Деталі»). Примітка. Це поле є доступним тільки при експорті даних з web-клієнта

C 40

41. REGBYSELFBUSY Ознака того, що співробітник


N 1


Зразки файлів додаються до комплекту документації (див. «2.5.2.Export_Employees.xls»).

2.5.3. Експорт до TXT-файлу

Файл експорту даних про співробітників підприємства в формат TXT містить інформацію про його співробітників підприємства та вивантажується з системи iFOBS.eSalary для роботи в зовнішніх системах.



Довжина

поля

О/З








Дата видачі паспорта співробітника в форматі DDMMYYYY

D 8




форматі DDMMYYYY D 8



С 26






Довжина

поля

О/З

12. CITIZENSHIP Код країни держави співробітника

(для України 804) N 3





N 3



С 254



















С 254




N 3




C 6



C 40



C 40



C 36


Вулиця

C 40


Номер дома

C 10



C 10




Довжина

поля

О/З


роботу в форматі DDMMYYYY D 8


форматі +380999999999 C 20


форматі +380999999999 C 20


форматі +380999999999 C 20

37. TABNO Табельний номер співробітника С 15


Зразки файлів додаються до комплекту документації (див. «2.5.3.Export_Employees.txt»).

2.5.4. Експорт до HTML-файлу

Файл експорту даних про співробітників підприємства в формат HTML містить інформацію про його співробітників підприємства та вивантажується з системи iFOBS.eSalary для роботи в зовнішніх системах.



Довжина

поля

О/З








Дата видачі паспорта співробітника в форматі DD.MM.YYYY

D 8







С 26



12. CITIZENSHIP Код країни громадянства

співробітника (для України 804) N 3




Довжина

поля

О/З





N 3



С 254



















С 254




N 3




C 6



C 40



C 40



C 36


Вулиця

C 40


Номер дома

C 10



C 10


роботу в форматі DD.MM.YYYY D 8




Довжина

поля

О/З


форматі +380999999999 C 20


форматі +380999999999 C 20


форматі +380999999999 C 20


Примітка. При імпорті не враховується. Це поле є доступним тільки при експорті даних з web-клієнта

С 15


Зразки файлів додаються до комплекту документації (див. «2.5.4.Export_Employees.html»).

2.5.5. Експорт реєстру звільнених співробітників

Файл експорту реєстру звільнених співробітників формується для автоматичного розсилання інформації про звільнених співробітників в банк.

Приклад:

<?xml version="1.0" encoding="UTF-8"?>


<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 Табельний номер співробітника. +




Призначення/опис О/З


6. CARDACCOUNTNO Номер карткового (або іншого) рахунку співробітника

-

7. LASTNAME Прізвище співробітника +

8. FIRSTNAME Ім’я співробітника +


Зразки файлів додаються до комплекту документації (див. «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. Картковий рахунок Номер карткового рахунку співробітника +




2. ПIБ

ПІБ співробітника.

Прізвище, ім'я, по батькові розділені одним пробілом

+

3. IПН Ід. код співробітника +

4. ЗКП Код ЗКП +



3. ФОРМАТИ ФАЙЛІВ ІМПОРТУ ТА ЕКСПОРТУ,

ВИКОРИСТОВУВАНІ В АБС Б2

3.1. Імпорт даних про співробітників


Файл імпорту даних про співробітників підприємства містить інформацію про підприємства клієнта та його співробітників та формується з бухгалтерської програми клієнта.

Приклад:



<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 (*при імпорті не враховується)

Назва підприємства. Якщо потрібні подвійні лапки ", їх слід замінити на ' або &quot

C 30 -


3. NALOGREGISTERDA Дата реєстрації підприємства у D 8 -




Довжина

поля

О/З

TE податковій (в форматі ДД/ММ/РРРР)

4. NALOGREGISTERNO Номер реєстрації підприємства у податковій

N 10 -

5. ADDRESS Повна адреса підприємства. Якщо поле не заповнено або в ньому встановлений прочерк (знак мінус "-"), тоді при збереженні запису про співробітника в адресі буде зазначено «Не визначено»

C 254 -


C 20 -




C 100 -

10. SITEID МФО банку анкети співробітника, а також контрагента-підприємства. Якщо параметр не заповнено, то зазначається значення МФО банку поточного користувача АБС Б2

N 6 -



12. IDENTIFYCODE Ідентифікаційний код співробітника (для нерезидентів, а також для резидентів, що відмовилися від присвоєння ідентифікаційного коду, заповнюється значенням «000000000»)

N 10 +




16. EMBOSSIGLI Транслітерація прізвища та імені співробітника для нанесення на картку. Альтернативний варіант написання цього поля EMBOSSINGLIT дозволяє замінювати деякі параметри співробітника, якщо він вже був внесений

С 26


18. PASSPORTNO Номер паспорту співробітника в форматі ББ999999 для резидентів

С 25 +


Дата видачі паспорту співробітника в форматі ДД/ММ/РРРР

D 8




D 8



N 3

24. ADDRESS Повна домашня адреса співробітника. Якщо заповнюється це поле, тоді всі інші поля, що стосуються адреси співробітника (25-32), можна не зазначати

С 254

25. JURADDRESS Повна адреса розсилки. Якщо заповнюється це поле, тоді всі інші поля, що стосуються адреси розсилки (33-40), можна не

С 254




Довжина

поля

О/З

зазначати


N 3

27. ADDR_POSTCODE Поштовий індекс домашньої адреси співробітника

C 6


С 40


C 40


C 40


C 40

32. ADDR_HOUSENO Номер будинку домашньої адреси співробітника

C 10


C 10


Адреса для кореспонденції. Цифровий код країни

N 3


Адреса для кореспонденції. Поштовий індекс

C 6

36. JURADDR_REGION Адреса для кореспонденції. Найменування області

С 40


C 40


C 40

39. JURADDR_STREET Адреса для кореспонденції. Вулиця

C 40

40. JURADDR_HOUSENO Адреса для кореспонденції. Номер дома

C 10

41. JURADDR_FLAT Адреса для кореспонденції. Номер квартири

C 10


D 8

43. HOMEPHONE Домашній телефон співробітника в форматі +380999999999 (обов'язково повинен бути зазначений хоча б один телефон - домашній, мобільний або робочий)

C 30

44. WORKPHONE Робочий телефон співробітника в форматі +380999999999 (обов'язково повинен бути зазначений хоча б один телефон - домашній, мобільний або робочий)

C 30

45. MOBILEPHONE Мобільний телефон співробітника в форматі +380999999999 (обов'язково повинен бути зазначений хоча б один телефон - домашній, мобільний або робочий)

C 30


Код країни резидентності співробітника. Якщо цей параметр відсутній або не заповнений, за умовчанням заповнюється значенням цифрового коду країни домашньої адреси співробітника (поле ADDR_COUNTRYID). Якщо поле ADDR_COUNTRYID не заповнено, за умовчанням код України - «804»

N 3 -

47. REGBYSELFBUSY Ознака того, що співробітник N 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. Якщо у файлі імпорту номер рахунку зазначено:

Виконується перевірка наявності рахунку та відповідності його номера контрагенту співробітника, а також його статус;



Якщо у контрагента співробітника зазначений рахунок відсутній або рахунок було закрито, запис не імпортується;

Перелік записів, що не було імпортовано, буде відображено в протоколі;

Операціоніст може внести зміни в файл та імпортувати його ще раз.

3. Перевірка валюти рахунку:

Якщо валюта рахунку не зазначена, приймається значення за умовчанням – 980 (гривня);

Якщо зазначено валюту рахунку, що відрізняється від 980 (гривня), запис не імпортується;

Перелік записів, що не було імпортовано, буде відображено в протоколі;

Операціоніст може внести зміни в файл та імпортувати його ще раз.


«3.1.2.Import_Employees.txt»).

3.2. Імпорт даних про рахунки співробітників


Файл імпорту даних про рахунки співробітників підприємства містить інформацію про співробітників підприємства, зареєстрованих в зарплатному проекті на стороні банка з інформацією про створені карткові рахунки співробітників в системі емісії платіжних карток.

Приклад:



<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




2. NAME Найменування підприємства

3. IDENTIFYCODE Ідентифікаційний код

Інформація про рахунки співробітників містить такі значення

4. IDENTIFYCODE Ідентифікаційний код співробітника


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



Зразки файлів додаються до комплекту документації (див. «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




х


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_Status

Сімейний стан співробітника. Не враховується при імпорті

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_Since

Резидент з якого часу. Не враховується при імпорті

D 245 8

22. Doc_Type Тип ідентифікаційного документу. Завжди заповнюється значенням «001»

C 253 3

23. Id_Card Номер паспорту. Для громадянина України заповнюється номером паспорту. Для не громадянина України заповнюється значенням параметру «серія та номер паспорта» з картки співробітника

C 256 16

24. Serial_No Серія паспорта. Для громадянина України заповнюється серією паспорту. Для не громадянина

C 272 15




х


України Не враховується при імпорті

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_Phone

Не враховується при імпорті 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


57. Mng_E_Mails Не враховується при імпорті C 1270 100

58. Year_Inc Не враховується при імпорті N 1370 14

59. Ccy_For_Incom


60. Imm_Prop_V Не враховується при імпорті N 1387 14




х


alue

61. U_Cod1 Не враховується при імпорті C 1401 3



64. U_Field1 Не враховується при імпорті C 1416 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 Номер замовлення.


N 9 20

41. Action Тип дії:

01 – введення нового клієнта,

02 – оновлення даних клієнта.


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





х


Заповнюється значенням, зазначеним операціоністом при вивантаженні файлу (з довідника «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


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


57. U_Code5 Не враховується при імпорті C 283 6

58. U_Code6 Не враховується при імпорті C 289 6



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


69. Future Use Не враховується при імпорті C 521 485

Запис типу 30 (дані про картковий рахунок)




Опис Тип даних




С 1 2



N 3 6

3. Order number Номер замовлення.


N 9 20

4. Action Тип дії:

01 – введення нового клієнта,

02 – оновлення даних клієнта


C 29 2


Заповнюється або наскрізним лічильником «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 Тип рахунку.


C 97 2

12. Adjust_Flag Індикатор генерації регулювальних транзакції:

0 – вимкнено

1 – увімкнено


C 99 1

13. Stat_Change Режим змінення статусу рахунку.


C 100 1

14. Crd Дозволений кредит.


N 101 14

15. Min_Bal Мінімальний баланс.


N 115 12

16. Non_Reduce_Bal

Незнижуваний залишок.


N 127 14

17. Tranz_Acct Не враховується при імпорті C 141 20

18. Auth_Bonus Не враховується при імпорті N 161 14

19. Ab_Expirity Не враховується при імпорті D 175 8

20. Deposit_Account


21. Deposit Не враховується при імпорті N 203 14




Опис Тип даних


22. Deposit_Coment




25. Ufield_5 Не враховується при імпорті C 256 20


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_acct


34. R_card_oper_ccy


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 2



N 3 6

3. Order number Завжди заповнюється значенням «1» N 9 20

4. Action Номер замовлення.


C 29 2


заповнюється або наскрізним лічильником «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





х


9. Card_Type Тип картки.


C 79 2

10. Base_Supp Інформація про пріоритетності картки:

1 - основна

2 - додаткова


C 81 1

11. Cond_Set Набор умов картки.

Заповнюється значенням, зазначеним операціоністом при вивантаженні файлу (з довідника «Условия карт» (умови карток)).

C 82 3

12. Auth_Limit Авторизаційний ліміт [0..9].

Поле обов’язково заповнювати, якщо довжина BIN-коду – 6 символів.


C 85 1

13. Risk_Level Рівень риску.

Завжди заповнюється значенням «А»

C 86 1

14. Pin Flag Інформація про генерації PIN-коду:

1 – PIN-код генерується,

0 - PIN-код не генерується.


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





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.





х


33. Rrisk_Level Не враховується при імпорті C 447 5

34. Old_Client Не враховується при імпорті C 452 16

35. Card_services_set


36. F_name1


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


49. Future Use Не враховується при імпорті 656 463

Хвостовик

№ Название поля Опис Тип дани

х

Позиции Макс. довжина поля



С 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>



<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 Ідентифікаційний код підприємства


Дата реєстрації підприємства у податковій (в форматі ДД/ММ/РРРР)

4. NALOGREGISTERNO Номер реєстрації підприємства у податковій


6. CONTACTINFO Контактна інформація

7. FAX Номер факсу підприємства


Інформація про співробітниках містить такі значення

9. ID Порядковий номер співробітника





14. EMBOSSIGLI Транслітерація прізвища та імені співробітника для нанесення на картку. Альтернативний варіант написання поля EMBOSSINGLIT дозволяє замінювати деякі параметри співробітника, якщо він вже був внесений

15. SEX Стать співробітника (M або F)

16. PASSPORTNO Номер паспорту співробітника в форматі ББ999999 для резидентів


Дата видачі паспорту співробітника в форматі ДД/ММ/РРРР


Місце видачі паспорту співробітника

19. BIRTHDATE Дата народження співробітника в форматі ДД/ММ/РРРР




20. BIRTHPLACE Місце народження співробітника


22. ADDRESS Повна домашня адреса співробітника.

Якщо заповнюється це поле, тоді всі інші поля щодо адреси співробітника (25-32) можна не зазначати.

Примітка. Можливість вказівки адреси в даному полі регулюється внутрішніми налаштуваннями банку


Якщо заповнюється це поле, тоді всі інші поля щодо адреси розсилки (32-39) можна не зазначати.

Примітка. Можливість вказівки адреси в даному полі регулюється внутрішніми налаштуваннями банку







30. ADDR_HOUSENO Номер дома домашньої адреси співробітника













Вулиця


Номер дома




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);



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 - Не заповнюється



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_HOMECITYID

13. Hdistrictid Ідентифікатор району всередині області України

361 5 + Регулюється константою Б2:

SAL_ISCARD_HOMEDISTRICTID



14. HregionID Ідентифікатор області всередині України

366 2 + Регулюється константою Б2:

SAL_ISCARD_HOMEREGIONID

15. HcountryID Ідентифікатор країни 368 2 + Регулюється константою Б2:

SAL_ISCARD_HOMECOUNTRYID

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 + Визначаєтьс

я за типом контрагента та кодом країни



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. Identkodoblid

Код області податкової реєстрації

877 3 - Не


46. Identtemp Прапорець «Тимчасова

податкова реєстрація» 880 1


47. Enrolled Дата укладання договору 881 8

+ + Не заповнюється

48. AgrExp Дата закінчення договору 889 8


49. MainAccCcy Валюта основного

рахунку 897 3




50. AddAccCcy Валюта додаткового

рахунку 900 3


51. BranchID Ідентифікатор філії

(дирекції) 903 4


52. ContractNum Номер договору 907 10


53. LegalContractNum

Юридичний номер договору

917 32 - Не


54. BaseCardName

Ім’я власника для ембосування на картці (латинкою)

949 24 - Не


55. BaseMcName Ім’я, що закодоване на

магнітній стрічці карки (в форматі ПРІЗВИЩЕ/ІМ’Я) (латинкою)

973 26 - Не


56. BaseRiskClassID

Ідентифікатор виду керування ризиками карток

999 5 - Не


57. BaseCardKindID

Ідентифікатор виду картки

1004 1 - Не


58. BaseCardPswrd

Кодове слово для ідентифікації клієнта

1005 50 - Не


59. BaseInformation

Додаткова інформація про клієнта

1055 40 - Не


60. BaseSoftStopModeID

Ідентифікатор засобу постановки карток до стоп-списку в разі несанкціонованої перевитрати

1095 1 - Не


61. Supp1CardName


1096 24 - Не


62. Supp1McName

Ім’я, що закодоване на магнітній стрічці карки (в форматі ПРІЗВИЩЕ/ІМ’Я) (латинкою)

1120 26 - Не


63. Supp1RiskClassID


1146 5 - Не


64. Supp1CardKindID


1151 1 - Не


65. Supp1Relation

Відносини між основним та додатковим власниками картки

1152 25 - Не


66. Supp1CardPswrd

Певне кодове слово для ідентифікації клієнта

1177 50 - Не


67. Supp1Information


1227 40 - Не




68. Supp1SoftStopModeID


1267 1 - Не


69. Supp2CardName


1268 24 - Не


70. Supp2McName


1292 26 - Не




1318 5 - Не


72. Supp2CardKindID


1323 1 - Не


73. Supp2Relation


1324 25 - Не


74. Supp2CardPswrd


1349 50 - Не




1399 40 - Не




1439 1 - Не


77. Supp3CardName


1440 24 - Не


78. Supp3McName


1464 26 - Не




1490 5 - Не


80. Supp3CardKindID


1495 1 - Не


81. Supp3Relation



82. Supp3CardPswrd









85. BASENAMECORP

Назва підприємства на основній картці




86. SUPP1NAMECORP

Назва підприємства на 1 дод. картці


87. SUPP2NAMECORP



88. SUPP3NAMECORP



Додаткова секція

89. Reserved1 Поле заміни 1 1708 20 - Не заповнюється










99. FinancestateID

Ідентифікатор фінансового стану


100. DebtserviceID

Ідентифікатор стану обслуговування кредиту


101. StatementModeID

Ідентифікатор виду отримання виписок клієнтами

2024 1 - + Не заповнюється

102. EmailAddress Адреса електронної пошти для отримання виписки


103. PermAddress Постійна (основна) поштова адреса для надсилання виписки


104. TempAddress Тимчасова (додаткова) поштова адреса для надсилання виписки


105. TempStart Дата початку використання тимчасової поштової адреси для надсилання виписки (включно)


106. TempFinish Дата закінчення використання тимчасової поштової адреси для надсилання виписки (включно)


107. PrefixID Префікс картки 2191 6 - Не заповнюється

108. AuthRangeID Ідентифікатор шаблона альтернативної авторизації


109. CodeCardID Ідентифікатор виду обслуговування картки


110. Mbal Мінімальний баланс (в копійках/центах)




111. FGRem Плаваюча страхова сума (%*100)


112. ScrAmt Страхова сума (в копійках/центах)


113. DscrAmt Зниження страхової суми (%*100)


114. Clim Дозволений кредит (в копійках/центах)


115. Ecre Додатковий кредит (в копійках/центах)


116. EcreStartDate

Дата надання додаткового кредиту


117. EcreExpDate Дата спливання терміну надання додаткового кредиту


118. RepCr Повернення кредиту (%*100)


119. AvlOver Сума санкціонованої перевитрати без штрафу, стоп-списку (в копійках/центах)


120. BillingCycleTypeID

Ідентифікатор типу розрахункових циклів


121. AllowChargeUAHOffUSD

Прапорець дозволу списання коштів з додаткового рахунку при нестачі на основному


122. PercCondID Ідентифікатор відсоткової ставки


123. GracePeriodtypeID

Ідентифікатор типу безкоштовного періоду


124. AccModelID Ідентифікатор облікової схеми


125. FremMin Мінімальне значення плаваючої страхової суми (в копійках, центах)


126. AvlAmtBlk Корекція доступної суми 2324 12 - Не заповнюється

127. Scramtexp Дата мінімізації страхової суми


128. Projectid Ідентифікатор проекту 2344 5 - Не заповнюється

129. ALLOWUSESCRAMT

Прапорець списання з стр. суми


130. ParameterID Ідентифікатор параметра 2350 5 - Не заповнюється

131. CondID Ідентифікатор умови ведення рахунку РКО


132. CONDID2 Ідентифікатор умови ведення рахунку транзиту


133. CONDID3 Ідентифікатор умови ведення рахунку конв.


134. RISKGROUPID

Ідентифікатор Категорії ризику


135. MOBILEOPID ID мобільного оператора 2371 5 - Не заповнюється



Хвостовик

№ Назва поля Опис Позиції Макс. довжина

поля

О/З

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. PHONENUMBER

№ мобільного телефону 2376 7 - Не заповнюється

137. STARTDATE Початок дії додаткових параметрів угоди


138. ISSUETYPE Тип терміновості картки 2391 4 - Не заповнюється

139. CREDITCOMMITTEELEVELID

Рівень кредитного комітету, що приймав остаточне рішення щодо видачі кредиту


140. SchemeID Ідентифікатор схеми 2399 4 - Не заповнюється



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 +




Довжина

О/З

- для громадян України першими двома символами параметра «Номер паспорта»;

- для не громадян України – значенням «-»

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 -




Довжина

О/З

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 -




Довжина

О/З

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» – найменування підприємства.

Приклад:


<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>



</ENTERPRISEINFO>

</DATAPACKET>



1. NAME Назва підприємства

2. IDENTIFYCODE Ідентифікаційний код підприємства


Дата реєстрації підприємства в податковій (в форматі ДД/ММ/РРР)

4. NALOGREGISTERNO Номер реєстрації підприємства в податковій


6. CONTACTINFO Контактна інформація

7. FAX Номер факсу підприємства



9. ID Порядковий номер співробітника





14. EMBOSSIGLI Транслітерація прізвища та імені співробітника для нанесення на картку. Альтернативний варіант написання цього поля EMBOSSINGLIT дозволяє замінити деякі параметри співробітника, якщо він вже був внесений

15. SEX Стать співробітника (M або F)

16. PASSPORTNO Номер паспорта співробітника в форматі ББ999999 для резидентів




Місце видачі паспорта співробітника


20. BIRTHPLACE Місце народження співробітника


22. ADDRESS Повна домашня адреса співробітника

Якщо заповнюється це поле, тоді усі інші поля, що мають відношення до адреси співробітника (25-32), можливо не зазначати.

Примітка. Можливість зазначення адреси в цьому полі регулюється внутрішніми налаштуваннями банку


Якщо заповнюється це поле, тоді усі інші поля, що мають відношення до адреси розсилки (32-39), можливо не зазначати.

Примітка. Можливість зазначення адреси в цьому полі регулюється внутрішніми налаштуваннями банку







30. ADDR_HOUSENO Номер дома домашньої адреси співробітника
















Вулиця


Номер дома



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 – порядковий номер файлу протягом дня.

Приклад:



<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">



<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_BRANCHID

МФО банку платника

8. PAYER_BANK_NAME Найменування банку платника

9. PAYER_BANK_ACCOUNTNO

Номер рахунку банку платника

10. PAYER_ACCOUNTNO Рахунок для списання грошових коштів

11. ONFLOW_TYPE Тип нарахування

12. TOTAL_SHEDULE_AMOUNT

Загальна сума зарплатної відомості

13. OPERATOR Оператор, що прийняв зарплатну відомість

14. COMMENT Коментар до відомості (приклад: Зарахування на ПК згідно авансового звіту від 05/11/2006 № 15)

15. FILE_NUMBER Порядковий номер файлу за день

Інформація щодо нарахованої співробітнику суми містить такі значення



18. CURRENCYID Код валюти рахунку

19. BRANCHID МФО банку, в якому відкритий рахунок




23. AMOUNT Сума для зарахування на картковий рахунок

Зразки файлів додаються до комплекту документації (див. «3.4.1.P71520111511121.xml»).



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. FileStructVersion

Номер версії (для нового формату)

13 3 N

3. Date Дата створення файлу (YYYYMMDD)

16 8 D

Структура файлу: Тіло


Тип даних

1. CommandID Код операції. Примітка. Наразі доступними є такі коди

1 3 N



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


C 40

3. SBK_NUM Номер карткового рахунку C 20

4. SBK_SUM Сума зарахування N 10,2

Зразки файлів додаються до комплекту документації (див. «3.4.3.P235_0000007780_0000137028.dbf»).




Платіжний файл містить інформацію щодо нарахувань співробітникам підприємства за зарплатною відомістю на карткові рахунки, що не ведуться в Б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»).


Платіжний файл з інформацією щодо нарахувань за співробітниками підприємства містить інформацію щодо нарахованих за зарплатною відомістю сумах, які мають бути перераховані на карткові рахунки співробітників. Файл вивантажується до АБС Б2. Операція є доступною для відомостей у статусах «Прийнятий» та «Проведений».

Файлу експорту платіжного DBF файлу привласнюється назва виду «pКОД_КОНТРАГЕНТА_ВВВВВВВВВВ_ИИИИИИИИИИ», де:

Р – символьний ідентифікатор документа;

КОД_КОНТРАГЕНТА – код контрагента за підприємством;

ВВВВВВВВВВ – № відомості;

ИИИИИИИИИИ – ID відомості;




1. SBK_INN Ідентифікаційний код співробітника CHAR 10


CHAR 40

3. SBK_NUM Номер карткового рахунку CHAR 20

4. SBK_SUM Сума зарахування NUMBER 10,2

Documents

iFOBS.eSalary - KredoBank › public › upload › 27bd2f8244c... · Підсистема перерахування коштів на банківські картки співробітників