Entretiens pharmaceutiques (BPM)

Introduction

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

La logique est la suivante:

Création de l’établissement s’il n’existe pas
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 la liste des traitements passés en paramètre

Si l’accompagnement est en cours et non terminé, il n’est pas modifié même si les traitements fournis en paramètres sont différents.

Point d’entrée

URL des appels contextuels

⚠️

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/accompaniement

En-têtes HTTP

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

Corps de la requête

Nom	type	Description
`type`	`string`	Le type de l’accompagnement à réaliser. Voir la section Type Requis
`facilitySlug`	`string`	Nom de votre éditeur de logiciel. Requis
`user`	`object`	Objet décrivant l’utilisateur voulant faire l’accompagnement. Voir la section User Requis
`patient`	`object`	Objet décrivant le patient sur lequel on veut pratiquer l’accompagnement. Voir la section Patient Requis

Type

Peut prendre une de ces valeurs :

BPM (bilan partagé de médication)

User

Attribut	Type	Description
`firstName`	`string`	Prénom de l’utilisateur Requis
`lastName`	`string`	Nom de l’utilisateur Requis
`rpps`	`string`	Numéro RPPS de l’utilisateur Requis
`email`	`string`	Email de l’utilisateur Requis

Patient

Attribut	Type	Description
`ins`	`string`	Numéro de sécurité sociale du patient Requis
`firstName`	`string`	Prénom du patient Requis
`lastName`	`string`	Nom du patient Requis
`usualName`	`string`	Nom d’usage du patient
`birthDate`	`string`	Date de naissance du patient au format `YYYY-MM-DD` Requis
`birthLocation`	`string`	Commune de naissance du patient Requis
`gender`	`enum`	Sexe du patient. Voir la section Gender Requis
`address`	`object`	Détails de l’adresse du patient . Voir la section Address
`phone`	`string`	Téléphone du patient
`email`	`string`	Email du patient
`fax`	`string`	Fax du patient
`height`	`number`	Taille du patient
`weight`	`number`	Poid 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
`currentTreatments`	`string[]`	Une liste de code CIP, UCD, CIS

Gender

Peut prendre une de ces valeurs:

FEMALE
MALE
UNDIFFERENTIATED
UNKNOWN

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

Address

Attribut	Type	Description
`lines`	`string[]`	Rue, numéro de rue et détails complémentaire de l’adresse
`city`	`string`	Commune
`zipCode`	`string`	Code postal
`adminCode`	`string`	Le code INSEE de la commune
`country`	`string`	Pays

{
  "type": "BPM",
  "patient": {
    "ins": "1880593059061",
    "firstName": "Robert",
    "lastName": "De Niro",
    "birthDate": "1970-05-25",
    "birthLocation": "80100"
  },
  "user": {
    "firstName": "Lucie",
    "lastName": "Dupont",
    "rpps": "abcde1234",
    "email": "lucie.dupont@pharma.mssante.fr"
  },
  "facilitySlug": "lgo"
}

Output

{
  "location": "https://partner-connect.preprod.posos.co/partners/proxy/logout?payload=0c1e1c7e86b96f3088605e2121a7c19e%7Cc8fdb1763354aa04c250008001fe52d5b203fbeed6770e5cf01035a9fe31b4a97dcd3738303e6e5ec815d83d2b5030f91a3689a8122a7beb798b6f38ee495a1f53264b08aacdb512448264079850d0509f16ab2004a80f8ca4ba7cae33395d48f5ca276fb1e5d9845d6fefedea70fc7634bd885e1275c8b6bad73ca8e49243e50cc8b89c3aaefa"
}

Format de la réponse

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

Output

{
  "location": "https://partner-connect.preprod.posos.co/partners/proxy/logout?payload=0c1e1c7e86b96f3088605e2121a7c19e%7Cc8fdb1763354aa04c250008001fe52d5b203fbeed6770e5cf01035a9fe31b4a97dcd3738303e6e5ec815d83d2b5030f91a3689a8122a7beb798b6f38ee495a1f53264b08aacdb512448264079850d0509f16ab2004a80f8ca4ba7cae33395d48f5ca276fb1e5d9845d6fefedea70fc7634bd885e1275c8b6bad73ca8e49243e50cc8b89c3aaefa"
}

Le champ location est celui contenant l’URL vers laquelle rediriger l’utilisateur.

Codes de réponse

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

Conciliation Médicamenteuse Autocomplétion