Partager via


Sirva relocalisation de l’employé (préversion)

Connectez-vous à la plateforme du portail des employés de Sirva Relocation pour récupérer des informations sur vos relocalisations passées et présentes. Ce connecteur nécessite un compte actif avec Sirva Relocation pour notre portail des employés (https://ee.sirva.com).

Ce connecteur accorde l’accès aux informations de déplacement et vous permet de récupérer les informations de contact et la disponibilité de votre conseiller personnel. Vous pouvez également récupérer votre forfait d’avantages et les allocations connexes pour examiner et poser des questions sur votre politique.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Prise en charge de la réinstallation de Sirva
URL https://support.sirva.com
Messagerie électronique sirvacsc@sirva.com
Métadonnées du connecteur
Éditeur Relocalisation de Sirva
Site internet https://www.sirva.com
Politique de confidentialité https://www.sirva.com/support/privacy-policy
Catégories Productivité

Sirva relocalisation du connecteur employé

Sirva Connect+ Transferee fournit un connecteur qui vous permet de récupérer des informations sur vos déplacements actuels, passés et présents avec Sirva.

Prerequisites

Vous devez procéder comme suit :

  • Un compte actif avec Sirva Relocation

Si vous avez accès à la plateforme, vous recevrez un e-mail avec les informations d’identification de connexion de Sirva.

Pour que l’authentification Microsoft Entra fonctionne, votre locataire doit être mappé à une organisation et une inscription d’application doit être configurée correctement pour accéder à l’API. Veuillez contacter le support sirva (https://support.sirva.com) pour commencer le processus.

Éditeur : Sirva Relocation

Opérations prises en charge

Le connecteur prend en charge les opérations suivantes :

  • Get Relocations: répertorie les réadressages auquel vous avez accès
  • Get Relocation Package: récupère un package d’avantages pour une réinstallation spécifique
  • Get Counselor Contact Information: récupère les informations de contact du conseiller pour une réinstallation, y compris les URL permettant de réserver des réunions
  • Ask the Sirva bot a question about a topic: demande au bot Sirva une question sur votre déplacement

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Inscription d’application Microsoft Entra Se connecter à l’aide d’une inscription d’application Microsoft Entra personnalisée Toutes les régions Non partageable
Compte Sirva Se connecter via l’authentification Sirva Toutes les régions Non partageable
Valeur par défaut [DÉCONSEILLÉE] Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante. Toutes les régions Non partageable

Inscription d´application Microsoft Entra

ID d’authentification : aad-auth

Applicable : Toutes les régions

Se connecter à l’aide d’une inscription d’application Microsoft Entra personnalisée

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
ID de client ficelle ID d’application (client) de votre inscription d’application Entra ID Vrai
Clé secrète client securestring Clé secrète client de votre inscription d’application Entra ID Vrai

Compte Sirva

ID d’authentification : custom-app-auth

Applicable : Toutes les régions

Se connecter via l’authentification Sirva

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Valeur par défaut [DÉCONSEILLÉE]

Applicable : Toutes les régions

Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Limites de limitation

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Obtenir les informations de contact du conseiller

Obtient le conseiller affecté à un déplacement spécifique et à ses coordonnées.

Poser une question au bot Sirva sur un sujet

Envoie le texte de la question au bot de réponse Sirva sur la rubrique sélectionnée et retourne avec une réponse

Retenez le package d’avantages associé à un déplacement

Récupérer le forfait d’avantages associés à une réinstallation spécifique, y compris les allocations potentielles

Récupérer une liste de déplacements associés à l’utilisateur connecté

Récupérez une liste de déplacements associés à l’utilisateur connecté, y compris les déplacements passés et présents.

Obtenir les informations de contact du conseiller

Obtient le conseiller affecté à un déplacement spécifique et à ses coordonnées.

Paramètres

Nom Clé Obligatoire Type Description
Indique si l’image du conseiller doit être récupérée
IncludePicture True boolean

Indique si l’image doit être extraite et incluse dans la réponse

Identificateur unique du déplacement
RelocationId True string

Identificateur unique du déplacement pour renvoyer le conseiller pour

Retourne

Nom Chemin Type Description
nom
name string

Nom du conseiller.

paraphe
initials string

Initiales du conseiller.

Messagerie électronique
email string

Adresse e-mail du conseiller.

phone
phone string

Numéro de téléphone du conseiller.

disponibilité
availability string

Disponibilité du conseiller.

image
image string

Un JPEG base64 du conseiller. Non inclus si l’image include est définie sur false.

bookingUrl
bookingUrl string

URL de Microsoft Booking qui peut être utilisée pour planifier un appel avec le conseiller.

userTime
userTime string

Heure dans le fuseau horaire dans laquelle le conseiller se trouve avec des informations de décalage.

contUID
contUID integer

Identificateur système principal du conseiller.

outOfOffice
outOfOffice boolean

Indique si le conseiller est hors de bureau.

outOfOfficeMessage
outOfOfficeMessage string

Message d’absence du bureau s’il est défini.

startTime
startTime string

L’heure à laquelle le conseiller commence sa journée de travail.

endTime
endTime string

L’heure à laquelle le conseiller termine sa journée de travail.

Poser une question au bot Sirva sur un sujet

Envoie le texte de la question au bot de réponse Sirva sur la rubrique sélectionnée et retourne avec une réponse

Paramètres

Nom Clé Obligatoire Type Description
RelocationId
RelocationId True string

Identificateur unique du déplacement.

Question à poser au bot
Query True string

Question à poser au bot

Le sujet sur la question est sur
Topic True string

Le sujet sur la question est sur

Retourne

Nom Chemin Type Description
répondre
answer string

Réponse à la question posée.

Retenez le package d’avantages associé à un déplacement

Récupérer le forfait d’avantages associés à une réinstallation spécifique, y compris les allocations potentielles

Paramètres

Nom Clé Obligatoire Type Description
L’identité unique de la réinstallation
RelocationId True string

Identificateur unique du déplacement pour extraire le package

Retourne

Nom Chemin Type Description
isStarted
isStarted boolean

Indique si le package a commencé à être préparé.

isComplete
isComplete boolean

Indique si le package a été terminé.

isAccepted
isAccepted boolean

Indique si le package a été accepté.

readyForNeedsAnalysis
readyForNeedsAnalysis boolean

Indique si le package est prêt pour la tâche d’analyse des besoins à émettre.

Allocations
allowances array of object

Tableau des allocations disponibles et sélectionnées pour laquelle l’employé déplacé est éligible.

Identifiant unique universel (UUID)
allowances.uuid string

Identificateur unique de l’allocation.

nom
allowances.name string

Informations sur la valeur de l’allocation.

amountIdentifiedAt Consultingation
allowances.amountIdentifiedAtConsultation boolean

Indique si le montant de l’allocation est identifié par le cousnselor pendant l’appel initial des prestations.

allowances.amount float

Montant de l’allocation s’il est identifié.

monnaie
allowances.currency string

Code ISO de la devise dans laquelle l’allocation doit être versée.

currencyId
allowances.currencyId string

ID interne de la devise.

type de catégorie
allowances.categoryType string

La catégorie à laquelle l’allocation est associée.

categoryTypeId
allowances.categoryTypeId string

Identificateur interne de la catégorie.

occurrenceType
allowances.occurrenceType string

Fréquence à laquelle l’allocation est versée.

occurrenceTypeId
allowances.occurrenceTypeId string

Identificateur interne de la fréquence.

paidByType
allowances.paidByType string

L’organisation paie l’allocation à l’employé déplacé.

paidByTypeId
allowances.paidByTypeId string

Identificateur interne pour le type payant.

isSelected
allowances.isSelected boolean

Indique si l’allocation a été incluse dans le forfait d’avantages.

userId
allowances.paymentRequest.requestedBy.userId string

ID d’utilisateur associé à la demande de paiement.

Messagerie électronique
allowances.paymentRequest.requestedBy.email string

Adresse e-mail de l’utilisateur demandant le paiement.

premier
allowances.paymentRequest.requestedBy.first string

Prénom de l’utilisateur demandant le paiement.

last
allowances.paymentRequest.requestedBy.last string

Nom de l’utilisateur demandant le paiement.

requestedDate
allowances.paymentRequest.requestedDate string

Date demandée pour payer l’allocation.

remittanceMethod
allowances.paymentRequest.remittanceMethod string

Méthode d’envoi de fonds pour payer l’allocation.

remittanceAccount
allowances.paymentRequest.remittanceAccount string

Compte bancaire auquel le paiement doit être effectué.

services
services array of object

Liste des services avec des avantages et des composants disponibles pour l’employé déplacé.

isInPackage
services.isInPackage boolean

Indique si le service est inclus dans le package. Si un service n’est pas inclus, un utilisateur peut le demander, mais il peut ne pas être couvert par l’organisation fournissant le déplacement.

Identifiant unique universel (UUID)
services.uuid string

Identificateur unique du service.

nom
services.name string

Nom du service.

type de catégorie
services.categoryType string

La catégorie sous laquelle le service se trouve.

categoryTypeId
services.categoryTypeId string

Identificateur unique du type de catégorie.

brève description
services.shortDescription string

Brève description des avantages fournis par le service.

longDescription
services.longDescription string

Description plus détaillée des avantages fournis par le service.

providerType
services.providerType string

Fournisseur du service.

providerTypeId
services.providerTypeId string

Identificateur unique du fournisseur.

cœur
services.core boolean

Indique si ce service est considéré comme principal ou non facultatif.

cashOutOption
services.cashOutOption boolean

Indique si le service prend en charge l’échange de l’avantage pour un montant en espèces.

cashOutPercentage
services.cashOutPercentage integer

Définit le pourcentage de la valeur estimée du service reçu en cas de retrait.

outOfPocket
services.outOfPocket boolean

Indique si le service est payé en dehors de la poche par l’employé déplacé.

Séquence
services.sequence integer

Séquence de tri qui place les services dans un ordre plus logique en fonction de leur démarrage.

URL d'icône
services.iconUrl string

URL du CDN Sirva pour une icône qui représente le service.

isIncluded
services.isIncluded boolean

Indique si le service est actuellement inclus dans le package.

masterServiceId
services.masterServiceId string

Identificateur de cumul qui lie des variantes de services sous un seul parent.

isClientService
services.isTravelService boolean

Indique s’il s’agit d’un service de voyage.

useRemittance
services.useRemittance boolean

Indique si le compte de transfert de fonds par défaut doit être utilisé.

cashOutAmount
services.cashOutAmount float

Définit une valeur plate pour le service si le pourcentage n’est pas défini.

Avantages
services.benefits array of object

Liste des avantages associés à ce service.

Identifiant unique universel (UUID)
services.benefits.uuid string

Identificateur unique de l’avantage.

nom
services.benefits.name string

Nom de l’avantage.

outOfPocket
services.benefits.outOfPocket boolean

Si l’avantage est payé par l’employé en déplacement.

cashoutOption
services.benefits.cashoutOption boolean

Si l’avantage prend en charge une option de trésorerie.

cashoutPercentage
services.benefits.cashoutPercentage integer

Définit le pourcentage de la valeur estimée de l’avantage reçu en cas de retrait.

cashoutAmount
services.benefits.cashoutAmount float

Définit un montant de retrait forfaitaire pour l’avantage si un pourcentage n’est pas disponible.

isIncluded
services.benefits.isIncluded boolean

Définit si l’avantage est inclus dans le package.

amountOptions
services.benefits.amountOptions array of object

Liste des différentes options de coût pour l’avantage avec différentes configurations et valeurs.

Identifiant unique universel (UUID)
services.benefits.amountOptions.uuid string

Identificateur unique de l’option de coût pour l’avantage.

unitType
services.benefits.amountOptions.unitType string

Unité de mesure.

unitTypeId
services.benefits.amountOptions.unitTypeId string

Identificateur unique de l’unité de mesure.

condition
services.benefits.amountOptions.condition string

Définit toutes les conditions sur la façon dont cette option est utilisée.

conditionId
services.benefits.amountOptions.conditionId string

Identificateur unique de la condition.

quantité
services.benefits.amountOptions.quantity float

Montant total accordé par l’option.

coût
services.benefits.amountOptions.cost float

Coût de cette option.

actual CashOut
services.benefits.amountOptions.actualCashOut float

Valeur réelle de trésorerie de cette option.

recommandé
services.benefits.amountOptions.recommended boolean

Indique que cette option particulière est recommandée par Sirva.

isSelected
services.benefits.amountOptions.isSelected boolean

Indique si cette option est l’option sélectionnée ou non.

date de création
services.benefits.amountOptions.createdDate string

Date de création de l’option.

commentaire
services.benefits.amountOptions.comment string

Commentaires supplémentaires sur l’option.

components
services.benefits.components array of object

Liste des composants associés à cet élément.

Identifiant unique universel (UUID)
services.benefits.components.uuid string

Identificateur unique du composant.

nom
services.benefits.components.name string

Nom du composant.

componentType
services.benefits.components.componentType string

Type du composant.

componentTypeId
services.benefits.components.componentTypeId string

Identificateur unique du composant.

options
services.benefits.components.options array of object

Options associées au composant.

Identifiant unique universel (UUID)
services.benefits.components.options.uuid string

Identificateur unique du composant.

value
services.benefits.components.options.value string

Élément associé au composant.

recommandé
services.benefits.components.options.recommended boolean

Si le composant est recommandé par Sirva

Séquence
services.benefits.components.options.sequence integer

Séquence de tri pour les composants.

requestType
services.serviceRequest.requestType string

Type de requête.

requestedDate
services.serviceRequest.requestedDate string

Date à laquelle la demande a été effectuée.

userId
services.serviceRequest.requestedBy.userId string

ID de l’utilisateur effectuant la requête.

Messagerie électronique
services.serviceRequest.requestedBy.email string

Adresse e-mail de l’utilisateur effectuant la demande.

premier
services.serviceRequest.requestedBy.first string

Prénom de l’utilisateur qui effectue la requête.

last
services.serviceRequest.requestedBy.last string

Dernier neame de l’utilisateur effectuant la requête.

servicesAvailable
servicesAvailable array of

Liste des services disponibles.

Identifiant unique universel (UUID)
policy.uuid string

Identificateur unique de la stratégie.

nom
policy.name string

Nom associé à la stratégie.

client
policy.client string

Client associé à la stratégie.

clientId
policy.clientId string

Identificateur unique du client associé à la stratégie.

monnaie
policy.currency string

Devise par défaut de la stratégie.

currencyId
policy.currencyId string

Identificateur associé à la devise.

version
policy.version integer

Version de la stratégie.

flexAmountCap
policy.flexAmountCap integer

Si elle est définie, représente une limite logique sur la quantité de services non-cœurs pouvant être inclus dans la stratégie.

Date d’entrée en vigueur
policy.effectiveDate string

Date à laquelle cette stratégie a pris effet.

statusTypeId
policy.statusTypeId string

Identificateur associé à l’état de la stratégie.

statusType
policy.statusType string

État de la stratégie.

policyTypeId
policy.policyTypeId string

Identificateur associé au type de la stratégie.

policyType
policy.policyType string

Type de la stratégie.

preDecision
policy.preDecision boolean

Si la stratégie est une stratégie de pré-décision, utilisée pour déterminer si le déplacement sera accepté.

completedDate
status.completedDate string

Date à laquelle le paquet a été complété par Sirva.

userId
status.completedBy.userId string

Identificateur de l’utilisateur de la personne qui termine le package.

Messagerie électronique
status.completedBy.email string

Adresse e-mail de l’utilisateur qui termine le package.

premier
status.completedBy.first string

Prénom de la personne qui termine le package.

last
status.completedBy.last string

Nom de la personne qui termine le package.

userId
status.modifiedBy.userId string

ID d’utilisateur de la dernière personne à modifier le package.

Messagerie électronique
status.modifiedBy.email string

Adresse e-mail de l’utilisateur qui a modifié le package.

premier
status.modifiedBy.first string

Prénom de l’utilisateur qui a modifié le package.

last
status.modifiedBy.last string

Nom de l’utilisateur qui a modifié le package.

modifiedDate
status.modifiedDate string

Date de dernière modification du package.

isReadyForESC
isReadyForESC boolean

Si le package est prêt à être modifié dans les scénarios en libre-service.

packageOwnerShip
packageOwnerShip string

Définit qui a les autorisations nécessaires pour modifier le package.

Récupérer une liste de déplacements associés à l’utilisateur connecté

Récupérez une liste de déplacements associés à l’utilisateur connecté, y compris les déplacements passés et présents.

Retourne

Nom Chemin Type Description
Délocalisations
relocations array of object

Liste des réinstallations auxquelles l’utilisateur authentifié a accès. Les déplacements passés et futurs sont inclus s’ils sont connus.

relocationId
relocations.relocationId string

Identificateur unique du déplacement.

firstName
relocations.firstName string

Prénom de l’utilisateur connecté.

lastName
relocations.lastName string

Prénom de l’utilisateur connecté.

transfereeFirstName
relocations.transfereeFirstName string

Prénom de la personne qui se déplace.

transfereeLastName
relocations.transfereeLastName string

Nom de la personne qui se déplace.

userAccountId
relocations.userAccountId string

ID de compte de l’utilisateur connecté.

departureCountry
relocations.departureCountry string

Pays de départ pour la réinstallation.

departureCountryCode
relocations.departureCountryCode string

Code de pays ISO de l’emplacement de départ de la réinstallation.

departureState
relocations.departureState string

État ou provice de l’emplacement de départ.

departureCity
relocations.departureCity string

La ville de l’emplacement de départ.

destinationCountry
relocations.destinationCountry string

Le pays est déplacé vers.

destinationCountryCode
relocations.destinationCountryCode string

Code ISO du pays à déplacer.

destinationState
relocations.destinationState string

État de destination vers lequel il est déplacé.

destinationCity
relocations.destinationCity string

Ville de travail de destination en cours de déplacement.

system
relocations.system string

Système d’origine de ce déplacement.

delegate
relocations.delegate boolean

Indique si l’utilisateur a délégué l’accès à cette réinstallation.

accès
relocations.access string

Indique le niveau d’accès.

sourceSystemId
relocations.sourceSystemId integer

ID de la plateforme d’exploitation, utile pour la prise en charge.

estimatedStartDate
relocations.estimatedStartDate string

Date de début estimée du déplacement.

clientName
relocations.clientName string

Nom du client associé à la réinstallation.

clientId
relocations.clientId string

ID du client associé à la réinstallation.

Messagerie électronique
relocations.email string

E-mail associé au déplacement.

preferredLanguage
relocations.preferredLanguage string

Langue préférée de la personne déplacée.

programName
relocations.programName string

Le programme de relocalisation est sous lequel définit les avantages.

isExpenseReceiptUploadRequired
relocations.isExpenseReceiptUploadRequired boolean

Si les chargements de reçus sont requis pour les notes de frais sur cette réinstallation.

isMyDocumentsAccessEnabled
relocations.isMyDocumentsAccessEnabled boolean

Si l’accès aux documents est autorisé pour cette réinstallation.

status
relocations.status string

État de la réinstallation. ACTIVE, CANCEL, CLOSED ou ONHOLD.

estimatedEndDate
relocations.estimatedEndDate string

Date de fin estimée de la réinstallation. Si le déplacement est permanent, cela ne sera pas défini.

isGovernmentClient
relocations.isGovernmentClient boolean

Indique si la réinstallation est associée à une entité gouvernementale.

nom d’affichage
relocations.displayName string

Valeur d’affichage pour le déplacement combinant les éléments de destination et de départ.

isDPSClient
relocations.isDPSClient boolean

Indique si la réinstallation utilise la plateforme de stratégie numérique.

orgUid
relocations.orgUid integer

ID d’organisation associé à ce déplacement. Utile pour la prise en charge.

isTransitionFile
isTransitionFile boolean

Indique si ce fichier était déjà en cours avec une autre agence avant d’être déplacé vers Sirva.

isExpenseBudgetEnabled
isExpenseBudgetEnabled boolean

Indique si le déplacement est soumis à des budgets de dépenses spécifiques.

preferredLanguage
preferredLanguage string

Langue préférée de l’utilisateur connecté.