Integrazione BigBuy¶

Questo plugin collega il vostro negozio Shopware 6 alla piattaforma BigBuy e consente il dropshipping completamente automatizzato: i prodotti, le categorie, gli inventari e i prezzi vengono importati automaticamente dal catalogo BigBuy, i nuovi ordini vengono inoltrati direttamente a BigBuy e le informazioni di tracciamento vengono restituite a Shopware – tutto senza sforzo manuale.

Punti salienti

🛍️ Importazione automatica di prodotti, categorie e immagini
📦 Sincronizzazione in tempo reale di inventari e prezzi
🚀 Trasferimento automatico degli ordini a BigBuy (Dropshipping)
🔍 Recupero automatico di numeri di tracciamento e stato di spedizione
⚙️ Quattro attività pianificate configurabili (Cronjobs)
💰 Margine di markup configurabile (percentuale e/o importo fisso)

❓ Domande frequenti¶

Cos'è BigBuy?

BigBuy è un grossista e fornitore di dropshipping europeo con oltre 200.000 prodotti. Attraverso l'API REST di BigBuy, i prodotti, i prezzi, gli inventari e gli ordini possono essere sincronizzati completamente in modo automatico. È richiesto un pacchetto BigBuy Ecommerce attivo.

Quali dati vengono importati da BigBuy?

Il plugin importa categorie di prodotti, prodotti (inclusi nomi e descrizioni multilingue, EAN, peso), immagini di prodotti, inventari e prezzi.

Come funziona il trasferimento degli ordini?

Non appena un ordine Shopware raggiunge lo stato « In elaborazione », viene automaticamente trasmesso a BigBuy. BigBuy si occupa quindi della preparazione e della spedizione diretta al cliente finale. L'ID dell'ordine di BigBuy viene archiviato nei campi personalizzati dell'ordine Shopware.

Come i numeri di tracciamento arrivano nel negozio?

Il cronjob di tracciamento recupera ogni ora le informazioni di spedizione attuali da BigBuy e scrive automaticamente il numero di tracciamento nella spedizione Shopware corrispondente.

Posso configurare un margine di markup?

