Plateforme de commande pour grossiste pharmaceutique et ERP

Une plateforme de commande B2B pour la distribution pharmaceutique en gros : un mini-programme acheteur, une console opérateur et une API Spring Boot. Des tâches planifiées récupèrent produits et stocks dans l'ERP du distributeur et lui renvoient commandes et clients, avec nouvelles tentatives.

EN BREF : Nous avons mis en place la commande en libre-service pour un grossiste pharmaceutique tout en laissant l’ERP du distributeur faire référence : des tâches planifiées récupèrent catalogue et stocks, renvoient commandes et clients avec nouvelles tentatives, et interrogent l’état des documents jusqu’à l’expédition des marchandises et l’émission des factures.

Vue d’ensemble

Pharmacies et cliniques commandent via un mini-programme. Les opérateurs gèrent produits, habilitations des acheteurs, commandes et SAV dans une console web. Produits, stocks et factures viennent toujours de l’ERP ; la plateforme n’envoie que les commandes payées et validées, avec leurs clients.

Flux d'intégration : le mini-programme acheteur et la console opérateur utilisent l'API de la plateforme ; des tâches planifiées récupèrent dans l'ERP les produits toutes les 30 minutes et les stocks chaque minute, envoient commandes et clients chaque minute avec nouvelles tentatives, et interrogent l'état des documents toutes les 5 minutes, transformant les bons de sortie comptabilisés en commandes expédiées et récupérant les factures.

Problème

Les acheteurs en gros voulaient commander en libre-service, mais stocks, comptabilité et facturation devaient rester dans l’ERP. Les deux systèmes devaient rester cohérents via une spécification d’interface publiée côté ERP.

Contraintes

  • L’ERP fait référence pour les produits, les stocks, l’état des documents et les factures.
  • Les habilitations des acheteurs doivent être vérifiées avant l’achat, y compris par reconnaissance des documents de licence téléversés.
  • Développement et tests doivent tourner sans accès réel au paiement, à la logistique, aux notifications ni à l’ERP.

Architecture

ÉlémentMise en œuvre
Back-endJava 17, Spring Boot 3.3, MySQL 8, Redis, stockage objet compatible S3, migrations Flyway
ClientsMini-programme d’une plateforme de messagerie pour les acheteurs ; console opérateur en Vue 3
Adaptateur ERPBascule entre une simulation en mémoire, qui fait avancer les commandes jusqu’à « comptabilisé » et produit les factures, et l’implémentation HTTP
PlanificationCatalogue toutes les 30 minutes ; stocks chaque minute ; envoi des commandes et clients avec nouvelles tentatives chaque minute ; interrogation de l’état des documents toutes les 5 minutes
ExploitationPage d’intégration dans la console avec état et journaux de synchronisation ; synchronisation, envoi et interrogation peuvent être lancés à la main

Décisions clés

  1. Récupérer et interroger, sans base partagée. La plateforme n’accède à l’ERP que par son interface publiée ; un changement de schéma d’un côté ne casse pas l’autre.
  2. Adaptateurs simulés d’abord. Paiement, logistique, notifications et ERP ont chacun leur simulation, ce qui permet de faire tourner en local tout le cycle de vie d’une commande, facturation comprise, sans identifiants partenaires.
  3. Les secrets restent hors du dépôt. La CI lance la vérification back-end, le lint, le contrôle de types, les tests et le build de la console, ainsi qu’une recherche de secrets ; seuls des fichiers d’environnement d’exemple sont commités.

Éléments de preuve

  • 45 classes de test back-end et 56 fichiers de migration.
  • Les documents de déploiement en production couvrent mise en production, rollback, rotation des secrets, sauvegarde et restauration.

Limites

Le volume de commandes, le nombre d’acheteurs, la date de mise en service et les conditions commerciales ne sont pas publiés.

Questions fréquentes

Comment le stock reste-t-il synchronisé avec l'ERP ?

Les produits sont récupérés toutes les 30 minutes, les stocks chaque minute. Commandes et clients sont envoyés avec nouvelles tentatives. L'état des documents est interrogé toutes les 5 minutes.

Peut-on développer sans accès au véritable ERP ?

Un adaptateur ERP simulé reproduit le cycle de vie des documents, facturation comprise.

Que se passe-t-il quand un envoi vers l'ERP échoue ?

L'enregistrement reste en file et est retenté au passage suivant, qui tourne chaque minute. Les opérateurs voient les journaux de synchronisation et peuvent relancer l'envoi depuis la console.