Le connecteur Chorus Pro permet de transmettre directement depuis Organilog des factures destinées aux structures publiques, sans avoir à effectuer manuellement un nouveau dépôt depuis le portail Chorus Pro.
La première utilisation nécessite cependant de mettre en place un raccordement entre plusieurs services :
Organilog → Compte technique Chorus Pro → PISTE → Chorus Pro

Cette configuration n'est à réaliser qu'une seule fois. Une fois le raccordement opérationnel, les factures peuvent être envoyées directement depuis Organilog.

À savoir : la première configuration nécessite plusieurs manipulations sur Chorus Pro et sur la plateforme PISTE. Il est recommandé de conserver les différents identifiants créés au cours de la procédure.

1. Les prérequis

Avant de commencer la configuration, plusieurs éléments sont nécessaires :

• disposer d'un compte Chorus Pro rattaché à la structure de l'entreprise ;
• disposer des droits de Gestionnaire principal de cette structure ;
• créer un compte technique Chorus Pro ;
• disposer d'un compte sur la plateforme PISTE ;
• créer une application PISTE et lui donner accès aux API nécessaires ;
• raccorder l'application PISTE à Chorus Pro ;
• disposer du Pack Premium Organilog pour utiliser le connecteur ;
• avoir correctement renseigné le SIRET de l'entreprise dans Organilog.

Le raccordement utilisé par Organilog repose sur les API Chorus Pro en mode OAuth2. La documentation officielle Chorus Pro confirme que ce mode nécessite notamment un compte PISTE et un compte technique Chorus Pro.

2. Préparer le compte Chorus Pro

2.1 Créer un compte Chorus Pro si nécessaire

Si aucun compte Chorus Pro n'existe encore, commencer par créer un compte sur le portail Chorus Pro (cf. https://chorus-pro.gouv.fr).
La création d'un compte utilisateur est nécessaire avant de pouvoir gérer la structure et créer le compte technique qui sera utilisé par Organilog.

Tutoriel vidéo Chorus Pro Gouv
​https://communaute.chorus-pro.gouv.fr/documentation/tutoriels/#1522314752134-2110dbbb-1becb5d1-16c22add-8ea028e4-1e88

En cas de blocage, voici la fiche officielle Chorus Pro Gouv
https://communaute.chorus-pro.gouv.fr/wp-content/uploads/2021/12/AIFE-Fiche-pratique-Creer-un-compte-en-quelques-clics.pdf

2.2 Vérifier les droits du Gestionnaire principal

Le compte utilisé pour effectuer la configuration doit être rattaché à la structure concernée et disposer des droits nécessaires.
En particulier, la création d'un compte technique doit être réalisée par le Gestionnaire principal de la structure.
Les habilitations Chorus Pro sont gérées à travers différents profils attribués aux utilisateurs.
En cas de difficulté concernant les utilisateurs, les structures ou les habilitations, se référer à la documentation officielle Chorus Pro consacrée à la gestion des utilisateurs.

En cas de blocage, voici la fiche officielle Chorus Pro Gouv
https://communaute.chorus-pro.gouv.fr/wp-content/uploads/2021/12/AIFE-Fiche-pratique-Gerer-les-utlilisateurs.pdf

2.3 Créer le compte technique Chorus Pro

À quoi sert le compte technique ?

Le compte technique permet à un logiciel externe, comme Organilog, de communiquer avec Chorus Pro par API.
Il est différent du compte utilisateur habituellement utilisé pour se connecter au portail Chorus Pro. Il n'est d'ailleurs pas destiné à être utilisé pour une connexion classique au portail.

Création du compte technique

Depuis Chorus Pro :

1. Accéder au domaine Raccordements.

2. Ouvrir l'application Compte technique.

3. Dans le champ correspondant au type de demande, sélectionner Création d'un compte technique.
4. Sélectionner la structure concernée.
5. Les informations du compte technique sont alors générées.

6. Conserver soigneusement le login et le mot de passe.
7. Valider la création du compte.

⚠️ Important : conserver immédiatement le mot de passe.
Chorus Pro ne permet pas de le consulter ultérieurement. En cas de perte, une réinitialisation du mot de passe du compte technique devra être effectuée.

La création du compte technique peut nécessiter un délai avant que celui-ci soit pleinement actif. La documentation actuelle de Chorus Pro indique un délai pouvant aller jusqu'à environ 30 minutes.
Le compte technique possède des droits importants sur la structure. Ses identifiants doivent donc être conservés de manière sécurisée.

En cas de blocage, voici la fiche officielle Chorus Pro Gouv
​https://communaute.chorus-pro.gouv.fr/documentation/creation-dun-compte-technique-pour-un-acces-api-en-production/#1645413551590-0c993690-7063

