# Directus mit dem ERP verbinden: Was wir bei einer Business-Central-Anbindung gelernt haben

Erfahrungen aus einem laufenden Projekt: Directus mit Microsoft Dynamics 365 Business Central verbinden, ohne die Plattform zu gefährden. Fünf Lehren für Ihr Projekt.

Wer Directus mit einem ERP verbindet, sollte zuerst klären, welches System welche Daten führt. Danach gehört jede Erweiterung in ein eigenes Modul statt in den Kern von Directus. So haben wir es für eine Digitalagentur gemacht: über zehn neue Workflows in TypeScript und eine Anbindung an Microsoft Dynamics 365 Business Central, die stabil im Betrieb läuft.

Dieser Beitrag zeigt, wie das Projekt aufgebaut ist und was wir dabei gelernt haben.

## Die Ausgangslage

Eine Digitalagentur betreibt eine Plattform auf Directus. Directus ist eine Datenplattform, die sich über eine SQL-Datenbank legt. Sie bietet eine Oberfläche zur Pflege von Daten und eine API für andere Systeme. Mehr dazu im Beitrag [Headless CMS im Mittelstand](/blog/headless-cms-mittelstand/).

Über diese eine Plattform laufen mehrere Kundenprojekte gleichzeitig. Das hat einen unangenehmen Effekt: Jede Erweiterung für ein Projekt muss so gebaut sein, dass sie die anderen nicht beschädigt.

Dazu kam ein Problem im Alltag. Daten wurden von Hand zwischen der Plattform und Business Central übertragen. Business Central ist das ERP-System von Microsoft. Jede Übertragung von Hand kostete Zeit und war eine Quelle für Fehler.

## Was wir gebaut haben

- **Die Anbindung an Business Central.** Stammdaten werden nicht mehr doppelt gepflegt. Die Datenbrücke zwischen Directus und dem ERP läuft automatisch.
- **Über zehn neue Workflows.** Wir haben sie in TypeScript gebaut, als Erweiterungen von Directus.
- **Ein erweitertes Frontend.** Die Website der Plattform läuft mit Astro. Wir haben sie um die neuen Funktionen ergänzt.

Betrieben wird das Ganze über Kubernetes und Helm. Lokal läuft dieselbe Plattform über Docker Compose. Das Projekt läuft weiter, wir entwickeln die Plattform laufend fort. Mehr in der Referenz zur [ERP-Integration mit Directus](/referenzen/directus-erp-integration/).

## Fünf Lehren aus dem Projekt

### 1. Klären Sie zuerst, welches System welche Daten führt

Das Ziel einer ERP-Anbindung ist, dass Daten nur noch an einer Stelle gepflegt werden. Das klappt nur, wenn für jede Art von Daten feststeht, wo sie entstehen. Kundendaten und Preise kommen meist aus dem ERP. Texte, Bilder und Inhalte für die Website entstehen meist im CMS.

Schreiben Sie das vor dem ersten Code auf, als einfache Tabelle: Datenart, führendes System, Richtung des Abgleichs. Diese Tabelle erspart später viele Diskussionen.

### 2. Bauen Sie Erweiterungen, greifen Sie nicht in den Kern ein

Directus lässt sich über Erweiterungen ausbauen. Wir bauen neue Funktionen als Bundle-Erweiterungen in TypeScript, mit eigenen Endpunkten und Hooks. Ein Endpunkt ist eine eigene Adresse in der API. Ein Hook reagiert auf ein Ereignis, zum Beispiel wenn ein Datensatz gespeichert wird.

Der Kern von Directus bleibt dabei unberührt. Das hat zwei Vorteile: Updates von Directus lassen sich einspielen, ohne eigene Änderungen zu verlieren. Und jede Erweiterung lässt sich für sich testen und prüfen.

### 3. Auf einer geteilten Plattform zählt jede Änderung doppelt

Wenn mehrere Projekte auf einer Plattform laufen, trägt oder gefährdet jede Änderung die anderen. Ein guter Teil unserer Arbeit besteht deshalb aus Fehleranalyse und Reviews über alle Projekte hinweg. Bei geteilter Infrastruktur ist das die eigentliche Qualitätssicherung.

Für Sie heißt das: Planen Sie Zeit für Reviews ein. Eine Erweiterung ist erst fertig, wenn klar ist, dass sie nichts anderes stört.

### 4. Gleiche Umgebung lokal und im Betrieb

Bei uns läuft die Plattform lokal über Docker Compose und im Betrieb über Kubernetes mit Helm. Beide Wege beschreiben dieselben Dienste. So verhält sich eine Änderung auf dem Laptop eines Entwicklers so wie später im Betrieb.

Gerade bei einer ERP-Anbindung ist das wichtig. Fehler zeigen sich oft erst im Zusammenspiel der Systeme. Je näher die Testumgebung am Betrieb ist, desto früher sehen Sie sie.

### 5. Planen Sie ein, dass das ERP mal nicht antwortet

Jede Anbindung an ein anderes System kann ausfallen. Das ERP wird gewartet, ein Netzwerk hakt, ein Datensatz passt nicht. Legen Sie vorher fest, was dann passiert: Wird der Abgleich später wiederholt? Wer bekommt eine Meldung? Wo sehen Sie, welche Datensätze nicht übertragen wurden?

Eine Anbindung, die im Normalfall funktioniert, ist schnell gebaut. Eine Anbindung, die auch im Fehlerfall verlässlich ist, braucht diese Fragen.

## Was das Projekt bringt

Die Datenbrücke zwischen Directus und Business Central ersetzt die Übertragung von Hand. Damit fallen eine Arbeit und eine Fehlerquelle weg. Die Plattform hat über zehn neue Workflows bekommen, und die ERP-Anbindung läuft stabil im Betrieb.

Die Lehren gelten nicht nur für Business Central. Sie passen auf jede Anbindung von Directus an ein ERP, ein CRM oder ein anderes Fachsystem.

## Häufige Fragen

**Geht das auch mit einem anderen ERP?**
Ja. Business Central und viele andere ERP-Systeme bieten Schnittstellen, über die andere Systeme Daten lesen und schreiben. Der Weg ist ähnlich: führendes System klären, Erweiterung bauen, Fehlerfälle planen.

**Wie lange dauert eine Anbindung?**
Das hängt vor allem an der Zahl der Datenarten und an der Schnittstelle des ERP. Eine erste Anbindung lässt sich meist als MVP umsetzen. Bei uns gibt es ein MVP ab 8.000 €.

**Brauchen wir dafür eine Directus-Lizenz?**
Ab einer bestimmten Unternehmensgröße braucht der Einsatz von Directus eine kommerzielle Lizenz. Wir klären das mit Ihnen und vermitteln die Lizenz als Partner.

## Der nächste Schritt

Sie wollen Directus mit Ihrem ERP verbinden? Im kostenlosen Erstgespräch klären wir, welche Daten fließen sollen und was das kostet. Mehr über unsere Arbeit steht auf der Seite [Directus-Agentur](/directus-agentur/). Oder [schreiben Sie uns direkt](/kontakt/).

Quelle: https://camsol.io/blog/directus-erp-anbindung/
