Pourquoi cette API change tout
Sans API, le quotidien d'un pharmacien client UPROMEDIC ressemble à ceci :
- Vous recevez la livraison physique avec le BL imprimé.
- Vous vérifiez ligne par ligne ce qui est livré contre le BL.
- Vous saisissez chaque médicament dans votre logiciel : nom, lot, péremption, quantité, prix d'achat, TVA.
- Vous re-vérifiez les totaux pour ne pas avoir d'écart.
- Vous archivez le BL papier.
Pour une pharmacie qui reçoit 2-3 livraisons UPROMEDIC par semaine avec 30-80 lignes par BL, cela représente 2 à 4 heures de saisie par semaine. Sur l'année : 100 à 200 heures — 2,5 à 5 semaines de travail à temps plein.
Avec l'API : 1 clic. Le BL est importé en intégralité avec tous les détails déjà remplis. Temps : 30 secondes. Erreurs de saisie : nulles.
Architecture technique de l'API
L'API UPROMEDIC est exposée sur https://api.upromedic.org/v2. Elle utilise une authentification à 3 headers :
| Header | Rôle |
|---|---|
username | Votre identifiant officine (fourni par UPROMEDIC à l'ouverture du compte) |
password | Votre mot de passe officine |
apikey | Clé API spécifique à votre filiale (Alger, Oran, etc.) |
4 endpoints principaux :
GET /grossistes— liste des grossistes accessibles à votre compteGET /factures?from=DATE&to=DATE— liste des BL/factures sur une périodeGET /facture/{id}— détail complet d'un BL avec toutes les lignesGET /produits— catalogue de référence (mise à jour mensuelle)
app_settings du SQLite local et utilisés uniquement pour les appels HTTPS sortants. Aucun proxy par TKAWEN.Workflow pratique dans PharmaPro
- Configuration initiale (5 min) — vous saisissez vos identifiants dans Paramètres → UPROMEDIC.
- Test connexion — un bouton Test appelle
GET /grossistes. Si OK : votre compte est lié. - Réception livraison — vous recevez physiquement les colis et le BL papier.
- Synchronisation 1 clic — bouton Sync UPROMEDIC dans le module Fournisseurs → l'app récupère tous les BL non importés.
- Vérification rapide — vous comparez visuellement les totaux papier vs API. En cas d'écart : alerte.
- Validation — chaque ligne incrémente le stock automatiquement avec lot + péremption corrects.
Cas particuliers gérés
- Médicament inconnu de votre catalogue — créé automatiquement avec les attributs reçus de l'API.
- Médicament avec dosage différent — détecté + mappé sur votre référentiel ou créé en alternative.
- BL partiel (livraison incomplète) — vous pouvez ajuster les quantités avant validation.
- BL annulé côté UPROMEDIC — l'API renvoie le statut, l'import est bloqué.
- Multi-filiales — vous pouvez avoir un compte différent par filiale (utile si vous achetez à Alger ET Annaba).
Comment obtenir un compte API UPROMEDIC
L'API est ouverte à tous les clients officines UPROMEDIC. Procédure :
- Si vous n'êtes pas encore client UPROMEDIC : ouvrez d'abord un compte officine via leur représentant local (recherche : "UPROMEDIC + nom de votre wilaya").
- Une fois client : demandez l'activation API à votre représentant. Le compte est généralement créé en 24-48h.
- Vous recevez par email vos 3 identifiants (username, password, apikey).
- Saisie dans PharmaPro → vous êtes opérationnel.
Le coût : gratuit pour tous les clients UPROMEDIC. C'est un service inclus.
ROI réel de l'intégration
Pour une officine recevant 2 livraisons UPROMEDIC/semaine :
- Avant API : 3h/sem de saisie × 50 sem = 150h/an
- Avec API : 10 min/sem × 50 sem = 8h/an
- Gain : 142h/an = ~3,5 semaines de travail
- Si vous valorisez votre temps à 1 500 DA/h : 213 000 DA/an récupérés
- Sans compter : -90% d'erreurs de saisie (lots, péremptions, prix)