Introduction

Cette API permet d’initialiser un accompagnement pharmaceutique, comme un bilan partagé de médication pour un patient

La logique est la suivante:

• Création de l’utilisateur s’il n’existe pas
• Création du patient s’il n’existe pas
• Création de l’accompagnement si aucun n’est en cours, avec scan d’ordonnance asynchrone

Point d’entrée

URL de l’appel contextuel

post/api/partners/:facilitySlug/bpm/create

Avec facilitySlug le facilitySlug unique pour votre intégration et qui sera le même pour l’ensemble des pharmacies

En-têtes HTTP

Authentification

Une authentification est nécessaire pour l’appel à cet endpoint. Il y a deux types de jetons d’authentification qui peuvent être utilisés

Jeton par certificat (x5c)

Le jeton peut être signé avec la clé publique fournie dans un certificat dans le x5c du jeton. L’autorité de certification correspondante doit nous être fournie au préalable pour que nous la rajoutions dans les autorités de confiance. Généralement ce mode opératoire vous permet de générer un jeton par pharmacie ou opérateur (intervenant de santé). Dans ce cas le jeton d’authentification doit contenir les claims suivants.

Note : les champs posos_id et email doivent être uniques pour l’opérateur parmi toutes les pharmacies (pas uniquement pour sa pharmacie).

Jeton d’accès à nos APIs

Le jeton peut également être le jeton standard d’accès à nos APIs et appels contextuels dont la génération est décrite dans la page Authentification. Cette méthode doit uniquement être utilisée dans le cas d’un accès serveur à serveur, et ne doit pas émaner de la pharmacie pour des raisons de sécurité (il est possible de faire des requêtes pour n’importe quelle pharmacie de l’éditeur). Dans ce scénario il sera obligatoire de fournir dans le corps de la requête le champ operator.

Corps de la requête

Ordonnances

Patient

Gender

Peut prendre une de ces valeurs:

• FEMALE
• MALE
• UNDIFFERENTIATED
• UNKNOWN

Location

Profile

Renal impairment

Peut prendre une de ces valeurs :

• NONE
• MILD
• MODERATE
• SEVERE
• TERMINAL
• UNSPECIFIED

Heart failure

Peut prendre une de ces valeurs :

• NONE
• MILD
• MODERATE
• SEVERE
• UNSPECIFIED

Hepatic failure

Peut prendre une de ces valeurs :

• NONE
• MILD
• MODERATE
• SEVERE
• UNSPECIFIED

Conditions

Pour chaque condition précisée il est nécessaire de spécifier au moins un coding pour que la donnée soit correctement structurée par le BPM et que des alertes puissent remonter.

Coding

{
  "patient": {
    "ins": "1880593059061",
    "givenName": "Robert",
    "familyName": "De Niro",
    "birthDate": "1970-05-25",
    "gender": "MALE",
    "profile": {
      "conditions": [
        {
          "label": "insuffisance cardiaque à haut débit",
          "codings": [
            {
              "code": "10091002",
              "display": "insuffisance cardiaque à haut débit",
              "system": "snomed"
            }
          ]
        },
        {
          "label": "spasme artériel",
          "codings": [
            {
              "code": "3750006",
              "display": "spasme artériel",
              "system": "snomed"
            }
          ]
        }
      ]
    }
  },
  "images": [],
  "medicationReviewInterviewDate": "2025-10-12"
}

Format de la réponse

Le résultat obtenu est du JSON de la forme suivante:

{
  "patientIpp": "<string>"
}

Le champ patientIpp est celui de l’identifiant patient dans le BPM Posos.

Exemple de réponse

{
  "patientIpp": "ABCDEFG01"
}

Codes de réponse