API employee: различия между версиями

Материал из WiKi - UserSide
Строка 72: Строка 72:
  Обязательные параметры:
  Обязательные параметры:
   date_from - дата начала выборки
   date_from - дата начала выборки
   date_from - дата окончания выборки
   date_to - дата окончания выборки
  Необязательные параметры:
  Необязательные параметры:
   employee_id - id сотрудника
   employee_id - id сотрудника

Версия от 18:29, 28 ноября 2021

Раздел API ERP "UserSide"

Назначение: Сотрудники

Дополнительные параметры:
action - подкатегория запроса (возможное значение: см.ниже)

Подкатегории

check_pass

Добавлено с: 3.16dev2

Описание: Проверка совпадения логина и пароля на вход в UserSide
Обязательные параметры:
 login - логин
 pass - пароль

get_data

Добавлено с: 3.16dev2

Описание: Получение информации о сотруднике
Необязательные параметры:
 id - id сотрудника для выборки (можно через запятую)

get_division

Добавлено с: 3.16dev2

Описание: Получение информации о подразделении
Необязательные параметры:
 id - ID подразделения (можно через запятую)

get_division_list

Добавлено с: 3.16dev2

Описание: Список подразделений

get_employee_id

Добавлено с: 3.16dev2

Описание: Получение ID сотрудника по входящим данным
Обязательные параметры:
 data_typer - тип данных, которые проверяем (возможные значения: additional_field_XXX, name, login)
 data_value - значение

get_history

Доработано в: 3.16dev6 (добавлен параметр object_id)

Добавлено с: 3.16dev2

Описание: История действий (лимит 10000 записей в результатах выборки)
Обязательные параметры:
 date_from - дата начала выборки (с)
 date_to - дата окончания выборки (по)
Необязательные параметры:
 employee_id - id сотрудника (можно через запятую) 
 type_id - id типа действий (можно через запятую)
 object_id - id связанного объекта (можно через запятую)

get_history_type

Добавлено с: 3.16dev2

Описание: Типы действий в истории
Необязательные параметры:
 id - id типа действий

get_timesheet_data

Добавлено с: 3.16dev2

Описание: Получение информации из табеля работ
Обязательные параметры:
 date_from - дата начала выборки
 date_to - дата окончания выборки
Необязательные параметры:
 employee_id - ID сотрудника (можно через запятую)
 division_id - ID подразделения (можно через запятую)

get_work_time_data

Добавлено с: 3.17dev1

Описание: Получение информации о рабочем времени сотрудников
Обязательные параметры:
 date_from - дата начала выборки
 date_to - дата окончания выборки
Необязательные параметры:
 employee_id - id сотрудника

set_timesheet_data

Добавлено с: 3.16dev2

Описание: Добавление/изменение/удаление записи в табель работ
Обязательные параметры:
 employee_id - ID сотрудника
 date - дата
 type_id - id типа записи (1 - основное время, 2 - сверхурочное, 3 - прочее)
 value - количество часов (целое значение, либо: 994 - дежурный, 995 - не вышел, 996 - отпуск, 997 - выходной, 998 - больничный, 999 - командировка, либо 0 для удаления записи)

work_time_finish

Добавлено с: 3.16dev5

Описание: Фиксация момента окончания рабочего времени сотрудника 
Обязательные параметры:
 employee_id - id сотрудника
 date - дата и время
Необязательные параметры:
 comment - заметки

work_time_start

Добавлено с: 3.16dev5

Описание: Фиксация момента начала рабочего времени сотрудника 
Обязательные параметры:
 employee_id - id сотрудника
 date - дата и время
Необязательные параметры:
 comment - заметки