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 |
| 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 |
輔導員的姓名首字母。 |
|
電子郵件
|
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 |
輔導員結束工作日的時間。 |