Структура документа «Отпуск» в API

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

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

Синий — только для чтения

• "Документ": объект:
  • "Идентификатор"*: строка, используется для адресации документа
  • "Номер": строка. Если номер документа не указан, он сгенерируется автоматически
  • "Дата": строка в формате «ДД.ММ.ГГГГ». Если дата документа не указана, подставляется текущая дата
  • "Редакция": объект, редакция документа:
    • "Идентификатор": строка, идентификатор редакции, в которую вносятся изменения. Если параметр не указан, работа идет с текущей редакцией документа
    • "ПримечаниеИС": строка, текстовое примечание для изменяемой редакции
  • "Тип"*: строка, тип документа. Принимает значение «Отпуск»
  • "Регламент": объект, регламент документооборота. Чтобы привязать регламент, заполните одно из полей — «Название» или «Идентификатор»:
    • "Идентификатор": строка, идентификатор регламента документооборота в СБИС. Чтобы вычислить, создайте документ в интерфейсе СБИС и вызовите для него «СБИС.ПрочитатьДокумент». В результирующем объекте будет идентификатор
    • "Название": строка, название регламента документооборота в СБИС. Если передан идентификатор, название не учитывается
  • "НашаОрганизация"*: объект. Указывает, по какой из наших компаний формируется отпуск. В зависимости от формы организации заполняется только один из информационных блоков:
    • "СвЮЛ": объект, сведения о юридическом лице:
      • "ИНН"*: строка, для юридических лиц номер состоит из 10 символов, для индивидуальных предпринимателей и физических лиц — из 12. Для иностранных организаций номер определяется требованиями законодательства их стран
      • "КПП"*: строка, 9 символов
      • "КодФилиала": строка
      • "КодСтраны": строка, код страны в формате ISO 3166-1 Numeric
      • "Название": строка, название организации
    • "СвФЛ": объект, сведения о физическом лице:
      • "ИНН"*: строка, 12 символов
      • "КодФилиала": строка
      • "КодСтраны": строка, код страны в формате ISO 3166-1 Numeric
      • "Фамилия": строка
      • "Имя": строка
      • "Отчество": строка
  • "Автор": объект, сотрудник — автор документа. Если задан идентификатор, сотрудник ищется по нему, иначе по ФИО:
    • "Фамилия": строка
    • "Имя": строка
    • "Отчество": строка
    • "Идентификатор": строка, идентификатор сотрудника во внешней системе
  • "Вложение": массив объектов:
    • "Идентификатор": строка, используется для адресации вложения
    • "Название": строка, название вложения
    • "Удален": строка, признак удаления вложения. Возможные значения «Да» и «Нет»
    • "Дата": строка в формате «ДД.ММ.ГГГГ», дата загрузки
    • "Файл": объект:
      • "Имя": строка, имя файла
      • "Ссылка": строка, ссылка на объект в файловом хранилище
    • "Тип": строка, тип документа
  • "СУчетом": строка, возможные значения «Да» или «Нет»
  • "ПоПлану": строка, возможные значения «Да» или «Нет»
  • "Сумма": строка, сумма отпускных. Только для отпуска с учетом и оплачиваемых отпусков
  • "МесяцРасчета": строка в формате «ДД.ММ.ГГГГ», где ДД - любое число нужного месяца
  • "ВидОтпуска"*: строка. Возможные значения
  • "ДатаСобытия"**: строка в формате «ДД.ММ.ГГГГ». Дата события, для которого создается отпуск. Например, дата рождения ребенка. Заполняется, если в параметре «ВидОтпуска» передано название отпуска по коллективному договору и в документе отпуска указана дата в поле «событие»
  • "Сотрудник"*: объект, данные для поиска сотрудника, для которого оформляется отпуск
    • По каким параметрам определяется сотрудник?
    • "ВнешнийИдентификатор": строка, идентификатор частного лица во внешней системе. Поле «ИдентификаторИС» метода СБИС.ЗаписатьСотрудника
    • "Фамилия": строка, фамилия сотрудника
    • "Имя": строка, имя
    • "Отчество": строка, отчество
    • "ТабельныйНомер": строка, табельный номер
    • "НомерТрудовогоДоговора": строка, номер трудового договора
    • "ДатаТрудовогоДоговора": строка в формате «ДД.ММ.ГГГГ», дата трудового договора
    • "ИдентификаторСотрудника": строка, идентификатор трудового договора
  • "Интервал"*: объект, описание интервала отпуска:
    • "ДатаНачала": строка в формате «ДД.ММ.ГГГГ», дата начала отпуска
    • "ДатаКонца": строка в формате «ДД.ММ.ГГГГ», дата окончания отпуска
    • "Дни": строка, количество дней отпуска
  • "ПричинаОтзыва": строка, причина отзыва из отпуска. Возможные значения
  • "РасшифровкаПричины": текст, комментарий к коду причины отзыва или государственным обязанностям
  • "ИдДокументаОснования": строка в формате UUID. Для отзыва из отпуска передается идентификатор отпуска
  • "Оплачиваемый": строка, признак необходимости оплаты. Возможные значения «Да» или «Нет». Используется для отпуска по гособязанностям и учебного. Значение по умолчанию — «Да»
  • "Детализация": массив объектов. Детализация данных по должностям и рабочим периодам:
    • "Интервал": объект, интервал отпуска по должности:
      • "ДатаНачала": строка в формате «ДД.ММ.ГГГГ», дата начала отпуска
      • "ДатаКонца": строка в формате «ДД.ММ.ГГГГ», дата окончания отпуска
      • "Дни": строка, количество дней
    • "ДолжностьСотрудника": объект, указывает, по какой должности оформляется отпуск:
      • "Идентификатор": строка в формате UUID, идентификатор должности
      • "Название": строка, название должности. Используется для поиска, если не указан идентификатор
      • "ДатаТрудовогоДоговора": строка в формате «ДД.ММ.ГГГГ», дата трудового договора
      • "НомерТрудовогоДоговора": строка, номер трудового договора
      • "ИдентификаторСотрудника": строка, идентификатор трудового договора
    • "ТипПредоставления": строка, способ предоставления отпуска для ежегодного по нескольким должностям или отпуска по гособязанностям. Для основной должности значение параметра всегда будет «Оплатить». Возможные значения
    • "СпособРасчета": строка. Возможные значения
    • "ПоРабочимПериодамNew": массив объектов, детализация отпуска по периодам:
      • "ПериодНачало": строка в формате «ДД.ММ.ГГГГ», дата начала рабочего периода
      • "ПериодКонец": строка в формате «ДД.ММ.ГГГГ», дата окончания рабочего периода
      • "Расшифровка": объект, информация по интервалу:
        • "ДатаНачала": строка в формате «ДД.ММ.ГГГГ», дата начала отпуска в периоде
        • "ДатаКонца": строка в формате «ДД.ММ.ГГГГ», дата окончания отпуска в периоде
        • "Дни": количество дней отпуска, использованных в этом периоде
      • "ОсновныеДни": строка, количество дней основного отпуска
      • "ДетализацияДопДней": массив объектов, детализация интервала по дополнительным отпускам
        • "ПричинаПредоставления": строка. Возможные значения
        • "ДопДни": строка, количество дней дополнительного отпуска
        • "ДатаНачала": строка в формате «ДД.ММ.ГГГГ», дата начала дополнительного отпуска
        • "ДатаКонца": строка в формате «ДД.ММ.ГГГГ», дата окончания дополнительного отпуска
    • "Расчеты": массив объектов, детализация по расшифровкам
      • "ДатаНачала": строка в формате «ДД.ММ.ГГГГ», дата начала расшифровки
      • "ДатаКонца": строка в формате «ДД.ММ.ГГГГ», дата окончания расшифровки
      • "Сумма": строка, сумма отпускных за период

Комментарий

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

Примеры

Отпуск с видом «Дни отдыха донора», «Доп. выходные по уходу за детьми-инвалидами», «За свой счет», «Учебный», «Диспансеризация», «Доп. отпуск ЧАЭС»

Компенсация за отпуск

Ежегодный отпуск без детализации

Ежегодный отпуск с детализацией по должностям

Отпуск в связи с гособязанностями и учебный

Отпуск по коллективному договору

Отзыв из отпуска с причинами «Иное», «Производственная необходимость», «Государственная обязанность». Без продления

Отзыв из отпуска по причине «Отмена отпуска». Без продления

Отзыв из отпуска по причине «Заболевание». Без продления

Отзыв из отпуска по причине «Заболевание». С продлением

Отмена отпуска по одной из должностей

Отпуск по мобилизации