Intégration DHIS2

Deux directions

VLMIS et DHIS2 sont connectés dans les deux sens. VLMIS dépend de DHIS2 pour les formations, les identités et la connexion ; et VLMIS alimente DHIS2 avec les chiffres de stock quotidiens pour que le niveau national puisse analyser et suivre la chaîne d'approvisionnement en vaccins dans les tableaux de bord DHIS2 standards.

                dépend de
   +------------------------------->
VLMIS                                DHIS2
   <-------------------------------+
     valeurs de stock chaque nuit

Ce que VLMIS prend de DHIS2

• Les formations (unités d'organisation) : VLMIS importe l'arbre des unités d'organisation DHIS2 et en garde une réplique. Les nouvelles formations n'apparaissent dans VLMIS qu'après un rafraîchissement depuis DHIS2 (Maintenance, Paramètres), et la hiérarchie des magasins se construit en rattachant ces unités à leur parent fournisseur.
• Les identités des utilisateurs : un compte est créé à partir d'un nom d'utilisateur DHIS2, et le nom, l'email et le téléphone de la personne viennent de l'API DHIS2. Voir Utilisateurs.
• La connexion elle-même : à la connexion, VLMIS vérifie votre nom d'utilisateur et votre mot de passe auprès de DHIS2. Il n'y a pas de mot de passe VLMIS séparé ; si votre mot de passe DHIS2 change, celui de VLMIS change avec.
• La correspondance des éléments de données : chaque produit du catalogue porte un code HMIS (Maintenance, Produits). Ce code est l'identifiant de l'élément de données DHIS2 dans lequel le produit rapporte ; un produit sans code ne peut pas être rapporté à DHIS2.

Ce que VLMIS renvoie à DHIS2

VLMIS rapporte automatiquement l'activité de stock de chaque magasin à DHIS2, sans aucune action de l'utilisateur, en deux étapes nocturnes :

1. Résumé de fin de journée (23 h 59)

Juste avant minuit, VLMIS parcourt toute la hiérarchie des magasins depuis le magasin central et, pour chaque magasin et produit, fige la journée précédente dans un rapport de fin de journée (EoD) : solde d'ouverture, arrivées, réquisitions reçues, distributions sorties, retours entrants et sortants, ajustements de comptage physique, dispensation, pertes, et solde de clôture. Les produits en stock mais sans mouvement ce jour-là sont aussi enregistrés (ouverture égale clôture). Si un jour a été manqué (serveur arrêté, par exemple), la tâche rattrape un jour à la fois.

Ces résumés quotidiens sont ce que montre le rapport EOD du module Rapports, aux côtés du rapport des opérations quotidiennes.

2. Envoi vers DHIS2 (20 h 00)

Chaque soir, VLMIS prend les valeurs quotidiennes accumulées et non encore transmises et les envoie à l'API dataValueSets de DHIS2. Les chiffres de chaque produit deviennent des valeurs de données sur son élément de données au code HMIS, ventilées par catégorie (solde d'ouverture, reçu, retours entrants/sortants, distribué, dispensation, pertes, écart, solde de clôture), par formation et par jour. Un envoi réussi marque les valeurs comme transmises ; un envoi échoué est retenté les nuits suivantes, jusqu'à cinq tentatives par enregistrement.

Résultat : les tableaux de bord DHIS2 nationaux voient le stock et la consommation de vaccins au niveau des formations sans que personne ne remplisse de formulaire DHIS2 à la main.

Ce que cela signifie au quotidien

• Enregistrez tout dans VLMIS le jour où cela se produit : le résumé nocturne fige la veille, et une saisie antidatée fausse ce que DHIS2 reçoit.
• Gardez les codes HMIS corrects à la création des produits ; ils sont le pont vers le rapportage national.
• Une nouvelle formation dans DHIS2 nécessite un rafraîchissement des unités d'organisation, puis un rattachement dans la hiérarchie des magasins, avant que ses données puissent circuler.