API pour éditeurs de LGO

Ajoutez l'optimisation des achats génériques à votre logiciel d'officine

Une API REST qui reçoit les achats, les remises sur facture et les remises arrière d'une officine ou d'un groupement, et renvoie la répartition qui minimise le coût net : par groupe générique, par laboratoire et par CIP.

Pourquoi une API plutôt qu'un outil de plus pour vos clients

Vos clients pharmaciens et groupements ont déjà leurs achats dans votre logiciel. Leur demander d'exporter des fichiers vers un outil tiers, c'est perdre la plupart d'entre eux en route. Avec l'API Margen, l'optimisation apparaît directement dans votre interface, sous votre marque, à partir des données que vous détenez déjà.

  • Pour un LGO : proposer à chaque officine la liste « quoi acheter, chez qui » pour la fin de l'année, et l'économie attendue.
  • Pour un logiciel de groupement ou de centrale : consolider les officines adhérentes, préparer les rendez-vous laboratoires avec des volumes argumentés.
  • Pour un outil de commande ou de BI pharmacie : enrichir vos tableaux de bord d'un coût net optimisé et d'un écart chiffré.

Construire ou intégrer ?

Avec les assistants de code actuels, votre équipe peut écrire un optimiseur. La question n'est pas de savoir si elle en est capable, mais ce que cela coûte, combien de temps vos clients attendent, et qui le maintient ensuite. Faites le calcul avec vos propres chiffres :

Sur 3 ans, net du chiffre d'affaires de revente : intégrer Margen rapporte 60 300 €, le construire coûte 117 000 €. L'intégration économise 177 300 €, dont 22 500 € de revente perdue pendant le développement.

Coût net cumulé : sous la ligne 0, l'option rapporte plus qu'elle ne coûte.

-50 k€0 k€50 k€100 k€06 mois12 mois18 mois24 mois30 mois36 moisAPI · -60 k€Interne · 117 k€
Hypothèses et tableau des valeurs

Construire : 2 ingénieur(s) pendant 6 mois, puis 0.5 ingénieur pour tenir le référentiel (BDPM, Assurance Maladie, groupes génériques, biosimilaires) et le moteur, plus 300 € d'hébergement par mois. Intégrer : 1 mois-ingénieur, puis l'abonnement Partner. Chaque option encaisse la revente dès que la fonctionnalité est en production.

MoisAPI MargenDéveloppement interne
00 €0 €
6-900 €108 000 €
12-12 780 €109 800 €
18-24 660 €111 600 €
24-36 540 €113 400 €
30-48 420 €115 200 €
36-60 300 €117 000 €

Ce que l'IA écrit vite, et ce qu'elle ne vous donne pas

Soyons francs : avec un assistant de code, un solveur qui répartit des volumes entre labos s'écrit en quelques jours. Nous l'avons fait. Ce n'est pas le code qui coûte. Ce qui coûte, c'est de savoir quelles règles écrire, de disposer des données de référence, et de prouver que le chiffre affiché à un pharmacien est juste. Rien de cela ne se génère.

Les règles qu'il faut connaître avant la première ligne

Nous en avons compté une vingtaine, et aucune n'est écrite dans une documentation : elles sont dans les contrats labo, dans les textes, et dans les factures où elles se contredisent. Un seul exemple, public : le plafond légal des remises a changé trois fois en 2025. Un moteur qui ne le suit pas recommande des conditions hors la loi. Les autres règles, nous les avons trouvées une par une, sur des données réelles, et elles sont dans le moteur. Nous les détaillons en rendez-vous.

Les données que personne ne vous fournira propres

Le référentiel Margen (prix fabricant avec historique, groupes génériques, ruptures) est reconstruit chaque nuit à partir des publications officielles, chacune avec son format et son encodage, qui changent sans préavis. Un format qui change ou une liste publiée en retard, c'est notre problème, pas le vôtre.

Savoir que le chiffre est juste

