Сэрва Перемещенный сотрудник (предварительная версия)

Подключитесь к платформе портала портала сотрудника Sirva Relocation, чтобы получить сведения о прошлых и нынешних перемещениях. Для этого соединителя требуется активная учетная запись с перемещением сэрва для нашего портала сотрудников (https://ee.sirva.com).

Этот соединитель предоставляет доступ к перемещаемой информации и позволяет получать контактные данные и доступность личного консультанта. Вы также можете получить пакет пособий и связанные с ними пособия для проверки и задать вопросы о политике.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate за исключением следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     - Azure Government регионы
     - Azure регионы Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate за исключением следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Поддержка перемещений сэрва
URL https://support.sirva.com
Адрес электронной почты sirvacsc@sirva.com
Метаданные соединителя
Publisher Перемещение сэрвы
Website https://www.sirva.com
Политика конфиденциальности https://www.sirva.com/support/privacy-policy
Категории Продуктивность

Соединитель для перемещений сотрудников сэрва

Sirva Connect+ Transferee предоставляет соединитель, который позволяет получить информацию о текущем, прошлом и настоящем перемещении с сэрва.

Предпосылки

Для продолжения вам потребуется следующее:

  • Активная учетная запись с перемещением сэрва

Если у вас есть доступ к платформе, вы получите сообщение электронной почты с учетными данными для входа из Sirva.

Чтобы Microsoft Entra проверка подлинности для работы клиента должна быть сопоставлена с организацией, а регистрация приложения должна быть правильно настроена для доступа к API. Обратитесь в службу поддержки Сэрва (https://support.sirva.com), чтобы начать процесс.

Издатель: Сэрва Перемещение

Поддерживаемые операции

Соединитель поддерживает следующие операции:

  • Get Relocations: список перемещений, к которых у вас есть доступ
  • Get Relocation Package: извлекает пакет преимуществ для определенного перемещения
  • Get Counselor Contact Information: извлекает контактные данные консультанта для перемещения, включая URL-адреса для книги собраний
  • Ask the Sirva bot a question about a topic: задает боту Sirva вопрос о вашем шаге

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

Microsoft Entra регистрация приложения Вход с помощью пользовательской регистрации приложения Microsoft Entra Все регионы Недоступен для совместного использования
Учетная запись сэрва Вход с помощью проверки подлинности Sirva Все регионы Недоступен для совместного использования
По умолчанию [не рекомендуется] Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости. Все регионы Недоступен для совместного использования

регистрация приложений Microsoft Entra

Идентификатор проверки подлинности: aad-auth

Применимо: все регионы

Вход с помощью пользовательской регистрации приложения Microsoft Entra

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя Тип Description Обязательно
Идентификатор клиента струна Идентификатор приложения (клиента) из регистрации приложения с идентификатором записи True
Секрет клиента securestring Секрет клиента из регистрации приложения идентификатора записи True

Учетная запись сэрва

Идентификатор проверки подлинности: custom-app-auth

Применимо: все регионы

Вход с помощью проверки подлинности Sirva

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

По умолчанию [не рекомендуется]

Применимо: все регионы

Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Задайте боту Сэрва вопрос о теме

Отправляет текст вопроса боту ответа Sirva о выбранной теме и возвращает ответ.

Повторное использование пакета преимуществ, связанного с перемещением

Получение пакета пособий, сопоставленного с определенным перемещением, включая потенциальные пособия

Получение контактных данных консультанта

Возвращает консультанта, назначенного определенному перемещению, и их контактные данные.

Получение списка перемещения, связанных с пользователем, вошедшего в систему

Получение списка перемещения, связанных с пользователем, вошедшего в систему, включая прошлые и нынешние перемещения.

Задайте боту Сэрва вопрос о теме

Отправляет текст вопроса боту ответа Sirva о выбранной теме и возвращает ответ.

Параметры

Имя Ключ Обязательно Тип Описание
RelocationId
RelocationId True string

Уникальный идентификатор перемещения.

Вопрос для запроса бота
Query True string

Вопрос для запроса бота

Тема, о чем идет речь
Topic True string

Тема, о чем идет речь

Возвращаемое значение

Имя Путь Тип Описание
ответ
answer string

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

Повторное использование пакета преимуществ, связанного с перемещением

Получение пакета пособий, сопоставленного с определенным перемещением, включая потенциальные пособия

Параметры

Имя Ключ Обязательно Тип Описание
Уникальный идентификатор перемещений
RelocationId True string

Уникальный идентификатор перемещения для извлечения пакета

Возвращаемое значение

Имя Путь Тип Описание
запущен
isStarted boolean

Указывает, был ли подготовлен пакет.

isComplete
isComplete boolean

Указывает, был ли завершен пакет.

isAccepted
isAccepted boolean

Указывает, был ли принят пакет.

readyForNeedsAnalysis
readyForNeedsAnalysis boolean

Указывает, готов ли пакет к выполнению задачи анализа потребностей.

Пособия
allowances array of object

Массив доступных и выбранных пособий, на которые имеет право перемещенный сотрудник.

UUID (Универсальный уникальный идентификатор)
allowances.uuid string

Уникальный идентификатор пособия.

имя
allowances.name string

Сведения о том, за что это пособие.

amountIdentifiedAtConsultation
allowances.amountIdentifiedAtConsultation boolean

Указывает, определяется ли сумма пособия cousnselor во время первоначального вызова пособия.

allowances.amount float

Сумма пособия, если она определена.

currency
allowances.currency string

ISO-код валюты, в которую должна быть выплачена льгота.

currencyId
allowances.currencyId string

Внутренний идентификатор валюты.

тип категории
allowances.categoryType string

Категория, с которым связано пособие.

categoryTypeId
allowances.categoryTypeId string

Внутренний идентификатор категории.

occurrenceType
allowances.occurrenceType string

Частота оплаты пособия.

occurrenceTypeId
allowances.occurrenceTypeId string

Внутренний идентификатор частоты.

paidByType
allowances.paidByType string

Организация, оплачивающая пособие на перемещенного сотрудника.

paidByTypeId
allowances.paidByTypeId string

Внутренний идентификатор платного по типу.

isSelected
allowances.isSelected boolean

Указывает, включена ли пособие в пакет пособий.

userId
allowances.paymentRequest.requestedBy.userId string

Идентификатор пользователя, связанный с запросом на оплату.

электронная почта
allowances.paymentRequest.requestedBy.email string

Адрес электронной почты пользователя, запрашивающего оплату.

первый
allowances.paymentRequest.requestedBy.first string

Имя пользователя, запрашивающего оплату.

последний
allowances.paymentRequest.requestedBy.last string

Фамилия пользователя, запрашивающего оплату.

запрошенныйDate
allowances.paymentRequest.requestedDate string

Дата, запрошенная для оплаты пособия.

денежный перевод
allowances.paymentRequest.remittanceMethod string

Метод денежных переводов для оплаты пособия.

денежный перевод
allowances.paymentRequest.remittanceAccount string

Банковский счет для оплаты.

services
services array of object

Список служб с преимуществами и компонентами, доступными для перемещенного сотрудника.

isInPackage
services.isInPackage boolean

Указывает, включена ли служба в пакет. Если служба не включена, пользователь может запросить его, но он не может быть охвачен организацией, предоставляющей перемещение.

UUID (Универсальный уникальный идентификатор)
services.uuid string

Уникальный идентификатор службы.

имя
services.name string

Имя службы.

тип категории
services.categoryType string

Категория, поданая служба.

categoryTypeId
services.categoryTypeId string

Уникальный идентификатор типа категории.

краткое описание
services.shortDescription string

Краткое описание преимуществ, предоставляемых службой.

длинноеОписание
services.longDescription string

Более подробное описание преимуществ, предоставляемых службой.

providerType
services.providerType string

Поставщик службы.

providerTypeId
services.providerTypeId string

Уникальный идентификатор поставщика.

ядро
services.core boolean

Указывает, считается ли эта служба основной или необязательной.

cashOutOption
services.cashOutOption boolean

Указывает, поддерживает ли служба обмен выгодой на денежные суммы.

cashOutPercentage
services.cashOutPercentage integer

Определяет процент предполагаемой стоимости службы, полученной при обналичии.

outOfPocket
services.outOfPocket boolean

Указывает, оплачивается ли служба из кармана перемещенным сотрудником.

последовательность
services.sequence integer

Последовательность сортировки, которая помещает службы в более логический порядок на основе начала.

iconUrl
services.iconUrl string

URL-адрес cdN Sirva для значка, представляющего службу.

isIncluded
services.isIncluded boolean

Указывает, включена ли служба в пакет.

masterServiceId
services.masterServiceId string

Сверточный идентификатор, который связывает варианты служб вместе с одним родительским элементом.

isTravelService
services.isTravelService boolean

Указывает, является ли это туристической службой.

useRemittance
services.useRemittance boolean

Указывает, следует ли использовать учетную запись денежных переводов по умолчанию.

cashOutAmount
services.cashOutAmount float

Определяет неструктурированное значение службы, если процент не определен.

Преимущества
services.benefits array of object

Список преимуществ, связанных с этой службой.

UUID (Универсальный уникальный идентификатор)
services.benefits.uuid string

Уникальный идентификатор преимущества.

имя
services.benefits.name string

Имя преимущества.

outOfPocket
services.benefits.outOfPocket boolean

Если льготы оплачиваются из кармана перемещенным сотрудником.

cashoutOption
services.benefits.cashoutOption boolean

Если преимущество поддерживает вариант наличных средств.

cashoutPercentage
services.benefits.cashoutPercentage integer

Определяет процент предполагаемой стоимости льготы, полученной при наличии денежных средств.

cashoutAmount
services.benefits.cashoutAmount float

Определяет плоскую сумму наличных средств для льготы, если процент недоступен.

isIncluded
services.benefits.isIncluded boolean

Определяет, входит ли преимущество в пакет.

amountOptions
services.benefits.amountOptions array of object

Список различных вариантов затрат для преимущества с различными конфигурациями и значениями.

UUID (Универсальный уникальный идентификатор)
services.benefits.amountOptions.uuid string

Уникальный идентификатор параметра затрат для преимущества.

unitType
services.benefits.amountOptions.unitType string

Единица измерения.

unitTypeId
services.benefits.amountOptions.unitTypeId string

Уникальный идентификатор единицы измерения.

condition
services.benefits.amountOptions.condition string

Определяет все условия использования этого параметра.

conditionId
services.benefits.amountOptions.conditionId string

Уникальный идентификатор условия.

количество
services.benefits.amountOptions.quantity float

Общая сумма, предоставленная параметром.

стоимость
services.benefits.amountOptions.cost float

Стоимость этого варианта.

actualCashOut
services.benefits.amountOptions.actualCashOut float

Фактическое денежное значение этого параметра.

рекомендуемый
services.benefits.amountOptions.recommended boolean

Указывает, что этот конкретный параметр рекомендуется сэрва.

isSelected
services.benefits.amountOptions.isSelected boolean

Указывает, является ли этот параметр выбранным или нет.

дата создания
services.benefits.amountOptions.createdDate string

Дата создания параметра.

Комментарий
services.benefits.amountOptions.comment string

Дополнительные комментарии о параметре.

components
services.benefits.components array of object

Список компонентов, связанных с этим элементом.

UUID (Универсальный уникальный идентификатор)
services.benefits.components.uuid string

Уникальный идентификатор компонента.

имя
services.benefits.components.name string

Имя компонента.

componentType
services.benefits.components.componentType string

Тип компонента.

componentTypeId
services.benefits.components.componentTypeId string

Уникальный идентификатор компонента.

options
services.benefits.components.options array of object

Параметры, связанные с компонентом.

UUID (Универсальный уникальный идентификатор)
services.benefits.components.options.uuid string

Уникальный идентификатор компонента.

value
services.benefits.components.options.value string

Элемент, связанный с компонентом.

рекомендуемый
services.benefits.components.options.recommended boolean

Если компонент рекомендуется сэрва

последовательность
services.benefits.components.options.sequence integer

Последовательность сортировки компонентов.

тип запроса
services.serviceRequest.requestType string

Тип запроса.

запрошенныйDate
services.serviceRequest.requestedDate string

Дата создания запроса.

userId
services.serviceRequest.requestedBy.userId string

Идентификатор пользователя, выполняющего запрос.

электронная почта
services.serviceRequest.requestedBy.email string

Адрес электронной почты пользователя, выполняющего запрос.

первый
services.serviceRequest.requestedBy.first string

Имя пользователя, выполняющего запрос.

последний
services.serviceRequest.requestedBy.last string

Последнее неугодный пользователь, выполняя запрос.

servicesAvailable
servicesAvailable array of

Список доступных служб.

UUID (Универсальный уникальный идентификатор)
policy.uuid string

Уникальный идентификатор политики.

имя
policy.name string

Имя, связанное с политикой.

client
policy.client string

Клиент, связанный с политикой.

clientId
policy.clientId string

Уникальный идентификатор клиента, связанного с политикой.

currency
policy.currency string

Валюта по умолчанию политики.

currencyId
policy.currencyId string

Идентификатор, связанный с валютой.

version
policy.version integer

Версия политики.

flexAmountCap
policy.flexAmountCap integer

Если задано, представляет логическую крышку по количеству неядерных служб, которые могут быть включены в политику.

Дата вступления в силу
policy.effectiveDate string

Дата, когда эта политика вступила в силу.

statusTypeId
policy.statusTypeId string

Идентификатор, связанный с состоянием политики.

statusType
policy.statusType string

Состояние политики.

policyTypeId
policy.policyTypeId string

Идентификатор, связанный с типом политики.

policyType
policy.policyType string

Тип политики.

preDecision
policy.preDecision boolean

Если политика является политикой предварительного принятия решений, используется для определения того, будет ли принято перемещение.

completedDate
status.completedDate string

Дата завершения пакета сэрва.

userId
status.completedBy.userId string

Идентификатор пользователя, завершающего пакет.

электронная почта
status.completedBy.email string

Адрес электронной почты пользователя, завершающего пакет.

первый
status.completedBy.first string

Первое имя пользователя, завершающего пакет.

последний
status.completedBy.last string

Фамилия пользователя, завершающего пакет.

userId
status.modifiedBy.userId string

Идентификатор пользователя последнего пользователя для изменения пакета.

электронная почта
status.modifiedBy.email string

Адрес электронной почты пользователя, изменив пакет.

первый
status.modifiedBy.first string

Имя пользователя, изменяющего пакет.

последний
status.modifiedBy.last string

Фамилия пользователя, изменившего пакет.

modifiedDate
status.modifiedDate string

Дата последнего изменения пакета.

isReadyForESC
isReadyForESC boolean

Если пакет готов к изменениям в сценариях самообслуживания.

packageOwnerShip
packageOwnerShip string

Определяет, у кого есть разрешения на изменение пакета.

Получение контактных данных консультанта

Возвращает консультанта, назначенного определенному перемещению, и их контактные данные.

Параметры

Имя Ключ Обязательно Тип Описание
Указывает, следует ли извлечь рисунок консультанта.
IncludePicture True boolean

Указывает, следует ли получить рисунок и включить его в ответ.

Уникальный идентификатор перемещения
RelocationId True string

Уникальный идентификатор перемещения для возврата консультанта

Возвращаемое значение

Имя Путь Тип Описание
имя
name string

Имя советника.

инициалы
initials string

Инициалы консультанта.

электронная почта
email string

Адрес электронной почты консультанта.

phone
phone string

Номер телефона консультанта.

availability
availability string

Доступность консультанта.

image
image string

JPEG-файл base64 консультанта. Не включается, если для рисунка задано значение false.

bookingUrl
bookingUrl string

URL-адрес Microsoft Booking, который можно использовать для планирования звонка с консультантом.

userTime
userTime string

Время в часовом поясе, в который консультант входит со сведениями смещения.

contUID
contUID integer

Основной системный идентификатор консультанта.

OutOfOffice
outOfOffice boolean

Указывает, выходит ли консультант из должности.

outOfOfficeMessage
outOfOfficeMessage string

Если задано сообщение о выходе из офиса.

startTime
startTime string

Время, когда консультант начинает свой рабочий день.

endTime
endTime string

Время, когда советник заканчивает свой рабочий день.

Получение списка перемещения, связанных с пользователем, вошедшего в систему

Получение списка перемещения, связанных с пользователем, вошедшего в систему, включая прошлые и нынешние перемещения.

Возвращаемое значение

Имя Путь Тип Описание
перемещение
relocations array of object

Список перемещений, к которым имеет доступ прошедший проверку подлинности пользователь. Прошлые и будущие ходы включаются, если известно.

relocationId
relocations.relocationId string

Уникальный идентификатор перемещения.

Имя
relocations.firstName string

Имя пользователя, вошедшего в систему.

lastName
relocations.lastName string

Имя пользователя, вошедшего в систему.

transfereeFirstName
relocations.transfereeFirstName string

Первое имя перемещаемого лица.

transfereeLastName
relocations.transfereeLastName string

Фамилия перемещаемого лица.

userAccountId
relocations.userAccountId string

Идентификатор учетной записи пользователя, вошедшего в систему.

departureCountry
relocations.departureCountry string

Страна отъезда для переезда.

departureCountryCode
relocations.departureCountryCode string

Код страны ISO в расположении отъезда для перемещений.

departureState
relocations.departureState string

Состояние или просечение места отъезда.

departureCity
relocations.departureCity string

Город места отъезда.

destinationCountry
relocations.destinationCountry string

Страна перемещается в страну.

destinationCountryCode
relocations.destinationCountryCode string

Код ISO страны, в которой перемещается.

destinationState
relocations.destinationState string

Состояние назначения, в которое перемещается.

destinationCity
relocations.destinationCity string

Город назначения, в который перемещается город.

system
relocations.system string

Исходная система этого перемещения.

delegate
relocations.delegate boolean

Указывает, имеет ли пользователь делегированный доступ к этому перемещению.

доступ
relocations.access string

Указывает уровень доступа.

sourceSystemId
relocations.sourceSystemId integer

Идентификатор операционной платформы, полезный для поддержки.

Оценочная оценкаStartDate
relocations.estimatedStartDate string

Предполагаемая дата начала перемещения.

clientName
relocations.clientName string

Имя клиента, связанного с перемещением.

clientId
relocations.clientId string

Идентификатор клиента, связанного с перемещением.

электронная почта
relocations.email string

Сообщение электронной почты, связанное с перемещением.

предпочтительный язык
relocations.preferredLanguage string

Предпочтительный язык перемещаемого лица.

programName
relocations.programName string

Программа, в которой выполняется перемещение, определяет преимущества.

isExpenseReceiptUploadRequired
relocations.isExpenseReceiptUploadRequired boolean

Если отправки квитанций требуются для отчетов о расходах по этому перемещению.

isMyDocumentsAccessEnabled
relocations.isMyDocumentsAccessEnabled boolean

Если доступ к документам разрешен для этого перемещения.

статус
relocations.status string

Состояние перемещения. ACTIVE, CANCEL, CLOSED или ONHOLD.

ПредполагаемоеendDate
relocations.estimatedEndDate string

Предполагаемая дата окончания перемещения. Если перемещение является постоянным, это не будет задано.

isGovernmentClient
relocations.isGovernmentClient boolean

Указывает, связана ли перемещение с государственной сущностью.

отображаемое имя
relocations.displayName string

Отображаемое значение для перемещения, объединяющего элементы назначения и отъезда.

isDPSClient
relocations.isDPSClient boolean

Указывает, использует ли перемещение платформу цифровой политики.

orgUid
relocations.orgUid integer

Идентификатор организации, связанный с этим перемещением. Полезно для поддержки.

isTransitionFile
isTransitionFile boolean

Указывает, был ли этот файл уже запущен с другим агентством, прежде чем переходить в Сирву.

isExpenseBudgetEnabled
isExpenseBudgetEnabled boolean

Указывает, является ли перемещение конкретным бюджетом расходов.

предпочтительный язык
preferredLanguage string

Предпочитаемый язык пользователя, вошедшего в систему.