SAP S/4HANA Cloud Public Edition
Wie SAP S/4HANA Cloud Public Edition Seriennummern an BatteryPass übergibt und Pass-Links zurückbekommt.
Diese Seite beschreibt ein Integrationsmuster. BatteryPass liefert keinen Konnektor für SAP S/4HANA Cloud und hat keine Partnerschaft mit SAP; nichts hier ist eine Freigabe des Herstellers.
In der Public Edition spricht jede Integration über ein eigenes Kommunikationsarrangement mit den freigegebenen APIs des SAP Business Accelerator Hub. Geben Sie der Middleware für BatteryPass genau die APIs, die sie braucht: die Seriennummern-API, Rückmeldungen zu Fertigungsaufträgen oder Warenbewegungen für Einheiten aus der Fertigung und die Produkt-API, wenn eine Produktänderung die verantwortliche Person erreichen soll.
Seriennummern liefert CE_API_MATERIALSERIALNUMBER_0001. Der SAP-Hinweis 3772443 beschreibt einen Fehler bei
Serialisierungsstufe 1: das Anlegen antwortet mit 201, legt aber nichts an. Das Lesen ist nicht betroffen; lassen
Sie Seriennummern also in der Fertigung (oder mit IQ01) entstehen und lesen Sie sie nur aus der Middleware. Das Preset
sap-serial-numbers ordnet Materialnummer, Seriennummer und Buchungsdatum des Wareneingangs zu; es setzt voraus, dass
die Modellkennung des Batteriemodells in BatteryPass die SAP-Materialnummer ist.
Änderungen erreichen die Middleware als CloudEvents über SAP Event Mesh, etwa
sap.s4.beh.product.v1.Product.Changed.v1. Die Ereignisse sind schlank: sie tragen den Schlüssel, das Produkt liest
die Middleware danach. Für den Rückweg (Digital Link und Passstatus am Seriennummernsatz) folgt die Middleware dem
Änderungsfeed von BatteryPass.
Schnittstellen und Prüfstand
- Hersteller
- SAP
- Betriebsarten
- Cloud: Public Edition
Jede Integration bekommt ein eigenes Kommunikationsarrangement mit genau den APIs, die sie braucht. Die Middleware läuft meist in der SAP Integration Suite oder einer anderen iPaaS.
Integrationsmuster, kein Konnektor: BatteryPass liefert keine ERP-Anbindung und ist bei keinem Hersteller zertifiziert.
| Schnittstelle | Protokoll | Anmeldung | Ereignisse | Objekte | Prüfstand |
|---|---|---|---|---|---|
CE_PRODUCT_0002Produktstamm | OData V4 | Basic Auth, X.509-Zertifikat, OAuth 2.0 Client Credentials | keine | Produkt-/Materialstamm | geprüft in der Herstellerdokumentation, 24.10.2026 |
CE_API_MATERIALSERIALNUMBER_0001Serialnummern | OData V4 | Basic Auth, X.509-Zertifikat, OAuth 2.0 Client Credentials | keine | Charge/Seriennummer | geprüft in der Herstellerdokumentation, 24.10.2026 |
CE_PRODUCTIONORDER_0001Fertigungsaufträge | OData V4 | Basic Auth, X.509-Zertifikat, OAuth 2.0 Client Credentials | keine | Fertigungsauftrag | geprüft in der Herstellerdokumentation, 24.10.2026 |
API_PROD_ORDER_CONFIRMATION_2_SRVRückmeldungen zu Fertigungsaufträgen | OData V2 | Basic Auth, X.509-Zertifikat, OAuth 2.0 Client Credentials | keine | Fertigungsauftrag | geprüft in der Herstellerdokumentation, 24.10.2026 |
API_OUTBOUND_DELIVERY_SRV_0002Auslieferungen | OData V2 | Basic Auth, X.509-Zertifikat, OAuth 2.0 Client Credentials | keine | Lieferung/Warenausgang | geprüft in der Herstellerdokumentation, 24.10.2026 |
API_MATERIAL_DOCUMENT_SRVWarenbewegungen (Wareneingang, Warenausgang) | OData V2 | Basic Auth, X.509-Zertifikat, OAuth 2.0 Client Credentials | keine | Lieferung/Warenausgang | geprüft in der Herstellerdokumentation, 24.10.2026 |
API_CUSTOMER_RETURN_SRVKundenretouren | OData V2 | Basic Auth, X.509-Zertifikat, OAuth 2.0 Client Credentials | keine | Retoure | geprüft in der Herstellerdokumentation, 24.10.2026 |
sap.s4.beh.product.v1.Product.Changed.v1Ereignis „Produkt geändert“ über SAP Event Mesh | REST | OAuth 2.0 Client Credentials | Geschäftsereignisse (nicht signiert) | Produkt-/Materialstamm | geprüft in der Herstellerdokumentation, 24.10.2026 |
Hinweise
CE_PRODUCT_0002: Die ältere API API_PRODUCT_SRV (OData V2) ist nur noch für Produkttexte gedacht.CE_API_MATERIALSERIALNUMBER_0001: SAP-Hinweis 3772443: Bei Serialisierungsstufe 1 antwortet das Anlegen mit 201, legt aber nichts an. Lesen ist nicht betroffen; Seriennummern entstehen dann über die Fertigung oder IQ01.sap.s4.beh.product.v1.Product.Changed.v1: CloudEvents mit schlanker Nutzlast (Produktschlüssel); das Produkt liest die Middleware danach über die API.
Importvorlagen (Presets)
SAP-Serialnummernliste (sap-serial-numbers): 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).
| Spalte im Export | Feld in BatteryPass |
|---|---|
Material (auch Product, Materialnummer, Produkt) | Modellkennung / SKU identification.model_identifier |
SerialNumber (auch Serial Number, Serialnummer) | Seriennummer identification.serial_number |
PostingDate (auch Posting Date, Buchungsdatum) | Herstellungsdatum identification.manufacturing_date |
Allgemeine CSV-Datei (generic-csv): 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.
| Spalte im Export | Feld in BatteryPass |
|---|---|
GTIN (auch EAN, GTIN-13, GTIN-14) | GTIN (GS1) identification.gtin |
Serial number (auch Seriennummer, serial_number) | Seriennummer identification.serial_number |
Manufacturing date (auch Herstelldatum, manufacturing_date) | Herstellungsdatum identification.manufacturing_date |
Facility (auch Produktionsstätte, Facility GLN, Werk-GLN) | Herstellungsort identification.manufacturing_place |
Model version (auch Modellversion, model_version) | Modellversion model_version |
Battery status (auch Batteriestatus, battery_status) | Batteriestatus identification.battery_status |
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. Scopes des Schlüssels: import
- 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. Scopes des Schlüssels: read
- 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. Scopes des Schlüssels: readcondition
- 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. Scopes des Schlüssels: readcondition
- 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. Scopes des Schlüssels: read