Une recommandation fausse se voit à la première facture, et le pharmacien ne revient pas. Chaque requête passe par 26 contrôles sur ses lignes d'achats, de RSF et de remises arrière (CIP, FINESS, dates, quantités, taux, paliers) et renvoie des erreurs et des avertissements typés, ligne par ligne. Le mode backtest rejoue une année passée de vos propres clients pour mesurer ce que la recommandation aurait rapporté, avant de la leur montrer. Et chaque version du moteur est vérifiée contre des résultats de référence enregistrés : même entrée, même sortie, au centime.

Ajoutez l'optimisation en nombres entiers sur les paliers, la prévision des volumes de fin d'année avec un historique court, et un calcul qui tient sous la minute pour cinquante officines. Puis quelqu'un pour suivre les textes, les formats et les prix, chaque mois, pendant que vos ingénieurs construisent ce qui différencie votre logiciel.

Et aucune dépendance cachée : l'API ne conserve pas les données de vos clients (les requêtes sont traitées en mémoire), tout reste dans votre logiciel. Si vous décidez un jour de construire votre propre moteur, vous n'avez rien à récupérer chez nous.

Ce que fait l'API

Un appel à POST /v1/optimize contient les achats (CIP, mois, quantité, FINESS de l'officine), les remises sur facture par labo ou par CIP, et les barèmes de remises arrière par laboratoire (paliers, forfaits, objectifs périodiques). Le prix fabricant, les groupes génériques et les ruptures viennent du référentiel Margen, mis à jour chaque nuit à partir de la BDPM et des données de l'Assurance Maladie : vous n'envoyez que ce qui est propre à votre client.

En retour, pour chaque groupe générique :

  • la répartition recommandée entre laboratoires et CIP, et l'économie par rapport aux achats actuels ;
  • la liste to_buy : ce qu'il reste à acheter d'ici la fin de l'année, en boîtes, par CIP et par labo ;
  • les volumes prévus mois par mois, pour l'année en cours ou l'année suivante ;
  • en option, le détail par officine et par mois.

Trois modes couvrent les usages courants : current_year (optimiser le reste de l'année en cours), forecast_next (préparer l'année suivante et ses négociations) et backtest (mesurer ce qu'aurait coûté la répartition optimale sur une année passée). Le calcul se fait au niveau du groupement ou officine par officine.

Intégration : quelques semaines, pas des mois

  1. Créez un compte développeur et une clé de test dans la console.
  2. Vérifiez vos CIP avec GET /v1/reference/generics, puis envoyez une première optimisation.
  3. Récupérez le résultat immédiatement (Prefer: wait), par interrogation de /v1/jobs/{id} ou par webhook signé.
  4. Passez en offre Partner depuis la console pour obtenir vos clés live.

Le contrat est décrit en OpenAPI 3.1 (référence complète), les erreurs sont typées et chaque ligne invalide est signalée avec son chemin. Le tutoriel donne des exemples prêts à copier.

Prix : à l'officine active

L'offre Partner coûte 290 € HT par mois et inclut 30 officines actives ; au-delà, le prix par officine baisse avec le volume. Une officine active est un FINESS optimisé au moins une fois dans le mois avec une clé live : vous ne payez que les officines que vos clients utilisent réellement.

Officines actives dans le moisMontant mensuel HTSoit par officine
50470 €9,4 €
2001 820 €9,1 €
5003 920 €7,84 €
2 00012 420 €6,21 €

À comparer aux 29 € HT par officine et par mois de l'application Margen vendue en direct : vous restez libre de votre prix de revente. Grilles détaillées et offre Enterprise sur la page tarifs de l'API.

Données et conformité

L'API ne reçoit que des données commerciales : achats par CIP, prix, remises. Aucune donnée patient. Le contenu des requêtes est traité en mémoire et jamais stocké ; les résultats sont conservés 7 jours puis supprimés. Calcul et stockage sont hébergés dans l'Union européenne, et Margen agit en sous-traitant au sens de l'article 28 du RGPD (conditions et DPA).