Ce document s’adresse à tous les utilisateurs de l’environnement de qualification du Portail de Services Chorus Pro. Le portail de qualification constitue un environnement « bac-à-sable » permettant de simuler l’usage du Portail, aussi bien en mode raccordement (interfaçage) qu’en « mode portail », sans risque de modification malencontreuse ou de perturbation du véritable portail. Ce guide détaille comment accéder à cet environnement, et comment en utiliser les fonctionnalités.
L’environnement de qualification du portail de services Chorus Pro, désigné dans ce document par le terme « portail de qualification », permet de se connecter à un environnement semblable à l’environnement de production afin de prendre en main la solution en mode « bac à sable ».
Dans cet environnement, il est possible d’exploiter les principales fonctionnalités du portail de services Chorus Pro : dépôt, traitement et recherche de factures, suivi des flux, etc.
Pour les structures souhaitant mettre en œuvre un raccordement technique à Chorus Pro, le portail de qualification offre la possibilité de se raccorder à un environnement dédié à la réalisation des tests techniques préalables à l’ouverture de leur véritable raccordement (dit « raccordement en production »). En d’autres termes, il permet de « se qualifier » sur des données de test, avant de transmettre et recevoir des données réelles sur le véritable portail de production.
Dans le cadre d’un projet de raccordement, le portail de qualification permet :
En complément de ces fonctionnalités, le portail de qualification dispose d’une fonctionnalité de test des formats entrants et sortants.
Attention : les transactions réalisables sur le portail de qualification ne le sont que sur des données fictives produites par ledit portail. Autrement dit, on ne peut pas utiliser sur le portail comme structure destinataire ou émettrice de facture une entité du monde réel. Tous les tests se font exclusivement sur des données fictives. On ne teste donc pas des données « réelles », mais plutôt des fonctions, des canaux d’échange, des formats et des cinématiques (exemple : émission d’une facture fictive par un émetteur fictif vers un destinataire fictif, puis traitement de la facture par ce dernier et mise à jour des cycles de vie).
Les données fictives utilisables pour les tests (notamment les structures privées et structures publiques adressables) sont fournies par un « matelas de données » à créer directement sur le portail de qualification.
Les données du matelas de données ne commencent à être utilisables pour des tests de raccordement que le lendemain de leur génération (J+1).
Le portail de qualification suit le rythme d’évolution du portail réel, dit « de production ». Le contenu des matelas de données a donc évolué depuis le déploiement initial de Chorus Pro. Les matelas anciens ne gèrent par exemple pas la notion de PDP.
Ainsi, si vous vous êtes créé un matelas avant février 2025, et que vous souhaitez utiliser des fonctionnalités non couvertes par votre matelas actuel, vous devrez vous créer un nouveau compte utilisateur en qualification pour générer un nouveau matelas de données comprenant les données requises.
Par exemple, si vous êtes un opérateur de dématérialisation raccordé à Chorus Pro avant 2025 et que vous travaillez à un raccordement en tant que PDP dans le cadre de la facturation électronique interentreprises, votre matelas de données antérieur à 2025 ne comprendra pas de structures de test de type PDP, ou de structure de niveau SIREN, et vous ne pourrez pas réaliser les tests de qualification requis.
Dans la mesure où il est impossible d’étendre les données « structure » de votre ancien matelas de données, vous devrez donc vous créer un nouveau compte utilisateur de qualification, puis générer un nouveau matelas. Les matelas produits à partir de cette date contiendront deux structures de type PDP, et deux structures privées additionnelles de niveau SIREN, permettant de réaliser les cas de test facturation interentreprise.
Le portail de qualification est accessible par toutes les entités à l’adresse suivante : https://qualif.chorus-pro.gouv.fr
Ce portail se distingue d’emblée du portail de production par la couleur marron des boutons des menus, du bouton de connexion en haut à droite ainsi que de l’assistante virtuelle Claudia en bas à droite.
En mode déconnecté, la page d’accueil du portail de qualification est vide et ne présente aucun domaine comme le montre la capture d’écran ci-dessus. Afin d’accéder aux domaines, il est nécessaire de se connecter ou de créer un compte utilisateur.
L’utilisation du portail de qualification nécessite un matelas de données. Un matelas de données est un fichier contenant des données fictives permettant de se connecter au portail et d’utiliser ses fonctionnalités.
Tous les tests effectués sur le portail de qualification doivent s’appuyer sur les informations fournies par le matelas de données. Il n’est pas possible de créer une structure sur le portail de qualification ; les structures utilisées doivent être celles du matelas de données.
Le processus de connexion au portail de qualification dans le cadre de l’exécution d’un test se fait en trois étapes détaillées ci-dessous :
Point d’attention : Le compte utilisateur créé à l’étape 1 n’est utilisé que pour récupérer le matelas de données. Une fois celui-ci téléchargé, les connexions au portail se font à partir des identifiants et mots de passe contenus dans le matelas.
Par exemple, si je souhaite faire un test de dépôt de facture simple en tant que fournisseur de l’Etat, j’irai chercher dans le matelas l’identifiant et le mot de passe utilisateur correspondant à ma structure de test fictive « fournisseur » pour me connecter au portail de qualification.
Pour créer un compte utilisateur, vous avez uniquement besoin d’une adresse courriel valide :
Le message suivant apparaît à l’écran pour confirmer la prise en compte de la demande de création de compte :
Comme le mentionne le récapitulatif, à l’issue de la création de votre compte, un lien d’activation est envoyé à l’adresse mail que vous avez renseignée. Pour finaliser la création de votre compte, vous devez simplement cliquer sur ce lien.
Vous serez alors redirigé vers la page d’activation du compte utilisateur. Cette étape permet de sécuriser l’accès à votre compte au travers du paramétrage d’un mot de passe.
Entrez et confirmez votre mot de passe puis cliquez sur « SOUMETTRE ».
Une fois votre compte utilisateur activé, vous êtes redirigé vers la page d’accueil connecté du portail de qualification. Lorsque vous êtes connecté à votre compte, vous pouvez uniquement accéder au domaine « Matelas de données ».
Il existe trois types différents de matelas de données :
Le premier matelas à créer est le matelas de données « Structures et utilisateurs ». Il est ensuite possible (mais pas obligatoire) de créer les matelas « Demandes de paiement » et « Engagements juridiques », dans cet ordre. En effet, il n’est pas possible de créer le matelas « Engagements juridiques » si le matelas « Demandes de paiement » n’a pas été créé au préalable.
La première génération d’un matelas de données permet d’obtenir le matelas « Structures et utilisateurs ».
Dans l’application « Générer un matelas de données », cliquer sur « Soumettre ».
Une fois le matelas généré, vous serez redirigé vers le domaine « Matelas de données ». Deux nouvelles applications sont disponibles : « Consulter un matelas de données » et « Changer le mot de passe d’un utilisateur de test ».
Pour consulter le matelas de donnée généré, il suffit de cliquer sur « Accéder » dans l’application « Consultation du matelas de données ».
Vous êtes redirigé vers la page de consultation des matelas de données.
La génération du matelas de données n’est pas instantanée et peut prendre quelques minutes. Si vous essayez de consulter votre matelas dans cet intervalle, un message lui explicatif est affiché et le bouton de téléchargement du fichier est grisé.
A noter que, quelques minutes plus tard, vous devez recharger la page du formulaire de consultation pour dégriser le bouton.
Le bloc « Consulter les structures et utilisateurs » contient le csv à télécharger afin de visualiser les données des organisations et utilisateurs.
Pour télécharger le fichier, autorisez les pop-ups qui s’affichent sur votre navigateur. Le téléchargement prend quelques secondes.
L’utilisateur reçoit une notification sur son adresse électronique de contact dès l’achèvement de la génération du matelas de données.
Après la génération du premier matelas de données « Structures et utilisateurs », vous pouvez générer les matelas « Demandes de paiement » et « Engagements juridiques » si vous le souhaitez. Pour ce faire, cliquez sur « Consulter mes demandes de paiement et engagements » dans le bloc de même nom.
Dans l’application, il vous suffit de cliquer sur le bouton « Créer » dans le bloc correspondant au matelas de votre choix.
Pour rappel, les matelas doivent être créés dans l’ordre suivant : « Structures et utilisateurs », « Demandes de paiement », « Engagements juridiques ».
Pour mettre en forme le matelas de données de façon lisible, nous vous suggérons de l’enregistrer sur votre ordinateur au format CSV.
Il est ensuite utile d’ouvrir un logiciel de type tableur pour y importer le fichier CSV correspondant à votre matelas de données. Sous Excel, par exemple, l’ouverture d’un fichier CSV fera apparaître l’assistant d’importation de texte :
étape 1 : Cliquer sur « Suivant »
étape 2 : Cocher l’option de séparateur Point-virgule puis cliquez sur « Suivant »
étape 3 : Sélectionner toutes les colonnes de l’aperçu de données puis cocher le format de données « Texte ». Cela évitera la transformation des suites numériques longues en notations illisibles dans Excel.
étape 4 : Cliquer sur « Terminer » pour ouvrir le fichier au format tableur, avec une distinction claire des différentes colonnes.
Les matelas de données permettent à chaque entité de disposer de l’ensemble des données nécessaires à la réalisation de cas de tests variés sur l’espace de qualification.
On retrouve dans le matelas structures la typologie suivante de structures.
Pour les matelas antérieurs à 2025 :
A partir de 2025, pour permettre les tests de facturation électronique interentreprises s’ajoutent les types suivants :
La mise en forme de la version 2025 des matelas diffère sensiblement de celle des matelas antérieurs. Elle se structure de la façon suivante :
La première colonne, « identifiant structure » contient les identifiants d’adressage des structures fictives du matelas. Il s’agit de l’identifiant à indiquer pour adresser une facture à cette structure sur le portail de qualification.
La troisième colonne, « raison sociale » donne le nom de la structure de test. Cette colonne est utile pour repérer les typologies de structure. Par exemple, une structure « MOE » pourra être utilisée pour simuler le traitement de factures de travaux au niveau MOE, une structure « Destinataire Etat », pour simuler une facturation à un service de l’Etat (Ministère ou Services déconcentrées).
Toute la partie droite du tableau sert à fournir pour chaque structure du jeu de données plusieurs identifiants et mots de passe permettant de se connecter avec des utilisateurs fictifs des différentes structures. Il est recommandé de privilégier l’utilisation des comptes utilisateurs commençant en « GEST_... » (c’est-à-dire « gestionnaire »), puisqu’ils disposent du maximum de droits.
On peut également reconnaitre les structures « PDP » à leur « type d’identifiant » (matricule PDP), en plus de la mention PDP dans la raison sociale.
Pour chaque structure, le matelas fournit des identifiants et mots de passe pour un compte de profil Gestionnaire (c’est-à-dire administrateur de la structure) et des comptes de profil Utilisateur (simples agents de la structure).
Ces identifiants et mot de passe permettent de simuler une connexion au portail par l’utilisateur fictif choisi. En règle générale, il est recommandé de privilégier les connexions avec l’utilisateur de profil Gestionnaire, puisqu’il dispose du maximum de droits.
Attention : le portail de qualification impose périodiquement de modifier les vieux mots de passe utilisateurs. Quand vous choisissez un nouveau mot de passe pour un utilisateur, pensez à l’inscrire dans votre matelas de données pour ne pas l’oublier.
Facture : Factures déjà existantes sur le portail de qualification, avec tous types de statuts et différents cadres de facturation
Engagement Juridique : Numéros d’engagements utilisables en test
Une fois le matelas de données téléchargé sur votre poste de travail, déconnectez-vous en cliquant sur la flèche à côté de votre nom en haut à droite de l’écran, puis sur « Se déconnecter ».
Vous serez alors redirigé vers la page d’accueil de l’environnement de qualification du portail de services Chorus Pro.
Pour réaliser vos tests, vous devez utiliser les données de vos différents matelas.
Pour vous connecter avec un utilisateur fictif, vous devez tout d’abord identifier les données du matelas « Structures et utilisateurs » répondant à vos besoins pour le test que vous souhaitez réaliser.
Ensuite, vous pouvez renseigner l’adresse de connexion (désignée par « login » dans les matelas de données antérieurs à 2024 et « Username » pour les matelas postérieurs à 205) et le mot de passe dans la page de connexion du portail de qualification et vous connecter.
Ainsi, dans l’exemple, l’utilisateur sera connecté en tant que gestionnaire principal de la structure 10114553923878 du matelas de données « Structures et utilisateurs ».
Une fois authentifié, toutes les fonctionnalités du portail de services Chorus Pro sont exploitables : gestion de la structure, gestion des utilisateurs, dépôt de factures, traitement de factures, suivi des flux…
Le portail de qualification est une plateforme de simulation : aucune des factures que vous déposerez sur cet environnement ne sera transmise à une entité publique réelle.
Les mots de passe des utilisateurs du matelas de données doivent être renouvelés périodiquement sous peine d’expiration. Lorsque vous utilisez un compte dont le mot de passe arrive à expiration, le portail vous réoriente vers une page permettant d’enregistrer un nouveau mot de passe. Il est vivement recommandé d’enregistrer ce nouveau mot de passe défini par vos soins sur votre ficher matelas, afin de ne pas l’oublier.
En cas de perte de mot de passe d’un utilisateur du matelas de données, il reste possible de régénérer un nouveau mot de passe en vous connectant avec votre compte personnel (celui qui vous a permis de créer le matelas en premier lieu).
Pour cela, connectez-vous avec vos identifiants personnels, et accédez à l’application « Changer le mot de passe d’un utilisateur de test ».
Dans l’application, vous pourrez sélectionner l’utilisateur de votre choix et changer son mot de passe en le saisissant dans le champ dédié. Pour valider, cliquez sur « Soumettre ».
Encore une fois, nous recommandons que vous inscriviez immédiatement ce nouveau mot de passe à la place de l’ancien directement dans votre matelas à des fins de traçabilité.
Les fonctionnalités du portail de qualification sont, sauf exception, identiques aux fonctionnalités du portail de production. De même, les droits spécifiques à chaque profil sont identiques aux droits du portail de production.
L’ensemble de la documentation fonctionnelle proposée sur le périmètre du portail de production est applicable au portail de qualification. Vous pouvez en prendre connaissance sur notre portail de documentation.
On utilise l’espace de qualification avec les profils utilisateurs (identifiants et mots de passe) fournis dans les matelas de données. Dès lors, la réponse à une sollicitation émise à partir du portail de qualification sera envoyée au profil utilisateur utilisé pour émettre cette sollicitation (et non à votre profil personnel « réel »). Il faudra donc vous connecter sous ce profil pour aller consulter la réponse dans son espace Sollicitations émises. Pour faciliter le travail du Support, il est vivement recommandé de remplacer l’adresse de contact générique associée à cet utilisateur de test par la vôtre, dans la partie « Mon compte ».
Les principales spécificités du portail de qualification par rapport au portail de production tiennent à sa nature d’environnement de test et à l’obligation faite d’y utiliser des données fictives en matière de « structures ».
Comme il s’agit d’un environnement « bac à sable », le dispositif de double authentification appliqué au portail de production n’y est pas mis en œuvre. Il suffit d’entrer l’identifiant et mot de passe de l’utilisateur de son choix pour accéder au portail sous son profil.
On ne peut par ailleurs pas créer de nouvelle « structure » sur le portail de qualification. Il n’est possible d’y intervenir en émission/réception/gestion d’annuaire que sur des structures existantes, qui correspondent à la somme des structures issues de tous les matelas de données de tous les utilisateurs du portail de qualification. Dit autrement, l’annuaire des structures du portail de qualification correspond à la somme des structures de tous les matelas de données générés par les utilisateurs.
L’usage des entités PDP des matelas de données est réservé aux entités ayant déposé un dossier de demande d’immatriculation en tant que PDP. Nous prions les entités non candidates au statut de PDP (par exemple les entreprises ou entités publiques) de ne pas utiliser les profils utilisateurs de PDP fictives (login/mot de passe) de leurs matelas.
Comme les PDP du portail de production, les structures PDP figurant dans les matelas de données de la qualification disposent d’un identifiant de type « numéro d’immatriculation » (fictif) qui leur permet de réaliser toutes les actions réservées aux PDP dans le cadre du projet Facturation Electronique. Les structures PDP peuvent donc modifier des lignes d’annuaire de la qualification.
Les entités candidates à l’immatriculation PDP doivent impérativement attendre l’accord de l’AIFE pour générer leur matelas de données, et pour réaliser leurs tests.
Les tests techniques concourant à l’immatriculation supposent en effet l’utilisation d’un matelas de données intactes (c’est-à-dire non modifiées) au démarrage des tests. Les scénarios de tests ayant été conçus sur la base d’un matelas intact tout « jeu » induisant des modifications de données en amont du démarrage des tests est susceptible de fausser le résultat attendu de ces derniers, et donc leur conclusion.
Par ailleurs, afin de ne pas perturber les tests des autres entités utilisatrices de la qualification, il est demandé aux entités réalisant des tests sous un profil PDP de n’intervenir dans l’annuaire de la Qualification que sur les structures qui figurent dans LEUR matelas de données : l’intervention sur des lignes d’annuaire de la qualification ne relevant pas de votre matelas est proscrite.
Si pour un motif quelconque vous avez besoin de davantage de structures que celles fournies dans votre matelas pour effectuer un test, il est possible de vous créer un nouveau compte utilisateur pour générer un matelas de données additionnel.
Pour rappel, l’espace de qualification est un environnement de test. Il est rigoureusement séparé du portail Chorus Pro. Par conséquent, aucune des actions entreprises sur le portail de qualification n’a de conséquence sur l’émission ou la réception de factures sur le portail de services Chorus Pro. Pour cette raison :
Attention, pour le lot 1 (pilote annuaire), le raccordement des PDP en qualification s’effectue via une « fiche raccordement » au format tableur, et non via l’interface de raccordement du portail présentée dans la suite du document (qui correspond au système de raccordement actuel pour la facturation à destination de la sphère publique).
Pour qualifier son raccordement, il sera néanmoins nécessaire de :
Le portail de qualification peut être raccordé au système externe d’un partenaire. Pour ces cas, les fonctionnalités du portail de qualification sont :
L’ensemble de la documentation proposée sur le périmètre du portail de production est applicable au portail de qualification. La documentation est disponible sur le portail de documentation.
En complément de ces fonctionnalités, le portail de qualification dispose d’une fonctionnalité de test des formats entrants et sortants (voir paragraphe dépôt de flux infra).
Avant d’aller y effectuer votre demande de raccordement avec votre utilisateur de test il est recommandé d’aller indiquer dans votre fiche utilisateur votre véritable adresse de contact, en lieu et place de l’adresse générique proposée par défaut. Cela permettra au Support Chorus Pro de vous contacter plus facilement en cas de problème.
Pour accéder à votre fiche utilisateur, vous devez cliquer sur la flèche à côté de votre nom et cliquer sur « Mon compte ». Vous pourrez alors modifier votre adresse électronique de contact.
Une fois cette étape réalisée, vous pouvez effectuer votre demande de raccordement à l’espace de qualification.
Pour cela, connecté au compte d’un utilisateur du matelas de données, rendez-vous dans le domaine « Raccordements », et accédez à l’application « EDI » ou « API » selon votre mode de raccordement.
Vous pourrez alors faire votre demande de raccordement en cliquant sur les onglets dédiés.
Cette démarche est décrite en détails dans le guide utilisateur Raccordement à Chorus Pro.
Lorsque vous effectuez votre demande de raccordement sur l’espace de qualification, pensez à bien renseigner vos véritables coordonnées dans le formulaire de demande, sans quoi le Support Chorus ne pourra jamais vous répondre. Indiquer dans le champ commentaire le nom de votre société.
Deux solutions permettent l’envoi de flux vers le portail de qualification :
Le dépôt manuel concerne pour l'instant uniquement la facturation à destination de la sphère publique. Il s’effectue en mode portail :
Si CPPStatut est coché, le format du flux retour sera un FEN1200. Si AIFEStatut est coché, le format du flux retour sera un FEN1201.