Distribution automatisée des factures / notes de crédit reçues via Peppol

- 10/04/2025

Overview

Les processus décrits ici permettent d'automatiser la distribution des messages provenant du réseau Peppol, contenant une facture ou une note de crédit. Lors de la réception d'un message via le PeppolBoxHelper, celui-ci sera décodé et distribué, en fonction de son contenu, à tel ou tel département. Cette distribution se fait via une action du CRM de Mercator. Cette action contient un bouton permettant l'injection de la facture / note de crédit, soit en gestion commerciale, soit en comptabilité. Dans les modèles proposés ici, l'action est conçue comme une tâche.

Actions et responsabilités

• Deux actions sont créées :
  • Document Peppol à importer : pour la gestion commerciale (par exemple, les factures de marchandises)
  • Ecriture Peppol à importer : pour la comptabilité (par exemple, les factures de frais généraux)

Les modèles d'action sont disponibles dans le fichier zip ci-dessous. Pour installer ces actions :

• Dézipper le fichier ZIP ci-inclus
• Plus d'information pour une installation rapide.

Une tâche en mode console télécharge à intervalle régulier les messages. La PeppolBox n'est donc plus utilisée. La méthode à placer dans le customizer Main est reprise ci-dessous. Chaque message correctement identifié fera l'objet de la génération d'une de ces deux actions.

Extraits de code (illustratifs) ne sont pas destinés à être exécutés tels quels dans ce document.

Dans le fichier ini, cette ligne sera spécifiée :

Task1=DownloadAndDispatchPeppolMessages

Les tests permettant de déterminer l'action à générer doivent être adaptés selon des critères à concevoir. Ce code, par exemple, permet d'obtenir le numéro de TVA du fournisseur qui peut être utile pour son identification préalable à l'attribution de l'action :

XmlNode nodeNumTva = parsedContent.XmlSelectNodes(...).FirstOrDefault();

string numTva = nodeNumTva?.InnerText;

Les actions générées apparaissent dans la liste des tâches des utilisateurs concernés. Le cas échéant, la liste des destinataires peut être modifiée en agissant par code sur les droits de l'action. Chaque action contient un PDF permettant de prévisualiser la facture / note de crédit. Elle contient aussi un bouton permettant de déclencher l'import proprement dit.

Par exemple, pour l'import en gestion commerciale, le code de ce bouton est :

/* Code illustratif — voir version complète dans le fichier source */

Pour l'import en comptabilité, la dernière ligne doit simplement être modifiée : StartImportIntoAccounting

Une fois l'écriture ou le document de la gestion commerciale généré et sauvegardé, la tâche est automatiquement marquée comme fait.

Il faut noter que ce paramétrage ne supprime pas les messages de la PeppolBox. Les messages sont supprimés après importation et sauvegarde, si l'utilisateur répond par l'affirmative à la question Supprimer ce document de la PeppolBox ?. Comme lors d'une importation habituelle depuis la PeppolBox.

Le paramétrage ci-dessous montre comment donner la possibilité à un utilisateur de créer ces actions manuellement depuis la PeppolBox. Cela permet, par exemple, à un administrateur de distribuer les messages qui n'ont pas pu être traités automatiquement par la tâche illustrée ci-dessus. Ceci se fait en codeless via le paramétrage de grilles sans code.

• Y cocher AutoAddCustomColumns
• Placer ce StringUpdater :
  • à gauche : as isnew
  • à droite : as isnew, UserDefinedButtonColumnCustom
• Ensuite, on ajoute une règle de colonne dans la propriété CustomRules :
  • Name :UserDefinedButtonColumnCustom
  • Width : 50
  • ButtonText : Action

Et enfin placer ce code dans le customizer PeppolBox :

Extraits de code illustratifs pour le customizer PeppolBox (non détaillés dans ce document)

A télécharger : .zip (13 Kb - 25/03/2025)