Identification des médicaments

Les API Posos utilisent une hiérarchie structurée pour identifier les médicaments à différents niveaux de spécificité. Comprendre cette hiérarchie est essentiel pour envoyer les bons codes aux API d’analyse.

Niveaux de concept médicamenteux

Les médicaments sont organisés en quatre niveaux, du plus générique au plus spécifique :

Médicament virtuel international

Le médicament virtuel international (MVI) constitue le socle commun entre les médicaments de différents pays. Il permet de relier des concepts équivalents (même substance, même dosage, même forme) au-delà des frontières, facilitant ainsi l’interopérabilité internationale.

Bon à savoir : Le niveau MVI n’est pas actuellement exposé dans les APIs Posos mais pourrait être utilisé dans de futures versions pour permettre la cartographie des médicaments entre pays.

Médicament clinique (virtuel)

Un médicament clinique représente un groupe de médicaments cliniquement équivalents partageant :

• La ou les même(s) substance(s) active(s) (DCI)
• Le(s) même(s) dosage(s)
• La même forme pharmaceutique
• La même voie d’administration

Les médicaments cliniques sont indépendants de la marque. Par exemple, toutes les versions génériques et de marque de « atorvastatine 20 mg comprimé » sont regroupées sous un même médicament clinique.

Code interne Posos : préfixe MV (ex. MV00001165)

Spécialité (médicament de marque)

Une spécialité est un produit commercialisé spécifique d’un fabricant donné. Par exemple, « TAHOR 20 mg, comprimé pelliculé » (la marque Pfizer de l’atorvastatine 20 mg).

Plusieurs spécialités peuvent correspondre à un même médicament clinique.

Présentation (médicament conditionné)

Une présentation est un conditionnement commercial spécifique d’une spécialité — par exemple, « TAHOR 20 mg, boîte de 90 comprimés pelliculés ».

Terminologies de codage

Différents systèmes de codage sont utilisés selon le niveau de concept médicamenteux :

Note régionale : Les terminologies ci-dessus concernent le marché français (fr_FR). Pour la Belgique (fr_BE), les terminologies disponibles incluent amp, CNK, CTI Extended et vmp. D’autres terminologies internationales sont également disponibles et détaillées dans la documentation de la base.

Utilisation des codes médicaments dans les APIs

Le type GraphQL DrugInput accepte l’un des trois champs suivants :

input DrugInput {
  clinicalDrug: CodingInput # pour les codes de médicaments cliniques
  brandedDrug: CodingInput # pour les codes de spécialités (CIS, UCD)
  packagedDrug: CodingInput # pour les codes de présentations (CIP)
  id: String # identifiant unique du médicament
}
 
input CodingInput {
  code: String! # le code médicament
  terminology: String! # le système de codage (ex. "posos", "cis", "CIP13")
}

Résolution des identifiants médicaments

Dans la plupart des intégrations, il faut d’abord convertir les noms de médicaments ou codes externes en identifiants Posos à l’aide de l’API d’autocomplétion :

GET /autocomplete-api/autocomplete?query=atorvastatine&entity_type=DRUG

La réponse inclut des identifiants codés que vous pouvez extraire et transmettre aux API d’analyse :

{
  "candidates": [
    {
      "label": "Atorvastatine 20 mg comprimé",
      "codings": {
        "posos": [{ "code": "MV00001165", "terminology": "posos" }],
        "cis": [{ "code": "60151894", "terminology": "cis" }]
      }
    }
  ]
}

Voir aussi

• Types d’entrée partagés — Référence complète des types d’entrée
• Guide d’analyse de prescription — Intégration pas à pas
• Médicaments cliniques (MedicalDB) — Modèle de données détaillé