Loading....
Print Friendly, PDF & Email

INTRODUCTION

Chorus Pro offre deux modes de raccordement aux structures émettrices et réceptrices de factures :

  • EDI ( Electronic Data Interchange) ;
  •  API (Applicative Programing Interface).

Ces services facilitent le dépôt, la récupération et le traitement des factures. Leur activation nécessite d’effectuer un raccordement entre le système d’information financier de ces structures et Chorus Pro.

Un espace dédié Raccordements EDI/API est mis à disposition sur le portail Chorus Pro, il permet de réaliser une demande de raccordement en automatique à Chorus Pro.

PERIMETRE ET PREREQUIS

Le raccordement à Chorus Pro s’effectue en deux temps : 

  • Un raccordement à l’environnement de qualification ; 
  • Un raccordement à l’environnement de production.

Le présent guide présente la démarche à effectuer pour un raccordement à l’environnement de production. Concernant l’environnement de qualification, merci de vous reporter au mode opératoire dédié à l’espace de qualification sur la Communauté Chorus Pro. La Communauté contient également des précisions sur l’ensemble du processus de raccordement.

Toutes les structures émettrices ou réceptrices de factures peuvent demander un raccordement à Chorus Pro, qu’il s’agisse de structures publiques ou privées. La création d’une fiche de raccordement nécessite : 

  • D’avoir pris connaissance de la documentation technique (notamment les rubriques) :
    • spécifications externes
    • utiliser Chorus pro en mode EDI
    • OU utiliser Chorus Pro en mode API
  • Pour un raccordement en EDI, de disposer d’un certificat numérique valide ;
  • De disposer de toutes les informations techniques de paramétrage du raccordement , notamment :
    • en EDI : protocole de raccordement, adresse IP, etc.
    • en API : code application PISTE.

 

Point d’attention : Une demande de raccordement nécessite une expertise technique, c’est pourquoi elle doit être réalisée en partenariat avec des équipes disposant de ces expertises.

 

Pour les structures à raccorder en API, la création d’un utilisateur technique est également un prérequis.

Avant de procéder à un raccordement à Chorus Pro en production, il est préconisé d’avoir effectué un raccordement en qualification, à moins que l’éditeur de la solution informatique utilisée par la structure soit déjà raccordé en qualification.

Les structures s’appuyant sur un opérateur de dématérialisation (dont les tiers de télétransmission homologués pour les collectivités et établissements publics en EDI) n’ont aucune demande de raccordement à effectuer

 

Les structures souhaitant se raccorder en mode API doivent créer un utilisateur technique, directement à partir de la solution Chorus Pro. La création d’un utilisateur technique est détaillée dans le guide Administrer les structures et les utilisateurs à la rubrique 4.3 – Rattacher un utilisateur technique à une structure

Pour accéder à Chorus Pro et créer une fiche de raccordement, il faut : 

  • Disposer d’un compte utilisateur
  • Disposer d’une fiche structure

Le gestionnaire principal ou secondaire de la structure doit avoir : 

  • Paramétré l’Espace raccordement EDI et API structure
  • Rattaché au moins un utilisateur à cet espace

Si vous n’êtes pas gestionnaire principal ou secondaire de la structure, il est possible de : 

  • Demander le rattachement à une structure
  • Demander l’abonnement à l’Espace raccordements EDI et API

 

L’utilisation de la fonctionnalité Espace de raccordement est très ponctuelle, et ses fonctionnalités sont très spécifiques. Nous préconisons donc de limiter fortement le nombre de personnes habilitées sur cet espace.

Il est par exemple possible de limiter cet accès à un gestionnaire (principal ou secondaire), et à un utilisateur (qui peut avoir un profil plus technique).

Pour utiliser l’Espace raccordements EDI et API sur une structure, le gestionnaire principal ou secondaire active cet espace à partir de l’onglet Activités du gestionnaire.

Identifier la structure pour laquelle l’espace raccordement doit être ajouté, puis cliquer sur l'icône crayon.

Dans le bloc Espaces, sélectionner Ajouter des espaces.

Sélectionner les droits d’accès à l’Espace raccordement EDI et API  en Modification.

Valider la saisir à l'aide du bouton Valider en bas de page.

L’Espace raccordement EDI et API est actif et devient visible dans le bandeau supérieur de Chorus Pro pour le(s) gestionnaire(s) de la structure après une reconnexion de l’utilisateur.

