Le raccordement à Chorus Pro s’effectue en deux temps : 

• Un raccordement à l’environnement de qualification ; 
• Un raccordement à l’environnement de production.

Le présent guide présente la démarche à effectuer pour un raccordement à l’environnement de production. Concernant l’environnement de qualification, merci de vous reporter au mode opératoire dédié à l’environnement de qualification sur la Communauté Chorus Pro (lien à insérer).

Toutes les structures émettrices ou réceptrices de factures peuvent demander un raccordement à Chorus Pro, qu’il s’agisse de structures publiques ou privées. La création d’une fiche de raccordement nécessite : 

• D’avoir pris connaissance de la documentation technique (notamment les rubriques) :
  • spécifications externes

• De disposer de toutes les informations techniques de paramétrage du raccordement, notamment :
  • en API : code application PISTE.

Point d’attention : une demande de raccordement nécessite une expertise technique, c’est pourquoi elle doit être réalisée en partenariat avec des équipes disposant de ces expertises.

Pour les structures à raccorder en API, la création d’un utilisateur technique est également un prérequis.

Avant de procéder à un raccordement à Chorus Pro en production, il est préconisé d’avoir effectué un raccordement en qualification, à moins que l’éditeur de la solution informatique utilisée par la structure soit déjà raccordé en qualification.

Les structures s’appuyant sur un opérateur de dématérialisation n’ont aucune demande de raccordement à effectuer.

Les structures souhaitant se raccorder en mode API doivent créer un utilisateur technique, directement à partir de la solution Chorus Pro. La création d’un compte technique est détaillée dans la page « Création d’un compte technique pour un accès API en production ».

Pour accéder à Chorus Pro et créer une fiche de raccordement, il faut :

• Avoir créé sa structure sur le portail Chorus Pro
• Disposer d'un compte utilisateur habilité sur cette structure

L’utilisation de l’application de raccordement est très ponctuelle, et ses fonctionnalités sont très spécifiques. Nous préconisons donc de limiter fortement le nombre de personnes habilitées sur cette application.

Pour en savoir plus sur la gestion des utilisateurs, vous pouvez consulter la page « gérer les utilisateurs ».

Pour créer une fiche de raccordement API en mode oAuth2, rendez-vous sur le portail de services Chorus Pro. Connectez-vous avec votre identifiant de connexion et votre mot de passe.

Une fois connecté sur le portail de services Chorus, cliquez sur le domaine « Raccordements ».

Dans le domaine « Raccordements », cliquez sur l’application « API ».

Vous arriverez sur cette interface :

• Cliquer sur l’onglet Gérer raccordement API dans le bandeau supérieur
• Cliquer sur Déclarer un raccordement PISTE  situé en bas de la page comme illustré ci-dessus.

La page de saisie d’un raccordement PISTE s’affiche.

• Renseigner les données avec une attention particulière pour le champ  Nom de l’application PISTE. Ce champ est à renseigner avec la valeur saisie dans PISTE lors de l’étape de création d’application. Le respect de la sensibilité à la casse est important car déterminant pour le succès des appels API à venir.
• L’utilisateur doit aussi renseigner le type d’utilisation en le sélectionnant parmi une liste déroulante. S’il indique être utilisateur d’une solution éditeur ou opérateur, il lui est demandé d’indiquer le nom de l’éditeur / opérateur.

• Après la saisie de données, valider le raccordement, qui passe à  ACTIF .

Cliquez sur l’onglet Gérer raccordement API dans le bandeau supérieur.

Par défaut, tous les raccordements existants, actifs ou non, s'affichent, en mode certificat comme en mode Oauth2.

Selon qu’il s’agit d’un raccordement en mode certificat ou Oauth2, il faut filtrer éventuellement sur Structure et Etat courant, soit dans la partie haute de l’écran (raccordement par certificat), soit dans la partie basse (raccordement en mode Oauth2 – Piste).

Pour les raccordements en mode certificat, ces derniers étant inopérants en principe depuis le 31/12/2020, seule la consultation est possible.