SAP S/4HANA (on-premise and Private Edition) und der Batteriepass: Integrationsmuster
Wie Daten aus SAP S/4HANA (on-premise and Private Edition) (SAP) ü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
- SAP
- Betriebsarten
- On-Premise (On-premise and Private Edition with the OP_ APIs of the SAP Business Accelerator Hub)
- Geprüft
- Herstellerdokumentation, 24. Oktober 2026
- Verwaltete Integration
- —
Die OP_-APIs entsprechen den Cloud-APIs; die Middleware erreicht das System meist über den SAP Cloud Connector oder ein Reverse Proxy im Werksnetz, nie direkt aus dem Internet.
Schnittstellen
| Schnittstelle | Protokoll | Anmeldung | Ereignisse | Objekte | Geprüft |
|---|---|---|---|---|---|
| OP_API_PRODUCT_SRV_0001Produktstamm | OData V2 | Basic Auth, X.509-Zertifikat | keine | Produkt-/Materialstamm | geprüft in der Herstellerdokumentation, 24.10.2026 |
| OP_API_MATERIALSERIALNUMBER_0001Serialnummern | OData V4 | Basic Auth, X.509-Zertifikat | keine | Charge/Seriennummer | geprüft in der Herstellerdokumentation, 24.10.2026 |
| OP_API_BATCH_SRV_0001Chargen | OData V2 | Basic Auth, X.509-Zertifikat | keine | Charge/Seriennummer | geprüft in der Herstellerdokumentation, 24.10.2026 |
| OP_API_PRODUCTION_ORDER_2_SRV_0001Fertigungsaufträge | OData V2 | Basic Auth, X.509-Zertifikat | keine | Fertigungsauftrag | geprüft in der Herstellerdokumentation, 24.10.2026 |
| OP_CUSTOMERRETURN_0001Kundenretouren | OData V4 | Basic Auth, X.509-Zertifikat | keine | Retoure | geprüft in der Herstellerdokumentation, 24.10.2026 |
| MATMASIDoc für den Materialstamm | IDoc | Basic Auth, X.509-Zertifikat | Geschäftsereignisse | Produkt-/Materialstamm | nur Community- oder Werbequelle, 24.10.2026 |
| RAP business eventsGeschäftsereignisse des RAP-Modells | REST | OAuth 2.0 Client Credentials, X.509-Zertifikat | Geschäftsereignisse | Produkt-/Materialstamm, Fertigungsauftrag | nicht geprüft |
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.
Zustandsdaten aus BMS und Service
Ein Batteriemanagementsystem oder ein Servicewerkzeug meldet Messwerte wie Kapazitätsverlust oder Zyklen; BatteryPass übernimmt neuere Messungen und veröffentlicht nach der Richtlinie der Organisation.
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
- SAP-Serialnummernliste: Eine Liste der Serialnummern aus SAP S/4HANA, wie sie eine Middleware aus der Serialnummern-API oder dem Wareneingang aus der Fertigung zusammenstellt. Setzt voraus, dass die Modellkennung des Batteriemodells in BatteryPass die SAP-Materialnummer ist. Das Buchungsdatum des Wareneingangs steht für das Herstelldatum; das Werk bleibt ungemappt (die Produktionsstätte wählen Sie in den Importoptionen).
- 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.