Ing ordre generique_tpv_serveur 0.8

Version Draft 0.8 janvier 2009

INGEVOUCHER

Complément du protocole ECR
Dialogues serveur / caisse

Technical Specification © ATX SOFTWARE
R&D Dept. Gestion des périphériques caisse
Author: BURGUIERE Yann E-mail: yburguiere@ingevoucher.com

Date :2009-08-01
Version : 00.8

Dialogues serveur / caisse Date: 01/2009
INGEVOUCHER Release: 0.8

1 Table des tableaux..................................................................................................................... 3
2 Table des figures ....................................................................................................................... 4
3 Historique ................................................................................................................................... 5
4 Objet du document .................................................................................................................... 6
5 Principes .................................................................................................................................... 7
5.1 Enchaînements possibles des messages ....................................................................... 7
5.1.1 Cas 1 : Message 8105/8115 simple........................................................................ 7
5.1.2 Cas 2 : Message 8105/8115 avec messages 8104/8114 intercalés ....................... 8
5.1.3 Cas 3 : Message 8105/8115 puis 8105, avec messages 8104/8114 intercalés ..... 9
6 Format général des messages ............................................................................................... 10
6.1 Principes ....................................................................................................................... 10
6.2 Description du message 8104/8114 ............................................................................. 10
6.3 Description du message 8105/8115 ............................................................................. 11
7 Format des données TLV ........................................................................................................ 12
7.1 Le format TLV ............................................................................................................... 12
7.2 Le format TLV composé ............................................................................................... 12
7.3 Le format TLV crypté .................................................................................................... 12
7.4 Plages de valeurs des tags........................................................................................... 13
7.5 Valeurs des TAGS ........................................................................................................ 15
7.6 Descriptif des TAGS spéciaux ...................................................................................... 19
7.6.1 Données du message 8101 (T_DATAS_8101)..................................................... 19
7.6.2 Demie clé de session (T_HALF_SESS_KEY) ...................................................... 19
7.6.3 Données du message 8111 (T_DATAS_8111)..................................................... 19
8 Structures des données des messages ................................................................................ 21
8.1 Structures des données des messages 8104/8114 ...................................................... 21
8.1.1 Effacement écran.................................................................................................. 21
8.1.2 Affichage écran ..................................................................................................... 22
8.1.3 Saisie confirmation ............................................................................................... 23
8.1.4 Saisie de caractères ............................................................................................. 24
8.1.5 Impression d’une ligne .......................................................................................... 25
8.1.6 Impression d’un buffer .......................................................................................... 26
8.1.7 Coupure papier ..................................................................................................... 27
8.1.8 Scanne code barre ............................................................................................... 28
8.1.9 Lecture de piste magnétique ................................................................................ 29
8.1.10 Demande de code confidentiel ............................................................................. 30
8.2 Structures des données des messages 8105/8115 ...................................................... 31
8.2.1 Réservation de produit identifié par un gencode................................................... 31
8.2.2 Confirmation/annulation de transaction ................................................................ 33
8.2.3 Requête carte cadeau .......................................................................................... 34
9 Exemples de séquences d’échanges de messages ............................................................. 35
9.1 Vente de recharge téléphonique virtuelle ..................................................................... 35
9.2 Vente de carte iTunes avec lecture de piste ISO .......................................................... 36
9.3 Activation de carte cadeau ........................................................................................... 37
9.4 Paiement avec une carte cadeau ................................................................................. 38
10 Codes retours (tag T_RES_TRX) ............................................................................................ 39
11 Formats additionnels de ticket ............................................................................................... 40
11.1 Impression de codes à barres ...................................................................................... 40
11.2 Impression de logos...................................................................................................... 40
11.3 Impression de données préenregistrées....................................................................... 40
11.4 Impressions dynamiques des tags et des lignes liées aux tags .................................... 40
12 Annexe1.................................................................................................................................... 42
12.1 Exemple de demande de lecture de piste magnétique ................................................. 42

CONFIDENTIEL Page 2 / 42
www.ingevoucher.com


1 Table des tableaux
Tableau 1 – Format général des messages. .................................................................. 10
Tableau 2 – Plages de valeurs des tags ........................................................................ 13
Tableau 3 – Valeurs des tags. ........................................................................................ 18
Tableau 4 – Données en clair du message 8101. .......................................................... 19
Tableau 5 – Demie clé de session. ................................................................................ 19
Tableau 6– Données en clair du message 8111. ........................................................... 20
Tableau 7 – Commande effacement écran. ................................................................... 21
Tableau 8 – Commande d’affichage écran. ................................................................... 22
Tableau 9 – Commande de saisie de confirmation ........................................................ 23
Tableau 10 – Commande de saisie de caractères. ........................................................ 24
Tableau 11 – Commande d’impression de ligne. ........................................................... 25
Tableau 12 – Commande d’impression de buffer. ......................................................... 26
Tableau 13 – Commande de coupure papier. ................................................................ 27
Tableau 14 – Commande de scanne code barre. .......................................................... 28
Tableau 15 – Commande de lecture de piste magnétique. ........................................... 29
Tableau 16 – Demande de code confidentiel. ................................................................ 30
Tableau 17 – Demande de réservation de produit. ........................................................ 32
Tableau 18 – Demande de confirmation/annulation de transaction. .............................. 33
Tableau 19 – Requête carte cadeau. ............................................................................. 34
Tableau 20 – Codes retour (tag T_RES_TRX). ............................................................. 39

www.ingevoucher.com


