СБИС.ЗаписатьСотрудника

Команда «СБИС.ЗаписатьСотрудника» создает карточку сотрудника или обновляет ее, если работник уже зарегистрирован в системе.

Чтобы добавить в карточку сотрудника данные, например о рабочих периодах, используйте вспомогательные методы.

Параметры запроса

Адрес запроса: https://online.sbis.ru/service/?srv=1

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

• "Параметр"*: объект:
  • "Сотрудник"*: объект:
    • "Фамилия": строка
    • "Имя": строка
    • "Отчество": строка
    • "ДатаРождения": строка в формате «ДД.ММ.ГГГГ». В качестве разделителя можно использовать «.» или «-»
    • "МестоРождения": строка, данные места рождения сотрудника по паспорту
    • "ДокументСерия": строка, серия паспорта в формате «ХХ ХХ»
    • "ДокументНомер": строка, номер паспорта в формате «ХХХХХХ»
    • "ДокументКемВыдан": строка, кем выдан паспорт
    • "ДокументДатаВыдачи": строка, дата выдачи паспорта в формате «ДД.ММ.ГГГГ»
    • "ДокументКодПодразделения": строка, код подразделения, в котором выдан паспорт, в формате «ХХХ-ХХХ»
    • "НомерСтраховогоСвидетельства": строка в формате «ХХХ-ХХХ-ХХХ ХХ». В качестве разделителя можно использовать пробел или вводить значение без разделителей: «ХХХХХХХХХХХ»
    • "ИНН": строка, идентификационный номер налогоплательщика
    • "ТипСертификатаНЭП": строка. Возможные значения: «Самоподписанный» или «ЧерезЗаявку»
    • "Сторонний": строка. Возможные значения: «Да» или «Нет». Заполняется один раз при создании карточки сотрудника. Недоступен для изменения
    • "ЛичныеДанные": объект, данные об адресе и семейном положении:
      • "АдресРег": объект, адрес регистрации сотрудника:
        • "Адрес": строка
        • "ФорматироватьПоФИАС": строка. Определяет, надо ли форматировать вводимое значение. Возможные значения «Да» и «Нет», по умолчанию «Нет»
      • "АдресФакт": объект, адрес фактического проживания сотрудника:
        • "Адрес": строка
        • "ФорматироватьПоФИАС": строка. Определяет, надо ли форматировать вводимое значение. Возможные значения «Да» и «Нет», по умолчанию «Нет».
      • "СемейноеПоложение": число, семейное положение сотрудника. Возможные значения
    • "ИностранныеФИО": массив объектов, ФИО сотрудника на иностранном языке или локализованные. Для каждого языка возможен один вариант ФИО. Чтобы удалить локализацию, передайте код языка с пустыми параметрами «Фамилия» и «Имя»
      • "Фамилия": строка, фамилия
      • "Имя": строка, имя
      • "Отчество": строка, отчество
      • "КодЯзыка"*: двухбуквенный код иностранного языка. Возможные значения
    • "ГражданствоКод": строка, код гражданства сотрудника. Указывается по ОКСМ
    • "Фото": строка, фотография сотрудника в формате base64
    • "Пол": строка, пол сотрудника. Возможные значения: «0» — мужской и «1» — женский
    • "ДокументВид": строка, вид документа, предоставленный сотрудником. Возможные значения
    • "ДоступВСистему": строка, возможные значения «Да» или «Нет»
    • "Приложение": строка, URL приложения, в которое надо отправить приглашение. Заполняется, если в параметре «ПриглашениеВСистему» указано «Да»
    • "ОтправитьЗапросДляПодтвержденияПочты": строка, возможные значение «Да» или «Нет». На личную (не корпоративную) почту сотрудника отправляется подтверждение
    • "Логин": строка, логин сотрудника в СБИС
    • "Пароль": строка, пароль сотрудника в СБИС
    • "ТабельныйНомер": строка. Заполняется вместе с параметром «НашаОрганизация» при добавлении сотрудника в конкретную организацию. Если не указать нашу организацию, параметр не запишется
    • "ИдентификаторИС": строка, уникальный идентификатор сотрудника во внешней системе
    • "Идентификатор": строка в виде целого числа. Идентификатор сотрудника в СБИС
    • "РабочееМесто": строка, расположение рабочего места сотрудника
    • "СоглашениеКЭДО": объект. Информация о согласии сотрудника подписывать кадровые документы электронно. Если параметр заполнен, то поле «НашаОрганизация» обязательно для передачи. Если кадровый документ по сотруднику отсутствует в СБИС, то передайте поле «ДатаПриема»
      • "Дата"*: дата в формате «ДД.ММ.ГГГГ», с которой действует соглашение
      • "Файл": строка UUID, идентификатор соглашения
    • "ДатаПриема": строка в формате «ДД.ММ.ГГГГ»
    • "ТипТрудоустройства": строка. Возможные значения: «Основное место работы», «Внешний совместитель», «Внутренний совместитель»
    • "ДатаУвольнения": строка в формате «ДД.ММ.ГГГГ»
    • "ЛимитПодЗП": строка, лимит на оплату под зарплату в месяц
    • "КоличествоОплатВДень": строка, лимит на количество оплат под зарплату в день
    • "СоздатьСертификатНЭП": строка, может содержать значение «Да» или «Нет». Если передано значение «Да», в карточке сотрудника должны быть указаны СНИЛС, ИНН и место трудоустройства. Иначе метод вернет ошибку
    • "ПриглашениеВСистему": строка, может содержать значение «Да» или «Нет»
    • "Email": строка, почтовый ящик для отправки приглашения. Если в параметре «ПриглашениеВСистему» передано «Да», адрес почты сохранится в карточке сотрудника
    • "Телефон": строка, номер телефона для приглашения сотрудника по смс. Если в параметре «ПриглашениеВСистему» передано «Да», номер сохранится в карточке сотрудника
    • "Пропуск": массив объектов:
      • "ТипПропуска"*: строка, тип пропуска. Допустимое значение — «ProximityCard», список будет расширяться
      • "ПодТипПропуска"*: строка, подтип пропуска. Допустимое значение — «Wiegand-26», список будет расширяться
      • "Идентификатор"*: строка, идентификатор пропуска
      • "ДатаНачалаДействия": строка в формате «ДД.ММ.ГГГГ ЧЧ:ММ:СС»
      • "ДатаОкончанияДействия": строка в формате «ДД.ММ.ГГГГ ЧЧ:ММ:СС»
      • "Описание": строка
      • "Удалить": строка «Да»/«Нет»
  • "Должность": объект:
    • "Название": строка
    • "Идентификатор ": строка, внешний идентификатор должности
  • "НашаОрганизация": объект. Обязательно для заполнения, если передан непустой параметр «СоглашениеКЭДО»
    • "СвЮЛ": объект:
      • "ИНН": строка. Для юридических лиц номер состоит из 10 символов, для индивидуальных предпринимателей и физических лиц — из 12. Для иностранных организаций номер определяется требованиями законодательства их стран
      • "КПП": строка
      • "КодФилиала": строка, код филиала
    • "СвФЛ": объект:
      • "ИНН": строка
  • "Подразделение": объект:
    • "Идентификатор": строка, код подразделения
  • "Права": объект:
    • "Роль": массив объектов:
      • "Название": строка
    • "Ограничение": объект:
      • "ПоПодразделениямИСотрудникам": объект:
        • "БезОграничений": строка «Да»/«Нет»
        • "ПоСвоим": строка. Возможные значения: «СвойОфис», «СвоеПодразделение», «ПоСебе»
        • "Подразделения": массив объектов:
          • "Идентификатор": строка
          • "Код": строка
          • "Структура": строка
        • "Сотрудники": массив объектов:
          • "Идентификатор": строка, идентификатор сотрудника в СБИС
          • "ИдентификаторИС": строка, идентификатор сотрудника во внешней системе
        • "Кроме": объект:
          • "Сотрудники": массив объектов
            • "Идентификатор": строка, идентификатор сотрудника в СБИС
            • "ИдентификаторИС": строка, идентификатор сотрудника во внешней системе
          • "Подразделения": массив объектов
            • "Идентификатор": строка, идентификатор подразделения
            • "Код": строка
            • "Структура": строка
      • "ПоОрганизациям": объект:
        • "БезОграничений": строка «Да»/«Нет»
        • "НашаОрганизация": массив:
          • "СвЮЛ": объект:
            • "ИНН": строка
            • "КПП": строка
          • "СвФЛ": объект:
            • "ИНН": строка
      • "ПоСкладу": список объектов:
        • "Идентификатор": строка UUID, значение берется из sabyWarehouse.Read

