Cet article vous aide à préparer la fusion de vos deux intégrations SCIM actuelles (TravelPerk SCIM pour les voyages et Yokoy SCIM pour les dépenses) en une seule intégration Perk SCIM. Il explique les différences entre votre configuration actuelle et le nouveau modèle, afin que vous puissiez rassembler des informations précises sur votre configuration SCIM et les partager avec votre interlocuteur Perk.
Avant de commencer
Aujourd'hui, vous exécutez simultanément deux intégrations SCIM distinctes : TravelPerk SCIM fournit aux utilisateurs les moyens de voyager, et Yokoy SCIM Perk fournit aux utilisateurs des fonctionnalités pour leurs dépenses et leurs frais. Perk a unifié ces deux aspects dans un seul Perk SCIM. L'intégration centralise la gestion des voyages et des dépenses via une connexion unique à votre fournisseur d'identité (Okta, Azure AD (Entra ID) ou une intégration API directe et personnalisée). Vous effectuez vous-même la modification de configuration auprès de votre fournisseur d'identité ; l'équipe Perk ne s'en charge pas. Avant cela, votre contact Perk examine votre configuration actuelle TravelPerk SCIM et Yokoy SCIM et vous indique précisément les éléments à configurer dans Perk SCIM. Cet article a pour but de vous aider à comprendre les différences entre votre configuration actuelle et le nouveau modèle afin de pouvoir partager des informations précises et utiles avec votre contact Perk. Il ne décrit pas directement les étapes de configuration du fournisseur d'identité ; ces instructions vous seront fournies par Perk après analyse de votre configuration.
Comment votre configuration actuelle se compare-t-elle au nouveau Perk SCIM ?
TravelPerk SCIM, votre intégration actuelle côté voyages, est transférée vers Perk SCIM quasiment sans modification. TravelPerk SCIM utilise le schéma de base SCIM, l'extension entreprise (urn:ietf:params:scim:schemas:extension:enterprise:2.0:User), et une extension Perk personnalisée (urn:ietf:params:scim:schemas:extension:travelperk:2.0:User) pour les champs spécifiques aux voyages comme travelPolicy, profils de factures, et lineManagerEmailPerk SCIM conserve le même schéma de base, la même extension d'entreprise et la même extension Perk personnalisée ; la plupart de vos mappages d'attributs de voyage existants restent donc inchangés. La véritable nouveauté réside dans l'extension de dépenses (urn:ietf:params:scim:schemas:extension:expense:2.0:User).TravelPerk SCIM n'a jamais intégré cette extension, car la gestion des dépenses n'en faisait pas partie. Perk SCIM l'ajoute spécifiquement pour couvrir tous les aspects des dépenses actuellement gérés par votre intégration Yokoy SCIM : politiques de dépenses, entités juridiques et seuils d'approbation, par exemple. L'extension de dépenses de Perk repose sur la même logique que l'extension personnalisée de Yokoy ; il s'agit du même principe, repris au sein de la plateforme Perk. C'est pourquoi les noms d'attributs de l'extension de dépenses vous sembleront familiers si vous avez déjà configuré Yokoy SCIM : policyId, créancier, legalEntityId, seuil d'approbationet ignoreManagerInRequests Tous réapparaissent avec les mêmes noms et les mêmes concepts.
Partagez vos charges utiles SCIM actuelles
Le partage de vos données SCIM actuelles permet à Perk de recueillir des informations précises sur votre configuration avant de vous indiquer les réglages à effectuer. Avant toute décision de votre part ou de celle de l'équipe Perk, Perk doit visualiser exactement les données que votre fournisseur d'identité envoie actuellement à TravelPerk SCIM et à Yokoy SCIM.
Voici comment fonctionne le processus :
- Exportez ou documentez la charge utile SCIM que votre fournisseur d'identité envoie actuellement à TravelPerk SCIM.
- Exportez ou documentez la charge utile SCIM que votre fournisseur d'identité envoie actuellement à Yokoy SCIM.
- Partagez les deux fichiers utiles avec votre contact Perk.
- L'équipe de Perk examine vos charges utiles et vous renvoie les valeurs exactes et le mappage des attributs à utiliser dans Perk SCIM, ainsi que toutes les modifications que vous devez apporter à votre fournisseur d'identité.
Il s'agit d'une étape de collecte de données, et non de configuration. Vous ne définissez pas vous-même les valeurs finales : vous fournissez à Perk des informations précises sur votre configuration actuelle afin que leur équipe puisse vous indiquer exactement les valeurs à utiliser.
Comparaison des attributs : Yokoy SCIM et l'extension des dépenses Perk
L'extension de gestion des dépenses Perk couvre les mêmes fonctionnalités que votre intégration SCIM Yokoy actuelle ; il est donc utile de les comparer. Utilisez ce tableau pour vérifier que vos attributs Yokoy actuels correspondent bien à leurs équivalents SCIM Perk les plus proches lors de la documentation de votre charge utile Yokoy pour Perk.
| Attribut SCIM de Yokoy | Avantage SCIM Attribut | Notes |
|---|---|---|
ID |
id (schéma de base) |
Ce sont deux identifiants en lecture seule attribués par le serveur. |
externalId |
externalId (schéma de base) |
Même concept dans les deux cas : un identifiant défini par le client. Non requis dans les deux cas. |
actif |
actif (schéma de base) |
Booléen dans les deux cas. Requis dans Perk SCIM ; non explicitement requis dans Yokoy. |
nom d'utilisateur |
nom d'utilisateur (schéma de base) |
L'adresse e-mail de l'utilisateur, utilisée comme identifiant. Obligatoire dans les deux cas. |
emails[type eq "travail"].valeur |
emails (schéma de base) |
Requis dans Yokoy. E-mails de Perk est un tableau et n'est pas obligatoire, bien qu'il soit recommandé de l'envoyer — par exemple, sarah@example.com. |
nom.prénom |
nom.givenName (schéma de base) |
Obligatoire dans les deux cas. |
nom.nom de famille |
nom.nom de famille (schéma de base) |
Obligatoire dans les deux cas. |
Langue préférée |
Langue préférée et locale
|
Yokoy utilise un champ combiné (par exemple, de-chPerk sépare la langue et les paramètres régionaux en deux champs. Voir Langue de l'utilisateur. |
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber |
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber |
Dans Yokoy, cela nécessite un champ personnalisé nommé employeeNumber Configurez d'abord cette valeur dans les paramètres de l'entreprise, sinon elle n'apparaîtra jamais dans l'interface utilisateur de Yokoy. Numéro d'employé de l'avantage SCIM est intégré — aucune configuration de champ personnalisé n’est nécessaire. |
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:creditor |
urn:ietf:params:scim:schemas:extension:expense:2.0:User:creditor |
Le principe est le même dans les deux cas : le compte comptable sert à enregistrer les dépenses à titre privé. Il n’est obligatoire dans aucun des deux cas. |
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization |
Aucun équivalent direct | Voir Considérations clés. |
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter |
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter |
Même nom de champ dans les deux cas. Voir Objets de coûts, politiques et gestionnaires pour une mise en garde concernant la cartographie à signaler avec Perk. |
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.value |
manager.value ou lineManagerEmail
|
Yokoy fonctionne uniquement avec un identifiant. Perk prend en charge un gestionnaire basé sur un identifiant. ou un lineManagerEmail par e-mail. Voir Objets de coûts, politiques et gestionnaires. |
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:legalEntityId |
urn:ietf:params:scim:schemas:extension:expense:2.0:User:legalEntityId |
Même principe appliqué à l'extension des dépenses. Obligatoire dans Yokoy ; non requis dans Perk SCIM. Permet d'identifier l'entreprise à laquelle l'utilisateur est rattaché. |
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:policyId |
urn:ietf:params:scim:schemas:extension:expense:2.0:User:policyId |
Associe l'utilisateur à une politique de dépenses dans les deux systèmes. À ne pas confondre avec la politique de voyage distincte de Perk (travelPolicy). champ — voir Objets de coûts, politiques et gestionnaires. |
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:approvalThreshold |
urn:ietf:params:scim:schemas:extension:expense:2.0:User:approvalThreshold |
Même principe dans les deux cas : une limite d’approbation, envoyée sous forme décimale. Optionnel dans les deux cas. |
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:ignoreManagerInRequests |
urn:ietf:params:scim:schemas:extension:expense:2.0:User:ignoreManagerInRequests |
Même concept booléen dans les deux cas. Optionnel dans les deux cas. |
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:customData0–customData3
|
Aucun équivalent direct | Voir Considérations clés. |
Objets de coûts, politiques et gestionnaires
Certains attributs du tableau ci-dessus nécessitent plus de contexte avant d'être décrits avec précision à Perk, car la correspondance n'est pas purement mécanique. Objets de coût. Centre de coûts de Yokoy Ce champ envoie des codes d'objets de coûts qui doivent déjà exister dans Yokoy avant l'attribution d'une valeur à un utilisateur ; Yokoy ne crée pas automatiquement d'objets de coûts à partir des données SCIM. Perk crée automatiquement un objet de coût, tel que « Marketing », s'il n'existe pas déjà. Politique de dépenses vs politique de voyage. L'identifiant de politique de Yokoy Associe un utilisateur à une politique de dépenses. Perk SCIM conserve cette information sous la forme policyId dans l'extension des dépenses, mais Perk dispose également d'une politique de voyage distincte. Ce champ, dans son extension personnalisée Perk, doit déjà exister dans Perk et concerne spécifiquement la politique de voyage. Il s'agit de deux champs distincts couvrant deux domaines différents. Si votre organisation utilise les deux, veuillez documenter les deux valeurs lorsque vous partagez votre charge utile avec Perk. Responsables et approbateurs. Dans Yokoy, manager.value L'identification est basée sur l'identifiant, et le responsable hiérarchique de l'utilisateur devient automatiquement son approbateur — le schéma d'entreprise de Yokoy ne prévoit pas de concept d'approbateur distinct. Si aucun responsable n'existe encore dans Yokoy, un utilisateur factice est créé. Toute personne sans responsable hiérarchique, comme un PDG, doit être désignée comme son propre responsable. Perk SCIM offre deux méthodes pour désigner un responsable : `manager.value` (par identifiant utilisateur Perk) ou lineManagerEmail (Par e-mail, conçu pour les fournisseurs d'identité comme Okta qui ne peuvent pas référencer les utilisateurs par leur identifiant interne). Lorsque vous partagez votre configuration avec Perk, veuillez indiquer laquelle de ces options votre fournisseur d'identité prend en charge afin que Perk configure la bonne.
approbateurs Le champ de l'extension personnalisée Perk n'est pas disponible pour les comptes Perk créés après le 1er juillet 2024 ; il renvoie une erreur sur ces comptes. Il est remplacé par manager et lineManagerEmailSi votre compte a été créé après cette date, n'incluez pas les approbateurs. dans ce que vous partagez avec Perk.Considérations clés
Gardez ces points à l'esprit lors de la préparation de vos charges utiles pour Perk.
Ce qu'il contient
L'organisation L'attribut est un identifiant Yokoy obligatoire et constant pour l'organisation de l'utilisateur. Il est copié une seule fois depuis l'interface d'administration Yokoy et réutilisé pour chaque utilisateur. Dans Perk, votre compte n'est pas identifié par un attribut dans la charge utile ; l'identification est implicite dans l'URL de base et la clé API que vous utilisez..
séparée et facultative Ce champ sert à sous-limiter les utilisateurs par nom d'entreprise au sein d'un même compte Perk qui couvre plusieurs entreprises ; il ne représente pas le compte lui-même.Langue de l'utilisateur
Yokoy combine la langue et les paramètres régionaux en un seul preferredLanguage champ, par exemple de-ch. Perk SCIM divise cela en deux champs : preferredLanguage pour la langue elle-même, et une locale distincte Champ utilisé uniquement lors de la création, que Perk divise en fonction du tiret ou du trait de soulignement pour déterminer le pays et la devise. Documentez les deux parties séparément lorsque vous partagez votre langue préférée Yokoy preferredLanguage valeurs avec avantage.
champs_personnalisés_utilisateur
Le schéma SCIM de Yokoy offrait la possibilité de créer des champs personnalisés directement dans le formulaire utilisateur avec customData0–customData3, chacun nécessitant un champ personnalisé correspondant, tel que data0Perk SCIM n'a pas d'équivalent direct. Si votre organisation utilise ces champs, veuillez le signaler lors du partage de vos données avec Perk.
Que se passe-t-il ensuite ?
Une fois que vous avez partagé vos données et que l'équipe de Perk les a examinées, la transition se déroule en trois étapes :
- La veille du procès SCIM. Vous désactivez le module SCIM de Yokoy et mettez à jour la configuration SCIM de TravelPerk en suivant les instructions de Perk. Yokoy continue de fonctionner normalement, car Perk synchronise les deux systèmes en arrière-plan.
- Jour du changement. Perk accorde un accès d'essai à la configuration unifiée. Yokoy continue de travailler en parallèle.
- Deux semaines après le changement. Perk bloque l'accès à Yokoy. Vous êtes entièrement intégré à Perk Travel & Spend grâce à une seule intégration SCIM.