2 Table des figures
Figure 1 – Message 8105/8115 simple. ........................................................................... 7
Figure 2 - Message 8105/8115 avec messages 8104/8114 intercalés. ........................... 8
Figure 3 - Message 8105/8115 puis 8105, avec messages 8104/8114 intercalés .......... 9
Figure 4 - Vente de recharge téléphonique virtuelle ...................................................... 35
Figure 5 - Vente de carte iTunes avec lecture de piste ISO. ......................................... 36
Figure 6 - Activation de carte cadeau. ............................................................................ 37
Figure 7 - Paiement avec une carte cadeau .................................................................. 38

www.ingevoucher.com


3 Historique

Version Date Commentaires Auteur
00.1 2008-21-08 Release 1 EURONET
00.2 2008-05-09 Ajout de codes retour. EURONET
Nouveau caractères de contrôle pour les
tickets.
00.3 2008-26-11 Ajout du message 8105/8115 EURONET
Ajout du tag crypté.
Ajout de valeurs de tags.
00.4 2008-02-12 Modification de l’entête du message EURONET
8105/8115
Modification des types de messages
8105/8115.
00.5 2008-10-12 Ajout de la saisie de code confidentiel EURONET
Ajout de tags liés aux cartes cadeaux
Ajout du message de requête carte cadeau.
Enrichissement des codes retours.
00.6 2008-17-12 Gestion de l’impression des tags. EURONET
Corrections mineures.
00.7 2008-24-12 Ajout d’exemples d’échanges. EURONET
Corrections mineures.
00.8 2009-08-01 Modification des tickets. EURONET
Modifications mineures..

www.ingevoucher.com


4 Objet du document
Ce document est un complément du document
ING_ECR_INTERFACE_TCP_IP_IMPLEMENTATION définissant le protocole
d’échanges entre les caisses et le serveur INGEVOUCHER.

Ce document décrit un nouveau format de message générique basé sur le format
TLV. Ce format de message a pour but d’offrir une souplesse et une évolutivité
maximum dans les dialogues caisses/serveur.

www.ingevoucher.com


5 Principes
Deux nouveaux messages obéissent à ce format :
.
- Le message 8104/8114, qui est à l’initiative du serveur.
- Le message 8105/8115, qui est à l’initiative de la caisse.

Le message 8104/8114 a pour objectif de mettre à disposition du serveur les
périphériques du point de vente.
A réception d’un message 8104, le point de vente doit y répondre par un message
8114 et se mettre en attente d’un nouveau message.

Le message 8105/8115 a pour objectif d’effectuer tout type de demande au serveur.
A réception d’un message 8105, le serveur répond par un message 8115. La réponse
est facultative et dépend du type de demande.
Des messages 8104/8114 peuvent être intercalés entre la demande 8105 et la réponse
8115.

5.1 Enchaînements possibles des messages
5.1.1 Cas 1 : Message 8105/8115 simple

Point de Serveur
vente

8105

8115

Figure 1 – Message 8105/8115 simple.

www.ingevoucher.com


5.1.2 Cas 2 : Message 8105/8115 avec messages 8104/8114 intercalés

Point de Serveur
vente

8105

8104

8114

8104

8114

8115

Figure 2 - Message 8105/8115 avec messages 8104/8114 intercalés.

www.ingevoucher.com


5.1.3 Cas 3 : Message 8105/8115 puis 8105, avec messages 8104/8114
intercalés

Point de Serveur
vente

8105

8104

8114

8104

8114

8115

8105

Figure 3 - Message 8105/8115 puis 8105, avec messages 8104/8114 intercalés

www.ingevoucher.com


6 Format général des messages

6.1 Principes
Les messages possèdent un format analogue aux messages déjà existants dans
protocole ECR.
Ils sont composés de deux parties distinctes :

- Un entête identifiant de manière unique le point de vente.
- Des données applicatives liées au message.

Les entêtes sont différents pour les messages 8104/8114 et 8105/8115.
Les données applicatives peuvent être cryptées ou non.

L’intégralité des messages est exprimée au format ASCII.

6.2 Description du message 8104/8114

FIELD DESCRIPTION LENGTH FORMAT VALUE
TRANSACTION Internal use 4 ALPHANUMERIC 0P12
CODE
MESSAGE Message class 4 ALPHANUMERIC 8104 ou 8114
CLASS and function
RUF INTERNAL USE 6 ALPHANUMERIC ‘000000’
CASH REGISTER Sequential 8 ALPHANUMERIC Right space
NUMBER number filled
identifying cash
register
SHOP NUMBER Sequential 15 ALPHANUMERIC Right space
number filled
identifying shop
REQUEST DATA TLV DATAS Var ALPHANUMERIC
DATAS
TLV

Tableau 1 – Format général des messages.

www.ingevoucher.com


6.3 Description du message 8105/8115

TRANSACTION Internal use 4 ALPHANUMERIC 0P12
CODE
MESSAGE Message class 4 ALPHANUMERIC 8105
CLASS and function 8115
CASH REGISTER Sequential 8 ALPHANUMERIC Right space
identifying cash
register
CASHIER Sequential 8 ALPHANUMERIC Right space
identifying
cashier
TRANSACTION Sequential 8 ALPHANUMERIC left zero-filled
NUMBER number (ex:123
identifying 0123)
transaction
SHOP NUMBER Sequential 15 ALPHANUMERIC Right space
number filled
identifying shop
DATE Date of request 8 ALPHANUMERIC DDMMYYYY
TIME Time of request 6 ALPHANUMERIC hhmmss
CONTROLLER Internal use 2 ALPHANUMERIC 00
REQUEST DATA TLV DATAS Var ALPHANUMERIC
DATAS
TLV

