GTPDP - Onboarding OD/PDP

   Ce formulaire permet de gérer l'inscription et la configuration auprès des services Cegid pour l'Opérateur de Dématérialisation des factures (OD), également appelé Concentrateur eFacture, ainsi que pour la Plateforme de Dématérialisation Partenaire (PDP) pour chaque établissement ayant un code SIRET distinct.

   Le processus d'inscription se déroule en plusieurs étapes, chaque étape étant associée à une action spécifique déclenchée par un bouton.

   L'utilisateur qui réalise ce processus doit être lié à un compte Cegid Account et doit être abonné aux services de "Gestion des utilisateurs - Administration" pour son identifiant de contrat (code SIC).

   En outre, le service "Cegid Opérateur de Dématérialisation" doit figurer dans la liste des services associés à l'identifiant du contrat. Ce service est activé pour le client lors de la souscription à l'offre Opérateur de Dématérialisation des factures.

   Cette interface permet également d'enregistrer une URL publique de callback pour l'utilisation des webhooks d'achats ou de ventes.

   Cela signifie que le service "Opérateur de Dématérialisation" sera autorisé à envoyer des notifications à l'URL publique de callback chaque fois qu'un événement pertinent se produit. Par exemple, lorsqu'une facture change de statut sur la PDP, l'information est transmise à l'Opérateur de Dématérialisation. Ce dernier enverra une requête à cette URL spécifiée pour signaler le changement. Le nouveau statut sera ensuite enregistré dans une table de la base de données, puis lu et propagé dans l'ERP là où cela est nécessaire.

   Les produits disponibles pour l'inscription sont définis dans le paramètre IDPGTPDP.

   La saisie du nom de l'inscription est libre.
Ce nom apparaîtra sur la Plateforme de Dématérialisation Partenaire (PDP) en lien avec l'inscription pour l'identifiant du contrat-SIRET.

   Identifiant du compte utilisé pour accéder aux applications de Cegid.
Pour Cegid XRP Ultimate On Demand, cet identifiant est proposé et ne peut pas être modifié.
Il doit être saisi pour Cegid XRP Ultimate On Premise.
Un client ne peut avoir qu'un seul identifiant de contrat (code SIC).

   Les informations à renseigner pour l'établissement sont :
   - le code établissement : à saisir uniquement si l'identifiant du produit est celui livré par Cegid XRP Ultimate. Les autres informations liées à l'établissement sont proposées et sont modifiables. Pour un identifiant produit externe les informations relatives à l'établissement sont saisies manuellement ;
   - le code SIRET de l'établissement ;
   - le nom de l'inscription ;
   - l'adresse complète.

   Le représentant de l'établissement se caractérise par :
   - son adresse e-mail ;
   - son prénom ;
   - son nom.

   Plateforme de Dématérialisation Partenaire sur laquelle l'inscription est réalisée.
Les plateformes disponibles sont définies dans le paramètre PDPGTPDP.

   Le statut permet de suivre l'avancement du processus d'inscription.
Les valeurs disponibles sont définies dans le paramètre STAGTPDP.

   Le message associé au statut est renseigné uniquement lorsqu'une étape de l'inscription a échoué. Lorsque le problème est résolu, le statut change et le message disparait.

   Le numéro de session est affecté lors du lancement de l'action "Ouvrir une session".

   Le customer ID est affecté sur l'action "Obtenir un Customer ID".

   Si le customer ID a déjà été retourné mais qu'il n'a pas été affecté, il faut relancer l'action "Ouvrir une session". Cette action ne retournera pas un nouveau numéro de session mais le customer ID.

   Si le code produit correspond au produit Cegid, l'utilisateur et le mot de passe sont stockés dans les mots de passe.

   L'identifiant de l'API Key et le mot de passe ne sont renseignés que pour l'inscription d'un produit autre que Cegid XRP Ultimate.
Attention, ces informations ne sont pas stockées en base, il faut donc les conserver manuellement. Elles seront nécessaire pour la finalisation de l'inscription à la plateforme et également pour les inscriptions aux Webhooks.

   Permet de s'inscrire aux Webhooks des achats.

   Permet de s'inscrire aux Webhooks des ventes.

   Cette URL correspond à une adresse accessible par les services de l'Opérateur de Dématérialisation sur laquelle les notifications sont reçues.
Pour Cegid XRP Ultimate On Demand, cette adresse est proposée et n'est pas modifiable.
Cette URL est obligatoire et n'est pas modifiable dès lors qu'au moins une inscription aux Webhooks est faite. Elle doit être la même pour les Webhooks achats et ventes si les deux inscriptions sont demandées.

   Le statut permet de suivre l'avancement du processus de l'inscription aux Webhooks des achats.
Les valeurs disponibles sont définies dans le paramètre SWAGTPDP.

   Le message associé au statut du Webhook des achats est renseigné uniquement lorsqu'une étape de l'inscription aux Webhooks des achats a échoué. Lorsque le problème est résolu, le statut change et le message disparait.

   Le statut permet de suivre l'avancement du processus de l'inscription aux Webhooks des ventes.
Les valeurs disponibles sont définies dans le paramètre SWVGTPDP.

   Le message associé au statut du Webhook des ventes est renseigné uniquement lorsqu'une étape de l'inscription aux Webhooks des ventes a échoué. Lorsque le problème est résolu, le statut change et le message disparait.

   Cette action permet d'obtenir une API Key pour l'inscription aux Webhooks des achats et/ou des ventes.
