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

Структура документа «Корректирующий табель» в API

Структура документа «Корректирующий табель» в API

Чтобы внести изменения в закрытый табель, например указать, что сотрудник был на больничном, создайте документ с типом «Корректирующий табель».

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

Тип

Описание

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

строка

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

Тип*

строка

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

ДокументОснование

массив

данные документа-основания для корректировки во внешней системе

 

Документ

объект

документ-основание

 

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

строка

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

Номер

строка

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

Дата*

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

последний день месяца

Редакция

объект

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

 

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

строка

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

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

строка

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

Ответственный*

массив

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

 

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

строка

идентификатор табельщика во внешней системе. Обязателен, если не указаны «ФИО»

Фамилия**

строка

ФИО табельщика, который создает документ. Обязательны, если не указан «Идентификатор»

Имя**

строка

Отчество**

строка

Регламент

объект

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

 

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

строка

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

Название

строка

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

Вложение

массив

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

 

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

строка

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

Название

строка

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

Удален

строка

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

Дата

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

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

Файл

объект

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

 

Имя

строка

имя файла

Ссылка

строка

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

Тип

строка

тип вложения

Табели

массив

табели, которые необходимо закрепить за документом

 

Сотрудник*

объект

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

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

 

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

строка

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

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

строка

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

Фамилия

строка

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

Имя

строка

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

Отчество

строка

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

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

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

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

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

строка

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

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

строка

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

ДанныеТабеля*

массив

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

 

День*

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

дата в табеле. Дни меток должны быть в пределах периода по документу

Метки*

массив

метки за день. Метки за один день должны быть уникальны

 

Название*

строка

буквенное обозначение метки, например «НРВ» или «Б»

Время

строка

минуты по метке. Если указано «0» или «NULL», метка будет проставлена на день. Время метки не может превышать 24 часа

ДанныеДляНачислений

массив

данные для начислений

 

КодВидаНУ

строка

код для начислений и удержаний

КорСчет

строка

номер счета затрат

Дни

строка

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

Часы

строка

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

Комментарий

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

Чтобы внести изменения в «Корректирующий табель», создайте еще один табель с корректировками.

Пример

Создать документ

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