共用方式為


Sirva 搬遷員工 (預覽版)

連接到 Sirva Relocation 的員工門戶平台,檢索有關您過去和現在的搬遷信息。 此連接器需要我們員工入口網站 ()https://ee.sirva.com 的 Sirva Relocation 有效帳戶。

此連接器授予移動資訊的存取權,並允許您獲取個人顧問的聯絡資訊和可用性。 您還可以獲取您的福利包和相關津貼以供審查並詢問有關您的保單的問題。

此連接器適用於以下產品和區域:

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 (DoD)
Power Apps 進階 除下列區域外的所有 Power Apps 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人​​
名稱 Sirva 搬遷支持
URL https://support.sirva.com
Email sirvacsc@sirva.com
連接器中繼資料
Publisher 西爾瓦搬遷
網站 https://www.sirva.com
隱私策略 https://www.sirva.com/support/privacy-policy
類別 生產力

Sirva 搬遷員工連接器

Sirva Connect+ Transferee 提供了一個連接器,可讓您使用 Sirva 獲取有關當前、過去和現在的移動的信息。

先決條件

您將需要以下內容才能繼續:

  • Sirva Relocation 的活躍帳戶

如果您有權訪問該平台,您將收到一封來自 Sirva 的電子郵件,其中包含登錄憑據。

為了讓 Microsoft Entra 認證正常運作,你的租戶必須對應到組織,並且正確設定應用程式註冊才能存取 API。 請聯絡 Sirva 客服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 帳號 透過 Sirva 認證登入 所有區域 不可共享
預設值 [已棄用] 此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。 所有區域 不可共享

Microsoft Entra 應用程式註冊

認證 ID:aad-auth

適用:所有地區

使用自訂的 Microsoft Entra 應用程式註冊登入

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
用戶端識別碼 字串 來自你 Entra ID 應用程式註冊的應用程式(客戶端)ID
用戶端密碼 安全字串 Entra ID 應用程式註冊時的客戶端秘密

Sirva 帳號

認證 ID:custom-app-auth

適用:所有地區

透過 Sirva 認證登入

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

預設值 [已棄用]

適用:所有地區

此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

向 Sirva 機器人詢問有關主題的問題

將有關所選主題的問題文本發送給 Sirva 回答機器人,並返回回复

擷取與登入使用者相關聯的移動清單

擷取與登入使用者相關聯的動作清單,包括過去和現在的動作。

擷取與移動相關聯的權益套件

擷取與特定搬遷相關聯的福利套件,包括潛在的津貼

獲取輔導員聯繫信息

取得指派給特定動作的輔導員及其聯絡資訊。

向 Sirva 機器人詢問有關主題的問題

將有關所選主題的問題文本發送給 Sirva 回答機器人,並返回回复

參數

名稱 機碼 必要 類型 Description
RelocationId
RelocationId True string

移動的唯一識別碼。

要問機器人的問題
Query True string

要問機器人的問題

問題涉及的主題
Topic True string

問題涉及的主題

傳回

名稱 路徑 類型 Description
answer string

所提出問題的答案。

擷取與登入使用者相關聯的移動清單

擷取與登入使用者相關聯的動作清單,包括過去和現在的動作。

傳回

名稱 路徑 類型 Description
搬遷
relocations array of object

已驗證使用者有權存取的重新定位清單。 如果已知,包括過去和未來的舉動。

重新定位標識碼
relocations.relocationId string

移動的唯一識別碼。

名字
relocations.firstName string

登入使用者的名字。

lastName
relocations.lastName string

登入使用者的名字。

transfereeFirstName
relocations.transfereeFirstName string

搬遷人員的名字。

transferee姓氏
relocations.transfereeLastName string

搬遷人員的姓氏。

使用者帳戶識別碼
relocations.userAccountId string

登入使用者的帳戶 ID。

出發國家/地區
relocations.departureCountry string

搬遷的出發國家/地區。

出發國家代碼
relocations.departureCountryCode string

搬遷出發地點的 ISO 國家代碼。