Результат

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

Комментарий

• Для идентификации сотрудника в СБИС используются поля «Идентификатор» и «ИдентификаторИС»:
  • «Идентификатор» — уникальный номер карточки сотрудника в СБИС. Присваивается автоматически при создании.
  • «ИдентификаторИС» — уникальный номер сотрудника в сторонней системе. Назначается вручную в карточке или передается как параметр команды «СБИС.ЗаписатьСотрудника».

  В первую очередь сотрудник определяется по значению поля «Идентификатор».

• Чтобы добавить нового сотрудника, обязательно заполните поля «Фамилия» и «Имя».
• Чтобы предоставить сотруднику доступ в систему, в запросе укажите «ДоступВСистему»=«Да», «Логин» и «Пароль».
• Если нужно изменить доступ сотрудника в систему, передайте в запросе параметр «ДоступВСистему». Дополнительно передайте идентификатор карточки сотрудника в поле «Идентификатор». Его можно взять из ответа, который прислал сервер при создании карточки сотрудника.
• Значение поля «ДатаУвольнения» будет записано в карточке сотрудника СБИС, только если в запросе передан параметр «НашаОрганизация».
• Если в запросе указано значение параметра, которого нет в СБИС, команда вернет ошибку.
• Поиск подразделения зависит от параметра «НашаОрганизация». Если значение указано, подразделения ищутся по юридической структуре, иначе — по управленческой.

Примеры запроса

Создать запись сотрудника

Создать запись сотрудника — администратора системы

Удалить пропуск

Указать срок действия пропуска

Запрос с некорректным идентификатором

Примеры ответа

Ответ на корректный запрос

Ответ с ошибкой, если пользователь с таким логином уже существует