iFOBS.eSalary

Руководство пользователя: Импорт и экспорт данных

в рамках зарплатного проекта

в системе «Интернет-Клиент-Банкинг»

для субъектов хозяйственной деятельности

(Win32-версия)

23 июня 2014 г.

(Версия 2.1.5.Х)

ОГЛАВЛЕНИЕ

ВВЕДЕНИЕ ................................................................... 3

1. Импорт данных о сотрудниках .................................... 3

2. Импорт зарплатной ведомости .................................... 8

3. Экспорт данных о сотрудниках ................................. 11

4. Справочники .............................................................. 12

Страница 3 из 17

ВВЕДЕНИЕ

В данном документе подробно описан формат XLS-файла импорта и экспорта,

который используются в рамках работы с подсистемой iFOBS.eSalary.

Столбец «Тип данных» в таблицах описывает структуру данных и может

принимать следующие значения:

Значение Описание

C поле содержит строковое значение, выровнено влево

N поле содержит целое число без ведущих нулей, выровнено вправо

D поле содержит дату в формате YY/MM/DD (две цифры года, месяца и дня соответственно)

1. Импорт данных о сотрудниках

Файл импорта данных о сотрудниках предприятия содержит информацию о

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

представляет собой таблицу Excel, состоящую из одной вкладки «EMPLOYEES».

Образец файла прилагается к комплекту документации (см. «1.Сотрудники.xls»).

Файл имеет фиксированную структуру, описанную в таблице ниже.

№

пп Наименование поля Назначение/описание

Тип

данных

Длина

поля О/З

1. GENDER Пол сотрудника. Заполняется русской буквой М или Ж (без пробелов)

C 1 +

2. NAME Фамилия, имя, отчество сотрудника, которые введены через один пробел

C - +

3. EMBOSSING_NAME

Латинская транслитерация фамилии и имени сотрудника, которая эмбоссируется на з/п картах. Необходимо указать значение UNKNOWN.

После синхронизации с банком, фамилия и имя сотрудника будет преобразовано по

правилам транслитерации, установленным КМУ от 26.06.2007

C 26 +

4. BIRTHDATE Дата рождения сотрудника в формате

DD/MM/YYYY D 8 +

5. CITY Место рождения сотрудника C 40 +

6. ADDRESS Полный адрес сотрудника C 254 -

7. PASSPORT_NUMBER Номер паспорта сотрудника C 20 +

8. PASP_SERIES Серия паспорта сотрудника C 20 +

9. PASSPORT ISSUER Место выдачи паспорта C 120 +

10. PASSPORT_ISSUE_DATE Дата выдачи паспорта в формате DD/MM/YYYY

D 8 +

11. COUNTRY Код страны прописки N 3 -

12. CITY_REGISTRATION Город прописки С 36 -

13. ZIP Индекс прописки С 6 -

14. TEL_HOME Номер мобильного телефона в формате 0671234567 (не должен содержать пробелы, черточки, плюсы или скобки)

С 20 +

Страница 4 из 17

Примечание. В файле экспорта номер телефона выгружается в формате +380999999999

15. CODEWORD Кодовое слово для карты из заявления Сотрудника

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

Страна (согласно справочника кодов стран).

Если сотрудник - нерезидент (ISRESIDENT=2), код страны должен совпадать с кодом страны резидентности (RESIDENTCOUNTRYID)

N 3 +

31. JurAddr_Postcode Индекс C 6 +

32. JurAddr_RegionID

Область (согласно справочника кодов областей) Если сотрудник - нерезидент (ISRESIDENT=2) – данное поле не обязательно для заполнения

N 10 +/-

33. JurAddr_District Район C 40 +

34. JurAddr_City Город C 40 +

35. JurAddr_Street Улица C 40 +

36. JurAddr_Houseno Дом C 10 +

37. JurAddr_Flat Квартира C 10 +

38. TABNO Табельный номер сотрудника. Значение сохраняется в таблице привязки сотрудника к номеру предприятия

С 15 -

Страница 5 из 17

39. RESIDENTCOUNTRYID

Код страны резидентности. (согласно справочника кодов стран) Заполняется если сотрудник - нерезидент

(ISRESIDENT=2) Для сотрудников-резидентов, данное поле не обязательно для заполнения

N 3 +/-

Внимание!

Все данные по сотрудникам в импортируемом файле должны:

- соответствовать паспортным данным сотрудников;

- соответствовать данным в заявлении на открытие счетов сотрудникам;

- заполняться без ошибок;

- заполняться на укр. языке.

Необязательные поля для заполнения (О/З «-») выделены в шаблоне серым

цветом. Их заполнять не нужно.

