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

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

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

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

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

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

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

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

Результат

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

Комментарий

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

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

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

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

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

{
   "jsonrpc": "2.0",
   "method": "СБИС.ЗаписатьСотрудника",
   "params": {
      "Параметр": {
         "Сотрудник": {
            "Фамилия": "Иванов",
            "Имя": "Иван",
            "Отчество": "Александрович",
            "ДоступВСистему": "Да",
            "Логин": "ИвановЛогин1",
            "Пароль": "ИвановПароль1",
            "ИдентификаторИС": "ИвановИван1"
         },
         "Права": {
            "Роль": [
               {
                  "Название": "Менеджер"
               }
            ]
         },
         "Должность": {
            "Название": "Менеджер"
         }
      }
   },
   "id": 1
}
Скачать пример

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

{
  "jsonrpc": "2.0",
  "method": "СБИС.ЗаписатьСотрудника",
  "params": {
    "Параметр": {
      "Сотрудник": {
        "Фамилия": "Иванов",
        "Имя": "Алексей",
        "Отчество": "Алексеевич",
        "ДатаРождения": "01.09.1990",
        "НомерСтраховогоСвидетельства": "25764820302",
        "ТабельныйНомер": "3536",
        "ИдентификаторИС": "9999",
        "Идентификатор": "25709478",
        "ДатаПриема": "11.04.2022",
        "ДокументВид": "10",
        "ДокументСерия": "71 13",
        "ДокументНомер": "981134",
        "ДокументДатаВыдачи": "31.12.2011",
        "ДокументКемВыдан": "ОУФМС",
        "ДокументКодПодразделения": "760-007",
        "ИНН": "034439210770",
        "ГражданствоКод": "007"
      },
      "НашаОрганизация": {
        "СвЮЛ": {
          "ИНН": "7830683405",
          "КПП": "096844166"
        }
      }
    }
  },
  "id": 1
}
Скачать пример

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

{
   "jsonrpc": "2.0",
   "method": "СБИС.ЗаписатьСотрудника",
   "params": {
      "Параметр": {
         "Сотрудник": {
            "Фамилия": "Александров",
            "Имя": "Сергей",
            "Отчество": "Георгиевич",
            "ДоступВСистему": "Да",
            "Логин": "Александров45",
            "Пароль": "Александров12345"
         },
         "Права": {
            "Роль": [
               {
                  "Название": "Администратор системы"
               }
            ]
         }
      }
   },
   "id": 1
}
Скачать пример

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

{
   "ТипПропуска": "ProximityCard",
   "ПодТипПропуска": "Wiegand-26",
   "Идентификатор": "04000000295F2901",
   "ДатаНачалаДействия": "None",
   "ДатаОкончанияДействия": "None",
   "Описание": "Нечто 11",
   "Удалить": "Да"
}
Скачать пример

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

{
   "ТипПропуска": "ProximityCard",
   "ПодТипПропуска": "Wiegand-26",
   "Идентификатор": "600000006DD50401",
   "ДатаНачалаДействия": "26.09.2017 18:16:50+03",
   "ДатаОкончанияДействия": "01.01.2100 23:59:59+03",
   "Описание": "Нечто 2",
   "Удалить": "Нет"
}
Скачать пример

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

{
   "ТипПропуска": "ProximityCard",
   "ПодТипПропуска": "Wiegand-26",
   "Идентификатор": "04000error000295F2901",
   "ДатаНачалаДействия": "2017-08-30 16:57:44.983236+03",
   "ДатаОкончанияДействия": "None",
   "Описание": "Нечто 1",
   "Удалить": "Нет"
}
Скачать пример

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

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

{
"jsonrpc": "2.0",
"result": {
        "Права": {...},
        "Сертификаты": [ ],
        "Сотрудник": {
                "ВнешнийИдентификатор": "",
                "ДатаБлокировки": "",
                "ДатаПриема": "01.06.2020",
                "ДатаРождения": "08.08.1988",
                "ДатаУвольнения": "",
                "ДокументДатаВыдачи": "31.12.2011",
                "ДокументКемВыдан": "ОУФМС",
                "ДокументКодПодразделения": "760-007",
                "ДокументНомер": "981134",
                "ДокументСерия": "71 13",
                "Должность": {...},
                "ДоступВСистему": "Да",
                "ИНН": "034439210770",
                "Идентификатор": "25709478",
                "ИдентификаторИС": "",
                "Имя": "Алексей",
                "КоличествоОплатВДень": null,
                "ЛимитПодЗП": 9000,
                "Логин": "",
                "НомерСтраховогоСвидетельства": "756-666-623 58",
                "Отчество": "Алексеевич",
                "Подразделение": {...},
                "ПоследняяАктивность": "",
                "Принят": "01.06.2020",
                "Пропуск": null,
                "ТабельныйНомер": "ММIS-00014",
                "Уволен": "",
                "Фамилия": "Алексеев"
        }
}
}
Скачать пример

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

{
   "jsonrpc": "2.0",
   "error": {
      "code": "-32000",
      "message": "Ошибка при записи данных по пользователю:Пользователь с логином \"Александров45\" уже существует! Попробуйте ввести другой логин.",
      "details": "Ошибка при вызове метода \"Пользователь.SafeWriteUser\" с сервиса \"admin-api\": Ошибка в обработчике \"ОбработчикНаПередЗаписатьПользователя\": Пользователь с логином \"Александров45\" уже существует! Попробуйте ввести другой логин.",
      "type": "warning",
      "data": {
         "classid": "{00000000-0000-0000-0000-1fa000001000}",
         "error_code": -1,
         "addinfo": null
      }
   },
   "id": 1
}
Скачать пример
Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.