Interfacer un site de vente en ligne avec la caisse Clyo (Web PHP / WooCommerce) – Clyo Systems

Résumé
Cet article explique comment interfacer un site de vente en ligne avec la caisse Clyo.

Il couvre la configuration à réaliser dans la caisse (adresse du site, mot de passe, liaison des articles).

Il décrit aussi les web services PHP à déployer côté site web pour échanger les produits et renvoyer les commandes vers la caisse.

ℹ️ Prérequis

Un accès au module Paramètre de la caisse Clyo.
L'adresse (URL) du site e-commerce.
Le mot de passe de récupération des commandes, s'il a été défini.
Un accès au site web pour y déposer les fichiers PHP (volet web service).
Les articles déjà créés dans la caisse et sur le site web.

Procédure

1	Ouvrez le module de paramétrage Paramètre > Paramètre > Périphérique → Résultat : l'onglet « Site Web e-Commerce » s'affiche.

Onglet Site Web e-Commerce avec les champs adresse du site, mot de passe, règlement C.B internet, article frais de port et article remise

3	Saisissez le mot de passe de récupération des commandes Si vous ne le connaissez pas, laissez le champ vide.

4	Vérifiez le champ « Reglement C.B internet » Il indique le mode de règlement des paiements carte du site (exemple : CARTE BLEUE).

5	Renseignez le champ « Article frais de port » Choisissez un article pour que les frais de port du site s'intègrent en caisse.

6	Renseignez le champ « Article remise » Choisissez un article pour que les remises du site s'intègrent en caisse. → Résultat : la caisse est paramétrée pour dialoguer avec le site e-commerce.

Procédure — Lier les articles de la caisse aux produits du site

Cette opération associe chaque produit du site à un article de la caisse.

Liste de gestion des liens d'articles e-commerce avec un article web sélectionné

9	Sélectionnez l'article caisse correspondant Choisissez l'article dans la liste déroulante « Article caisse ».

Sélection de l'article web (1), de l'article caisse (2) puis du bouton Lier (3)

11	Recommencez l'opération pour tous les articles Répétez la liaison jusqu'à ce que chaque produit du site soit associé à un article caisse.

Web services à déployer côté site web

Cette partie s'adresse au développeur du site web.

Elle décrit les scripts PHP que le site doit exposer pour dialoguer avec la caisse Clyo.

⚠️ Important
Placez tous les fichiers PHP dans un répertoire clyo à la racine du site web.

Liaison des produits

produitClyoKey.php liste les produits du site qui n'ont pas encore d'identifiant Clyo (produits sans clé Clyo).

Exemple d'appel : http://www.votre-site.com/clyo/produitClyoKey.php?password=motpasse

Détail des champs de la ligne d'en-tête :

- idProd : facultatif (laisser vide).
- name : nom du produit (court), exemple : Salade de Choux.
- description : description du produit, exemple : Salade de choux fait maison.
- idCategorie : facultatif (laisser vide).
- isFormule : indique si le produit est une formule ; « N » par défaut.
- idProduit : id du produit sur le site web.
- size : « 1 » par défaut.
- priceWeb : prix en livraison TTC, exemple : 15.55.
- priceShop : prix sur place ou à emporter TTC, exemple : 17.00.
- position : « 0 » par défaut.
- idClyo : id du produit Clyo ; ici vide, car on demande les produits sans clé.

Exemple de flux (la première ligne est toujours celle des champs) :

[A COMPLETER : exemple de flux de la source, illisible sur le document fourni]

produitClyoKey.php peut aussi lister les produits du site qui possèdent déjà un identifiant Clyo (produits avec clé Clyo).

Les champs sont identiques, à une différence près : idClyo est renseigné.

produitUpdate_KEY.php crée les liaisons (mapping) entre un article Clyo et un article du site.

Exemple d'appel : http://www.votre-site.com/clyo/produitUpdate_KEY.php?password=motpasse&idProduit=18&idClyo=66

Côté site, mettez à jour le produit idProduit (votre clé) en y enregistrant la clé Clyo correspondante.

Récupération des commandes

customerListOrder.php liste toutes les commandes non traitées (champ status différent de « pre »).

Exemple d'appel : http://www.votre-site.com/clyo/customerListOrder.php?password=motpasse

Détail des champs :

- idCommande : numéro de la commande.
- contenu : facultatif (laisser vide).
- contentLivrer : facultatif (laisser vide).
- productFree : « 0 » par défaut.
- amount : montant total de la commande, exemple : 50.25.
- frais : frais de port (0 par défaut).
- datelivr : date de livraison souhaitée, exemple : 2013-04-11.
- payement : « Paiement par CB » pour un paiement carte.
- status : INIT pour une commande non traitée.
- supplement : facultatif, exemple : Carte, Poivre, couvert.
- comment : commentaire sur la commande.
- hourValue : heure de livraison souhaitée (facultatif).
- hourOpening : plage de livraison (facultatif).
- nom : nom du client, exemple : Dupont.
- email : email du client.
- telephone : téléphone du client.
- libelle : libellé de l'adresse (facultatif).
- adr : adresse complète du client (facultatif).
- cp : code postal du client (facultatif).
- bat : bâtiment (facultatif).
- etage : étage (facultatif).
- interphone : interphone (facultatif).
- porte : porte (facultatif).
- digicode : digicode (facultatif).
- commentaire : facultatif.
- idShopLivr : numéro du magasin sur le menu (toujours « 2 » lorsqu'il s'agit d'un magasin).
- keyAndPrice : le détail de la commande (voir le format ci-dessous).
- resultRBK : « OK » pour un paiement carte.
- ID_SHOP_UP : laisser vide.
- amount_reduction : montant de réduction sur la commande (optionnel).
- id_carte_client : numéro de carte de fidélité (optionnel).
- id_table : numéro de la table (optionnel) ; permet l'ouverture d'une table sur le plan de salle.
- nb_couvert : nombre de couverts total si id_table est différent de 0.

Problèmes fréquents

Le client dit...	Cause probable	Solution
"Mes produits du site n'apparaissent pas dans la caisse."	Les articles ne sont pas liés.Le web service produitClyoKey.php n'est pas déployé.	Vérifiez la liaison des articles.Contrôlez que les fichiers PHP sont bien dans le répertoire /clyo.
"Les commandes du site ne remontent pas en caisse."	Le mot de passe de récupération est incorrect ou absent.Le script customerListOrder.php n'est pas accessible.	Vérifiez le mot de passe dans l'onglet « Site Web e-Commerce ».Testez l'URL d'appel du script dans un navigateur.
"Les frais de port n'apparaissent pas sur le ticket."	Le champ « Article frais de port » n'est pas renseigné.	Renseignez un article dans le champ « Article frais de port » de l'onglet.