Присоединяйтесь!

Структура документа «Изменение графика отпусков» в API

Структура документа «Изменение графика отпусков» в API

Чтобы перенести плановый отпуск, создайте документ «Изменение графика отпусков» с типом «PlanVacationScheduleChange».

Документ «Изменение графика отпусков» передается с помощью API только по структуре, которую вы установили в Saby в настройках раздела «Сотрудники».

Параметр
* — обязательный
** — условно-обязательный

Тип

Описание

Идентификатор*

строка

идентификатор документа, используется для его адресации

Номер

строка

если номер документа не указан, значение генерируется автоматически

Дата

строка
«ДД.ММ.ГГГГ»

если дата документа не указана, устанавливается текущая дата

Редакция

объект

редакция документа

 

Идентификатор

строка

идентификатор редакции, в которую вносятся изменения. Если параметр не указан, работа идет с текущей редакцией документа

ПримечаниеИС

строка

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

Тип

строка

тип документа, принимает значение «PlanVacationScheduleChange»

Регламент*

объект

заполняется по одному из полей — «Название» или «Идентификатор»

 

Идентификатор

строка

идентификатор регламента документооборота в Saby. Чтобы его получить, создайте документ в Saby и вызовите для него СБИС.ПрочитатьДокумент

Название

строка

название регламента документооборота в Saby. Если передан идентификатор, название не учитывается

НашаОрганизация**

объект

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

Обязателен, если документ передается по юридической структуре. Не указывать, если по управленческой.

Допускается передавать только реквизиты головной организации. В зависимости от формы организации заполняется один из информационных блоков

 

СвЮЛ

объект

сведения о юридическом лице

 

ИНН*

строка

ИНН организации. Для юридических лиц в РФ — 10 символов. Для иностранных организаций — в зависимости от законодательства их стран

КПП*

строка

9 символов

КодФилиала

строка

код филиала

КодСтраны

строка

код страны в формате ISO 3166-1 Numeric

Название

строка

название организации

 

СвФЛ

объект

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

 

ИНН*

строка

ИНН. Для индивидуальных предпринимателей и физических лиц в РФ — 12 символов. Для иностранцев — в зависимости от законодательства их стран

КодФилиала

строка

код филиала

КодСтраны

строка

код страны в формате ISO 3166-1 Numeric

Фамилия

строка

фамилия

Имя

строка

имя

Отчество

строка

отчество

Автор

объект

сотрудник — автор документа. Если задан идентификатор, сотрудник ищется по нему, иначе по ФИО

 

Фамилия

строка

фамилия автора документа

Имя

строка

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

Отчество

строка

отчество автора документа

Идентификатор

строка

идентификатор сотрудника во внешней системе

Вложение

объект

массив объектов

 

Идентификатор

строка

идентификатор вложения, который используется для его адресации

Название

строка

название вложения

Удален

строка

признак удаления вложения. Возможные значения — «Да» или «Нет»

Дата

строка
«ДД.ММ.ГГГГ»

дата загрузки

Файл

объект

вложение документа

 

Имя

строка

имя файла

Ссылка

строка

ссылка на объект в файловом хранилище

Тип

строка

тип вложения

Подразделение*

объект

информация о подразделении сотрудника

 

Идентификатор

строка

код подразделения

Название

строка

название подразделения

ДатаНачала

дата
«ДД.ММ.ГГГГ»

по этой дате определяется год, на который действует документ

Примечание

строка

комментарий в документе

ИзмененияПлановыхОтпусков*

массив объектов

каждый элемент массива содержит данные для изменения плановых отпусков по одному сотруднику. Определите сотрудника одним из способов (указаны по убыванию приоритета):

  • «ИдентификаторСотрудника». Используется для идентификации сотрудника по конкретной должности. Идентификатор возвращается в параметре extEmployeeId в результате запроса sabyEmployee.ListPositions;
  • «ВнешнийИдентификатор» (лица) + «ДатаТрудовогоДоговора» (строка «ДД.ММ.ГГГГ») и «НомерТрудовогоДоговора». Идентификация сотрудника по естественным ключам;
  • «ВнешнийИдентификатор» (лица) + «ТабельныйНомер». Способ подходит, если во внешней системе табельные номера уникальны для разных трудовых договоров

 

ИдентификаторСотрудника*

строка

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

Интервалы*

массив объектов

каждый элемент массива содержит информацию для изменения одного планового отпуска сотрудника. Заполните поля:

  • «ДатаНачала» и «ДатаОкончания» — чтобы создать плановый период;
  • «ДатаНачала», «ДатаОкончания», «ДатаНачалаСтарая» и «ДатаОкончанияСтарая» — изменить плановый период;
  • «ДатаНачала», «ДатаОкончания», «ДатаНачалаСтарая» и «ДатаОкончанияСтарая» — чтобы удалить отпуск, укажите одинаковые значения.

 

ДатаНачалаСтарая

строка
«ДД.ММ.ГГГГ»

старая дата начала отпуска

ДатаОкончанияСтарая

строка
«ДД.ММ.ГГГГ»

старая дата окончания отпуска

ДатаНачала

строка
«ДД.ММ.ГГГГ»

новая дата начала отпуска

ДатаОкончания

строка
«ДД.ММ.ГГГГ»

новая дата окончания отпуска

Примечание

строка

комментарий к изменению графика отпусков

Комментарий

Чтобы перенести отпуск сотрудника на следующий год, создайте для него график отпусков и укажите нужный период отпуска. В текущем графике удалите перенесенный отпуск — создайте документ «Изменение графика отпусков» и в объекте «Интервалы» передайте одинаковые значения для параметров «ДатаНачала», «ДатаОкончания», «ДатаНачалаСтарая» и «ДатаОкончанияСтарая».

Пример запроса

Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.