Étude de cas

WeInvoice — construire une Plateforme de Dématérialisation Partenaire agréée

Le problème

La réforme de la facturation électronique crée un nouveau rôle : les Plateformes de Dématérialisation Partenaires, chargées de transmettre les factures B2B et l'e-reporting à l'administration fiscale. Weproc a décidé de construire la sienne : WeInvoice.

Le cahier des charges est celui d'un système fiscal : des délais réglementaires stricts, aucune facture perdue ni dupliquée, une traçabilité opposable et des formats imposés — le tout en multi-tenant.

L'approche

• Une machine à états dont la base est l'autorité : PostgreSQL comme source de vérité unique, outbox transactionnel et Temporal comme exécuteur durable. Les garanties exactly-once sont obtenues par at-least-once + idempotence.
• La conformité outillée plutôt que déclarée : moteur de contrôles EN 16931 et règles métier (schematron), validation XSD, unicité de facture garantie côté applicatif et par contrainte en base.
• Les formats réglementaires en profondeur : convertisseurs UBL ↔ CII fidèles (aller-retour vérifié), assemblage Factur-X PDF/A-3 validé, génération de PDF lisibles.
• Une chaîne d'audit fiscale infalsifiable : empreintes SHA-256 chaînées scellant chaque facture, détection d'altération.
• Le réseau : Access Point et SMP Peppol auto-hébergés, synchronisation avec l'annuaire du Portail Public de Facturation.
• Les délais tenus par construction : un flux n'entre dans un lot que s'il lui reste de la marge sur son délai — le regroupement est une optimisation, le délai est une obligation. Quota de flux arbitré par réservation atomique en base (1 000 flux/h), rejeu du sous-ensemble sain d'un lot rejeté.
• Un écosystème pour les intégrateurs : sandbox déterministe, API OAuth2, webhooks signés livrés de façon idempotente, connecteur Stripe publié sur la marketplace.
• Le dossier d'immatriculation, pas seulement le code : rédaction du dossier technique déposé auprès de la DGFiP — descriptif des processus d'émission / réception, notes techniques des protocoles de communication (SFTP, AS2, AS4, API REST) — pour l'immatriculation de la plateforme, jusqu'à la levée des réserves.

Le résultat

WeInvoice est une PDP agréée par la DGFiP, en production, adossée à plus de 10 000 tests automatisés. Les choix d'architecture — Clean Architecture / DDD, orchestration Temporal, contrôles mécanisés — permettent d'absorber les évolutions réglementaires sans réécrire le cœur du système.

Stack : TypeScript, Node.js, Fastify, Temporal, Prisma / PostgreSQL, Angular, Peppol (AS4), Factur-X / UBL / CII.

Le sujet vous concerne ? Voyez aussi ma page facturation électronique.