PRIUM4
Guide de l’éditeur
Public
XRD-2018-4305
30/09/2022
Version 05.00
Olaqin 28 quai Gallieni
S.A.S. au capital de 10 931 186 € 92150 Suresnes – France
852 722 750 R.C.S. Nanterre Tél : +33 (0)1 87 15 99 99
Version 05.00
PRIUM4 - Guide de l’éditeur
Public
Historique du document
Révision Auteur Date Modifications
Equipe
1.0 Version initiale
projet
- Evolution application EI96 3.32 avec
ordonnancement des applications en réponse
API SESAM-Vitale « Lecture de la
Configuration du Terminal lecteur »
Equipe - Affichage de la date de dernière mise à jour
2.0
projet de la carte Vitale (application Homepage
1.09)
- Paramétrage de la date/heure dans le menu
de configuration (application Homepage
1.09)
Equipe Evolution liée à l’application EI96 4.01 (Homologation
3.0 26/02/2018
projet du produit au référentiel Terminal Lecteur V04.00)
Corrections d’anomalies de l’application EI96. Edition
Equipe de la nouvelle version v4.03.01.
4.0 10/06/2020
projet Evolution et amélioration de la Homepage (version
2.02).
Equipe Edition de la nouvelle version pour EI’96 5.0 (PC/SC
5.0 15/09/2022
projet rapide).
Documents de référence
Révision Auteur Date Nom
Guide d’intégration
[DR1] MLE 19/09/2022 API PC/SC
Version 1.00
[Link] 2/10
Version 05.00
PRIUM4 - Guide de l’éditeur
Public
Sommaire
1. Présentation du PRIUM4...................................................................4
2. Présentation des nouveautés de la version EI96 05.00 et
HomePage 03.03 ...................................................................................5
2.1. Correction d’anomalies ........................................................................................ 5
2.1.1. Correction de cas entraînant des crashs ....................................................................... 5
2.2. Améliorations ..................................................................................................... 5
2.2.1. Performances du TL4 en mode PC/SC ......................................................................... 5
2.2.2. Gestion dynamique des coupleurs ..................................................................................... 5
2.2.3. Utilisation de l’interface sans-contact du PRIUM4 ............................................................. 5
2.2.4. Ajout d’une macro-commande de lecture ApCv................................................................. 5
3. Présentation des nouveautés de la version EI96 4.03.01 et
Homepage 2.02 .....................................................................................6
3.1. Correction d’anomalies ...................................................................................... 6
3.1.1. Correction du contrôle de la date de fin de validité de la carte CPS ............................. 6
3.1.2. Correction du code de couverture remonté pour les cartes avec régime minier ............... 6
3.1.3. Correction de la demande de ressaisie du code porteur de la carte CPS ......................... 6
3.2. Améliorations ....................................................................................................... 6
4. Présentation des nouveautés de la version EI96 4.01 et
Homepage 1.17 .....................................................................................7
4.1. Référentiel Terminal Lecteur V04.00 : modes de communication entre le
terminal et le poste de travail ......................................................................................... 7
CDC/PSS.................................................................................................................................................. 7
PC/SC....................................................................................................................................................... 7
4.2. Référentiel Terminal Lecteur V04.00 : sécurité .................................................. 8
4.3. Référentiel Terminal Lecteur V03.60 : ordres obsolètes .................................... 8
4.4. Améliorations ..................................................................................................... 8
5. Présentation des nouveautés de la version EI96 3.32 et
Homepage 1.09 .....................................................................................9
5.1. Ordonnancement des applications Santé ............................................................. 9
5.2. Affichage de la dernière date de mise à jour de la carte Vitale............................ 9
5.3. Paramétrage de la date/heure .............................................................................. 9
6. Présentation de la version EI96 3.31 et Homepage 1.06 ............... 10
[Link] 3/10
Version 05.00
PRIUM4 - Guide de l’éditeur
Public
1. Présentation du PRIUM4
PRIUM-4 est la solution sur mesure pour les officines et professionnels de santé qui permet à la fois la
création, la signature des feuilles de soins électroniques (FSE) et la mise à jour de la carte Vitale.
PRIUM-4 repose sur un terminal conçu pour répondre parfaitement au besoin de traitements massifs
mettant en œuvre à la fois la Carte de Professionnel de Santé (CPS) et la carte Vitale.
Ce nouveau terminal de carte Vitale, homologué suivant les dernières versions du référentiel du GIE
SESAM-Vitale, offre une ergonomie optimale au comptoir ainsi qu’une large flexibilité par sa
connectique.
PRIUM-4 permet de mettre à jour les cartes Vitale quelle que soit leur génération mais est également
prêt pour les cartes des complémentaires santé lorsqu’elles seront disponibles.
PRIUM-4 hérite des atouts ergonomiques reconnus du PRIUM-3S tout en apportant des améliorations
notables telles qu’un plus grand écran d’affichage et la simplicité d’activation du service de mise à jour
des cartes Vitale. Il dispose d’une connectique basée sur la technologie HDMI qui permet d’alimenter à
la fois le terminal mais aussi de le connecter en USB au poste de travail et au réseau local en Ethernet
en un seul câble.
[Link] 4/10
Version 05.00
PRIUM4 - Guide de l’éditeur
Public
2. Présentation des nouveautés de la version
EI96 05.00 et HomePage 03.03
Le terminal PRIUM-4 équipé de la version EI’96 V04.03 est conforme aux exigences du référentiel
Terminal Lecteur V04.00.
2.1. Correction d’anomalies
Correction de cas entraînant des crashs
Après une mise-à-jour, l’application HomePage pouvait, dans certains cas, crasher et entraîner un
reboot du terminal. Ces cas sont désormais traités.
2.2. Améliorations
Performances du TL4 en mode PC/SC
En mode PC/SC, l’application EI’96 traite désormais plus rapidement les ordres contenant des APDU
carte.
Gestion dynamique des coupleurs
Les coupleurs sont désormais numérotés de cette façon :
- Coupleur PCSC 0 = coupleur du dessous (CPS).
- Coupleur PCSC 1 = coupleur frontal ou du dessus (Si deux cartes sont insérées, le PRIUM4
indique qu’il faut retirer l’une des deux cartes).
- Coupleur PCSC 2 = coupleur sans contact (actif sur commande escape pour activer/désactiver
la chasse)
Utilisation de l’interface sans-contact du PRIUM4
Cette version met en œuvre l’interface sans-contact du PRIUM. L’interface n’est utilisable qu’après
activation de la chasse sur le terminal.
La méthode d’activation par appel d’une API PC/SC est décrite dans le document (DR1].
Cette interface permet notamment la lecture de l’application ApCv.
Ajout d’une macro-commande de lecture ApCv
Cette macro-commande permet à un logiciel éditeur de faire réaliser par le PRIUM4 l’ensemble des
opérations nécessaires pour acquérir le token généré par l’application ApCv, sans avoir besoin de
connaître les commandes APDU à envoyer au terminal.
La méthode de lecture par appel d’une API PC/SC est décrite dans le document (DR1].
[Link] 5/10
Version 05.00
PRIUM4 - Guide de l’éditeur
Public
3. Présentation des nouveautés de la version
EI96 4.03.01 et Homepage 2.02
Le terminal PRIUM-4 équipé de la version EI96 V04.03 est conforme aux exigences du référentiel
Terminal Lecteur V04.00.
3.1. Correction d’anomalies
Correction du contrôle de la date de fin de validité de la carte CPS
La fin de validité des cartes CPS était contrôlée lors de la lecture de carte Vitale. Dorénavant, la validité
est effectuée avant toute lecture de carte Vitale.
Correction du code de couverture remonté pour les cartes avec régime
minier
L’application EI96 ne remontait pas les informations correctes lors de la lecture des cartes Vitale avec
le régime minier. Le code de couverture remonté était incorrect. Le nouvel EI96 corrige cette anomalie.
Correction de la demande de ressaisie du code porteur de la carte CPS
Suivant certains ordres envoyés par le poste de travail vers le terminal, il était possible qu’une demande
de saisie du code porteur de la carte CPS soit exigée à nouveau.
Il s’agissait d’un problème de gestion du compteur de changement d'états de la carte CPS qui a été
corrigée.
3.2. Améliorations
Mise à jour de la Homepage pour permettre :
• L’ajout d'une demande de confirmation avant l'appel serveur
• La suppression de la demande de code pour accéder au menu "Evolution"
[Link] 6/10
Version 05.00
PRIUM4 - Guide de l’éditeur
Public
4. Présentation des nouveautés de la version
EI96 4.01 et Homepage 1.17
Le terminal PRIUM-4 équipé de la version EI96 V04.01 est conforme aux exigences du référentiel
Terminal Lecteur V04.00.
Nota : La version 04.01 est la première version TL4 disponible aux éditeurs, en vue du déploiement.
4.1. Référentiel Terminal Lecteur V04.00 : modes de
communication entre le terminal et le poste de travail
CDC/PSS
Le mode ‘historique’ de communication CDC/PSS entre le terminal et le poste de travail est conservé.
Ce mode utilise le(s) driver(s) précédemment mis à disposition avec les versions logicielles 03.3x.
PC/SC
Le référentiel Terminal Lecteur V04.00 du GIE SESAM-Vitale introduit un second mode de
communication entre le terminal, le poste de travail et, in fine, les cartes à puce. Ce nouveau mode de
communication utilise un driver propriétaire Olaqin utilisant la norme « PC/SC ».
Concernant les drivers PC/SC :
- Si le terminal est neuf et que le PC de l’utilisateur peut accéder à Windows Update, le terminal
s’installera automatiquement. Cette méthode est recommandée pour l’installation du driver.
- L’utilisateur peut également récupérer sur le site web d’Olaqin :
o L’installeur de driver PC/SC Olaqin pour Windows
o Le driver PC/SC Olaqin MAC
o Le driver PC/SC Olaqin Linux.
Les environnements supportés sont :
- Microsoft Windows 10, 8.1, 7
- MAC OS 10.10, 10.11, 10.12.
Sur le terminal, le mode de communication est choisi dans le menu de l’application EI96 / protocole
USB :
- Le protocole PSS est sélectionné par défaut.
- Lorsque le protocole PC/SC est choisi, le paramètre période est réglé par défaut à 10s. Il est
recommandé de ne pas modifier ce paramètre.
- Une fois le changement de protocole validé, le terminal redémarre. Il n’y a pas de redémarrage
du terminal si l’utilisateur n’a pas modifié le protocole.
Dans tous les cas, il est nécessaire de procéder à l’installation selon les étapes décrites dans
le manuel utilisateur (configuration préalable du terminal et du socle, mode opératoire).
Une fois le driver PC/SC et l’ensemble terminal/socle installés en mode PC/SC, le lecteur de carte à
puce « Ingenico SESAM-VITALE reader » apparaît dans le gestionnaire de périphérique Windows.
Un seul lecteur de carte apparaît dans cet environnement, quel que soit le nombre de fentes carte
présentées physiquement par le terminal.
Les interfaces carte sont accessibles depuis le poste de travail via le protocole PC/SC et présentent le
nommage suivant, en accord avec le référentiel GIE SESAM-VITALE :
- Ingenico XXXXXXXX TL TELIUM 1 0 => Interface 1 exclusivement dédiée à la carte CPS
- Ingenico XXXXXXXX TL TELIUM 2 0 => Interface 2 dédiée à la carte SESAM-VITALE
- Ingenico XXXXXXXX TL TELIUM 3 0 => Interface 3 dédiée à la carte SESAM-VITALE
[Link] 7/10
Version 05.00
PRIUM4 - Guide de l’éditeur
Public
XXXXXXXX représente le numéro de série du terminal.
L’utilisation du mode PC/SC permet également de convoyer des trames PSS via la fonction
SCardControl du « resource manager PC/SC ». Ce mode de transmission est conforme au référentiel
TL V04.00 et constitue un mode de compatibilité intermédiaire entre le PSS et le PC/SC.
4.2. Référentiel Terminal Lecteur V04.00 : sécurité
Les PRIUM-4 livrés conformes TL4.0 embarquent un nouveau dispositif de sécurité permettant de
renforcer l’intégrité des secrets du GIE SESAM-Vitale.
4.3. Référentiel Terminal Lecteur V03.60 : ordres obsolètes
Conformément aux référentiels Terminal Lecteur V03.60 et V04.00, certains ordres sont maintenant
obsolètes (ex. Suppression des ordres 1.31).
Référentiel
Code / Nom de la fonction appelée
TL 03.60 et >
0x90 LVIT-LCV : lecture de la Carte Vitale Obsolète
0x92 CFSE : certification de la FSE (C.D.C. 1.31) Obsolète
0x92 CLOT : certification de l’ensemble des lots (C.D.C. 1.31) Obsolète
0x95 LDVAC : lecture des droits de la Carte Vitale Obsolète
4.4. Améliorations
L’utilisateur a dorénavant la possibilité de gérer :
- L’activation / la désactivation de la plupart des bips sonores. Le son est activé par défaut.
- L’activation / la désactivation du rétro-éclairage. Le rétro-éclairage est activé par défaut.
Se référer au manuel utilisateur qui décrit plus en détail ces fonctionnalités.
[Link] 8/10
Version 05.00
PRIUM4 - Guide de l’éditeur
Public
5. Présentation des nouveautés de la version
EI96 3.32 et Homepage 1.09
5.1. Ordonnancement des applications Santé
Depuis le lancement du PRIUM-4, nous avons constaté lors de l’envoi de l’API SESAM-Vitale relative à
la « Lecture de configuration du Terminal Lecteur » que certains logiciels de Santé traitaient la réponse
du PRIUM-4 en considérant qu’il n’existait qu’une seule application : EI96. PRIUM-4 est un terminal
multi-applicatif et de fait cette évolution force l’ordre de la remontée des applications avec l’EI96 en
premier.
5.2. Affichage de la dernière date de mise à jour de la carte Vitale
Si PRIUM-4 est activé avec le service de télémise à jour PRIUM-Service+, à l’insertion de la carte Vitale,
la dernière date de mise à jour est affichée :
5.3. Paramétrage de la date/heure
Le paramétrage de la date et de l’heure du PRIUM-4 est disponible depuis le menu Paramètre du
terminal \ Configuration \ Date/heure :
[Link] 9/10
Version 05.00
PRIUM4 - Guide de l’éditeur
Public
6. Présentation de la version EI96 3.31 et
Homepage 1.06
Ce package logiciel est le premier destiné à la vente du PRIUM-4, et homologué au référentiel TL3.30.
----------------- FIN DU DOCUMENT -----------------
[Link] 10/10
