Sirva Rilocazione dipendente (anteprima)

Connettersi alla piattaforma del portale dei dipendenti di Sirva Relocation per recuperare informazioni sui rilocazione passati e presenti. Questo connettore richiede un account attivo con Sirva Rilocazione per il portale dei dipendenti (https://ee.sirva.com).

Questo connettore concede l'accesso alle informazioni di spostamento e consente di recuperare le informazioni di contatto e la disponibilità del consulente personale. È anche possibile recuperare il pacchetto di benefici e le quote correlate per la revisione e porre domande sul criterio.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio	Class	Regions
Copilot Studio	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Normale	Tutte le aree di App per la logica , ad eccezione delle seguenti:      - Aree di Azure per enti pubblici      - Aree di Azure Cina      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Di alta qualità	Tutte le aree di Power Apps , ad eccezione dei seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	Supporto per la rilocazione di Sirva
URL	https://support.sirva.com
Email	sirvacsc@sirva.com

Metadati del connettore
Editore	Sirva Rilocazione
Sito web	https://www.sirva.com
Informativa sulla privacy	https://www.sirva.com/support/privacy-policy
Categorie	Produttività

Sirva Rilocazione del connettore dei dipendenti

Sirva Connect+ Transferee fornisce un connettore che consente di recuperare informazioni sull'attuale, passato e presente con Sirva.

Prerequisiti

Per procedere, è necessario quanto segue:

• Un account attivo con Sirva Rilocazione

Se si ha accesso alla piattaforma, si riceverà un messaggio di posta elettronica con le credenziali di accesso da Sirva.

Affinché l'autenticazione di Microsoft Entra funzioni correttamente, il tenant deve essere mappato a un'organizzazione e la registrazione di un'applicazione deve essere configurata correttamente per accedere all'API. Per iniziare il processo, contattare il supporto tecnico sirva (https://support.sirva.com).

Autore: Sirva Rilocazione

Operazioni supportate

Il connettore supporta le operazioni seguenti:

• Get Relocations: elenca le rilozioni a cui si ha accesso
• Get Relocation Package: recupera un pacchetto di vantaggi per una rilocazione specifica
• Get Counselor Contact Information: recupera le informazioni di contatto del consulente per una rilocazione, inclusi gli URL per prenotare le riunioni
• Ask the Sirva bot a question about a topic: pone al bot Sirva una domanda sullo spostamento

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Registrazione dell'applicazione Microsoft Entra	Accedere con una registrazione personalizzata dell'applicazione Microsoft Entra	Tutte le aree	Non condivisibile
Account Sirva	Accedere tramite l'autenticazione sirva	Tutte le aree	Non condivisibile
Impostazione predefinita [DEPRECATO]	Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.	Tutte le aree	Non condivisibile

Registrazione dell'applicazione Microsoft Entra

ID autenticazione: aad-auth

Applicabile: tutte le aree

Accedere con una registrazione personalizzata dell'applicazione Microsoft Entra

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome	TIPO	Description	Obbligatorio
ID cliente	corda	ID applicazione (client) dalla registrazione dell'app Entra ID	Vero
Segreto del cliente	securestring	Segreto client dalla registrazione dell'app Entra ID	Vero

Account Sirva

ID autenticazione: custom-app-auth

Applicabile: tutte le aree

Accedere tramite l'autenticazione sirva

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Impostazione predefinita [DEPRECATO]

Applicabile: tutte le aree

Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	100	60 secondi

Azioni

Ottenere le informazioni di contatto del consulente	Ottiene il consulente assegnato a uno spostamento specifico e alle relative informazioni di contatto.
Porre al bot Sirva una domanda su un argomento	Invia il testo della domanda al bot di risposte Sirva sull'argomento selezionato e restituisce con una risposta
Recuperare il pacchetto di vantaggi associato a uno spostamento	Recuperare il pacchetto di benefici associato a una rilocazione specifica, incluse le potenziali indennità
Recuperare un elenco di spostamenti associati all'utente connesso	Recuperare un elenco di spostamenti associati all'utente connesso, inclusi gli spostamenti passati e presenti.

Ottenere le informazioni di contatto del consulente

ID operazione:

GetCounselorContactInformation

Ottiene il consulente assegnato a uno spostamento specifico e alle relative informazioni di contatto.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Indica se l'immagine del consulente deve essere recuperata	IncludePicture	True	boolean	Indica se l'immagine deve essere recuperata e inclusa nella risposta
Identificatore univoco dello spostamento	RelocationId	True	string	Identificatore univoco del passaggio per restituire il consulente per

Restituisce

Nome	Percorso	Tipo	Descrizione
nome	name	string	Nome del consigliere.
iniziali	initials	string	Le iniziali del consigliere.
posta elettronica	email	string	Indirizzo di posta elettronica del consulente.
phone	phone	string	Numero di telefono del consulente.
disponibilità	availability	string	La disponibilità del consulente.
image	image	string	Un JPEG di base64 del consigliere. Non incluso se l'immagine di inclusione è impostata su false.
bookingUrl	bookingUrl	string	URL di Microsoft Booking che può essere usato per pianificare una chiamata con il consulente.
userTime	userTime	string	Ora nel fuso orario in cui il consulente si trova con informazioni di offset.
contUID	contUID	integer	Identificatore di sistema principale per il consulente.
outOfOffice	outOfOffice	boolean	Indica se il consulente è fuori sede.
outOfOfficeMessage	outOfOfficeMessage	string	Messaggio fuori sede, se impostato.
startTime	startTime	string	L'ora in cui il consulente inizia la giornata lavorativa.
endTime	endTime	string	L'ora in cui il consulente termina la giornata lavorativa.

Porre al bot Sirva una domanda su un argomento

ID operazione:

AskSirvaBotAboutTopic

Invia il testo della domanda al bot di risposte Sirva sull'argomento selezionato e restituisce con una risposta

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
RilocazioneId	RelocationId	True	string	Identificatore univoco dello spostamento.
Domanda per porre il bot	Query	True	string	Domanda per porre il bot
L'argomento relativo alla domanda riguarda	Topic	True	string	L'argomento relativo alla domanda riguarda

Restituisce

Nome	Percorso	Tipo	Descrizione
risposta	answer	string	Risposta alla domanda posta.

Recuperare il pacchetto di vantaggi associato a uno spostamento

ID operazione:

GetRelocationPackage

Recuperare il pacchetto di benefici associato a una rilocazione specifica, incluse le potenziali indennità

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Identificatore univoco della rilocazione	RelocationId	True	string	Identificatore univoco dello spostamento per cui eseguire il pull del pacchetto

Restituisce

Nome	Percorso	Tipo	Descrizione
èIniziato	isStarted	boolean	Indica se il pacchetto è stato avviato per la preparazione.
isComplete	isComplete	boolean	Indica se il pacchetto è stato completato.
isAccepted	isAccepted	boolean	Indica se il pacchetto è stato accettato.
readyForNeedsAnalysis	readyForNeedsAnalysis	boolean	Indica se il pacchetto è pronto per l'esecuzione dell'attività di analisi delle esigenze.
Indennità	allowances	array of object	Una matrice di indennità disponibili e selezionate per cui il dipendente di trasferimento è idoneo.
UUID (Identificatore Unico Universale)	allowances.uuid	string	Identificatore univoco della quota.
nome	allowances.name	string	Informazioni sull'indennità.
amountIdentifiedAtConsultation	allowances.amountIdentifiedAtConsultation	boolean	Indica se l'importo dell'indennità è identificato dal cousnselor durante la chiamata iniziale al beneficio.
	allowances.amount	float	Importo dell'indennità, se identificato.
currency	allowances.currency	string	Codice ISO della valuta in cui deve essere pagata l'indennità.
currencyId	allowances.currencyId	string	ID interno della valuta.
tipoCategoria	allowances.categoryType	string	La categoria a cui è associata l'indennità.
categoryTypeId	allowances.categoryTypeId	string	Identificatore interno della categoria.
occurrenceType	allowances.occurrenceType	string	La frequenza in cui viene pagata l'indennità.
occurrenceTypeId	allowances.occurrenceTypeId	string	Identificatore interno per la frequenza.
paidByType	allowances.paidByType	string	L'organizzazione che paga l'indennità al dipendente trasferito.
paidByTypeId	allowances.paidByTypeId	string	Identificatore interno per l'oggetto pagato per tipo.
isSelected	allowances.isSelected	boolean	Indica se l'indennità è stata inclusa nel pacchetto di benefici.
userId	allowances.paymentRequest.requestedBy.userId	string	ID utente associato alla richiesta di pagamento.
posta elettronica	allowances.paymentRequest.requestedBy.email	string	Indirizzo di posta elettronica dell'utente che richiede il pagamento.
primo	allowances.paymentRequest.requestedBy.first	string	Nome dell'utente che richiede il pagamento.
ultimo	allowances.paymentRequest.requestedBy.last	string	Cognome dell'utente che richiede il pagamento.
requestedDate	allowances.paymentRequest.requestedDate	string	Data in cui è stato richiesto di pagare l'indennità.
rimessaMethod	allowances.paymentRequest.remittanceMethod	string	Metodo di rimessa per pagare l'indennità.
rimessaAccount	allowances.paymentRequest.remittanceAccount	string	Conto bancario a cui effettuare il pagamento.
services	services	array of object	Elenco di servizi con vantaggi e componenti disponibili per il trasferimento del dipendente.
isInPackage	services.isInPackage	boolean	Indica se il servizio è incluso nel pacchetto. Se un servizio non è incluso, un utente può richiederlo, ma potrebbe non essere coperto dall'organizzazione che fornisce lo spostamento.
UUID (Identificatore Unico Universale)	services.uuid	string	Identificatore univoco del servizio.
nome	services.name	string	Il nome del servizio.
tipoCategoria	services.categoryType	string	La categoria in cui rientra il servizio.
categoryTypeId	services.categoryTypeId	string	Identificatore univoco del tipo di categoria.
descrizione breve	services.shortDescription	string	Breve descrizione dei vantaggi offerti dal servizio.
longDescrizione	services.longDescription	string	Descrizione più lunga e dettagliata dei vantaggi offerti dal servizio.
providerType	services.providerType	string	Provider del servizio.
providerTypeId	services.providerTypeId	string	Identificatore univoco del provider.
nucleo	services.core	boolean	Indica se questo servizio è considerato core o non facoltativo.
cashOutOption	services.cashOutOption	boolean	Indica se il servizio supporta lo scambio del vantaggio per un importo in contanti.
cashOutPercentage	services.cashOutPercentage	integer	Definisce la percentuale del valore stimato del servizio ricevuto se contanti.
outOfPocket	services.outOfPocket	boolean	Indica se il servizio viene pagato in tasca dal dipendente che si trasferisce.
sequenza	services.sequence	integer	Sequenza di ordinamento che inserisce i servizi in un ordine più logico in base all'avvio.
iconUrl	services.iconUrl	string	URL della rete CDN Sirva per un'icona che rappresenta il servizio.
isIncluded	services.isIncluded	boolean	Indica se il servizio è attualmente incluso nel pacchetto.
masterServiceId	services.masterServiceId	string	Identificatore di rollup che collega le varianti dei servizi in un singolo elemento padre.
isService	services.isTravelService	boolean	Indica se si tratta di un servizio di viaggio.
useRemittance	services.useRemittance	boolean	Indica se è necessario utilizzare l'account di rimessa predefinito.
cashOutAmount	services.cashOutAmount	float	Definisce un valore flat per il servizio se la percentuale non è definita.
Benefici	services.benefits	array of object	Elenco dei vantaggi associati a questo servizio.
UUID (Identificatore Unico Universale)	services.benefits.uuid	string	Identificatore univoco del vantaggio.
nome	services.benefits.name	string	Nome del vantaggio.
outOfPocket	services.benefits.outOfPocket	boolean	Se l'indennità viene pagata in tasca dal dipendente che si trasferisce.
cashoutOption	services.benefits.cashoutOption	boolean	Se il vantaggio supporta un'opzione di pagamento in contanti.
cashoutPercentage	services.benefits.cashoutPercentage	integer	Definisce la percentuale del valore stimato del beneficio ricevuto se contanti.
cashoutAmount	services.benefits.cashoutAmount	float	Definisce un importo di cassa flat per il beneficio se una percentuale non è disponibile.
isIncluded	services.benefits.isIncluded	boolean	Definisce se il vantaggio è incluso nel pacchetto.
amountOptions	services.benefits.amountOptions	array of object	Elenco di opzioni di costo diverse per il vantaggio con configurazioni e valori diversi.
UUID (Identificatore Unico Universale)	services.benefits.amountOptions.uuid	string	Identificatore univoco dell'opzione di costo per il vantaggio.
unitType	services.benefits.amountOptions.unitType	string	Unità di misura.
unitTypeId	services.benefits.amountOptions.unitTypeId	string	Identificatore univoco per l'unità di misura.
condition	services.benefits.amountOptions.condition	string	Definisce le condizioni relative alla modalità di utilizzo di questa opzione.
conditionId	services.benefits.amountOptions.conditionId	string	Identificatore univoco della condizione.
quantità	services.benefits.amountOptions.quantity	float	Importo totale concesso dall'opzione.
costo	services.benefits.amountOptions.cost	float	Costo di questa opzione.
actualCashOut	services.benefits.amountOptions.actualCashOut	float	Il valore effettivo di cassa di questa opzione.
raccomandato	services.benefits.amountOptions.recommended	boolean	Indica che questa particolare opzione è consigliata da Sirva.
isSelected	services.benefits.amountOptions.isSelected	boolean	Indica se questa opzione è l'opzione selezionata o meno.
data di creazione	services.benefits.amountOptions.createdDate	string	Data di creazione dell'opzione.
commento	services.benefits.amountOptions.comment	string	Commenti aggiuntivi sull'opzione.
components	services.benefits.components	array of object	Elenco di componenti associati a questo elemento.
UUID (Identificatore Unico Universale)	services.benefits.components.uuid	string	Identificatore univoco del componente.
nome	services.benefits.components.name	string	Nome del componente.
componentType	services.benefits.components.componentType	string	Tipo del componente.
componentTypeId	services.benefits.components.componentTypeId	string	Identificatore univoco del componente.
options	services.benefits.components.options	array of object	Opzioni associate al componente.
UUID (Identificatore Unico Universale)	services.benefits.components.options.uuid	string	Identificatore univoco del componente.
value	services.benefits.components.options.value	string	Elemento associato al componente.
raccomandato	services.benefits.components.options.recommended	boolean	Se il componente è consigliato da Sirva
sequenza	services.benefits.components.options.sequence	integer	Sequenza di ordinamento per i componenti.
requestType	services.serviceRequest.requestType	string	Tipo di richiesta.
requestedDate	services.serviceRequest.requestedDate	string	Data di creazione della richiesta.
userId	services.serviceRequest.requestedBy.userId	string	ID dell'utente che effettua la richiesta.
posta elettronica	services.serviceRequest.requestedBy.email	string	Indirizzo di posta elettronica dell'utente che effettua la richiesta.
primo	services.serviceRequest.requestedBy.first	string	Nome dell'utente che effettua la richiesta.
ultimo	services.serviceRequest.requestedBy.last	string	Ultimo neame dell'utente che effettua la richiesta.
servicesAvailable	servicesAvailable	array of	Elenco dei servizi disponibili.
UUID (Identificatore Unico Universale)	policy.uuid	string	Identificatore univoco del criterio.
nome	policy.name	string	Nome associato al criterio.
client	policy.client	string	Client associato al criterio.
clientId	policy.clientId	string	Identificatore univoco del client associato al criterio.
currency	policy.currency	string	Valuta predefinita del criterio.
currencyId	policy.currencyId	string	Identificatore associato alla valuta.
version	policy.version	integer	Versione del criterio.
flexAmountCap	policy.flexAmountCap	integer	Se definito, rappresenta un limite logico per la quantità di servizi non principali che possono essere inclusi nei criteri.
data di entrata in vigore	policy.effectiveDate	string	Data di applicazione di questo criterio.
statusTypeId	policy.statusTypeId	string	Identificatore associato allo stato del criterio.
statusType	policy.statusType	string	Stato del criterio.
policyTypeId	policy.policyTypeId	string	Identificatore associato al tipo di criterio.
policyType	policy.policyType	string	Tipo di criterio.
preDecisione	policy.preDecision	boolean	Se il criterio è un criterio pre-decisionale, usato per determinare se lo spostamento verrà accettato.
completedDate	status.completedDate	string	Data in cui il pacchetto è stato completato da Sirva.
userId	status.completedBy.userId	string	Identificatore utente della persona che completa il pacchetto.
posta elettronica	status.completedBy.email	string	Indirizzo di posta elettronica dell'utente che completa il pacchetto.
primo	status.completedBy.first	string	Nome della persona che completa il pacchetto.
ultimo	status.completedBy.last	string	Cognome della persona che completa il pacchetto.
userId	status.modifiedBy.userId	string	ID utente dell'ultima persona per modificare il pacchetto.
posta elettronica	status.modifiedBy.email	string	Indirizzo di posta elettronica dell'utente che ha modificato il pacchetto.
primo	status.modifiedBy.first	string	Nome dell'utente che ha modificato il pacchetto.
ultimo	status.modifiedBy.last	string	Cognome dell'utente che ha modificato il pacchetto.
modifiedDate	status.modifiedDate	string	Data dell'ultima modifica del pacchetto.
isReadyForESC	isReadyForESC	boolean	Se il pacchetto è pronto per la modifica in scenari self-service.
packageOwnerShip	packageOwnerShip	string	Definisce chi ha le autorizzazioni per modificare il pacchetto.

Recuperare un elenco di spostamenti associati all'utente connesso

ID operazione:

GetRelocations

Recuperare un elenco di spostamenti associati all'utente connesso, inclusi gli spostamenti passati e presenti.

Restituisce

Nome	Percorso	Tipo	Descrizione
Rilocazioni	relocations	array of object	Elenco delle rilozioni a cui l'utente autenticato ha accesso. Le mosse passate e future vengono incluse se note.
rilocazioneId	relocations.relocationId	string	Identificatore univoco dello spostamento.
nome	relocations.firstName	string	Nome dell'utente connesso.
lastName	relocations.lastName	string	Nome dell'utente connesso.
transfereeFirstName	relocations.transfereeFirstName	string	Nome della persona che si trasferisce.
transfereeLastName	relocations.transfereeLastName	string	Cognome della persona che si trasferisce.
userAccountId	relocations.userAccountId	string	ID account dell'utente connesso.
departureCountry	relocations.departureCountry	string	Paese di partenza per il trasferimento.
departureCountryCode	relocations.departureCountryCode	string	Codice paese ISO della posizione di partenza del trasferimento.
departureState	relocations.departureState	string	Stato o prova della posizione di partenza.
departureCity	relocations.departureCity	string	Città della località di partenza.
destinationCountry	relocations.destinationCountry	string	Il paese in cui è stato trasferito.
destinationCountryCode	relocations.destinationCountryCode	string	Codice ISO del paese in cui viene trasferito.
destinationState	relocations.destinationState	string	Stato di destinazione in cui viene spostato.
destinationCity	relocations.destinationCity	string	Città di lavoro di destinazione in cui si trasferisce.
operativo	relocations.system	string	Sistema di origine di questo spostamento.
delegate	relocations.delegate	boolean	Indica se l'utente ha delegato l'accesso a questa rilocazione.
accesso	relocations.access	string	Indica il livello di accesso.
sourceSystemId	relocations.sourceSystemId	integer	ID piattaforma operativa, utile per il supporto.
estimatedStartDate	relocations.estimatedStartDate	string	Data di inizio stimata della rilocazione.
clientName	relocations.clientName	string	Nome del client associato alla rilocazione.
clientId	relocations.clientId	string	ID del client associato alla rilocazione.
posta elettronica	relocations.email	string	Messaggio di posta elettronica associato alla rilocazione.
linguaPreferita	relocations.preferredLanguage	string	Lingua preferita della persona trasferita.
programName	relocations.programName	string	Il programma di rilocazione è al di sotto del quale definisce i benefici.
isExpenseReceiptUploadRequired	relocations.isExpenseReceiptUploadRequired	boolean	Se i caricamenti delle ricevute sono necessari per le spese relative a questa rilocazione.
isMyDocumentsAccessEnabled	relocations.isMyDocumentsAccessEnabled	boolean	Se l'accesso ai documenti è consentito per questa rilocazione.
status	relocations.status	string	Stato della rilocazione. ACTIVE, CANCEL, CLOSED o ONHOLD.
estimatedEndDate	relocations.estimatedEndDate	string	Data di fine stimata della rilocazione. Se la rilocazione è permanente, questa operazione non verrà impostata.
isGovernmentClient	relocations.isGovernmentClient	boolean	Indica se la rilocazione è associata a un'entità governativa.
nome visualizzato	relocations.displayName	string	Valore visualizzato per lo spostamento che combina gli elementi di destinazione e di partenza.
isDPSClient	relocations.isDPSClient	boolean	Indica se la rilocazione usa la piattaforma di criteri digitali.
orgUid	relocations.orgUid	integer	ID organizzazione associato a questo spostamento. Utile per il supporto.
isTransitionFile	isTransitionFile	boolean	Indica se il file era già in corso con un'altra agenzia prima di essere spostato in Sirva.
isExpenseBudgetEnabled	isExpenseBudgetEnabled	boolean	Indica se la rilocazione è soggetta a budget di spesa specifici.
linguaPreferita	preferredLanguage	string	Lingua preferita dell'utente connesso.