Onglet Intégrations : votre adresse d'envoi, WooCommerce, Glovo et API

▶Vidéo à venir

L'onglet Intégrations est réservé au propriétaire, et au module Intégrations (« Intégrations (WooCommerce, Glovo, API) »). Les secrets (mots de passe SMTP, clés) ne sont jamais montrés à un manager.

Envoyer le rapport Z depuis votre adresse#

Le rapport Z par e-mail est inclus pour tous : ses destinataires se règlent dans l'onglet Tickets (tickets et impression) et il part au nom de votre commerce depuis QodPOS. Ici, vous pouvez le faire partir de votre propre adresse.

• Fournisseur d'e-mail : SMTP (défaut) ou Brevo (API). Brevo envoie en HTTP : pratique quand l'hébergeur bloque les ports SMTP.
  • Brevo : Clé API Brevo (xkeysib-…) et E-mail expéditeur (vérifié dans Brevo).
  • SMTP : Hôte (par exemple smtp.gmail.com), Port (587), SSL/TLS (port 465 ; désactivé = STARTTLS 587), Utilisateur, Mot de passe (ou mot de passe d'application).
• Envoyer les rapports à rappelle les destinataires réglés dans l'onglet Tickets. Nom de l'expéditeur facultatif (« Café Atlas — Rapports »).
• Enregistrer, puis Tester SMTP / Tester Brevo (35 secondes au plus) : le test part vers ces destinataires.

Un champ texte vidé garde l'ancienne valeur côté serveur. Le contenu du rapport est décrit dans la clôture.

Intégrations externes#

Des clés d'API relient des plateformes (QodWeb, WooCommerce, Glovo…) : les commandes reçues arrivent dans l'onglet « En ligne » de la caisse (commandes en ligne).

Points d'accès API#

Deux adresses en lecture seule, avec Copier :

• Envoi des commandes : …/api/external-orders/ingest.
• Synchronisation du catalogue produits : …/api/external-orders/sync-products.
• En-tête : Authorization: Bearer <clé>.

Clés API#

Nouvelle intégration : Nom (obligatoire), Plateforme (QodWeb, WooCommerce, Glovo, Autre), Webhook URL (facultative ; adresse https:// publique où QodPOS envoie les changements d'état confirmé / annulé). Créer la clé (format qod_…).

Pour Glovo, ajoutez Client ID, Client Secret, Chain ID et (facultatif) Store ID, trouvés dans le portail partenaire Glovo (« Shop Integrations »), puis copiez l'adresse « Webhook Glovo » dans ce portail.

Par clé : afficher/copier, activer/désactiver, modifier le webhook, supprimer (la clé est révoquée tout de suite).

WooCommerce#

1. Dans WooCommerce : Réglages › Avancé › API REST : créez une clé.
2. Ici : URL du site (publique), Consumer Key (ck_…), Consumer Secret (cs_…), puis Tester.
3. Copiez l'URL du webhook dans WooCommerce ; ajoutez le Secret du webhook pour vérifier la signature (facultatif).
4. Activez Activer WooCommerce et Enregistrer : les commandes arrivent dans l'onglet « En ligne ».

Synchroniser les produits importe le catalogue (images téléchargées et compressées). Les produits absents de WooCommerce sont archivés (récupérables). Correspondance des produits relie les produits WooCommerce à ceux de la caisse (par nom, ou à la main) pour que les commandes en ligne se terminent seules. Importer via CSV (avancé) (WooCommerce ou Shopify) remplace tout le catalogue après confirmation.

Format de la requête#

Une documentation d'API : POST …/ingest en JSON. Obligatoires : externalOrderId, customer.name, items[].name, items[].qty, items[].unitPrice ; facultatifs : téléphone, adresse, externalProductId, total, notes, paymentMethod.