Dolibarr ERP/CRM ist eine leistungsstarke Open-Source-Plattform, die für ihre Flexibilität und die große Auswahl an integrierten Business-Management-Tools bekannt ist. Obwohl Dolibarr grundlegende CRM-Funktionen bietet, kann die Integration mit externen CRM-Systemen wie HubSpot, Zoho CRM oder Salesforce für Unternehmen sinnvoll – oder sogar notwendig – sein, um Marketingautomatisierung, Kundenbindung oder Reporting zu verbessern. Diese Anleitung erklärt, wie Sie Dolibarr mit externen CRMs synchronisieren, ohne auf teure Plugins oder proprietäre Middleware angewiesen zu sein.

Inhaltsverzeichnis

  1. Warum Dolibarr mit einem externen CRM synchronisieren?

  2. Übersicht über beliebte externe CRMs

  3. Integrationsmethoden: Direkte API, Middleware und benutzerdefinierte Skripte

  4. Voraussetzungen und Vorbereitungen

  5. Die API-Struktur von Dolibarr verstehen

  6. Übersicht über die APIs von HubSpot, Zoho und Salesforce

  7. Auswählen, was synchronisiert werden soll (Leads, Kontakte, Deals, Rechnungen)

  8. Einrichten des API-Zugriffs auf Dolibarr

  9. Einrichten des API-Zugriffs auf das externe CRM

  10. Zuordnen von Datenfeldern zwischen Systemen

  11. Erstellen eines Synchronisierungsskripts (PHP/Python)

  12. Sicherer Umgang mit Authentifizierung und Token

  13. Automatisieren der Synchronisierung mit Cron-Jobs oder Webhooks

  14. Fehlerbehandlung und Datenkonfliktlösung

  15. Abschließende Gedanken und Best Practices

1. Warum Dolibarr mit einem externen CRM synchronisieren?

Während Dolibarr CRM-Grundlagen wie Drittanbieterverwaltung, Aufgaben und Angebote übernimmt, bieten externe CRMs spezialisierte Tools wie:

  • Marketing-Automatisierung (E-Mail-Kampagnen, Lead Nurturing)

  • Vertriebspipelines und erweiterte Prognosen

  • Integrierte Telefonie- oder Chatbot-Integrationen

  • Verbesserte Dashboards und Analysen

Durch die Synchronisierung wird sichergestellt, dass beide Systeme synchron bleiben und die doppelte Dateneingabe reduziert wird.

2. Übersicht über beliebte externe CRMs

Hier ein kurzer Überblick über einige externe CRM-Optionen, die Sie in Dolibarr integrieren könnten:

  • HubSpot: Inbound-Marketing, Formulare, E-Mail und Automatisierung

  • Zoho CRM: Leistungsstarkes Kontaktmanagement, Lead-Tracking und Berichte

  • Salesforce: CRM der Unternehmensklasse mit umfassender Anpassung

  • Pipedrive: Fokussiert auf Einfachheit und visuelle Pipelines

  • Freshsales: KI-basiertes Scoring und Telefonintegration

Alle unterstützen APIs zur Integration.

3. Integrationsmethoden: Direkte API, Middleware und benutzerdefinierte Skripte

Drei allgemeine Möglichkeiten, Dolibarr mit externen CRMs zu synchronisieren:

  • Direkte API-Integration: Verwenden Sie beide APIs, um eine Brücke zu bauen

  • Middleware-Plattformen: Verwenden Sie Open-Source-Tools wie n8n oder Integromat (kostenlose Stufe)

  • Benutzerdefinierte Synchronisierungsskripte: Ideal für volle Kontrolle und kostenbewusste Setups

Dieser Leitfaden konzentriert sich auf die direkte API-Integration mithilfe benutzerdefinierter Skripts.

4. Voraussetzungen und Vorbereitungen

Bevor Sie beginnen:

  • Stellen Sie sicher, dass Sie Dolibarr mit aktiviertem API-Modul haben (vorzugsweise Version 9.0+).

  • Erstellen Sie ein externes CRM-Konto oder greifen Sie darauf mit API-Berechtigungen zu

  • Verwenden Sie einen Server oder eine Umgebung für die Entwicklung (lokal oder remote).

  • Wählen Sie eine Skriptsprache (PHP, Python, Node.js)

Außerdem:

  • Sichern Sie beide Systeme

  • Listen Sie die zu synchronisierenden Daten auf: Dritte, Kontakte, Angebote usw.

5. Die API-Struktur von Dolibarr verstehen

Die REST-API von Dolibarr unterstützt die meisten Kernmodule:

  • Drittparteien: /thirdparties

  • Kontakte: /contacts

  • Bestellungen: /orders

  • Rechnungen: /invoices

Zugriffsformat:

https://yourdolibarr.com/api/index.php/thirdparties?DOLAPIKEY=your_key

Die Antwort ist JSON. Verwenden Sie je nach Vorgang GET/POST/PUT.

6. Übersicht über die APIs von HubSpot, Zoho und Salesforce

HubSpot

  • Standort: https://api.hubapi.com/

  • Authentifizierung: OAuth2 oder API-Schlüssel (wird bald verworfen)

  • Gemeinsame Endpunkte: /contacts/v1, /deals/v1, /companies/v2

