Création d'un entretien pharmaceutique (BPM)

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

⚠️

L’url de base est https://partner-connect.{env}.posos.co où {env} est l’environnement suivant : preprod pour la validation, production pour le live.

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

Nom	Valeur
`Content-Type`	`application/json`
`Authorization`	`Bearer <token>`

Jeton d’authentification

Le jeton d’authentification doit être un jeton contenant les claims suivants

Attribut	Type	Description
`email`	`string`	Email de l’intervenant de santé Requis
`rpps`	`string`	RPPS de l’intervenant de santé Requis
`cip`	`string`	Identifiant unique de la pharmacie Requis
`first_name`	`string`	Prénom de l’intervenant de santé Requis
`last_name`	`string`	Nom de l’intervenant de santé Requis

Corps de la requête

Nom	type	Description
`images`	`object[]`	La liste des ordonnances à scanner. Voir la section Ordonnances Requis mais peut être un tableau vide.
`patient`	`object`	Objet décrivant le patient. Vois la section Patient Requis
`medicationReviewInterviewDate`	`string`	Date de l’entretien Requis

Ordonnances

Attribut	Type	Description
`image`	`string`	Contenu de l’image en base64 Requis
`isPdf`	`boolean`	Flag indiquant si l’image est un PDF ou non Requis

Patient

Attribut	Type	Description
`ins`	`string`	Numéro de sécurité sociale du patient Requis
`givenName`	`string`	Prénom du patient Requis
`familyName`	`string`	Nom du patient Requis
`birthDate`	`string`	Date de naissance du patient au format `YYYY-MM-DD` Requis
`gender`	`enum`	Sexe du patient. Voir la section Gender Requis
`profile`	`object`	Profil du patient

Gender

Peut prendre une de ces valeurs:

FEMALE
MALE
UNDIFFERENTIATED
UNKNOWN

Profile

Attribut	Type	Description
`height`	`number`	Taille du patient
`weight`	`number`	Poids du patient
`dfg`	`number`	Débit de filtration glomérulaire du patient
`renalImpairment`	`enum`	Insufisance rénale Voir la section Renal impairment
`heartFailure`	`enum`	Insufisance cardiaque Voir la section Heart failure
`hepaticFailure`	`enum`	Insufisance cardiaque Voir la section Hepatic failure
`allergies`	`object[]`	Liste d’allergies Voir la section Conditions
`conditions`	`object[]`	Liste de terrains Voir la section Conditions

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

Attribut	Type	Description
`label`	`string`	Label de la condition
`codings`	`{code: string, display: string, system: string}[]`	Liste de codings pour la condition

Les systèmes autorisés sont : snomed, cim10 et meddra.

{
  "patient": {
    "ins": "1880593059061",
    "givenName": "Robert",
    "familyName": "De Niro",
    "birthDate": "1970-05-25",
    "birthLocation": "80100",
    "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:

Output

{
  "patientIpp": "<string>"
}

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

Exemple de réponse

Output

{
  "patientIpp": "ABCDEFG01"
}

Codes de réponse

Code	Description
`201`
`400`	Un des paramètres passés dans la requête est invalide
`401`	Le token passé est invalide

Scan & Go Accès au tableau de bord