出發狀態
relocations.departureState string

出發地點的州或省。

出發城市
relocations.departureCity string

出發地點的城市。

目的地國家/地區
relocations.destinationCountry string

被遷移到的國家。

destinationCountryCode
relocations.destinationCountryCode string

要搬遷到的國家/地區的 ISO 代碼。

destinationState
relocations.destinationState string

要重新定位的目的地狀態。

目的地城市
relocations.destinationCity string

要搬遷到的目的地工作城市。

系統
relocations.system string

此招的起源系統。

委派
relocations.delegate boolean

指出使用者是否已委派此重新配置的存取權。

訪問
relocations.access string

指出存取層級。

來源系統識別碼
relocations.sourceSystemId integer

操作平台 ID,可用於支援。

估計開始日期
relocations.estimatedStartDate string

搬遷的預估開始日期。

客戶名稱
relocations.clientName string

與重新配置相關聯的用戶端名稱。

clientId
relocations.clientId string

與重新配置相關聯的用戶端識別碼。

電子郵件
relocations.email string

與搬遷相關聯的電子郵件。

偏好語言
relocations.preferredLanguage string

被搬遷人員的首選語言。

programName
relocations.programName string

搬遷所依據的計劃定義了福利。

isExpenseReceiptUploadRequired
relocations.isExpenseReceiptUploadRequired boolean

如果此搬遷的費用報告需要上傳收據。

isMyDocumentsAccess已啟用
relocations.isMyDocumentsAccessEnabled boolean

是否允許此重新定位存取文件。

狀態
relocations.status string

搬遷的狀態。 ACTIVE、CANCEL、CLOSED 或 ONHOLD。

估計結束日期
relocations.estimatedEndDate string

搬遷的預估結束日期。 如果搬遷是永久性的,則不會設定此設定。

isGovernment客戶
relocations.isGovernmentClient boolean

指出重新定位是否與政府實體相關聯。

顯示名稱
relocations.displayName string

結合目的地和出發元素的移動的顯示值。

是DPS謹慎
relocations.isDPSClient boolean

指出重新定位是否使用數位原則平台。

orgUid
relocations.orgUid integer

與此移動相關聯的組織識別碼。 對支持很有用。

isTransitionFile
isTransitionFile boolean

指出此檔案在移至 Sirva 之前是否已與其他機構進行。

isExpenseBudget已啟用
isExpenseBudgetEnabled boolean

指出搬遷是否受特定費用預算的約束。

偏好語言
preferredLanguage string

登入使用者的偏好語言。

擷取與移動相關聯的權益套件

擷取與特定搬遷相關聯的福利套件,包括潛在的津貼

參數

名稱 機碼 必要 類型 Description
搬遷的唯一標識符
RelocationId True string

提取套件的移動的唯一識別碼

傳回

名稱 路徑 類型 Description
isStarted
isStarted boolean

指出封裝是否已開始準備。

是完整的
isComplete boolean

指出封裝是否已完成。

已接受
isAccepted boolean

指出封裝是否已被接受。

readyForNeeds分析
readyForNeedsAnalysis boolean

指出封裝是否已準備好發出需求分析任務。

津貼
allowances array of object

搬遷員工有資格獲得的一系列可用和選定的津貼。

全域唯一識別碼 (UUID)
allowances.uuid string

津貼的唯一識別碼。

名稱
allowances.name string

有關津貼用途的資訊。

amountIdentifiedAtConsult
allowances.amountIdentifiedAtConsultation boolean

指出津貼金額是否由表親在初始福利呼叫期間確定。

allowances.amount float

津貼金額(如果已確定)。

貨幣
allowances.currency string

支付津貼的貨幣的 ISO 代碼。

貨幣標識符
allowances.currencyId string

貨幣的內部 ID。

類別類型
allowances.categoryType string

津貼與之相關聯的類別。

類別類型識別碼
allowances.categoryTypeId string

類別的內部識別碼。

occurrenceType
allowances.occurrenceType string

津貼的支付頻率。

occurrenceTypeId
allowances.occurrenceTypeId string