3. Configurer PISTE et le raccordement API

PISTE est la plateforme utilisée pour permettre l'accès sécurisé aux API de l'État.
Une application doit y être créée afin de permettre la communication entre Organilog et Chorus Pro.

3.1 Créer un compte PISTE

Accéder à la plateforme PISTE (cf. ) puis sélectionner Créer un compte.

Renseigner les informations demandées.
Si aucun code organisation n'est disponible, le champ correspondant peut être laissé vide.
Valider ensuite les conditions générales d'utilisation et terminer la création du compte.

3.2 Se connecter à PISTE

Après activation du compte, se connecter à PISTE afin de créer l'application qui sera utilisée pour Chorus Pro.

3.3 Créer l'application de production

Créer une nouvelle application destinée à l'environnement de production.

Plusieurs informations doivent être renseignées.

Nom de l'application

Définir un nom permettant d'identifier facilement l'application.

⚠️ Conserver ce nom.
Le nom de l'application PISTE sera utilisé lors de la création du raccordement avec Chorus Pro.

La documentation Chorus Pro indique également que le nom de l'application déclarée dans PISTE est demandé lors de la création du raccordement API.

Adresse e-mail

Indiquer l'adresse e-mail du responsable de l'application.

Responsable de l'application

Indiquer une personne pouvant être contactée par les équipes Chorus Pro ou PISTE en cas de besoin.

Informations concernant la structure

Renseigner notamment le SIRET de l'entreprise.
Une fois les informations renseignées, enregistrer l'application.

3.4 Ajouter les API Chorus Pro à l'application PISTE

L'application doit maintenant être autorisée à accéder aux API nécessaires au fonctionnement du connecteur.
Depuis PISTE :

1. sélectionner l'application précédemment créée ;

2. ouvrir sa modification ;

3. accéder à la gestion des API et des consentements ;

4. accepter les conditions générales d'utilisation des API concernées ;
5. sélectionner les API de PRODUCTION ;

6. enregistrer les choix ;
7. revenir sur l'application pour appliquer les API sélectionnées.

⚠️ Vérifier qu'il s'agit bien des API PROD / Production et non des API de type Sandbox.

Pour le fonctionnement du connecteur Organilog, vérifier notamment la présence des familles d'API suivantes :

• Transverses
• Structures
• Utilisateurs
• Engagements
• Factures

Selon l'organisation de l'interface PISTE, ces API peuvent être réparties sur plusieurs pages.

Une fois la configuration terminée, vérifier que les différentes API apparaissent bien comme souscrites pour l'application.

3.5 Récupérer les identifiants OAuth PISTE

Depuis l'application PISTE précédemment créée, ouvrir sa modification puis accéder à la partie Authentification.

Deux informations importantes doivent être conservées :

• le Client ID / identifiant OAuth ;
• le Client Secret.

⚠️ Ces informations sont confidentielles. Elles permettent d'authentifier l'application auprès des API et doivent être conservées de manière sécurisée.

3.6 Raccorder l'application PISTE à Chorus Pro

Une fois l'application PISTE créée, elle doit être déclarée auprès de Chorus Pro.
Depuis Chorus Pro :

1. accéder au domaine consacré aux Raccordements ;
2. accéder à la gestion des raccordements API ;

3. créer/déclarer un nouveau raccordement ;

4. sélectionner la structure concernée ;
5. renseigner l'application PISTE créée précédemment ;
6. compléter les informations demandées concernant le raccordement et le contact technique ;

7. valider la demande.

Selon l'interface proposée par Chorus Pro, certaines informations comme le type d'utilisation Éditeur / Opérateur peuvent également être demandées.
Le compte effectuant cette opération doit disposer des habilitations nécessaires pour modifier les raccordements de la structure. La documentation Chorus Pro actuelle mentionne notamment le profil Raccordement modification pour cette opération.
Une fois le raccordement correctement configuré, celui-ci doit apparaître comme actif.

En cas de blocage, voici les fiches officielles Chorus Pro Gouv
​

Environnement de qualification et production

Chorus Pro distingue un environnement de qualification, destiné aux essais avec des données fictives, et l'environnement de production, utilisé pour les données réelles. Sa documentation prévoit une phase de qualification pour tester les raccordements avant leur utilisation en production.
Pour davantage d'informations sur la procédure de raccordement, se référer à la documentation officielle Chorus Pro consacrée aux raccordements API.

4. Configurer Chorus Pro dans Organilog

Lorsque Chorus Pro et PISTE sont configurés, le connecteur peut être activé dans Organilog.

4.1 Accéder au connecteur

