Chorus

La plateforme Chorus Pro permet aux administrations publiques de centraliser la réception des factures de leurs fournisseurs.

La plateforme Piste met à disposition toutes les API de l'Etat et de la sphère publique.

Paramétrer la connexion entre ATOOK Bureau et la plateforme Chorus permet d'envoyer des factures en masse vers Chorus directement depuis ATOOK Bureau.

Le portail Chorus est accessible à partir de l’adresse https://portail.chorus-pro.gouv.fr/aife_csm

Documentation officielle de Chorus : https://portail.chorus-pro.gouv.fr/aife_documentation

Documentation officielle de Piste : https://piste.gouv.fr/help-center/guide

Paramétrer le compte Chorus dans ATOOK Bureau

Avant de paramétrer Chorus dans ATOOK Bureau, plusieurs éléments sont à paramétrer directement dans les plateformes Chorus Pro et Piste.

1

Créer un compte Chorus

Portail pour la création d'un compte Chorus

Documentation sur la création d'un compte Chorus

2

Créer un compte technique Chorus

Portail de connexion pour le raccordement

Documentation pour la création d'un compte technique Chorus

3

Créer un compte Piste

Portail pour la création d'un compte Piste

Documentation de la plateforme Piste

4

Copier les données vers ATOOK Bureau

Dans le menu BASE > Paramètres > Onglet Chorus, remplir les champs comme suit :

Informations liées à la société

Champ	Valeur attendue
Extensions de PJ Autorisées	Copier / coller la ligne suivante : BMP;HTM;FAX;PNG;XHTML;BZ2;JPEG;PPS;XLC;CSV;JPG;PPT;PPTX ;XLM;DOC;ODP;RTF;XLS;GIF;ODS;SVG;XML;GZ;ODT;TGZ;XSD;GZIP;P7S;TIF;XSL;HTML;PDF;TXT;ZIP;TIFF,XLSX;DOC;DOCX
Niveau de configuration	Sélectionner un niveau de configuration Affaire : les informations Chorus sont renseignées au niveau de la fiche chantier. Pièce commerciale : les informations Chorus sont renseignées au niveau des pièces commerciales. Intervention : les informations Chorus sont renseignées dans la fiche bon d'intervention.
Type TVA	Renseigner le régime de TVA de la société
Cadre de facturation (par défaut)	Sélectionner un cadre de facturation

Informations de connexion Compte technique Chorus Pro

Les champs suivants sont à compléter à partir des données de la plateforme Chorus Pro.

Champ	Valeur attendue
Url API	https://api.piste.gouv.fr
API : Compte technique Login	Login du compte technique
API : Compte technique MDP	Mot de passe du compte technique

Informations de connexion Piste

Les champs suivants sont à compléter à partir des données de la plateforme Piste.

Champ	Valeur attendue
URL Token	https://oauth.piste.gouv.fr/api/oauth/token
Token Client ID	Copier / coller le champ Client ID dans Identifiants Oauth Plateforme Piste
Token Client Secret	Copier / coller le champ Secret Key dans Identifiants Oauth

Paramétrage client

Le paramétrage client va permettre d'identifier les factures du client comme des factures à transmettre sur Chorus.

Pour paramétrer Chorus sur la fiche client :

1. Aller dans le module CLIENTS ;

2. Ouvrir la fiche du client concerné ;

3. Aller dans l'onglet Chorus ;

4. Cocher la case Chorus pour identifier ce client comme client Chorus ;

5. Sélectionner un Cadre de facturation (ou paramétrer un cadre de facturation par défaut pour ne pas avoir à le saisir dans la fiche de chaque client Chorus) ;

6. Sélectionner la Structure du destinataire (celle-ci est appelée à partir du numéro SIRET du client) ;

7. Sélectionner le Service du destinataire (les services proposés dépendent de la structure du destinataire).

Paramétrage selon le niveau de configuration

Selon le niveau de configuration choisi, les informations sont à compléter au niveau de la fiche chantier, des pièces commerciales ou de la fiche du bon d'intervention :

• Affaire : les informations Chorus sont renseignées au niveau de la fiche chantier.

• Pièce commerciale : les informations Chorus sont renseignées au niveau des pièces commerciales.