Suite à l’activation de l’Espace raccordement, les utilisateurs de la structure peuvent demander à s’y abonner. L’abonnement d’un utilisateur à un espace se fait en deux temps :

  1. L’utilisateur effectue une demande d’abonnement à l’espace Raccordements EDI et API 
  2. La demande d’abonnement est validée par un gestionnaire

 

Point d’attention :

Pour en savoir plus sur l’abonnement des utilisateurs à un espace, veuillez-vous reporter au guide utilisateur Activités du gestionnaire. – paragraphe 3 – Gérer les demandes d’abonnement à des espaces.

Pour effectuer une demande de rattachement, les utilisateurs sélectionnent l’onglet Mon compte dans le bandeau supérieur.

L’utilisateur se rend dans le bloc Mes abonnements aux espaces . et clique sur Ajouter un abonnement

L’utilisateur sélectionne la structure concernée par sa demande, et sélectionne Raccordement EDI et API dans le champ Espace.

En fonction des droits demandés, les champs Consultation et/ou Modification sont sélectionnés.

La demande est soumise en cliquant sur Valider.

Après création de la demande de rattachement, un gestionnaire de la structure peut la valider à partir de l’onglet Activités du gestionnaire du bandeau supérieur.


Le gestionnaire sélectionne les demandes de rattachements à valider à l’aide du bouton à cocher, puis valide le rattachement en cliquant sur Valider.

GESTION DES RACCORDEMEMTS

Dans le menu de navigation, cliquez sur Raccordements EDI et API.

Si le lien vers l’Espace raccordements n’est pas visible, veuillez vérifier le paramétrage de votre compte et de la structure, en vous référant aux prérequis.

Cliquez sur l’onglet Raccordement EDI et API permet d’accéder à la liste aux onglet actifs pour cette fonctionnalité, par défaut l’onglet affiché est Accueil.

Sélectionnez Créer Fiche EDI pour accéder à la création d’une fiche de raccordement EDI.

Lors de la création de la fiche de raccordement, il est nécessaire de fournir un certificat valide répondant aux exigences techniques d’un raccordement à Chorus Pro. Ces exigences sont détaillées dans le document Certificats.

Type de certificat :

  • Client et serveur pour les raccordements EDI PeSIT
  • Serveur pour les raccordements EDI AS2
  • Client pour les raccordements EDI SFTP

Liste des fournisseurs : Un lien dans le document Certificats renvoie vers la liste des fournisseurs de certificats (liste LSTI).

Format du certificat : Les certificats doivent être transmis au format pkcs 7 avec l’ensemble de la chaîne de certification.

Attention :Un même certificat ne peut pas être utilisé pour plusieurs raccordements, même pour des structures différentes.

Sélectionnez la structure pour laquelle la fiche de raccordement est générée grâce au champ Partenaire, puis confirmer le Protocole de raccordement à utiliser.

Cliquez sur Parcourir afin de télécharger le ou les certificats sur votre poste (en fonction du protocole de raccordement sélectionné, le nombre de certificats peut varier).

Validez votre saisie à l’aide du bouton Analyser e(s) certificat(s).

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

  • PeSIT - Protocole Echanges Système Interbancaire Télécompensation
  • SFTP - Secure File Transfer Protocol
  • AS2 - Applicability Statement 2 Les protocoles de raccordement et leur mode de fonctionnement sont détaillés sur la communauté dans le dossier Spécifications externes (Chap. 9 dédié aux protocoles de raccordement).

Dans les zones :

  • Informations générales : Confirmez la période de validité du raccordement.
  • Certificat(s): Vérifiez les données du certificat téléchargé.
  • Contacts techniques : 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.
  • Caractéristiques réseaux : Prenez connaissance des informations de paramétrage du réseau à utiliser et, le cas échéant, complétez-les.

Exemple en SFTP  :

  • Codes interfaces : L’écran suivant offre la possibilité de sélectionner les flux EDI pour lesquels un raccordement sera à réaliser.

Les flux disponibles en mode EDI sont détaillés dans le tableau ci-dessous. Certains choix de flux ne sont pas proposés pour les raccordements en production (en gras) dans la mesure où ils ne concernent pas directement les entités qui se raccordent :

