Collegare weclapp a Shopware 6: guida all’integrazione ERP

Come collegare weclapp a Shopware 6: requisiti, plugin connettore, configurazione dell’API, sincronizzazione, test, risoluzione dei problemi e go-live.

Introduzione

weclapp è un ERP in cloud per gestione del magazzino, CRM, fatturazione e progetti. Collegato a Shopware 6, sincronizza in automatico articoli, giacenze, clienti e ordini tra negozio ed ERP, senza dati da inserire due volte. Questa guida mostra a merchant, sviluppatori e agenzie in Italia come è strutturata l’integrazione: requisiti, installazione del plugin, configurazione dell’API, test, risoluzione dei problemi e go-live.

Se sta ancora valutando quale ERP sia adatto al Suo negozio, Le sarà utile il nostro articolo sull’integrazione ERP efficiente nei costi per Shopware 6. Le basi della piattaforma sono descritte nella nostra pagina dedicata allo sviluppo Shopware.

Che cos'è weclapp?

weclapp è un sistema ERP in cloud che riunisce in un’unica piattaforma gestione del magazzino, CRM, evasione degli ordini, fatturazione e project management. Per chi vende online è interessante perché copre magazzino, acquisti e contabilità senza dover gestire un proprio server.

Vantaggi per l’e-commerce

• Dati su clienti, giacenze e vendite sono centralizzati in un unico punto.
• Fatture e registrazioni nascono direttamente dall’ordine, riducendo il lavoro amministrativo.
• Ordini e giacenze vengono allineati automaticamente, così la disponibilità nel negozio è sempre corretta.

Perché collegarlo a Shopware 6?

• I dati nel negozio e nell’ERP sono sempre coerenti.
• Attività ripetitive come il trasferimento degli ordini scompaiono.
• Meno inserimenti manuali significano meno errori.

Shopware resta il frontend per i Suoi clienti, weclapp il backend per evasione e finanza. Quali altri sistemi si possono collegare lo mostra la nostra panoramica sulle integrazioni ERP e CRM per Shopware.

Requisiti

Requisiti tecnici

• Shopware 6.4 o superiore, in funzionamento stabile
• PHP 8.1 o superiore
• Web server con HTTPS e memoria sufficiente per PHP (consigliati almeno 512 MB), affinché le sincronizzazioni non si interrompano
• MySQL 8.0 o superiore oppure MariaDB

Account weclapp

• Account weclapp Cloud attivo con diritti di amministratore
• Accesso ai dati API: nome del tenant, token API e URL dell’endpoint

Altro

• Accesso all’amministrazione di Shopware con i permessi per installare e configurare estensioni
• Conoscenze di base sull’installazione dei plugin Shopware

Verifichi ogni requisito prima di iniziare: farà risparmiare tempo durante la configurazione.

Installare il plugin connettore

Per il collegamento serve un plugin connettore. Le strade possibili sono due:

• Un plugin commerciale dallo Shopware Store (cerchi «weclapp») che copre i casi standard.
• Un plugin dedicato basato sull’API di weclapp, se ha bisogno di processi o mappature dei campi particolari. Come realizziamo soluzioni di questo tipo lo spieghiamo nella pagina sullo sviluppo di plugin Shopware.

Installazione dallo Store

1. Acceda all’amministrazione di Shopware.
2. Apra Estensioni → Store e cerchi «weclapp».
3. Scelga il plugin adatto e clicchi su Installa.
4. Attivi il plugin in Estensioni → Le mie estensioni.
5. Da lì apra la configurazione del connettore.

Verifichi la compatibilità con la Sua versione di Shopware. Con un plugin dedicato segua le istruzioni di installazione dello sviluppatore, di norma tramite bin/console plugin:install --activate.

Configurare il plugin

Accesso API

• Tenant: la sigla aziendale weclapp, reperibile nelle impostazioni dell’account.
• Token API: si genera nel profilo utente di weclapp. È consigliabile creare un utente tecnico dedicato con i permessi necessari.
• Endpoint: di solito https://{mandant}.weclapp.com/webapp/api/v1/.

Sincronizzazione

• Prodotti: trasferire le anagrafiche articolo da weclapp a Shopware, prezzi e varianti inclusi.
• Ordini: creare automaticamente gli ordini Shopware come ordini cliente in weclapp.
• Clienti: associare e allineare account e indirizzi dei clienti.
• Giacenze: scrivere nel negozio le giacenze di magazzino presenti in weclapp.

Altre impostazioni

