Connector · ERPNext (Frappe v15)

ERPNext (Frappe v15)

ERPNext läuft als mandantenfähige Frappe-Site erp.simo-online.com im Docker-Container erpnext. Die Anbindung erfolgt über die Frappe-REST-API.

Integrations-Vorgehensweise

1. Credential hinterlegen — der operative User-Key (api_key/api_secret)

liegt verschlüsselt in ~/.simosphere/secrets/erpnext.json.

2. Multi-Tenant-Host — jeder REST-Aufruf trägt den Header

Host: erp.simo-online.com, sonst antwortet der falsche/kein Mandant.

3. Verbindungstest — GET /api/method/frappe.auth.get_logged_user mit dem

gespeicherten User-Key. Antwortet die API mit dem eingeloggten Benutzer, steht die Verbindung.

4. Datenzugriff — z. B. /api/resource/Customer, /api/resource/Project,

/api/resource/Lead.

Berechtigungsmodell

• Auth-Schema: Authorization: token <api_key>:<api_secret> (Token-Paar je

Benutzer).

• Rollen: ein Vertriebs-/Projekt-User erhält Sales Manager, Sales User,

Projects Manager, Projects User.

• Auto-Provisioning braucht Admin — das Anlegen eines Users

(POST /api/resource/User), das Zuweisen der Rollen und das Erzeugen des Token-Paars (generate_keys) erfordert eine System-Manager-API-Credential. Der operative User-Key hat keine User-Anlage-Rechte. Daher muss eine separate Admin-API-Credential (admin_api_key/admin_api_secret) in erpnext.json hinterlegt sein. Fehlt sie, lehnt das Provisioning klar ab (kein stiller Fallback).

Sicherheit: Provisioning ist Stufe 1 vorbehalten. Der erzeugte Schlüssel

wird serverseitig gespeichert (chmod 600) und nie im Klartext angezeigt.