Ing ordre generique_tpv_serveur 0.8

42
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: [email protected] Date :2009-08-01 Version : 00.8

Transcript of Ing ordre generique_tpv_serveur 0.8

Page 1: 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: [email protected] Date :2009-08-01 Version : 00.8

Page 2: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 2 / 42 www.ingevoucher.com

INGEVOUCHER

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

Page 3: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 3 / 42 www.ingevoucher.com

INGEVOUCHER

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

Page 4: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 4 / 42 www.ingevoucher.com

INGEVOUCHER

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

Page 5: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 5 / 42 www.ingevoucher.com

INGEVOUCHER

3 Historique

Version Date Commentaires Auteur

00.1 2008-21-08 Release 1 EURONET

00.2 2008-05-09 Ajout de codes retour.

Nouveau caractères de contrôle pour les tickets.

EURONET

00.3 2008-26-11 Ajout du message 8105/8115

Ajout du tag crypté.

Ajout de valeurs de tags.

EURONET

00.4 2008-02-12 Modification de l’entête du message 8105/8115

Modification des types de messages 8105/8115.

EURONET

00.5 2008-10-12 Ajout de la saisie de code confidentiel

Ajout de tags liés aux cartes cadeaux

Ajout du message de requête carte cadeau.

Enrichissement des codes retours.

EURONET

00.6 2008-17-12 Gestion de l’impression des tags.

Corrections mineures.

EURONET

00.7 2008-24-12 Ajout d’exemples d’échanges.

Corrections mineures.

EURONET

00.8 2009-08-01 Modification des tickets.

Modifications mineures..

EURONET

Page 6: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 6 / 42 www.ingevoucher.com

INGEVOUCHER

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.

Page 7: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 7 / 42 www.ingevoucher.com

INGEVOUCHER

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

Figure 1 – Message 8105/8115 simple.

Point de vente

Serveur

8105

8115

Page 8: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 8 / 42 www.ingevoucher.com

INGEVOUCHER

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

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

Point de vente

Serveur

8105

8115

8114

8104

8114

8104

Page 9: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 9 / 42 www.ingevoucher.com

INGEVOUCHER

5.1.3 Cas 3 : Message 8105/8115 puis 8105, avec mes sages 8104/8114

intercalés

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

Point de vente

Serveur

8105

8115

8114

8104

8114

8104

8105

Page 10: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 10 / 42 www.ingevoucher.com

INGEVOUCHER

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 A SCII. 6.2 Description du message 8104/8114

FIELD DESCRIPTION LENGTH FORMAT VALUE

TRANSACTION CODE

Internal use 4 ALPHANUMERIC 0P12

MESSAGE CLASS

Message class and function

4 ALPHANUMERIC 8104 ou 8114

RUF INTERNAL USE 6 ALPHANUMERIC ‘000000’ CASH REGISTER

NUMBER Sequential number identifying cash register

8 ALPHANUMERIC Right space filled

SHOP NUMBER Sequential number identifying shop

15 ALPHANUMERIC Right space filled

TLV

D

AT

AS

REQUEST DATA TLV DATAS

Var ALPHANUMERIC

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

Page 11: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 11 / 42 www.ingevoucher.com

INGEVOUCHER

6.3 Description du message 8105/8115

FIELD DESCRIPTION LENGTH FORMAT VALUE

TRANSACTION CODE

Internal use 4 ALPHANUMERIC 0P12

MESSAGE CLASS

Message class and function

4 ALPHANUMERIC 8105 8115

RUF INTERNAL USE 6 ALPHANUMERIC ‘000000’ CASH REGISTER

NUMBER Sequential number identifying cash register

8 ALPHANUMERIC Right space filled

CASHIER NUMBER

Sequential number identifying cashier

8 ALPHANUMERIC Right space filled

TRANSACTION NUMBER

Sequential number identifying transaction

8 ALPHANUMERIC left zero-filled (ex:123 � 0123)

SHOP NUMBER Sequential number identifying shop

15 ALPHANUMERIC Right space filled

DATE Date of request 8 ALPHANUMERIC DDMMYYYY TIME Time of request 6 ALPHANUMERIC hhmmss CONTROLLER Internal use 2 ALPHANUMERIC 00

TLV

D

AT

AS

REQUEST DATA TLV DATAS

