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

La API REST que Dolibarr debería traer de serie

EasyAPI reimplementa los 32 dominios del core de Dolibarr (ventas, compras, stock, contabilidad, proyectos, RRHH, asociación…) sobre un contrato único: el mismo envelope de respuesta, la misma taxonomía de errores, idempotencia en toda escritura y un servidor MCP para agentes de IA. Tus permisos y tu ACL de Dolibarr siguen mandando.

El mismo envelope, los mismos códigos y los mismos filtros en los 32 dominios. Se aprende una vez y sirve para todos: no hay una forma distinta de paginar, de filtrar ni de leer el error según el recurso que toques.

Lo que pide el agente de IA espera a que tú lo confirmes

Con la confirmación humana activa, una escritura que un agente pide por MCP no se ejecuta. Queda en Herramientas › Acciones pendientes (IA) con sus datos y una vista previa, y solo se hace cuando la persona que conectó al agente pulsa Confirmar.

• Tú decides qué espera. Todas las escrituras, o solo los envíos de correo y los borrados. La opción viene apagada, así que actualizar no cambia nada.
• El agente no puede confirmarse a sí mismo. La confirmación no existe para el MCP: se hace en Dolibarr o por la API REST (POST /mcp/pending/{token}/confirm), y solo la da quien pidió la acción.
• Una sola vez y con caducidad. Cada acción se confirma una vez y caduca a los 10 minutos; el plazo se amplía hasta 24 horas.
• Correos marcados. Un correo enviado tras confirmarlo lleva X-AI-Generated y X-AI-Reviewed.

Cuánto te deben y desde cuándo, y el precio que el ERP pondría a cada cliente

La versión 2.25 trajo lecturas de negocio que antes había que montar sumando facturas a mano. El MCP, además, le dice al agente qué hace cada operación antes de que la llame.

• Antigüedad de la deuda. GET /invoices/kpis/aging y GET /supplier-invoices/kpis/aging reparten lo pendiente en sin vencer, 1-30, 31-60, 61-90 y más de 90 días. Los tramos se cambian con ?buckets=0,15,45 y ?group=thirdparty da el desglose por tercero. Respetan la ACL de los listados: el comercial que solo ve a sus clientes solo ve la deuda de esos clientes.
• Días de cobro y pago, y el pendiente real. /invoices/kpis añade dso y /supplier-invoices/kpis añade dpo, los días medios de cobro y de pago de los últimos 90 días. Los KPI outstanding y overdue suman lo que queda pendiente de verdad: descuentan cobros parciales, abonos y anticipos con el mismo cálculo que getRemainToPay() del core.
• Precio efectivo por cliente. GET /products/{id}/price?socid=&qty= devuelve el precio que pondría el ERP en la línea para ese cliente y esa cantidad, con IVA, recargo e IRPF, los totales y de dónde sale: base, price_level, customer_price o quantity.
• Errores sin SQL. El texto del motor de base de datos se queda en el syslog con el request_id, y la respuesta trae un código con el que se puede hacer algo: un duplicado es un 409 con reason: duplicate_record, y un bloqueo, un 503 con Retry-After: 2 para reintentar.
• Cada operación declara su efecto. x-effect dice si lee (read), escribe en el ERP (internal), sale fuera (external) o no tiene vuelta atrás (irreversible), y el MCP lo traduce a readOnlyHint y destructiveHint. Los borrados por MCP se pueden prohibir en el setup (EASYAPI_MCP_ALLOW_DELETE) o usuario a usuario, y manda lo más restrictivo.
• IBAN enmascarado. Por MCP, el IBAN, el número de cuenta y la referencia del mandato de las cuentas bancarias de terceros salen con solo los 4 últimos caracteres. Por REST no cambia nada.

curl -X POST "https://tu-dolibarr.com/custom/easyapi/api/invoices" \
  -H "DOLAPIKEY: tu_clave" \
  -H "Idempotency-Key: pedido-4417" \
  -H "Content-Type: application/json" \
  -d '{"socid": 128, "lines": [{"fk_product": 55, "qty": 2, "subprice": 49.90}]}'

{
  "success": true,
  "data": {
    "id": 902,
    "ref": "(PROV902)",
    "socid": 128,
    "statut": 0,
    "total_ttc": 119.76,
    "lines": [ { "id": 3311, "qty": 2, "subprice": 49.90 } ]
  }
}

{
  "success": false,
  "error": {
    "type": "validation_error",
    "code": 422,
    "message": "Validation failed",
    "fields": { "socid": "does not exist" },
    "request_id": "req_7f3a91c2",
    "doc_url": "https://easysoft.es/docs/api#validation_error"
  }
}

EasyAPI no es un módulo publicado y olvidado: la versión actual es la 2.28.0 y cada entrega añade pruebas que sujetan lo que arregla. La 2.28 trae una prueba por cada regla de la confirmación humana, comprobada rompiendo la regla a propósito, una prueba en navegador de la página de acciones pendientes y la comprobación por HTTP en Dolibarr 15, 18 y 24. Además de las pruebas, cada release pasa QA contra instancias reales de Dolibarr antes de publicarse.

¿Te encaja para lo que necesitas integrar?

Cuéntanos tu caso y te decimos si EasyAPI te sirve — y si no, te lo decimos igual.