Partilhar via


Sirva Realocação de Funcionário (Visualização)

Conecte-se à plataforma de portal de funcionários da Sirva Relocation para recuperar informações sobre suas realocações passadas e presentes. Este conector requer uma conta ativa com a Sirva Relocation para o nosso portal de funcionários (https://ee.sirva.com).

Este conector concede acesso para mover informações e permite que você busque informações de contato e disponibilidade de seu conselheiro pessoal. Você também pode buscar seu pacote de benefícios e subsídios relacionados para revisão e fazer perguntas sobre sua apólice.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Suporte de realocação Sirva
URL https://support.sirva.com
Email sirvacsc@sirva.com
Metadados do conector
Editora Recolocação de Sirva
Sítio Web https://www.sirva.com
Política de privacidade https://www.sirva.com/support/privacy-policy
Categorias Produtividade

Sirva realocando o conector de funcionários

O Sirva Connect + Transferee fornece um conector que permite que você busque informações sobre seus movimentos atuais, passados e presentes com o Sirva.

Pré-requisitos

Você precisará do seguinte para prosseguir:

  • Uma conta ativa com a Sirva Relocation

Se você tiver acesso à plataforma, receberá um e-mail com credenciais de login da Sirva.

Para que a autenticação Microsoft Entra funcione, o seu tenant deve estar mapeado para uma organização e o registo da aplicação deve estar configurado corretamente para aceder à API. Por favor, contacte o suporte da Sirva (https://support.sirva.com) para iniciar o processo.

Editora: Sirva Relocation

Operações suportadas

O conector suporta as seguintes operações:

  • Get Relocations: Lista as realocações às quais você tem acesso
  • Get Relocation Package: Recupera um pacote de benefícios para uma realocação específica
  • Get Counselor Contact Information: Recupera informações de contato do conselheiro para uma realocação, incluindo URLs para agendar reuniões
  • Ask the Sirva bot a question about a topic: Faz uma pergunta ao bot Sirva sobre a sua mudança

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Registo de candidaturas Microsoft Entra Inicie sessão usando um registo personalizado de uma aplicação Microsoft Entra Todas as regiões Não compartilhável
Conta Sirva Iniciar sessão via autenticação Sirva Todas as regiões Não compartilhável
Padrão [DEPRECATED] Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores. Todas as regiões Não compartilhável

Registo de candidaturas Microsoft Entra

ID de autenticação: aad-auth

Aplicável: Todas as regiões

Inicie sessão usando um registo personalizado de uma aplicação Microsoft Entra

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
ID do Cliente cadeia (de caracteres) O ID da Candidatura (Cliente) do seu Registo da Aplicação Entra ID Verdade
Segredo do Cliente securestring O Segredo do Cliente do Registo da Aplicação Entra ID Verdade

Conta Sirva

ID de autenticação: custom-app-auth

Aplicável: Todas as regiões

Iniciar sessão via autenticação Sirva

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Padrão [DEPRECATED]

Aplicável: Todas as regiões

Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Faça uma pergunta ao bot Sirva sobre um tópico

Envia o texto da pergunta para o bot de resposta do Sirva sobre o tópico selecionado e retorna com uma resposta

Obter informações de contato do conselheiro

Obtém o conselheiro designado para um movimento específico e suas informações de contato.

Recuperar uma lista de movimentos associados ao usuário conectado

Recupere uma lista de movimentos associados ao usuário conectado, incluindo movimentos passados e presentes.

Retreive o pacote de benefícios associado a uma mudança

Recuperar o pacote de benefícios associado a uma realocação específica, incluindo possíveis subsídios

Faça uma pergunta ao bot Sirva sobre um tópico

Envia o texto da pergunta para o bot de resposta do Sirva sobre o tópico selecionado e retorna com uma resposta

Parâmetros

Name Chave Necessário Tipo Description
RelocationId
RelocationId True string

O identificador exclusivo da mudança.

Pergunta a fazer ao bot
Query True string

Pergunta a fazer ao bot

O tema sobre o qual a pergunta trata
Topic True string

O tema sobre o qual a pergunta trata

Devoluções

Name Caminho Tipo Description
resposta
answer string

A resposta à questão colocada.

Obter informações de contato do conselheiro

Obtém o conselheiro designado para um movimento específico e suas informações de contato.

Parâmetros

Name Chave Necessário Tipo Description
Indica se a imagem do conselheiro deve ser recuperada
IncludePicture True boolean

Indica se a imagem deve ser buscada e incluída na resposta

O identificador exclusivo da mudança
RelocationId True string

O identificador exclusivo da mudança para devolver o conselheiro para

Devoluções

Name Caminho Tipo Description
nome
name string

O nome do conselheiro.

iniciais
initials string

As iniciais do conselheiro.

e-mail
email string

O endereço de e-mail do conselheiro.

phone
phone string

O número de telefone do conselheiro.

disponibilidade
availability string

A disponibilidade do conselheiro.

imagem
image string

A base64 JPEG do conselheiro. Não incluído se a imagem include estiver definida como false.

bookingUrl
bookingUrl string

Uma URL para o Microsoft Booking que pode ser usada para agendar uma chamada com o conselheiro.

userTime
userTime string

A hora no fuso horário em que o conselheiro está com informações de deslocamento.

contUID
contUID integer

O identificador do sistema central para o conselheiro.

fora do escritório
outOfOffice boolean

Indica se o conselheiro está fora do cargo.

outOfOfficeMessage
outOfOfficeMessage string

A mensagem de ausência temporária, se definida.

startTime
startTime string

A hora em que o conselheiro inicia o seu dia de trabalho.

endTime
endTime string

A hora em que o conselheiro termina o seu dia de trabalho.

Recuperar uma lista de movimentos associados ao usuário conectado

Recupere uma lista de movimentos associados ao usuário conectado, incluindo movimentos passados e presentes.

Devoluções

Name Caminho Tipo Description
Recolocações
relocations array of object

Uma lista de realocações às quais o usuário autenticado tem acesso. Movimentos passados e futuros são incluídos, se conhecidos.

relocationId
relocations.relocationId string

O identificador exclusivo da mudança.

primeiroNome
relocations.firstName string

O primeiro nome do usuário conectado.

sobrenome
relocations.lastName string

O primeiro nome do usuário conectado.

transfereeFirstName
relocations.transfereeFirstName string

O primeiro nome da pessoa que está a mudar.

transfereeSobrenome
relocations.transfereeLastName string

O apelido da pessoa que está a mudar.

userAccountId
relocations.userAccountId string

O ID da conta do usuário conectado.

País de partida
relocations.departureCountry string

O país de partida para a recolocação.

departureCountryCode
relocations.departureCountryCode string

Código ISO do local de partida da recolocação.

Estado de partida
relocations.departureState string

O estado ou provice do local de partida.

partidaCidade
relocations.departureCity string

A cidade do local de partida.

destinoPaís
relocations.destinationCountry string

O país para onde está a ser transferido.

destinationCountryCode
relocations.destinationCountryCode string

O código ISO do país para o qual está a ser transferido.

destinationState [en]
relocations.destinationState string

O estado de destino para o qual está sendo realocado.

destinoCidade
relocations.destinationCity string

A cidade de trabalho de destino para a qual está sendo realocada.

sistema
relocations.system string

O sistema de origem deste movimento.

delegado
relocations.delegate boolean

Indica se o usuário delegou acesso a essa realocação.

acesso
relocations.access string

Indica o nível de acesso.

sourceSystemId
relocations.sourceSystemId integer

O ID da plataforma operacional, útil para suporte.

estimatedStartDate
relocations.estimatedStartDate string

A data estimada de início da recolocação.

nome_do_cliente
relocations.clientName string

O nome do cliente associado à realocação.

clientId
relocations.clientId string

O ID do cliente associado à realocação.

e-mail
relocations.email string

O e-mail associado à realocação.

linguagemPreferida
relocations.preferredLanguage string

A língua preferida da pessoa que está a ser recolocada.

nomedoprograma
relocations.programName string

O programa de realocação é sob o qual define benefícios.

isExpenseReceiptUploadRequired
relocations.isExpenseReceiptUploadRequired boolean

Se forem necessários carregamentos de recibos para relatórios de despesas sobre esta realocação.

isMyDocumentsAccessEnabled
relocations.isMyDocumentsAccessEnabled boolean

Se o acesso ao documento for permitido para essa realocação.

estado
relocations.status string

O status da recolocação. ATIVO, CANCELAR, FECHADO ou EM espera.

estimatedEndDate
relocations.estimatedEndDate string

A data prevista para o fim da recolocação. Se a recolocação for permanente, esta não será definida.

isGovernmentClient
relocations.isGovernmentClient boolean

Indica se a realocação está associada a uma entidade governamental.

nome de exibição
relocations.displayName string

Um valor de exibição para a movimentação que compõe os elementos de destino e partida.

isDPSClient
relocations.isDPSClient boolean

Indica se a realocação está usando a plataforma de política digital.

orgUid
relocations.orgUid integer

O ID da organização associado a essa movimentação. Útil para suporte.

isTransitionFile
isTransitionFile boolean

Indica se este arquivo já estava em andamento com outra agência antes de ser movido para Sirva.

isExpenseBudgetEnabled
isExpenseBudgetEnabled boolean

Indica se a realocação está sujeita a orçamentos de despesas específicos.

linguagemPreferida
preferredLanguage string

O idioma preferido do usuário conectado.

Retreive o pacote de benefícios associado a uma mudança

Recuperar o pacote de benefícios associado a uma realocação específica, incluindo possíveis subsídios

Parâmetros

Name Chave Necessário Tipo Description
O identificador único da recolocação
RelocationId True string

O identificador exclusivo da movimentação para puxar o pacote para

Devoluções

Name Caminho Tipo Description
estáIniciado
isStarted boolean

Indica se o pacote foi iniciado para ser preparado.

isCompleto
isComplete boolean

Indica se o pacote foi concluído.

isAceito
isAccepted boolean

Indica se o pacote foi aceito.

readyForNeedsAnalysis
readyForNeedsAnalysis boolean

Indica se o pacote está pronto para a tarefa de análise de necessidades a ser emitida.

Subsídios
allowances array of object

Uma série de subsídios disponíveis e selecionados para os quais o funcionário que se muda é elegível.

Identificador Único Universal (UUID)
allowances.uuid string

O identificador único da licença.

nome
allowances.name string

Informações sobre para que serve o subsídio.

montanteIdentificadoAtConsultation
allowances.amountIdentifiedAtConsultation boolean

Indica se o montante do subsídio é identificado pelo cousnselor durante a chamada inicial da prestação.

allowances.amount float

O montante do subsídio, se identificado.

moeda
allowances.currency string

O código ISO da moeda em que o subsídio deve ser pago.

currencyId
allowances.currencyId string

O ID interno da moeda.

tipoDeCategoria
allowances.categoryType string

A categoria a que o subsídio está associado.

categoryTypeId
allowances.categoryTypeId string

O identificador interno da categoria.

occurrenceType
allowances.occurrenceType string

A frequência com que o subsídio é pago.

occurrenceTypeId
allowances.occurrenceTypeId string

O identificador interno da frequência.

paidByType
allowances.paidByType string

A organização que paga o subsídio ao funcionário que se desloca.

paidByTypeId
allowances.paidByTypeId string

O identificador interno para o pago por tipo.

isSelected
allowances.isSelected boolean

Indica se o subsídio foi incluído no pacote de benefícios.

userId
allowances.paymentRequest.requestedBy.userId string

O ID de utilizador associado ao pedido de pagamento.

e-mail
allowances.paymentRequest.requestedBy.email string

O endereço de e-mail do usuário solicitando o pagamento.

primeiro
allowances.paymentRequest.requestedBy.first string

O primeiro nome do usuário que solicita o pagamento.

último
allowances.paymentRequest.requestedBy.last string

O sobrenome do usuário que solicita o pagamento.

Data solicitada
allowances.paymentRequest.requestedDate string

A data solicitada para o pagamento do subsídio.

Método de remessa
allowances.paymentRequest.remittanceMethod string

O método de remessa para o pagamento do subsídio.

remittanceAccount
allowances.paymentRequest.remittanceAccount string

A conta bancária para a qual o pagamento deve ser efetuado.

services
services array of object

Uma lista de serviços com benefícios e componentes que estão disponíveis para o funcionário que está mudando.

isInPackage
services.isInPackage boolean

Indica se o serviço está incluído no pacote. Se um serviço não estiver incluído, um usuário pode solicitá-lo, mas ele pode não ser coberto pela organização que fornece a mudança.

Identificador Único Universal (UUID)
services.uuid string

O identificador exclusivo do serviço.

nome
services.name string

O nome do serviço.

tipoDeCategoria
services.categoryType string

A categoria em que o serviço se enquadra.

categoryTypeId
services.categoryTypeId string

O identificador exclusivo do tipo de categoria.

breveDescrição
services.shortDescription string

Uma breve descrição dos benefícios proporcionados pelo serviço.

longDescrição
services.longDescription string

Uma descrição mais longa e detalhada dos benefícios proporcionados pelo serviço.

Tipo de provedor
services.providerType string

O prestador do serviço.

providerTypeId
services.providerTypeId string

O identificador exclusivo do provedor.

núcleo
services.core boolean

Indica se esse serviço é considerado essencial ou não opcional.

cashOutOpção
services.cashOutOption boolean

Indica se o serviço suporta a troca do benefício por um valor em dinheiro.

levantamentoPercentagem
services.cashOutPercentage integer

Define a percentagem do valor estimado do serviço que é recebido se levantado.

outOfPocket
services.outOfPocket boolean

Indica se o serviço está sendo pago do próprio bolso pelo funcionário realocado.

sequência
services.sequence integer

Uma sequência de classificação que coloca os serviços em uma ordem mais lógica com base em quando eles começam.

iconUrl
services.iconUrl string

Um URL para a CDN do Sirva para um ícone que representa o serviço.

isIncluído
services.isIncluded boolean

Indica se o serviço está atualmente incluído no pacote.

masterServiceId
services.masterServiceId string

Um identificador de roll-up que une variações de serviços sob um único pai.

isTravelService
services.isTravelService boolean

Indica se este é um serviço de viagem.

useRemessa
services.useRemittance boolean

Indica se a conta de remessa padrão deve ser usada.

levantamentoMontante
services.cashOutAmount float

Define um valor fixo para o serviço se a porcentagem não estiver definida.

Benefícios
services.benefits array of object

Uma lista de benefícios associados a este serviço.

Identificador Único Universal (UUID)
services.benefits.uuid string

O identificador único do benefício.

nome
services.benefits.name string

O nome do benefício.

outOfPocket
services.benefits.outOfPocket boolean

Se o benefício está sendo pago do próprio bolso pelo funcionário que está se mudando.

cashoutOpção
services.benefits.cashoutOption boolean

Se o benefício suportar uma opção de levantamento.

levantamentoPercentagem
services.benefits.cashoutPercentage integer

Define a percentagem do valor estimado da prestação que é recebida se for levantada.

levantamentoMontante
services.benefits.cashoutAmount float

Define um valor fixo de levantamento para o benefício se uma percentagem não estiver disponível.

isIncluído
services.benefits.isIncluded boolean

Define se o benefício está incluído no pacote.

montanteOpções
services.benefits.amountOptions array of object

Uma lista de diferentes opções de cálculo de custos para o benefício com diferentes configurações e valores.

Identificador Único Universal (UUID)
services.benefits.amountOptions.uuid string

O identificador único da opção de cálculo de custos para o benefício.

tipo de unidade
services.benefits.amountOptions.unitType string

A unidade de medida.

unitTypeId
services.benefits.amountOptions.unitTypeId string

O identificador único da unidade de medida.

condition
services.benefits.amountOptions.condition string

Define quaisquer condições sobre a forma como esta opção é usada.

condiçãoId
services.benefits.amountOptions.conditionId string

O identificador exclusivo da condição.

quantidade
services.benefits.amountOptions.quantity float

O montante total concedido pela opção.

custo
services.benefits.amountOptions.cost float

O custo desta opção.

actualCashOut
services.benefits.amountOptions.actualCashOut float

O valor real de saque desta opção.

recomendado
services.benefits.amountOptions.recommended boolean

Indica que esta opção em particular é recomendada pela Sirva.

isSelected
services.benefits.amountOptions.isSelected boolean

Indica se esta opção é a opção selecionada ou não.

createdDate (Data de criação)
services.benefits.amountOptions.createdDate string

A data de criação da opção.

comentário
services.benefits.amountOptions.comment string

Comentários adicionais sobre a opção.

components
services.benefits.components array of object

Uma lista de componentes associados a este item.

Identificador Único Universal (UUID)
services.benefits.components.uuid string

O identificador exclusivo do componente.

nome
services.benefits.components.name string

O nome do componente.

componentType
services.benefits.components.componentType string

O tipo do componente.

componentTypeId
services.benefits.components.componentTypeId string

O identificador exclusivo do componente.

options
services.benefits.components.options array of object

Opções associadas ao componente.

Identificador Único Universal (UUID)
services.benefits.components.options.uuid string

O identificador exclusivo do componente.

valor
services.benefits.components.options.value string

Um item associado ao componente.

recomendado
services.benefits.components.options.recommended boolean

Se o componente for recomendado pela Sirva

sequência
services.benefits.components.options.sequence integer

Uma sequência de classificação para os componentes.

requestType [en]
services.serviceRequest.requestType string

O tipo de pedido.

Data solicitada
services.serviceRequest.requestedDate string

A data em que o pedido foi feito.

userId
services.serviceRequest.requestedBy.userId string

O ID do usuário que faz a solicitação.

e-mail
services.serviceRequest.requestedBy.email string

O endereço de e-mail do usuário que faz a solicitação.

primeiro
services.serviceRequest.requestedBy.first string

O primeiro nome do usuário que faz a solicitação.

último
services.serviceRequest.requestedBy.last string

O último neame do usuário que faz a solicitação.

serviçosDisponível
servicesAvailable array of

Uma lista de serviços disponíveis.

Identificador Único Universal (UUID)
policy.uuid string

O identificador exclusivo da política.

nome
policy.name string

O nome associado à política.

cliente
policy.client string

O cliente associado à política.

clientId
policy.clientId string

O identificador exclusivo do cliente associado à política.

moeda
policy.currency string

A moeda padrão da política.

currencyId
policy.currencyId string

O identificador associado à moeda.

versão
policy.version integer

A versão da política.

flexAmountCap
policy.flexAmountCap integer

Se definido, representa um limite lógico para a quantidade de serviços não essenciais que podem ser incluídos na política.

Data de entrada em vigor
policy.effectiveDate string

A data em que esta política entrou em vigor.

statusTypeId
policy.statusTypeId string

O identificador associado ao status da política.

statusType
policy.statusType string

O status da política.

policyTypeId
policy.policyTypeId string

O identificador associado ao tipo da política.

policyType
policy.policyType string

O tipo da política.

pré-decisão
policy.preDecision boolean

Se a política for uma política de pré-decisão, usada para determinar se a mudança será aceita.

completedDate
status.completedDate string

A data em que o pacote foi concluído por Sirva.

userId
status.completedBy.userId string

O identificador de usuário da pessoa que conclui o pacote.

e-mail
status.completedBy.email string

O endereço de e-mail do usuário que está completando o pacote.

primeiro
status.completedBy.first string

O primeiro nome da pessoa que completa o pacote.

último
status.completedBy.last string

O sobrenome da pessoa que preenche o pacote.

userId
status.modifiedBy.userId string

O ID de usuário da última pessoa a modificar o pacote.

e-mail
status.modifiedBy.email string

O endereço de e-mail do usuário que modificou o pacote.

primeiro
status.modifiedBy.first string

O primeiro nome do usuário que modificou o pacote.

último
status.modifiedBy.last string

O sobrenome do usuário que modificou o pacote.

modifiedDate
status.modifiedDate string

A data em que o pacote foi modificado pela última vez.

isReadyForESC
isReadyForESC boolean

Se o pacote estiver pronto, a modificação em cenários de autoatendimento.

pacoteOwnerShip
packageOwnerShip string

Define quem tem permissões para modificar o pacote.