Administration de la facturation électronique

Administration de la facturation électronique

Retrouvez la documentation du paramétrage initial de la facturation électronique en suivant ce lien Facturation électronique

Pour rappel, le provisionning initial ne s’effectue qu’une seule fois par code projet (=environnement ERP) puis on entre dans un mode d’administration décrit ici

image-20260518-152107.png

 

Paramétrer une ‘Recette’

Le mise en place de la RFE ne comporte pas à proprement parler de mode TEST ou RECETTE qui permette de faire un flux complet de recette.

Il est donc essentiel et important de bien noter que c’est la PRODUCTION qui est utilisée pour le paramétrage des données réelles pour un environnement d’utilisation réel.

Ce qui suit permet une Recette en sa basant sur le fait que les API de dépose de facture vers Docoon ne fasse pas réellement la dépose, mais effectue une Qualification de la facture pour vérifier sa conformité

 

DANS MYDIVALTO

Divalto propose une méthode pour vous permettre d’effectuer une recette à minima, en respectant un cahier des charges précis

  • vous devez disposer d’un CODE PROJET (=environnement en Saas) de TEST/RECETTE qui doit correspondre à l’identique strict en terme d’organisation (dossier, établissements, SIREN, SIRET, code routage)

    • car le paramétrage RFE de ce code projet de recette sera à saisir sur le code projet de Production. Exemple : vous voulez ajouter un SIRET en Recette => il faut saisir ce SIRET dans la RFE de Production pour pouvoir l’utiliser en Recette

    • le paramétrage de Recette sera déduit du paramétrage de Production en forçant le type de dépôt à ‘Qualification’, ce qui aura pour effet de n’envoyer aucune facture de Recette sur l’environnement de Production

  • vous devez savoir qu’il n’y a qu' UN seul compte Docoon, celui de Production. Le code projet de Recette permettra uniquement de simuler du paramétrage mais n’enverra pas de facture

    • lors d’une utilisation en Recette pour un envoi de facture, aucune facture n’apparaîtra dans Docoon !

    • le paramétrage pour HupApi de Recette est une stricte copie du paramétrage de Production, au type de dépôt près (il est forcé à Qualification)

  • si vous avez des dossier/établissement de Recette dans un code projet de Production, et que vous voulez les utiliser, il faudra bien saisir ces Siret dans le paramétrage, en indiquant un type de dépôt ‘Qualification’

image-20260518-152142.png
Cliquez sur le bouton ‘Lier un projet’ pour choisit le projet de Recette associé

DANS L’ERP

Dans l’ERP de RECETTE il faut indiquer une clé d’API dans la fiche dossier ou paramètres externes, en utilisant myDivalto pour générer cette clé avec le code projet de TEST

Une clé d’API est valable pour un code projet. Un site dispose en général de 2 codes projets (xxx-PROD et xxx-TEST). Il faudra donc attribuer à l’ERP de production la clé générée pour le code projet xxx-PROD, et à l’ERP de recette la clé générée pour le code projet xxx-TEST

Suite à une duplication d’un ERP de Prod vers un ERP de Recette, il faut remplacer la clé d’API par une clé du code projet de Recette, car la clé api du code projet de production n’est pas utilisable ailleurs qu’en production (et donc le dialogue n’est pas possible si la clé d’api ne correspond pas)

Administration d’un paramétrage existant

Regénérer des clés

Les boutons ‘Regénérer’ permettent de re-créer les clés d’API et paramétrages pour les flux entrant et sortant de Docoon

image-20260505-151919.png
  • Regénérer sur le flux entrant va re-générer la clé d’API côté Docoon et HubApi. Cette clé est utilisée notamment lorsque l’ERP dépose une facture via le HubApi vers Docoon. A noter que tout le paramétrage (siret, date de validité, type de dépôt) est re-généré à partir des informations myDivalto

  • Regénérer sur le flux sortant va re-générer la configuration HttpsOutConfig et le Webhook côté Docoon, ainsi que la clé d’API côté HubApi. Cette clé et paramétrage sont utilisés lors de déclenchement d'évènement depuis Docoon notamment lors d’une entrée de facture dans Docoon pour informer HubApi. A noter que la configuration et le webhook sont entièrement re-générés.

 

Modifier le compte ERP Datahub

Le bouton ‘Modifier’ concerne le compte ERP pour Datahub.

Il permet d’indiquer le login/mot de passe du compte ERP utilisé par HubApi pour appeler le Service Web ERP Datahub

