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

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

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

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

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

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

Комментарий

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

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

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

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

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

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

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

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

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

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

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