www.ingevoucher.com


7 Format des données TLV

7.1 Le format TLV

Le format des données échangées obéit aux règles suivantes :

• Les quatre premiers octets définissent le type de donnée.

• Les quatre octets suivants déterminent la longueur de la donnée.

• La présence de ces huit premiers octets est obligatoire.

• Les octets suivants, s’ils sont présents, sont la donnée elle-même.

Une donnée au format TLV a donc le format ci-dessous :

Type donnée Longueur donnée (=n) Donnée

4 octets 4 octets n octet(s)

Figure 1 - Format d'une donnée TLV

7.2 Le format TLV composé
Une donnée au format TLV peut également être composée de plusieurs données au
format TLV. Ce type de donnée est appelée « donnée composée », par opposition au
type de donnée simple.
Les tags composés possèdent une plage de valeurs spécifique.

Une donnée composée au format TLV composé a donc le format ci-dessous :

Longueur
Type donnée T1 L1 V1 …… Tn Ln Vn
donnée (=n)

4 octets 4 octets octet n octet(s) octet

Avec, T1L1V1…. TnLnVn des données simples au format TLV.
Figure 2 - Format d'une donnée TLV composée

7.3 Le format TLV crypté
Un tag crypté permet de véhiculer des données de manière sécurisée.

Un tag crypté possède différentes caractéristiques :

• La valeur du tag est incluse dans une plage de valeurs spécifique.

www.ingevoucher.com


• Les données du tag sont cryptées par un algorithme 3DES.

• Les données du tag sont composées de :
o Les données utiles.
o Des caractères de padding initialisés à ‘00’. Le padding génère une
taille totale de données multiple de 8.
o Un CRC (Cyclic Redundancy Check) sur 2 octets et calculé sur les
données utiles + les caractères de padding

• La longueur du tag indique la longueur des données utiles décryptées et
non la longueur des données cryptées.

• La longueur des données cryptées est égale au multiple de 8
immédiatement supérieur à la longueur des données utiles + 2.

Une donnée au format TLV crypté a donc le format ci-dessous :

Longueur données Donnée cryptées =
Type donnée
utiles décryptées(=n) Données utiles+padding+CRC

4 octets 4 octets m octet(s), avec m>=n+2 et m multiple de 8

Figure 3 - Format d'une donnée TLV cryptée.

7.4 Plages de valeurs des tags
Suivant leur type, les tags appartiennent à des plages de valeurs spécifiques :

Plages de
Type
valeurs
0xFFFF
à Tag composé et crypté
0xC000
Tag composé
0xBFFF
à Tag Composé et en clair
0x8000
0x7FFF
à Tag simple et crypté
0x4000
Tag simple
0x3FFF
à Tag simple et en clair
0x0000
Tableau 2 – Plages de valeurs des tags

Ainsi, chaque tags en clair possède son homologue en crypté, il suffit pour cela
d’ajouter 0x4000 à la valeur du tag en clair.

www.ingevoucher.com


Par exemple, si valeur du tag en clair « piste ISO1 » est 0x0210, la valeur du tag crypté
« piste ISO1 » sera 0x4210.

www.ingevoucher.com


7.5 Valeurs des TAGS
Les TAGS décrits dans les cases colorées (vert) sont des TAGS cryptés.

Tableau à compléter.
Format des Longueur
Nom Valeur données des Description
données

Tags composés

T_DATAS_MSG 0x8000 ALPHANUM Var. Données du message

Tags de commandes

8104/8114
T_EFF_ECRAN 0x0010 0 Effacement viseur caisse
T_AFF_LIGNE 0x0011 0 Affichage ligne
Demande de lecture de piste
T_LECT_ISO1 0x0021 0 ISO1
T_SAISIE_CONFIRM 0x0030 0 Saisie de confirmation
Saisie de plusieurs
T_SAISIE_MUL 0x0031 0 caractères
T_IMP_LIGNE 0x0040 0 Impression ligne
T_IMP_BUFF 0x0041 0 Impression buffer
T_IMP_CUT 0x0042 0 Coupure papier
Demande de scanne de code
T_SCAN 0x0050 0 barre
Demande de code
T_SAISIE_CODE_CONF 0x0032 0 confidentiel.
8105/8115
Type de message :
1 : Réservation de produit.
2 :Confirmation/annulation de
produit.
3 : Demande de nouvelle clé.

12 : Demande de paiement
avec une carte cadeau.
13 : Demande de
rechargement de carte
cadeau.
14 : Demande de solde de
carte cadeau.
15 : Demande de
remboursement de carte
cadeau.
T_TYPE_MSG 0x1101 NUMERIQUE 1

51 : Réponse à un message
de type 1.
de type 3.

de type 12.
de type 13.
de type 14.
de type 15.

www.ingevoucher.com


Confirmation/annulation de
produit :
T_CNF_CODE 0x1109 2 00 : Confirmation
11 : Annulation
8105/8115 (FDJ)
T_FDJ_REQ 0x2101 0 Demande de prise de jeux.
Réponse à la demande de
T_FDJ_ANSW 0x2111 0 prise de jeux.
Demande d’annulation de
T_ANNL_FDJ_REQ 0x2102 0 prise de jeux.
Réponse à la demande
T_ANNL_FDJ_ANSW 0x2112 d’annulation de prise de jeux.

Tags de paramètres et de données

