Collegare Microsoft Dynamics 365 Business Central a Shopware: guida all’integrazione

Finanza, magazzino e ordini in un unico sistema: come collegare Microsoft Dynamics 365 Business Central a Shopware 6, dalla registrazione dell’app al connettore fino a test in sandbox e go-live, con indicazioni per gli shop in Italia.

Introduzione

Situazione di partenza

Chi gestisce un negozio online si destreggia tra gestione delle giacenze, evasione degli ordini, comunicazione con i clienti, spedizioni, resi e marketing. Shop, corriere, contabilità e helpdesk lavorano spesso in parallelo senza dialogare. Con la crescita del fatturato questo mosaico diventa inefficiente, soggetto a errori e costoso, una situazione che conoscono bene molti merchant in Italia.

La soluzione

Microsoft Dynamics 365 Business Central è un ERP in cloud che riunisce finanza, vendite, magazzino, supply chain e dati dei clienti in un unico sistema. Questa guida accompagna dai prerequisiti all’installazione di un’estensione connettore e alla configurazione, fino al test in sandbox, al go-live e alla gestione operativa. L’obiettivo è un processo ripetibile e tracciabile, applicabile anche a più shop.

A chi si rivolge questa guida

• Gestori di shop che vogliono visibilità ed efficienza senza addentrarsi nello sviluppo.
• Sviluppatori che cercano un percorso chiaro per installazione, configurazione e mappatura dei campi.
• Agenzie che collegano più shop o offrono ai clienti una soluzione standardizzata.

Risultato

Al termine, tra Shopware e Business Central scorre un flusso di dati bidirezionale per ordini, clienti, prodotti e giacenze, sostenuto da un ERP per finanza e operations.

Per le aziende che non hanno dimensioni enterprise conviene valutare prima Xentral: è pensato per l’e-commerce, si collega nativamente a Shopware 6 e si introduce in tempi più rapidi e a costi inferiori. Un confronto tra le opzioni si trova nel nostro articolo sull’integrazione ERP economica per Shopware 6.

Microsoft Dynamics 365 Business Central in sintesi

Business Central fa parte della famiglia Microsoft Dynamics 365. È un ERP in cloud per piccole e medie imprese che riunisce contabilità, vendite, magazzino, progetti e assistenza in un’unica interfaccia. Grazie alla stretta integrazione con Microsoft 365, Power BI, Power Automate e Azure si può estendere in modo flessibile.

Vantaggi per l’e-commerce

• Un’unica base dati: clienti, ordini, fatture e giacenze in un solo posto.
• Meno lavoro manuale: niente import ed export doppi; tracciamento delle spedizioni, ordini ai fornitori e fatturazione procedono in modo automatizzato.
• Giacenze aggiornate: le quantità gestite a magazzino in Business Central compaiono in Shopware.
• Decisioni migliori: report finanziari e operativi in tempo reale, ad esempio su rotazione delle scorte e margine di contribuzione.
• Compliance: log di audit, report IVA e controlli finanziari semplificano il rispetto degli obblighi normativi; per l’Italia esiste una localizzazione di Business Central che copre anche la fatturazione elettronica tramite SDI (da verificare con il proprio partner Microsoft).

Quali altri sistemi ERP e CRM si possono collegare a Shopware lo mostra la nostra panoramica sulle integrazioni ERP e CRM per Shopware.

Prerequisiti

Ambiente Shopware

• Versione: Shopware 6.4 o successiva; verifichi la compatibilità del connettore scelto con la Sua versione.
• PHP: la versione richiesta dalla Sua versione di Shopware, da verificare con php -v da riga di comando.
• Estensioni: accesso amministrativo alla gestione delle estensioni nell’amministrazione.
• Hosting: hosting stabile con CPU e RAM sufficienti per le sincronizzazioni; i worker della message queue e lo scheduler devono essere attivi.

Business Central

• Abbonamento: un’azienda Business Central nel tenant Microsoft 365 della Sua impresa.
• Accesso amministrativo: permessi nel Business Central Admin Center e nel Microsoft Entra Admin Center (in precedenza Azure AD) per gestire app, utenti e accessi API.
• Registrazione dell’app in Microsoft Entra ID: con i permessi necessari per l’API di Business Central, ad esempio Financials.ReadWrite.All (delegato) oppure API.ReadWrite.All (applicazione).
• Ambiente sandbox: un ambiente di test separato dalla produzione.
• Ambiente di produzione: il tenant live per l’operatività reale.

Credenziali

Tenga a portata di mano:

• ID directory (Tenant ID)
• ID applicazione (Client ID) della registrazione app
• Client Secret
• Nome dell’ambiente Business Central e della società (Company)

Regole di sicurezza

• Creare un’app dedicata o un utente tecnico dedicato con permessi minimi.
• Rinnovare i secret regolarmente (ogni 90 o 180 giorni).
• Conservare le credenziali in file .env o in un secret store, mai nel codice.

Installare l'estensione connettore in Shopware

Per il collegamento serve un connettore. Nello Shopware Store sono disponibili estensioni di terze parti (cerchi “Dynamics 365 Business Central”); in alternativa realizziamo l’integrazione su misura tramite l’API di Business Central e la Admin-API di Shopware. Maggiori dettagli nella nostra pagina dedicata allo sviluppo di plugin Shopware.

