EasyAPI - API REST professionale per Dolibarr (32 domini del core) + MCP

mp23914d20260607102352

API REST professionale per Dolibarr: 32 domini del core con permessi nativi, idempotenza, resilienza, docs Scalar e server MCP per agenti IA.

290,00 €
Al netto delle imposte

  • Autore EasySoft Tech SL
  • Versione modulo 2.11.0
  • Rilascio data 07/06/2026
  • Accesso agli aggiornamenti e ai download 1 anno
  • Come contattare l'assistenza info@easysoft.es
  • Compatibilità Dolibarr V15+   -   PHP7.0 - 8.3
  • Ultimo aggiornamento 08/07/2026 13.44

Maggiori informazioni...

EasyAPI per Dolibarr — l'API REST + MCP professionale che reimplementa tutto il core

EasyAPI dota Dolibarr di una API REST professionale che reimplementa completamente l'API del core (32 domini: vendite, acquisti, magazzino, progetti, contabilità, risorse umane, associazione…) su un framework di Resources auto-rilevate, con i permessi NATIVI di Dolibarr, idempotenza, resilienza configurabile e documentazione Scalar/Swagger/Redoc integrata.

🤖 Novità 2.1.0 — Server MCP nativo per agenti IA

EasyAPI include ora un server MCP (Model Context Protocol) autonomo in PHP: collega Claude, Cursor o qualsiasi agente IA al tuo Dolibarr in un minuto (l'URL del modulo + il tuo DOLAPIKEY come token Bearer). Invece di centinaia di tool, espone 3 meta-tool (search / describe / invoke) sulle ~697 operazioni, con schemi ed esempi pronti da invocare, concatenamento di operazioni multi-step, scritture idempotenti ed errori auto-correggibili (422 con il campo esatto da correggere). L'agente eredita i tuoi permessi e ACL nativi di Dolibarr e rileva automaticamente anche le risorse dei moduli di terze parti. Include una scheda di amministrazione « MCP / IA » e una guida di connessione integrata.

⚖️ Confronto: API nativa Dolibarr vs EasyAPI

Dolibarr include già un'API REST… ma ti lascia a metà strada: niente idempotenza, niente errori strutturati, bug di permessi reali, niente operazioni massive né resilienza, e copertura disomogenea. EasyAPI è l'API che Dolibarr dovrebbe avere
Dimensione API nativa Dolibarr ⭐ EasyAPI
Copertura ~25 classi API con copertura DISOMOGENEA (es. accountancy = solo exportData; vari metodi commentati/inesistenti) 32 domini del core COMPLETI + sotto-risorse (righe, contatti, pagamenti, ecc.)
Modello di risposta Eterogeneo (un POST restituisce un int grezzo, un altro l'oggetto; _cleanObjectDatas incoerente tra domini) Envelope UNIFORME {success,data,meta}; POST→201+oggetto pulito; DELETE→204
Errori RestException con codici/messaggi disparati, senza tassonomia, senza request_id ErrorCatalog: tassonomia completa (422 validation_error+error.fields, 409, 410, 412, 413, 415, 428, 429, 503…) + request_id + doc_url in ogni errore
Sicurezza / ACL Diritti nativi + _checkAccessToResource ma CON BUG reali (join commerciali t.rowid=sc.fk_soc, restituisce 401 dove serve 403, feature mal whitelistate) STESSI diritti nativi + ACL per record CORRETTA e uniforme (fk_soc/entità), 403 corretto, nessuna fuga cross-socid/entità
Idempotenza ❌ ✅ Idempotency-Key (prenotazione atomica, replay, conflitto 422) in OGNI scrittura, incluse le transizioni di stato
Validazione 400 «<campo> field missing» di base 422 dichiarativa con error.fields per regola (required/numeric/enum/exists/ordine-delle-date…)
Filtri / ordinamento / paginazione sqlfilters (potente ma grezzo) + limit/page + JSON:API ?filter/?sort/?q/?fields/?include, paginazione offset+cursor, X-Total-Count, spareggio deterministico
Operazioni massive (bulk) ❌ ✅ 207 Multi-Status in create/update/delete (fino a 100 per lotto)
Resilienza ❌ ✅ rate-limit configurabile, retry dei deadlock DB, ETag/If-None-Match (304) + If-Match (concorrenza ottimistica, 412), modalità manutenzione, endpoint /status e /health
Documentazione Explorer Swagger basico OpenAPI completo + Scalar/Swagger/Redoc integrati, raggruppato per dominio, esempi auto
Estensibilità Bisogna toccare/forkare il core per aggiungere endpoint auto-discovery delle Resources dal tuo modulo
Qualità / coerenza Incoerenze e bug ereditati Contratto dichiarativo uniforme + 3.849 test + audit adversarial incrociato
Portabilità / config Standard Portabile (custom/ o qualsiasi root registrata) + tutto configurabile tramite costanti EASYAPI_*

📦 Casi d'uso comuni

  • Integrare Dolibarr con e-commerce, app mobili o ERP esterni tramite una REST moderna.
  • Sincronizzazione massiva (bulk) di prodotti, terzi e ordini.
  • Automazioni headless con garanzia «esattamente una volta» (idempotenza).
  • Esporre dati a BI/dashboard con filtri e paginazione potenti.
  • Costruire la tua API di dominio estendendo le Resources, senza fare il fork di Dolibarr.

✨ Funzionalità

  • 🧩 32 domini del core reimplementati (vendite, acquisti, magazzino, progetti, contabilità, risorse umane, associazione…) con filtri, paginazione, ordinamento e operazioni massive (bulk 207).
  • 🔐 Sicurezza basata sui permessi NATIVI di Dolibarr per dominio + ACL per record (fk_soc/entità).
  • ⭐ Livello Pro: idempotenza (Idempotency-Key), validazione 422, errori strutturati, OpenAPI con docs Scalar/Swagger/Redoc integrate.
  • 🛡️ Resilienza configurabile: rate-limit, retry dei deadlock, ETag/If-Match (concorrenza ottimistica) e modalità manutenzione.
  • 🔌 Estensibile: rileva automaticamente le Resources — estendi l'API dal tuo modulo senza toccare il core.

📋 Come funziona

  1. Installa e attiva EasyAPI; esegui composer install nella cartella del modulo.
  2. Configura la resilienza (rate-limit, retry, ETag, dimensione del corpo, manutenzione) e CORS/logging nella scheda «API».
  3. Autenticati con il tuo DOLAPIKEY e consuma i 32 domini; usa Idempotency-Key e If-Match per scritture sicure.
  4. Apri /docs per esplorare l'API con Scalar/Swagger/Redoc; estendila con le tue Resources.

🧩 Cosa include il modulo

  • Framework EAPI con auto-discovery + i 32 domini del core di Dolibarr.
  • Livello Pro: idempotenza, validazione 422, errori strutturati, bulk 207, ACL per record.
  • Resilienza: rate-limit, retry dei deadlock, ETag/If-Match e modalità manutenzione configurabili.
  • Documentazione OpenAPI integrata con Scalar, Swagger UI e Redoc; guide ed esempi.
  • Interfaccia in 8 lingue.

⚙️ Compatibilità e requisiti

  • 📦 Dolibarr V15+ (compatibile fino a V22+)
  • ⚙️ PHP 7.0 – 8.3+
  • 🗄️ MySQL 5.7+ / MariaDB 10.2+ / PostgreSQL 10+
  • 🌐 Apache con mod_rewrite o Nginx; Composer per installare le dipendenze

💰 Prezzo e licenza

EasyAPI: 330 €. Distribuito secondo la GNU General Public License v3.0. Include 365 giorni di accesso agli aggiornamenti.

✉️ Supporto

✉️ info@easysoft.es | 🌐 www.easysoft.es




If you think this module is a fork of another one (published after the first one) or violates some terms or conditions of use (for users or vendors), you can make a report at dolistore@dolibarr.org