Wie synchronisiere ich Kontakte mit Microsoft Business Central?

Übersicht

Die Microsoft-Business-Central-Integration synchronisiert Kontakte und Firmen aus Business Central als Quelle, d.h. sync.blue® schreibt niemals etwas zurück.

Schritt 1: App-Registrierung in Microsoft Entra ID anlegen

sync.blue® meldet sich bei Business Central als Anwendung an. Dafür benötigt man zunächst eine App-Registrierung in Microsoft Entra ID.

1. Öffne das Microsoft Entra Admin Center und gehe zu App-Registrierungen → Neue Registrierung.
   
    
2. Vergebe einen Namen wie „sync.blue® Business Central“.
   
3. Kopiere auf der Übersicht-Seite der App:
   • Verzeichnis-ID (Mandant)
   • Anwendungs-ID (Client)
     
     
4. Gehe zu Zertifikate & Geheimnisse → Neuer geheimer Clientschlüssel. Wähle eine Beschreibung und eine Gültigkeitsdauer und klicke auf Hinzufügen.
   
5. Kopiere den Wert des Geheimnisses. Dieser wird nur einmal angezeigt.
   
6. Gehe zu API-Berechtigungen → Berechtigung hinzufügen → Dynamics 365 Business Central.

7. Wähle Anwendungsberechtigungen (nicht „Delegiert“), setze den Haken bei API.ReadWrite.All und klicke auf Berechtigungen hinzufügen.

   

8. Klicke auf Administratorzustimmung für <Ihre Organisation> erteilen und bestätige diese. Unter Status muss ein grünes Häkchen erscheinen.

Trotz des Namens ist API.ReadWrite.All die Standard-Anwendungsberechtigung für die Business-Central-API. sync.blue® liest darüber ausschließlich Daten.

Wichtig: Geheime Clientschlüssel laufen ab. Notiere das Ablaufdatum und erstelle rechtzeitig einen neuen Schlüssel.

Schritt 2: App in Business Central registrieren

Die Entra-Berechtigung aus Schritt 1 erlaubt der App nur, die Business-Central-API aufzurufen. Zugriff auf Daten gewährt diese nicht. Dafür muss die App zusätzlich in Business Central registriert werden und einen Berechtigungssatz erhalten.

1. Öffne in Business Central über die Suche (Lupe oder Alt+Q) die Seite Microsoft Entra Anwendungen.
2. Klicke auf Neu, um einen neuen Eintrag anzulegen.
3. Füge die Anwendungs-ID (Client) aus Schritt 1 in das Feld Client-ID ein und vergebe eine Beschreibung wie „sync.blue“.
4. Setze den Status auf Aktiviert und bestätige den Zustimmungsdialog.
5. Füge auf derselben Karte unter Benutzerberechtigungssätze z.B. den Berechtigungssatz D365 BASIC hinzu.

Schritt 3: Business Central in sync.blue® verbinden

1. Lege in sync.blue® ein neue Verbindung an und wähle als Quelle Microsoft Business Central.
2. Wähle die gewünschte App, welches als Ziel genutzt werden soll.
3. Fülle die folgenden Felder aus und klicke auf Speichern und testen.