Чтобы записать и сгруппировать сотрудников по должностям, создайте объект «Должность».
Параметр | Тип | Описание | |||
ID | строка в формате UUID | идентификатор должности во внешней системе. Если не задать, будет сгенерирован автоматически | |||
Title* | строка | название должности | |||
NodeType | строка | тип создаваемой записи. Возможные значения — «группа» и «должность». Значение по умолчанию — «должность» | |||
Parent | строка в формате UUID | идентификатор родительской записи. Значение по умолчанию — «null», означает, что будет записана в корне справочника. Возможна привязка одной записи к другой, например указание категорий в должности, или привязка должностей к группе. Подробнее в комментарии | |||
IsClosed | строка | указывает, действует ли должность. При «true» — должность закрыта | |||
Clarification** | строка | дополнительное описание должности. Обязателен, если должность с таким наименованием уже существует в СБИС | |||
PaymentType | строка | вид оплаты. Возможные значения: «месяц», «час», «смена» | |||
Category | объект | дополнительные параметры для категории | |||
| Title* | строка | название должности для категории | ||
NeedPrint | строка | указывать или нет категорию вместе с должностью при печати документов. При значении «true» — печатать. Значение по умолчанию — «false». | |||
ReportCardFillingStrategy | строка | стратегия заполнения табеля. Возможные значения: «по графику», «по расписанию», «по активности» | |||
Accruals | массив | начисления по должности. Первый элемент массива считается основным начислением | |||
| Value* | строка | сумма начислений. Значение по умолчанию «0» | ||
ADType | объект | вид начисления или удержания. Поиск происходит по параметру «Name». Если хотя бы одно из начислений с указанным названием не найдено, вернется ошибка | |||
| Name* | строка | служебное имя справочника вида начислений и удержаний в СБИС | ||
Title | строка | при записи не используется, возвращается только на чтение. Текстовое название вида начисления или удержания. Поле «Название» справочника «Виды начислений и удержаний» | |||
WorkSchedule | объект | график рабочего времени по должности. Поиск графика происходит по параметру «Title». Если график не найден, вернется ошибка | |||
| Title* | строка | название графика для поиска | ||
CategoryCode | строка | код категории | |||
OKZ | объект | общероссийский классификатор занятий. Обязательно наличие хотя бы одного из двух полей объекта. Поиск осуществляется по обоим полям. Если ничего не найдено, вернется ошибка | |||
| Code | строка | код ОКЗ | ||
Title | строка | название ОКЗ | |||
OKPDTR | объект | общероссийский классификатор профессий рабочих, должностей служащих и тарифных разрядов. Обязательно наличие хотя бы одного из двух полей объекта. Поиск осуществляется по обоим полям. Если ничего не найдено, вернется ошибка | |||
| Code | строка | код ОКПДТР | ||
Title | строка | название ОКПДТР | |||
PeriodicRequirements | объект | периодические требования по должности | |||
| MedicalExamination | объект | частота прохождения медосмотра | ||
| Period | строка | выбранный период. Возможные значения: «месяц», «год». По умолчанию — «год» | ||
Value* | строка | количество медосмотров в выбранном периоде | |||
QualificationImprovement | объект | частота повышения квалификации | |||
| Period | строка | выбранный период. Возможные значения: «месяц», «год». По умолчанию — «год» | ||
Value* | строка | количество повышений в выбранном периоде | |||
PsychiatricExamination | объект | частота психиатрических освидетельствований | |||
| Period | строка | выбранный период. Возможные значения: «месяц», «год». По умолчанию — «год» | ||
Value* | строка | количество освидетельствований в выбранном периоде | |||
LocalizationTitles | массив объектов | локализованные наименования должности | |||
| LangCode | строка | язык локализации. Возможные значения: «ru», «en», «fr», «he», «kk», «ar», «uz» | ||
Title | строка | локализованное наименование | |||
Комментарии
- В справочнике должностей существует 2 типа записей «nodeType»:
- «группа» (или папка) — служит для упорядочивания справочника, группировки нескольких должностей или групп в одну. Имеет минимальный набор полей (остальные не учитываются): «ID», «Title», «NodeType» = «группа», «Parent»;
- «должность» — для указания должности. Обрабатывается весь набор полей.
- Чтобы записать категорию, создайте «Должность», укажите параметр «Category» и передайте «ID» должности в поле «Parent».
Если родительская должность изменится, у привязанных категорий автоматически обновятся параметры:
- «Title» — название должности. Название категории «categoryTitle» при этом останется прежним;
- «Clarification» — примечание;
- «WorkSchedule.Title» — название графика рабочего времени.
- Запись привязывается к родительской по полю «Parent»:
- чтобы создать запись в корне справочника, не заполняйте поле «Parent»;
- чтобы вложить запись в другую, в поле «Parent» укажите идентификатор UUID родительской записи;
- должности, привязанные к другой родительской должности, считаются ее категориями;
- должности можно привязать к группе;
- группы можно привязывать только к другим группам для создания дерева папок.
Никакие другие варианты связывания записей невозможны. Также невозможно привязать запись саму к себе (параметры «ID» и «Parent» должны отличаться).
Команды
- «sabyPosition.Update» — создать или обновить должность;
- «sabyPosition.Read» — прочитать должность;
- «sabyPosition.List» — вернуть список должностей;
- «sabyPosition.ChangeId» — обновить внешний идентификатор должности;
- «sabyPosition.Delete» — удалить должность.