Inhaltsverzeichnis

  1. Einführung

  2. Grundlegendes zur Dolibarr REST-API

  3. Warum Zapier mit Dolibarr verwenden?

  4. Erste Schritte: Voraussetzungen für die Integration

  5. Einrichten des API-Zugriffs in Dolibarr

  6. Erstellen Ihres ersten API-Tokens

  7. Zapier und seine Rolle bei der Automatisierung verstehen

  8. Schritt für Schritt: Dolibarr mit Zapier verbinden

  9. Beispiel 1: Erstellen eines neuen Dolibarr-Kontakts aus Google Sheets

  10. Beispiel 2: Erstellen einer Rechnung aus einer WooCommerce-Bestellung

  11. Beispiel 3: Erstellen einer neuen Aufgabe in Dolibarr aus einer Formularübermittlung

  12. Beispiel 4: Protokollieren der E-Mail-Aktivität bei Dolibarr-Drittanbietern

  13. Beispiel 5: Automatische Aktualisierung der Lagerbestände aus einem CSV-Upload

  14. Erweiterte API-Techniken mit Zapier-Webhooks

  15. Zuordnen von Datenfeldern zwischen Zapier und Dolibarr

  16. Sicherer Umgang mit Authentifizierung und Sicherheit

  17. Überwachen und Debuggen Ihrer Integrationen

  18. Ratenbegrenzungen und bewährte Methoden für API-Aufrufe

  19. Alternative Tools zu Zapier für die Dolibarr-Automatisierung

  20. Fazit und nächste Schritte

1. Einleitung

Enterprise-Resource-Planning-Systeme wie Dolibarr sind unglaublich leistungsstark, wenn sie mit anderen Tools Ihres digitalen Ökosystems verbunden werden. Zapier, eine No-Code-Automatisierungsplattform, ermöglicht Unternehmen die Erstellung automatisierter Workflows (sogenannte Zaps) zwischen Dolibarr und über 5,000 anderen Anwendungen. Dank der REST-API von Dolibarr sind die Möglichkeiten nahezu unbegrenzt.

In diesem umfassenden Handbuch wird die Verwendung der Dolibarr REST-API mit Zapier erläutert. Es bietet umsetzbare Beispiele, mit denen Sie Zeit sparen, die manuelle Dateneingabe reduzieren und die Betriebseffizienz verbessern können.

2. Die Dolibarr REST API verstehen

Dolibarr bietet eine RESTful-API für die Interaktion mit allen wichtigen Komponenten des ERP-Systems, wie zum Beispiel:

  • Dritte (Unternehmen, Kunden, Lieferanten)

  • Kontakt

  • Produkte und Dienstleistungen

  • Bestellungen, Angebote und Rechnungen

  • Projekte und Aufgaben

  • Bestände, Lager und Sendungen

Diese API verwendet standardmäßige HTTP-Methoden (GET, POST, PUT, DELETE) und gibt Daten normalerweise im JSON-Format zurück.

3. Warum Zapier mit Dolibarr verwenden?

Zapier unterstützt auch Nicht-Entwickler bei der Automatisierung von Workflows zwischen Apps. Es ist besonders nützlich für:

  • Sich wiederholende Aufgaben automatisieren

  • Erstellen von Workflows über verschiedene Tools hinweg (z. B. CRM, E-Commerce, Marketing)

  • Spart Entwicklerzeit und reduziert Integrationskosten

Dolibarr ist keine native Zapier-App, aber mit Webhooks und benutzerdefinierten API-Anfragen können Sie dennoch tiefe Integrationen erreichen.

4. Erste Schritte: Voraussetzungen für die Integration

Bevor Sie Zapier mit Dolibarr verbinden, stellen Sie sicher, dass Sie Folgendes haben:

  • Dolibarr Version 9.0 oder höher (v15+ empfohlen)

  • API-Modul in Dolibarr aktiviert

  • Ein Zapier-Konto (kostenlos oder kostenpflichtig)

  • HTTPS-fähige Dolibarr-Installation

  • Grundlegende Kenntnisse mit REST-APIs und JSON-Formatierung

5. Einrichten des API-Zugriffs in Dolibarr

  1. Melden Sie sich als Administrator bei Dolibarr an

  2. Gehen Sie zu Home > Setup > Module > Webdienste (REST-API)

  3. Aktivieren Sie das Modul

  4. Generieren Sie einen API-Schlüssel für einen Benutzer (vorzugsweise mit eingeschränkten Berechtigungen).

Die API-URL-Struktur ist normalerweise: https://yourdomain.com/api/index.php/

6. Erstellen Ihres ersten API-Tokens

  1. Gehen Sie zu Benutzer & Gruppen > Benutzer auswählen > Registerkarte API-Schlüssel

  2. Klicken Sie auf „API-Schlüssel erstellen“

  3. Bewahren Sie den Schlüssel sicher auf

Dieses Token wird für alle von Zapier gestellten HTTP-Anfragen verwendet.

7. Zapier und seine Rolle in der Automatisierung verstehen

Zapier löst bei einem Ereignis eine Aktion aus. Jeder Zap enthält:

  • Ein Auslöser (z. B. eine neue Zeile in Google Tabellen)

  • Eine oder mehrere Aktionen (z. B. einen Kontakt in Dolibarr erstellen)

Sie verwenden die App „Webhooks by Zapier“, um eine Verbindung mit der API von Dolibarr herzustellen.