頻率的內部識別碼。

paidByType
allowances.paidByType string

向搬遷員工支付津貼的組織。

已付款ByTypeId
allowances.paidByTypeId string

依類型付費的內部識別碼。

是已選取
allowances.isSelected boolean

指出津貼是否已包含在福利方案中。

userId
allowances.paymentRequest.requestedBy.userId string

與付款要求相關聯的使用者 ID。

電子郵件
allowances.paymentRequest.requestedBy.email string

要求付款的使用者的電子郵件地址。

first
allowances.paymentRequest.requestedBy.first string

要求付款的使用者的名字。

last
allowances.paymentRequest.requestedBy.last string

請求付款的使用者的姓氏。

請求日期
allowances.paymentRequest.requestedDate string

要求支付津貼的日期。

remittance方法(remittanceMethod)
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

服務所屬的類別。

類別類型識別碼
services.categoryTypeId string

類別類型的唯一識別碼。

簡短描述
services.shortDescription string

服務提供的好處的簡短描述。

長描述
services.longDescription string

對服務提供的好處的更長、更詳細的描述。

providerType
services.providerType string

服務的提供者。

providerTypeId
services.providerTypeId string

提供者的唯一識別碼。

核心
services.core boolean

指出此服務是否被視為核心服務,或非選擇性服務。

現金輸出選項
services.cashOutOption boolean

指出服務是否支援將權益兌換成現金金額。

現金支出百分比
services.cashOutPercentage integer

定義兌現時收到的服務預估價值的百分比。

自掏腰包
services.outOfPocket boolean

指出服務費用是否由搬遷員工自掏腰包支付。

序列
services.sequence integer

排序順序,根據服務啟動的時間,以更合乎邏輯的順序排列服務。

iconUrl
services.iconUrl string

Sirva CDN 的 URL,用於代表服務的圖示。

是包含
services.isIncluded boolean

指出服務目前是否包含在套件中。

masterServiceId
services.masterServiceId string

彙總識別碼,可將單一父項下的服務變化串聯在一起。

旅遊服務
services.isTravelService boolean

指出這是否是旅行服務。

使用匯款
services.useRemittance boolean

指出是否應使用預設匯款帳戶。

現金輸出金額
services.cashOutAmount float

定義服務的一般值(如果未定義百分比)。

優點
services.benefits array of object

與此服務相關的福利清單。

全域唯一識別碼 (UUID)
services.benefits.uuid string

權益的唯一識別碼。

名稱
services.benefits.name string

權益的名稱。

自掏腰包
services.benefits.outOfPocket boolean

如果福利是由搬遷員工自掏腰包支付的。

兌現選項
services.benefits.cashoutOption boolean

如果福利支持兌現選項。

兌現百分比
services.benefits.cashoutPercentage integer

定義兌現時收到的利益估計值的百分比。

cashout金額
services.benefits.cashoutAmount float

定義福利的固定套現金額(如果無法使用百分比)。

是包含
services.benefits.isIncluded boolean

定義福利是否包含在套件中。

amount選項
services.benefits.amountOptions array of object

具有不同組態和值的權益的不同成本計算選項清單。

全域唯一識別碼 (UUID)
services.benefits.amountOptions.uuid string

權益成本計算選項的唯一識別碼。

單位類型
services.benefits.amountOptions.unitType string

測量單位。

單位類型識別碼
services.benefits.amountOptions.unitTypeId string

測量單位的唯一識別碼。

condition
services.benefits.amountOptions.condition string

定義如何使用此選項的任何條件。

條件標識
services.benefits.amountOptions.conditionId string

條件的唯一識別碼。

數量
services.benefits.amountOptions.quantity float

期權授予的總金額。

成本
services.benefits.amountOptions.cost float

此選項的成本。

實際兌現
services.benefits.amountOptions.actualCashOut float

此選項的實際套現價值。

推薦
services.benefits.amountOptions.recommended boolean

表示 Sirva 建議使用此特定選項。

是已選取
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

元件的名稱。

元件類型
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