Pour chaque code interface, confirmez les modes de traitement à mettre en oeuvre :

  • Pas de raccordement : pas de raccordement pour le flux
  • Complète : raccordement pour le flux, une erreur sur l’une des pièces d’un flux entrant, entraine le rejet de l’intégralité du flux (1facture en erreur sur un lot de 100 factures entraine le rejet de toutes les factures)
  • Partielle : raccordement pour le flux, une erreur sur l’une des pièces d’un flux entrant, n’entraine pas le rejet de l’ensemble du flux (1facture en erreur sur un lot de 100 factures, interdit l’intégration de la facture en erreur, mais ne bloque pas l’intégration des 99 autres pièces).

 

  • Commentaires : offre la possibilité de contextualiser votre fiche de raccordement.
  • Soumission : cliquez sur Soumettre pour envoyer le formulaire. Le bouton Enregistrer permet de conserver le formulaire en mode brouillon sans le transmettre pour traitement.
  • Envoi : sélectionnez Confirmer et envoyer pour transmettre la fiche de raccordement.

Cliquez sur l’onglet Rechercher Fiche EDI dans le bandeau supérieur.

Renseigner un critère de recherche parmi ceux disponibles (ex : Partenaire).

Lancez la recherche en cliquant sur Rechercher.

Les résultats de la recherche sont affichés en bas de page, ils peuvent être exportés en cliquant sur le bouton Exporter les résultats.

Les fiches de raccordement peuvent avoir les statuts suivants :

  • Activée
  • Brouillon
  • Désactivée
  • Envoyée
  • Envoyée MAJ

Les fiches de raccordement au statut Brouillon peuvent être modifiées en cliquant sur le bouton crayon.

Point d’attention : un traitement automatique assure la prise en charge des demandes de raccordement. Une fiche de raccordement opérationnelle porte un statut Activée. Si jamais votre fiche ne porte pas le statut Activée le lendemain de son dépôt, il est conseillé de vous rapprocher du Support.

Depuis la mi-janvier 2020, la création d’un nouveau raccordement en API en mode certificat n’est plus possible. Seul est possible le renouvellement de certificat sur un raccordement existant.

Les nouveaux raccordements en API doivent être effectués en mode Oauth2.

En cas de difficulté, veuillez contacter l’équipe support de Chorus Pro.

1. Prérequis

Afin d’effectuer un appel API Chorus Pro, il est impératif qu’au préalable l’utilisateur :

  • Se soit créé un compte dans PISTE en sélectionnant l’organisation UNIVERSELLE  sur laquelle se trouve les API Chorus Pro.
  • Ait créé son application dans PISTE

Ces étapes sont décrites dans le guide utilisateur PISTE mis à disposition des utilisateurs de la plateforme.

 

Document de référence disponible sur le site de PISTE :

https://developer.aife.economie.gouv.fr/help-center/guide

UserGuide_navigation_FR (Version du 12/08)

 

Le présent guide, décrit les étapes à réaliser dans Chorus Pro pour déclarer son raccordement API dans Chorus Pro.

Avant cette déclaration, il est important d’avoir réalisé les prérequis ci-dessous :

  • Disposer d’un compte Chorus Pro
  • Etre rattaché à une structure
  • Créer un compte technique
  • Avoir l’espace  Raccordement EDI & API  ouvert en modification

 

2.Procédure

2.1    Déclaration d’un raccordement PISTE

Afin de déclarer un raccordement PISTE, l’utilisateur connecté doit :

  • Cliquer sur l’espace Raccordement EDI & API
  • Cliquer sur Gérer mes raccordements

  • Cliquer sur Déclarer un raccordement PISTE  situé en bas de la page comme illustré ci-dessus.

La page de saisie d’un raccordement PISTE s’affiche.

  • Renseigner 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.
  • L’utilisateur doit aussi renseigner le type d’utilisation en le sélectionnant parmi une liste déroulante. S’il indique être utilisateur d’une solution éditeur ou opérateur, il lui est demandé d’indiquer le nom de l’éditeur / opérateur.

écran présentant le type d'utilisation API

  • Après la saisie de données, valider le raccordement, qui passe à  ACTIF .

Cliquez sur l’onglet  Gérer raccordement API dans le bandeau supérieur.

 

 

Par défaut, tous les raccordements s’affichent, en mode certificat comme en mode Piste.

Selon qu’il s’agit d’un raccordement en mode certificat ou Oauth2, il faut filtrer éventuellement sur Structure et Etat courant , soit dans la partie haute de l’écran (raccordement par certificat), soit dans la partie basse (raccordement en mode Oauth2 – Piste)

WEBINAIRE

Inscrivez-vous aux prochains webinaires

Dernière mise à jour : janvier 20, 2020  

32903    Le Raccordement à Chorus Pro, Le Raccordement à Chorus Pro., Se Raccorder à Chorus Pro, Se Raccorder à Chorus Pro.    
Back To Top