EasyAPI - Professionelle REST-API für Dolibarr (32 Core-Domänen) + MCP

Die REST-API, die Dolibarr ab Werk mitbringen sollte

EasyAPI implementiert die 32 Domänen des Dolibarr-Core neu (Verkauf, Einkauf, Lager, Buchhaltung, Projekte, Personal, Mitglieder…) auf einem einzigen Vertrag: dieselbe Antwort-Envelope, dieselbe Fehlertaxonomie, Idempotenz bei jeder Schreiboperation und ein MCP-Server für KI-Agenten. Ihre Rechte und Ihre ACL in Dolibarr gelten weiterhin.

Dieselbe Envelope, dieselben Codes und dieselben Filter in allen 32 Domänen. Einmal gelernt, gilt es für alle: es gibt keine andere Art zu paginieren, zu filtern oder den Fehler zu lesen, je nachdem, welche Ressource Sie anfassen.

Was der KI-Agent anfordert, wartet auf Ihre Bestätigung

Mit aktivierter menschlicher Bestätigung wird ein Schreibvorgang, den ein Agent über MCP anfordert, nicht ausgeführt. Er wartet unter Werkzeuge › Ausstehende Aktionen (KI) mit seinen Daten und einer Vorschau und läuft erst, wenn die Person, die den Agenten verbunden hat, auf Bestätigen klickt.

• Sie entscheiden, was wartet. Alle Schreibvorgänge oder nur E-Mail-Versand und Löschungen. Die Option ist ausgeschaltet, ein Update ändert also nichts.
• Der Agent kann sich nicht selbst bestätigen. Für MCP gibt es keine Bestätigung: Sie erfolgt in Dolibarr oder über die REST-API (POST /mcp/pending/{token}/confirm), und nur die Person, die die Aktion angefordert hat, kann sie geben.
• Einmal und mit Ablauf. Jede Aktion wird einmal bestätigt und läuft nach 10 Minuten ab; die Frist lässt sich auf bis zu 24 Stunden verlängern.
• Markierte E-Mails. Eine nach der Bestätigung gesendete E-Mail trägt X-AI-Generated und X-AI-Reviewed.

Wer Ihnen wie viel schuldet und seit wann, und der Preis, den das ERP jedem Kunden berechnen würde

Version 2.25 brachte Geschäftskennzahlen, die man bisher von Hand aus den Rechnungen zusammenrechnen musste. Dazu sagt der MCP dem Agenten, was jede Operation bewirkt, bevor er sie aufruft.

• Altersstruktur der offenen Posten. GET /invoices/kpis/aging und GET /supplier-invoices/kpis/aging teilen das Offene auf in nicht fällig, 1-30, 31-60, 61-90 und über 90 Tage. Die Stufen lassen sich mit ?buckets=0,15,45 ändern, und ?group=thirdparty liefert die Aufschlüsselung pro Geschäftspartner. Es gilt dieselbe ACL wie in den Listen: Ein Vertriebsmitarbeiter, der nur seine Kunden sieht, sieht auch nur deren Schulden.
• Zahlungsdauer und echter offener Betrag. /invoices/kpis ergänzt dso und /supplier-invoices/kpis ergänzt dpo, die durchschnittlichen Tage bis zum Zahlungseingang und bis zur Zahlung über die letzten 90 Tage. Die KPI outstanding und overdue summieren, was wirklich noch offen ist: Sie ziehen Teilzahlungen, Gutschriften und Anzahlungen mit derselben Berechnung ab wie getRemainToPay() im Core.
• Effektiver Preis pro Kunde. GET /products/{id}/price?socid=&qty= liefert den Preis, den das ERP für diesen Kunden und diese Menge in die Zeile setzen würde, mit MwSt., Zuschlag und Quellensteuer, den Summen und der Herkunft des Preises: base, price_level, customer_price oder quantity.
• Fehler ohne SQL. Die Meldung der Datenbank bleibt im Syslog, zusammen mit der request_id, und die Antwort enthält einen Code, mit dem man etwas anfangen kann: Ein Duplikat ist ein 409 mit reason: duplicate_record, eine Sperre ein 503 mit Retry-After: 2 für den nächsten Versuch.
• Jede Operation deklariert ihre Wirkung. x-effect gibt an, ob sie liest (read), im ERP schreibt (internal), nach außen geht (external) oder sich nicht rückgängig machen lässt (irreversible), und der MCP übersetzt das in readOnlyHint und destructiveHint. Löschen per MCP lässt sich im Setup (EASYAPI_MCP_ALLOW_DELETE) oder pro Benutzer verbieten, und es gilt die strengere Einstellung.
• Maskierte IBAN. Per MCP zeigen IBAN, Kontonummer und Mandatsreferenz der Bankkonten von Geschäftspartnern nur noch die letzten 4 Zeichen. Über REST ändert sich nichts.

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 ist kein veröffentlichtes und vergessenes Modul: die aktuelle Version ist die 2.28.0, und jede Lieferung ergänzt Tests, die absichern, was sie repariert. Die 2.28 bringt einen Test für jede Regel der menschlichen Bestätigung, geprüft durch absichtliches Brechen der Regel, einen Browsertest der Seite mit den ausstehenden Aktionen und eine HTTP-Prüfung auf Dolibarr 15, 18 und 24. Neben den Tests durchläuft jedes Release vor der Veröffentlichung QA gegen echte Dolibarr-Instanzen.

Passt es zu dem, was Sie integrieren möchten?

Schildern Sie uns Ihren Fall, und wir sagen Ihnen, ob EasyAPI für Sie passt — und wenn nicht, sagen wir Ihnen das genauso.