Création du bouton et paramétrage de l’url :
Paramètres utilisables
Exemples d’appels
Gestion des erreurs

Création du bouton et paramétrage de l’url :

Pour ajouter un appel à une url externe, passer en mode paramétrage de l’écran de caisse :

Cliquer sur le bouton d’ajout de fonctionnalité.

Sélectionner « Url externe »

Dans le formulaire, il faut remplir :

Libellé : Nom que portera le bouton en caisse

Url : Url qui sera appelée

Type de réponse :

-Fenêtre en caisse : Affiche le résultat de l’appel dans une fenêtre en caisse. La fenêtre est redimensionnable, minimisable et déplaçable afin que l’utilisateur puisse continuer à travailler sur sa caisse. Automatiquement utilisé si l’appel à l’url renvoie du Json ou du Xml.

Attention : Certains sites comme Google n’autorisent pas l’affichage de leur site dans une fenêtre au sein d’un autre site.

-Nouvel onglet : Ouvre l’url dans un nouvel onglet. Seulement utilisable si l’url appelée renvoie du html.

Paramètres obligatoirement initialisés : Définit si les paramètres de l’url (variables clictill) doivent être initialisés ou si leur valeur peut rester nulle.

Retour : Définit le type de données que l’url appelée va renvoyer.

Couleur et image : Couleur & image du bouton qui apparaît en caisse

Paramètres utilisables

Il y a différentes variables qui peuvent être utilisées dans une url. Elles sont les suivantes :

article.reference : Référence de l’article sélectionné en caisse

article.ext_code : Code externe de l’article sélectionné en caisse

article.barcode : Code barre de l’article sélectionné en caisse

shop.code : Code de la boutique actuelle

shop.ext_code : Code externe de la boutique actuelle

customer.id_customer : Id du client sélectionné

customer.code : Code du client sélectionné

customer.ext_code : Code externe du client sélectionné

customer.loyalty_barcode : Code barre fidélité du client sélectionné

receipt.id_receipt : Id du ticket sélectionné

receipt.receipt_number : Numéro du ticket sélectionné

receipt.ext_code : Code externe du ticket sélectionné

Les paramètres doivent être entourés de deux barres verticales (PIPE), par exemple :

http://test.url.com/art=||article.reference||&customer=||customer.id_customer||&

Ce qui donnera : http://test.url.com/art=52630 &customer=17 &

Exemples d’appels

Appels HTML

Appel Html avec fenêtre en caisse

Pour appeler une adresse qui renvoie du html et dont le retour se fera dans une fenêtre en caisse les paramètres sont les suivants :

Lorsque l’on clique sur le bouton « Appel Html en caisse » , la fenêtre s’ouvre de cette manière :

Il est possible de la déplacer, de la redimensionner et de la minimiser.

Appel Html vers un nouvel onglet

Pour ouvrir une url dans un nouvel onglet, les paramètres sont identiques, il suffit de cocher « Nouvel onglet » au lieu de « Fenêtre en caisse » :

L’ouverture se fera donc dans un nouvel onglet du navigateur.

Appel Json

Lorsque l’on appelle une url qui renvoie du Json, seul un affichage en caisse est possible.

Les paramètres à utiliser sont les suivants :

Et l’affichage sera le suivant :

Appel XML

De la même manière, il est possible d’appeler une url renvoyant des données au format XML.

Les paramètres à utiliser sont les suivants :

Lors de l’appel à l’url le retour en caisse sera le suivant :

Appel à une url Google Maps

Il est possible d’afficher en caisse la localisation de votre boutique.

Pour cela, il faut utiliser votre clé d’API Google Maps.

Le format de l’url est le suivant :

https://www.google.com/maps/embed/v1/place?key=VOTRE_CLE_API&q=ADRESSE

où l’adresse est entrée en remplaçant les espaces par le caractère « + »

exemple :

https://www.google.com/maps/embed/v1/place?key=VOTRE_CLE_API&q=41+Rue+Laure+Diebold+69009+Lyon

Les paramètres sont donc les suivants :

Et le résultat de l’appel sera celui-ci :

Gestion des erreurs

Comme il est possible d’entrer des paramètres (par exemple, « article.barcode » ), mais qu’ils ne soient pas définis en caisse, l’option « paramètres obligatoirement initialisés » peut être activée.

Ainsi, si l’utilisateur appelle une url contenant des variables clictill qui n’ont pas été initialisées, il sera prévenu et pour annuler l’appel afin d’initialiser les variables (par ex. en cliquant sur la ligne d’un article dans un ticket)

Exemple de message d’erreur :