Var ALPHANUMERIC

Page 12: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 12 / 42 www.ingevoucher.com

INGEVOUCHER

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

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 :

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

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.

4 octets 4 octets n octet(s)

4 octets 4 octets octet n octet(s) octet

Page 13: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 13 / 42 www.ingevoucher.com

INGEVOUCHER

• 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 :

Type donnée Longueur données utiles décryptées(=n)

Donnée cryptées = Données utiles+padding+CRC

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 valeurs Type

0xFFFF à 0xC000

Tag composé

Tag composé et crypté

0xBFFF à 0x8000

Tag Composé et en clair

0x7FFF à 0x4000

Tag simple

Tag simple et crypté

0x3FFF à 0x0000

Tag simple et en clair

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.

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

Page 14: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 14 / 42 www.ingevoucher.com

INGEVOUCHER

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

Page 15: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 15 / 42 www.ingevoucher.com

INGEVOUCHER

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

Nom Valeur Format des

données Longueur

des données

Description

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

T_LECT_ISO1 0x0021 0 Demande de lecture de piste ISO1

T_LECT_ISO2 0x0020 0 Demande de lecture de piste ISO2

T_LECT_ISO3 0x0023 0 Demande de lecture de piste ISO3

T_SAISIE_CONFIRM 0x0030 0 Saisie de confirmation

T_SAISIE_MUL 0x0031 0 Saisie de plusieurs caractères

T_IMP_LIGNE 0x0040 0 Impression ligne

T_IMP_BUFF 0x0041 0 Impression buffer

T_IMP_CUT 0x0042 0 Coupure papier

T_SCAN 0x0050 0 Demande de scanne de code barre

T_SAISIE_CODE_CONF 0x0032 0 Demande de code confidentiel.

8105/8115

T_TYPE_MSG 0x1101 NUMERIQUE 1

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. 51 : Réponse à un message de type 1. 53 : Réponse à un message de type 3. 62 : Réponse à un message de type 12. 63 : Réponse à un message de type 13. 64 : Réponse à un message de type 14. 65 : Réponse à un message de type 15.

Page 16: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 16 / 42 www.ingevoucher.com

INGEVOUCHER

T_CNF_CODE 0x1109 2

Confirmation/annulation de produit : 00 : Confirmation 11 : Annulation

8105/8115 (FDJ) T_FDJ_REQ 0x2101 0 Demande de prise de jeux.

T_FDJ_ANSW 0x2111 0 Réponse à la demande de prise de jeux.

T_ANNL_FDJ_REQ 0x2102 0 Demande d’annulation de prise de jeux.

T_ANNL_FDJ_ANSW 0x2112 Réponse à la demande 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)

T_STR_ASCII 0x0019 ALPHANUM Var. Chaîne de caractères ASCII (affichage ou impression)

