Ce document est à destination des entités publiques souhaitant se raccorder à la plateforme agréée Chorus Pro pour :

• Transmettre des factures vers un client privé assujetti à la TVA ; 
• Transmettre des données de transaction et de paiement ;
• Accéder à l’annuaire de la facturation électronique dédié à la sphère publique.

 

 

Toutes les entités publiques concernées par la réforme de la facturation électronique doivent procéder à un raccordement à Chorus Pro pour :

• Transmettre des factures vers un client privé assujetti à la TVA ;
• Transmettre des données de transaction et de paiement ;
• Accéder à l’annuaire de la facturation électronique dédié à la sphère publique.

Ce raccordement vient en complément d’un éventuel raccordement existant pour la réception de factures.

1.1       Prendre connaissance des spécifications

 

Les règles à respecter pour se raccorder ainsi que les méthodes de mise en œuvre sont décrites dans les « spécifications externes » et dans leurs annexes.

Seuls les formats et les appels recensés ou décrits dans les spécifications externes sont utilisables pour échanger des données avec Chorus Pro : Spécifications Externes FE- CHORUS PRO.

 

1.2      Choisir son mode de raccordement

 

1.2.1      Raccordement direct ou via un tiers

 

L’entité publique peut choisir de se raccorder directement à Chorus Pro ou de le déléguer à un tiers qui agit pour son compte.

 

1.2.2     Canal API et canal EDI

 

L’entité publique peut se raccorder en EDI ou en API ou bien aux deux canaux d’échanges selon ses besoins. Le canal EDI est préconisé pour gérer les volumes d’échanges importants.

 

 

Afin de sécuriser la qualité des flux transmis, l’entité publique est invitée à se raccorder sur l’environnement de qualification afin de dérouler des tests avant de procéder à son raccordement sur l’environnement de production.

L’environnement de qualification est un environnement « iso prod » dédié à l’exécution de tests avec des données fictives issues de matelas de données.

L’utilisation de l’environnement de qualification est présentée sur la page de documentation suivante.

L’entité publique s’appuyant sur un opérateur de dématérialisation n’a pas de demande de raccordement à effectuer. Elle doit néanmoins lui fournir tous les éléments dont il a besoin pour assurer cette tâche, a minima le numéro SIRET de leur structure.

 

2.1      Prérequis au raccordement

 

Avant de procéder au raccordement, il est nécessaire de respecter les prérequis suivants :

• Disposer d’un compte utilisateur sur chaque environnement auquel on souhaite se raccorder (qualification et production) ;
• Le compte doit être rattaché à la structure SIRET pour laquelle le raccordement est demandé ;
• S’assurer que les comptes sont habilités sur le profil « Raccordement modification » sur la structure pour laquelle le raccordement est demandé.
• Les prérequis spécifiques au mode de raccordement choisi doivent par ailleurs avoir été réalisés. Le demandeur doit disposer de toutes les informations techniques requises pour compléter sa demande : protocole, adresse IP/FQDN, certificat (pour l’EDI), compte technique, code application PISTE (pour les API) …

Les 3 premiers prérequis sont en principe déjà remplis lorsque l’entité publique dispose déjà d’un raccordement à Chorus Pro pour recevoir des factures de la part de fournisseurs privés. Ainsi, la création de nouveaux comptes n’est pas exigée puisque les comptes utilisateurs créés pour les raccordements sur les environnements de qualification et de production sont réutilisables.

 

2.2     Raccordement en EDI

 

Le raccordement EDI requiert l’utilisation d’un certificat électronique valide « authentification serveur » ou « authentification serveur de type client » de niveau RGS* (RGS une étoile) ou eIDAS QWAC, afin de chiffrer les échanges et authentifier l’émetteur / récepteur des flux (sa date d’expiration doit être surveillée par l’entité publique)

RGS* à minima, afin de chiffrer les échanges et authentifier l’émetteur / récepteur des flux.

Les protocoles de raccordements utilisables en EDI pour Chorus Pro sont :

•     PeSIT
•     SFTP
•     AS2

 

Type de certificat attendu en fonction du protocole :

 

• « Client » et « Serveur » pour les raccordements EDI PeSIT
• « Serveur » ou « Client » pour les raccordements EDI AS2
• « Client » pour les raccordements EDI SFTP
• Format : Les certificats doivent être transmis au format pkcs 7 avec l’ensemble de la chaîne de certification.
• Un même certificat ne peut pas être utilisé pour plusieurs raccordements au même environnement (production ou qualification), même pour des structures différentes.

 