Passaggi

1. Accedere all’amministrazione di Shopware.
2. Aprire Estensioni → Store.
3. Cercare “Dynamics 365 Business Central” e scegliere l’estensione adatta.
4. Cliccare su Installa e attendere che i pacchetti vengano estratti.
5. Cliccare su Attiva per abilitare le funzioni dell’estensione.

Configurare l'integrazione

Impostare la connessione

Apra la pagina delle impostazioni dell’estensione e inserisca:

• URL API: l’endpoint dell’API di Business Central, di norma https://api.businesscentral.dynamics.com/v2.0/{tenant}/{ambiente}/api/v2.0/
• Tenant ID, Client ID e Client Secret dalla registrazione dell’app
• Ambiente: sandbox o produzione
• Società: la Company in Business Central con cui sincronizzare

Clicchi poi su Testa connessione e salvi le impostazioni.

Definire la sincronizzazione

Per ogni tipo di dato definisca direzione, intervallo e mappatura:

• Prodotti: Business Central → Shopware (anagrafica articoli, prezzi, varianti)
• Giacenze: Business Central → Shopware, possibilmente a intervalli brevi
• Clienti: Shopware → Business Central (creazione e aggiornamento dei clienti)
• Ordini: Shopware → Business Central (ordini di vendita con metodo di pagamento, spese di spedizione e imposte)
• Stati e numeri di tracking: Business Central → Shopware

Presti attenzione alla mappatura di aliquote IVA, metodi di pagamento, metodi di spedizione e valute. Per uno shop in Italia questo significa ad esempio IVA al 22 % e alle aliquote ridotte, pagamenti come PayPal, Satispay, Scalapay, carte o bonifico e corrieri come Poste Italiane, BRT o GLS. È qui che nascono la maggior parte delle discrepanze in contabilità.

Eseguire il test in sandbox

Preparare la sandbox

1. Creare una sandbox nel Business Central Admin Center, idealmente come copia della produzione.
2. Assegnare alla registrazione dell’app gli stessi permessi API previsti per la produzione.
3. Usare credenziali dedicate, così da non mescolare test e produzione.

Testare la sincronizzazione

1. Nell’estensione passare alla modalità Sandbox.
2. Eseguire Sincronizza ora per ogni tipo di dato: clienti → BC, prodotti ← BC, ordini → BC, giacenze ← BC.
3. Dopo ogni esecuzione controllare i dati nella sandbox: prezzi, imposte, indirizzi e quantità sono corretti?

Analizzare i log

Nei log di sincronizzazione dell’estensione le chiamate dovrebbero comparire con stato 200. Errori come 401 (autorizzazione), 404 (ambiente o società errati) o 429 (limite API) vanno risolti prima di procedere.

Go-live in produzione

1. Nell’estensione passare l’ambiente da Sandbox a Produzione.
2. Inserire le credenziali di produzione ed eseguire Testa connessione.
3. Avviare la sincronizzazione iniziale completa e osservare i primi cicli per individuare anomalie.
4. Informare il team sui nuovi processi in Business Central e formarlo.

Prima del passaggio crei un backup del database di Shopware e pianifichi il go-live in una fascia oraria con poco traffico.

Best practice dopo l'avvio

• Controllare i log: esaminare ogni mese i log di sincronizzazione e impostare notifiche in caso di errori.
• Credenziali: rinnovare regolarmente i client secret e assegnare i permessi secondo il principio del privilegio minimo.
• Riconciliazione: verificare ogni mese ordini, clienti e giacenze tra i due sistemi.
• Aggiornamenti: mantenere aggiornati Shopware, connettore e Business Central; Business Central riceve due grandi aggiornamenti l’anno (release wave).
• Piano di emergenza: eseguire un backup prima delle modifiche importanti e testare il ripristino.
• Performance: monitorare code, durata della sincronizzazione e carico del server.

Approfondimenti

• Più magazzini: mappare le ubicazioni (“Locations”) di Business Central sui magazzini di Shopware.
• Entità personalizzate: sincronizzare articoli di assemblaggio, numeri di serie o lotti tramite pagine API dedicate.
• Automazione: usare Power Automate e Power BI per workflow e dashboard avanzati.
• Localizzazione: installare le estensioni regionali di Business Central per imposte e normative; in Italia sono rilevanti soprattutto la fatturazione elettronica tramite SDI e la gestione dell’IVA.
• Più shop: servire più canali di vendita o shop Shopware da un’unica istanza di Business Central.

Se Business Central è troppo complesso per le dimensioni della Sua azienda, legga le nostre guide su weclapp e Pickware, spesso la scelta più adatta per shop piccoli e medi.

Conclusione

Con questo processo collega Shopware e Microsoft Dynamics 365 Business Central in passaggi chiari: prerequisiti e pianificazione, installazione e configurazione, test in sandbox, go-live e gestione operativa. Il risultato è uno shop i cui ordini, clienti, giacenze e dati finanziari sono visibili in tempo reale nell’ERP. Assistiamo merchant in Italia nella scelta, nell’integrazione e nella mappatura dei campi: ci contatti quando vuole; una prima panoramica del Suo shop la offre la nostra analisi dello shop.