Intégration e-commerce
L'intégration relie une boutique en ligne à Nadigit IMS. Nadigit IMS reste la référence pour les articles, les prix, les taxes et le stock ; la boutique lui transmet ses commandes.
Ce qui est synchronisé
| Sens | Ce qui circule |
|---|---|
| Nadigit IMS → boutique | Catalogue de l'entrepôt lié (nom, description, catégorie, prix, taxe, images, codes-barres) et quantités disponibles. Toute variation de stock, qu'elle vienne du point de vente, d'un achat, d'une radiation, d'un transfert ou d'un retour, est signalée à la boutique. Un article désactivé ou épuisé est retiré de la vente en ligne. |
| Nadigit IMS → boutique | Statut des commandes web : en cours, livrée, annulée, retournée, et l'état du paiement. |
| Boutique → Nadigit IMS | Commandes passées en ligne, enregistrées comme des ventes, et leurs annulations. |
Prérequis
- La formule Enterprise.
- Dans l'entrepôt que la boutique vendra : des articles actifs, avec un prix de vente et du stock.
- Un magasin auquel rattacher les ventes en ligne. Elles restent ainsi distinctes des ventes du point de vente dans les rapports.
- La boutique et Nadigit IMS doivent pouvoir s'appeler mutuellement en HTTPS.
- Le rôle Administrateur.
Chaque boutique est liée à un seul entrepôt et un seul magasin. Pour vendre en ligne le stock de deux entrepôts, créez deux intégrations.
Plateformes
| Plateforme | Connecteur |
|---|---|
| Bagisto | Connecteur fourni par Nadigit |
| Shopify, WooCommerce, Personnalisée | Un connecteur développé sur l'API d'intégration |
Connecter une boutique
1. Déclarer la boutique
- Ouvrez Paramètres du système → Paramètres globaux, onglet Intégrations, puis Intégrations e-commerce.
- Cliquez sur Nouvelle intégration et renseignez :
- la Plateforme et un Nom ;
- l'URL de la boutique, son adresse publique ;
- l'Entrepôt et le Magasin liés, obligatoires avant le provisionnement ;
- le Chemin du webhook, l'adresse sur la boutique qui reçoit les notifications de Nadigit IMS. La valeur proposée convient au connecteur Bagisto ;
- le Secret du webhook (HMAC) : laissez-le vide, le provisionnement le génère.
- Cliquez sur Enregistrer.
2. Provisionner le connecteur
Dans la liste, cliquez sur Provisionner le connecteur sur la ligne de la boutique. Nadigit IMS crée l'identité du connecteur : un compte technique qui n'a accès qu'à l'API d'intégration, et seulement pour l'entrepôt et le magasin liés.
La fenêtre Configuration du connecteur affiche alors :
- l'adresse de Nadigit IMS et l'adresse d'obtention des jetons ;
- l'identifiant et le secret du client ;
- le secret du webhook.
La fenêtre prévient que les deux secrets ne sont affichés qu'à ce moment-là : cliquez sur Copier le JSON et conservez-le en lieu sûr jusqu'à l'étape suivante. Le provisionnement peut être relancé sans risque : il ne change ni le compte du connecteur ni ses secrets.
3. Installer le connecteur sur la boutique
Pour Bagisto :
- Installez le connecteur fourni par Nadigit sur la boutique.
- Dans l'administration Bagisto, ouvrez Configure → ERP Connector et importez le JSON copié à l'étape 2.
- Enregistrez, puis cliquez sur Test Connection.
L'extension PHP intl doit être active. Après l'installation du connecteur,
videz le cache de l'application (php artisan optimize:clear) : sinon les
commandes ne sont pas transmises.
4. Vérifier
De retour dans Intégrations e-commerce, la ligne de la boutique affiche Provisionné. Le bouton Tester la connexion vérifie que Nadigit IMS joint la boutique, et la colonne Dernière synchro montre le dernier échange dans chaque sens : Entrant (boutique → IMS) et Sortant (IMS → boutique).
Commandes en ligne
- Prix et taxes recalculés. Nadigit IMS recalcule chaque commande avec ses propres prix et taxes. Si le total de la boutique diffère, la commande est quand même enregistrée, avec un avertissement d'écart de prix. Pour l'éviter, alignez les taxes de la boutique sur celles de Nadigit IMS.
- Stock. La commande sort le stock de l'entrepôt lié.
- Client. Le client est retrouvé par son e-mail, ou créé.
- Paiement. Une commande réglée à la commande (carte, portefeuille ou passerelle de paiement comme Stripe ou PayPal, virement) est enregistrée payée. Une commande payée à la livraison reste impayée jusqu'à l'encaissement.
- Annulation. Une commande annulée sur la boutique remet le stock en place. Le remboursement éventuel se fait manuellement.
- Pas de doublon. Une commande renvoyée par la boutique, par exemple après une coupure, n'est jamais enregistrée deux fois.
Bonnes pratiques
- Modifiez le catalogue dans Nadigit IMS, pas sur la boutique : c'est Nadigit IMS qui fait foi, et ses changements sont transmis à la boutique.
- Après la mise en service, vérifiez quelques articles sur la boutique : prix, taxe, stock et images.
- Alignez les taxes des deux côtés avant d'ouvrir la vente en ligne.
- Supprimer une intégration arrête immédiatement la synchronisation avec cette boutique.