Zoho

  • Standort: https://www.zohoapis.com/crm/v2/

  • OAuth2 erforderlich

  • Unterstützt Module wie Leads, Kontakte, Deals

Salesforce

  • Verwendet REST-API über OAuth2

  • Erfordert eine registrierte App mit Client-Geheimnis

  • REST-Basis: https://instance.salesforce.com/services/data/vXX.0/

7. Auswählen, was synchronisiert werden soll (Leads, Kontakte, Deals, Rechnungen)

Definieren Sie Ihren Synchronisierungsbereich:

  • Von Dolibarr zu CRM: Kontakte, Firmen, Rechnungen

  • Von CRM zu Dolibarr: Leads, marketingqualifizierte Kontakte

  • Richtung festlegen (uni- oder bidirektional)

Die Zuordnung sollte eindeutig sein und in einer Konfigurationsdatei oder Datenbank gespeichert werden.

8. Einrichten des API-Zugriffs auf Dolibarr

  1. Aktivieren Sie die API-Modul vom Dolibarr-Administrator

  2. Generieren Sie den API-Schlüssel für den Integrationsbenutzer

  3. Erteilen Sie Berechtigungen für erforderliche Module

  4. Testen Sie den API-Zugriff mit curl oder Postman:

curl https://yourdolibarr.com/api/index.php/thirdparties?DOLAPIKEY=your_key

9. Einrichten des API-Zugriffs auf das externe CRM

Befolgen Sie die Anweisungen im Entwicklerhandbuch des CRM, um:

  • Erstellen einer App/eines Clients (für OAuth2)

  • Abrufen der Client-ID und des Geheimnisses

  • Festlegen von Bereichen und Umleiten von URIs

  • Testen Sie mit dem API-Explorer oder curl

Bewahren Sie die Zugriffs- und Aktualisierungstoken sicher auf.

10. Datenfelder zwischen Systemen zuordnen

Ejemplo:

Dolibarr-Feld HubSpot-Feld
name company
email email
phone phone
note_private notes
date_creation createdate

Verwenden Sie Arrays oder Wörterbücher in Ihrem Skript, um diese Zuordnung zu verwalten.

11. Erstellen eines Synchronisierungsskripts (PHP/Python)

Beispiel in Python (Kontakte synchronisieren):

import requests

# Get Dolibarr contacts
dol_url = "https://yourdolibarr.com/api/index.php/contacts?DOLAPIKEY=your_key"
dolibarr_contacts = requests.get(dol_url).json()

# Send to HubSpot
hubspot_url = "https://api.hubapi.com/contacts/v1/contact/"
headers = {"Authorization": "Bearer YOUR_ACCESS_TOKEN"}

for contact in dolibarr_contacts:
    data = {
        "properties": [
            {"property": "email", "value": contact['email']},
            {"property": "firstname", "value": contact['firstname']},
        ]
    }
    requests.post(hubspot_url, json=data, headers=headers)

12. Sicherer Umgang mit Authentifizierung und Token

  • Geben Sie Anmeldeinformationen niemals fest ein

  • Nutzen Sie .env Dateien oder Umgebungsvariablen

  • Token regelmäßig aktualisieren

  • Festlegen von Token-Ablaufwarnungen

Erwägen Sie die Verwendung von Token-Verwaltungsbibliotheken oder -Paketen.

13. Automatisieren der Synchronisierung mit Cron-Jobs oder Webhooks

  • Verwenden Sie Cron, um regelmäßige Synchronisierungen zu planen (z. B. alle 15 Minuten).

  • Verwenden Sie Webhooks, um sofort auf Änderungen zu reagieren (sofern CRM dies unterstützt).

Beispiel für einen Cron-Job:

*/15 * * * * /usr/bin/python3 /path/sync_contacts.py

14. Fehlerbehandlung und Datenkonfliktlösung

Behandeln Sie Fehler wie:

  • 401 Nicht autorisiert (Token abgelaufen)

  • 400 Ungültige Anfrage (fehlende Felder)

  • 429 Zu viele Anfragen (Ratenbegrenzungen)

Behandeln Sie außerdem:

  • Doppelte Datensätze

  • Widersprüchliche Updates

  • Soft Deletes oder Archivierung

Protokollieren Sie jeden Synchronisierungslauf mit einem Zeitstempel und Ergebnis.

15. Abschließende Gedanken und bewährte Vorgehensweisen

Durch die Verbindung von Dolibarr mit einem externen CRM verschafft Ihr Unternehmen einen strategischen Vorteil, indem es die ERP-Leistung von Dolibarr mit fortschrittlichen Marketing- und Vertriebstools kombiniert.

Empfohlene Vorgehensweise:

  • Beginnen Sie mit der unidirektionalen Synchronisierung, bevor Sie zur bidirektionalen Synchronisierung übergehen

  • Vor der Automatisierung gründlich testen

  • Pflegen Sie die Dokumentation der API-Nutzung und Feldzuordnungen

  • Sichern Sie die Anmeldeinformationen und wechseln Sie sie regelmäßig

  • Verwenden Sie Staging-Umgebungen für neue Funktionen