T_NB_CAR 0x0038 NUM Var. Nombre de caractères (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.

T_TYPE_EQU 0x003D NUM 1 Type d’équipement à utiliser 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

T_ISO2 0x0220 ALPHANUM Var. Piste ISO2

T_ISO3 0x0230 ALPHANUM Var. Piste ISO3

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

T_ASK_TICK 0x1006 NUM 1 Demande ticket : 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

T_VAL_DATE 0x01012 NUM 8 Date de fin de validité de code au format YYYYMMDD.

T_ASK_KEY 0x1013 NUM 1 Demande de nouvelle clé : 0 : Pas de clé demandée. 1 : Nouvelle clé demandée.

T_KEY_ATTPT 0x014 NUM 8 Nombre de demandes max. utilisant l’ancienne clé de cryptage.

T_RES_TRX 0x1015 NUM 1 Résultat de la transaction. : 0 : Transaction OK <>0 : Transaction échouée.

T_PIN_CODE 0x1017 ALPHANUM Var. Code d’activation

T_CNF_TYPE 0x1018 NUM 2 Type de confirmation : 00 : Confirmation 11 : Annulation

T_MST_KEY 0x1019 ALPHANUM 32 Clé maître

T_TICK 0x1020 ALPHANUM Var. Ticket à imprimer pour le produit.

T_HALF_SESS_KEY* 0x5016 ALPHANUM 32 Demie-clé de session.

T_DATAS_8101* 0x5001 ALPHANUM 40 Données cryptées utilisées

Page 17: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 17 / 42 www.ingevoucher.com

INGEVOUCHER

dans le message 8101

T_DATAS_8111* 0x5002 ALPHANUM 144 Données cryptées utilisées dans le message 8111.

8105/8115 (FDJ)

T_FDJ_RET 0x2000 NUM Var. Code retour retourné par le serveur FDJ.

T_FDJ_TIMESTAMP 0x2001 NUM 14 Timestamp de la requête au format AAAAMMJJHHMMSS

T_FDJ_FSN 0x2002 NUM 16 Foreign serial Number

T_FDJ_COUNTERMARK 0x2003 ALPHUNUM 12 Identifiant de contremarque.

T_FDJ_RECEIPT_NB 0x6004 NUM 32 Numéro à imprimer sur le reçu de prise de jeu.

T_FDJ_NNCA 0x6005 ALPHANUM 16 Numéro de contrôle sécuritaire NNCA encrypté puis encodé en base 64.

T_FDJ_SEQ_NUM 0x2006 NUM 5 Numéro séquentiel reçu de l’OLTP.

T_FDJ_AGENT_NUM 0x2007 NUM 8 Numéro de l’opérateur virtuel qui a effectué la prise de jeux.

T_FDJ_AMOUNT 0x2008 NUM Var. Montant de la prise de jeux en centimes.

T_FDJ_COMBI 0x6009 ALPHANUM Var.

Combinaison jouée pour une grille, cette balise peut être répétée plusieurs fois La combinaison est pré formatée : par exemple pour le Loto : "01 02 03 04 05"

T_FDJ_ADD_COMBI 0x6010 ALPHANUM Var.

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 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"

T_FDJ_JOKER 0X6013 ALPHANUMERIQUE Var.

Numéro joué pour le numéro chance Joker ; Cette balise peut être répétée plusieurs fois La combinaison est pré formaté : par exemple pour le Loto et Euromillions : "1 234 567".

T_FDJ_BP 0x2011 NUM Var. Identifiant de bitmap.

T_FDJ_MP 0x2012 NUM Var. Identifiant de message prédéfini.

8105/8115 (CARTE CADEAU) T_PAN 0x3000 NUM 19 Primary Account Nnumber.

T_TRANSAC_AMOUNT 0x3001 NUM 12 Montant de transaction

T_ENTRY_MODE 0x3002 NUM 1 1 : Manuel 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

T_CR_MSG 0x0100 NUM 1

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

Page 18: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 18 / 42 www.ingevoucher.com

INGEVOUCHER

3 = Paramètre absent 10 = Commande inconnue

T_CR_AFF 0x0310 NUM 1

Compte-rendu d’affichage : 0 = OK 1 = Affichage échoué. 10 = Périphérique absent.

T_CR_SAISIE 0x0330 NUM 1

Compte-rendu de saisie : 0 = OK 1 = Abandon saisie 3 = Timeout saisie 10 = Périphérique absent

T_CR_IMP 0x0340 NUM 1

Compte-rendu d’impression : 0 = OK 1 = Impression échouée 2 = Papier absent 10 = Périphérique absent

T_CR_SCAN 0x0340 NUM 1

Compte-rendu du scanne : 0 = OK 1 = Scanne échoué 10 = Périphérique absent

T_CR_ISO 0x0120 NUM 1

Compte rendu de lecture de piste ISO2: 0 = OK 1 = Carte illisible 2 = Abandon lecture 3 = Timeout lecture 9 = Autre échec

8105/8115 (FDJ)

T_CR_FDJ_REQ 0x2301 0

Compte-rendu de demande de prise de jeux : 0 : Requête aboutie. <> 0 : Requête non aboutie.

T_CR_ANNL_FDJ_REQ 0x2302 0

Compte-rendu de demande de prise de jeux : 0 : Requête aboutie. <> 0 : Requête non aboutie.

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

Tableau 3 – Valeurs des tags.

Page 19: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 19 / 42 www.ingevoucher.com

INGEVOUCHER

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 :

FIELD DESCRIPTION LENGTH FORMAT VALUE

GENCODE eVoucher

GENCODE eVoucher 13 BCD Format Given by Ingevoucher

RUF INTERNAL USE 5 ALPHANUMERIC ‘00000’ Random 1 Session Key Part1

8 Binary Random generated

value Random 2 (Padd) Random used for

verification 6 Binary Random generated

value CRC Cyclic Redundancy

Check 2 Binary CRC of the 32

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) La longueur totale des données en clair est de 16 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 32 octets. Les données en clair, avant encryption et conversion sont les suivantes :

