Vaccins à faire

Récupération du diagnostic

Récupération au format HTML

La récupération des vaccins à faire au format HTML permet une intégration directe du résultat mis en forme par nos soins au sein d’une application. La vue retournée est une page HTML autonome pouvant être affichée dans une iFrame sur un site Internet ou une vue web dans un client lourd.

  • GET /records/:uuid/immunisation_assessment.html renvoie les vaccins à faire mis en forme au format HTML

Le rendu est disponible aux formats mobile et bureau, en fonction du user-agent portant la requête.

Le status du diagnostic (cf. schedule_status ci-après) est disponible dans l’entête MVX-Assessment-Status pour pouvoir être manipulé plus aisément (pour afficher une icône d’alerte par exemple).

Le numéro de version des règles utilisées par le système expert pour générer le diagnostic est disponible dans l’entête MVX-Assessment-Rules-Revision.

Version mobile

Vaccins à faire sur mobile

Version bureau

Vaccins à faire sur bureau

Récupération au format JSON

Le diagnostic d’un carnet de vaccination électonique est obtenu par appel au système expert de MesVaccins.net. Ce service retourne le détail des vaccinations à jour et en retard de la personne.

  • GET /records/:uuid/immunisation_assessment.json renvoie les vaccins à faire
{
    "schedule_status": "to-do",
    "rules_revision": "1.0",
    "assessments": [
      {
        "disease": {
          "id": 2,
            "name": "Tétanos"
          },
          "group_name": "DTP",
          "conditions": [ ],
          "dose_count": 1,
          "message": "Prochain rappel : à 75 ans !",
          "schedule_status": "up-to-date",
          "next_vaccination_date": "2020-01-01",
          "recommendation": {
            "messages": [
              "<p>Nouveau calendrier vaccinal.</p>",
              "<p>Recommandation générale : rappels à âges fixes à 25, 45 et 65 ans, puis à 75, 85 ans...</p>"
            ],
            "alerts": [ ],
            "comments": [ ],
            "justifications": [
              "<p>Toute personne non ou mal vaccinée est à risque de tétanos, mais à votre âge vous êtes particulièrement concerné. En effet, les personnes les moins bien protégées en France contre le tétanos sont les personnes âgées, en particulier les femmes, et les hommes qui n'ont pas effectué de service militaire.</p>"
            ],
            "level": "Recommandé",
            "refund": "Remboursé par la sécurité sociale à 65 %",
            "reference_texts": [
              {
                "title": "Calendrier vaccinal",
                "url": "https://www.mesvaccins.net/textes/calendrier_vaccinal.pdf"
              }
            ]
          }
        },
        {
            "disease": {
                "id": 25,
                "name": "Pneumocoque"
            },
            "group_name": null,
            "conditions": [
                {
                    "name": "Insuffisance respiratoire chronique"
                }
            ],
            "dose_count": 4,
            "message": "Expertise indisponible",
            "schedule_status": "unresolved",
            "next_vaccination_date": null,
            "recommendation": {
                "messages": [ ],
                "alerts": [ ],
                "comments": [ ],
                "justifications": [ ],
                "level": "Recommandé",
                "refund": "Remboursé par la sécurité sociale à 65 %"
            }
        },
        {
            "disease": {
                "id": 6,
                "name": "Hépatite B"
            },
            "group_name": null,
            "conditions": [
                {
                    "name": "Dialysé"
                }
            ],
            "dose_count": 3,
            "message": "Selon résultat de la sérologie annuelle",
            "schedule_status": "unresolved",
            "next_vaccination_date": null,
            "recommendation": {
                "messages": [ ],
                "alerts": [ ],
                "comments": [ ],
                "justifications": [ ],
                "level": "Recommandé",
                "refund": "Remboursé par la sécurité sociale à 100 %"
            }
        },
        ...
    ]
}

En cas d’accès non autorisé à un carnet, le serveur renvoie 404 Not Found.

Les différents éléments de la réponse sont :

Nom du paramètre Description
schedule_status Indique le retard éventuel de la vaccination.
Peut prendre l'une des valeurs suivantes : unresolved, to-do, late, up-to-date.
rules_revision Numéro de version des règles du système expert utilisées pour générer le diagnostic.
assessments Liste des éléments du diagnostic.
disease Maladie concernée.
group_name Nom du groupe de maladie concerné ou null si aucun groupe n'est concerné
conditions Conditions justifiant le statut.
dose_count Nombre de doses de vaccin reçues par le vacciné contre cette maladie.
next_vaccination_date Date de la prochaine vaccination.

Chaque valeur de schedule_status est associée à un code couleur dans l’interface, pour aider la compréhension du champ par les utilisateurs. Les valeurs possibles sont :

Statut Description Couleur associée
unresolved Le système expert ne peut pas déterminer le statut de cette vaccination : le conseil d'un médecin est requis Gris
late Le titulaire du carnet est en retard de sa vaccination concernant cette maladie Rouge
to-do Le titulaire du carnet doit se faire vacciner contre cette maladie dès que possible Orange
up-to-date Le titulaire du carnet est à jour de sa vaccination concernant cette maladie Vert

Récupération des rappels

Il peut être intéressant de récupérer la liste des prochains rappels vaccinaux concernant un carnet de vaccination, pour les afficher au sein de l’interface du dossier patient dans un logiciel métier.

Cela se fait en exploitant le résultat du service de récupération du diagnostic, qui fournit les dates de prochaine vaccination dans l’attribut next_vaccination_date.