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

Чтобы внести изменения в уже созданный документ, создайте документ формата «Отпуск» с видом «Корректировка».

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

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

Комментарий

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

Примеры

Корректировка отпуска с учетом.

Остатки «без учета».