Microsoft Dynamics 365 Business Central Schnittstelle und API-Integration
Dynamics 365 Business Central ist das Cloud-ERP von Microsoft für kleine und mittlere Unternehmen, im Einsatz in mehr als 160 Ländern. Es deckt Finanzen, Lieferkette, Vertrieb, Projekte und Fertigung ab. Binden Sie es über Maesn an, und Sie erreichen es mit derselben REST API und demselben Datenmodell wie jedes andere unterstützte System.
Eine Business-Central-Anbindung in Tagen
Business Central wird in Schichten adressiert: Ihrer App wird im Microsoft-Entra-Verzeichnis des Kunden zugestimmt, und jede Anfrage nennt danach eine Umgebung und eine Firma darin. All das muss geklärt sein, bevor der erste Aufruf hinausgeht. Hier steht, was Maesn damit macht.
Beim Verbinden geklärt, immer dabei
Jede Business-Central-Anfrage nennt eine Umgebung und eine Firma. Maesn klärt beides, während Ihr Kunde sich verbindet, und hängt es von da an jede Anfrage, keines von beiden erreicht also Ihren Code, und die Entra-Zustimmung dahinter ist ein einmaliger Schritt und keine Frage je Anfrage.
Die Einrichtung läuft über uns
Eine Multitenant-Entra-App, zwei Berechtigungssätze, eine Admin-Zustimmung, dann noch ein Eintrag in Business Central selbst. Die App bleibt auf Ihr Unternehmen registriert, und Maesn geht jeden Schritt davon mit Ihnen durch.
Als ein gefilterter Lesezugriff zugestellt
Ändern sich mehrere Datensätze kurz hintereinander, sendet Business Central ein einzelnes Sammel-Event mit einem Zeitraum statt der IDs. Maesn leitet es in der üblichen Event-Form weiter, und dieser Zeitraum löst sich mit einem Listenaufruf auf.
In Ihrem Code kommen ein REST-Aufruf und ein Account-Key an. Teams gehen in Tagen live, und das System nach Business Central ist ein Konfigurationsschritt.
Ein kurzes Gespräch genügt meist, um zu klären, ob Maesn zu Ihrem Anwendungsfall passt.
Tipalti erreicht Business Central, ohne es zu bauen
Tipalti automatisiert den gesamten Kreditorenprozess, von der Lieferantenaufnahme bis zu weltweiten Zahlungen. Die Käufer im Mid-Market und im Enterprise-Segment erwarten tiefe Anbindungen an Systeme wie Business Central, und Tipalti kam zu dem Schluss, dass diese Schicht selbst zu bauen die falsche Stelle für Entwicklungszeit ist.
“Mit Maesn haben wir unsere europäische Expansion beschleunigt, weil komplexe ERP-Integrationen über Benelux und DACH hinweg reibungslos laufen. Für eine AP-Plattform ist verlässlicher Zugang zu den wichtigen lokalen ERP-Systemen entscheidend, und genau den gibt uns Maesn.”
Drei Gründe, die Business Central Schnittstelle über Maesn anzubinden
Eine Business-Central-Verbindung ist ein lösbares Problem. Die Kosten zeigen sich bei der fünfzigsten, verteilt über Umgebungen, Firmen und ein Client-Secret, das nach eigenem Zeitplan abläuft.
Die Plattformarbeit bleibt hier
Die Auswahl von Umgebung und Firma, das Abonnement, das Business Central alle drei Tage verfallen lässt, und die gebündelten Events, die ohne IDs ankommen. Jedes davon wird einmal gelöst, auf unserer Seite, für jeden Kunden, den Sie anbinden.
Die Drei-Tage-Uhr gehört uns
Ein Business-Central-Abonnement verfällt nach 72 Stunden, und es zu erneuern heißt, den Validierungs-Handshake von Microsoft erneut zu beantworten. Bei Business Central ist unsere URL registriert, Handshake und Erneuerung laufen also hier, und Ihr Endpunkt empfängt die Events.
Das nächste System kostet nichts
Sobald Business Central läuft, antwortet jedes andere unterstützte Buchhaltungs- und ERP-System auf derselben Schnittstelle. Ihre zweite Integration ist ein Konfigurationsschritt.
Business Central in Microsoft AppSource
Die meisten Anbieter hören bei der API auf. Maesn übernimmt die technische Seite und die Beziehung, und bei Business Central führt die zweite an einen bestimmten Ort: AppSource, den Marketplace von Microsoft für Business-Central-Apps, mit mehr als 5.000 gelisteten Lösungen.
Technische Unterstützung
Eine Integration gegen die Unified API und ein Datenmodell, identisch zu jedem anderen System, das Maesn unterstützt. Ihre Entwickler treffen hier auf dieselbe Schnittstelle wie beim nächsten System.
Unterstützung beim Eintrag
Microsoft prüft einen Eintrag technisch und kaufmännisch. Maesn geht beide Hälften mit Ihnen durch. Die Einreichung besteht die Prüfung damit beim ersten Mal.
Connect App ist der Eintragstyp
Eine Integration auf Maesn gilt als Connect App, der übliche AppSource-Typ für Integrationen von Drittanbietern.
Er läuft über das Partner Center
Der Eintrag wird im Microsoft Partner Center eingereicht und verwaltet, und dort läuft auch die Prüfung.
Die Reichweite folgt der Plattform
Ein Eintrag stellt Sie vor die weltweite Dynamics-365-Kundschaft, in mehr als 160 Ländern.
Der Eintrag läuft unter Ihrer Marke, nicht unter der von Maesn. Ihr Name ist das, was der Kunde beim Verbinden sieht.
Ein Eintrag ist ein Vertriebskanal und kein Abzeichen, und was er verlangt, ist je Anbieter verschieden. Unser Leitfaden zu Partnerschaften bei Buchhaltungsintegrationen geht die Marketplace-Anforderungen über die Systeme im Katalog hinweg durch.
Maesn bereitet den Eintrag parallel zu Ihrer Integration vor.
Ihre Entra-App, deren Mandant, einmal geklärt
Business Central authentifiziert über eine Microsoft-Entra-App, und die App, der Ihre Kunden zustimmen, ist Ihre und nicht die von Maesn. Das Eigene kommt nach der Zustimmung: Ein Mandant kann mehrere Umgebungen und mehrere Firmen halten, und eine Anfrage ist erst adressierbar, wenn beide bekannt sind.
- Microsoft-Entra-App
- Multitenant, von Ihnen registriert
Eine App, jeder Kunde. Maesn verwahrt die Zugangsdaten und klärt Umgebung und Firma dahinter.
- Der interaktive Ablauf
- Ihr Kunde wählt auf einer Auswahlseite eine Umgebung und eine Firma, und die Wahl wird bei der Verbindung gespeichert. Die Seite lässt sich an Ihr Produkt anpassen.
- Query-Parameter je Anfrage
- Lassen Sie die Auswahl weg, dann trägt jeder Aufruf den Namen der Umgebung und die Firmen-ID selbst. Zusätzlich zu einer gespeicherten Wahl gesendet, überschreiben sie diese, und genau so wechselt ein Kunde zu einer anderen Firma.
Eine Kombination sollten Sie vorher kennen: Der Weg, der den Account-Key als signierten Webhook statt als Redirect zurückgibt, unterstützt die interaktive Auswahl noch nicht. Umgebung und Firma reisen dort also als Query-Parameter mit.
- 1
Ihr Kunde startet in Ihrem Produkt
Sie schicken ihn in den Ablauf, und Maesn öffnet den Zustimmungsbildschirm von Microsoft. Er trägt den Namen Ihrer App, denn die App ist auf Ihr Unternehmen registriert. Die Verbindung liest sich also als Ihre und nicht als die eines Dritten.
- 2
Umgebung und Firma werden geklärt
Im interaktiven Ablauf landet Ihr Kunde auf einer Auswahlseite und wählt je eines aus. Maesn speichert beides bei der Verbindung, und Umgebungen und Firmen bleiben von da an voneinander getrennt.
- 3
Sie arbeiten mit einem Account-Key
Maesn speichert die Verbindung und gibt einen Account-Key zurück. Ab da trägt jede Anfrage Ihren API-Schlüssel und diesen Account-Key, dieselben zwei Header, die Sie für jedes andere System im Katalog ohnehin schon senden.
Jedes System im Katalog authentifiziert anders, und bei Business Central sind die Zugangsdaten die leichte Hälfte und die Adressierung nicht. Unified Authentication hält beides von Ihrer Seite fern: Der Redirect, der Auswahlschritt und die Art, wie Ihnen der Account-Key übergeben wird, sind dort konfigurierbar und identisch, ganz gleich, welches System ein Kunde anbindet.
Jedes Business-Central-Event, auch die ohne ID
Business Central sendet native Events, statt Sie nach Änderungen abfragen zu lassen, und es abonniert je Ressource. Eine Registrierung liefert dafür also jeden Event-Typ. Maesn registriert das Abonnement je angebundenem Kunden, erneuert es, bevor Business Central es ablaufen lässt, und vereinheitlicht die Nutzlasten, die Form, die Sie verarbeiten, ist damit bei jedem System identisch, das Sie anbinden.
Business Central abonniert je Ressource statt je Paar. Ein Abonnement liefert damit alle vier Event-Typen.
Collection ist der Event-Typ, für den Sie entwerfen sollten. Wenn sich mehrere Datensätze einer Ressource kurz hintereinander ändern, hält Business Central sie zurück und sendet ein einzelnes Event mit einem Zeitbereich statt der IDs. Maesn leitet es in der gewohnten Form mit diesem Bereich weiter, und Sie lösen es mit einem gefilterten Listenaufruf auf, statt die Filtersyntax von Business Central zu lernen. Events kommen in beiden Fällen als Array an, und das sollten Sie wissen, bevor Sie den Handler schreiben.
Business Central spricht sein eigenes Event-Vokabular, und deshalb läuft ein Event-Modell über den ganzen Katalog: Der Handler, den Sie für eine Business-Central-Rechnung schreiben, funktioniert weiter für ein System, das nichts sendet und darunter abgefragt werden muss.
Ein Sammel-Event löst sich über dasselbe Filtern und Paginieren auf, das Sie für einen Delta-Abruf ohnehin benutzen, der Bereich, den es trägt, braucht also keine Business-Central-eigene Abfrage, und was zurückkommt, liegt im gemeinsamen Common Data Model wie jede andere Rechnung, die Sie verarbeiten.
Was Business Central vorab verlangt
Business Central verlangt fünf Dinge, bevor eine Integration beginnt, und alle lassen sich leichter einplanen als auf halber Strecke entdecken.
- Ein Azure-Konto mit Administratorrechten
- Ein aktives Azure-Abonnement, ein Microsoft-Entra-Mandant und die Berechtigung Cloud Application Administrator für das Konto, von dem aus die App registriert wird.
- Ihre eigene Multitenant-Entra-App
- Sie registrieren sie in Microsoft Entra als Multitenant-Webanwendung, mit dem Callback von Maesn als Redirect-URL. Kopieren Sie den Wert des Client Secret in dem Moment, in dem Entra ihn anzeigt, denn danach ist er nicht mehr abrufbar, und merken Sie sich den Ablauf: standardmäßig sechs Monate, und bei jeder Rotation brauchen wir den neuen Wert.
- Zwei Berechtigungssätze und eine Admin-Zustimmung
- Ihre App braucht auf Dynamics 365 Business Central sowohl Anwendungs- als auch delegierte Berechtigungen, erteilt mit Admin-Zustimmung. Halten Sie die Scopes auf dem, was Sie wirklich nutzen: Der breite Entwicklungs-Scope erreicht jeden Endpunkt, und ihn im Produktivbetrieb anzufordern ist das, was Kunden am Zustimmungsbildschirm zögern lässt.
- Ein Schritt in Business Central selbst
- Ein Administrator trägt Ihre Client-ID in Business Central unter Microsoft Entra Applications ein. Die Azure-Seite allein schließt die Verbindung nicht ab, und das ist der Schritt, den Teams meist zuletzt finden.
- API-Setup-Vorlagen für alles, was Sie anlegen
- Ein POST schlägt fehl, solange Business Central für dieses Objekt keine Vorlage unter API Setup hält. Vorlagen füllen außerdem einige Pflichtfelder selbst, und die lassen sich nicht über die API setzen.
Wir gehen die Entra-Einrichtung und die Berechtigungen mit Ihnen durch.
