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 - enregistrer le certificat SSL de cette entité - le certificat SSL : o au format p7b : pour l’enregistrer sur Chorus Pro o au format p12 : pour l’enregistrer dans SOAPUI

• Install SOAPUI
• Obtain SSL key (P7B and P12 formats)

SOAPUI configuration

Dans le menu Files > Preferences … > SSL Settings

Chargement d’une bibliothèque de fonctions REST

Créer un nouveau projet REST en important un fichier WADL Télécharger les fichiers WADL : AIFE-Chorus-Pro-Exemples_JSON_WADL.zip Cette opération constitue une liste de fonction

Interface SOAPUI

Interrogation d'une fonction

Pour interroger une requête, il faut : - Ouvrir la requête (double clic) - Afficher l’inspecteur ‘Auth’ de la requête - Dans la combo ‘Authorization’ - ‘Add a new Authorization’ - Elle sera 'basic' - Renseigner les informations d’authentification du compte technique (communiqué dans le fichier excel de constitution du matelas de données ou lors de la création du compte technique associé au compte du gestionnaire) - Vérifier que le port (5443) du ‘endpoint’ est bien configuré dans le ‘chemin de la requête’ - Renseigner la requête JSON. Copier-coller a. soit de la documentation portail chorus : pour l’exemple de ce document, il suffit de rechercher dans google ‘chorus pro factures consulter fournisseur’ b. soit de la bibliothèques de fichiers JSON donnés en exemples : $$$TmpAIFE-Chorus-Pro- Exemples_JSON_WADLJSON - Adapter le fichier JSON à la situation : j’ai utilisé l’id du premier utilisateur et l’id de la première facture indiqués dans le fichier de trace de création du matelas de données (lignes 9 et 176) - Lancer la requête avec le bouton PLAY - Dans la partie droite de l’écran apparaît la réponse, il peut être nécessaire de sélectionner un mode d’affichage JSON à la place de HTML - Dans la partie gauche, vous pouvez afficher la requête au format brut : - On pourra noter dans l’inspecteur la présence de l’onglet SSL qui indique le certificat utilisé… alors qu’il n’est pas dans le fichier brut