EasyAPI - API REST profesional para Dolibarr (32 dominios del core) + MCP

EasyAPI para Dolibarr — la API REST + MCP profesional que reimplementa todo el core

EasyAPI dota a Dolibarr de una API REST profesional que reimplementa por completo la API del core (32 dominios: ventas, compras, stock, proyectos, contabilidad, RRHH, asociación…) sobre un framework de Resources auto-descubiertos, con permisos NATIVOS de Dolibarr, idempotencia, resiliencia configurable y documentación Scalar/Swagger/Redoc embebida.

🛡️ Novedades 2.7.4 → 2.7.12 — auditoría de robustez y fidelidad de contrato

Una auditoría multiagente exhaustiva del módulo completo (todos los dominios) ha endurecido EasyAPI sin romper compatibilidad. Lo más destacado:

• Integridad de datos: las claves foráneas opcionales enviadas como 0/"" se normalizan a NULL en lugar de fallar; validación de IVA (vatrate) y de flags booleanos coherente en todos los recursos.
• Transaccionalidad: operaciones multi-paso (envíos, recepciones, exportación contable, cuentas bancarias) envueltas en una sola transacción — sin estados a medias.
• Seguridad y ACL: control de acceso por registro reforzado en pasarelas, categorías, movimientos de stock y líneas de gastos; sin lecturas cruzadas entre entidades.
• Sin fugas de datos: las líneas anidadas (lines[]) de todos los documentos ya no exponen metadatos internos.
• OpenAPI fiel: 204/304 sin cuerpo, forma de lote oneOf/array correcta, cabeceras por código (ETag, Allow, Retry-After) y filtrado de la especificación según los permisos del usuario.
• MCP más sólido: idempotencia determinista solo donde corresponde (los creates naturalmente repetibles —movimientos de stock, eventos de agenda— ya no se deduplican por error) y soporte de If-Match en escrituras condicionales.
• Códigos de estado coherentes: las transiciones no-op (p. ej. validar un miembro ya validado) devuelven un 304 idempotente en vez de 409.

Todos los cambios verificados con la suite PHPUnit y QA en vivo. Ver ChangeLog.md para el detalle por versión.

🤖 Novedad 2.1.0 — Servidor MCP nativo para agentes de IA

EasyAPI incluye ahora un servidor MCP (Model Context Protocol) autocontenido en PHP: conecta Claude, Cursor o cualquier agente de IA a tu Dolibarr en un minuto (la URL del módulo + tu DOLAPIKEY como token Bearer). En lugar de cientos de tools, expone 3 meta-tools (search / describe / invoke) sobre las ~697 operaciones, con esquemas y ejemplos listos para invocar, encadenado de operaciones de varios pasos, idempotencia en escrituras y errores auto-corregibles (422 con el campo exacto a corregir). El agente hereda tus permisos y ACL nativos de Dolibarr y auto-descubre incluso los recursos de módulos de terceros. Incluye pestaña de administración «MCP / IA» y guía de conexión dentro del propio módulo.

⚖️ Comparativa: API nativa de Dolibarr vs EasyAPI

Dolibarr ya trae una API REST… pero te deja a medias: sin idempotencia, sin errores estructurados, con bugs de permisos, sin operaciones masivas ni resiliencia, y con cobertura desigual. EasyAPI es la API que Dolibarr debería tener

📦 Casos de uso

• Integrar Dolibarr con e-commerce, apps móviles o ERPs externos vía REST moderna.
• Sincronización masiva (bulk) de productos, terceros y pedidos.
• Automatizaciones headless con garantía «exactamente una vez» (idempotencia).
• Exponer datos a BI/dashboards con filtros y paginación potentes.
• Construir tu propia API de dominio extendiendo Resources, sin forkear Dolibarr.

✨ Características

• 🧩 32 dominios del core reimplementados (ventas, compras, stock, proyectos, contabilidad, RRHH, asociación…) con filtros, paginación, ordenación y operaciones masivas (bulk 207).
• 🔐 Seguridad con los permisos NATIVOS de Dolibarr por dominio + ACL por registro (fk_soc/entidad).
• ⭐ Capa Pro: idempotencia (Idempotency-Key), validación 422, errores estructurados, OpenAPI con docs Scalar/Swagger/Redoc embebidas.
• 🛡️ Resiliencia configurable: rate-limit, reintento de deadlocks, ETag/If-Match (concurrencia optimista) y modo mantenimiento.
• 🔌 Extensible: auto-descubre Resources — amplías la API desde tu propio módulo sin tocar el core.

📋 Cómo funciona

1. Instala y activa EasyAPI; ejecuta composer install en la carpeta del módulo.
2. Configura resiliencia (rate-limit, retry, ETag, tamaño de cuerpo, mantenimiento) y CORS/logging en la pestaña «API».
3. Autentícate con tu DOLAPIKEY y consume los 32 dominios; usa Idempotency-Key e If-Match para escrituras seguras.
4. Abre /docs para explorar la API con Scalar/Swagger/Redoc; extiéndela con tus propios Resources.

🧩 Qué incluye el módulo

• Framework EAPI con auto-discovery + los 32 dominios del core de Dolibarr.
• Capa Pro: idempotencia, validación 422, errores estructurados, bulk 207, ACL por registro.
• Resiliencia: rate-limit, retry de deadlocks, ETag/If-Match y modo mantenimiento configurables.
• Documentación OpenAPI embebida con Scalar, Swagger UI y Redoc; guías y ejemplos.
• Interfaz en 8 idiomas.

⚙️ Compatibilidad y requisitos

• 📦 Dolibarr V15+ (compatible hasta V22+)
• ⚙️ PHP 7.0 – 8.3+
• 🗄️ MySQL 5.7+ / MariaDB 10.2+ / PostgreSQL 10+
• 🌐 Apache con mod_rewrite o Nginx; Composer para instalar dependencias

💰 Precio y licencia

EasyAPI: 330 €. Distribuido bajo GNU General Public License v3.0. Incluye 365 días de acceso a actualizaciones.

✉️ Soporte

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