Удалять поля (в т.ч. необязательные для заполнения) или менять их местами -

запрещено. Импорт файлов в данном случае будет безуспешным.

Обратите внимание на формат ячеек в таблице Excel, где необходимо

указывать даты. Даты должна быть в формате ДД/ММ/ГГГГ. (формат ДД-ММ-ГГГГ - является неправильным и импорт файлов в данном случае будет безуспешным).

Если необходимо выполнить заказ нескольких типов карт (Visa Electron, Visa

Classic, Visa Gold) для разных категорий сотрудников, обязательно необходимо

подготовить несколько файлов импорта = кол-ву типов карт, которые Вы планируете

заказать:

Один файл – для сотрудников, которым необходимо заказать карты типа Visa Electron.

Второй файл - для сотрудников, которым необходимо заказать карты типа Visa Classic.

Третий файл - для сотрудников, которым необходимо заказать карты типа Visa Gold.

Последовательность действий для импорта файлов сотрудников:

Необходимо выполнить 5 действий указанных ниже:

В открывшемся окне необходимо выбрать один из заранее подготовленных файлов для импорта и нажать кнопку «Открыть»:

В появившемся окне необходимо выбрать Предприятие, «Зарплатный проект» и «Тип сделки ПТС» (иными словами - тип карты, по умолчанию - Electron Salary). Если Вы импортируете файл с перечнем сотрудников, которым необходимо заказать карты типа Visa Classic, Вам необходимо из выпадающего списка выбрать Classic Salary):

Нажать кнопку

Страница 7 из 17

Если импорт произошел с ошибками, система выдаст предупреждение и предложит вам просмотреть ошибки в импортируемом файле:

В случае успешного импорта на экране появится соответствующее сообщение.

Внимание! Если у Вас несколько файлов для загрузки, необходимо выполнить операцию по импорту по каждому файлу, с выбором соответствующего «Типа сделки ПТС».

2. Импорт зарплатной ведомости

Файл импорта зарплатной ведомости предприятия содержит информацию о

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

бухгалтерской программы на стороне клиента и представляет собой таблицу Excel,

состоящую из двух вкладок: 1 – информация о ЗП ведомости («SheduleInfo»), 2 –

данные о сотрудниках (Amounts).

Образец файла прилагается к комплекту документации (см. «2.Зарплатная

ведомость.xls»).

1. Первая вкладка - «SheduleInfo»:

Вкладка имеет фиксированную структуру, описанную в таблице ниже.

№

пп Наименование поля Назначение/описание О/З

1. SHEDULE_DATE Дата зарплатной ведомости в формате ДД/ММ/ГГГГ +

2. SHED_NUMBER Номер зарплатной ведомости +

3. CLIENTNAME Наименование предприятия плательщика -

4. BANK_MFO МФО банка в котором открыт счёт плательщика (380388) +

5. BANK_NAME Наименование банка, в котором открыт счёт плательщика -

6. BANK_ACCNO Счёт плательщика в банке (транзитный) -

7. ACCOUNTNO Счёт для списания средств +

8. SHED_SUM Общая сумма зарплатной ведомости в формате

ГРН,КОП +

9. EXTACCOUNT Признак списания средств -

10. CONTRAGENT_ZKP

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

Данное поле может быть не заполнено, если:

1. По предприятию определен один ЗКП, его код проставляется автоматически;

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

Если по предприятию не определено ни одного ЗКП, то при импорте система выдаст ошибку

+/-

11. COMMENTS Необходимо указать за какой период производится выплата +

12. ONFLOWTYPE Вид начисления по зарплатной ведомости. (согласно справочника видов начисления по зарплатной ведомости)

+

2. Вторая вкладка – «Amounts»:

Вкладка имеет фиксированную структуру, описанную в таблице ниже.

№ пп

Наименование поля Назначение/описание О/З

1. IDCODE

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

Примечание. Если сотрудник является нерезидентом или он отказался от присвоения ид.кода, то данное

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

+

2. TABNO

Табельный номер сотрудника.

Если в ид. коде указано значение 000000000 (сотрудник нерезидент или отказался от присвоения кода), данное поле является обязательным для

заполнения

-

3. ACCOUNTNO

Номер карточного счёта сотрудника.

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

-

4. LASTNAME Фамилия сотрудника -

5. FIRSTNAME Имя сотрудника -

6. MIDDLENAME Отчество сотрудника -

7. AMOUNT Сумма для зачисления на счёт сотрудника в формате ГРН,КОП +

После ввода всех необходимых данных, сформированный XLS-файл является

готовым для импорта.

Внимание!

Все данные по сотрудникам должны быть указаны на укр. языке.

Необязательные поля для заполнения (О/З «-») выделены в шаблоне серым

