Присоединяйтесь!
  1. Saby
  2. База знаний
  3. API
  4. API Управление персоналом
  5. Кадровые документы
  6. Табель

Структура документа «Табель» в API

Структура документа «Табель» в API

Описание полей объекта «Документ» с типом «Табель».

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

Тип

Описание

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

строка

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

Номер

строка

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

Дата*

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

укажите последнее число месяца, за который передаются данные

Редакция

объект

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

 

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

строка

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

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

строка

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

Тип*

строка

тип документа. Принимает значение «ТабельДокумент»

Регламент*

объект

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

 

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

строка

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

Название

строка

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

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

объект

указывает, по какой из ваших компаний оформляется табель. В зависимости от формы организации заполняется только один из информационных блоков.
Обязателен, если не указан параметр «Подразделение»

 

СвЮЛ

объект

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

 

ИНН*

строка

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

КПП*

строка

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

СвФЛ

объект

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

 

ИНН*

строка

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

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

объект

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

 

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

строка

код подразделения. Если подразделение принадлежит к юридической структуре, передачи одного этого поля достаточно для его идентификации. Иначе передайте параметр «Структура»

Название

строка

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

Структура**

строка

структура подразделения. Возможные значения: «Юридическая», «Управленческая», «Активная», «Совмещенная». Если указана «Совмещенная», поиск производится сначала по юридической, затем по управленческой структуре. Если значение не передано, используется управленческая структура

Вложение

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

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

 

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

строка

используется для адресации вложения

Название

строка

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

Удален

строка

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

Дата

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

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

Файл

объект

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

 

Имя

строка

имя файла

Ссылка

строка

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

Тип

строка

тип вложения

Табели

массив

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

 

Помечен

строка

признак фиксации табеля. Возможные значения: «Да» или «Нет»

Сотрудник*

объект

информация о сотруднике. Он должен быть трудоустроен в дни, в которые записываются метки. Сотрудник должен относится к тому же подразделению, что и табель. Есть несколько методов идентификации сотрудника

 

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

строка

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

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

строка

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

Фамилия

строка

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

Имя

строка

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

Отчество

строка

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

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

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

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

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

строка

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

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

строка

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

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

массив

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

 

День*

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

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

Метки*

массив

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

 

Название*

строка

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

Время*

строка

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

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

массив

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

 

КодВидаНУ

строка

код оплаты

КорСчет

строка

счет

Дни

строка

дни по данному коду

Часы

строка

часы по данному коду

Комментарий

  1. Табель можно создать для подразделения только при одновременном выполнении условий:
  2. Табели, в которые пишутся данные, должны быть открыты для изменений (не закрыты, не помечены, не рассчитаны).
  3. Справочники меток Saby и сторонней системы должны быть синхронизированы. Нельзя загружать данные по меткам, которых нет в одной из систем.

Примеры

Создать табель

Прочитать документ

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