Pour en savoir plus, consulter la page Certificats. Vous y trouverez également les certificats AIFE à télécharger.

 

En résumé, l’entité publique doit disposer de certificats distincts pour ses raccordements en EDI sur l’environnement de qualification et l’environnement de production.

 

2.3     Raccordements en API

 

Le raccordement en API exige :

• D’une part, d’avoir créé un compte sur la plateforme PISTE et de déclarer une « application » (voir le site de PISTE pour plus de détails). Le nom de l’application PISTE sera demandé par le portail de Services au moment de la demande de raccordement.
• D’autre part, de créer un « compte technique » lié à sa structure pour l’environnement de qualification et l’environnement de production. Pour plus d’information à ce sujet, voir la page Compte technique.

Pour rappel : si l’entité publique dispose déjà d’un raccordement en API (pour la réception/consultation de factures en provenance d’un fournisseur privé), alors la création d’un nouveau raccordement n’est pas exigée. L’entité publique doit uniquement s’abonner aux nouveaux services sur l’application PISTE.

 

2.4       Créer son raccordement

 

1. Se connecter depuis le portail avec son identifiant et mot de passe de qualification ou de production.

Pour l’environnement de qualification, l’identifiant et le mot de passe sont ceux d’un utilisateur de niveau gestionnaire du jeu de données.

Pour l’environnement de production, l’identifiant et le mot de passe sont ceux saisis lors de la création de votre compte utilisateur.

 

 

2. Une fois connecté au portail de services Chorus Pro, cliquer sur le domaine "Raccordements".

 

 

3. Dans le domaine "Raccordements", cliquez sur l'application "Raccordements".

 

 

4. Dans l'application "Raccordements", sélectionnez les applications "Mes raccordements EDI" ou "Mes raccordements API" en fonction du type de raccordement que vous souhaitez effectuer.

 

Un accès direct à PISTE est proposé depuis cette page pour les partenaires souhaitant se raccorder en API.

 

 

 

Les demandes de raccordement sont formalisées par la saisie de fiches raccordement.

 

3.1       Créer et gérer une fiche de raccordement en EDI

 

L’accueil de l’application « Mes raccordements en EDI » affiche un tableau de bord des raccordements existants.

 

 

3.1.1       Créer une fiche de raccordement en EDI

 

Cliquez sur le bouton « Créer raccordement EDI » pour initier une fiche de demande de raccordement.

 

3.1.1.1 Structure et système d’échange

 

Dans le bloc « Structure et système d’échange », sélectionnez la structure pour laquelle la fiche de raccordement est générée.

 

Sélectionner le système d’échange auquel vous souhaitez vous raccorder :

• PA CPRO pour l’émission de factures vers un client privé assujetti à la TVA, la transmission de données de transaction et de paiement, la consultation de l’annuaire de la facturation électronique ;
• CPRO pour la réception/consultation de factures en provenance de fournisseurs privés, l’émission de factures vers une entité publique.

 

3.1.1.2 Informations générales

 

Choisissez ensuite le protocole dans le bloc « Informations générales ».

 

Les protocoles de raccordements utilisables en EDI sur Chorus Pro sont :

•     PeSIT
•     SFTP
•     AS2

Les protocoles et leur mode de fonctionnement sont détaillés dans les spécifications externes.

Une fois le protocole choisi, les champs de configuration et de certificat s’affichent.

 

Précisions sur les algorithmes de chiffrement du système d’échange :

 

Pour le protocole PeSIT :

TLSv1.2

Cipher suites :

RSA_WITH_AES_128_CBC_SHA

RSA_WITH_AES_256_CBC_SHA

RSA_WITH_AES_256_CBC_SH256

ECDHE_RSA_WITH_AES_256_GCM_SHA384

 

Pour le protocole SFTP :

Encryption algorithms :
AES256_CBC, AES128_CBC

Key exchange algorithms :
DH_GROUP1_SHA1
ECDH_NISTP256
ECDH_NISTP384
DH_GROUP_EXCHANGE_SHA256

 

MAC algorithms :

HMAC_SHA1
HMAC_SHA256

 

 

 

Cliquez sur le bouton « Remplacer le fichier » pour télécharger le certificat sur votre poste.

 

Contrôlez et complétez les différents blocs de la page :

• Période de validité : Confirmer la période de validité du raccordement.

