SAP Business One
Wie SAP Business One über den Service Layer Seriennummern an BatteryPass liefert.
Diese Seite beschreibt ein Integrationsmuster. BatteryPass liefert keinen Konnektor für SAP Business One und hat keine Partnerschaft mit SAP; nichts hier ist eine Freigabe des Herstellers.
Der Zugang ist der Service Layer: OData V3 unter /b1s/v1 und OData V4 unter /b1s/v2. Er arbeitet mit Sitzungen:
die Middleware meldet sich mit POST /Login an, hält das Sitzungs-Cookie und meldet sich neu an, wenn die Sitzung
abläuft. Nutzen Sie einen technischen Business-One-Benutzer, der nur Artikel, Seriennummern und Fertigungsaufträge
lesen darf.
Webhooks sind im Service Layer nicht dokumentiert; die Middleware fragt deshalb regelmäßig ab, etwa alle paar Minuten
nach Seriennummern, die seit dem letzten Lauf entstanden sind. Sie schreibt sie mit dem Preset generic-csv (GTIN,
Seriennummer, Herstelldatum, Produktionsstätte) in eine Datei und stellt sie bereit wie unter
Einheiten aus der Fertigung beschrieben. Der Service Layer
selbst bleibt in Ihrem Netz; mit BatteryPass spricht nur die Middleware.
Schnittstellen und Prüfstand
- Hersteller
- SAP
- Betriebsarten
- On-Premise: SAP Business One with Service Layer (SQL Server and SAP HANA)
Der Service Layer arbeitet mit Sitzungen: die Middleware meldet sich mit POST /Login an und hält das Sitzungs-Cookie. Webhooks sind im Service Layer nicht dokumentiert; Änderungen findet die Middleware per Abfrage.
Integrationsmuster, kein Konnektor: BatteryPass liefert keine ERP-Anbindung und ist bei keinem Hersteller zertifiziert.
| Schnittstelle | Protokoll | Anmeldung | Ereignisse | Objekte | Prüfstand |
|---|---|---|---|---|---|
Service Layer /b1s/v1Service Layer (OData V3) | OData V3 | Sitzung | keine | Produkt-/Materialstamm, Charge/Seriennummer, Fertigungsauftrag, Lieferung/Warenausgang, Retoure | geprüft in der Herstellerdokumentation, 24.10.2026 |
Service Layer /b1s/v2Service Layer (OData V4) | OData V4 | Sitzung | keine | Produkt-/Materialstamm, Charge/Seriennummer, Fertigungsauftrag, Lieferung/Warenausgang, Retoure | geprüft in der Herstellerdokumentation, 24.10.2026 |
Importvorlagen (Presets)
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
- 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