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

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

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

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

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

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

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

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

Результат

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

Комментарий

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

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

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

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

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

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

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

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

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

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

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

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