FIELD DESCRIPTION LENGTH FORMAT VALUE

Random 3 Session Key Part2

8 Binary Random generated value

Random 4 (Padd) Encrypted Random4 6 Binary Random generated value

CRC Cyclic Redundancy Check

2 Binary CRC of the 14 previous bytes

Tableau 5 – Demie clé de session.

7.6.3 Données du message 8111 (T_DATAS_8111) La longueur totale des données en clair est de 72 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 144 octets.

Page 20: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 20 / 42 www.ingevoucher.com

INGEVOUCHER

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

FIELD DESCRIPTION LENGTH FORMAT VALUE

GENCODE eVoucher

GENCODE eVoucher 13 ALPHANUMERIC Given by Ingevoucher

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

Redundancy Check 1 Binary LRC of the 66

previous bytes PADDING PADDING 5 Binary 00 00 … 00

Tableau 6– Données en clair du message 8111.

Page 21: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 21 / 42 www.ingevoucher.com

INGEVOUCHER

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 :

TAG Longueur des données

Présence O : Obligatoire F : Facultative

C : Conditionnelle Description

Demande (8104) T_DATAS_MSG Var. O T_EFF_ECRAN 0 O Demande d’effacement écran

T_TYPE_EQU 1 O 1 : Ecran Pinpad 2 : Ecran caisse

Réponse (8114) T_DATAS_MSG Var. O

T_CR_MSG 1 O Résultat analyse du format de la demande.

T_CR_AFF 1 C Compte-rendu commande

Tableau 7 – Commande effacement écran.

8.1.1.2 Exemple :

Page 22: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 22 / 42 www.ingevoucher.com

INGEVOUCHER

8.1.2 Affichage écran 8.1.2.1 Format :

TAG Longueur des données

Présence O : Obligatoire F : Facultative

C : Conditionnelle Description

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.

T_NUM_LIGNE 1 F Numéro de ligne à traiter (les lignes suivantes sont facultatives).

T_STR_ASCII Var. F Chaine à afficher sur la ligne.

T_TYPE_EQU 1 O 1 : Ecran Pinpad 2 : Ecran caisse

Réponse (8114) T_DATAS_MSG Var. O

T_CR_MSG 1 O Résultat analyse du format de la demande.

T_CR_AFF 1 C Compte-rendu commande

Tableau 8 – Commande d’affichage écran.

8.1.2.2 Exemple :

Page 23: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 23 / 42 www.ingevoucher.com

INGEVOUCHER

8.1.3 Saisie confirmation 8.1.3.1 Format :

TAG Longueur

des données

Présence O : Obligatoire F : Facultative

C : Conditionnelle Description

Demande (8104) T_DATAS_MSG Var. O T_SAISIE_CONFIRM 0 O Demande de saisie de confirmation

T_TYPE_EQU 1 O 1 : Saisie Pinpad 2 : Saisie caisse

Réponse (8114) T_DATAS_MSG Var. O

T_CR_MSG 1 O Résultat analyse du format de la demande.

T_CR_SAISIE 1 C Compte-rendu commande

Tableau 9 – Commande de saisie de confirmation

8.1.3.2 Exemple :

Page 24: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 24 / 42 www.ingevoucher.com

INGEVOUCHER

8.1.4 Saisie de caractères 8.1.4.1 Format :

TAG Longueur des données

Présence O : Obligatoire F : Facultative

C : Conditionnelle Description

Demande (8104) T_DATAS_MSG Var. O T_SAISIE_MUL 0 O Demande de saisie de caractères

T_TYPE_EQU 1 O 1 : Saisie Pinpad 2 : Saisie caisse

Réponse (8114) T_DATAS_MSG Var. O

T_CR_MSG 1 O Résultat analyse du format de la 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 :

Page 25: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 25 / 42 www.ingevoucher.com

INGEVOUCHER

8.1.5 Impression d’une ligne 8.1.5.1 Format :

TAG Longueur des données

