Prérequis
Shopware 6.5 ou 6.6, PHP 8.1+, accès serveur/console, compte revendeur validé.
Étape par étape
- 1
Créer une clé API
Dans votre tableau de bord Hemp Wholesale, allez dans « Clés API », créez une nouvelle clé (commence par rk_) et copiez-la. Un compte revendeur validé est requis.
- 2
Installer l'extension
Téléchargez le zip ci-dessus. Dans l'admin : Extensions → Mes extensions → « Téléverser » → installer & activer. (Ou en console : bin/console plugin:refresh && plugin:install --activate HempWholeDropship.)
- 3
Configurer
Paramètres → Extensions → « Hemp Wholesale Europe — Dropshipping » : saisissez la clé API, le mode d'expédition et le nom technique du statut déclencheur (ex. in_progress) → Enregistrer.
- 4
Enregistrer le webhook d'expédition
Une fois en console : bin/console hempwhole:connect https://votre-boutique.example — enregistre le webhook d'expédition signé et stocke le secret.
- 5
Aligner les SKU
Les commandes sont rapprochées de nos produits par SKU, puis par EAN/code-barres. Le plus simple : importez notre flux produits (tableau de bord → API/flux) pour que vos SKU correspondent aux nôtres. Sinon, utilisez le champ « Correspondance SKU », une ligne par article : votre-sku = notre-sku. Les articles non rapprochés ne sont jamais ignorés silencieusement — la commande reçoit une note.
Associer les produits (SKU)
Les commandes sont rapprochées de nos produits par SKU, puis par EAN/code-barres. Le plus simple : importez notre flux produits (tableau de bord → API/flux) pour que vos SKU correspondent aux nôtres. Sinon, utilisez le champ « Correspondance SKU », une ligne par article : votre-sku = notre-sku. Les articles non rapprochés ne sont jamais ignorés silencieusement — la commande reçoit une note.
Tester
Passez une commande test dans votre boutique (avec un produit dont le SKU correspond au nôtre) et faites-la passer au statut déclencheur choisi. Une commande dropship doit apparaître peu après dans votre tableau de bord Hemp Wholesale, et votre commande reçoit une note avec notre numéro. Dès que nous expédions, votre commande passe automatiquement à « expédiée/terminée » avec le numéro de suivi.
Questions fréquentes
Une commande n'a pas été transmise — pourquoi ?
Le plus souvent un SKU non rapproché. Consultez la note de commande : elle liste les articles introuvables. Solution : importez le flux produits ou ajoutez une correspondance SKU.
Le suivi est-il renseigné automatiquement ?
Oui. Dès que nous expédions, nous passons votre commande à expédiée/terminée et renseignons le suivi — à condition d'avoir cliqué une fois sur « Connecter » (enregistre le webhook d'expédition signé).