Introduction

Cette API permet d’accéder à l’entretien pharmaceutique pour un patient au travers d’un appel contextuel.

La logique est la suivante:

• Création de l’utilisateur s’il n’existe pas
• Redirection vers la fiche de l’entretien pharmaceutique en cours

Attention : si l’utilisateur n’existe pas et que celui-ci est créé à la volée, il est nécessaire que le code identifiant pharmacie soit bien celui en charge de l’accompagnement du patient pour ne pas avoir une erreur d’autorisation à la consultation.

Point d’entrée

URL de l’appel contextuel

post/api/partners/:facilitySlug/bpm/medication-review-infos

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

{
  "patientIpp": "ABCDEFG01"
}

Format de la réponse

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

{
  "medicationReview": { ... }
}

Le champ medicationReview contient les informations de l’accompagnement en cours pour le patient.

Medication Review

Steps

Preparation

Imported Orescription

Le jobStatus peut être :

• PENDING
• IN_PROGRESS
• ERROR
• SUCCESS

Interview

Interview Question

Question

Les slugs utilisés sont les suivants :

Answer

Report

Counseling Interview

Observance

Conditions

Coding

Treatment

Branded Drug

Clinical Drug

Posology

Treatment Alert

Treatment Evolution

Le type peut être :

• CREATE
• UPDATE
• DELETE

Le kind peut être :

• PHARMACEUTICAL_INTERVENTION : intervention proposée par le pharmacien
• PATIENT_INTERVENTION : modification opérée par le patient
• MEDICAL_INTERVENTION : intervention proposée par le médecin

Pharmaceutical Intervention Details

Le problem peut être :

• NON_COMPLIANCE_WITH_GUIDELINES
• UNTREATED_INDICATION
• UNDERDOSING
• OVERDOSING
• DRUG_NOT_INDICATED
• INTERACTION_TO_ACKNOWLEDGE
• INTERACTION_PRECAUTIONS
• INTERACTION_DISCOURAGED_ASSOCIATION
• INTERACTION_PUBLISHED_CONTRAINDICATION
• ADVERSE_EFFECT
• INAPPROPRIATE_PATHWAY
• TREATMENT_NOT_RECEIVED
• NOT_DEFINED
• ONGOING_MONITORING

Le status peut être :

• ACCEPTED
• REJECTED
• NOT_SPECIFIED

Medication review current steps

Peut prendre une de ces valeurs:

• PREPARATION : préparation
• INTERVIEW : premier entretien
• REPORT : compte-rendu
• COUNSELING_INTERVIEW : entretien conseil
• OBSERVANCE : observance
• FINISHED : accompagnement terminé

Exemple de réponse

{
  "medicationReview": {
    "id": "58ea6fc6-ba29-4a88-bbd1-75b604438ee3",
    "adverseEffects": [],
    "archived": false,
    "billing": {
      "reference": {
        "content": {
          "code": {
            "amount": 0,
            "label": "BMI"
          },
          "status": "MISSING_STEPS"
        },
        "versionedObjectId": "c182daed-1e55-480f-a12c-83b71983ad6e"
      }
    },
    "comment": null,
    "documents": [],
    "nextReviewDate": null,
    "eligibilityCriteria": false,
    "isAdhesionCollected": true,
    "medicationCount": null,
    "prescriptions": [],
    "reviewerParty": {
      "reference": {
        "partyId": "bc94c4e4-4bd7-4751-8f23-4a6e53b0e0b3",
        "originTenantSlug": null,
        "content": {
          "name": "demo",
          "kind": "OFFICINE",
          "contacts": null
        }
      }
    },
    "validatorParty": null,
    "steps": {
      "current": "PREPARATION",
      "counselingInterview": {
        "validationDate": null,
        "date": null,
        "patientTreatments": [],
        "patientTreatmentEvolutions": []
      },
      "interview": {
        "validationDate": null,
        "questions": null,
        "patientTreatmentEvolutions": []
      },
      "preparation": {
        "validationDate": null,
        "importedPrescriptions": [],
        "patientTreatments": []
      },
      "report": {
        "validationDate": null,
        "comment": null,
        "patientTreatments": [],
        "patientTreatmentEvolutions": []
      },
      "reportValidation": null,
      "observance": {
        "validationDate": null,
        "questions": null,
        "patientTreatments": []
      }
    }
  }
}

Codes de réponse