La sincronizzazione tra il gestionale di farmacia (Wingesfar, CGM, Winfarm, FarmaPro) e l’e-commerce è il cuore di qualsiasi farmacia online seria. Se non parlano fra loro in tempo reale, hai due magazzini, due listini, due fatture. È un disastro.
Ecco come funziona la sincronizzazione di BIzPharma, spiegata in modo che la possa capire chi non scrive codice.
Il problema
Senza integrazione automatica, ogni mattina serve un dipendente che:
- Esporta il listino aggiornato dal gestionale
- Importa il file nel sito
- Verifica gli SKU mancanti
- Aggiorna prezzi cambiati
- Marca i prodotti esauriti
Risultato: 1-2 ore al giorno perse, sbagli di battitura, prezzi disallineati, ordini di prodotti non disponibili.
La soluzione: webhook bidirezionale
BIzPharma non importa il listino ogni notte. Si collega al gestionale e riceve aggiornamenti in tempo reale (webhook):
- Banco vende un prodotto → il sito aggiorna lo stock entro 5 secondi
- Listino cambia prezzo → il sito si aggiorna entro 30 secondi
- Cliente compra online → l’ordine entra direttamente nel gestionale come “scontrino tipo X”
- Spedizione confermata dal corriere → tracking inviato al cliente automaticamente
Cosa succede sotto il cofano
L’architettura è classica: un connettore Node.js che parla con l’API del gestionale (o, dove l’API non c’è, con un agente locale che legge il database del gestionale ogni N secondi).
Il connettore manda eventi a Medusa (il backend e-commerce headless), che aggiorna il database e propaga ai vari canali: sito Next.js, app mobile (se attiva), marketplace.
Tutto il sync è idempotente: se un evento viene perso, il prossimo lo riallinea. Se il gestionale è offline 30 minuti, al ritorno tutto si riconcilia.
Configurazione iniziale: 10 minuti
Sì, davvero 10 minuti. La prima volta:
- Installiamo il connettore sul PC della farmacia (o su VM remota)
- Configuriamo le credenziali API del gestionale
- Lanciamo l’import iniziale del catalogo (5.000 SKU = 4-8 minuti)
- Verifichiamo che 10 prodotti random siano allineati
- Pronto
Da quel momento il sito vive di vita propria, sincronizzato con la realtà del banco.
Cosa fai tu, farmacista
Niente. È esattamente l’idea: il tuo lavoro al banco non cambia. Vendi come hai sempre fatto, gestisci ordini come hai sempre fatto. Il sito è un canale aggiuntivo che si auto-aggiorna.
Se sei curioso di vedere la sincronizzazione in azione, possiamo mostrartela in 15 minuti di demo. Niente slide, ti mostriamo Wingesfar e il sito affiancati e cambiamo un prezzo dal gestionale. Ti chiamiamo entro 24 ore.