Magento 2 e registratore telematico: guida all’integrazione con WindDoc Cassa
Il plugin WindDoc per Magento 2 permette di collegare il proprio ecommerce a WindDoc Cassa, automatizzando la gestione delle vendite effettuate online.
Grazie all’integrazione è possibile trasferire automaticamente gli ordini di Magento 2 a WindDoc Cassa e utilizzare la cassa virtuale per gestire le vendite e l’emissione dei relativi documenti commerciali.
Il plugin consente inoltre di gestire, in base alla configurazione scelta, ordini, fatture, ricevute, clienti e magazzino, mantenendo sincronizzati i dati tra il negozio online e WindDoc.
Il principale vantaggio dell’integrazione con WindDoc Cassa è la possibilità di collegare Magento 2 al registratore telematico, evitando di dover reinserire manualmente nella cassa le vendite già effettuate sul negozio online.
Installazione del plugin
Il modulo può essere scaricato dalla pagina ufficiale del plugin WindDoc.
Dopo aver installato il plugin all’interno di Magento 2, sarà disponibile una nuova sezione dedicata alla configurazione nel percorso:
Stores → Configuration → WindDoc
Da questa area sarà possibile collegare Magento 2 al proprio account WindDoc e configurare tutte le funzionalità di integrazione, compresa la gestione delle vendite tramite WindDoc Cassa.
Collegamento account WindDoc
Per iniziare è necessario collegare il proprio account WindDoc a Magento 2.
Premendo il pulsante Collega WindDoc verrà aperta una finestra di autenticazione nella quale inserire le credenziali del proprio account.
Dopo aver effettuato l’accesso sarà possibile selezionare il profilo WindDoc da associare al negozio online.
Al termine della procedura verrà visualizzato il messaggio WindDoc collegato, che conferma l’avvenuta connessione tra Magento 2 e il gestionale.
Una volta completata la configurazione iniziale è importante salvare le impostazioni tramite il pulsante Save Config.
Sezione Rubrica
La sezione Rubrica consente di sincronizzare automaticamente le anagrafiche dei clienti di Magento 2 all’interno di WindDoc.
Attivando l’opzione Salva cliente, il sistema creerà automaticamente il cliente nel gestionale durante la sincronizzazione del primo documento associato all’ordine, come una fattura o una ricevuta.
Questa funzionalità permette di mantenere uno storico completo delle anagrafiche direttamente in WindDoc, facilitando la consultazione dei documenti emessi, dei movimenti e dello storico acquisti.
Nel caso in cui venga gestita la vendita esclusivamente tramite documento commerciale, l’anagrafica del cliente non verrà sincronizzata automaticamente.
Sezione Ordini
La sezione Ordini permette di creare automaticamente in WindDoc il documento ordine relativo agli acquisti effettuati sul sito Magento 2.
Quando l’opzione Sincronizza ordini è attiva, ogni nuovo ordine effettuato sull’ecommerce può essere trasferito al gestionale.
La sincronizzazione può essere eseguita manualmente oppure automaticamente subito dopo la conferma dell’ordine da parte del cliente.
Abilita magazzino
Attraverso l’opzione Abilita magazzino è possibile aggiornare automaticamente le quantità disponibili in WindDoc durante la sincronizzazione degli ordini.
Quando il magazzino viene movimentato da un ordine, i prodotti saranno contrassegnati come Impegnati.
Modello stampa ordine
Il parametro Modello stampa ordine consente di selezionare il template grafico utilizzato per la stampa del documento.
Numerazione ordini
La voce Numerazione ordini permette di definire una serie numerica dedicata agli ordini provenienti dall’ecommerce.
Sezione Scontrini
La sezione Scontrini rappresenta il punto centrale dell’integrazione tra Magento 2 e WindDoc Cassa.
Attraverso questa funzione è possibile collegare il negozio online alla cassa virtuale e automatizzare la gestione delle vendite effettuate sul sito.
Quando un ordine raggiunge le condizioni configurate per la sincronizzazione, il plugin trasferisce i dati della vendita a WindDoc Cassa, che provvede alla gestione del relativo documento commerciale.
Il flusso operativo può quindi essere automatizzato:
Ordine Magento 2 → pagamento → sincronizzazione → WindDoc Cassa → emissione del documento commerciale
In questo modo le vendite effettuate sul negozio online possono essere gestite direttamente tramite il registratore telematico, senza dover reinserire manualmente ogni vendita nella cassa.
Sincronizzazione automatica
La generazione dello scontrino può avvenire automaticamente quando l’ordine Magento 2 viene considerato pagato oppure manualmente da parte dell’operatore.
Attraverso il parametro relativo alla sincronizzazione automatica degli scontrini è possibile scegliere la modalità più adatta al proprio flusso di lavoro.
Lo stato dell’ordine considerato come “pagato” viene determinato sulla base della configurazione effettuata nella sezione Modalità di Pagamento.
Cassa
Il parametro Cassa permette di selezionare la cassa configurata in WindDoc Cassa da utilizzare per la gestione della vendita.
La cassa selezionata determina le configurazioni fiscali e le modalità di pagamento disponibili per l’emissione del documento commerciale.
Prima di configurare questa sezione è quindi necessario avere correttamente configurato la cassa all’interno di WindDoc Cassa.
Invio tramite email
È possibile attivare l’invio automatico del documento al cliente tramite email.
In questo modo, dopo la generazione del documento, il cliente potrà ricevere automaticamente il relativo documento all’indirizzo email associato all’ordine Magento 2.
Gestione magazzino
La gestione del magazzino può essere attivata anche per gli scontrini.
In questo caso, le quantità dei prodotti venduti verranno automaticamente scaricate dal magazzino durante la gestione della vendita.
Associazione metodi di pagamento
Per gestire correttamente le vendite è necessario associare ogni metodo di pagamento configurato in Magento 2 alla relativa modalità di pagamento disponibile nella cassa.
Ad esempio, un pagamento effettuato tramite carta dovrà essere associato alla corrispondente modalità Carta configurata in WindDoc Cassa.
Questa configurazione permette di registrare correttamente nella cassa non solo l’importo della vendita, ma anche la relativa modalità di pagamento.
Fatture
La sezione Fatture consente di generare automaticamente fatture elettroniche in WindDoc per gli ordini provenienti da Magento 2.
Le fatture create risultano predisposte per la gestione della fatturazione elettronica italiana.
Per i clienti privati il sistema imposterà automaticamente il codice destinatario 0000000, mentre per i clienti esteri verrà utilizzato il valore XXXXXXX.
La generazione della fattura non comporta automaticamente l’invio all’Agenzia delle Entrate: il documento viene preparato in WindDoc e potrà essere verificato prima della trasmissione definitiva.
Attivando la funzione Sincronizza fatture, il plugin potrà creare automaticamente il documento fiscale in base alle regole configurate.
La generazione automatica può avvenire quando l’ordine Magento viene considerato pagato. Lo stato dell’ordine utilizzato per identificare un pagamento valido può essere configurato nella sezione dedicata alle modalità di pagamento.
Gestione magazzino
La gestione del magazzino può essere abilitata anche durante la creazione delle fatture, permettendo l’aggiornamento automatico delle giacenze.
Modello stampa fatture
Attraverso il parametro Modello stampa fatture è possibile scegliere il layout grafico del documento.
Per creare modelli personalizzati è possibile fare riferimento alla guida dedicata.
Numerazione fatture
Il parametro Numerazione fatture permette di utilizzare una numerazione dedicata alle fatture generate dal negozio online.
Invio tramite email
Abilitando l’opzione Invia Email, la fattura verrà inviata automaticamente al cliente dopo la generazione in WindDoc.
Il contenuto dell’email può essere personalizzato nella sezione:
Impostazioni → Email → Template Email → Template Predefinito invio documenti
Sezione Ricevute
La sezione Ricevute permette di generare automaticamente ricevute per gli ordini effettuati su Magento 2.
Quando risultano attive contemporaneamente la gestione Fatture e la gestione Ricevute, il sistema determina automaticamente quale documento emettere in base ai dati fiscali inseriti dal cliente durante il checkout.
Se il cliente ha compilato il campo Partita IVA, verrà emessa una fattura; in caso contrario il sistema genererà una ricevuta.
Per le vendite che devono essere gestite tramite il registratore telematico, è invece necessario utilizzare la sezione Scontrini e configurare la relativa cassa in WindDoc Cassa.
Le impostazioni relative alla gestione del magazzino e all’invio automatico delle email vengono ereditate direttamente dalla configurazione presente nella sezione Fatture.
Il plugin consente inoltre di definire un modello di stampa dedicato e una numerazione separata per le ricevute provenienti dall’ecommerce.
Campi cliente
Magento 2 non include nativamente tutti i campi necessari per la gestione completa della fatturazione elettronica italiana.
Per questo motivo è possibile utilizzare estensioni aggiuntive che consentano di aggiungere campi personalizzati al checkout, come:
- Codice Fiscale;
- Partita IVA;
- Codice Destinatario;
- email PEC.
All’interno della sezione Campi cliente del plugin sarà possibile associare ciascun campo personalizzato di Magento 2 al corrispondente campo gestito da WindDoc.
Per le vendite gestite tramite WindDoc Cassa, invece, non è necessario richiedere al cliente tutti i dati fiscali necessari per l’emissione della fattura elettronica.
Modalità di Pagamento
La sezione Modalità di Pagamento permette di configurare il comportamento dei pagamenti durante la sincronizzazione dei documenti.
Per ogni metodo di pagamento configurato in Magento 2 è necessario associare il relativo conto contabile presente in WindDoc.
Per la gestione delle vendite tramite WindDoc Cassa, è inoltre necessario associare ogni metodo di pagamento di Magento 2 alla corrispondente modalità di pagamento configurata nella cassa.
In questa stessa sezione è possibile definire quali stati dell’ordine devono essere considerati validi per identificare un ordine come pagato e avviare automaticamente la sincronizzazione di fatture, ricevute o scontrini.
Il pulsante Predefiniti consente di applicare automaticamente la configurazione standard degli stati ordine comunemente utilizzati da Magento 2.
Una corretta configurazione di questa sezione è fondamentale per fare in modo che lo scontrino venga generato nel momento corretto.
Aliquote IVA
La sezione Aliquote IVA consente di associare le aliquote fiscali utilizzate in Magento 2 con quelle presenti in WindDoc.
Le aliquote standard, come 22% o 10%, vengono normalmente riconosciute automaticamente dal sistema quando la stessa aliquota è presente anche in WindDoc.
Nel caso di prodotti esenti IVA o soggetti a regimi fiscali particolari sarà invece necessario configurare manualmente il comportamento del plugin.
Nel campo Articolo per IVA zero (esente) è possibile indicare l’articolo IVA configurato in WindDoc da utilizzare per i prodotti che non prevedono un’aliquota IVA standard.
Una corretta configurazione delle aliquote è necessaria per garantire la corretta gestione fiscale delle vendite e dei documenti generati.
Magazzino
La gestione Magazzino consente di sincronizzare automaticamente le quantità dei prodotti tra Magento 2 e WindDoc durante la creazione dei documenti di vendita.
Per garantire il corretto funzionamento dello scarico automatico è necessario che lo SKU del prodotto presente in Magento 2 corrisponda esattamente al codice articolo configurato in WindDoc.
È inoltre necessario che il prodotto abbia la gestione del magazzino attiva anche all’interno del gestionale.
Durante la sincronizzazione il sistema utilizzerà automaticamente la prima locazione e il primo lotto disponibile configurati in WindDoc.
Per l’utilizzo del magazzino in WindDoc fare riferimento alla guida dedicata.
Area Cliente
Nell’area riservata del cliente di Magento 2 viene aggiunto automaticamente un pulsante dedicato al download dei documenti generati tramite WindDoc.
Il cliente potrà quindi scaricare direttamente dalla cronologia ordini oppure dal dettaglio dell’ordine la fattura, la ricevuta o il documento associato all’acquisto effettuato sul sito.
In questo modo il cliente può consultare autonomamente la documentazione relativa ai propri acquisti direttamente dalla propria area riservata.
Magento 2 e WindDoc Cassa: automatizzare le vendite online
L’integrazione tra Magento 2 e WindDoc Cassa permette di collegare il proprio ecommerce al registratore telematico, automatizzando la gestione delle vendite effettuate online.
Il funzionamento può essere sintetizzato nel seguente flusso:
Cliente → ordine Magento 2 → pagamento → sincronizzazione → WindDoc Cassa → documento commerciale
Magento 2 continua a occuparsi della gestione del negozio online, mentre WindDoc Cassa permette di gestire la parte relativa alla cassa e alle vendite, riducendo le operazioni manuali.
In questo modo non è necessario reinserire manualmente nella cassa ogni vendita effettuata sul sito: l’ordine viene trasferito automaticamente a WindDoc Cassa secondo le regole configurate nel plugin.
L’integrazione mantiene inoltre disponibili le funzionalità di WindDoc per la gestione di fatture, ordini, clienti e magazzino, permettendo di centralizzare la gestione amministrativa e operativa dell’ecommerce.

