Conciliation Médicamenteuse

Introduction

Cette API permet d’initialiser une Conciliation Médicamenteuse pour un patient via un appel contextuel.

La logique est la suivante:

Création du patient s’il n’existe pas
Création du bilan médicamenteux s’il n’existe pas, avec la liste des traitements passés en paramètre

Si le bilan existe déjà 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/conciliation

En-têtes HTTP

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

Corps de la requête

Nom	type	Description
`first_name`	`string`	Prénom de l’utilisateur requis
`last_name`	`string`	Nom de l’utilisateur requis
`rpps`	`string`	RPPS de l’utilisateur, ou un identifiant technique de l’utilisateur au sein de l’établissement requis
`facilitySlug`	`string`	Identifiant d’établissement qui vous a été transmis en début d’intégration. requis
`ehrName`	`string`	Nom du DPI d’origine de l’information: sera affiché comme nom de la source des médicaments dans le bilan requis
`conciliation`	`object`	Objet décrivant les paramètres métiers de la conciliation. Voir la section Conciliation requis

Bon à savoir : Le “RPPS” n’est pas nécessairement le RPPS mais peut être un identifiant technique de l’utilisateur au sein de l’établissement. Sur l’environnement preprod vous pouvez tester avec l’utilisateur abcde1234 qui est configuré.

Conciliation

Attribut	Type	Description
`patient`	`object`	Description du patient. Voir la section Patient requis
`encounter`	`object`	Description du séjour. Voir la section Encounter requis

Patient

Attribut	Type	Description
`ipp`	`string`	Identifiant Permanent du Patient
`ins`	`string`	Numéro de sécurité sociale du patient requis
`firstName`	`string`	Prénom du patient
`lastName`	`string`	Nom du patient
`birthDate`	`string`	Date de naissance du patient au format `YYYY-MM-DD`
`birthPlace`	`string`	Commune de naissance du patient
`telephone`	`string`	Téléphone du patient
`email`	`string`	Email du patient
`gender`	`string`	Sexe du patient ‘male’ ou ‘female’
`address`	`object`	Détails de l’adresse du patient . Voir la section Address

Address

Attribut	Type	Description
`line`	`string`	Rue, numéro de rue et détails complémentaire de l’adresse
`city`	`string`	Commune requis
`postalCode`	`string`	Code postal requis
`country`	`string`	Pays

Encounter

Attribut	Type	Description
`startDate`	`date`	Date de début du séjour au format `YYYY-MM-DD` requis
`drugs`	`object`	Médicaments à intégrer au bilan. Voir la section Drugs

Drugs

Attribut	Type	Description
`ucds`	`array<string>`	Tableau de code UCD 7 ou UCD 13

{
	"conciliation": {
		"patient": {
			"ins": "1880593059061",
			"firstName": "Robert",
			"lastName": "De Niro"
		},
		"encounter": {
			"startDate": "2024-05-25",
			"drugs": {
				"ucds": ["3400891771251","3400893604960"]
			}
		}
	},
		"rpps": "abcde1234",
		"last_name": "Doe",
		"first_name": "John",
		"facilitySlug": "hopital-demo",
		"ehrName": "FakeDPI"
}

Exemple

Request

POST

/api/partners/patient/scan-token

curl --request POST \
  --url https://partner-connect.preprod.posos.co/api/partners/conciliation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
	"conciliation": {
		"patient": {
			"ins": "1880593059061",
			"firstName": "Robert",
			"lastName": "De Niro"
		},
		"encounter": {
			"startDate": "2024-05-25",
			"drugs": {
				"ucds": ["3400891771251","3400893604960"]
			}
		}
	},
		"rpps": "abcde1234",
		"last_name": "Doe",
		"first_name": "John",
		"facilitySlug": "hopital-demo",
		"ehrName": "FakeDPI"
}'

Response

{
  "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:

Response

{
  "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
`200`
`400`	Un des paramètres passés dans la requête est invalide

Scan & Go Autocomplétion