# 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.

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.0](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/resources/dynamics_itemledgerentry)Standard-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)](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/dynamics-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 page](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-develop-custom-api)Eigene 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.

[Anleitung in der Entwicklerdokumentation (nach Anmeldung)](https://passport.kabin.sh/docs/de/integrations/erp/dynamics-365-business-central)

[← Alle Integrationsmuster](https://kabin.sh/integrationen)

Ihre Daten, ein geprüfter Batteriepass

Wir zeigen Ihnen in 30 Minuten, wie Ihre vorhandenen Tabellen, Lieferantendaten und Seriennummern zu einem gepflegten Batteriepass werden.

[Demo anfragen](https://kabin.sh/kontakt)[Beispiel-Batteriepass ansehen](https://kabin.sh/beispiel-batteriepass)