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 le plugin CNK Foundation et Shopware 6.7. Du côté BigBuy, un package Ecommerce actif est nécessaire, qui déverrouille l'accès à l'API.
🔧 Installation¶
- Prérequis : Plugin CNK Foundation (à partir de la version 3.0.4)
- 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é |
| Intervalle de sync | Fréquence d'importation des produits en secondes | 86400 (24 h) |
| 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é |
| Intervalle de sync | Fréquence de mise à jour en secondes | 3600 (1 h) |
| 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 | Activé |
| 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 | En cours de traitement |
| Code du prestataire d'expédition | Code transporteur BigBuy (par ex. SEUR_STANDARD, DHL) | – |
Suivi des envois¶
| Paramètre | Description | Standard |
|---|---|---|
| Sync de suivi activée | Activer/désactiver la synchronisation des numéros de suivi | Activé |
| Intervalle de sync | Fréquence des requêtes de suivi en secondes | 3600 (1 h) |
🔄 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¶
Les commandes contenant exclusivement des produits BigBuy sont automatiquement transférées à BigBuy dès que le statut « En cours de traitement » est défini. 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 doublon. Après un transfert réussi, la commande est automatiquement définie sur le statut de commande choisi sous Statut après transfert (les statuts de commande personnalisés sont également pris en charge).
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 peuvent être ajustés dans la zone d'administration Shopware sous Paramètres → Système → Tâches planifiées. 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