Come Utilizzare l’API REST di Dolibarr per Automatizzare le Attività?
   03/13/2025 00:00:00     Dolibarr    0 Commenti
Come Utilizzare l’API REST di Dolibarr per Automatizzare le Attività?

Dolibarr è un ERP e CRM open-source ampiamente utilizzato dalle aziende per gestire i processi commerciali, finanziari e amministrativi. Una delle sue funzionalità più potenti è la REST API, che consente agli sviluppatori di automatizzare le attività e integrare Dolibarr con altre applicazioni.

In questo articolo vedremo come utilizzare l’API REST di Dolibarr per automatizzare attività comuni come la gestione dei clienti, la creazione di fatture, l’aggiornamento dei prodotti e la sincronizzazione dei dati con servizi esterni.

1. Introduzione all’API REST di Dolibarr

L’API REST di Dolibarr consente di interagire con il sistema tramite richieste HTTP. È progettata per offrire accesso sicuro ai dati e alle funzionalità di Dolibarr, semplificando così l’integrazione con altri strumenti.

Funzionalità principali dell’API REST

  • Gestione di clienti e contatti (aggiunta, modifica, eliminazione).
  • Creazione e aggiornamento di fatture e preventivi.
  • Gestione di prodotti e servizi.
  • Accesso a ordini e pagamenti.
  • Lettura e scrittura di dati contabili.

2. Abilitare l’API REST in Dolibarr

Prima di utilizzare l’API REST, è necessario abilitarla in Dolibarr e configurare i permessi di accesso.

Passaggi per abilitare l’API

  1. Accedere come amministratore a Dolibarr.
  2. Andare su "Home" → "Impostazioni" → "Moduli/Applicazioni".
  3. Cercare il modulo "API REST" e attivarlo.
  4. Nella scheda Configurazione, generare una chiave API per ciascun utente o applicazione che deve accedere all’API.
  5. Definire i permessi API per limitare l’accesso ai dati sensibili.

Una volta abilitata, l’API sarà accessibile tramite il seguente URL:

plaintext
https://tuo-dolibarr.com/api/index.php

3. Autenticazione e Sicurezza

Dolibarr utilizza un meccanismo di autenticazione basata su token per proteggere l’accesso all’API.

Recuperare un token di autenticazione

L’autenticazione avviene inviando una richiesta POST con le credenziali API:

bash
curl -X POST https://tuo-dolibarr.com/api/index.php/login \ -H "Content-Type: application/json" \ -d '{ "login": "admin", "password": "tua_password" }'

La risposta conterrà un token di autenticazione, che dovrà essere incluso in ogni richiesta API come intestazione DOLAPIKEY:

bash
curl -X GET https://tuo-dolibarr.com/api/index.php/customers \ -H "DOLAPIKEY: tuo_token"

Protezione dell’API

  • Usare sempre HTTPS per evitare l’intercettazione dei dati.
  • Limitare l’accesso con permessi utente specifici.
  • Rigenerare regolarmente le chiavi API.
  • Monitorare i log di accesso API per rilevare attività sospette.

4. Automazione della Gestione dei Clienti

L’API REST permette di aggiungere e modificare clienti senza accedere all’interfaccia di Dolibarr.

Creare un nuovo cliente

Esempio di richiesta POST per aggiungere un cliente:

bash
curl -X POST https://tuo-dolibarr.com/api/index.php/thirdparties \ -H "DOLAPIKEY: tuo_token" \ -H "Content-Type: application/json" \ -d '{ "name": "Azienda X", "email": "contatto@azienda-x.com", "client": 1, "status": 1 }'

Dolibarr restituirà un ID univoco per questo cliente, che potrà essere utilizzato per azioni future.

Aggiornare un cliente esistente

Per modificare un cliente, utilizzare una richiesta PUT con l’ID del cliente:

bash
curl -X PUT https://tuo-dolibarr.com/api/index.php/thirdparties/123 \ -H "DOLAPIKEY: tuo_token" \ -H "Content-Type: application/json" \ -d '{ "email": "nuovo-contatto@azienda-x.com" }'

5. Automazione della Fatturazione

Creare una fattura tramite l’API REST

Per generare una fattura, utilizzare l’endpoint /invoices:

bash
curl -X POST https://tuo-dolibarr.com/api/index.php/invoices \ -H "DOLAPIKEY: tuo_token" \ -H "Content-Type: application/json" \ -d '{ "socid": 123, "date": "2024-03-15", "lines": [ { "desc": "Servizio di consulenza", "subprice": 200, "qty": 1, "total_ht": 200 } ] }'

Dolibarr restituirà l’ID della fattura, che potrà essere utilizzato per l’invio via email o il download in formato PDF.

6. Sincronizzazione di Dolibarr con Altri Strumenti

L’API REST di Dolibarr può essere utilizzata per sincronizzare i dati con strumenti esterni come WooCommerce, Prestashop, Zapier, Google Sheets, Power BI, ecc.

Esempio: Sincronizzazione con un sito e-commerce

Se si desidera recuperare l’elenco dei prodotti per un sito WooCommerce, è possibile eseguire la seguente richiesta:

bash
curl -X GET https://tuo-dolibarr.com/api/index.php/products \ -H "DOLAPIKEY: tuo_token"

Questo comando restituirà le informazioni sui prodotti di Dolibarr, che potranno essere importate in WooCommerce tramite la sua API REST.

7. Automazione dei Report e delle Analisi

L’API di Dolibarr consente di estrarre dati per generare report personalizzati.

Esportare le vendite del mese corrente

Per recuperare le vendite del mese:

bash
curl -X GET "https://tuo-dolibarr.com/api/index.php/invoices?date_creation_start=2024-03-01&date_creation_end=2024-03-31" \ -H "DOLAPIKEY: tuo_token"

Questi dati possono essere integrati in Google Sheets, Power BI o Excel per un’analisi avanzata.

Conclusione

L’API REST di Dolibarr è uno strumento potente che consente di automatizzare molte attività e integrare Dolibarr con altri sistemi. Attivando e proteggendo correttamente l’API, è possibile gestire i clienti, creare fatture, sincronizzare dati con piattaforme esterne e generare report personalizzati.

Che si tratti di un’integrazione con un sito e-commerce, un’app mobile o un CRM esterno, l’API REST di Dolibarr facilita l’automazione e migliora la produttività.

Se vuoi approfondire, esplora la documentazione ufficiale di Dolibarr o utilizza strumenti come Postman per testare e ottimizzare le richieste API.

Commenti

Accedi o registrati per inserire commenti