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

Корректировка отпуска в API

Корректировка отпуска в API

Корректировка отпуска — документ, который позволяет указать остаток дней отпуска и период, за который он предоставляется. Оформите корректировку, если:

  • начинаете вести учет в СБИС и вносите оставшиеся дни отпуска всех сотрудников;
  • меняете период, за который сотруднику был предоставлен отпуск;
  • корректируете количество оставшихся дней отпуска у сотрудника.

Создайте документ «Отпуск» с видом «Корректировка».

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

Тип

Описание

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

строка

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

Номер

строка

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

Дата

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

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

Редакция

объект

номер редакции

 

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

строка

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

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

строка

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

Тип*

строка

тип документа. Принимает значение «Отпуск»

Регламент

объект

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

 

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

строка

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

Название

строка

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

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

объект

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

 

СвЮЛ

объект

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

 

ИНН

строка

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

КПП

строка

КПП организации, 9 символов

КодФилиала

строка

код филиала

КодСтраны

строка

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

Название

строка

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

СвФЛ

объект

сведения об индивидуальном предпринимателе

 

ИНН*

строка

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

КодФилиала

строка

код филиала

КодСтраны

строка

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

Фамилия

строка

фамилия

Имя

строка

имя

Отчество

строка

отчество

Автор

объект

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

 

Фамилия

строка

фамилия автора

Имя

строка

имя автора

Отчество

строка

отчество автора

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

строка

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

Вложение

массив

сведения о приложенных документах

 

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

строка

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

Название

строка

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

Удален

строка

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

Дата

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

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

Файл

объект

данные файла вложения

 

Имя

строка

имя файла

Ссылка

строка

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

Тип

строка

тип вложения

ВидОтпуска*

строка

Возможные значения: «Корректировка» и «Остатки» для отпусков без учета

Сотрудник*

объект

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

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

 

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

строка

идентификатор конкретной должности сотрудника

ВнешнийИдентификатор

строка

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

Фамилия

строка

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

Имя

строка

имя сотрудника

Отчество

строка

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

ДатаТрудовогоДоговора

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

дата трудового договора

НомерТрудовогоДоговора

строка

номер трудового договора

ТабельныйНомер*

строка

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

ОстаткиНаДату*

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

дата ввода или коррекции остатков

Детализация*

массив

Детализация данных по должностям и рабочим периодам. Для каждой должности добавляется отдельный объект в массив. Один из массивов — «ПоРабочимПериодам» или «ПоРабочимПериодамСРаспределением» — обязателен для заполнения. Если заполнены оба, то значения «ПоРабочимПериодамСРаспределением» учитываться не будут

 

ДолжностьСотрудника

объект

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

  • «ИдентификаторСотрудника». Используется для идентификации сотрудника по конкретной должности. Идентификатор возвращается в параметре extEmployeeId в результате запроса sabyEmployee.ListPositions;
  • «Название» или «Идентификатор» + «ДатаТрудовогоДоговора» + «НомерТрудовогоДоговора»

 

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

строка

идентификатор конкретной должности сотрудника

НомерТрудовогоДоговора

строка

номер трудового договора

ДатаТрудовогоДоговора

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

дата трудового договора

Название**

строка

название должности. Используется для поиска, если не указан идентификатор

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

строка

идентификатор должности

ПоРабочимПериодам

массив

указывает, за какой рабочий период оформляется отпуск

 

ПериодНачало*

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

дата начала рабочего периода

ПериодКонец

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

дата окончания рабочего периода

ОстатокЕжегодного

строка

количество оставшихся дней отпуска на дату конца отпуска. Используется только для «отпусков без учета» и корректировок

ПоложеноЕжегодного

строка

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

ДетализацияДопДней

массив

количество дополнительных дней отпуска, которые положены сотруднику

 

ПричинаПредоставления*

строка

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

ОстатокДопДней

строка

количество оставшихся дополнительных дней отпуска на дату конца отпуска

ПоложеноДнейЗаПериод

строка

максимальное количество дополнительных дней для расчета остатков

ПоРабочимПериодамСРаспределением**

объект

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

 

ПериодНачало*

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

дата начала рабочего периода

ПериодКонец

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

дата окончания рабочего периода

ОстатокДней

строка

количество оставшихся дней отпуска на дату заведения остатков

ПоложеноДней

строка

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

ПричинаПредоставления

строка

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

Комментарий

  1. Все связываемые объекты — «Наша организация», «Сотрудник», «Должность», «Подразделение» — на момент выполнения команды «СБИС.ЗаписатьДокумент» уже должны присутствовать в СБИС.
  2. При изменении документа, запущенного в документооборот, он запускается заново.

Примеры

Пересчет отпуска с учетом использованных и дополнительных дней

Остаток отпускных дней на текущую дату без пересчета

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