Microsoft Dynamics 365 Business Central und der Batteriepass: Integrationsmuster
Wie Daten aus Microsoft Dynamics 365 Business Central (Microsoft) über die BatteryPass-API in den Batteriepass kommen: Schnittstellen, Abläufe und Prüfstand.
Ein Integrationsmuster, kein fertiger Konnektor: Ihr ERP oder Ihre Integrationsplattform liest und schreibt über die BatteryPass-API mit einem Organisationsschlüssel. Die Angaben unten stammen aus der Dokumentation des Herstellers und wurden am genannten Datum geprüft.
- Hersteller
- Microsoft
- Betriebsarten
- Cloud (Business Central online (API v2.0)); On-Premise (Business Central on-premises (API v2.0))
- Geprüft
- Herstellerdokumentation, 25. Oktober 2026
- Verwaltete Integration
- —
Die Standard-API liefert Artikelposten ohne Serien- und Chargennummern; dafür braucht es eine eigene AL-API-Seite. Webhook-Abonnements laufen nach drei Tagen ab und müssen erneuert werden.
Schnittstellen
| Schnittstelle | Protokoll | Anmeldung | Ereignisse | Objekte | Geprüft |
|---|---|---|---|---|---|
| API v2.0Standard-API (Artikel, Artikelposten, Verkaufsbelege) | OData V4 | OAuth 2.0 Client Credentials | keine | Produkt-/Materialstamm, Lieferung/Warenausgang | geprüft in der Herstellerdokumentation, 24.10.2026 |
| Webhook subscriptions (/api/v2.0/subscriptions)Benachrichtigungen über Änderungen | REST | OAuth 2.0 Client Credentials | Webhooks | Produkt-/Materialstamm, Lieferung/Warenausgang | geprüft in der Herstellerdokumentation, 24.10.2026 |
| Custom AL API pageEigene API-Seite für Artikelposten mit Seriennummern | OData V4 | OAuth 2.0 Client Credentials | keine | Charge/Seriennummer | geprüft in der Herstellerdokumentation, 25.10.2026 |
Passende Abläufe
Einheiten aus der Fertigung
Seriennummern aus Fertigungsrückmeldung oder Wareneingang werden als Import bereitgestellt; Mitglieder prüfen, übernehmen und geben frei, bevor ein Pass erscheint.
Pass-Links zurück ins ERP
Die Middleware folgt dem Änderungsfeed und schreibt den GS1 Digital Link und den Passstatus an den Seriennummernsatz im ERP, damit Etiketten und Lieferpapiere ihn tragen.
Rücksendungen und Reparaturen als Lebenszyklus-Ereignisse
Abgeschlossene Reparaturen, Prüfungen und Komponententausche aus Service- oder Retourenaufträgen erscheinen als Ereignisse in der Historie der Einheit.
Produktänderung führt zu neuer Modellversion
Eine Änderung am Produktstamm im ERP löst eine Benachrichtigung aus; ein Mitglied legt in BatteryPass eine neue Modellversion an. Deklarierte Daten werden nie automatisch geschrieben.
Importvorlagen
- Business Central – Artikelposten mit Seriennummern: Die Artikelposten aus Microsoft Dynamics 365 Business Central mit Seriennummer, wie sie eine eigene AL-API-Seite liefert (die Standard-API itemLedgerEntries enthält keine Seriennummern). Spaltennamen der API-Seite und der Excel-Ausgabe der Benutzeroberfläche (deutsch und englisch). Setzt voraus, dass die Modellkennung die Artikelnummer ist. Das Buchungsdatum steht für das Herstelldatum: exportieren Sie nur Posten der Postenart Istmeldung (Output), also die Fertigmeldungen aus der Produktion, sonst trägt eine Umlagerung oder ein Verkauf das falsche Datum ein.
- Allgemeine CSV-Datei: Für jedes ERP und für Dateien, die eine Middleware selbst schreibt: GTIN, Seriennummer, Herstelldatum, Produktionsstätte (Name oder GLN), Modellversion und Batteriestatus, mit deutschen und englischen Spaltennamen.