Присоединяйтесь!

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

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

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

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

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

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

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

Результат

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

Комментарий

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

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

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

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

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

Запрос с паспортными данными и ИНН

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

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

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

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

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

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

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

Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.