Überblick & Anbindung (S2S/OAuth)

Überblick & Anbindung (S2S/OAuth)

Die Azure Function DpdTrackingPush verarbeitet DPD-Statusdaten und schreibt sie über die Business-Central-OData-v4-API zurück. Dazu ist eine einmalige Service-to-Service-Anbindung (OAuth) nötig.

Architektur

BC-API-Endpunkte

Diese Endpunkte hinterlegen Sie in der Azure Function (Platzhalter ersetzen):

https://<env>.api.businesscentral.dynamics.com/v2.0/<company>/api/solutioo/dpd/v1.0/companies(<companyId>)/trackingEvents
https://<env>.api.businesscentral.dynamics.com/v2.0/<company>/api/solutioo/dpd/v1.0/companies(<companyId>)/proofOfDeliveries

Einmalige Anbindung

1

Entra App-Registrierung

Eine App-Registrierung anlegen (z. B. „DPD Tracking Push (BC S2S)") und ein Client-Secret erzeugen. Client-ID und Secret in die App-Settings der Function eintragen.

2

S2S in Business Central freischalten

In BC Microsoft Entra-Anwendungen öffnen, die Client-ID eintragen, Status = Aktiviert und den Berechtigungssatz SOUDPDConnector (oder D365 AUTOMATION + DPD) zuweisen.

3

Company-GUID ermitteln

GET .../v2.0/<env>/api/v2.0/companies → die id als BC_COMPANY_ID in der Function hinterlegen.

4

Push bei DPD registrieren

Beim DPD-Kundencenter die Push-URL hinterlegen (siehe Tracking-Push-Service).

App-Settings (Kern)

Setting	Beschreibung
BC_TENANT_ID	Entra-Tenant-GUID
BC_CLIENT_ID	Client-ID der App-Registrierung
BC_CLIENT_SECRET	Client-Secret
BC_ENVIRONMENT	z. B. Production oder Sandbox
BC_COMPANY_ID	GUID des BC-Mandanten
BC_API_BASE	optional, Default https://api.businesscentral.dynamics.com/v2.0

Deployment erfolgt über das mitgelieferte Skript deploy.sh (Resource Group, Storage Account und Function App werden idempotent angelegt). Runtime: Node auf Azure Functions v4, Windows Consumption Plan.