• Intervention : les informations Chorus sont renseignées dans la fiche bon d'intervention.

Affaire (Chantier)

Pour paramétrer Chorus au niveau du chantier :

1. Aller dans le module CHANTIER ;

2. Ouvrir la fiche du chantier concerné ;

3. Aller dans l'onglet Chorus ;

4. Sélectionner un Cadre de facturation (ou paramétrer un cadre de facturation par défaut pour ne pas avoir à le saisir dans la fiche de chaque client Chorus) ;

5. Les champs Structure du destinataire et Service du destinataire sont hérités de la fiche client ;

6. Compléter les champs Numéro d'engagement (obligatoire) et Numéro de marché (facultatif).

Pièce commerciale

Pour paramétrer Chorus au niveau de la pièce commerciale :

1. Aller dans le module VENTES > FACTURES ;

2. Ouvrir la facture concernée ;

3. Aller dans l'onglet Chorus ;

4. Compléter les champs Numéro d'engagement (obligatoire) et Numéro de marché (facultatif).

Bon d'intervention

Pour paramétrer Chorus au niveau du bon d'intervention :

1. Aller dans le module INTERVENTIONS > BONS D'INTERVENTION ;

2. Ouvrir la fiche du bon concerné ;

3. Aller dans l'onglet Chorus ;

4. Sélectionner un Cadre de facturation (ou paramétrer un cadre de facturation par défaut pour ne pas avoir à le saisir dans la fiche de chaque client Chorus) ;

5. Les champs Structure du destinataire et Service du destinataire sont hérités de la fiche client ;

6. Compléter les champs Numéro d'engagement (obligatoire) et Numéro de marché (facultatif).

Gestion du mot de passe du compte technique Chorus

Définition et contexte

Définition

Le "compte technique" est un utilisateur créé sur la plateforme Chorus Pro pour l'accès via l'API (et non pour une connexion manuelle via portail).

Il permet à ATOOK de s'authentifier pour envoyer ou consulter des factures, accéder aux services API.

Seul le gestionnaire principal de la structure peut créer ou modifier ce type de compte.

Pourquoi changer ou réinitialiser le mot de passe ?

Tous les ans, le mot de passe du compte technique expire afin de garantir la sécurité des échanges et il faut donc le changer.

Après modification, ATOOK qui utilise ce compte technique pour réaliser des appels API doit être mis à jour avec le nouveau mot de passe.

Prérequis

Avant d'entamer la procédure de changement du mot de passe, assurez-vous de disposer de :

• L'identifiant (login) du compte technique concerné

• Être gestionnaire principal de la structure

• Avoir accès au portail de services Chorus Pro

• Effectuer l'opération au moment où une interruption de l'API est tolérable (car il y a un délai d'activation).

Procédure de réinitialisation du mot de passe

Pour réinitialiser le mot de passe du compte technique Chorus :

Réinitialisation du mot de passe depuis la plateforme Chorus Pro :

1. Accéder au portail de services Chorus Pro

2. S'identifier en tant que gestionnaire principal de la structure

3. Accéder à l'application "Compte technique"

4. Depuis la page d'accueil, cliquer sur "Accéder au domaine" dans la section Raccordements

1. Ouvrir l'application "Compte technique" en cliquant sur "Accéder"

1. Sélectionner Réinitialisation du mot de passe du compte technique ;

1. Soumettre la demande de réinitialisation

1. Le nouveau mot de passe est généré et s'affiche à l'écran

2. Copier et noter le mot de passe

Mise à jour le mot de passe du compte technique Chorus dans ATOOK :

1. De retour dans ATOOK, se rendre dans le menu BASE > Paramètres > Onglet Chorus

2. Dans le champ API : Compte technique Mdp, coller le mot de passe généré sur Chorus.

Bonnes pratiques

Conservez le mot de passe dans un coffre-fort de mots de passe ou un emplacement sécurisé, et documentez la date de changement.

Prévenez les équipes concernées de l’impact potentiel (ex. arrêt temporaire des envois factures) et planifiez la prochaine échéance du renouvellement.

Documenter : date de la réinitialisation, nom du gestionnaire, compte technique concerné, système impacté, etc.