• Certificat(s) : Vérifier les données du certificat téléchargé.
• Contacts techniques : Renseigner les informations de contact de la personne chargée de la réalisation technique du raccordement. En cas de besoin, le support Chorus Pro pourra contacter la personne.
• Caractéristiques réseaux : Prendre connaissance des informations de paramétrage du réseau à utiliser et, le cas échéant, complétez-les.

 

Une vérification des données est appliquée lors de la saisie mais aussi à la validation de l’étape.

Cliquez sur « Suivant » pour poursuivre la création de la fiche.

 

3.1.1.3 Interfaces

 

La création de la demande de raccordement se poursuit avec le choix des abonnements aux interfaces.

Les interfaces dépendent du format d’échanges et du type de données transmises.

Le processus de création d’une fiche de raccordement en mode EDI est le même en émission ou en réception. La seule différence se situe au niveau du choix des « codes d’interface » proposés, qui incarnent les flux à gérer. 

Ci-dessous, un récapitulatif des flux proposés aux entités publiques pour l’émission de factures et cycles de vie en mode EDI :

 

Type de flux	Code interface	Format	Libellé	Provenance
Flux de dépôt de factures et ses cycles de vie	FSO3110A	UBL 2.1 (F2 - norme AFNOR)	Dépôt de factures.	Emetteur
	FSO3117A	Factur-x (F2 - norme AFNOR)	Dépôt de factures.	Emetteur
	CSI3110A	CDAR (F6 - norme AFNOR)	Compte-rendu d'irrecevabilité niveau Flux.	Chorus Pro
	CSI3117A	CDAR (F6 - norme AFNOR)	Compte-rendu d'irrecevabilité niveau Flux.	Chorus Pro
	CSO3110A	CDAR (F6 - norme AFNOR)	Compte-rendu d'acquittement niveau Objet Métier.	Chorus Pro
	CSO3117A	CDAR (F6 - norme AFNOR)	Compte-rendu d'acquittement niveau Objet Métier.	Chorus Pro
Flux cycles de vie	FEN4000A	CDAR (F6 - norme AFNOR)	Cycles de vie niveau Objet Métier.	Chorus Pro
	CEI4000A	CDAR (F6 - norme AFNOR)	Compte-rendu d'irrecevabilité niveau Flux.	Emetteur
	FEN4002A	CDAR (F6 - norme AFNOR)	Cycle de vie de cycle de vie rejeté niveau Objet Métier.	Chorus Pro
	CEI4002A	CDAR (F6 - norme AFNOR)	Compte-rendu d'irrecevabilité niveau Flux.	Emetteur
	FSO3300A	CDAR (F6 - norme AFNOR)	Cycles de vie niveau Objet Métier.	Emetteur
	CSI3300A	CDAR (F6 - norme AFNOR)	Compte-rendu d'irrecevabilité niveau Flux.	Chorus Pro
	FSO3302A	CDAR (F6 - norme AFNOR)	Cycle de vie de cycle de vie rejeté niveau Objet Métier.	Emetteur
	CSI3302A	CDAR (F6 - norme AFNOR)	Compte-rendu d'irrecevabilité niveau Flux.	Chorus Pro

 

Ci-dessous, un récapitulatif des flux proposés aux entités publiques pour la transmission de données de transaction et de paiement :

 

Type de flux	Code interface	Format	Libellé	Provenance
Dépôt de données e-reporting	FSO6000A	Format spécifique (F10)	Données de transaction et de paiement (e- reporting).	Fournisseur public
	CSI6000A	CDAR (F6)	Compte-rendu d’irrecevabilité niveau Flux.	Chorus Pro
Cycle de vie	FEN6000A	CDAR (F6)	Cycles de vie niveau Objet Métier.	Chorus Pro
	CSI6000A	CDAR (F6)	Compte-rendu d'irrecevabilité niveau Flux.	Emetteur

 

Les flux annuaires sont également proposés pour le raccordement G2B : FAR0057A et FAR0057B.

Une fois les abonnements aux interfaces sélectionnés, cliquez sur « Suivant ».

La création de la demande de raccordement EDI se poursuit avec le récapitulatif des données.

 

Après validation, une fenêtre s’affiche pour nommer le raccordement. Le nom du raccordement est limité à 100 caractères et est non modifiable. Il est unique sur le couple système d’échange/structure.

Une fois la demande validée, celle-ci passe au statut « En cours ».

 

3.1.2       Gérer une fiche de raccordement en EDI

 

Vous pouvez gérer les raccordements existants ou en cours depuis le tableau de bord de l’application « Raccordements EDI ».

 

 