如果該組件是 Sirva 推薦的

序列
services.benefits.components.options.sequence integer

元件的排序順序。

請求類型
services.serviceRequest.requestType string

請求的類型。

請求日期
services.serviceRequest.requestedDate string

提出請求的日期。

userId
services.serviceRequest.requestedBy.userId string

提出請求的使用者的 ID。

電子郵件
services.serviceRequest.requestedBy.email string

提出要求的使用者的電子郵件地址。

first
services.serviceRequest.requestedBy.first string

提出要求的使用者的名字。

last
services.serviceRequest.requestedBy.last string

提出請求的用戶的最後一個 neame。

服務可用
servicesAvailable array of

可用服務的清單。

全域唯一識別碼 (UUID)
policy.uuid string

原則的唯一識別碼。

名稱
policy.name string

與原則相關聯的名稱。

用戶端
policy.client string

與原則相關聯的用戶端。

clientId
policy.clientId string

與原則相關聯之用戶端的唯一識別碼。

貨幣
policy.currency string

保單的預設貨幣。

貨幣標識符
policy.currencyId string

與貨幣相關聯的識別碼。

版本
policy.version integer

原則的版本。

flexAmountCap
policy.flexAmountCap integer

如果已定義,則代表可包含在原則中的非核心服務數量的邏輯上限。

生效日期
policy.effectiveDate string

本政策生效的日期。

狀態類型識別碼
policy.statusTypeId string

與原則狀態相關聯的識別碼。

狀態類型
policy.statusType string

原則的狀態。

policyTypeId
policy.policyTypeId string

與原則類型相關聯的識別碼。

policyType
policy.policyType string

原則的類型。

預決定
policy.preDecision boolean

如果政策是預決策政策,則用於決定是否接受搬遷。

completedDate (已完成日期)
status.completedDate string

Sirva 完成包裹的日期。

userId
status.completedBy.userId string

完成套件之人員的使用者識別碼。

電子郵件
status.completedBy.email string

完成套件的使用者的電子郵件地址。

first
status.completedBy.first string

完成包裹的人員的名字。

last
status.completedBy.last string

完成包裹的人員的姓氏。

userId
status.modifiedBy.userId string

最後修改套件的人員的使用者 ID。

電子郵件
status.modifiedBy.email string

修改套件之使用者的電子郵件地址。

first
status.modifiedBy.first string

修改套件的使用者的名字。

last
status.modifiedBy.last string

修改套件之使用者的姓氏。

修改日期
status.modifiedDate string

上次修改套件的日期。

isReadyForESC
isReadyForESC boolean

如果套件已準備就緒,則在自助服務場景中進行修改。

packageOwnerShip
packageOwnerShip string

定義誰有權修改套件。

獲取輔導員聯繫信息

取得指派給特定動作的輔導員及其聯絡資訊。

參數

名稱 機碼 必要 類型 Description
指出是否應檢索輔導員圖片
IncludePicture True boolean

指出是否應該擷取圖片並包含在回應中

移動的唯一識別碼
RelocationId True string

返回輔導員的移動的唯一識別碼

傳回

名稱 路徑 類型 Description
名稱
name string

諮商師的姓名。

姓名縮寫
initials string

輔導員的姓名首字母。

電子郵件
email string

輔導員的電子郵件地址。

phone
phone string

輔導員的電話號碼。

availability
availability string

輔導員的可用性。

圖片
image string

輔導員的 base64 JPEG。 如果包含圖片設定為 false,則不包括。

booking網址
bookingUrl string

Microsoft Booking 的 URL,可用來排程與輔導員的通話。

使用者時間
userTime string

輔導員所處時區中的時間,以及偏移資訊。

續UID
contUID integer

諮商人的核心系統識別碼。

辦公室外
outOfOffice boolean

指出輔導員是否不在辦公室。

outOfOffice訊息
outOfOfficeMessage string

如果已設定,則不在辦公室訊息。

startTime
startTime string

輔導員開始一天工作的時間。

endTime
endTime string

輔導員結束工作日的時間。