Karim vend des vêtements pour enfants. Il a une boutique WooCommerce, une page Instagram avec ses propres commandes, et depuis peu une vitrine sur une place de marché. Trois canaux, un seul rayon dans son dépôt à Birkhadem. Chaque soir, il compare trois listes de commandes avec ce qu'il lui reste, et une fois par semaine il vend une robe qu'il n'a plus. Le client attend, s'énerve, le colis revient, et Karim rembourse une livraison qu'il a payée.

Le problème n'est pas d'avoir trois sites. C'est d'avoir trois stocks. Voici comment brancher deux ou trois sites de vente sur un seul stock, celui d'Almawarid, pour qu'une quantité vendue quelque part disparaisse partout.

Le principe : une seule vérité, les sites la lisent

Dans Almawarid, chaque produit a une référence (SKU) et une quantité en stock. C'est cette quantité, et elle seule, qui fait foi. Les sites de vente ne tiennent plus leur propre compte : ils reçoivent la quantité d'Almawarid et lui renvoient chaque commande. Quand une commande arrive d'un site, le stock descend dans Almawarid, et les autres sites reçoivent la nouvelle quantité.

La clé de tout, c'est la référence. Le même article doit porter le même SKU sur chaque site et dans Almawarid. « ROBE-ROSE-6A » sur WooCommerce, « ROBE-ROSE-6A » sur la place de marché, « ROBE-ROSE-6A » dans le stock. Une heure passée à unifier les références évite des mois de corrections à la main.

Site 1 : WooCommerce, sans une ligne de code

Pour WooCommerce, tout est prêt dans le module E-commerce d'Almawarid :

  1. Dans WooCommerce : Réglages, Avancé, REST API, « Créer une clé » avec les droits lecture et écriture.
  2. Dans Almawarid, page E-commerce : collez l'adresse de la boutique, la clé et le secret, puis « Tester la connexion ».
  3. « Importer les produits » : la correspondance se fait par SKU. Les produits déjà connus sont reliés, les inconnus sont signalés.
  4. Cochez « Pousser mon stock vers la boutique » : dès qu'une quantité change dans Almawarid, le site reçoit la nouvelle valeur.
  5. Cochez « Importer les commandes en temps réel » : WooCommerce appelle Almawarid à chaque commande, la commande apparaît dans votre file de confirmation et le stock est décompté.

Le journal des synchronisations, sur la même page, montre chaque échange. Si un produit du site n'a pas de correspondance, vous le voyez là, avec son SKU.

Sites 2 et 3 : par l'API

Pour une place de marché, un site fait sur mesure, un PrestaShop ou une deuxième boutique, Almawarid expose une API avec un jeton. Le jeton se trouve dans le menu, entrée « API & jeton », et s'envoie dans l'en-tête de chaque appel :

Authorization: Token VOTRE_JETON

Deux appels suffisent pour tenir un stock partagé.

Lire les quantités

GET https://almawarid.app/api/stock/products/?active=1

La réponse liste chaque produit avec son identifiant, son SKU, son code-barres, son prix de vente et sa quantité actuelle. Votre site 2 appelle cette adresse toutes les cinq ou dix minutes, retrouve chaque article par SKU et met à jour ses propres quantités. Un article à zéro passe en rupture sur le site avant qu'un client ne le commande.

Déclarer une vente

POST https://almawarid.app/api/stock/move/
{"product_id": 128, "delta": -2, "reason": "Commande marketplace #4471"}

Quand une commande arrive sur le site 2, votre script envoie une sortie de stock par ligne : un delta négatif, et le motif qui vous permettra de retrouver la commande. Si la sortie rendait le stock négatif, Almawarid la refuse : c'est le signal qu'un client a acheté la dernière pièce ailleurs quelques secondes plus tôt, et qu'il faut le prévenir avant d'expédier.

Une entrée de marchandise, un retour client ou un inventaire se déclarent de la même façon avec un delta positif.

Qui écrit ce script ?

Un développeur y passe une demi-journée : une tâche planifiée qui lit les quantités et met à jour le site, un point d'entrée qui reçoit les commandes du site et déclare les sorties. Les plateformes d'automatisation qui savent appeler une adresse web avec un en-tête font aussi l'affaire pour les volumes modestes. Le module « API & Webhooks » d'Almawarid donne les exemples d'appels, et vous pouvez tester avec un jeton avant de brancher quoi que ce soit en production.

Ce qui change pour Karim

  • Il n'a plus qu'un chiffre à regarder : la quantité dans Almawarid. Elle vaut pour les trois canaux.
  • Une pièce vendue sur Instagram, saisie en dix secondes dans la saisie rapide, disparaît du site WooCommerce et de la place de marché dans les minutes qui suivent.
  • Les commandes des trois canaux arrivent dans la même file de confirmation : un appel, un WhatsApp, et le colis part avec le bon tarif de livraison par wilaya.
  • Le taux de retour baisse, parce qu'il n'envoie plus jamais un colis pour un article qu'il n'a plus.

Le module E-commerce est disponible à la demande, avec le connecteur WooCommerce inclus ; l'accès API fait partie du module « API & Webhooks ». Ouvrez un compte, branchez votre premier site, et demandez-nous les deux autres.