Dans Organilog, accéder à : Paramètres > Connecteurs > Chorus Pro
Puis sélectionner Configurer.

Renseigner les différents identifiants demandés par le connecteur, notamment ceux issus du compte technique Chorus Pro et de la configuration PISTE.

⚠️ Ne pas confondre le compte utilisateur Chorus Pro et le compte technique.
Les communications réalisées par Organilog avec les API utilisent le compte technique Chorus Pro.

Une fois les informations saisies, lancer la connexion.

La connexion affiche une croix rouge

Si Organilog indique que la connexion avec Chorus Pro n'est pas valide, vérifier en priorité :

• le login du compte technique ;
• le mot de passe du compte technique ;
• les informations PISTE ;
• le Client ID et le Client Secret lorsqu'ils sont demandés ;
• l'absence d'espace ajouté accidentellement avant ou après un identifiant ;
• les majuscules et minuscules ;
• l'état du raccordement entre PISTE et Chorus Pro.

Corriger ensuite les informations dans le connecteur et relancer la connexion.

5. Préparer Organilog pour l'envoi des factures

5.1 Afficher l'identifiant Chorus Pro dans la liste des factures

La liste des factures peut être personnalisée afin d'afficher l'identifiant Chorus Pro.
Depuis le tableau de bord des factures (choix des colonnes) : Personnaliser > ID Chorus Pro

Cela permet notamment de repérer plus facilement les factures déjà transmises.

5.2 Vérifier les prérequis d'une facture

Avant de pouvoir envoyer une facture vers Chorus Pro, plusieurs conditions doivent être respectées.

SIRET de l'entreprise

Le SIRET de l'entreprise émettrice doit être correctement renseigné dans le Compte entreprise Organilog.
En cas d'utilisation d'une filiale, vérifier également les informations de cette filiale.

État de la facture

La facture ne doit plus être au statut Brouillon.
Elle doit au minimum être au statut En cours.

Contenu de la facture

La facture doit contenir des lignes de facturation.

SIRET du client

Le client destinataire doit posséder un SIRET correctement renseigné dans Organilog.
Ce SIRET doit correspondre à une structure publique active pouvant recevoir des factures dans Chorus Pro.
L'annuaire officiel Chorus Pro permet notamment de vérifier :

• que la structure existe ;
• qu'elle est active ;
• son SIRET ;
• les éventuels codes services ;
• si un numéro d'engagement juridique est obligatoire.

💡 Les informations de facturation, et notamment le SIRET, le code service et le numéro d'engagement lorsque ceux-ci sont nécessaires, sont généralement communiquées par la structure publique cliente, notamment sur ses documents de commande.

6. Envoyer une facture Organilog vers Chorus Pro

Ouvrir la facture concernée dans Organilog.
Sélectionner Éditer, puis accéder à l'onglet Chorus Pro.

Un assistant accompagne ensuite l'envoi de la facture.
Le processus se déroule en quatre étapes :

1. informations concernant l'envoi ;
2. vérification et complément des données ;
3. sélection des pièces jointes ;
4. envoi et confirmation.

Étape 1 — Informations concernant l'envoi

La première étape présente les informations générales concernant la transmission vers Chorus Pro.
Contrôler les informations affichées avant de poursuivre.

Étape 2 — Vérifier les données Chorus Pro

Organilog et Chorus Pro contrôlent les différentes informations nécessaires au traitement de la facture.

Selon le destinataire et les données déjà présentes dans Organilog, des informations complémentaires peuvent être demandées.
Parmi celles-ci peuvent notamment figurer :

Référence

Si une référence doit être transmise mais qu'elle n'a pas été saisie directement dans la facture, elle peut être renseignée lors de cette étape.
Dans Organilog, le champ correspondant peut être affiché dans la facture depuis :
Options d'affichage > Référence

Contact

Lorsqu'un contact doit être transmis, celui-ci peut également être renseigné dans la facture.
Le champ peut être affiché depuis :
Options d'affichage > Contact

Commentaire public

Le commentaire public renseigné dans la facture peut également être utilisé si nécessaire.

Cadre de facturation

Sélectionner le code du cadre de facturation correspondant à la situation.

TVA

Sélectionner le type de TVA demandé.
En cas d'exonération de TVA, renseigner également le motif d'exonération.

Code service et numéro d'engagement

Selon la structure publique destinataire, un code service, un numéro d'engagement juridique, les deux ou aucun de ces éléments peuvent être obligatoires.
Chorus Pro contrôle ces informations avant l'acheminement de la facture. Une valeur obligatoire absente ou incorrecte peut entraîner le rejet de la facture.

Étape 3 — Ajouter des pièces jointes