image-20260505-151919.png

 

Ajout de SIREN ou SIRET ou Mandat

Les boutons d’ajout permettent d’ajouter un SIREN ou un SIRET.

image-20260518-151614.png

 

image-20260618-070409.png

 

image-20260518-151652.png

Dates de début = aujourd’hui

Date de fin = vide

image-20260518-151714.png

Dates de début mandat : aujourd’hui par défaut afin de permettre dès maintenant une émission/réception par rapport à la PA (aucune incidence sur l’envoi ou réception des factures)

 

Tout ajout de SIREN implique la signature d’un mandat associé. Il faudra donc obligatoirement ajouter un mandat pour chaque SIREN

Consultez la page dédiée à l’assistant pour plus d’informations Facturation électronique

Attention, la modification de date d’annuaire n’est possible que depuis un SIREN avec mandat signé

 

Regénérer un mandat non signé

Lorsqu’un mandat n’est pas encore signé, les informations restent modifiables (pensez à cliquer sur Enregistrer les modifications). Le bouton Regénérer le mandat permet de renvoyer le mandat en signature. Un nouvelle invitation à signer est envoyée ; l’ancienne ne sera pas exploitée

 

Mandat : quel est le dernier valable

myDivalto sert à générer, signer et transmettre les mandats à Docoon, mais n’est pas la référence de ce qui est valide

Le mandat actif et son type (émission et/ou réception) est visible depuis le portail Docoon directement.

C’est ce mandat qui fait foi

Depuis Docoon, menu Administration, puis Entité légale. Choisissez l’entité, puis dans le coin en bas à droite

image-20260702-101628.png

Relance invitation Docoon

L’invitation à créer le compte administrateur Docoon est valable 48h.

Si le client n’a pas cliqué à temps sur le lien, vous pouvez renvoyer une invitation depuis le paramétrage RFE. Une notification indique la réussite de l’envoi

image-20260903-065820.png
Bouton ‘Renvoyer l’invitation' avec le mail de la personne concernée

A noter :

  • si le compte a été activé, mais que la personne a oublié son mot de passe, cette relance n’a aucun effet ; il faut utiliser le ‘Mot de passe oublié’ du portail Docoon

  • si le mail est erroné (faut de frappe) il faut faire une demande au support

Erreurs de saisie

  • Vous avez saisi un mauvais SIREN et il a été créé dans Docoon

    • On ne peut pas modifier le SIREN d’une entité légale dans Docoon, il s'agit d'une contrainte de conception pour garantir l'intégrité des données.

    • Pour corriger la situation, voici la procédure à suivre : Désactiver l'entité légale créée avec le mauvais SIREN dans Docoon et créer une nouvelle entité légale avec le bon SIREN depuis myDivalto

  • Vous avez saisi un mauvais nom, prénom, téléphone de signataire

    • Tant que le mandat n’est pas signé, vous pouvez modifier le mandat, et cliquer sur le bouton “Regénérer” pour renvoyer une demande de signature

  • Vous avez un mandat à modifier

    • Rappel :

      • un mandat en EMISSION permet d’utiliser Docoon pour l’envoi (pas besoin d’inscription annuaire)

      • un mandat en RECEPTION permet d’utiliser Docoon pour la réception. Dans ce cas une inscription à l’annuaire PPF est obligatoire

    • Rappel : Le mandat actif et son type (émission et/ou réception) est visible depuis le portail Docoon directement. C’est ce mandat qui fait foi, myDivalto est l’outil qui sert à les générer et les envoyer

    • Si vous vous êtes trompé ou que vous souhaitez modifier, il faut ajouter un nouveau mandat qui va venir remplacer celui existant dans Docoon

Pour aider Divalto, vous pouvez fournir les informations demandées en suivant ces instructions Comment fournir à Divalto des informations de paramétrage Docoon

Transfert de PA - Changement dans les sens de mandats - Multi PA

Rappels de principes de la RFE

  • l’annuaire donne, en général pour un SIREN, la PA chargée de recevoir les factures

  • une PA qui gère l'émission de facture doit avoir mandat de la part du client pour le sens “EMISSION”, afin d'être autorisé à émettre des factures via l’annuaire vers une PA destinataire

  • une PA qui gère la réception de facture doit avoir mandat pour le sens “RECEPTION”, afin d'être autorisé à inscrire le client dans l’annuaire (et implicitement recevoir des factures)

