Intégration Ecomanager : envoyez vos commandes vers Ecomanager
Catégorie : Plateformes externes · Plan min. : Pro · Page : /dashboard/addons/ecomanager
Ecomanager est une plateforme e-commerce de gestion des commandes et des livraisons, où chaque boutique a sa propre adresse de la forme https://your-store.ecomanager.dz. Si votre équipe confirme et expédie les commandes depuis Ecomanager, cette intégration place vos commandes DZBuild dans votre boutique Ecomanager sans aucune recopie, et ramène l'état Ecomanager de chaque commande sur la commande DZBuild correspondante.
Ce que fait l'intégration
- Envoie les nouvelles commandes. Les commandes passées sur votre boutique et sur vos pages de destination partent vers Ecomanager en arrière-plan tant que Synchroniser les nouvelles commandes est activé. Elles arrivent dans Ecomanager à l'état En confirmation.
- Vous laisse envoyer les autres à la main. Toute autre commande, par exemple une commande créée depuis la page Commandes ou passée avant la connexion, attend sur la page d'intégration jusqu'à ce que vous l'envoyiez.
- Ramène les états. Une fois les webhooks enregistrés, chaque changement d'état dans Ecomanager met à jour le statut de la commande DZBuild, et un numéro de suivi fourni par Ecomanager est recopié sur la commande.
- Ignore les commandes déjà envoyées. Une commande qui porte déjà une référence Ecomanager n'est pas renvoyée.
Les changements de statut ne vont que dans un sens. DZBuild n'envoie pas les changements de statut à Ecomanager : une commande que vous confirmez ou annulez dans DZBuild garde son état précédent dans Ecomanager. Faites ces changements dans Ecomanager et laissez-les revenir.
Ce que reçoit Ecomanager
Chaque commande arrive dans Ecomanager avec :
- le nom du client, son numéro de téléphone, sa wilaya, sa commune et son adresse, plus l'e-mail et la note quand le client les a donnés ;
- chaque ligne produit avec son SKU, sa quantité et son prix unitaire ;
- les frais de livraison, la remise, et le type de livraison : à domicile ou en Stop Desk.
Le numéro de téléphone est envoyé au format local qui commence par 0 : un numéro écrit avec +213 est réécrit. La commune est envoyée sous son nom français, pour correspondre à la liste des communes d'Ecomanager.
Avant l'envoi, DZBuild cherche chaque produit dans votre boutique Ecomanager, d'abord par SKU, puis par nom. Un produit introuvable est créé dans Ecomanager avec son nom, son SKU et son prix. Si le produit n'a pas de SKU dans DZBuild, il reçoit le SKU qu'il porte dans Ecomanager ; quand DZBuild doit en créer un, il commence par DZBUILD-. DZBuild envoie un seul SKU par produit : deux variantes du même produit arrivent donc sous le même SKU.
Les états qui reviennent
Les états Ecomanager arrivent dans DZBuild de deux façons : par les webhooks une fois enregistrés, et quand vous appuyez sur le bouton d'actualisation d'une commande envoyée. Chaque état remplace le statut de la commande DZBuild :
| État Ecomanager | Votre commande DZBuild devient |
|---|---|
| En confirmation | En attente |
| En préparation | Confirmée |
| En dispatch | En préparation |
| En livraison | Expédiée |
| Livrée, Encaissée | Livrée |
| En retour, Retournée | Retournée |
| Annulée | Annulée |
Le stock suit le nouveau statut selon la même règle que lorsque vous le changez vous-même (voir Commandes). Un changement arrivé par webhook met aussi à jour la ligne de la commande dans Google Sheets si votre boutique l'utilise, et vous envoie la même alerte de mise à jour du statut qu'un changement fait par vous (voir Notifications).
Avec les webhooks enregistrés, supprimer une commande dans Ecomanager ne la supprime pas dans DZBuild : la commande perd sa référence Ecomanager et revient dans la liste des commandes en attente d'envoi, sauf si elle est annulée.
Ce que ça coûte
L'intégration n'a pas de prix propre sur DZBuild, et rien n'est facturé par commande envoyée. La carte permet de se connecter sur les plans Pro, Unlimited et Enterprise. Sur le plan Free, elle affiche un badge PRO et un bouton Passer à Pro qui ouvre /dashboard/subscribe. Votre abonnement Ecomanager est facturé par Ecomanager.
Comment connecter
- Dans Ecomanager, connectez-vous à votre compte, ouvrez Shop Configuration et copiez la valeur API Token.
- Dans DZBuild, ouvrez Tableau de bord → Extensions sur
/dashboard/addons, trouvez la carte Ecomanager dans la section Plateformes externes et cliquez sur Connecter Ecomanager. - Dans URL de votre boutique Ecomanager, tapez uniquement le slug de votre boutique, sans
https://ni.ecomanager.dz. Pourhttps://my-shop.ecomanager.dz, tapezmy-shop. L'adresse complète s'affiche sous le champ pendant la saisie. - Collez le token dans Clé API.
- Cliquez sur Tester et connecter. DZBuild vérifie le slug et le token auprès de votre boutique Ecomanager et n'enregistre la connexion que si la vérification réussit. Tester la connexion uniquement fait la même vérification sans rien enregistrer.
- Quand la page se recharge avec le badge Connecté, appuyez sur Enregistrer les Webhooks pour que les états Ecomanager reviennent dans DZBuild.
Synchroniser les nouvelles commandes est activé dès la première connexion : la prochaine commande passée sur votre boutique part vers Ecomanager sans autre étape.
Utiliser la page d'intégration
Compteurs
Quatre tuiles s'affichent en haut : Total des commandes, Commandes envoyées, En attente de synchronisation et Dernière synchronisation. En attente de synchronisation compte toutes les commandes sans référence Ecomanager, annulées comprises, alors que la liste en dessous écarte les commandes annulées.
Commandes en attente d'envoi
Cette liste montre vos 20 commandes les plus récentes sans référence Ecomanager, hors commandes annulées, avec le numéro de commande, le client, le montant et le statut. Chaque ligne a son propre bouton d'envoi. Envoyer tout envoie les commandes cochées, ou toutes celles de la liste si aucune n'est cochée, après confirmation. Un appui envoie au plus 20 commandes ; la page se recharge ensuite et des commandes plus anciennes prennent leur place.
Si un envoi groupé échoue, envoyez les commandes une par une avec le bouton de chaque ligne. Le message indique ce qu'Ecomanager a refusé, par exemple un produit qu'il n'a pas pu créer.
Commandes envoyées
Cette liste montre les 20 commandes envoyées mises à jour le plus récemment, avec le numéro de commande, la Réf Eco (la référence Ecomanager), le client et le statut DZBuild. Le bouton Actualiser le statut d'une ligne lit l'état actuel de la commande dans Ecomanager, puis met à jour le statut et le numéro de suivi de la commande DZBuild.
Paramètres de synchronisation
Synchroniser les nouvelles commandes active ou coupe l'envoi automatique. Appuyez sur Enregistrer après l'avoir changé. La ligne Mise à jour du statut des commandes en dessous n'est pas un interrupteur : elle affiche « Mises à jour automatiques via Webhooks », parce que les états reviennent par les webhooks.
Webhooks
Enregistrer les Webhooks crée quatre webhooks dans votre compte Ecomanager : un pour les changements de statut, un pour les changements de statut de livraison, un pour les changements de statut de confirmation et un pour les commandes supprimées. Leurs noms dans Ecomanager commencent par DZBuild -. Une fois qu'ils sont enregistrés, la carte affiche Enregistré et le bouton devient Réenregistrer.
Informations de connexion
Cette carte affiche l'URL de votre boutique, les six derniers caractères du token et le statut Actif. Déconnecter demande une confirmation, puis arrête l'envoi des commandes et la réception des états ; les commandes déjà envoyées restent dans Ecomanager. Quand vous vous reconnectez, Synchroniser les nouvelles commandes est de nouveau activé et vous devez appuyer à nouveau sur Enregistrer les Webhooks, parce que les webhooks de la connexion précédente ne sont plus acceptés.
Quand quelque chose ne va pas
La page affiche la raison dans un message. Les plus fréquentes :
- Le lien doit être de la forme
https://slug.ecomanager.dz: le champ de l'URL de la boutique contient plus que le slug, par exemple l'adresse complète. Tapez uniquement le slug, fait de lettres latines, de chiffres et de tirets. - La clé API est invalide ou expirée : copiez à nouveau le token depuis Shop Configuration et reconnectez-vous.
- Trop de requêtes : Ecomanager limite les appels pour un moment, attendez un peu et réessayez.
- Erreur du serveur Ecomanager : Ecomanager n'a pas répondu correctement, réessayez plus tard.
- Un produit n'a pas pu être créé : le message nomme le produit et donne la raison renvoyée par Ecomanager.
Si Ecomanager signale que votre compte est suspendu, par exemple après un abonnement expiré ou des factures impayées, DZBuild déconnecte l'intégration de lui-même. Une fois votre compte Ecomanager réactivé, reconnectez-le et enregistrez les webhooks. Les commandes qui n'ont pas pu partir restent dans Commandes en attente d'envoi, prêtes à être envoyées.
FAQ
Dois-je envoyer chaque commande moi-même ? Non. Avec Synchroniser les nouvelles commandes activé, les commandes de votre boutique et de vos pages de destination partent vers Ecomanager d'elles-mêmes. Utilisez la liste d'attente pour les commandes plus anciennes et pour celles créées autrement.
Une commande peut-elle arriver deux fois dans Ecomanager ? DZBuild enregistre la référence Ecomanager de chaque commande envoyée et l'ignore lors des envois suivants : appuyer de nouveau sur Envoyer tout ne la duplique pas.
J'ai changé le statut d'une commande dans DZBuild. Pourquoi Ecomanager affiche-t-il encore l'ancien état ? DZBuild n'envoie pas les changements de statut à Ecomanager. Changez plutôt l'état dans Ecomanager : avec les webhooks enregistrés, le nouvel état revient dans DZBuild.
Le statut d'une commande a changé dans DZBuild sans que j'y touche. Pourquoi ? La commande a changé d'état dans Ecomanager et un webhook l'a appliqué. Les états Ecomanager remplacent le statut DZBuild, comme dans le tableau ci-dessus.
Où trouver le token API ? Dans votre compte Ecomanager, sur la page Shop Configuration, sous API Token.
Puis-je connecter Ecomanager sur le plan Free ? Non. La carte demande le plan Pro, Unlimited ou Enterprise. Les autres plateformes externes sont listées dans le catalogue des add-ons, et Flash Manager se connecte sur tous les plans.