Une fois l'API Key obtenue, l'inscription aux Webhooks peut être lancée.

   Pour lancer l'inscription aux Webhooks des achats, il faut une API Key valide pour les Webhooks.

   Si le code produit ne correspond pas à un produit Cegid XRP Ultimate, et que les informations concernant l'identifiant et le mot de passe de la clé API ne sont pas renseignées, il est nécessaire de les saisir en utilisant ceux obtenus et conservés lors de l'inscription à la Plateforme de Dématérialisation Partenaire.

   Une fois l'inscription effectuée, le statut des Webhooks des achats change.

   Si une erreur se produit, des traces sont générées dans la consultation des traces du Onboarding.

   Pour lancer l'inscription aux Webhooks des ventes, il faut un token valide et une API Key pour les Webhooks.

   Si le code produit ne correspond pas à un produit Cegid XRP Ultimate, et que les informations concernant l'identifiant et le mot de passe de la clé API ne sont pas renseignées, il est nécessaire de les saisir en utilisant ceux obtenus et conservés lors de l'inscription à la Plateforme de Dématérialisation Partenaire.

   Une fois l'inscription effectuée, le statut des Webhooks des ventes change.

   Si une erreur se produit, des traces sont générées dans la consultation des traces du Onboarding.

   Cette action permet d'obtenir un token d'authentification suite à une connexion à Cegid Account. Une fois l'opération effectuée, une page s'ouvre pour indiquer si elle a réussi.
Veuillez noter qu'il est impératif d'être administrateur du compte CEGIDLIFE pour réaliser cette opération.
Si le token est obtenu avec succès, vous reviendrez à l'écran de Onboarding OD/PDP où le statut d'inscription passera à "Token obtenu" et le bouton "Ouvrir une session" sera activé.

   En cas d'échec, le statut reste inchangé et des traces de l'opération sont enregistrées dans la consultation des traces du processus de Onboarding OD/PDP.

   Pour continuer les étapes suivantes, un token valide est nécessaire.
Le token devient invalide dans les situations suivantes :
   - l'écran de Onboarding OD/PDP a été fermé ;
   - une recherche a été effectuée après l'obtention du token ;
   - le temps de validité du token a expiré.
Lorsque le token n'est plus valide, vous pouvez simplement en demander un nouveau via le bouton "Obtenir un token", qui reste accessible. Notez que le token n'est pas conservé à la fermeture de l'écran.

   Cette action permet l'ouverture d'une session afin d'obtenir ultérieurement le Customer ID.
Pour cela, le point d'accès au service de l'OD doit être paramétré dans le référencement des services avec l'identifiant : CEGID_EFACTURE.
Services pour un client :
   - Pour un accès au service de production : "https://efacture.cegid.cloud/api/".
   - Pour un accès au service de recette : "en attente"
Services réservés aux équipes Cegid :
   - Pour un accès en intégration : "https://inteapi-efacture.cegid.cloud/api/" ;
   - Pour un accès en Stagging : "https://testapi-efacture.cegid.cloud/api/".
Le numéro de session obtenu est enregistré et le statut change.

   En cas d'échec, le statut n'évolue pas. Des traces sont générées dans la consultation des traces du Onboarding.

   Pour pouvoir ouvrir une session le token doit être valide.

   Cette action permet d'obtenir un customer ID nécessaire pour s'inscrire à la Plateforme de Dématérialisation Partenaire et aux Webhooks.
Cette action n'est accessible que si le numéro de session a été obtenu.
Le point d'accès à l'OD doit être paramétré dans le référencement des services avec l'identifiant : CEGID_EFACTURE.

   Une nouvelle page HTML permettant une connexion à Cegid PDP s'ouvre pour effectuer l'inscription du représentant pour le SIRET sur la plateforme.

   Si le customer ID est obtenu avec succès, vous reviendrez à l'écran de Onboarding OD/PDP où le statut d'inscription passera à "Customer ID obtenu" et le bouton "Obtenir une API Key" sera activé.

   Si le customer ID n'est pas renseigné et le statut n'a pas changé, deux situations peuvent se présenter :
   - une erreur a été signalée dans la page HTML. Vous devez alors résoudre le problème et relancer la demande de customer ID ;
   - le customer ID a été attribué mais non enregistré dans la base de données. Dans ce cas, vous devez ouvrir à nouveau une session pour obtenir le customer ID et faire avancer le statut à l'étape suivante.

   Pour pouvoir obtenir un customer ID le token doit être valide.

   Cette action permet d'obtenir une API Key (utilisateur et mot de passe nécessaires à l'inscription sur la Plateforme de Dématérialisation Partenaire).
Cette action n'est accessible que si le customer ID a été obtenu.
L'URL d'inscription doit être paramétrée dans le référencement des services avec l'identifiant : CEGIDLIFE.

   L'API key renvoyée est :
   - stockée dans les mots de passe si l'identifiant du produit correspond à Cegid XRP Ultimate ;
   - affichée temporairement dans l'écran de l'inscription. Il faut alors conserver ces informations pour les affecter lors de la finalisation de l'inscription si elles ne sont plus présentes dans l'écran ou lors de l'inscription aux Webhooks.

   Le statut change et il est alors possible de finaliser l'inscription. Des traces sont générées dans la consultation des traces du Onboarding.

   Pour lancer cette action le token doit être valide.

   Cette action permet finaliser l'inscription sur la Plateforme de Dématérialisation Partenaire.
Cette action n'est accessible que si l'API key a été obtenue. Le statut change.

   Des traces sont générées dans la consultation des traces du Onboarding.

   Pour lancer cette action le token doit être valide.