Sì. Nella sezione di configurazione del plugin, è possibile impostare un markup percentuale (ad esempio il 20%) e/o un importo fisso (ad esempio 5,00 €). Entrambi i valori vengono applicati al prezzo di acquisto di BigBuy (prezzo all'ingrosso) ad ogni aggiornamento dei prezzi, per determinare il prezzo di vendita nel negozio.

Viene supportata la modalità sandbox di BigBuy?

Sì, la modalità sandbox può essere attivata per testare il trasferimento degli ordini e il tracciamento delle spedizioni senza transazioni reali. Si noti che il sandbox di BigBuy non fornisce dati di catalogo – pertanto la sincronizzazione di prodotti, categorie, inventari e prezzi non può essere testata rispetto al sandbox. È richiesta una chiave API di produzione con la modalità sandbox disabilitata.

Quale pacchetto Shopware è necessario?

Il plugin richiede il plugin CNK Foundation e Shopware 6.7. Da parte di BigBuy, è necessario un pacchetto Ecommerce attivo che sblocchi l'accesso all'API.

🔧 Installazione¶

Prerequisito: Plugin CNK Foundation (dalla versione 3.0.4)
Prerequisito: Pacchetto BigBuy Ecommerce con accesso API
Installazione tramite il gestore plugin Shopware o via Composer
Attivare il plugin: bin/console plugin:install --activate CnkPlatformBigBuyIntegration
Registrare i compiti pianificati: bin/console scheduled-task:register
Eseguire la configurazione nell'area di amministrazione Shopware

⚙️ Configurazione¶

Credenziali di accesso API¶

Impostazione	Descrizione
Chiave API	Token Bearer dal vostro account cliente BigBuy
Modalità Sandbox	Utilizzare il sandbox di BigBuy (`api.sandbox.bigbuy.eu`) al posto dell'ambiente di produzione (`api.bigbuy.eu`). Nessuna transazione reale
Test della connessione	Pulsante che verifica le credenziali immesse rispetto all'API BigBuy e mostra il risultato direttamente nell'admin

Troverete la chiave API nel vostro account cliente BigBuy nelle impostazioni API. Utilizzate il pulsante Test della connessione per verificare le credenziali prima di salvarle.

Sincronizzazione dei prodotti¶

Impostazione	Descrizione	Standard
Sincronizzazione prodotti abilitata	Abilitare/disabilitare l'importazione dei prodotti	Abilitato
Intervallo di sincronizzazione	Frequenza dell'importazione dei prodotti in secondi	86400 (24 h)
Lingua del prodotto	Lingua dei dati del prodotto (de, en, fr, es, it …)	de
Canale di vendita	Elenco a discesa del canale di vendita dove i prodotti importati saranno visibili	–
Categoria predefinita	Elenco a discesa della categoria di ingresso sotto la quale verranno create le categorie di BigBuy	–
Importa immagini	Scaricare le immagini dei prodotti da BigBuy e impostare l'immagine di copertina	Abilitato
Dimensione del lotto	Numero di prodotti per chiamata API	100

Inventario & Prezzi¶

Impostazione	Descrizione	Standard
Sincronizzazione inventario/prezzo abilitata	Abilitare/disabilitare la sincronizzazione	Abilitato
Intervallo di sincronizzazione	Frequenza di aggiornamento in secondi	3600 (1 h)
Markup del prezzo (%)	Markup percentuale sui prezzi di BigBuy	0
Markup del prezzo fisso (€)	Importo fisso aggiunto a ogni prezzo	0

Trasferimento degli ordini¶

Impostazione	Descrizione	Standard
Trasferimento ordini abilitato	Abilitare/disabilitare il trasferimento a BigBuy	Abilitato
Trasferimento automatico	Trasferire l'ordine immediatamente allo stato « In elaborazione »	Abilitato
Stato dopo il trasferimento	Elenco a discesa degli stati dell'ordine Shopware; l'ordine verrà impostato su questo stato dopo un trasferimento riuscito	In elaborazione
Codice del fornitore di spedizione	Codice vettore di BigBuy (ad es. SEUR_STANDARD, DHL)	–

Tracciamento delle spedizioni¶

Impostazione	Descrizione	Standard
Sincronizzazione tracciamento abilitata	Abilitare/disabilitare la sincronizzazione dei numeri di tracciamento	Abilitato
Intervallo di sincronizzazione	Frequenza delle query di tracciamento in secondi	3600 (1 h)

🔄 Sincronizzazioni in dettaglio¶

Importazione dei prodotti¶

L'importazione dei prodotti viene eseguita quotidianamente (standard: ogni 24 ore) come attività pianificata in background:

Le categorie di BigBuy vengono mappate a categorie Shopware sotto la categoria di ingresso configurata
I prodotti vengono importati con descrizioni, EAN, peso e immagini (la prima immagine viene impostata come immagine di copertina)
I prodotti ricevono l'aliquota fiscale standard del negozio e vengono resi automaticamente visibili lì – se viene configurato un canale di vendita
I prodotti già importati vengono riconosciuti dall'ID prodotto di BigBuy e aggiornati (nessuna importazione duplicata); le immagini scaricate vengono riutilizzate in una successiva sincronizzazione piuttosto che ricaricate

Inventario & Prezzi¶

Gli inventari e i prezzi vengono aggiornati ogni ora. Il markup configurato viene ricalcolato e applicato ad ogni aggiornamento:

Prezzo Shopware (lordo) = Prezzo di acquisto BigBuy × (1 + Markup%) + Markup fisso

Il markup viene applicato al prezzo di acquisto di BigBuy (prezzo all'ingrosso). Il valore calcolato viene salvato come prezzo lordo; il prezzo netto viene automaticamente derivato dall'aliquota fiscale standard del negozio.

Trasferimento degli ordini¶

Gli ordini che contengono esclusivamente prodotti BigBuy vengono automaticamente trasferiti a BigBuy non appena viene impostato lo stato « In elaborazione ». L'ID dell'ordine restituito da BigBuy viene archiviato nel campo personalizzato bigbuy_order_id dell'ordine Shopware per evitare trasferimenti duplicati. Dopo un trasferimento riuscito, l'ordine viene automaticamente impostato allo stato dell'ordine scelto in Stato dopo il trasferimento (sono supportati anche gli stati dell'ordine personalizzati).

Tracciamento delle spedizioni¶

Ogni ora, tutti gli ordini Shopware con il campo bigbuy_order_id impostato vengono interrogati presso BigBuy. Non appena BigBuy restituisce un numero di tracciamento, questo viene inserito nella spedizione Shopware corrispondente e diventa disponibile per le e-mail dei clienti e i dettagli degli ordini.

⏱️ Attività pianificate (Cronjobs)¶

Il plugin registra quattro attività pianificate:

Nome del compito	Compito	Intervallo standard
`cnk_bigbuy.product_sync`	Importazione di prodotti & categorie	24 ore
`cnk_bigbuy.stock_price_sync`	Inventario & prezzi	1 ora
`cnk_bigbuy.order_transfer`	Trasferimento degli ordini in sospeso	15 minuti
`cnk_bigbuy.tracking_sync`	Recupero dei numeri di tracciamento	1 ora

Gli intervalli possono essere regolati nell'area di amministrazione di Shopware in Impostazioni → Sistema → Attività pianificate. L'esecuzione richiede un servizio Shopware Message Worker attivo:

bin/console messenger:consume async

Eseguire un'attività manualmente (CLI)¶

Ogni attività può essere avviata direttamente nel terminale per il test o per un'esecuzione singola. I comandi eseguono la stessa logica delle attività pianificate e producono un riepilogo dei risultati:

bin/console cnk:bigbuy:product-sync        # Importazione di prodotti & categorie
bin/console cnk:bigbuy:stock-price-sync    # Aggiornamento dell'inventario & prezzi
bin/console cnk:bigbuy:order-transfer      # Trasferimento degli ordini in sospeso
bin/console cnk:bigbuy:tracking-sync       # Recupero dei numeri di tracciamento

🛒 Casi d'uso tipici¶

Dropshipping puro¶

Il negozio vende esclusivamente prodotti di BigBuy. I prodotti, gli inventari e i prezzi vengono sincronizzati completamente in modo automatico. Gli ordini vengono immediatamente trasmessi a BigBuy, che spedisce direttamente al cliente finale.

Negozio ibrido¶

Il negozio offre i propri prodotti e i prodotti di BigBuy in parallelo. Il plugin sincronizza solo i prodotti collegati a un ID prodotto di BigBuy. I vostri prodotti rimangono invariati.

Tariffazione con markup¶

Utilizzando il markup configurabile, i gestori di negozi possono gestire il loro margine in modo mirato senza dover regolare manualmente i prezzi.

⭐ Vantaggi per i gestori di negozi¶

Nessuno sforzo manuale di manutenzione dei prodotti – il catalogo di BigBuy rimane automaticamente aggiornato
Nessun stoccaggio – BigBuy gestisce la spedizione diretta al cliente finale
I dati di inventario in tempo reale riducono le vendite eccessive
Configurazione centralizzata di tutti i parametri di sincronizzazione nell'admin di Shopware
Tracciabilità completa attraverso gli ID degli ordini di BigBuy in Shopware
I numeri di tracciamento arrivano automaticamente in Shopware – meno richieste di clienti

🧩 Ambito delle funzionalità¶

Importazione di categorie e prodotti di BigBuy incluse immagini e testi multilingue
Sincronizzazione in tempo reale di inventari e prezzi
Markup configurabile (percentuale e/o importo fisso)
Trasferimento automatico degli ordini a BigBuy al cambio di stato
Cronjob di fallback per i trasferimenti di ordini in sospeso
Importazione automatica dei numeri di tracciamento nelle spedizioni Shopware
Quattro attività pianificate configurabili in modo indipendente
Modalità sandbox per test senza rischi
Registrazione degli errori tramite la registrazione di Shopware

📚 Documentazione¶

Ulteriori contenuti di documentazione e screenshot verranno forniti con le prossime versioni del plugin.

Documentazione tecnica dell'API BigBuy: https://api.bigbuy.eu/rest/doc