La colonne « Statut » permet de vérifier si les raccordements affichés sont actifs ou non.

 

Les statuts pour les raccordements EDI sont :

• Brouillon : une demande a été initiée mais sa création n’a pas été finalisée. Les brouillons peuvent être supprimés par l’utilisateur ;
• En cours : la création de la demande a été finalisée et les données sont transmises au SE cible. La demande n’est pas modifiable à ce stade ;
• Partielle : le statut du flux est inactif pour une ou plusieurs interfaces. L’utilisateur devra contacter le support pour modifier le statut.
• Erreur : le SE cible a émis un retour KO. Une notification par mail est générée. Le statut n’est pas modifiable par le partenaire mais par un administrateur AIFE ;
• Actif/Inactif : le SE cible a émis un retour OK en fonction de la date de validité définie dans la fiche raccordement. Une notification est générée. Le statut est modifiable par le partenaire.

Les boutons présents en colonne « Actions » permettent de consulter le détail ou de modifier un raccordement.

La demande de raccordement EDI doit être au statut Actif ou Inactif pour être modifiée.

Les données de configuration, les certificats et les abonnements interface sont modifiables. Lors de la saisie et de la validation, les mêmes règles de gestion et de vérification sont appliquées qu’à la création.

La modification d’une demande de raccordement EDI ne permet pas de modifier :

• • Le système d’échange
  • La structure
  • Le protocole
  • Le nom du raccordement

Pour changer ces informations, il est nécessaire de procéder à la création d’une nouvelle fiche de raccordement.

La demande de raccordement EDI passe au statut En cours une fois les modifications enregistrées et les données sont transmises au système d’échange cible (maximum 24 heures entre le passage du statut « En cours » à « Actif » ou « En erreur »).

Les informations modifiées sont historisées.

 

3.2       Créer et gérer une fiche raccordement en API

 

L’accueil de l’application « Mes raccordements en API » affiche un tableau de bord des raccordements existants.

 

3.2.1       Créer une fiche de raccordement en API

 

Cliquez sur le bouton « Créer raccordement API » pour initier une fiche de demande de raccordement. Une application PISTE doit être créée au préalable.

 

Renseignez les informations de la fiche raccordement :

• Renseignez 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.
• Renseignez le type d’utilisation en le sélectionnant dans une liste déroulante. Si vous êtes utilisateur d’une solution éditeur ou opérateur, indiquez le nom de l’éditeur / opérateur.
• Renseignez les informations de contact de la personne chargée de la réalisation technique du raccordement. En cas de besoin, le support Chorus Pro pourra contacter la personne.

 

Après la saisie de données, cliquez sur le bouton « Suivant » pour confirmer la demande. Le statut du raccordement API passe à « Actif ».

Pour en savoir plus sur les modalités d’utilisation d’un raccordement API actif, consulter la page « Raccordement en mode Oauth ».

 

3.2.2       Gérer une fiche de raccordement en API

 

Vous pouvez consulter en détail et modifier les raccordements existants depuis le tableau de bord de l’application « Raccordements API ».

Les statuts pour les raccordements API sont :

• Erreur ;
• Actif/Inactif : Le statut est modifiable par le partenaire.

La modification d’une déclaration de raccordement API ne permet pas de changer de structure.

Les autres données sont modifiables et le statut Actif ou Inactif peut également être changé.

A la suite de la validation du récapitulatif des modifications, la déclaration de raccordement passe au statut Actif ou Inactif.

 

 

	En qualification	En production	Remarques
Rattachements du compte demandant le raccordement	1 rattachement à une structure SIRET du matelas de données	1 rattachement à une structure SIRET (celle de l’entité publique si raccordement direct, celle du tiers si recours à un tiers)	Habilitation nécessaire du compte au profil « Raccordements modification » (valable pour la qualification et la production)
Nombre de certificats en EDI	1	1	Au total, 2 certificats
Nombre de fiches de raccordement à créer	Si raccordement EDI ou API seul : 1 fiche Si raccordement EDI et API : 2 fiches	Si raccordement EDI ou API seul : 1 fiche Si raccordement EDI et API : 2 fiches	De 2 à 4 fiches

 

 

En cas de difficulté, vous pouvez joindre notre support en émettant un ticket.

 

Chaque environnement (qualification et production) dispose d’un portail de support propre pour émettre des tickets.

Privilégiez le dépôt de ticket en étant connecté à votre compte.

 

Retrouvez au lien suivant le mode opératoire pour émettre un ticket au support.