Intégration BigBuy¶
Ce plugin relie votre boutique Shopware 6 à la plateforme BigBuy et permet le dropshipping entièrement automatisé : les produits, catégories, stocks et prix sont importés automatiquement du catalogue BigBuy, les nouvelles commandes sont transmises directement à BigBuy et les informations de suivi sont renvoyées dans Shopware – le tout sans effort manuel.
Points forts
- 🛍️ Importation automatique de produits, catégories et images
- 📦 Synchronisation en temps réel des stocks et des prix
- 🚀 Transfert automatique des commandes à BigBuy (Dropshipping)
- 🔍 Récupération automatique des numéros de suivi et du statut d'expédition
- ⚙️ Quatre tâches planifiées configurables (Cronjobs)
- 💰 Majoration de prix configurable (pourcentage et/ou forfait)
❓ FAQ¶
Qu'est-ce que BigBuy ?
BigBuy est un grossiste et fournisseur de dropshipping européen avec plus de 200 000 produits. Via l'API REST de BigBuy, les produits, prix, stocks et commandes peuvent être synchronisés entièrement automatiquement. Un package BigBuy Ecommerce actif est requis.
Quelles données sont importées de BigBuy ?
Le plugin importe les catégories de produits, les produits (y compris les noms et descriptions multilingues, EAN, poids), les images de produits, ainsi que les stocks et les prix.
Comment fonctionne le transfert des commandes ?
Dès qu'une commande Shopware atteint le statut « En cours de traitement », elle est automatiquement transmise à BigBuy. BigBuy prend ensuite en charge le prélèvement et l'expédition directement au client final. L'identifiant de commande BigBuy est stocké dans les champs personnalisés de la commande Shopware.
Comment les numéros de suivi arrivent-ils dans la boutique ?
Le cronjob de suivi récupère toutes les heures les informations d'expédition actuelles de BigBuy et écrit automatiquement le numéro de suivi dans l'expédition Shopware correspondante.
Puis-je configurer une majoration de prix ?
Oui. Dans la section de configuration du plugin, vous pouvez définir une majoration en pourcentage (par exemple 20 %) et/ou un montant fixe (par exemple 5,00 €). Les deux valeurs sont appliquées au prix d'achat de BigBuy (prix de gros) à chaque mise à jour des prix, pour déterminer le prix de vente dans la boutique.
Le mode sandbox de BigBuy est-il pris en charge ?
Oui, le mode sandbox peut être activé pour tester le transfert des commandes et le suivi des expéditions sans transactions réelles. Veuillez noter : le sandbox BigBuy ne fournit pas de données de catalogue – la synchronisation des produits, catégories, stocks et prix ne peut donc pas être testée contre le sandbox. Une clé API de production avec le mode sandbox désactivé est requise pour cela.
Quel package Shopware est nécessaire ?
Le plugin nécessite Shopware 6.7 – aucun autre plugin n'est requis. Du côté BigBuy, un package Ecommerce actif est nécessaire, qui déverrouille l'accès à l'API.
🔧 Installation¶
- Prérequis : Package BigBuy Ecommerce avec accès à l'API
- Installation via le gestionnaire de plugins Shopware ou par Composer
- Activer le plugin :
bin/console plugin:install --activate CnkPlatformBigBuyIntegration - Enregistrer les tâches planifiées :
bin/console scheduled-task:register - Effectuer la configuration dans la zone d'administration Shopware
⚙️ Configuration¶
Identifiants d'accès API¶
| Paramètre | Description |
|---|---|
| Clé API | Jeton Bearer de votre compte client BigBuy |
| Mode Sandbox | Utiliser le sandbox BigBuy (api.sandbox.bigbuy.eu) à la place de l'environnement de production (api.bigbuy.eu). Pas de transactions réelles |
| Tester la connexion | Bouton qui vérifie les identifiants saisis contre l'API BigBuy et affiche le résultat directement dans l'admin |
Vous trouverez la clé API dans votre compte client BigBuy sous les paramètres API. Utilisez le bouton Tester la connexion pour vérifier les identifiants avant de les enregistrer.
Synchronisation des produits¶
| Paramètre | Description | Standard |
|---|---|---|
| Sync des produits activée | Activer/désactiver l'importation des produits | Activé |
| Langue des produits | Langue des données produits (de, en, fr, es, it …) | de |
| Canal de vente | Liste de sélection du canal de vente où les produits importés seront visibles | – |
| Catégorie par défaut | Liste de sélection de la catégorie d'entrée sous laquelle les catégories BigBuy seront créées | – |
| Importer les images | Télécharger les images produits de BigBuy et définir l'image de couverture | Activé |
| Taille du lot | Nombre de produits par appel API | 100 |
Stock & Prix¶
| Paramètre | Description | Standard |
|---|---|---|
| Sync Stock/Prix activée | Activer/désactiver la synchronisation | Activé |
| Majoration de prix (%) | Majoration en pourcentage sur les prix BigBuy | 0 |
| Majoration de prix fixe (€) | Montant fixe ajouté à chaque prix | 0 |
Transfert des commandes¶
| Paramètre | Description | Standard |
|---|---|---|
| Transfert des commandes activé | Activer/désactiver le transfert à BigBuy. Les commandes transférées sont de vraies commandes d'achat chez BigBuy – testez d'abord en mode sandbox | Désactivé |
| Transfert automatique | Transférer la commande immédiatement au statut « En cours de traitement » | Activé |
| Statut après transfert | Liste de sélection des statuts de commande Shopware ; la commande sera définie sur ce statut après un transfert réussi | – |
| Code du prestataire d'expédition | Nom du transporteur tel qu'utilisé par BigBuy (par ex. gls, seur) ; facultatif | – |
| Mode de paiement BigBuy | Comment les commandes transférées sont payées chez BigBuy : Solde (votre solde BigBuy est débité automatiquement) ou Virement (la commande attend chez BigBuy la réception de votre paiement) | Solde |
Suivi des envois¶
| Paramètre | Description | Standard |
|---|---|---|
| Sync de suivi activée | Activer/désactiver la synchronisation des numéros de suivi | Activé |
🔄 Synchronisations en détail¶
Importation des produits¶
L'importation des produits s'exécute quotidiennement (standard : toutes les 24 heures) en tant que tâche planifiée en arrière-plan :
- Les catégories BigBuy sont mappées dans les catégories Shopware sous la catégorie d'entrée configurée
- Les produits sont importés avec les descriptions, EAN, poids et images (la première image est définie comme image de couverture)
- Les produits reçoivent le taux de taxe standard du magasin et sont automatiquement rendus visibles là-bas – si un canal de vente est configuré
- Les produits déjà importés sont reconnus par l'identifiant produit BigBuy et mis à jour (pas d'importation en doublon) ; les images téléchargées sont réutilisées lors d'une synchronisation ultérieure au lieu d'être rechargées
Stock & Prix¶
Les stocks et les prix sont mis à jour toutes les heures. La majoration de prix configurée est recalculée et appliquée à chaque mise à jour :
La majoration est appliquée au prix d'achat BigBuy (prix de gros). La valeur calculée est enregistrée comme prix TTC ; le prix HT est automatiquement dérivé du taux de taxe standard du magasin.
Transfert des commandes¶
Dès qu'une commande passe au statut « En cours de traitement », ses articles importés depuis BigBuy sont transférés à BigBuy ; les produits propres à la boutique ne sont pas envoyés. Les commandes sans article BigBuy sont marquées et ne sont pas transférées. L'identifiant de commande renvoyé par BigBuy est stocké dans le champ personnalisé bigbuy_order_id de la commande Shopware pour éviter les transferts en double ; si BigBuy répartit la commande sur plusieurs entrepôts, tous les identifiants sont enregistrés. En cas d'échec, la tâche planifiée relance automatiquement le transfert. Après un transfert réussi, la commande passe au statut choisi sous Statut après transfert (les statuts personnalisés sont pris en charge). Le transfert des commandes est désactivé après l'installation et doit être activé délibérément.
Suivi des envois¶
Toutes les heures, toutes les commandes Shopware avec le champ bigbuy_order_id défini sont interrogées auprès de BigBuy. Dès que BigBuy renvoie un numéro de suivi, celui-ci est entré dans l'expédition Shopware correspondante et est disponible pour les e-mails clients et les détails des commandes.
⏱️ Tâches planifiées (Cronjobs)¶
Le plugin enregistre quatre tâches planifiées :
| Nom de la tâche | Tâche | Intervalle standard |
|---|---|---|
cnk_bigbuy.product_sync | Importation de produits & catégories | 24 heures |
cnk_bigbuy.stock_price_sync | Stock & prix | 1 heure |
cnk_bigbuy.order_transfer | Transfert des commandes en attente | 15 minutes |
cnk_bigbuy.tracking_sync | Récupération des numéros de suivi | 1 heure |
Les intervalles sont les valeurs par défaut du plugin. Shopware 6.7 ne propose pas de page de réglage pour cela ; si nécessaire, ils peuvent être modifiés avec un outil comme le plugin gratuit FroshTools. L'exécution nécessite un service Shopware Message Worker actif :
Exécuter manuellement une tâche (CLI)¶
Chaque tâche peut être démarrée directement dans le terminal pour le test ou pour une exécution unique. Les commandes exécutent la même logique que les tâches planifiées et produisent un résumé des résultats :
bin/console cnk:bigbuy:product-sync # Importation de produits & catégories
bin/console cnk:bigbuy:stock-price-sync # Mise à jour des stocks & prix
bin/console cnk:bigbuy:order-transfer # Transfert des commandes en attente
bin/console cnk:bigbuy:tracking-sync # Récupération des numéros de suivi
🛒 Cas d'utilisation typiques¶
Dropshipping pur¶
La boutique vend exclusivement des produits BigBuy. Les produits, stocks et prix sont synchronisés entièrement automatiquement. Les commandes sont immédiatement transmises à BigBuy, qui expédie directement au client final.
Boutique hybride¶
La boutique propose ses propres produits et des produits BigBuy en parallèle. Le plugin ne synchronise que les produits liés à un identifiant produit BigBuy. Vos propres produits restent intouchés.
Tarification avec majoration¶
À l'aide de la majoration de prix configurable, les exploitants de boutique peuvent gérer leur marge de manière ciblée sans avoir à ajuster manuellement les prix.
⭐ Avantages pour les exploitants de boutique¶
- Pas d'efforts manuels de maintenance des produits – le catalogue BigBuy reste automatiquement à jour
- Pas de stockage – BigBuy gère l'expédition directement au client final
- Les données de stock en temps réel réduisent les surventes
- Configuration centralisée de tous les paramètres de synchronisation dans l'admin Shopware
- Traçabilité complète grâce aux identifiants de commande BigBuy dans Shopware
- Les numéros de suivi arrivent automatiquement dans Shopware – moins de demandes clients
🧩 Étendue des fonctionnalités¶
- Importation des catégories et produits BigBuy y compris images et textes multilingues
- Synchronisation en temps réel des stocks et des prix
- Majoration de prix configurable (pourcentage et/ou fixe)
- Transfert automatique des commandes à BigBuy lors du changement de statut
- Cronjob de secours pour les transferts de commandes en attente
- Importation automatique des numéros de suivi dans les expéditions Shopware
- Quatre tâches planifiées configurables de manière indépendante
- Mode sandbox pour des tests sans risque
- Journalisation des erreurs via la journalisation Shopware
📚 Documentation¶
D'autres contenus de documentation et captures d'écran seront fournis avec les prochaines versions du plugin.
Documentation technique de l'API BigBuy : https://api.bigbuy.eu/rest/doc
📬 Support¶
Pour toute question, suggestion d'amélioration ou personnalisation, veuillez nous contacter par e-mail à support@cnk-plugins.de.