> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://docs.organilog.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Connecter Organilog à Chorus Pro et envoyer des factures 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** ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/organilog-chorus-pro-workflow_9fahq1.png =800x227) 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](https://chorus-pro.gouv.fr/)). ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/chorus-pro-creer-compte_9kxs8u.png =800x398)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.pd](https://communaute.chorus-pro.gouv.fr/wp-content/uploads/2021/12/AIFE-Fiche-pratique-Gerer-les-utlilisateurs.pdf)f ## 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/chorus-pro-interface-bouton-ra_kts4l.png =600x271) 2. Ouvrir l'application **Compte technique**. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/chorus-pro-interface-bouton-co_19vv5kc.png =600x270) 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/chorus-pro-interface-creation-_11kptqw.png =600x271) 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**](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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/poste-bouton-creer-un-compte_16e28kk.png =800x459) 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/piste-creer-application_e02w5q.png) Plusieurs informations doivent être renseignées. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/piste-creer-application-formul_1f9fmhg.png) ###### 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 ; ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/piste-selection-application_ex1mok.png) 2. ouvrir sa modification ; ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/piste-modifier-application_ovzjf4.png) 3. accéder à la gestion des API et des consentements ; ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/piste-modifier-application-acc_2c6grm.png =500x467) 4. accepter les conditions générales d'utilisation des API concernées ; 5. sélectionner les API de **PRODUCTION** ; ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/piste-application-autoriser-ap_rt3x5b.png =600x317) 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/piste-application-consentement_1otx8b4.png =500x292) ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/piste-application-consentement_1tcb94w.png =500x202) 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/piste-recuperer-identifiant_opsjoh.png =800x395) 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** ; ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/piste-raccordement-api-chorus-_6xwxqk.png) 3. créer/déclarer un nouveau raccordement ; ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/chorus-pro-raccordement-declar_1x6y9nk.png) 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 ; ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/chorus-pro-raccordement-declar_gw9le0.png) 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/chorus-pro-raccordement-ajout-_1jw1r0z.png) > ***En cas de blocage, voici les fiches officielles Chorus Pro Gouv*** > ​ > | Félicitations ! À ce stade, les paramétrages de Chorus Pro et Piste sont terminés. ### 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/organilog-acces-chorus-pro_1mvfiyq.png =800x430) Renseigner les différents identifiants demandés par le connecteur, notamment ceux issus du compte technique Chorus Pro et de la configuration PISTE. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/organilog-chorus-pro-configura_zvaqxn.png =800x383) > ⚠️ **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** ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/organilog-tableau-de-bord-chor_ieo4z1.png =800x404) 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/organilog-facture-onglet-choru_1q43ir0.png) 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/organilog-facture-chorus-pro-e_13c2au9.png =800x301) 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/organilog-facture-chorus-pro-e_sxohd4.png =500x353) Pour chaque pièce jointe sélectionnée, il est possible d'indiquer son type. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/organilog-facture-chorus-pro-e_1xffmmt.png =500x186) 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.