API CONNECTEURS · V1

Reliez Odoo ou votre ERP au flux PharmaML.

Une API JSON stable entre les commandes des pharmacies et votre ERP/WMS. Chaque client utilise son sous-domaine, ses clés et ses identifiants propres.

Télécharger la spécificationOuvrir le cockpit
LGO / pharmaciePharmaML signéPmlFiTJSON HTTPSOdoo · ERP · WMS
01 · Catalogue

Synchroniser les produits

Recherchez par CIP13, GTIN ou référence interne et poussez jusqu’à 500 produits par appel.

curl https://nomduclient.pmlfit.fr/api/v1/products?limit=50 \
  -H "Authorization: Bearer pmlfit_xxx"
02 · Disponibilité

Calculer prix et quotas

Obtenez le tarif de la pharmacie, la disponibilité PharmaML et le quota restant sans le consommer.

POST /api/v1/availability
{ "pharmacyCode": "2243032", "lines": [...] }
03 · Commandes

Importer dans Odoo

Récupérez les commandes reçues avec leurs lignes, références, quantités acceptées et prix.

curl https://nomduclient.pmlfit.fr/api/v1/orders?state=confirmed \
  -H "Authorization: Bearer pmlfit_xxx"
04 · Retour ERP

Acquitter et suivre

Rattachez la référence Odoo et faites progresser le statut renvoyé ensuite à la pharmacie.

curl -X PATCH https://nomduclient.pmlfit.fr/api/v1/orders/ORDER_ID \
  -H "Authorization: Bearer pmlfit_xxx" \
  -H "Content-Type: application/json" \
  -d '{"state":"preparing","distributorReference":"ODOO-SO-0042"}'
05 · Livraison

Déposer un BLV PharmaML

Transmettez quantités, prix, TVA, lots et péremptions. PmlFiT génère le BLV et suit son acquittement.

curl -X POST https://nomduclient.pmlfit.fr/api/v1/delivery-notes \
  -H "Authorization: Bearer pmlfit_xxx" \
  -H "Content-Type: application/json" \
  -d '{"externalId":"ODOO-BL-0042","pharmacyCode":"2243032","deliveryReference":"BL/2026/0042","deliveredAt":"2026-08-30T14:42:00Z","lines":[{"lineNumber":1,"productCode":"3400930065785","deliveredQuantity":2}]}'
06 · Supervision

Contrôler le dépôt FIFO

Consultez les messages en attente, délivrés, acquittés ou expirés avec leur nombre de tentatives.

GET /api/v1/outbox?status=delivered
Scope requis : outbox:read
Sécurité

Sous-domaines, clés et secrets séparés.

Les clés API sont stockées sous forme de condensat SHA-256. Les secrets HMD5 PharmaML sont chiffrés en AES-256-GCM. Un appel présenté sur le sous-domaine d’un autre client est refusé.