8104/8114
T_NUM_LIGNE 0x0018 NUM 1 Numéro de ligne (affichage)
Chaîne de caractères ASCII
T_STR_ASCII 0x0019 ALPHANUM Var. (affichage ou impression)
Nombre de caractères
T_NB_CAR 0x0038 NUM Var. (saisie)
T_RES_SAISIE 0x003A ALPHANUM Var. Chaîne saisie
T_LG_MIN_CODE 0x003B NUM 1 Longueur minimum du code.
T_LG_MAX_CODE 0x003C NUM 1 Longueur maximum du code.
Type d’équipement à utiliser
T_TYPE_EQU 0x003D NUM 1 1 : PINPAD
2 : Caisse
T_CODE_CONF 0x403E NUM Var Code confidentiel
T_BUFF 0x0048 ALPHANUM Var. Buffer à imprimer
T_RES_SCAN 0x0058 NUM Var. Code scanné.
T_ISO1 0x0210 ALPHANUM Var. Piste ISO1
8105/8115
T_TRX_NB 0x1001 NUM 4 Numéro de transaction
T_DATE 0x1002 NUM 8 Date au format DDMMYYYY
T_TIME 0x1003 NUM 6 Heure au format HHMMSS
T_EAN13 0x1004 NUM 13 Code EAN13
T_RANDOM 0x1005 NUM Var. Random
Demande ticket :
T_ASK_TICK 0x1006 NUM 1 0 : Ticket non demandé.
1 : Ticket demandé.
T_ING_REF 0x1010 ALPHANUM Var. Référence Ingevoucher
T_PIN_SERIAL 0x01011 ALPHANUM Var. Numéro de série de code
Date de fin de validité de
T_VAL_DATE 0x01012 NUM 8 code au format YYYYMMDD.
Demande de nouvelle clé :
T_ASK_KEY 0x1013 NUM 1 0 : Pas de clé demandée.
1 : Nouvelle clé demandée.
Nombre de demandes max.
T_KEY_ATTPT 0x014 NUM 8 utilisant l’ancienne clé de
cryptage.
Résultat de la transaction. :
T_RES_TRX 0x1015 NUM 1 0 : Transaction OK
<>0 : Transaction échouée.
T_PIN_CODE 0x1017 ALPHANUM Var. Code d’activation
Type de confirmation :
T_CNF_TYPE 0x1018 NUM 2 00 : Confirmation
11 : Annulation
T_MST_KEY 0x1019 ALPHANUM 32 Clé maître
Ticket à imprimer pour le
T_TICK 0x1020 ALPHANUM Var. produit.
T_HALF_SESS_KEY* 0x5016 ALPHANUM 32 Demie-clé de session.
T_DATAS_8101* 0x5001 ALPHANUM 40 Données cryptées utilisées

www.ingevoucher.com


dans le message 8101
Données cryptées utilisées
T_DATAS_8111* 0x5002 ALPHANUM 144 dans le message 8111.
8105/8115 (FDJ)
Code retour retourné par le
T_FDJ_RET 0x2000 NUM Var. serveur FDJ.
Timestamp de la requête au
T_FDJ_TIMESTAMP 0x2001 NUM 14 format AAAAMMJJHHMMSS
T_FDJ_FSN 0x2002 NUM 16 Foreign serial Number
T_FDJ_COUNTERMARK 0x2003 ALPHUNUM 12 Identifiant de contremarque.
Numéro à imprimer sur le
T_FDJ_RECEIPT_NB 0x6004 NUM 32 reçu de prise de jeu.
Numéro de contrôle
T_FDJ_NNCA 0x6005 ALPHANUM 16 sécuritaire NNCA encrypté
puis encodé en base 64.
Numéro séquentiel reçu de
T_FDJ_SEQ_NUM 0x2006 NUM 5 l’OLTP.
Numéro de l’opérateur virtuel
T_FDJ_AGENT_NUM 0x2007 NUM 8 qui a effectué la prise de
jeux.
Montant de la prise de jeux
T_FDJ_AMOUNT 0x2008 NUM Var. en centimes.
Combinaison jouée pour une
grille, cette balise peut être
répétée plusieurs fois
T_FDJ_COMBI 0x6009 ALPHANUM Var. La combinaison est pré
formatée : par exemple pour
le Loto : "01 02 03 04 05"
Combinaison
complémentaire jouée pour
une grille ou pour un jeu ;
cette balise est utilisée par
exemple pour le n° chance
du Loto et les étoiles de la
T_FDJ_ADD_COMBI 0x6010 ALPHANUM Var. chance d’Euro millions ;
Cette balise peut être répétée
plusieurs fois
La combinaison est pré
formaté : par exemple pour le
Loto : "07" ; pour Euromillions
"1 2"
Numéro joué pour le numéro
chance Joker ;
Cette balise peut être répétée
plusieurs fois
T_FDJ_JOKER 0X6013 ALPHANUMERIQUE Var. La combinaison est pré
formaté : par exemple pour le
Loto et Euromillions :
"1 234 567".
T_FDJ_BP 0x2011 NUM Var. Identifiant de bitmap.
Identifiant de message
T_FDJ_MP 0x2012 NUM Var. prédéfini.
8105/8115 (CARTE CADEAU)
T_PAN 0x3000 NUM 19 Primary Account Nnumber.
T_TRANSAC_AMOUNT 0x3001 NUM 12 Montant de transaction
1 : Manuel
T_ENTRY_MODE 0x3002 NUM 1 2 : Piste ISO
3 : Code barre
T_CURRENCY 0x3003 ALPHA 3 Devise
T_BALANCE_AMT 0x3004 NUM 12 Solde de la carte.

