Microsoft Dynamics 365 Business Central wird in drei grundlegenden Betriebsmodellen eingesetzt, die unterschiedliche Anforderungen an die Anbindung des Hivebuy Connectors stellen.
Business Central SaaS (Cloud)
In der Standard-Cloud-Variante betreibt Microsoft Business Central als vollständig verwalteten SaaS-Dienst. Die Business Central APIs (OData v4 / REST) sind über öffentlich erreichbare HTTPS-Endpunkte zugänglich und durch OAuth 2.0 (Azure AD / Entra ID) abgesichert. Der Hivebuy Connector kann diese Endpunkte direkt ansprechen, ohne zusätzliche Netzwerkinfrastruktur auf Kundenseite. Dies ist das häufigste Deployment-Modell und weist die geringste Integrationsaufwand auf.
Business Central Private Cloud / Dedicated Hosting
Bei dediziertem Cloud-Hosting (z. B. über einen Managed-Service-Partner oder eine isolierte Azure-Umgebung) ist Business Central nicht zwingend über das öffentliche Internet erreichbar. Die Anbindung des Hivebuy Connectors erfordert in diesem Fall eine gesicherte Netzwerkverbindung, z. B. über VPN-Tunneling, Azure Private Link oder IP-Whitelisting auf Firewallebene. Die API-Struktur ist technisch identisch zur SaaS-Variante, der Zugang wird jedoch auf Infrastrukturebene kontrolliert.
Business Central On-Premise
Bei einer On-Premise-Installation betreibt der Kunde Business Central vollständig in seinem eigenen Rechenzentrum. Die APIs sind ausschließlich intern erreichbar. Zur Anbindung des Hivebuy Connectors ist zwingend ein On-Premise-Agent oder ein API-Proxy (z. B. in einer DMZ) erforderlich, der eine ausgehende, verschlüsselte HTTPS-Verbindung zum Hivebuy Connector aufbaut. Eingehende Firewall-Ports müssen dabei nicht geöffnet werden. Zusätzlich ist zu beachten, dass die On-Premise-Version von Business Central eine eigene Authentifizierungskonfiguration erfordert (z. B. Windows Authentication oder NavUserPassword statt OAuth).
| Merkmal | SaaS (Cloud) | Private Cloud | On-Premise |
|---|---|---|---|
| Betrieb | Microsoft-managed | Partner/Kunde, cloud-gehostet | Kundenbetrieb, eigenes RZ |
| API-Erreichbarkeit | Öffentliches Internet (HTTPS) | Privates Netzwerk / VPN | Nur intern / LAN |
| Authentifizierung | OAuth 2.0 (Azure AD / Entra ID) | OAuth 2.0 / VPN-gesichert | Windows Auth / NavUserPassword |
| Konnektivität zum Hivebuy Connector | Direkt via HTTPS | VPN / Private Link / Whitelisting | On-Premise-Agent / API-Proxy |
| Zusätzliche Infrastruktur | Keine | Netzwerkkonfiguration | Agent-Installation erforderlich |
| Komplexität der Anbindung | Gering | Mittel | Hoch |
Die Integration zwischen Hivebuy und Microsoft Dynamics 365 Business Central wird über den Hivebuy Connector realisiert. Die Anbindung ist bidirektional und umfasst zwei eigenständige Integrationspfade: die ereignisgesteuerte Übertragung von Bestellungen aus Hivebuy nach Business Central (Real-time) sowie die periodische Synchronisation von Stammdaten (Lieferanten, Projekte/Kostenstellen) aus Business Central zurück nach Hivebuy (Scheduled). Die Kommunikation mit Business Central erfolgt über die Microsoft Dynamics Business Central API (Custom- und Standard-Endpunkte).
Trigger (Schritt 1) – Ereignisempfang via HTTP-Webhook (Real-time)
Der Hivebuy Connector empfängt eingehende HTTP-Webhook-Events von Hivebuy in Echtzeit. Der Prozess wird ausgelöst, sobald eine neue Bestellung angelegt oder eine bestehende erneut zur Verarbeitung übergeben wird (order.created, order.resent).
Schritt 2 – Filterung nach Legal Entity
Direkt nach dem Trigger prüft der Connector, welche rechtliche Einheit (Legal Entity Identifier) der Bestellung zugeordnet ist. Nur Bestellungen, die einer der konfigurierten Unternehmensidentifikatoren entsprechen (z. B. EVBE, STBE, ECBE, KGBE), werden weiterverarbeitet. Dies ermöglicht eine mandantenfähige Steuerung innerhalb derselben Integration und stellt sicher, dass jede Bestellung an den korrekten Business-Central-Mandanten weitergeleitet wird.