Este artículo te ayudará a prepararte para integrar tus dos integraciones SCIM actuales —TravelPerk SCIM para viajes y Yokoy SCIM para gastos— en una única integración SCIM de Perk. Explica cómo se compara tu configuración actual con el nuevo modelo, para que puedas recopilar información precisa sobre tu configuración SCIM y compartirla con tu contacto de Perk.
Antes de empezar
Hoy, ejecutas dos integraciones SCIM separadas en paralelo: TravelPerk SCIM proporciona a los usuarios para viajar y Yokoy SCIM Proporciona a los usuarios información sobre gastos y desembolsos. Perk ha unificado ambos en un único Perk SCIM Integración que abarca viajes y gastos en conjunto, a través de una única conexión con su proveedor de identidad, ya sea Okta, Azure AD (Entra ID) o una integración API directa y personalizada. Usted mismo realiza el cambio de configuración en su proveedor de identidad; el equipo de Perk no lo hace por usted. Antes de hacerlo, su contacto de Perk revisará su configuración actual de TravelPerk SCIM y Yokoy SCIM y le indicará exactamente qué configurar en Perk SCIM. El objetivo de este artículo es ayudarle a comprender las diferencias entre su configuración actual y el nuevo modelo para que pueda compartir información precisa y útil con su contacto de Perk. No le guiará directamente a través de los pasos de configuración del proveedor de identidad; esa guía la proporciona Perk tras revisar la información que usted comparte.
Comparación de tu configuración actual con la nueva Perk SCIM
TravelPerk SCIM, su integración actual del lado de los viajes, se traslada a Perk SCIM casi sin cambios. TravelPerk SCIM utiliza el esquema central de SCIM, la extensión empresarial (urn:ietf:params:scim:schemas:extension:enterprise:2.0:User), y una extensión Perk personalizada (urn:ietf:params:scim:schemas:extension:travelperk:2.0:User) para campos específicos de viajes como travelPolicy, perfiles de facturay lineManagerEmail. Perk SCIM mantiene este mismo esquema central, la misma extensión empresarial y la misma extensión Perk personalizada, por lo que la mayor parte de su asignación de atributos existente para viajes no necesita cambiar. La parte realmente nueva es la extensión de gastos (urn:ietf:params:scim:schemas:extension:expense:2.0:UserTravelPerk SCIM nunca tuvo esta extensión, porque la gestión de gastos no formaba parte de ella. Perk SCIM la agrega específicamente para cubrir todo lo que su integración con Yokoy SCIM maneja actualmente para los gastos, como políticas de gastos, entidades legales y umbrales de aprobación. La extensión de gastos de Perk se basa en la misma lógica subyacente que la extensión personalizada de Yokoy; es la misma idea, trasladada como parte de la plataforma de Perk. Por eso, los nombres de los atributos en la extensión de gastos le resultarán familiares si ha configurado Yokoy SCIM anteriormente: policyId, acreedor, ID de entidad legal, approvalThresholdy ignoreManagerInRequests Todos reaparecen con los mismos nombres y los mismos conceptos.
Comparte tus cargas útiles SCIM actuales
Al compartir tus cargas útiles SCIM actuales, Perk recopila información precisa sobre tu configuración antes de indicarte qué debes configurar. Antes de que tú o el equipo de Perk tomen una decisión, Perk necesita ver exactamente qué envía tu proveedor de identidad tanto a TravelPerk SCIM como a Yokoy SCIM.
Así es como funciona el proceso:
- Exporte o documente la carga útil SCIM que su proveedor de identidad envía actualmente a TravelPerk SCIM.
- Exporte o documente la carga útil SCIM que su proveedor de identidad envía actualmente a Yokoy SCIM.
- Comparte ambas cargas útiles con tu contacto de Perk.
- El equipo de Perk revisa tus cargas útiles y te devuelve los valores exactos y la asignación de atributos que debes usar en Perk SCIM, junto con cualquier cambio que debas realizar en tu proveedor de identidad.
Este es un paso de recopilación de datos, no de configuración. Aquí no decides los valores finales por tu cuenta, sino que le proporcionas a Perk información precisa sobre tu configuración actual para que su equipo pueda indicarte exactamente qué usar.
Comparación de atributos: Yokoy SCIM y la extensión de gastos Perk
La extensión de gastos de Perk abarca el mismo ámbito que tu integración actual de Yokoy SCIM, por lo que conviene compararlas. Utiliza esta tabla para comparar tus atributos actuales de Yokoy con sus equivalentes más cercanos en Perk SCIM al documentar tu carga útil de Yokoy para Perk.
| Atributo SCIM de Yokoy | Atributo SCIM de Perk | Notas |
|---|---|---|
ID |
id (esquema central) | Ambos son identificadores asignados por el servidor y de solo lectura. |
ID externo |
externalId (esquema central) | El concepto es el mismo en ambos casos: un identificador definido por el cliente. No es obligatorio en ninguno de los dos. |
activo |
activo (esquema central) | Booleano en ambos. Obligatorio en Perk SCIM; no explícitamente obligatorio en Yokoy. |
nombre de usuario |
nombre de usuario (esquema central) | La dirección de correo electrónico del usuario, que se utiliza como nombre de usuario. Obligatoria en ambos casos. |
correos electrónicos[tipo igual a "trabajo"].valor |
correos electrónicos (esquema central) | Requerido en Yokoy. Correos electrónicos de Perk es un array y no es obligatorio, aunque es una buena práctica enviarlo; por ejemplo, sarah@example.com. |
nombre.nombre |
nombre.nombre (esquema central) | Obligatorio en ambos. |
nombre.apellido |
nombre.apellido (esquema central) | Obligatorio en ambos. |
Idioma preferido |
idioma preferido y locale
|
Yokoy utiliza un campo combinado (por ejemplo, de-ch). Perk divide el idioma y la configuración regional en dos campos. Ver Idioma del usuario. |
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber |
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber |
En Yokoy, esto requiere un campo personalizado llamado employeeNumber Configúrelo primero en la configuración de la empresa, o el valor nunca aparecerá en la interfaz de usuario de Yokoy. employeeNumber de Perk SCIM Está integrado; no se necesita configurar ningún campo personalizado. |
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:creditor |
urn:ietf:params:scim:schemas:extension:expense:2.0:User:creditor |
El concepto es el mismo en ambos casos: la cuenta contable utilizada para registrar los gastos pagados de forma privada. No es obligatorio en ninguno de los dos. |
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization |
No existe un equivalente directo. | Ver Consideraciones clave. |
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter |
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter |
El mismo nombre de campo en ambos. Ver Objetos de costos, políticas y gerentes para una advertencia de mapeo para marcar con Perk. |
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.value |
manager.value o lineManagerEmail
|
Yokoy se basa únicamente en la ID. Perk admite un manager.value basado en la ID. o un lineManagerEmail basado en correo electrónico. Ver Objetos de costos, políticas y gerentes. |
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:legalEntityId |
urn:ietf:params:scim:schemas:extension:expense:2.0:User:legalEntityId |
El mismo concepto, aplicado a la extensión de gastos. Obligatorio en Yokoy; no obligatorio en Perk SCIM. Identifica la empresa asignada al usuario. |
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:policyId |
urn:ietf:params:scim:schemas:extension:expense:2.0:User:policyId |
Vincula al usuario a una política de gastos en ambos sistemas. No confundir con la política de viajes independiente de Perk. campo — ver Objetos de costos, políticas y gerentes. |
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:approvalThreshold |
urn:ietf:params:scim:schemas:extension:expense:2.0:User:approvalThreshold |
El concepto es el mismo en ambos casos: un límite de aprobación, enviado como un número decimal. Es opcional en ambos. |
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:ignoreManagerInRequests |
urn:ietf:params:scim:schemas:extension:expense:2.0:User:ignoreManagerInRequests |
El mismo concepto booleano en ambos casos. Opcional en ambos. |
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:customData0–datospersonalizados3
|
No existe un equivalente directo. | Ver Consideraciones clave. |
Objetos de costos, políticas y gerentes
Algunos atributos de la tabla anterior necesitan más contexto antes de que puedas describirlos con precisión a Perk, porque la asignación no es puramente mecánica. Objetos de costo. Centro de costos de Yokoy El campo envía códigos de objetos de costo que deben existir previamente en Yokoy antes de aprovisionar un usuario con un valor; Yokoy no crea objetos de costo a partir de datos SCIM automáticamente. Perk crea automáticamente un objeto de costo, como "Marketing", si aún no existe. Política de gastos frente a política de viajes. policyId de Yokoy vincula a un usuario con una política de gastos. Perk SCIM lo mantiene como policyId en la extensión de gastos, pero Perk también tiene una travelPolicy separada campo en su extensión personalizada de Perk, que ya debe existir en Perk y cubre la política de viajes específicamente. Estos son dos campos diferentes que cubren dos áreas diferentes. Si su organización usa ambos, documente ambos valores cuando comparta su carga útil con Perk. Gerentes y aprobadores. En Yokoy, manager.value Se basa en la identificación, y el gerente directo del usuario se convierte automáticamente en su aprobador; el esquema empresarial de Yokoy no tiene un concepto de aprobador independiente. Si un gerente aún no existe en Yokoy, se crea un usuario ficticio para él, y cualquier persona sin gerente, como un director ejecutivo, debe configurarse como su propio gerente directo. Perk SCIM ofrece dos maneras de asignar un gerente: manager.value (por ID de usuario de Perk) o lineManagerEmail (por correo electrónico, diseñado para proveedores de identidad como Okta que no pueden hacer referencia a los usuarios mediante su ID interno). Cuando compartas tu configuración con Perk, describe cuál de estas opciones admite tu proveedor de identidad para que Perk configure la correcta.
manager y lineManagerEmailSi tu cuenta se creó después de esa fecha, no incluyas aprobadores en lo que compartes con Perk.Consideraciones clave
Ten en cuenta estos puntos al preparar tus cargas útiles para Perk.
Lo que contiene
La organización El atributo es un identificador Yokoy constante y obligatorio para la organización del usuario, copiado una vez desde la interfaz de administración de Yokoy y reutilizado para cada usuario. En Perk, su cuenta no se identifica mediante ningún atributo en la carga útil; es implícito en la URL base y la clave API que está utilizando..
company, que es opcional y está separada. campo, que sirve para subdividir usuarios por nombre de empresa dentro de una única cuenta de Perk que abarca más de una empresa; no representa la cuenta en sí.Idioma del usuario
Yokoy combina idioma y configuración regional en un único preferredLanguage campo, por ejemplo de-ch. Perk SCIM divide esto en dos campos: preferredLanguage para el idioma en sí y una configuración regional separada campo, utilizado solo en la creación, que Perk divide por el guion o el guion bajo para calcular el país y la moneda. Documente ambas partes por separado cuando comparta su Yokoy preferredLanguage valores con Perk.
campos_personalizados_del_usuario
El esquema SCIM de Yokoy ofrecía la posibilidad de crear campos personalizados directamente en el formulario de usuario con customData0–datospersonalizados3, cada uno requiere un campo personalizado coincidente, como data0Perk SCIM no tiene un equivalente directo. Si su organización depende actualmente de estos campos, indíquelo como una deficiencia al compartir su carga útil con Perk.
¿Qué pasa después?
Una vez que hayas compartido tus cargas útiles y el equipo de Perk las haya revisado, el cambio se produce en tres etapas:
- Día antes del ensayo SCIM. Desactiva el SCIM de Yokoy y actualiza la configuración SCIM de TravelPerk siguiendo las instrucciones de Perk. Yokoy seguirá funcionando con normalidad, ya que Perk sincroniza ambos sistemas en segundo plano.
- Día del cambio. Perk otorga acceso de prueba a la configuración unificada. Yokoy continúa trabajando en paralelo.
- Dos semanas después del cambio. Perk desactiva el acceso a Yokoy. Con una sola integración SCIM, ya estarás completamente integrado a Perk Travel & Spend.