Compartir a través de


Relocalización de empleado (versión preliminar)

Conéctese a la plataforma del portal de empleados de Sirva Relocation para recuperar información sobre sus reubicaciones pasadas y presentes. Este conector requiere una cuenta activa con Sirva Relocation para nuestro portal de empleados (https://ee.sirva.com).

Este conector concede acceso a la información de movimiento y le permite capturar información de contacto y disponibilidad de su consejero personal. También puede capturar el paquete de beneficios y las asignaciones relacionadas para revisar y formular preguntas sobre su directiva.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Soporte técnico de reubicación de Sirva
URL https://support.sirva.com
Correo Electrónico sirvacsc@sirva.com
Metadatos del conector
Publicador Reubicación de Sirva
Sitio web https://www.sirva.com
Directiva de privacidad https://www.sirva.com/support/privacy-policy
Categorías Productividad

Relocalización del conector de empleados

Sirva Connect+ Transferee proporciona un conector que permite capturar información sobre los movimientos actuales, pasados y presentes con Sirva.

Prerrequisitos

Necesitará lo siguiente para continuar:

  • Una cuenta activa con Sirva Relocation

Si tiene acceso a la plataforma, recibirá un correo electrónico con credenciales de inicio de sesión de Sirva.

Para que la autenticación de Microsoft Entra funcione, el inquilino debe asignarse a una organización y un registro de aplicación debe configurarse correctamente para acceder a la API. Póngase en contacto con el soporte técnico de Sirva (https://support.sirva.com) para comenzar el proceso.

Publicador: Sirva Relocation

Operaciones admitidas

El conector admite las siguientes operaciones:

  • Get Relocations: enumera las reubicaciones a las que tiene acceso.
  • Get Relocation Package: recupera un paquete de beneficios para una reubicación específica.
  • Get Counselor Contact Information: recupera la información de contacto del consejero para una reubicación, incluidas las direcciones URL para reservar reuniones.
  • Ask the Sirva bot a question about a topic: formula al bot de Sirva una pregunta sobre el traslado.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Registro de aplicaciones de Microsoft Entra Inicio de sesión con un registro de aplicación personalizado de Microsoft Entra Todas las regiones No se puede compartir
Cuenta de Sirva Inicio de sesión a través de la autenticación de Sirva Todas las regiones No se puede compartir
Valor predeterminado [EN DESUSO] Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores. Todas las regiones No se puede compartir

Registro de una aplicación de Microsoft Entra

Identificador de autenticación: aad-auth

Aplicable: Todas las regiones

Inicio de sesión con un registro de aplicación personalizado de Microsoft Entra

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Id. de cliente cuerda / cadena El identificador de aplicación (cliente) del registro de la aplicación entra ID Cierto
Secreto del cliente securestring El secreto de cliente del registro de la aplicación Entra ID Cierto

Cuenta de Sirva

Identificador de autenticación: custom-app-auth

Aplicable: Todas las regiones

Inicio de sesión a través de la autenticación de Sirva

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Valor predeterminado [EN DESUSO]

Aplicable: Todas las regiones

Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Obtener información de contacto del consejero

Obtiene el consejero asignado a un movimiento específico y su información de contacto.

Pregunte al bot de Sirva una pregunta sobre un tema

Envía texto de pregunta al bot de respuesta de Sirva sobre el tema seleccionado y devuelve con una respuesta.

Recuperar el paquete de ventajas asociado a un movimiento

Recuperar el paquete de beneficios asociado a una reubicación específica, incluidas posibles asignaciones

Recuperar una lista de movimientos asociados al usuario que ha iniciado sesión

Recupere una lista de movimientos asociados al usuario que ha iniciado sesión, incluidos los movimientos pasados y presentes.

Obtener información de contacto del consejero

Obtiene el consejero asignado a un movimiento específico y su información de contacto.

Parámetros

Nombre Clave Requerido Tipo Description
Indica si se debe recuperar la imagen del consejero.
IncludePicture True boolean

Indica si la imagen se debe capturar e incluir en la respuesta.

Identificador único del movimiento
RelocationId True string

Identificador único del traslado para devolver al consejero

Devoluciones

Nombre Ruta de acceso Tipo Description
nombre
name string

Nombre del consejero.

Iniciales
initials string

Las iniciales del consejero.

Correo electrónico
email string

Dirección de correo electrónico del consejero.

phone
phone string

Número de teléfono del consejero.

availability
availability string

La disponibilidad del consejero.

image
image string

Un JPEG base64 del consejero. No se incluye si la imagen de inclusión está establecida en false.

bookingUrl
bookingUrl string

Dirección URL de Microsoft Booking que se puede usar para programar una llamada con el consejero.

userTime
userTime string

La hora en la zona horaria en la que está el consejero con información de desplazamiento.

contUID
contUID integer

Identificador principal del sistema para el consejero.

outOfOffice
outOfOffice boolean

Indica si el consejero está fuera de la oficina.

outOfOfficeMessage
outOfOfficeMessage string

Mensaje fuera de la oficina si se establece.

startTime
startTime string

La hora a la que el consejero comienza su día laboral.

endTime
endTime string

El momento en que el consejero termina su día laboral.

Pregunte al bot de Sirva una pregunta sobre un tema

Envía texto de pregunta al bot de respuesta de Sirva sobre el tema seleccionado y devuelve con una respuesta.

Parámetros

Nombre Clave Requerido Tipo Description
RelocationId
RelocationId True string

Identificador único del movimiento.

Pregunta para formular el bot
Query True string

Pregunta para formular el bot

El tema sobre el que se trata
Topic True string

El tema sobre el que se trata

Devoluciones

Nombre Ruta de acceso Tipo Description
respuesta
answer string

La respuesta a la pregunta planteada.

Recuperar el paquete de ventajas asociado a un movimiento

Recuperar el paquete de beneficios asociado a una reubicación específica, incluidas posibles asignaciones

Parámetros

Nombre Clave Requerido Tipo Description
El identificador único de la reubicación
RelocationId True string

Identificador único del movimiento para el que se va a extraer el paquete

Devoluciones

Nombre Ruta de acceso Tipo Description
isStarted
isStarted boolean

Indica si el paquete se ha iniciado para estar preparado.

isComplete
isComplete boolean

Indica si el paquete se ha completado.

isAccepted
isAccepted boolean

Indica si se ha aceptado el paquete.

readyForNeedsAnalysis
readyForNeedsAnalysis boolean

Indica si el paquete está listo para que se emita la tarea de análisis de necesidades.

Asignaciones
allowances array of object

Matriz de asignaciones disponibles y seleccionadas para las que el empleado de reubicación es elegible.

Identificador Único Universal (UUID)
allowances.uuid string

Identificador único de la asignación.

nombre
allowances.name string

Información sobre lo que es la asignación.

amountIdentifiedAtConsultation
allowances.amountIdentifiedAtConsultation boolean

Indica si el cousnselor identifica el importe de la asignación durante la llamada de beneficio inicial.

allowances.amount float

Importe de la asignación si se identifica.

divisa
allowances.currency string

Código ISO de la moneda en la que se va a pagar la asignación.

currencyId
allowances.currencyId string

Identificador interno de la moneda.

tipoDeCategoría
allowances.categoryType string

Categoría a la que está asociada la asignación.

categoryTypeId
allowances.categoryTypeId string

Identificador interno de la categoría.

occurrenceType
allowances.occurrenceType string

Frecuencia en la que se paga la asignación.

occurrenceTypeId
allowances.occurrenceTypeId string

Identificador interno de la frecuencia.

paidByType
allowances.paidByType string

La organización pagando la asignación al empleado de reubicación.

paidByTypeId
allowances.paidByTypeId string

Identificador interno del objeto pagado por tipo.

isSelected
allowances.isSelected boolean

Indica si la asignación se ha incluido en el paquete de beneficios.

userId
allowances.paymentRequest.requestedBy.userId string

Identificador de usuario asociado a la solicitud de pago.

Correo electrónico
allowances.paymentRequest.requestedBy.email string

Dirección de correo electrónico del usuario que solicita el pago.

Primero
allowances.paymentRequest.requestedBy.first string

Nombre del usuario que solicita el pago.

último
allowances.paymentRequest.requestedBy.last string

Apellido del usuario que solicita el pago.

requestedDate
allowances.paymentRequest.requestedDate string

Fecha en la que se solicitó pagar la asignación.

remittanceMethod
allowances.paymentRequest.remittanceMethod string

Método de envío para pagar la asignación.

account
allowances.paymentRequest.remittanceAccount string

Cuenta bancaria a la que se va a realizar el pago.

services
services array of object

Una lista de servicios con ventajas y componentes que están disponibles para el empleado de reubicación.

isInPackage
services.isInPackage boolean

Indica si el servicio se incluye en el paquete. Si no se incluye un servicio, un usuario puede solicitarlo, pero es posible que no esté cubierto por la organización que proporciona el traslado.

Identificador Único Universal (UUID)
services.uuid string

Identificador único del servicio.

nombre
services.name string

El nombre del servicio.

tipoDeCategoría
services.categoryType string

La categoría en la que se encuentra el servicio.

categoryTypeId
services.categoryTypeId string

Identificador único del tipo de categoría.

descripción breve
services.shortDescription string

Una breve descripción de las ventajas proporcionadas por el servicio.

longDescription
services.longDescription string

Una descripción más larga y detallada de las ventajas proporcionadas por el servicio.

providerType
services.providerType string

Proveedor del servicio.

providerTypeId
services.providerTypeId string

Identificador único del proveedor.

núcleo
services.core boolean

Indica si este servicio se considera básico o no opcional.

cashOutOption
services.cashOutOption boolean

Indica si el servicio admite el intercambio del beneficio por un importe en efectivo.

cashOutPercentage
services.cashOutPercentage integer

Define el porcentaje del valor estimado del servicio que se recibe si se recibe en efectivo.

outOfPocket
services.outOfPocket boolean

Indica si el servicio se paga por el bolsillo por el empleado de reubicación.

secuencia
services.sequence integer

Secuencia de ordenación que coloca los servicios en un orden más lógico en función de cuándo se inician.

iconUrl
services.iconUrl string

Dirección URL de la red CDN de Sirva para un icono que representa el servicio.

isIncluded
services.isIncluded boolean

Indica si el servicio está incluido actualmente en el paquete.

masterServiceId
services.masterServiceId string

Identificador acumulativo que vincula las variaciones de los servicios en un único elemento primario.

isAdvisorService
services.isTravelService boolean

Indica si se trata de un servicio de viaje.

useRemittance
services.useRemittance boolean

Indica si se debe usar la cuenta de envío predeterminada.

cashOutAmount
services.cashOutAmount float

Define un valor plano para el servicio si no se define el porcentaje.

Beneficios
services.benefits array of object

Lista de ventajas asociadas a este servicio.

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

Identificador único de la ventaja.

nombre
services.benefits.name string

Nombre de la ventaja.

outOfPocket
services.benefits.outOfPocket boolean

Si el empleado de reubicación paga el beneficio por el bolsillo.

cashoutOption
services.benefits.cashoutOption boolean

Si la ventaja admite una opción de efectivo.

cashoutPercentage
services.benefits.cashoutPercentage integer

Define el porcentaje del valor estimado de la ventaja que se recibe si se cobra en efectivo.

cashoutAmount
services.benefits.cashoutAmount float

Define un importe de efectivo plano para el beneficio si un porcentaje no está disponible.

isIncluded
services.benefits.isIncluded boolean

Define si la ventaja se incluye en el paquete.

amountOptions
services.benefits.amountOptions array of object

Una lista de diferentes opciones de costo para la ventaja con diferentes configuraciones y valores.

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

Identificador único de la opción de costo para la ventaja.

unitType
services.benefits.amountOptions.unitType string

Unidad de medida.

unitTypeId
services.benefits.amountOptions.unitTypeId string

Identificador único de la unidad de medida.

condition
services.benefits.amountOptions.condition string

Define las condiciones sobre cómo se usa esta opción.

conditionId
services.benefits.amountOptions.conditionId string

Identificador único de la condición.

quantity
services.benefits.amountOptions.quantity float

Importe total concedido por la opción .

costo
services.benefits.amountOptions.cost float

Costo de esta opción.

actualCashOut
services.benefits.amountOptions.actualCashOut float

Valor real de efectivo de esta opción.

recomendado
services.benefits.amountOptions.recommended boolean

Indica que sirve recomienda esta opción concreta.

isSelected
services.benefits.amountOptions.isSelected boolean

Indica si esta opción es la opción seleccionada o no.

fecha de creación
services.benefits.amountOptions.createdDate string

Fecha de creación de la opción.

comentario
services.benefits.amountOptions.comment string

Comentarios adicionales sobre la opción.

components
services.benefits.components array of object

Lista de componentes asociados a este elemento.

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

Identificador único del componente.

nombre
services.benefits.components.name string

Nombre del componente.

componentType
services.benefits.components.componentType string

Tipo del componente.

componentTypeId
services.benefits.components.componentTypeId string

Identificador único del componente.

options
services.benefits.components.options array of object

Opciones asociadas al componente.

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

Identificador único del componente.

value
services.benefits.components.options.value string

Elemento asociado al componente.

recomendado
services.benefits.components.options.recommended boolean

Si sirve recomienda el componente

secuencia
services.benefits.components.options.sequence integer

Secuencia de ordenación para los componentes.

requestType
services.serviceRequest.requestType string

Tipo de solicitud.

requestedDate
services.serviceRequest.requestedDate string

Fecha en que se realizó la solicitud.

userId
services.serviceRequest.requestedBy.userId string

Identificador del usuario que realiza la solicitud.

Correo electrónico
services.serviceRequest.requestedBy.email string

Dirección de correo electrónico del usuario que realiza la solicitud.

Primero
services.serviceRequest.requestedBy.first string

Nombre del usuario que realiza la solicitud.

último
services.serviceRequest.requestedBy.last string

El último neame del usuario que realiza la solicitud.

servicesAvailable
servicesAvailable array of

Lista de servicios disponibles.

Identificador Único Universal (UUID)
policy.uuid string

Identificador único de la directiva.

nombre
policy.name string

Nombre asociado a la directiva.

client
policy.client string

Cliente asociado a la directiva.

clientId
policy.clientId string

Identificador único del cliente asociado a la directiva.

divisa
policy.currency string

Moneda predeterminada de la directiva.

currencyId
policy.currencyId string

Identificador asociado a la moneda.

version
policy.version integer

Versión de la directiva.

flexAmountCap
policy.flexAmountCap integer

Si se define, representa un límite lógico en la cantidad de servicios no principales que se pueden incluir en la directiva.

Fecha de entrada en vigor
policy.effectiveDate string

Fecha en que esta directiva entró en vigor.

statusTypeId
policy.statusTypeId string

Identificador asociado al estado de la directiva.

statusType
policy.statusType string

Estado de la directiva.

policyTypeId
policy.policyTypeId string

Identificador asociado al tipo de la directiva.

policyType
policy.policyType string

Tipo de la directiva.

preDecision
policy.preDecision boolean

Si la directiva es una directiva de decisión previa, se usa para determinar si se aceptará el traslado.

completedDate
status.completedDate string

Fecha en que el paquete se completó con Sirva.

userId
status.completedBy.userId string

Identificador de usuario de la persona que completa el paquete.

Correo electrónico
status.completedBy.email string

Dirección de correo electrónico del usuario que completa el paquete.

Primero
status.completedBy.first string

Nombre de la persona que completa el paquete.

último
status.completedBy.last string

Apellido de la persona que completa el paquete.

userId
status.modifiedBy.userId string

Identificador de usuario de la última persona para modificar el paquete.

Correo electrónico
status.modifiedBy.email string

Dirección de correo electrónico del usuario que modificó el paquete.

Primero
status.modifiedBy.first string

Nombre del usuario que modificó el paquete.

último
status.modifiedBy.last string

Apellido del usuario que modificó el paquete.

modifiedDate
status.modifiedDate string

Fecha en que se modificó por última vez el paquete.

isReadyForESC
isReadyForESC boolean

Si el paquete está listo para modificarse en escenarios de autoservicio.

packageOwnerShip
packageOwnerShip string

Define quién tiene permisos para modificar el paquete.

Recuperar una lista de movimientos asociados al usuario que ha iniciado sesión

Recupere una lista de movimientos asociados al usuario que ha iniciado sesión, incluidos los movimientos pasados y presentes.

Devoluciones

Nombre Ruta de acceso Tipo Description
Reubicaciones
relocations array of object

Lista de reubicaciones a las que tiene acceso el usuario autenticado. Los movimientos pasados y futuros se incluyen si se conocen.

relocationId
relocations.relocationId string

Identificador único del movimiento.

firstName
relocations.firstName string

Nombre del usuario que ha iniciado sesión.

lastName
relocations.lastName string

Nombre del usuario que ha iniciado sesión.

transfereeFirstName
relocations.transfereeFirstName string

Nombre de la persona que se va a localizar.

transfereeLastName
relocations.transfereeLastName string

Apellido de la persona que se va a localizar.

userAccountId
relocations.userAccountId string

Identificador de cuenta del usuario que ha iniciado sesión.

departureCountry
relocations.departureCountry string

El país de salida para la reubicación.

departureCountryCode
relocations.departureCountryCode string

Código de país ISO de la ubicación de salida de la reubicación.

departureState
relocations.departureState string

Estado o provice de la ubicación de salida.

departureCity
relocations.departureCity string

La ciudad de la ubicación de salida.

destinationCountry
relocations.destinationCountry string

El país al que se va a reubicar.

destinationCountryCode
relocations.destinationCountryCode string

Código ISO del país al que se va a reubicar.

destinationState
relocations.destinationState string

Estado de destino al que se va a reubicar.

destinationCity
relocations.destinationCity string

Ciudad de trabajo de destino a la que se va a reubicar.

system
relocations.system string

Sistema de origen de este movimiento.

delegate
relocations.delegate boolean

Indica si el usuario ha delegado el acceso a esta reubicación.

acceso
relocations.access string

Indica el nivel de acceso.

sourceSystemId
relocations.sourceSystemId integer

El identificador de la plataforma operativa, útil para la compatibilidad.

estimatedStartDate
relocations.estimatedStartDate string

Fecha estimada de inicio de la reubicación.

clientName
relocations.clientName string

Nombre del cliente asociado a la reubicación.

clientId
relocations.clientId string

Identificador del cliente asociado a la reubicación.

Correo electrónico
relocations.email string

El correo electrónico asociado a la reubicación.

preferredLanguage
relocations.preferredLanguage string

Idioma preferido de la persona que se va a reubicar.

programName
relocations.programName string

El programa en el que se define la reubicación.

isExpenseReceiptUploadRequired
relocations.isExpenseReceiptUploadRequired boolean

Si se requieren cargas de recibos para los informes de gastos sobre esta reubicación.

isMyDocumentsAccessEnabled
relocations.isMyDocumentsAccessEnabled boolean

Si se permite el acceso a documentos para esta reubicación.

estado
relocations.status string

El estado de la reubicación. ACTIVE, CANCEL, CLOSED o ONHOLD.

estimatedEndDate
relocations.estimatedEndDate string

Fecha estimada de finalización de la reubicación. Si la reubicación es permanente, no se establecerá.

isGovernmentClient
relocations.isGovernmentClient boolean

Indica si la reubicación está asociada a una entidad gubernamental.

Nombre para mostrar
relocations.displayName string

Valor para mostrar del movimiento que combina los elementos de destino y salida.

isDPSClient
relocations.isDPSClient boolean

Indica si la reubicación usa la plataforma de directivas digitales.

orgUid
relocations.orgUid integer

Identificador de organización asociado a este movimiento. Útil para el soporte técnico.

isTransitionFile
isTransitionFile boolean

Indica si este archivo ya estaba en curso con otra agencia antes de moverse a Sirva.

isExpenseBudgetEnabled
isExpenseBudgetEnabled boolean

Indica si la reubicación está sujeta a presupuestos de gastos específicos.

preferredLanguage
preferredLanguage string

Idioma preferido del usuario que ha iniciado sesión.