Shopify, WooCommerce
Hela a sa propre vitrine (carte publique et boutique), qui suffit à beaucoup de commerces. Pour ceux qui vendent déjà sur Shopify ou WooCommerce : les commandes entrent comme ventes, le stock de Hela est écrit dans la boutique.
Ce qui circule
| Sens | Quoi | Quand |
|---|---|---|
| Boutique → Hela | Chaque commande devient une vente : client retrouvé par e-mail ou créé, lignes retrouvées par référence (SKU) ou ajoutées en lignes libres, frais de port en ligne de service, payée si la commande l'est. Une commande ne crée jamais deux ventes. | Le webhook de la boutique, à la commande ; et un passage toutes les quinze minutes pour ce que le webhook aurait manqué |
| Hela → boutique | La quantité en stock de chaque article qui a une référence, additionnée sur les établissements | Après chaque passage, et après une réception fournisseur, un transfert, une alerte de stock bas, une annulation |
Les ventes importées portent le canal En ligne et le numéro de la commande dans la note.
Le stock est réécrit dans la boutique à chaque mouvement : vente au comptoir ou en ligne, annulation ou avoir, réception d'achat, transfert, inventaire validé, ajustement, perte ou retour (sale.created, sale.cancelled, invoice.refunded, purchase.received, transfer.completed, stock.movement, stock.low).
Shopify
- Dans la boutique : Paramètres → Applications et canaux de vente → Développer des applications → Créer une application. Portées Admin API :
read_orders,read_products,write_inventory,read_locations. Installez l'app et copiez le jeton d'accès (shpat_…) et la clé secrète de l'application. - Dans Hela, Intégrations → Shopify → Connecter : la boutique (
ma-boutique.myshopify.com), le jeton, la clé secrète. - Paramètres → Notifications → Webhooks dans Shopify : « Création de commande », format JSON, vers l'adresse de notification affichée par Hela. La clé secrète signe chaque envoi (
X-Shopify-Hmac-Sha256) et Hela le vérifie.
Réglages : le portefeuille des commandes payées, l'établissement des ventes en ligne, l'écriture du stock (oui par défaut), l'emplacement Shopify du stock (rempli au premier test avec le premier emplacement actif).
WooCommerce
- WooCommerce → Réglages → Avancé → API REST → Ajouter une clé, droits lecture/écriture : copiez la consumer key et le consumer secret.
- Dans Hela, Intégrations → WooCommerce → Connecter : l'adresse du site, les deux clés.
- WooCommerce → Réglages → Avancé → Webhooks → Ajouter : sujet « Commande créée », vers l'adresse de notification de Hela, avec un secret que vous recopiez dans Hela ; chaque envoi est signé (
X-WC-Webhook-Signature).
Une commande est payée dans Hela quand WooCommerce la dit processing ou completed. Le stock est écrit sur le produit (stock_quantity), pas sur les variations.
Bon à savoir
- Donnez aux articles Hela la référence de la boutique : c'est elle qui relie les deux. Un article sans référence entre comme ligne libre et son stock n'est pas écrit.
- Les remboursements et annulations faits dans la boutique ne touchent pas la vente Hela ; annulez-la ou remboursez-la dans Hela, qui le dit à la boutique par le stock.
- Le journal de la connexion montre, par passage, le nombre de commandes importées et de quantités écrites.