EasyAPI - Professional REST API for Dolibarr (32 core domains) + MCP

EasyAPI for Dolibarr — the professional REST API + MCP that reimplements the whole core

EasyAPI gives Dolibarr a professional REST API that fully reimplements the core API (32 domains: sales, purchasing, stock, projects, accounting, HR, membership…) on top of an auto-discovered Resources framework, with NATIVE Dolibarr permissions, idempotency, configurable resilience and embedded Scalar/Swagger/Redoc documentation.

🛡️ What's new 2.7.4 → 2.7.12 — robustness & contract-fidelity audit

An exhaustive multi-agent audit of the whole module (every domain) has hardened EasyAPI without breaking compatibility. Highlights:

• Data integrity: optional foreign keys sent as 0/"" are normalised to NULL instead of failing; consistent VAT (vatrate) and boolean-flag validation across every resource.
• Transactionality: multi-step operations (shipments, receptions, accounting export, bank accounts) wrapped in a single transaction — no half-written states.
• Security & ACL: per-record access control hardened on gateways, categories, stock movements and expense lines; no cross-entity reads.
• No data leaks: nested document lines (lines[]) no longer expose internal metadata.
• Faithful OpenAPI: bodyless 204/304, correct oneOf/array bulk shape, per-status headers (ETag, Allow, Retry-After) and the spec filtered by the user's permissions.
• Sturdier MCP: deterministic idempotency only where appropriate (naturally repeatable creates —stock movements, agenda events— are no longer wrongly de-duplicated) plus If-Match support on conditional writes.
• Consistent status codes: no-op transitions (e.g. validating an already-validated member) return an idempotent 304 instead of 409.

All changes verified with the PHPUnit suite and live QA. See ChangeLog.md for the per-version detail.

🤖 New in 2.1.0 — Native MCP server for AI agents

EasyAPI now ships a self-contained MCP (Model Context Protocol) server in PHP: connect Claude, Cursor or any AI agent to your Dolibarr in a minute (the module URL + your DOLAPIKEY as a Bearer token). Instead of hundreds of tools it exposes 3 meta-tools (search / describe / invoke) over the ~697 operations, with schemas and ready-to-invoke examples, multi-step operation chaining, idempotent writes and self-correcting errors (422 with the exact field to fix). The agent inherits your native Dolibarr permissions and ACL and even auto-discovers third-party modules' resources. Ships with an "MCP / AI" admin tab and an in-module connection guide.

⚖️ Comparison: native Dolibarr API vs EasyAPI

Dolibarr already ships a REST API… but it leaves you halfway there: no idempotency, no structured errors, real permission bugs, no bulk operations or resilience, and uneven coverage. EasyAPI is the API Dolibarr should have

📦 Common use cases

• Integrate Dolibarr with e-commerce, mobile apps or external ERPs via a modern REST API.
• Bulk synchronization of products, third parties and orders.
• Headless automations with an "exactly once" guarantee (idempotency).
• Expose data to BI/dashboards with powerful filtering and pagination.
• Build your own domain API by extending Resources, without forking Dolibarr.

✨ Features

• 🧩 32 core domains reimplemented (sales, purchasing, stock, projects, accounting, HR, membership…) with filtering, pagination, sorting and bulk operations (bulk 207).
• 🔐 Security based on Dolibarr's NATIVE per-domain permissions + per-record ACL (fk_soc/entity).
• ⭐ Pro layer: idempotency (Idempotency-Key), 422 validation, structured errors, OpenAPI with embedded Scalar/Swagger/Redoc docs.
• 🛡️ Configurable resilience: rate-limit, deadlock retry, ETag/If-Match (optimistic concurrency) and maintenance mode.
• 🔌 Extensible: auto-discovers Resources — extend the API from your own module without touching the core.

📋 How it works

1. Install and enable EasyAPI; run composer install in the module folder.
2. Configure resilience (rate-limit, retry, ETag, body size, maintenance) plus CORS/logging on the "API" tab.
3. Authenticate with your DOLAPIKEY and consume the 32 domains; use Idempotency-Key and If-Match for safe writes.
4. Open /docs to explore the API with Scalar/Swagger/Redoc; extend it with your own Resources.

🧩 What's included in the module

• EAPI framework with auto-discovery + the 32 Dolibarr core domains.
• Pro layer: idempotency, 422 validation, structured errors, bulk 207, per-record ACL.
• Resilience: configurable rate-limit, deadlock retry, ETag/If-Match and maintenance mode.
• Embedded OpenAPI documentation with Scalar, Swagger UI and Redoc; guides and examples.
• Interface in 8 languages.

⚙️ Compatibility & requirements

• 📦 Dolibarr V15+ (compatible up to V22+)
• ⚙️ PHP 7.0 – 8.3+
• 🗄️ MySQL 5.7+ / MariaDB 10.2+ / PostgreSQL 10+
• 🌐 Apache with mod_rewrite or Nginx; Composer to install dependencies

💰 Pricing & license

EasyAPI: €330. Distributed under the GNU General Public License v3.0. Includes 365 days of update access.

✉️ Support

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