цветом. Их заполнять не нужно.

Удалять поля (в т.ч. необязательные для заполнения) или менять их местами -

запрещено. Импорт файлов в данном случае будет безуспешным.

Обратите внимание на формат ячеек, где необходимо указывать даты. Дата

должна быть в формате ДД/ММ/ГГГГ. (формат ДД-ММ-ГГГГ - является неправильным и импорт файлов в данном случае будет безуспешным)

Последовательность действий для импорта зарплатной ведомости:

Необходимо выполнить 5 действий указанных ниже:

В открывшемся окне необходимо выбрать заранее подготовленный файл для импорта и нажать кнопку «Открыть»:

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

В случае успешного импорта на экране появится соответствующее сообщение.

После чего з/п ведомость отобразится в списке Зарплатных ведомостей предприятия. Перед отправкой з/п ведомости в банк, необходимо подписать документ (ЭЦП) Пользователям, у которых есть право подписи.

Внимание! Если в системе настроено автоматическое подписание документов, тогда импортируемые зарплатные ведомости будут также подписываться автоматически (Сервис/Настройки/Документы/Параметры/, с подробным описанием можно ознакомиться в руководстве «iFobs_Win32_Руководство пользователя.doc», раздел 7.4.8.1.).

3. Экспорт данных о сотрудниках

Файл экспорта данных о сотрудниках в формат XLS аналогичен файлу импорта

данных о сотрудниках из файла формата XLS, описанному в п. «Ошибка! Источник

ссылки не найден.».

4. Справочники

Справочник видов начислений по зарплатной ведомости

ONFLOWTYPE

Заработная плата и авансы

Безналичное пополнение карточных счетов

Аванс на командировку

Пособие в связи с рождением ребенка

Пособие в связи с уходом за ребенком до 3-х лет

Премия

Больничные

Справочник кодов областей

ADDR_RegionID Краткое наименование

1 Крим

2 Вiнницька

3 Волинська

4 Дніпропетровська

5 Донецкая

6 Житомирська

7 Закарпатська

8 Запорiзька

9 Iвано-Франкiвська

10 Київська

11 Кiровоградська

12 Луганська

13 Львiвська

14 Миколаївська

15 Одеська

16 Полтавська

17 Рiвненська

18 Сумська

19 Тернопiльська

20 Харьковская

21 Херсонська

22 Хмельницька

23 Черкаська

24 Чернівецька

25 Чернiгiвська

26 м. Києв

27 м. Севастопiль

Страница 13 из 17

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

Addr_CountryID Название страны

4 Афганiстан

8 Албанiя

10 Антарктика

12 Алжир

16 Американське Самоа

20 Андорра

24 Анґола

28 Антиґуа і Барбуда

31 Азербайджан

32 Аргентина

36 Австралiя

40 Австрiя

44 Багамськi Острови

48 Бахрейн

50 Банґладеш

51 Вiрменiя

52 Барбадос

56 Бельґiя

60 Бермудськi Острови

64 Бутан

68 Болiвiя, Багатонацiональна держава

70 Боснiя i Герцеґовина

72 Ботсвана

74 Острiв Буве

76 Бразiлiя

84 Белiз

86 Британська територiя в Iндiйському Океанi

90 Соломоновi Острови

92 Вiрґiнськi Острови (Брит.)

96 Бруней-Даруссалам

100 Болгарiя

104 М'янма

108 Бурундi

112 Бiлорусь

116 Камбоджа

120 Камерун

124 Канада

132 Кабо-Верде

136 Каймановi острови

140 Центральноафриканська Республiка

144 Шрi-Ланка

148 Чад

152 Чiлi

156 Китай

158 Тайвань, Провiнцiя Китаю

162 Острiв Рiздва

166 Кокосовi (Кiлiнґ) Острови

170 Колумбiя

174 Комори

175 Майотта

178 Конґо

180 Конґо, Демократична Республiка

184 Острови Кука

188 Коста-Рiка

Страница 14 из 17

191 Хорватiя

192 Куба

196 Кiпр

203 Чехiя

204 Бенiн

208 Данiя

212 Домiнiка

214 Домiнiканська Республiка

218 Еквадор

222 Сальвадор

226 Екваторiальна Ґвiнея

231 Ефiопiя

232 Ерiтрея

233 Естонiя

234 Фарерськi Острови

238 Фолклендськi (Мальвiнськi) Острови

239 Пiвденна Джорджiя та Пiвденнi Сандвiчевi Острови

242 Фiджi

246 Фiнляндiя

248 Аландськi острови

250 Францiя

254 Французька Ґвiана

258 Французька Полiнезiя

260 Французькi Пiвденнi Територiї

