MB HPRIM XML EvenementsMvtStocks

Les messages de type msgEvenementsMvtStocks permettent de notifier les mouvements du stock de n'importe quel type de produit.

Ce message est utilisé dans les cas suivants :

Le schéma n'étant pas décrit dans la norme officiel HPRIM XML, celui-ci a été créé pour nos propres besoins en respectant la norme et n'a donc rien d'officiel.

Schéma général

Constitution des messages

Dans chaque message XML, la référence au fichier XSD doit être présente. L'entête d'un document XML d'événements patients est défini ainsi :

<evenementsPatients xmlns="http://www.hprim.org/hprimXML" acquittementAttendu="oui">

Entête du message XML

Chaque message XML échangé porte un entête conforme HPRIM. Cet entête définit un certain nombre d'attributs que nous détaillons dans ci-dessous.
L'élément HPRIM utilisé est enteteMessage.
L'entête apparaît dans chaque message immédiatement après la déclaration de l'élément racine qui détermine le type d'événement concerné par le message.

Description

élément XML	Chemin XML	Valeur possible	Description
identifiantMessage	enteteMessage	Chaîne de caractères	Identifiant du message. Il est unique. Il est créé lors de la création d'un échange HPRIM.
dateHeureProduction	enteteMessage	DateTime	Date de production du message.
catégorie	enteteMessage > émetteur > agents > agent	"application"	Type d'émetteur du message.
code	enteteMessage > émetteur > agents > agent	Entier	Code d'émetteur
catégorie	enteteMessage > destinataire > agents > agent	"application"	Type du destinataire.
code	enteteMessage > destinataire > agents > agent	Entier	Code du destinataire

Exemple

<enteteMessage>
    <identifiantMessage>000002</identifiantMessage>
    <dateHeureProduction>2009-04-12T21:53:54</dateHeureProduction>
    <emetteur>
      <agents>
        <agent categorie="application">
          <code>MediBoard</code>
          <libelle>Gestion des Etablissements de Santé</libelle>
        </agent>
        <agent categorie="acteur">
          <code>user1</code>
          <libelle>Administrateur OPENXTREM</libelle>
        </agent>
        <agent categorie="système">
          <libelle>Mediboard</libelle>
        </agent>
      </agents>
    </emetteur>
    <destinataire>
      <agents>
        <agent categorie="application">
          <libelle>Gestion des Etablissements de Santé</libelle>
        </agent>
      </agents>
    </destinataire>
  </enteteMessage>

Données du produit

Le type HPRIM produit est utilisé pour décrire un produit avec toutes ses caractéristiques. Celles-ci décrivent les identifiants et les données du produit. Il est possible de se reporter au fichier produit.xsd de la norme HPRIM pour le détail du type produit.

• identifiant (obligatoire): Voir ci-dessous
• libelle (obligatoire): Le nom du produit
• categories (obligatoire): La catégorie du produit
• description (optionnel): Concerne la description du produit
• quantiteDelivrance (obligatoire): Quantité de délivrance du produit (ex: pour 1 boîte de 30 comprimés, la quantité de délivrance est 30)
• uniteDelivrance (obligatoire): Unité de délivrance du produit (ex: pour 1 boîte de 30 comprimés, l'unité de délivrance est comprimés)
• quantiteAdministration (optionnel): Quantité d'administration du produit s'il permet une administration fractionnée (ex: pour une poche de 1000ml, celle-ci est 1000)
• uniteAdministration (optionnel): Unité d'administration du produit s'il permet une administration fractionnée (ex: pour une poche de 1000ml, celle-ci est ml)
• fabriquant (optionnel): Renseigne le fabriquant du produit

Identifiants d'un produit

Un produit dispose toujours deux identifiants :

• Un identifiant local IC pour l'établissement qui transmet ou reçoit l'information
• Un code produit commun au fabriquant

Identifiant local

L'identifiant local (IC) du produit est attribué par le système lors de l'enregistrement d'un produit sur un système. Pour envoyer l'identifiant local d'un produit, on utilise le champ émetteur défini dans le schéma du produit de la manière suivante :

<emetteur>
  <valeur>10001<valeur>
<emetteur>

Code produit

Le code produit est un identifiant unique et constant dans le temps pour un produit concernant un fabriquant. On utilise le code XML suivant pour envoyer le code produit.

<recepteur>
  <valeur>00006<valeur>
<recepteur>

Données du lot

Lors d'un événement concernant un mouvement de stock (entrée, sortie) l'élément lot est obligatoire. Celui-ci contient les éléments suivants :

• code (optionnel): Numéro de lot
• datePeremption (optionnel): La date de péremption du lot
• quantite (obligatoire): La quantité de produit que contient le lot

Données du patient

Dans chaque message concernant un patient, les données de celui-ci sont présentes. Le type HPRIM patient est utilisé pour décrire un patient administré par un établissement de soins, avec toutes ses caractéristiques. Celles-ci décrivent les identifiants et les traits stricts ou étendus d'un patient. Il est possible de se reporter au fichier patient.xsd de la norme HPRIM pour le détail du type patient.

Identifiants d'un patient

Un patient dispose après son inscription au SIP toujours deux identifiants :

• Un identifiant local IC pour l'établissement qui transmet ou reçoit l'information
• Un identifiant patient permanent IPP commun à l'ensemble des établissements.

Données du service

Un service correspond à une unité fonctionnelle et doit posséder les éléments suivants :

• code : Code de l'unité fonctionnelle
• libelle: Description de l'unité

De plus un attribut responsabilite, renseigne la responsabilité d'une unité fonctionnelle vis à vis d'un patient dans un établissement de soins. (Administrative, médicale, hébergement, soins)

Alias

evenementsMvtStocks, evenementsMvtStock.

---