La plateforme ChorusPro permet de gérer par webservice les factures envoyées aux clients institutionnels. Pour réaliser la connexion, il faut : - une structure identifiée (SIRET de la société maîtresse) qui supervise éventuellement d’autres structures (autres SIRET) - un utilisateur gestionnaire (principal ou secondaire) - un compte utilisateur technique attaché à la structure - activer les droits d’accès à l’API pour cette structure.

• Installer SOAPUI
• Disposer d'un access token via piste

Au préalable de l’exécution de l’appel API Chorus Pro, l’utilisateur doit récupérer un « Access Token ». La récupération de ce jeton est décrite dans le guide utilisateur de PISTE.

Afin de procéder à l’appel, suivre les étapes suivantes pour paramétrer le SOAPui:

Depuis la fenêtre de l’appel SOAPui, cliquer sur « Auth » (encadré rouge ci-dessous)

• Suite au clic, le bloc d’authentification s’affiche comme illustré ci-dessous :

• Sélectionner « Add new authorization », une nouvelle pop-in s’affiche :

• Préciser dans le champ « type », la valeur OAuth2.0 et choisir un profil

• Suite à la validation, la nouvelle authorization est créée :

• Cliquer sur « Get Token »

• Dans “Oauth 2 Flow” sélectionner « Client Credentials Grant »
• Copier le Client ID et le Client Secret – qui sont récupérables dans PISTE comme décrit dans le guide utilisateur PISTE dans la rubrique « 6.5 Génération d’une Api Key » du guide utilisateur PISTE UserGuide_navigation_FR
• Remplir l’Access Token URL en fonction d’où doit être effectué l’appel (zone Internet ou ADER). Pour cela se référer à la rubrique « 10.2 Liste des points d’accès PISTE par partenaire » du guide utilisateur PISTE UserGuide_navigation_FR
• Scope = « openid »
• Valider en cliquant sur Get Access Token

Une fois l’access Token généré, procéder à l’appel API Chorus Pro comme décrit ci-dessous :

• La valeur obtenue lors du get access Token est automatiquement renseigné dans le champ Access Token (bloc « Authorization » Profile 1) :

• Procéder à la création d’un Header en cliquant sur le bouton [Headers] et sur le « + » :

• Saisir « cpro-account » comme nom de header et valider :

• Lorsque le header est créé, renseigner dans le champ « Value » la combinaison « logintechnique:password » encodée en base 64
• Exécuter l’appel API en cliquant sur la flèche verte et vous obtiendrez alors une réponse dans la zone de droite (onglet JSON).

Le format d'encodage attendu : l’encodage du contenu doit être obligatoirement en UTF-8 (Content-Type: charset=UTF-8)