Перейти к основному содержимому

Обновить пользователя клиента по внешнему ID

PUT 
/api/v1/clients/:clientId/users/:externalId/externalId

Описание метода​

⚠️ Будьте осторожны!

Методы PUT перезаписывают запись целиком: любые непереданные поля считаются null и затирают данные в БД. Поэтому при обновлении указывайте все поля.

Обновляет данные пользователя клиента (ФИО, документы, телефон, email, внешние IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. и каналы оповещения) по идентификатору пользователя во внешней системе. Используйте параметр changeNqesSigningConfirmationChannelNeeded, если необходимо переназначить канал подтверждения подписания УНЭПУНЭП Усиленная неквалифицированная электронная подпись (CLOUD_NQES). Облачная подпись, обеспечивающая целостность документа..

Валидации запроса​

  • Тело запроса задано.
  • Клиент существует по заданному clientId, не удалён, и к нему относится пользователь, выполняющий операцию.
  • У клиента есть пользователь (активен или отключён) с заданным externalId.
  • У пользователя, выполняющего операцию, есть право CLIENT_USERS_UPDATE на уровне пользователя клиента или на уровне сотрудника.
  • Если список userExternalIds задан — он не содержит null-элементов, типы внешних систем существуют, и каждый внешний IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. либо принадлежит обновляемому пользователю, либо не закреплён ни за кем.
  • В заданном клиенте нет другого пользователя клиента с externalId, переданным в теле запроса.
  • Фамилия (lastName) задана.
  • В персональных документах (personalDocuments) не указаны тип и IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. документа одновременно.
  • Все документы с указанным id относятся к обновляемому человеку.
  • Все номера документов заданы корректно.
  • Сочетания типа и номера документа не пересекаются с документами других людей.
  • В списке документов нет двух документов одного типа.
  • Данные паспорта корректны: код подразделения, код региона, почтовый индекс.
  • В документах задан СНИЛС и паспорт.
  • Адрес регистрации в документах не передан (поле зарезервировано).
  • Версия каждого документа с id совпадает с актуальной версией в БД.
  • Версия данных о человеке (version) актуальна.
  • Если задан phone — он соответствует формату мобильного номера и не занят другим пользователем тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов..
  • Если задан email — он соответствует формату; если новый email отсутствует среди текущих каналов уведомлений пользователя, он не занят в системе.
  • У тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. есть активный пакет лицензий.
  • Если changeNqesSigningConfirmationChannelNeeded=true — смена канала подтверждения подписания УНЭПУНЭП Усиленная неквалифицированная электронная подпись (CLOUD_NQES). Облачная подпись, обеспечивающая целостность документа. допустима для текущего сертификата пользователя.

Request​

Responses​

Успешная операция.