Структура документа «Перевод» в API

Описание полей объекта «Документ» с типом «Перевод».

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

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

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

Комментарий

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

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

Пример