WooCommerce e il gestionale.
Come farli parlare.

Il problema è sempre lo stesso: hai un gestionale aziendale (Zucchetti, Danea, TeamSystem, o un sistema custom) e un negozio WooCommerce. Ogni ordine online va inserito a mano nel gestionale. Ogni modifica di stock va aggiornata in entrambi i posti. È un lavoro manuale, lento e pieno di errori. Si risolve collegando i due sistemi.

Cosa significa "integrare" WooCommerce con un gestionale

Un'integrazione tra WooCommerce e gestionale è un connettore software che fa tre cose in modo automatico: sincronizza lo stock in tempo reale, importa gli ordini nel gestionale e mantiene allineate le anagrafiche clienti.

Non esiste un plugin universale che funziona con tutti i gestionali. Ogni gestionale ha API diverse — o non ne ha — e ogni azienda ha flussi diversi. Il connettore va costruito su misura.

I tre flussi principali

1. Sincronizzazione stock gestionale → WooCommerce

È il flusso più critico. Se vendi un prodotto in negozio o via telefono, il gestionale scala la giacenza. WooCommerce deve saperlo immediatamente per non vendere prodotti esauriti.

Tecnicamente si implementa con un cron job che interroga il gestionale ogni N minuti e aggiorna le giacenze in WooCommerce via REST API:

PUT /wp-json/wc/v3/products/{id}
{
  "stock_quantity": 5,
  "manage_stock": true
}

Per gestionali con webhook nativi (come alcuni moduli Zucchetti), l'aggiornamento avviene in tempo reale invece che a intervalli.

2. Import ordini WooCommerce → gestionale

Ogni ordine completato su WooCommerce deve entrare nel gestionale come documento di vendita — DDT, fattura o ordine cliente dipende dal flusso aziendale. Il webhook woocommerce_order_status_completed triggera l'importazione:

add_action('woocommerce_order_status_completed',
  function($order_id) {
    $order = wc_get_order($order_id);
    // Chiamata API al gestionale
    send_to_gestionale($order);
  }
);

Il cliente viene creato nel gestionale se non esiste, oppure agganciato a quello esistente per codice fiscale o partita IVA.

3. Sincronizzazione prodotti e prezzi

Se il listino prezzi cambia nel gestionale, WooCommerce deve aggiornarsi. Questo flusso è tipicamente unidirezionale (gestionale → WooCommerce) e schedulato — una volta al giorno o all'ora, dipende dalla frequenza delle variazioni.

Come funziona tecnicamente il connettore

Il connettore è un'applicazione PHP (tipicamente Laravel) che sta in mezzo tra i due sistemi. Espone endpoint per ricevere webhook da WooCommerce, interroga le API del gestionale, e gestisce gli errori di sincronizzazione con retry automatici e log.

La struttura base è:

WooCommerce ←→ Connettore PHP ←→ Gestionale
              ↓
          Database log
          (errori, retry, storico)

Il database di log è fondamentale: permette di diagnosticare problemi, riprodurre errori e garantire che nessun ordine vada perso in caso di downtime temporaneo del gestionale.

Quali gestionali si possono integrare

Dipende dalle API disponibili. I gestionali più comuni in Italia:

Danea Easyfatt — esporta in XML/CSV, non ha API REST native. Il connettore legge i file di export in modo schedulato. Funziona ma con latenza di aggiornamento.

Zucchetti — versioni recenti hanno API REST documentate. Integrazione più pulita e in tempo reale.

TeamSystem — API disponibili nelle versioni enterprise. Il connettore usa OAuth2 per l'autenticazione.

Gestionali custom o su misura — si integra via database diretto (MySQL, MSSQL) o tramite API sviluppate ad hoc. È il caso più comune nelle PMI manifatturiere.

Cosa serve per iniziare

Prima di costruire il connettore servono tre informazioni: che gestionale usi e che versione, come sono strutturati i tuoi prodotti (varianti, codici, unità di misura), e quale flusso ordini vuoi automatizzare per primo.

L'analisi iniziale di solito richiede una o due ore — una chiamata per capire il flusso attuale e verificare le API disponibili. Solo dopo si può stimare il tempo di sviluppo e il costo.