Automatizzare Dolibarr: ordini via e-mail, fatturazione e solleciti di pagamento
Scritto da Adam Petras, Fondatore e CEO, TreeLab OÜ · Pubblicato il · Aggiornato il
Dall’e-mail del cliente alla fattura pagata, in Dolibarr 23 e successivi
Dolibarr offre alle piccole e medie imprese un ERP e un CRM completi, ma aspetta ancora che qualcuno digiti ogni ordine, convalidi ogni spedizione, crei ogni fattura e solleciti ogni cattivo pagatore. Questa guida spiega come tre bot di BOTS4.me si occupano di questi passaggi: Mail2ERP trasforma le e-mail dei clienti in proposte commerciali e ordini cliente, AutoERP convalida, spedisce e fattura gli ordini che contrassegna, e AutoCASH sollecita i clienti per le fatture scadute.
I bot si collegano tramite l’API REST di Dolibarr con la chiave API di un utente Dolibarr, su Dolibarr 23 e successivi, in hosting proprio o su DoliCloud. Ogni bot parte in Modalità demo, e il primo mese è un mese Discovery gratuito.
🎯 I passaggi dall’ordine all’incasso che Dolibarr lascia a lei
Dolibarr ha tutti i documenti di cui ha bisogno un’azienda commerciale: proposte commerciali, ordini cliente, spedizioni, fatture e pagamenti. Ciò che non ha è qualcuno che porti ogni ordine da un documento al successivo. Nella maggior parte delle aziende con Dolibarr è ancora una persona, e gli stessi pochi passaggi si ripetono per ogni ordine:
- Inserimento dell’ordine: un cliente invia via e-mail un ordine PDF o Excel, e qualcuno digita prodotti e quantità in una proposta o in un ordine.
- Convalida e spedizione: qualcuno convalida l’ordine, controlla le giacenze, crea la spedizione e la convalida.
- Fatturazione: qualcuno crea la fattura dall’ordine, si assicura che vengano fatturate solo le merci spedite e la invia al cliente.
- Solleciti: a fine mese, qualcuno passa in rassegna le fatture non pagate e scrive i solleciti, oppure non ci arriva.
Ogni passaggio, preso da solo, è rapido. Insieme, e ripetuti per ogni ordine, richiedono ore alla settimana, e il passaggio che viene dimenticato è di solito quello costoso: una fattura mai inviata, o un sollecito che parte con un mese di ritardo.
🤖 Quali bot di BOTS4.me funzionano con Dolibarr
Tutte le app ERP di BOTS4.me funzionano su Dolibarr 23 e successivi. Questa pagina tratta le tre che insieme gestiscono il lato vendite dall’e-mail al pagamento.
| Bot | Parte da | Risultato in Dolibarr |
|---|---|---|
| Mail2ERP | Un’e-mail del cliente con un ordine o una richiesta di offerta | Una proposta commerciale in bozza, o un ordine cliente convalidato |
| AutoERP | Un ordine cliente che ha contrassegnato nel campo BOTS4.me tags | Ordine convalidato, fattura d’acconto quando la condizione di pagamento richiede il pagamento anticipato, spedizione convalidata, fattura convalidata |
| AutoCASH | Le sue fatture cliente non pagate | E-mail di sollecito ai clienti in ritardo, un’anteprima il giorno prima e un report dopo |
Supplier2ERP, Pay2ERP, Bill2ERP, AutoSTOCK e AutoPURCHASE funzionano anch’essi su Dolibarr, e Pay2ERP può usare come input le righe bancarie di Dolibarr. Un’unica connessione Dolibarr serve ogni bot che avvia.
📧 Mail2ERP: dagli ordini via e-mail a proposte e ordini cliente
Arriva l’e-mail del cliente
Mail2ERP legge e abbina
Proposta o ordine in Dolibarr
Lo contrassegni per AutoERP
Mail2ERP legge la sua casella vendite, decide se ogni e-mail è una richiesta di offerta, un ordine fermo o nessuno dei due, e legge le righe di prodotto dal testo dell’e-mail e da ogni allegato: PDF, Excel, Word, CSV, HTML, immagini e documenti scansionati, in qualsiasi layout e lingua, senza modelli. Ogni codice prodotto viene abbinato ai riferimenti prodotto del suo catalogo Dolibarr.
- Richiesta → proposta commerciale in bozza, pronta perché il suo team vendite la prezzi, la adatti e la invii.
- Ordine fermo → ordine cliente, creato in bozza e poi convalidato.
- Contatti: la persona che ha scritto l’e-mail diventa il contatto cliente del documento, e un indirizzo di consegna indicato nell’e-mail diventa il contatto di spedizione.
- File: gli allegati del cliente vengono allegati alla proposta o all’ordine.
- Nessun duplicato: ogni documento viene contrassegnato con la sua e-mail di origine nel campo di riferimento esterno di Dolibarr, così lo stesso ordine inviato due volte viene creato una sola volta.
Mail2ERP non crea mai soggetti terzi né prodotti. Il mittente deve appartenere a un cliente esistente e ogni riga deve corrispondere a un prodotto esistente. Un’e-mail che non può essere importata resta non letta nella sua INBOX, e il registro le dice perché.
🐙 AutoERP: convalidare, spedire e fatturare gli ordini contrassegnati
AutoERP si occupa dei passaggi di routine dopo l’ordine. Lavora solo sugli ordini che lei gli affida, e la consegna avviene tramite un campo, non per supposizione.
Come affidare un ordine ad AutoERP
Dolibarr non consente ad altri programmi di leggere i tag di un ordine cliente, quindi AutoERP usa un campo dell’ordine chiamato BOTS4.me tags (codice b4mtags). Quando l’utente di integrazione è amministratore, AutoERP aggiunge il campo da solo. Altrimenti lo aggiunga una volta: Setup → Modules → Sales Orders → Complementary attributes → New attribute, etichetta BOTS4.me tags, codice b4mtags, tipo String (1 line), lunghezza 255, sempre modificabile. Poi digiti AutoERP nel campo per elaborare l’intero ordine, oppure AutoERP_partial per elaborarlo riga per riga. AutoERP aggiunge i propri tag di avanzamento nello stesso campo.
Cosa succede a ogni esecuzione
- Conferma: un ordine in bozza contrassegnato viene convalidato. Quando la condizione di pagamento dell’ordine richiede il pagamento anticipato, per esempio “Due on order” o una condizione con acconto del 100 %, AutoERP emette anche una fattura d’acconto convalidata per l’intero ordine, collegata a esso.
- Spedizione: non appena la merce è disponibile e la data di consegna è arrivata, AutoERP crea dall’ordine una spedizione convalidata con le quantità che possono partire. Dolibarr movimenta il magazzino alla convalida quando la configurazione del suo modulo Magazzino lo prevede. In caso di spedizioni parziali, il resto rimane sull’ordine.
- Fatturazione: AutoERP crea dall’ordine una fattura convalidata, fatturando i prodotti a magazzino per le quantità effettivamente spedite e i servizi per le quantità ordinate, e detrae gli acconti pagati. Può anche scegliere una fattura cumulativa per cliente al giorno, alla settimana o al mese.
✉️ Chi invia le e-mail ai suoi clienti
Dolibarr non può inviare documenti via e-mail tramite la sua API, quindi AutoERP invia da sé le e-mail di conferma d’ordine, documento di trasporto e fattura: dalla casella che ha collegato per AutoERP, oppure dalla nostra casella di sistema con il suo indirizzo come Reply-To. Ogni e-mail è scritta nella lingua del cliente e contiene il PDF del documento generato da Dolibarr.
⚠️ Un’impostazione da controllare
Le fatture vengono create solo entro la fascia di fatturazione che imposta, e quella fascia deve rientrare nel suo orario di funzionamento. Se le due non si sovrappongono mai, non viene creata alcuna fattura. Controlli entrambe nella scheda Controlli all’avvio.
Con il piano Business, AutoERP può anche trattenere le spedizioni per i clienti con fatture scadute, sollecitandoli una volta, e spedire gli ordini in più parti. Veda la guida di AutoERP per ogni opzione.
💰 AutoCASH: solleciti di pagamento per le fatture Dolibarr scadute
Nei giorni del mese che sceglie, AutoCASH legge le sue fatture cliente non pagate da Dolibarr, le raggruppa per cliente e stabilisce quanto è in ritardo ciascun cliente. Per impostazione predefinita l’escalation è graduale:
| Livello | Significato | Soglia predefinita |
|---|---|---|
| 0 | Un elenco cordiale delle fatture aperte | Non ancora al livello 1 |
| 1 | Primo sollecito | 30 giorni di ritardo |
| 2 | Secondo sollecito | 45 giorni di ritardo |
| 3 | Sollecito finale | 60 giorni di ritardo |
- Iniziare con delicatezza: può attivare solo il livello 1, abituarsi e abilitare i livelli 2 e 3 in seguito.
- Mai due volte per la stessa cosa: lo stesso livello si ripete solo dopo un periodo di attesa, e un’esecuzione che si interrompe a metà non può inviare un sollecito due volte.
- Filtri: un importo minimo, un numero minimo di giorni di ritardo e un elenco di clienti che non vuole mai sollecitare automaticamente.
- Due e-mail per lei: un’anteprima il giorno prima, con l’elenco di chi verrà sollecitato, e un report dopo, con chi è stato contattato, a quale livello e per quali fatture.
- Inviati da BOTS4.me: poiché Dolibarr non può inviare e-mail tramite la sua API, i solleciti vengono inviati da BOTS4.me, nella lingua del cliente. Le fatture d’acconto emesse da AutoERP per gli ordini prepagati non vengono sollecitate da AutoCASH.
⚙️ Configurazione passo per passo per Dolibarr
- Passo 1 — Inizi il suo mese Discovery gratuito: acceda a bots4.me/bots e faccia clic su Inizia il mese Discovery gratuito nella scheda del bot desiderato. Non serve alcuna carta.
- Passo 2 — Abiliti l’API REST in Dolibarr: Home → Setup → Modules/Applications → abiliti API REST (server).
- Passo 3 — Crei un utente di integrazione: in Users & Groups crei un utente come “BOTS4.me Integration” e gli dia i permessi dei bot che usa: Mail2ERP — soggetti terzi, prodotti, proposte commerciali, ordini cliente; AutoERP — ordini cliente, spedizioni, fatture cliente, magazzino; AutoCASH — fatture cliente, pagamenti, banche. Ogni bot ha inoltre bisogno dell’accesso in lettura a Banche e alla propria scheda utente.
- Passo 4 — Generi la chiave API: apra la scheda utente → Modify → campo API key → genera → Save, e copi la chiave.
- Passo 5 — Colleghi Dolibarr su bots4.me: inserisca l’URL del suo sito Dolibarr e la chiave API, più il numero di entità se usa il modulo Multicompany. La procedura completa è in Come collegarsi.
- Passo 6 — Solo AutoERP: aggiunga il campo dell’ordine BOTS4.me tags come descritto sopra, a meno che l’utente di integrazione non sia amministratore.
- Passo 7 — Colleghi la sua casella di posta per Mail2ERP (Gmail e Microsoft 365 con Secure Quick Connect, gli altri via IMAP con una password per le app), oppure inoltri invece gli ordini alla casella BOTS4.me.
🧪 Modalità demo, e-mail poco chiare ed errori
Ogni bot parte in Modalità demo. Mail2ERP le invia via e-mail la proposta o l’ordine che avrebbe creato, AutoERP riferisce quali ordini avrebbe convalidato, spedito e fatturato, e AutoCASH le invia l’elenco completo dei clienti che avrebbe sollecitato, senza contattarne nessuno. Nulla viene scritto in Dolibarr finché non imposta Modalità su LIVE, che si sblocca dopo il primo report Demo. La pagina Modalità demo spiega l’idea, e la demo dal vivo della dashboard mostra ogni impostazione con dati di esempio.
- Le e-mail che Mail2ERP non è riuscito a importare restano non lette nella sua INBOX. Quelle importate vengono spostate in _Mail2ERP/ELABORATO.
- Il motivo viene sempre registrato nella scheda Registri e nella cartella LOGS della sua casella di posta, per esempio un mittente che non è cliente in Dolibarr o un riferimento prodotto che non esiste. Veda la guida alla cartella LOGS.
- Corregga con le cartelle: trascini un’e-mail in _Mail2ERP/PREVENTIVO o _Mail2ERP/ORDINI per rielaborarla come proposta o come ordine, oppure in _Mail2ERP/SALTA per saltare quel tipo di e-mail in futuro.
- I problemi di configurazione di AutoERP, come un campo BOTS4.me tags mancante o il modulo Spedizioni disattivato, sono indicati nel report dell’esecuzione, così sa esattamente cosa correggere.
📅 Il mese Discovery gratuito e il piano gratuito
Il primo mese di ogni bot è un mese Discovery gratuito, senza carta. Gli interruttori contrassegnati con Discovery nella scheda Controlli sono inclusi e partono disattivati, così sceglie lei cosa provare.
📅 Alla fine del mese Discovery
Ogni bot prosegue da solo con il piano gratuito e una piccola quota mensile: circa cinque ordini o richieste di offerta al mese per Mail2ERP, circa cinque ordini per AutoERP e circa quindici solleciti di pagamento per AutoCASH. Quando la quota è esaurita, i nuovi elementi attendono il mese successivo o finché non sceglie un piano, e un elemento già avviato viene sempre completato. I piani sono elencati in ogni pagina prodotto.
❓ Domande frequenti
Quali versioni di Dolibarr supporta BOTS4.me?
Dolibarr 23 e successivi, in hosting proprio o su DoliCloud. Il modulo API REST (API REST server) deve essere abilitato, e il suo sito Dolibarr deve essere raggiungibile da Internet.
Cosa crea Mail2ERP in Dolibarr?
Una richiesta di offerta diventa una proposta commerciale in bozza. Un ordine fermo del cliente diventa un ordine cliente, che Mail2ERP poi convalida. La persona che ha scritto l’e-mail viene impostata come contatto cliente, un indirizzo di consegna indicato nell’e-mail come contatto di spedizione, e i file del cliente vengono allegati.
Perché AutoERP ha bisogno del campo BOTS4.me tags?
Dolibarr non consente ad altri programmi di leggere o impostare i tag di un ordine cliente tramite la sua API, quindi AutoERP usa invece un attributo complementare sull’ordine. Quando l’utente di integrazione è amministratore, AutoERP crea il campo da solo; altrimenti lo aggiunge lei una volta in Setup → Modules → Sales Orders → Complementary attributes, con il codice b4mtags.
Chi invia ai miei clienti le conferme d’ordine, le fatture e i solleciti?
BOTS4.me, perché Dolibarr non può inviare e-mail tramite la sua API. AutoERP invia dalla casella che ha collegato per AutoERP, oppure dalla nostra casella di sistema con il suo indirizzo come Reply-To, con il PDF generato da Dolibarr allegato. I messaggi sono scritti nella lingua del cliente.
AutoERP tocca gli ordini che non ho contrassegnato?
No. AutoERP lavora solo sugli ordini il cui campo BOTS4.me tags contiene il tag AutoERP (intero ordine) o il tag AutoERP_partial (riga per riga). Ogni altro ordine resta esattamente com’è.
Posso impedire ad AutoCASH di sollecitare un determinato cliente?
Sì. Aggiunga il cliente all’elenco delle aziende escluse, e imposti un importo minimo e un numero minimo di giorni di ritardo. Il giorno prima di ogni esecuzione riceve anche un’anteprima di chi verrà sollecitato, così può togliere qualcuno dall’elenco in tempo.
Cosa succede dopo il mese Discovery gratuito?
Ogni bot prosegue da solo con il piano gratuito e una piccola quota mensile, per esempio circa cinque ordini al mese per AutoERP e circa quindici solleciti di pagamento per AutoCASH. Quando è esaurita, i nuovi elementi attendono il mese successivo o finché non sceglie un piano. Nulla di ciò che è già stato scritto in Dolibarr viene annullato.
📚 Letture correlate
- Prodotti: Mail2ERP, AutoERP e AutoCASH.
- Guide: Guida di Mail2ERP, Guida di AutoERP, Guida di AutoCASH e Come collegarsi.
- Un altro ERP open source: Automatizzare ERPNext dalle e-mail: ordini, conferme dei fornitori e pagamenti.
- Confrontare gli approcci: Parseur, Docparser o Nanonets vs Mail2ERP per l’inserimento ordini nell’ERP.
- Gli stessi passaggi in altri ERP: Spedire e fatturare automaticamente gli ordini di Business Central e Come automatizzare conferma degli ordini, consegna e fatturazione in Odoo.
- Approfondimento: Capire i sistemi ERP e CRM e perché abbiamo creato BOTS4.me.
Lasci che Dolibarr esegua i passaggi di routine
Abiliti l’API REST, incolli una chiave API e guardi ogni bot al lavoro in Modalità demo prima che venga scritto qualsiasi cosa. Il primo mese è un mese Discovery gratuito, senza carta.
Più di un processo da automatizzare, o un ERP che non è nella nostra lista? We build it for you: book a free call →