EasyAPI

API REST potente y moderna para conectar Dolibarr con cualquier sistema.

Compatible con Dolibarr
Entrega inmediata
Soporte en español
Actualizaciones incluidas

EasyAPI API REST profesional para Dolibarr · 32 dominios · Idempotencia · Servidor MCP para agentes de IA
CARACTERÍSTICAS PRINCIPALES
32 dominios del core	Ventas, compras, stock, proyectos, contabilidad, RRHH, asociación y más — filtros, paginación, ordenación y selección de campos en todos los dominios. Operaciones masivas (bulk) con respuesta 207 Multi-Status por elemento.
Seguridad nativa + ACL	Autorización con los permisos NATIVOS de Dolibarr por dominio. ACL por registro (fk_soc / entidad) corregida y uniforme, sin fugas cross-socid/entidad.
Sesión por cookie HTTP-only	4 modos configurables (disabled / static / hybrid / session) para front web sin manejar la api_key en JS. El modo session emite un JWT firmado HS256 con TTL y revocación (POST /logout). CORS con Allow-Credentials automático.
Idempotencia	Idempotency-Key en TODA escritura (reserva atómica, replay, conflicto 422): garantía «exactamente una vez» en creates, updates y transiciones de estado.
Validación 422 + errores	Validación declarativa con error.fields por regla (required/numeric/enum/exists/orden de fechas…). Taxonomía completa de errores (409, 410, 412, 413, 415, 428, 429, 503…) + request_id + doc_url.
Documentación OpenAPI	Scalar, Swagger UI y Redoc embebidos con ejemplos automáticos, agrupados por dominio y generados desde los metadatos reales de los Resources.
CAPA PRO — RESILIENCIA CONFIGURABLE
Rate limiting	Límite de peticiones por usuario/ventana con bloqueo de fichero para evitar carreras. Totalmente configurable vía constantes EASYAPI_RATE_*.
Reintento de deadlocks	Reintento automático de transacciones de BD abortadas por deadlock (EASYAPI_DB_RETRY_*), transparencia total para el cliente.
ETag / If-Match	If-None-Match → 304 Not Modified (ahorro de ancho de banda). If-Match → concurrencia optimista con 412 Precondition Failed (sin sobreescrituras perdidas).
Modo mantenimiento	Endpoint /status y /health con Retry-After. Límite configurable de tamaño de cuerpo (EASYAPI_MAX_BODY_BYTES).
Bulk 207 Multi-Status	Creación, actualización y eliminación masiva (hasta 100 por lote) con resultado individual por elemento: éxito parcial sin abortar el lote.
SERVIDOR MCP NATIVO — IA / AGENTES
Model Context Protocol	Servidor MCP autocontenido en PHP sin SDK ni servicios externos. Conecta Claude, Cursor o cualquier agente de IA a Dolibarr con tus permisos y ACL nativos.
3 meta-tools	easyapi_search (búsqueda multi-idioma ES/EN/FR/DE/IT/PT con paginación por cursor), easyapi_describe (esquema de entrada + ejemplo con solo campos requeridos) y easyapi_invoke (ejecución con tus permisos).
Workflow compuesto	4ª meta-tool experimental easyapi_invoke_workflow: secuencia encadenada de operaciones con placeholder $lastId y rollback best-effort (opt-in).
Transporte STDIO	Servidor MCP local por stdin/stdout (bin/mcp-stdio.php) para clientes que lanzan un proceso sin URL pública. Auth por variable de entorno EASYAPI_TOKEN.
Conformidad MCP 2025-11-25	Negociación de protocolVersion, validación de Origin (anti DNS-rebinding), structuredContent + outputSchema, destructiveHint y caché APCu del mapa de operaciones.
DOCUMENTOS — NUEVO v2.12.1
15 recursos con docs	Subida, listado, descarga y generación de documentos en product, societe, bom, mo, contact, ticket, donation, partnership, knowledgerecord, user, bank_account, agenda, recruitmentcandidature, recruitmentjobposition y subscription.
Interoperabilidad UI	Directorios de salida alineados con la pestaña Documentos del core de Dolibarr: los ficheros subidos vía API aparecen en la UI y viceversa. Guardia method_exists para clases sin generateDocument() → 422 limpio.
EXTENSIBILIDAD
Auto-discovery	Resources auto-descubiertos desde carpetas eapi/ de cualquier módulo activo. Dos mecanismos: Resources EAPI (recomendado, con helpers declarativos) o hooks tradicionales (easyapiRegisterRoutes).
Integración transparente	Amplías la API sin tocar el core de Dolibarr ni el código de EasyAPI. Tus Resources heredan permisos, idempotencia, validación y resiliencia automáticamente.
COMPATIBILIDAD Y REQUISITOS
Dolibarr	Versión 15.0 o superior (compatible hasta 22.x). Familia del módulo: interface.
PHP	7.0 – 8.3+ (Slim 4 requiere 7.4 en tiempo de ejecución; recomendado 8.1+).
Base de datos	MySQL 5.7+ / MariaDB 10.2+ / PostgreSQL 10+. Una tabla propia: llx_easyapi_sessions (sesiones JWT).
Servidor web	Apache con mod_rewrite o Nginx. Composer para instalar dependencias (Slim 4, PSR-7, FastRoute).
Idiomas	Interfaz en 8 idiomas: español, inglés, francés, alemán, italiano, portugués, catalán y gallego.
PRECIO Y LICENCIA
Edición Pro	290 € (HT). Incluye 365 días de acceso a actualizaciones y soporte por email. Licencia GNU GPL v3.0. Módulo único, auto-contenido, sin SaaS ni telemetría.
Soporte	info@easysoft.es · www.easysoft.es · Ficha en Dolistore
Compatible con Dolibarr v15 o superior · PHP 7.0+ · MySQL / MariaDB / PostgreSQL · 8 idiomas

Cómo lo ponemos en marcha

1
Instalación y configuración
Lo instalamos en tu Dolibarr y lo dejamos listo para usar.
2
Adaptación a tu operativa
Ajustamos el módulo a tu forma de trabajar y a tus procesos.
3
Formación y soporte
Formamos a tu equipo y te acompañamos tras la puesta en marcha.

Preguntas frecuentes