Présence O : Obligatoire F : Facultative

C : Conditionnelle Description

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 Résultat analyse du format de la demande.

T_CR_IMP 1 C Compte-rendu commande

Tableau 11 – Commande d’impression de ligne.

8.1.5.2 Exemple :

Page 26: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 26 / 42 www.ingevoucher.com

INGEVOUCHER

8.1.6 Impression d’un buffer 8.1.6.1 Format :

TAG Longueur des données

Présence O : Obligatoire F : Facultative

C : Conditionnelle Description

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 Résultat analyse du format de la demande.

T_CR_IMP 1 C Compte-rendu commande

Tableau 12 – Commande d’impression de buffer.

8.1.6.2 Exemple :

Page 27: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 27 / 42 www.ingevoucher.com

INGEVOUCHER

8.1.7 Coupure papier 8.1.7.1 Format :

TAG Longueur des données

Présence O : Obligatoire F : Facultative

C : Conditionnelle Description

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 Résultat analyse du format de la demande.

T_CR_IMP 1 C Compte-rendu commande

Tableau 13 – Commande de coupure papier.

8.1.7.2 Exemple :

Page 28: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 28 / 42 www.ingevoucher.com

INGEVOUCHER

8.1.8 Scanne code barre 8.1.8.1 Format :

TAG Longueur des données

Présence O : Obligatoire F : Facultative

C : Conditionnelle Description

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 Résultat analyse du format de la 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 :

Page 29: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 29 / 42 www.ingevoucher.com

INGEVOUCHER

8.1.9 Lecture de piste magnétique 8.1.9.1 Format :

TAG Longueur des données

Présence O : Obligatoire F : Facultative

C : Conditionnelle Description

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 Résultat analyse du format de la 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étiqu e.

8.1.9.2 Exemple :

Page 30: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 30 / 42 www.ingevoucher.com

INGEVOUCHER

8.1.10 Demande de code confidentiel 8.1.10.1 Format :

TAG Longueur

des données

Présence O : Obligatoire F : Facultative

C : Conditionnelle Description

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.

T_TYPE_EQU 1 O 1 : Saisie pinpad (code porteur) 2 : Saisie caisse (code caissier)

Réponse (8114) T_DATAS_MSG Var. O

T_CR_MSG 1 O Résultat analyse du format de la 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 :

Page 31: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 31 / 42 www.ingevoucher.com

INGEVOUCHER

8.2 Structures des données des messages 8105/8115 8.2.1 Réservation de produit identifié par un genco de 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 :

TAG Longueur des données

Présence O : Obligatoire F : Facultative

C : Conditionnelle Description

Demande (8105) T_DATAS_MSG Var. O

T_TYPE_MSG 1 O 1 : Demande de réservation de produit.

T_DATAS_8101 40 O Données du message 8101 Réponse (8115) T_DATAS_MSG Var. O

T_TYPE_MSG 1 O 51 : Réponse à la demande de réservation sur code EAN.

T_ING_REF 6 O Référence unique du produit délivrée par le serveur Ingevoucher.

T_PIN_SERIAL 20 max O Code série du produit.

T_VAL_DATE 8 O Date d’expiration du produit au format YYYYMMDD

T_ASK_KEY 1 O Indicateur de clé à actualiser.

T_KEY_ATTPT 8 O Nombre de demande réalisables avec l’ancienne clé.

T_BALANCE_AMT 12 F Solde de la carte (pour les cartes cadeau).

T_RES_TRX 2 O Résultat de la demande.

T_HALF_SESS_KEY 32 O Demie-clé de session générée par le serveur.

T_DATAS_8111 144 F Données cryptées de réponse (suivant le type de produit).

T_TICK Var F Ticket à imprimer pour ce produit.

T_FDJ_RECEIPT_NB 32 F Numéro à imprimer sur le reçu de jeux, encrypté puis encodé en base 64 (FDJ).

T_FDJ_NNCA 16 F Numéro de contrôle NNCA (FDJ)

T_FDJ_COMBI Var F Combinaison(s) jouée(s) à imprimer (FDJ)

T_FDJ_ADD_COMBI Var F Combinaison(s) complémentaire(s) jouée(s) à imprimer (FDJ)

T_FDJ_JOKER Var F Numéro joker joué à imprimer (FDJ)