On peut faire le parallèle avec un numéro de téléphone mobile. Vous donnez mandat à un fournisseur (ex: Orange) pour gérer votre numéro (SIREN). Quand vous appelez un numéro vous utilisez les services de votre fournisseur. Quand quelqu’un vous appelle, un annuaire national (+33) permet de trouver le fournisseur qui gère le numéro afin de contacter le mobile. Quand vous changez de fournisseur, il faut que votre annuaire passe de l’ancien au nouveau fournisseur, en demandant à votre nouveau fournisseur de faire la démarche.

1. Contexte & Enjeu

Dans le cadre de la Réforme de la Facturation Électronique (RFE), une entreprise peut choisir d'utiliser deux Plateformes Agréées (PA) distinctes :

  • Une PA pour les flux sortants (Émission)

  • Une PA pour les flux entrants (Réception)

Un cas survient lorsqu'un client a initialement signé un mandat global (Émission + Réception) chez Docoon et souhaite basculer la réception vers une autre PA, ou changer de PA.

2. Principe de fonctionnement de l'Annuaire (Protocole Inter-PA)

  • Fonctionnement de l'Annuaire Central (PPF) : L'affectation de la ligne de réception ne se gère pas par une action manuelle de suppression dans le portail Docoon ou myDivalto.

  • Règle inter-PA : Le protocole national entre PA stipule que la PA choisie par le client pour la réception fait la demande directe de transfert auprès de la PA qui détient actuellement la ligne avec un code de portabilité

  • Impact sur les flux entrants : Dès que la nouvelle PA récupère la ligne dans l'annuaire central, la réception bascule automatiquement vers cette nouvelle PA. Docoon ne recevra plus aucun flux entrant, même si l'ancien mandat de réception y figure encore techniquement.

3. Procédure opérationnelle (Étape par Étape)

Étape 1 : Paramétrage et bascule de la Réception (Immédiat & Non bloquant)

  1. Signature du mandat Réception : Le client donne mandat de réception à sa nouvelle PA.

  2. Transfert de l'Annuaire : La nouvelle PA demande à Docoon le transfert/récupération de la ligne d'annuaire du ou des SIREN concernés. Cette procédure est gérée entre PA

  3. Mise en service : La nouvelle PA inscrit l'entreprise dans l'annuaire et prend en charge le traitement des factures entrantes.

    Note : Cette étape ne nécessite pas d'attendre l'annulation préalable du mandat dans Docoon.

Étape 2 : Régularisation des mandats chez Docoon (Alignement contractuel)

A ce jour il n’est pas possible d’annuler un mandat ou un sens de mandat. Cette fonctionnalité sera disponible prochainement

4. Foire Aux Questions / Points d'attention

  • La présence de l'ancien mandat de réception chez Docoon bloque-t-elle la nouvelle PA ?
    Non. La gestion de l'annuaire prévaut. Si la nouvelle PA a récupéré la ligne d'annuaire, la réception fonctionne chez elle sans interférence avec Docoon.

  • Quel est l'impact sur les flux sortants (Émission) déjà en place chez Docoon ?
    Aucun impact. L'émission via Docoon continue de fonctionner normalement pendant et après la transition de la réception.

  • Multi-PA avec sous-découpage

Dans l’absolu, il est possible d’avoir 2 PA en réception en même temps, mais sur des lignes d’annuaires différentes. myDivalto et Docoon utilisent la ligne en SIREN* ce qui rend les sous-lignes possibles

Administration Docoon

Dans le portail Docoon, une administration est possible.

A ce jour (juin 2026), il est possible de créer des comptes d’administrateurs

Certaine fonctions sont actuellement accessibles, mais ne doivent pas être manipulées directement

  • clé d’API principale : cette clé doit être administrée dans myDivalto, car elle doit aussi être connu par la plateforme Divalto Cloud

  • Configuration (webhook et callback) : les configurations doivent être administrée dans myDivalto, car elle doit aussi être connu par la plateforme Divalto Cloud

  • Entité légales : l’ajout d’entité (SIREN) doit se faire dans myDivalto, car l’ajout a un impact sur le paramétrage de la plateforme Divalto Cloud

  • Structures : j’ajout de structure (SIRET) doit se faire dans myDivalto, car l’ajout a un impact sur le paramétrage de la plateforme Divalto Cloud

La gestion de utilisateurs fine, ainsi que des services de l’entreprise (achat, compta,…), sont des fonctionnalités Docoon dépendantes de la roadmap Docoon