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

Получить сотрудника по внешнему ID

GET 
/api/v1/clients/:clientId/employees/:employeeExternalId/externalId

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

Возвращает расширенные данные о сотрудниках пользователя по внешнему IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. одного из сотрудников пользователя.

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

  • Клиент существует, не удалён, и к нему относится пользователь, выполняющий операцию.
  • IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. сотрудника во внешней системе задан.
  • В клиенте существует сотрудник по IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе.
  • Если запрашиваемый сотрудник не является руководителем, то текущему пользователю доступен отдел запрашиваемого сотрудника.
  • Если текущий пользователь запрашивает данные не собственного сотрудника, то он должен иметь право EMPLOYEESEmployee Связь пользователя пространства клиента с юрлицом — пара (clientUserId, legalEntityId). Один пользователь может иметь несколько записей Employee в разных юрлицах или даже в одном. на уровне пользователя клиента или право EMPLOYEESEmployee Связь пользователя пространства клиента с юрлицом — пара (clientUserId, legalEntityId). Один пользователь может иметь несколько записей Employee в разных юрлицах или даже в одном. в юрлице сотрудника.
  • IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID.
  • По заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента существует клиент.
  • Пользователь, выполняющий операцию, относится к клиенту.
  • Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. сотрудника во внешней системе задан.
  • Проверяет, что сотрудник по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе существует и возвращает его, если он существует.
  • Если юрлицо указано, то существование сотрудника проверяется в заданном юрлице.
  • Если юрлицо не указано, то существование сотрудника проверяется в клиенте с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..
  • Проверяет наличие у пользователя клиента доступа к отделу сотрудника учитывая замещенияSubstitution Замещение — временная передача прав одного пользователя другому (например, на время отпуска). Настраивается для конкретных контекстов: документы, заявления, сотрудники, ЛНА..
  • Проверяет, что текущий пользователь относится к заданному клиенту и возвращает пользователя клиента, если он существует.
  • Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента, заданный в виде строки, соответствует формату, и возвращает типизированный IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента.
  • Проверяет существование клиента по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и возвращает клиента, если он существует.
  • Проверяет, что клиент не удален.
  • Проверяет наличие у пользователя клиента доступа к отделу сотрудника.

Request​

Responses​

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