Tags de compte-rendu

8104/8114
Compte-rendu d’analyse du
message reçu :
0 = OK
T_CR_MSG 0x0100 NUM 1 1 = Longueur incorrecte
2 = Format de paramètre(s)
incorrect

www.ingevoucher.com


3 = Paramètre absent
10 = Commande inconnue
Compte-rendu d’affichage :
0 = OK
T_CR_AFF 0x0310 NUM 1 1 = Affichage échoué.
10 = Périphérique absent.
Compte-rendu de saisie :
0 = OK
T_CR_SAISIE 0x0330 NUM 1 1 = Abandon saisie
3 = Timeout saisie
10 = Périphérique absent
Compte-rendu d’impression :
0 = OK
T_CR_IMP 0x0340 NUM 1 1 = Impression échouée
2 = Papier absent
Compte-rendu du scanne :
0 = OK
T_CR_SCAN 0x0340 NUM 1 1 = Scanne échoué
Compte rendu de lecture de
piste ISO2:
0 = OK
T_CR_ISO 0x0120 NUM 1 1 = Carte illisible
2 = Abandon lecture
3 = Timeout lecture
9 = Autre échec
8105/8115 (FDJ)
Compte-rendu de demande
de prise de jeux :
T_CR_FDJ_REQ 0x2301 0 0 : Requête aboutie.
<> 0 : Requête non aboutie.
Compte-rendu de demande
de prise de jeux :
T_CR_ANNL_FDJ_REQ 0x2302 0 0 : Requête aboutie.
<> 0 : Requête non aboutie.

(*) : Tag spécial dont la valeur est composée de plusieurs données obéissant à une structure fixe.

Tableau 3 – Valeurs des tags.

www.ingevoucher.com


7.6 Descriptif des TAGS spéciaux
Les tags spéciaux sont composés de plusieurs données et possédant une structure
fixe.

7.6.1 Données du message 8101 (T_DATAS_8101)

La longueur totale des données en clair est de 40 octets .
Ces données sont cryptées en TDES (clé de 16 octets), puis converties au format
ASCII. La longueur finale de la valeur du TAG est donc de 80 octets.

Les données en clair, avant encryption et conversion sont les suivantes :

GENCODE GENCODE eVoucher 13 BCD Format Given by
eVoucher Ingevoucher
Random 1 Session Key Part1 8 Binary Random generated
value
Random 2 (Padd) Random used for 6 Binary Random generated
verification value
CRC Cyclic Redundancy 2 Binary CRC of the 32
Check previous bytes
Ask Receipt Flag for asking Receipt 1 Binary 0xAA : true
Other : false
PADDING PADDING 5 Binary 00 00 … 00
Tableau 4 – Données en clair du message 8101.

7.6.2 Demie clé de session (T_HALF_SESS_KEY)



Random 3 Session Key Part2 8 Binary Random generated
value
Random 4 (Padd) Encrypted Random4 6 Binary Random generated
value
CRC Cyclic Redundancy 2 Binary CRC of the 14
Check previous bytes

Tableau 5 – Demie clé de session.

7.6.3 Données du message 8111 (T_DATAS_8111)


www.ingevoucher.com



GENCODE GENCODE eVoucher 13 ALPHANUMERIC Given by Ingevoucher
eVoucher
PIN LENGTH 1 Binary Indicate the length of
the PIN
PIN PIN 32 ALPHANUMERIC PIN in hex format
SERIAL LENGTH Serial length 1 Binary Indicate the length of
the PIN
PIN SERIAL Pin serial number 10 BCD Format Serial in BCD with
zero-padding
VALIDITY DATE 4 BCD Format YYYYMMDD
RUF INTERNAL USE 5 ALPHANUMERIC “00000”.
LRC Longitudinal 1 Binary LRC of the 66
Redundancy Check previous bytes
PADDING PADDING 5 Binary 00 00 … 00
Tableau 6– Données en clair du message 8111.

www.ingevoucher.com


8 Structures des données des messages
Ce chapitre concerne le champ “REQUEST DATA” des messages. Il décrit les tags
utilisés pour les commandes standards.

8.1 Structures des données des messages 8104/8114

8.1.1 Effacement écran

8.1.1.1 Format :

Présence
Longueur des O : Obligatoire
TAG Description
données F : Facultative
C : Conditionnelle

Demande (8104)

T_DATAS_MSG Var. O
T_EFF_ECRAN 0 O Demande d’effacement écran
1 : Ecran Pinpad
T_TYPE_EQU 1 O
2 : Ecran caisse

Réponse (8114)

T_DATAS_MSG Var. O
Résultat analyse du format de la
T_CR_MSG 1 O
demande.
T_CR_AFF 1 C Compte-rendu commande
Tableau 7 – Commande effacement écran.

8.1.1.2 Exemple :

www.ingevoucher.com


8.1.2 Affichage écran

8.1.2.1 Format :

Présence
TAG Description
C : Conditionnelle

Demande (8104)

T_DATAS_MSG Var. O
T_AFF_LIGNE 0 O Demande d’affichage écran
T_NUM_LIGNE 1 O Numéro de ligne à traiter.
T_STR_ASCII Var. O Chaine à afficher sur la ligne.
Numéro de ligne à traiter (les lignes
T_NUM_LIGNE 1 F
suivantes sont facultatives).
T_STR_ASCII Var. F Chaine à afficher sur la ligne.
1 : Ecran Pinpad
T_TYPE_EQU 1 O
2 : Ecran caisse

