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