Si la facture Organilog possède des pièces jointes, une ou plusieurs d'entre elles peuvent être jointes à l'envoi Chorus Pro.
Sélectionner les documents à transmettre.

Pour chaque pièce jointe sélectionnée, il est possible d'indiquer son type.

Si aucun type particulier n'est indiqué, le document est transmis comme document annexe.
Une fois les documents sélectionnés, valider afin de poursuivre.

Étape 4 — Envoyer la facture

La dernière étape permet de transmettre définitivement la facture.
Sélectionner Envoyer.
Lorsque Chorus Pro confirme la réception du dépôt, la facture passe au statut Déposée.
Dans Chorus Pro, le statut « Déposée » signifie que la facture a bien été envoyée par l'émetteur. Elle poursuit ensuite son cycle de traitement auprès du destinataire.

7. Suivre une facture envoyée sur Chorus Pro

Après son dépôt, une facture évolue selon différents statuts Chorus Pro.
Parmi les principaux statuts pouvant être rencontrés :

• Déposée : la facture a été envoyée ;
• Mise à disposition : la facture a été transmise au destinataire ;
• À recycler : une information concernant le destinataire doit être corrigée ;
• Suspendue : le destinataire demande généralement des éléments ou pièces complémentaires ;
• Rejetée : la facture a été refusée et une nouvelle facture doit être émise ;
• Service fait ;
• Mandatée ;
• Mise à disposition du comptable ;
• Comptabilisée ;
• Mise en paiement.

Certains statuts intermédiaires sont facultatifs et dépendent des informations remontées par la structure destinataire.
Une facture peut également être recherchée directement depuis le portail Chorus Pro afin de consulter son détail et son historique de traitement.

8. Les erreurs courantes lors de l'envoi vers Chorus Pro

En cas d'échec lors de l'envoi d'une facture, l'origine peut provenir des informations présentes dans Organilog, des identifiants utilisés ou du raccordement Chorus Pro / PISTE.
Voici les erreurs les plus fréquemment rencontrées.

« Vérifiez vos identifiants Chorus Pro et les droits accordés à votre compte technique. Cette erreur est intervenue lors de l'accès aux Motifs d'exonération TVA »

La mention relative à la TVA n'est généralement pas l'élément important du message.
Cette erreur indique principalement un problème d'authentification ou d'accès à Chorus Pro.
Points à vérifier :

• identifiants du compte technique Chorus Pro ;
• mot de passe du compte technique ;
• identifiants PISTE ;
• absence d'espace dans les identifiants ;
• respect des majuscules/minuscules ;
• état du raccordement API.

Si nécessaire, réinitialiser le mot de passe du compte technique depuis Chorus Pro puis renseigner le nouveau mot de passe dans Organilog.

« Recherche de structure : aucune structure active ne correspond au SIRET de votre compte ou de la filiale rattachée à la facture »

Le SIRET de l'entreprise émettrice ou de la filiale utilisée pour la facture ne correspond pas à la structure attendue par Chorus Pro.
Résolution :
Vérifier et corriger :

• le SIRET du Compte entreprise dans Organilog ;
• ou le SIRET de la filiale associée à la facture.

« GDP_MSG_11.068 - La structure destinataire XXXXX n'est pas une structure publique »

Le SIRET renseigné sur la fiche du client ne correspond pas à une structure publique reconnue comme destinataire de la facture.
Résolution :
Vérifier le SIRET communiqué par le client et rechercher la structure dans l'annuaire Chorus Pro.
Corriger ensuite le SIRET présent dans la fiche client Organilog.
Seules les structures publiques actives peuvent recevoir une facture via Chorus Pro.

« Une erreur est survenue lors du traitement de la communication avec Chorus Pro : l'accès à [élément] a été refusé par Chorus Pro »

Cette erreur indique généralement que le connecteur n'est pas autorisé à accéder à l'une des ressources nécessaires.
Points à vérifier :

• le compte technique Chorus Pro ;
• les droits associés au compte ;
• le raccordement API Chorus Pro ;
• l'application PISTE ;
• la souscription aux API de production nécessaires ;
• les identifiants OAuth de l'application ;
• l'état actif du raccordement.

9. En cas de problème

Si l'erreur concerne directement le portail Chorus Pro, PISTE, les habilitations ou le raccordement API, la documentation officielle Chorus Pro constitue la référence pour vérifier le paramétrage.
Si Chorus Pro et PISTE sont correctement configurés mais que l'envoi depuis Organilog reste impossible, transmettre au support Organilog :

• le message d'erreur obtenu ;
• la facture concernée ;
• si possible, une capture du message affiché ;
• les vérifications déjà réalisées.

Mis à jour le : 25/09/2026