Réponse (8114)

T_DATAS_MSG Var. O
T_CR_MSG 1 O
demande.
T_CR_AFF 1 C Compte-rendu commande
Tableau 8 – Commande d’affichage écran.

8.1.2.2 Exemple :

www.ingevoucher.com


8.1.3 Saisie confirmation

8.1.3.1 Format :

Longueur Présence
O : Obligatoire
TAG des Description
F : Facultative
données C : Conditionnelle

Demande (8104)

T_DATAS_MSG Var. O
T_SAISIE_CONFIRM 0 O Demande de saisie de confirmation
1 : Saisie Pinpad
T_TYPE_EQU 1 O
2 : Saisie caisse

Réponse (8114)

T_DATAS_MSG Var. O
T_CR_MSG 1 O
demande.
T_CR_SAISIE 1 C Compte-rendu commande
Tableau 9 – Commande de saisie de confirmation

8.1.3.2 Exemple :

www.ingevoucher.com


8.1.4 Saisie de caractères

8.1.4.1 Format :

Présence
TAG Description
C : Conditionnelle

Demande (8104)

T_DATAS_MSG Var. O
T_SAISIE_MUL 0 O Demande de saisie de caractères
1 : Saisie Pinpad
T_TYPE_EQU 1 O
2 : Saisie caisse

Réponse (8114)

T_DATAS_MSG Var. O
T_CR_MSG 1 O
demande.
T_CR_SAISIE 1 C Compte-rendu commande
T_NB_CAR 1 C Nombre de caractères saisis
T_RES_SAISIE Var. C Chaîne saisie.
Tableau 10 – Commande de saisie de caractères.

8.1.4.2 Exemple :

www.ingevoucher.com


8.1.5 Impression d’une ligne

8.1.5.1 Format :

Présence
TAG Description
C : Conditionnelle

Demande (8104)

T_DATAS_MSG Var. O
T_IMP_LIGNE 0 O Demande d’impression d’une ligne
T_STR_ASCII Var O Chaine à imprimer

Réponse (8114)

T_DATAS_MSG Var. O
T_CR_MSG 1 O
demande.
T_CR_IMP 1 C Compte-rendu commande
Tableau 11 – Commande d’impression de ligne.

8.1.5.2 Exemple :

www.ingevoucher.com


8.1.6 Impression d’un buffer

8.1.6.1 Format :

Présence
TAG Description
C : Conditionnelle

Demande (8104)

T_DATAS_MSG Var. O
T_IMP_BUFF 0 O Demande d’impression d’une ligne
T_BUFF Var O Buffer à imprimer

Réponse (8114)

T_DATAS_MSG Var. O
T_CR_MSG 1 O
demande.
Tableau 12 – Commande d’impression de buffer.

8.1.6.2 Exemple :

www.ingevoucher.com


8.1.7 Coupure papier

8.1.7.1 Format :

Présence
TAG Description
C : Conditionnelle

Demande (8104)

T_DATAS_MSG Var. O
T_IMP_CUT 0 O Demande d’impression d’une ligne

Réponse (8114)

T_DATAS_MSG Var. O
T_CR_MSG 1 O
demande.
Tableau 13 – Commande de coupure papier.

8.1.7.2 Exemple :

www.ingevoucher.com


8.1.8 Scanne code barre

8.1.8.1 Format :

Présence
TAG Description
C : Conditionnelle

Demande (8104)

T_DATAS_MSG Var. O
T_SCAN 0 O Demande de scanne de code barre

Réponse (8114)

T_DATAS_MSG Var. O
T_CR_MSG 1 O
demande.
T_CR_SCAN 1 C Compte-rendu du scanne
T_RES_SCAN Var C Données scannées
Tableau 14 – Commande de scanne code barre.

8.1.8.2 Exemple :

www.ingevoucher.com


8.1.9 Lecture de piste magnétique

8.1.9.1 Format :

Présence
TAG Description
C : Conditionnelle

Demande (8104)

T_DATAS_MSG Var. O
T_LECT_ISO2 0 O Demande de lecture de piste ISO2

Réponse (8114)

T_DATAS_MSG Var. O
T_CR_MSG 1 O
demande.
T_CR_ISO 1 C Compte-rendu de la lecture piste
T_ISO Var C Données lues
Tableau 15 – Commande de lecture de piste magnétique.

8.1.9.2 Exemple :

www.ingevoucher.com


8.1.10 Demande de code confidentiel

8.1.10.1 Format :

Longueur Présence
O : Obligatoire
TAG des Description
F : Facultative
données C : Conditionnelle

Demande (8104)

T_DATAS_MSG Var. O
T_CODE_CONF 0 O Demande de code confidentiel
T_LG_MIN_CODE 1 O Longueur minimum du code.
T_LG_MAX_CODE 1 O Longueur maximum du code.
1 : Saisie pinpad (code porteur)
T_TYPE_EQU 1 O
2 : Saisie caisse (code caissier)

Réponse (8114)

T_DATAS_MSG Var. O
T_CR_MSG 1 O
demande.
T_CR_SAISIE 1 C Compte-rendu de la saisie.
T_CODE_CONF Var O Code confidentiel
Tableau 16 – Demande de code confidentiel.

8.1.10.2 Exemple :

www.ingevoucher.com


8.2 Structures des données des messages 8105/8115
8.2.1 Réservation de produit identifié par un gencode