• Mappatura fiscale tra le aliquote di Shopware e i codici IVA di weclapp (per l’Italia, ad esempio, l’aliquota ordinaria del 22 %)
• Valute e lingue in linea con i Suoi canali di vendita
• Logging e intervallo di sincronizzazione

Salvi la configurazione e controlli ogni mappatura prima di avviare il primo allineamento. Per chi vende in Italia è importante chiarire fin da subito anche il flusso della fatturazione elettronica: verifichi se le fatture generate vengono trasmesse al Sistema di Interscambio (SDI) direttamente dall’ERP o tramite un intermediario.

Testare l'integrazione

Allineamento prodotti

1. Crei in weclapp un articolo di prova con codice articolo, prezzo e descrizione.
2. Verifichi che compaia nel catalogo Shopware con i dati corretti.

Allineamento ordini

1. Effettui un ordine di prova nel negozio.
2. Controlli in weclapp, in Vendite → Ordini, che l’ordine sia arrivato con tutte le righe.

Controllare i log

• Esamini i log del plugin alla ricerca di messaggi di errore o conferme.
• Usi gli strumenti per sviluppatori del browser e i log di Shopware per individuare le chiamate non riuscite.

Documenti le eventuali discrepanze e le risolva prima di andare live.

Risoluzione dei problemi

Problemi tipici

• Token API non valido: copiare il token per intero e verificare che l’utente abbia in weclapp i permessi necessari.
• Timeout: controllare firewall e URL dell’endpoint.
• Gli ordini non vengono trasferiti: verificare che il trasferimento automatico sia attivo e che lo scheduler di Shopware (bin/console scheduled-task:run) o il cronjob siano in esecuzione.
• Giacenze non allineate: controllare nel plugin l’intervallo di sincronizzazione e le regole di sovrascrittura.

Log e diagnosi

• Shopware: Impostazioni → Sistema → Log
• Attivare il logging dettagliato durante la configurazione
• Analizzare in weclapp le risposte API e i protocolli

Conflitti tra plugin

• Disattivare temporaneamente i plugin non necessari per circoscrivere i conflitti.
• Verificare la compatibilità della versione del plugin con la versione di Shopware.

Go-live

1. Nelle impostazioni del plugin passi l’ambiente da «Test» a «Live».
2. Controlli un’ultima volta credenziali API e mappatura fiscale.
3. Esegua un allineamento completo di prodotti, clienti e giacenze.
4. Informi collaboratori e assistenza del passaggio e, se necessario, li formi.

Prima dell’avvio

• Esegua un backup del database Shopware ed esporti i dati di weclapp.
• In modalità live effettui un ordine di prova e controlli fattura, giacenza e dati del cliente.
• Verifichi la mappatura di tutti i campi, come codice articolo, prezzi e giacenze.

Best practice e sicurezza

Sicurezza

• Conservare i token API in variabili d’ambiente o in un secret store, non nel codice.
• Rinnovare regolarmente i token e revocare quelli non più utilizzati.
• Limitare i permessi dell’utente tecnico ai soli moduli necessari.

Performance

• Pianificare gli allineamenti più pesanti nelle fasce orarie a basso traffico.
• Con cataloghi ampi, raggruppare i trasferimenti.
• Impostare notifiche di errore e report di sincronizzazione.

Manutenzione

• Installare tempestivamente gli aggiornamenti del plugin.
• Controllare i log ogni settimana.
• Ripetere il test dell’allineamento dopo aggiornamenti importanti di Shopware o weclapp.

Domande frequenti

Che cosa succede se un ordine non viene trasferito?
Il plugin registra l’errore. Può correggere i dati e avviare di nuovo manualmente il trasferimento.

Posso sincronizzare solo determinati prodotti?
Sì, la maggior parte dei connettori consente filtri per categoria o tag.

Vengono trasferiti gli stati di pagamento e spedizione?
Gli stati possono essere mappati tra i due sistemi; quanto viene coperto dipende dal plugin.

Come gestire più canali di vendita?
Assegni in weclapp a ogni canale di vendita un identificativo univoco e una propria configurazione di sincronizzazione.

weclapp aggiorna automaticamente le giacenze in Shopware?
Sì, se l’allineamento delle giacenze è attivo. L’intervallo si imposta nelle impostazioni del plugin.

Se preferisce una gestione del magazzino direttamente in Shopware, legga la nostra guida a Pickware in Shopware 6. Per collegare weclapp o un altro ERP ci contatti: affianchiamo anche merchant in Italia nelle integrazioni Shopware. Una prima panoramica rapida la offre la nostra analisi del negozio.