Fonction PortCom.TPE [Divers : Port COM / Série]
Description
Envoie la commande au standard "Caisse AP" / "Concert v3" sur le port spécifié et attend le retour du TPE. Retourne la chaîne renvoyée par le TPE.
Affiche éventuellement une fenêtre avec le message spécifié et un bouton d'abandon.
Le bouton abandonner annule l'action dans SIMAX mais pas sur le terminal (c'est une limitation du protocole).
Attention : la commande est bloquante, elle se termine après le retour du TPE ou l'utilisation du bouton "Abandonner"
Syntaxe
PortCom.TPE(< Port >, < Commande > [, < Titre attente >, < Message attente >] [, < Configuration > ])
- < Port > : Le port à lire
- < Commande > : La commande texte à écrire
- < Titre attente > : titre de la fenêtre d'attente
- < Message attente > : message de la fenêtre d'attente
- < Configuration > : La configuration
Remarque
Si vous ne voulez pas les erreurs renvoyées par la fonction utiliser : SiErreur()
Extrait de la norme :
TAG action transaction
1.1 Envoi (De la Caisse vers le Terminal)
|
TAG |
|
|
|
|
CZ |
Version protocole |
|
Obligatoire Q/R identique |
|
CJ |
Identifiant protocole caisse IPC - 12 caractères |
Pas de contrôle |
Obligatoire Q/R identique |
|
CA |
N° de caisse 2 caractères |
Pas de contrôle |
Obligatoire Q/R identique |
|
CB |
Montant 2 à 10 caractères |
Limité à 10 chiffres. |
Obligatoire Cf retour (partiel) |
|
CC |
Sélection application 3 caractères |
000 : indifférent 001 : bancaire 00C : chèque Absent : 000 |
Optionnel Q/R différent |
|
CD |
Type action 1 caractère |
0 : Débit 1 : Crédit 2 : Annulation 4 : Pre-auto Autre : Fonction non implémentée |
Obligatoire Q/R identique Voir zone privative |
|
CE |
Devise numérique 3 caractères |
|
Obligatoire Q/R identique |
|
CF |
Champ privatif 1 à 99 caractères |
Cf zone définie pour BENEF |
|
|
CG |
N° contrat commerçant 10 caractères max. |
|
Optionnel Non géré |
|
CH |
N° De référence 12 caractères max. |
|
Optionnel Non géré |
|
CI |
Mode de lecture 1 caractère |
|
Optionnel Non géré Par défaut indifférent |
|
BA |
Délai de réponse 1 caractère |
0 : Réponse en fin de transaction 1 : Réponse immédiate 2 : Pas de réponse (non traité) |
Optionnel Par défaut : 0 |
|
|
|
Public |
|
|
BB |
Type autorisation 1 caractère |
0 : Cartes-auto fct transaction 1 : Demande auto forcée / Chèque=FNCI 2 : Carte idem 1, Chèque garantisseur |
Optionnel Cf chèque non implémenté ? |
|
BF |
Paiement partiel 1 caractère |
|
Optionnel Non géré |
|
1.2 |
Réponse (Du |
Terminal vers la Caisse) |
|
|
TAG |
|
|
|
|
CZ |
Version protocole |
|
Obligatoire Q/R identique |
|
CJ |
Identifiant protocole caisse IPC 12 caractères |
|
Obligatoire Q/R identique |
|
AA |
PAN 19 caractères max. |
Masqué (PCI-DSS) 123456XXXXXX1234 |
Optionnel |
|
AB |
Date fin de validité 4 caractères |
|
Optionnel Non géré |
|
AC |
N° autorisation |
|
Optionnel Non géré |
|
AD |
Piste CMC7 |
|
Optionnel |
|
AE |
Statut (2) |
01 : Opération non effectuée 10 : Opération effectuée 11 : Requête prise en compte |
Obligatoire |
|
AF |
Complément statut 1 à 50 caractères |
09 : Erreur format message 10 : Erreur sélection 11 : Abandon opérateur 12 : Type action demandé inconnu 13 : Devise non supportée |
Optionnel Géré si opération non effectuée |
|
AG |
Réponse FNCI 4 caractères |
|
Optionnel Non géré |
|
AH |
Réponse garantie 6 caractères |
|
Optionnel Non géré |
|
AI |
AID de la carte 32 caractères max. |
|
Si carte et module MSH |
|
CA |
N° de caisse 2 caractères |
|
Obligatoire Q/R identique |
CB Montant Montant réel (cf autorisation partielle) Obligatoire
2 à 10 caractères Max 10 caractères
Public
|
CC |
Application qui a effectué l’action 3 caractères |
Cf liste « Annexe 3 » |
Obligatoire |
|
CD |
Type action 1 caractère |
0 : Débit 1 : Crédit 2 : Annulation 4 : Pré-auto |
Obligatoire Q/R identique |
|
CE |
Devise 3 caractères |
Code numérique de la devise |
Obligatoire Q/R identique |
|
CF |
Champ privatif 1 à 99 caractères |
Données privées remontées par l’application. |
|
|
CG |
N° contrat commerçant 10 caractères max. |
|
N° de contrat |
|
CH |
N° de référence 12 caractères max. |
|
Optionnel Non géré |
|
CI |
Mode de lecture 1 caractère |
0 : Indifférente 1 : Contact 2 : Cless 3 : Piste 4 : Saisie manuelle |
Mode de lecture |
Exemple
PortCom.TPE(6, "CZ0040301CJ012123456789012CA00201CB003100CC003000CD0010CE003978CF003111BA0010BB0011", "Paiement par carte", "Paiement de 1,00€ en attente")
Demande de paiement par carte d'un montant de 1€
PortCom.TPE(6, "CZ0040301CJ012123456789012CA00201CD001I")
Test de dialogue avec le TPE