Les requêtes de réservation de produit doivent obligatoirement être suivies d’une
confirmation/annulation de transaction (message de type 2).

8.2.1.1 Format :

Présence
TAG Description
C : Conditionnelle

Demande (8105)

T_DATAS_MSG Var. O
1 : Demande de réservation de
T_TYPE_MSG 1 O
produit.
T_DATAS_8101 40 O Données du message 8101

Réponse (8115)

T_DATAS_MSG Var. O
51 : Réponse à la demande de
T_TYPE_MSG 1 O
réservation sur code EAN.
Référence unique du produit
T_ING_REF 6 O délivrée par le serveur
Ingevoucher.
T_PIN_SERIAL 20 max O Code série du produit.
Date d’expiration du produit au
T_VAL_DATE 8 O
format YYYYMMDD
T_ASK_KEY 1 O Indicateur de clé à actualiser.
Nombre de demande réalisables
T_KEY_ATTPT 8 O
avec l’ancienne clé.
Solde de la carte (pour les cartes
T_BALANCE_AMT 12 F
cadeau).
T_RES_TRX 2 O Résultat de la demande.
Demie-clé de session générée
T_HALF_SESS_KEY 32 O
par le serveur.
Données cryptées de réponse
T_DATAS_8111 144 F
(suivant le type de produit).
Ticket à imprimer pour ce
T_TICK Var F
produit.
Numéro à imprimer sur le reçu
T_FDJ_RECEIPT_NB 32 F de jeux, encrypté puis encodé en
base 64 (FDJ).
T_FDJ_NNCA 16 F Numéro de contrôle NNCA (FDJ)
Combinaison(s) jouée(s) à
T_FDJ_COMBI Var F
imprimer (FDJ)
Combinaison(s)
T_FDJ_ADD_COMBI Var F complémentaire(s) jouée(s) à
imprimer (FDJ)
Numéro joker joué à imprimer
T_FDJ_JOKER Var F
(FDJ)

www.ingevoucher.com


Tableau 17 – Demande de réservation de produit.

8.2.1.2 Exemple :

www.ingevoucher.com


8.2.2 Confirmation/annulation de transaction
8.2.2.1 Format :

Présence
Longueur O : Obligatoire
TAG Description
des données F : Facultative
C : Conditionnelle

Demande (8105)

T_DATAS_MSG Var. O
51 : Confirmation/annulation de
T_TYPE_MSG 1 O
produit.
Référence unique du produit
T_ING_REF 6 O délivrée par le serveur
Ingevoucher.
Indicateur de confirmation ou
T_CNF_CODE 2 O
annulation.
Montant de la transaction, confirmation
du montant traité.
T_TRANSAC_AMOUNT 12 F Utilisé pour les échanges carte cadeau
(activation ou paiement).

Réponse (8115)

Pas de réponse pour ce type de message
Tableau 18 – Demande de confirmation/annulation de transaction.

8.2.2.2 Exemple :

www.ingevoucher.com


8.2.3 Requête carte cadeau

Si la requête carte cadeau est de type 12, 13 ou 15, elle doit obligatoirement être suivie
d’une confirmation/annulation de transaction (message de type 2).

8.2.3.1 Format :

Présence
Longueur O : Obligatoire
TAG Description
des données F : Facultative
C : Conditionnelle

Demande (8105)

T_DATAS_MSG Var. O
12 : Demande de paiement avec une
carte cadeau.
13 : Demande de rechargement de carte
T_TYPE_MSG 1 O cadeau.
14 : Demande de solde de carte cadeau.
15 : Demande de remboursement de
carte cadeau.
T_PAN 19 C Primary Account Nnumber.
1 : Manuel
T_ENTRY_MODE 1 O 2 : Piste ISO
3 : Code barre
T_TRANSAC_AMOUNT 12 C Montant de transaction
T_CURRENCY 3 C Devise

Réponse (8115)

T_DATAS_MSG Var. O
62 : Réponse à la demande de paiement.
rechargement
T_TYPE_MSG 1 O 64 : Réponse à la demande de solde
carte
remboursement.
Référence unique de la
T_ING_REF 6 O
transaction.
T_BALANCE_AMT 12 O Solde de la carte
T_RES_TRX 2 O Résultat de la demande.
Si T_TYPE_MSG = 62, possibilité de
T_TICK Var F ticket informant du nouveau solde et des
montants.

Tableau 19 – Requête carte cadeau.

www.ingevoucher.com


9 Exemples de séquences d’échanges de messages

9.1 Vente de recharge téléphonique virtuelle

Point de Serveur
vente

8105
T_TYPE_MSG = 1

8115
T_TYPE_MSG = 51

8105
T_TYPE_MSG = 2

Figure 4 - Vente de recharge téléphonique virtuelle

www.ingevoucher.com


9.2 Vente de carte iTunes avec lecture de piste ISO

Point de Serveur
vente

8105
T_TYPE_MSG = 1

8104
Demande de lecture ISO2

8114
Réponse à la lecture ISO2

8115
T_TYPE_MSG = 51

8105
T_TYPE_MSG = 2

Figure 5 - Vente de carte iTunes avec lecture de piste ISO.

www.ingevoucher.com


9.3 Activation de carte cadeau

Point de Serveur
vente

8105
T_TYPE_MSG = 1

8104
Demande de lecture ISO2

8114
Réponse à la lecture ISO2

8115
T_TYPE_MSG = 51
T_BALANCE_AMT présent

8105
T_TYPE_MSG = 2
T_TRANSAC_AMOUNT présent