8. Schritt für Schritt: Dolibarr mit Zapier verbinden

  1. Einen neuen Zap erstellen

  2. Wählen Sie Ihre Trigger-App (z. B. Google Forms, Gmail)

  3. Fügen Sie eine Aktion hinzu: Webhooks von Zapier > Benutzerdefinierte Anfrage

  4. Set-Methode: POST (zum Erstellen von Datensätzen)

  5. Fügen Sie die Dolibarr-API-URL hinzu (z. B. .../thirdparties)

  6. Überschriften hinzufügen:

    • DOLAPIKEY: your_api_key

    • Content-Type: application/json

  7. Geben Sie im Textkörper Ihre JSON-Nutzlast ein

9. Beispiel 1: Erstellen eines neuen Dolibarr-Kontakts aus Google Sheets

Auslöser: Neue Zeile in Google Tabellen. Aktion:

  • Webhook POST an /contacts

  • Verwenden Sie Werte aus der Tabelle, um Name, E-Mail und Telefonnummer einzutragen.

Dieses Setup ermöglicht das automatische Hinzufügen von über Formulare gesammelten Leads.

10. Beispiel 2: Erstellen einer Rechnung aus einer WooCommerce-Bestellung

Auslöser: Neue WooCommerce-Bestellung. Aktion:

  • POST-Anfrage an /invoices

  • Fügen Sie Einzelposten, Kunden-ID, Gesamtbetrag und Steuerinformationen ein

Rechnungen können bei Bedarf mithilfe einer nachfolgenden PUT-Anfrage automatisch validiert werden.

11. Beispiel 3: Erstellen einer neuen Aufgabe in Dolibarr aus einer Formularübermittlung

Auslöser: Neuer Eintrag in Typeform Aktion:

  • POST an /projects/tasks

  • Geben Sie Titel, Projekt-ID, Dauer und zugewiesenen Benutzer an

Nützlich für die Automatisierung interner Arbeitsabläufe anhand von Benutzereingaben.

12. Beispiel 4: Protokollieren der E-Mail-Aktivität bei Dolibarr-Drittanbietern

Auslöser: Neue E-Mail in Gmail mit dem Label „Kunde“. Aktion:

  • POST an /thirdparties/note

  • E-Mail-Text als öffentliche oder private Notiz zu einem Drittanbieter-Datensatz hinzufügen

13. Beispiel 5: Automatische Aktualisierung der Lagerbestände aus einem CSV-Upload

Auslöser: Neue Datei in Google Drive oder Dropbox. Aktion:

  • Verwenden Sie den Zapier-Codeschritt, um CSV zu analysieren

  • Senden Sie mehrere PUT-Anfragen an /products/{id} um den Bestand zu aktualisieren

14. Erweiterte API-Techniken mit Zapier-Webhooks

Du kannst auch:

  • Verketten Sie Aktionen mit Zapier-Pfaden

  • Verwenden Sie Filter zum bedingten Erstellen bzw. Aktualisieren

  • Verzögerungen zwischen den Schritten festlegen

15. Datenfelder zwischen Zapier und Dolibarr zuordnen

Verwenden Sie die Feldzuordnungs-Benutzeroberfläche von Zapier, um Formulareingaben oder Tabellenspalten mit API-JSON-Schlüsseln zu verknüpfen. Achten Sie stets darauf:

  • Die Daten sind im richtigen Format (JJJJ-MM-TT)

  • Währungsfelder verwenden Dezimalstellen

  • IDs stimmen mit Dolibarr-Datensätzen überein (z. B. Kunden-ID, Produkt-ID)

16. Sicherer Umgang mit Authentifizierung und Sicherheit

  • Verwenden Sie immer HTTPS für Ihre Dolibarr-Instanz

  • Beschränken Sie API-Benutzer auf die erforderlichen Berechtigungen

  • Schlüssel regelmäßig neu generieren

  • Verwenden Sie die integrierten Sicherheitsfunktionen von Zapier, um vertrauliche Daten zu maskieren

17. Überwachung und Fehlerbehebung Ihrer Integrationen

  • Überprüfen Sie den Zapier-Aufgabenverlauf für jede Ausführung

  • Fehler in Dolibarr protokollieren (bei Bedarf benutzerdefinierte Protokollierung verwenden)

  • Vor dem Livegang eine Testumgebung nutzen

18. Ratenbegrenzungen und Best Practices für API-Aufrufe

Dolibarr kann je nach Serverkonfiguration Anruflimits erzwingen:

  • Vermeiden Sie die Stapelverarbeitung großer Datensätze ohne Verzögerungsschritte

  • Verwenden Sie die Paginierung für GET-Anfragen

  • Zwischenspeichern Sie Daten nach Möglichkeit lokal

19. Alternative Tools zu Zapier für die Dolibarr-Automatisierung

  • Integromat (Make.com)

  • n8n (selbstgehostete Automatisierung)

  • Pabbly Connect

  • Benutzerdefinierte Skripte mit Node.js oder Python + Dolibarr API

Jedes hat seine Stärken, insbesondere bei komplexen Arbeitsabläufen oder selbst gehosteten Lösungen.

20. Fazit und nächste Schritte

Die Integration von Dolibarr mit Zapier eröffnet leistungsstarke Automatisierungsmöglichkeiten, ohne dass komplexer Code geschrieben werden muss. Von Lead-Management und Rechnungsstellung bis hin zu Bestandsaktualisierungen und Aufgabenautomatisierung kann die Kombination aus Dolibarrs REST-API und Zapiers Workflow-Engine die Geschäftseffizienz erheblich steigern.

Für beste Ergebnisse:

  • Beginnen Sie mit einfachen Zaps

  • Überwachen und optimieren Sie Ihre API-Nutzung

  • Erweitern Sie, während sich Ihre Prozesse weiterentwickeln

Sobald Sie diese Arbeitsabläufe beherrschen, verschaffen Sie sich mit einem schlanken, automatisierten ERP-System, das auf Ihre individuellen Abläufe zugeschnitten ist, einen Wettbewerbsvorteil.