Salut les #Trailblazers,

Bienvenue sur mon blog. Dans cet article de blog, nous allons apprendre à intégrer Salesforce avec Xero.

Chaque fois que nous parlons d’intégration, la chose très importante est de savoir comment se connecter en toute sécurité au système tiers, puis sécuriser la communication.

Vous pouvez utiliser le lien ci-dessous pour tout savoir sur l’authentification Xero. Remarque : – Xero utilise OAuth 2.0 et OAuth 1.0 pour l’authentification et nous utiliserons OAuth 2.0

https://developer.xero.com/documentation/sdks-and-tools/tools/postman/#steps-to-get-up-and-running

Étape 1 – Créer une application connectée dans Xero

Aller vers Ce lien puis cliquez sur Nouvelle application

Accédez au portail des développeurs Xero et créez une application OAuth2.

Si vous n’êtes pas encore inscrit à un compte xero, vous pouvez le faire ici.

Utilisez les valeurs suivantes :

• Nom de l’application – votre choix, mais ne peut pas contenir le mot « Xero »
• URL de l’entreprise ou de l’application – il doit s’agir d’une adresse https, mais n’est pas utilisée
• URI de redirection OAuth 2.0 – doit également être https mais ne sera pas utilisé dans salesforce. Nous modifierons cette URL dans les étapes ultérieures

Puis:

1. Cliquez sur Créer une application
2. Cliquez sur Générer un secret
3. Garder la page ouverte

Étape 2 – Créer un fournisseur d’authentification dans Salesforce

Une fois que vous avez créé l’application connectée dans Xero, il est maintenant temps de créer l’authentification. Fournisseur dans Salesforce

1. Connectez-vous à l’organisation Salesforce
2. Accédez à Configuration -> Identité -> Auth. Fournisseurs -> Nouveau
3. Pour le type de fournisseur, sélectionnez Open ID Connect
4. Pour la clé client, fournissez l’identifiant client que vous avez noté
5. Pour le secret client, fournissez le secret client que vous avez noté
6. Pour Autoriser l’URL du point de terminaison, fournissez l’utilisation « https://login.xero.com/identity/connect/authorize« 
7. Pour l’URL du point de terminaison du jeton, utilisez « https://identity.xero.com/connect/token« 
8. Pour l’URL du point de terminaison des informations sur l’utilisateur, utilisez « https://identity.xero.com/connect/userinfo« 
9. Pour l’émetteur de jetons, utilisez « https://identity.xero.com« 
10. Pour les étendues par défaut, utilisez « offline_access openid profile email Accounting.transactions Accounting.transactions.read Accounting.contacts »
11. Allez-y et cliquez sur Enregistrer
12. Maintenant, à partir de la page de détail, copiez « URL de rappel »

Étape 3 – Modifier l’URL de rappel dans l’application Xero

1. Revenez à la page de détails de l’application Xero Connected
2. Cliquez sur l’onglet Configuration à partir de la gauche
3. Cliquez sur « Ajouter un autre bouton URI »
4. Collez l’URL que vous avez copiée puis enregistrez-la

Étape 4 – Créer des informations d’identification nommées dans Salesforce

Une fois que vous avez créé l’Auth. Fournisseur et mise à jour de l’URL de rappel dans l’application Xero Connected. Maintenant, créons les informations d’identification nommées car elles seront utilisées pour authentifier Xero avec Salesforce

Assurez-vous que vos informations d’identification nommées ressemblent à l’image ci-dessous.

Pour la portée, utilisez les valeurs ci-dessous

Étape 5 – Tester l’intégration

Pour tester l’intégration et s’assurer que cela fonctionne correctement. Exécutez le code ci-dessous à partir de la console développeur

HttpRequest request = new HttpRequest();
request.setMethod('GET');
request.setEndpoint( 'callout:Xero/'+'connections' );

request.setHeader('Accept', 'application/json');
request.setHeader('xero-tenant-id', '');
HttpResponse response = new HttpResponse();
response = new Http().send(request);

System.debug(' n '+ response.getStatusCode() );
System.debug(' n '+ response.getBody() );

Après avoir exécuté le code, vous devez voir un 200 comme code d’état. Voir l’image ci-dessous

Ci-dessous est le code complet pour votre référence

Remarque : – La classe XeroUtilApi est la classe principale qui utilise la classe XeroAPICalloutService pour effectuer les appels vers Xero Org.

Voici quelques exemples déjà implémentés

1. XeroUtilApi.getXeroInvoces(); – Pour récupérer toutes les factures
2. XeroUtilApi.getXeroAccounts(); – Pour récupérer tous les comptes
3. XeroUtilApi.getXeroContacts(); – Pour récupérer tous les contacts

Merci d’avoir lu Bon apprentissage

En rapport