Figure 6 - Activation de carte cadeau.

www.ingevoucher.com


9.4 Paiement avec une carte cadeau

Point de Serveur
vente

8105
T_TYPE_MSG = 12
T_PAN présent

8115
T_TYPE_MSG = 62
T_BALANCE_AMT présent

8105
T_TYPE_MSG = 2

Figure 7 - Paiement avec une carte cadeau

www.ingevoucher.com


10 Codes retours (tag T_RES_TRX)
Le tag T_RES_TRX peut prendre les valeurs suivantes :

00 Accepted
04 Internal Error. Try Again
05 Request rejected (authorization
refused)
06 No more costumer credit
11 Invalid Format. Field missing or
invalid in header.
12 Fatal Error. Ask Ingevoucher.
15 Duplicate transaction
21 Invalid Operator Code
22 Invalid Product Code
23 Invalid Merchant ID/Invalid Terminal
ID
24 Obsolete
30 No PINs are available
40 No answer
41 Server connexion failed (Ingeclient)
42 Server connexion failed (Ingeserver)
43 Error during communication
50 Unknown reference
51 Record failed
63 Identification failed
71 Expired card
72 Invalid transaction
73 Invalid amount
74 Invalid card number
55 Invalid confidential pincode
80 Accepted, magnetic card treated
with success.

81 Magnetic card treatment failed
82 Unknown card
83 Invalid card
84 Wrong card datatd format
85 Card already activated
90 Card account invalid
100 Card balance lower than amount
101 Card amount is null
Tableau 20 – Codes retour (tag T_RES_TRX).

www.ingevoucher.com


11 Formats additionnels de ticket

De nouveaux caractères de contrôle sont définis.

11.1 Impression de codes à barres
Ce caractère de contrôle permet l’impression de codes à barres.

Caractère de contrôle : 0x1A
Format de la ligne : 0x1AGxxxxxxxxxxxxx
Avec :
0x1A : caractère de contrôle
G : Format du code à barre (1 = EAN13, 2 = EAN128)
xxxxx… : Valeur numérique à formater

Exemple, Impression d’un EAN13 de valeur 1234567890123 :
x1A11234567890123x0A

11.2 Impression de logos
Ce caractère de contrôle permet l’impression de logos préenregistrés dans la caisse.

Caractère de contrôle : 0x1B
Format de la ligne : 0x1Bxxx
Avec :
0x1B : caractère de contrôle
xxx : Référence du logo à imprimer

Exemple, Impression du logo 2 :
x1B002x0A

11.3 Impression de données préenregistrées
Ce caractère de contrôle permet l’impression de données préenregistrées dans la
caisse.

Caractère de contrôle : 0x1E
Avec :
0x1E : caractère de contrôle
xxx : Référence des données à imprimée

Exemple, Impression du texte 3 :
x1E003x0A

11.4 Impressions dynamiques des tags
Un tag peut être imprimé en fonction de la présence de celui-ci.
Le format de l’impression est dépendant du format de la donnée.

Le caractère de contrôle demandant l’impression d’un tag est :
@Vxxxxnn, avec xxxx la valeur du tag et nn le numéro d’occurrence du tag.

Exemple :

www.ingevoucher.com


Impression de combinaison FDJ (tag T_FDJ_COMBI = 0x6009 ).

La partie du ticket reçue et liée à l’impression des combinaisons est :

Voici vos combinaisons :
@V600901
@V600902
@V600903

Bonne chance !

Dans la réponse du serveur, si le tag T_FDJ_COMBI comporte 2 occurrences dont les
valeurs sont « 01 02 03 04 05 » & « 06 07 08 09 », l’impression des combinaisons sur
le ticket final est :

Voici vos combinaisons
01 02 03 04 05
06 07 08 09

Bonne chance !

www.ingevoucher.com


12 Annexe1
12.1 Exemple de demande de lecture de piste magnétique
Les trames suivantes, définissent l’échange suivant :
- Demande à la caisse 1234 du magasin 5566 de lire les pistes ISO2 et ISO3.
- Réponse de la caisse avec une lecture de la piste ISO2 (1030150604567111100=8888)
réussie et un échec sur la lecture de la piste ISO3.

0P128104000000 1234 5566800000100020000000230000

0P128114000000 1234 55668000002A0120000200022000181030150604567111
100=8888
0120000201

Décomposition des données TLV du message aller :

- TAG de données du message : 8000
- Longueur de données du message : 0010
- Tag demande lecture ISO2 : 0020
- Longueur demande lecture ISO2 : 0000
- Tag demande lecture ISO3 : 0023
- Longueur demande lecture ISO3 : 0000

Décomposition des données TLV du message retour :

- TAG de données du message : 8000
- Longueur de données du message : 002A
- Tag CR de lecture ISO : 0120
- Longueur CR de lecture ISO : 0002
- CR de lecture ISO : 0000
- Tag ISO2 : 0220
- Longueur ISO2 : 0018
- ISO2 : 1030150604567111100=8888
- Tag CR de lecture ISO : 0120
- Longueur CR de lecture ISO : 0002
- CR de lecture ISO : 01

www.ingevoucher.com

Ing ordre generique_tpv_serveur 0.8

Recomendados

Recomendados

Mais conteúdo relacionado

Mais procurados

Mais procurados (20)

Destaque

Destaque (6)

Semelhante a Ing ordre generique_tpv_serveur 0.8

Semelhante a Ing ordre generique_tpv_serveur 0.8 (20)

Último

Último (13)

Ing ordre generique_tpv_serveur 0.8