Tribalbyte

Automatiser l’administratif / BPMN 2.0

De la feuille de temps validée
à la facture.

Chaque mois, la même suite de gestes : retrouver l’e-mail d’approbation, lire le PDF, compter les jours, créer la facture. Un processus court, répétitif et sensible aux erreurs de saisie.

Cadre
Activité de Tribalbyte
État
Script API développé · validation réelle à confirmer
Outils
PowerShell · Python · IMAP · API Billit

Le besoin

Dans une mission en sous-traitance, la feuille de temps est approuvée par le client final, qui l’envoie par e-mail. Le consultant facture ensuite la société intermédiaire. Les jours facturés doivent correspondre exactement à ceux qui ont été approuvés.

Deux versions

La première version décrite dans cette fiche récupère le relevé d’heures, extrait les informations du PDF et prépare la facture. Un script PowerShell de seconde version est désormais présent : il recherche la feuille approuvée, contrôle le mois et les doublons, puis prévoit la création de la facture par l’API Billit avec le PDF joint. Une option d’envoi Peppol vérifie d’abord la pièce jointe enregistrée. La présence du code est confirmée ; une création ou un envoi réel réussi reste à établir.

Le schéma ci-dessous décrit le processus de la seconde version. La revue du code confirme les étapes développées ; le schéma ne vaut pas preuve d’exécution réelle dans Billit.

Le processus documenté

Créer la facture d’un mois presté

BPMN 2.0 · processus collaboratif
Processus BPMN de facturation mensuelleTrois pools : le client final approuve la feuille de temps et l’envoie par e-mail ; le script retrouve le mail, extrait les jours prestés, calcule les dates et crée la facture ; le logiciel de facturation l’enregistre et la numérote.Client finalScript de facturationBillitFin de moisApprouver lafeuille de tempsMail d’approbation+ PDFMois demandé(ex. 2026-09)Retrouver le maild’approbation(IMAP)Mailtrouvé ?Rien à facturer(signalé)Extraire les joursprestés du PDFCalculer dateet échéanceCréer la facturede venteFacturecrééeEnregistrer etnuméroterDate de facture = date de livraison= jour de création ; échéance =dernier jour du mois suivantnonouifeuille de tempsfacturenuméro

← Faire défiler le schéma →

Trois participants, reliés uniquement par des messages. Le chemin « non » rend explicite le cas d’un mois sans approbation : rien n’est facturé, et c’est signalé.

Règles de gestion

Ce que l’outil doit respecter.

  1. RG-01Les jours facturés proviennent exclusivement de la feuille de temps approuvée.
  2. RG-02Date de facture = date de livraison = jour de création.
  3. RG-03Échéance = dernier jour du mois suivant.
  4. RG-04Le numéro de facture est attribué par le logiciel de facturation, jamais par le script.
  5. RG-05Un seul client facturé à ce stade : la société intermédiaire.

Pourquoi le schéma avant le code

Les règles de dates paraissent évidentes jusqu’au moment de les écrire. Les poser noir sur blanc avant le développement évite qu’elles soient décidées implicitement par le code.

Prochaines étapes

  • Valider la lecture de la feuille de temps sur plusieurs mois.
  • Créer la facture par l’API et la comparer à la version manuelle.

État au 13 octobre 2026

Une réalisation, un périmètre précis.

Ce qui est réalisé

Script V2 présent : lecture IMAP, contrôle de la feuille approuvée et du mois, tarif applicable, prévention des doublons, création API avec PDF joint, mode de prévisualisation et option Peppol conditionnée à la vérification de la pièce jointe.

Ce qui a été vérifié

Les fonctions ont été constatées dans le code Facturer-Prestations.ps1 le 13 octobre. Aucune exécution n’a été lancée pendant cette revue ; aucun résultat réel de création ou d’envoi réussi n’est confirmé.

Limites actuelles

L’inventaire initial ne relevait que l’étude API ; ce script apporte une preuve de développement supplémentaire. Sa présence ne confirme ni la connexion actuelle ni la bonne exécution de bout en bout. Le périmètre client reste ciblé.

Prochaine étape

Valider sur un jeu de référence les contrôles d’approbation, de période, de doublons et de pièce jointe, puis confirmer un parcours maîtrisé de création avant d’évaluer l’option d’envoi.

Exemples de critères de recette

Ces critères décrivent le résultat attendu. Ils ne constituent pas, à eux seuls, des tests réussis.

  1. Pour un mois sans e-mail d’approbation, le traitement signale l’absence et ne prépare ni ne crée aucune facture.
  2. Une facture déjà présente bloque une nouvelle création par défaut ; un envoi Peppol ne part que si le PDF récupéré depuis Billit possède la même empreinte que la feuille approuvée.

Parlons de votre projet

Un besoin concret.
Une première discussion.

Un processus trop manuel, une donnée peu fiable ou une idée à tester ? Commençons par clarifier ce qui vous serait vraiment utile.

Échanger avec Loïc