262 Джiбутi

266 Ґабон

268 Грузiя

270 Ґамбiя

275 Палестинська Територiя

276 Нiмеччина

288 Гана

292 Ґiбралтар

296 Кiрiбатi

300 Грецiя

304 Ґренландiя

308 Ґренада

312 Ґваделупа

316 Ґуам

320 Ґватемала

324 Ґвiнея

328 Ґайана

332 Гаїтi

334 Острiв Герд i Острови МакДональд

336 Святий Престол (Держава-мiсто Ватикан)

340 Гондурас

344 Гонконґ

348 Угорщина

352 Iсландiя

356 Iндiя

360 Iндонезiя

364 Iран, Iсламська Республiка

368 Iрак

372 Iрландiя

376 Iзраїль

380 Iталiя

384 Кот-Д'Iвуар

388 Ямайка

Страница 15 из 17

392 Японiя

398 Казахстан

400 Йорданiя

404 Кенiя

408 Корейська Народно-Демократична Республiка

410 Корея, Республiка

414 Кувейт

417 Киргизстан

418 Лаоська Народно-демократична Республiка

422 Лiван

426 Лесото

428 Латвiя

430 Лiберiя

434 Лiвiя

438 Лiхтенштейн

440 Литва

442 Люксембурґ

446 Макао

450 Мадаґаскар

454 Малавi

458 Малайзiя

462 Мальдiви

466 Малi

470 Мальта

474 Мартiнiка

478 Маврiтанiя

480 Маврiкiй

484 Мексика

492 Монако

496 Монголiя

498 Молдова, Республiка

499 Чорногорiя

500 Монтсеррат

504 Марокко

508 Мозамбiк

512 Оман

516 Намiбiя

520 Науру

524 Непал

528 Нiдерланди

531 Кюрасао

533 Аруба

534 Сiнт-Мартен (нiдерландська частина)

535 Бонайре, Сiнт-Естатiус i Саба

540 Нова Каледонiя

548 Вануату

554 Нова Зеландiя

558 Нiкараґуа

562 Нiґер

566 Нiґерiя

570 Нiуе

574 Острiв Норфолк

578 Норвеґiя

580 Пiвнiчнi Марiанськi Острови

581 Малi Вiддаленi Острови США

583 Мiкронезiя, Федеративнi штати

584 Маршалловi острови

Страница 16 из 17

585 Палау

586 Пакистан

591 Панама

598 Папуа-Нова Ґвiнея

600 Параґвай

604 Перу

608 Фiлiппiни

612 Пiткерн

616 Польща

620 Портуґалiя

624 Ґвiнея-Бiсау

626 Тiмор-Лештi

630 Пуерто-Рiко

634 Катар

638 Реюньйон

642 Румунiя

643 Росiйська Федерацiя

646 Руанда

652 Сен-Бартелемi

654 Острiв Святої Єлени

659 Сент-Кiтс i Невiс

660 Анґiлья

662 Сент-Люсiя

663 Сен-Мартен (французька частина)

666 Сен-П'єр i Мiкелон

670 Сент-Вiнсент i Ґренадiни

674 Сан-Марiно

678 Сан-Томе i Прiнсiпi

680 Сарк

682 Саудiвська Аравiя

686 Сенеґал

688 Сербiя

690 Сейшельськi Острови

694 Сьєрра-Леоне

702 Сiнґапур

703 Словаччина

704 В'єтнам

705 Словенiя

706 Сомалi

710 Пiвденна Африка

716 Зiмбабве

724 Iспанiя

728 Пiвденний Судан

729 Судан

732 Захiдна Сахара

740 Сурiнам

744 Шпiцберґен та Ян-Маєн

748 Свазiленд

752 Швецiя

756 Швейцарiя

760 Сирiйська Арабська Республiка

762 Таджикистан

764 Таїланд

768 Тоґо

772 Токелау

776 Тонґа

780 Трiнiдад i Тобаґо

Страница 17 из 17

784 Об'єднанi Арабськi Емiрати

788 Тунiс

792 Туреччина

795 Туркменiстан

796 Острови Теркс i Кайкос

798 Тувалу

800 Уґанда

804 Україна

807 Колишня Югославська республiка Македонiя

818 Єгипет

826 Велика Британiя

831 Ґернсi

832 Джерсi

833 Острiв Мен

834 Танзанiя, Об'єднана Республiка

840 США

850 Вiрґiнськi Острови (США)

854 Буркiна-Фасо

858 Уруґвай

860 Узбекистан

862 Венесуела, Болiварська республiка

876 Уоллiс i Футуна

882 Самоа

887 Ємен

894 Замбiя

999 Страны Еврозоны