Mitarbeitersynchronisierung zwischen biz.Suite (CRM) und Business Central (ERP)
Diese Dokumentation beschreibt die Einrichtung und Funktionsweise der Mitarbeitersynchronisierung zwischen dem CRM-System biz.Suite und dem ERP-System Microsoft Dynamics 365 Business Central. Ziel ist es, Mitarbeiterdaten konsistent und automatisiert zwischen beiden Systemen auszutauschen.
1. Einrichtung der Mitarbeitersynchronisierung
Für die Synchronisierung müssen in Business Central die korrekten Einstellungen zur Verbindung mit biz.Suite hinterlegt werden.
1.1 Konfiguration der Verbindung
Folgende Felder müssen korrekt ausgefüllt werden:
A. Name
Beispiel: Mitarbeiter
B. Typ
Auswahl: Mitarbeiter
C. URL
Eintrag der API-Endpoint-URL von biz.Suite:
https://{BASE_URL}/api/v2/workers
D. BS-Token
Ein gültiges API-Token für biz.Suite muss hinterlegt werden.
2. Feldmapping zwischen Business Central und biz.Suite
Die folgende Tabelle zeigt, wie die Mitarbeiterdaten zwischen den beiden Systemen gemappt/synchronisiert werden.
| Entität | Endpunkt | Feld BC | Feld biz.Suite |
|---|---|---|---|
| Employee | workers | First Name | party.firstname |
| Employee | workers | Last Name | party.name |
| Employee | workers | party.primary_email_address | |
| Employee | workers | Phone No. | party.primary_phone_number |
| Employee | party | electronicaddresslinks.electronicaddress.value | |
| Employee | party | Phone No. | electronicaddresslinks.electronicaddress.value |
| Employee | party | Post Code | addresslinks.address.zipecode |
| Employee | party | Address | addresslinks.address.street |
| Employee | party | City | addresslinks.address.city |
| Employee | workers | No. | personelnumber |
| Employee | workers | No. | externalworkernumber |
| Employee | workers | Gender | gender |
| Employee | workers | Employment Date | employment_start_date |
| Employee | workers | Termination Date | employment_end_date |
3. Automatisches Erstellen und Aktualisieren von Mitarbeitern
Um Mitarbeiterdaten automatisiert zwischen den Systemen zu synchronisieren, müssen in Business Central Jobs (Aufgabenwarteschlangen) eingerichtet werden.
3.1 Einrichten eines Jobs
- Öffnen der Seite Aufgabenwarteschlangenposten.
- Klick auf Neu.
- Auswahl einer Codeunit als Art des auszuführenden Objekts.
- Festlegen von Job ID und weiteren Parametern.
4. Verwendete Job-Codeunits
Die folgenden Codeunits steuern den Datenaustausch zwischen den Systemen.
4.1 Neue Mitarbeiter erstellen (BC → biz.Suite)
- ID: 91338
- Name: QS_bs_PostWorker
4.2 Mitarbeiter aktualisieren (BC → biz.Suite)
- ID: 91348
- Name: QSBSUpdateWorker
4.3 Mitarbeiter synchronisieren (biz.Suite → BC)
- ID: 91379
- Name: QS_SyncWorkerFromBizToBC
5. Zusammenfassung
Die Synchronisierung zwischen biz.Suite und Business Central basiert auf:
- korrekt eingerichteten API-Verbindungen,
- einem definierten Feldmapping,
- und automatisierten Jobs zur Erstellung, Aktualisierung und Synchronisierung von Mitarbeiterdaten.
Diese Konfiguration stellt sicher, dass beide Systeme konsistente und aktuelle Mitarbeiterinformationen verwenden.
Wenn Ergänzungen oder grafische Beispiele gewünscht sind, kann die Dokumentation erweitert werden.