Page 32: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 32 / 42 www.ingevoucher.com

INGEVOUCHER

Tableau 17 – Demande de réservation de produit.

8.2.1.2 Exemple :

Page 33: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 33 / 42 www.ingevoucher.com

INGEVOUCHER

8.2.2 Confirmation/annulation de transaction 8.2.2.1 Format :

TAG Longueur des données

Présence O : Obligatoire F : Facultative

C : Conditionnelle Description

Demande (8105) T_DATAS_MSG Var. O

T_TYPE_MSG 1 O 51 : Confirmation/annulation de produit.

T_ING_REF 6 O Référence unique du produit délivrée par le serveur Ingevoucher.

T_CNF_CODE 2 O Indicateur de confirmation ou annulation.

T_TRANSAC_AMOUNT 12 F

Montant de la transaction, confirmation du montant traité. 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 :

Page 34: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 34 / 42 www.ingevoucher.com

INGEVOUCHER

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 :

TAG Longueur des données

Présence O : Obligatoire F : Facultative

C : Conditionnelle Description

Demande (8105) T_DATAS_MSG Var. O

T_TYPE_MSG 1 O

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_PAN 19 C Primary Account Nnumber.

T_ENTRY_MODE 1 O 1 : Manuel 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

T_TYPE_MSG 1 O

62 : Réponse à la demande de paiement. 63 : Réponse à la demande de rechargement 64 : Réponse à la demande de solde carte 65 : Réponse à la demande de remboursement.

T_ING_REF 6 O Référence unique de la transaction.

T_BALA NCE_AMT 12 O Solde de la carte T_RES_TRX 2 O Résultat de la demande.

T_TICK Var F Si T_TYPE_MSG = 62, possibilité de ticket informant du nouveau solde et des montants.

Tableau 19 – Requête carte cadeau.

Page 35: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 35 / 42 www.ingevoucher.com

INGEVOUCHER

9 Exemples de séquences d’échanges de messages 9.1 Vente de recharge téléphonique virtuelle

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

Point de vente

Serveur

8105 T_TYPE_MSG = 1

8115 T_TYPE_MSG = 51

8105 T_TYPE_MSG = 2

Page 36: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 36 / 42 www.ingevoucher.com

INGEVOUCHER

9.2 Vente de carte iTunes avec lecture de piste ISO

Figure 5 - Vente de carte iTunes avec lecture de pi ste ISO.

Point de vente

Serveur

8105 T_TYPE_MSG = 1

8115 T_TYPE_MSG = 51

8114 Réponse à la lecture ISO2

8104 Demande de lecture ISO2

8105 T_TYPE_MSG = 2

Page 37: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 37 / 42 www.ingevoucher.com

INGEVOUCHER

9.3 Activation de carte cadeau

Figure 6 - Activation de carte cadeau.

Point de vente

Serveur

8105 T_TYPE_MSG = 1

8115 T_TYPE_MSG = 51

T_BALANCE_AMT présent

8114 Réponse à la lecture ISO2

8104 Demande de lecture ISO2

8105 T_TYPE_MSG = 2

T_TRANSAC_AMOUNT présent

Page 38: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 38 / 42 www.ingevoucher.com

INGEVOUCHER

9.4 Paiement avec une carte cadeau

Figure 7 - Paiement avec une carte cadeau

Point de vente

Serveur

8105 T_TYPE_MSG = 12

T_PAN présent T_TRANSAC_AMOUNT présent

8115 T_TYPE_MSG = 62

T_BALANCE_AMT présent

8105 T_TYPE_MSG = 2

T_TRANSAC_AMOUNT présent

Page 39: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 39 / 42 www.ingevoucher.com

INGEVOUCHER

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).

Page 40: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 40 / 42 www.ingevoucher.com

INGEVOUCHER

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 :

\x1A11234567890123\x0A

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 :

\x1B002\x0A

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 :

\x1E003\x0A

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 :

Page 41: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 41 / 42 www.ingevoucher.com

INGEVOUCHER

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 !

Page 42: Ing ordre generique_tpv_serveur 0.8

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

CONFIDENTIEL Page 42 / 42 www.ingevoucher.com

INGEVOUCHER

12 Annexe1 12.1 Exemple de demande de lecture de piste magnéti que 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