Ihr ERP sicher anbinden
Wie ein ERP, seine Middleware und BatteryPass zusammenarbeiten, wer was tut und was Ihre Systeme nie verlässt.
Ihr ERP kennt Produkte, Seriennummern, Fertigungsaufträge, Lieferungen und Retouren. BatteryPass hält die Batteriepässe, die aus diesen Daten entstehen. Dieser Bereich zeigt, wie Sie beides verbinden: so, dass Daten fließen, ohne dass jemand Tabellen von Hand kopiert, und so, dass deklarierte Passdaten trotzdem nur über eine Person Ihrer Organisation in BatteryPass gelangen, die für sie einsteht.
Die Seiten beschreiben Integrationsmuster, keine Produkte: BatteryPass liefert keinen ERP-Konnektor, hat keine Zertifizierung eines Herstellers und keine Partnerschaft mit einem ERP-Anbieter. Die Verbindung bauen Sie mit Ihrer Middleware oder iPaaS auf der veröffentlichten API.
Die Architektur
flowchart LR ERP["ERP<br/>(Fertigung, Seriennummern,<br/>Lieferungen, Retouren)"] -->|"Outbox oder Ereignis"| MW["Middleware / iPaaS"] MW -->|"API-Schlüssel, Scope import:<br/>Tabelle bereitstellen"| API["BatteryPass-API"] MW -->|"API-Schlüssel, Scope condition:<br/>Messwerte, Ereignisse"| API API -->|"API-Schlüssel, Scope read:<br/>Änderungsfeed, Pässe, QR"| MW MW -->|"Digital Link, Status"| ERP API --> PORTAL["Portal: Mitglieder prüfen,<br/>übernehmen, geben frei"] PORTAL -->|"Mitglieder veröffentlichen"| PUB["Veröffentlichter Pass<br/>(signiert, öffentlicher Teil online)"]
- Das ERP hält fest, was geschieht (eine Fertigungsrückmeldung, ein Wareneingang, eine zurückgegebene Batterie), und legt die Änderung in einer Ausgangstabelle (Outbox) ab oder löst ein Ereignis aus.
- Die Middleware (ein eigener Dienst oder eine iPaaS) holt die Änderung ab, bringt sie in die Form, die BatteryPass erwartet, und ruft die API mit einem Schlüssel Ihrer Organisation auf.
- BatteryPass prüft jede Anfrage gegen den Scope des Schlüssels, validiert die Daten nach denselben Regeln wie das Portal und hält jeden Schreibvorgang im Audit-Log fest.
- Mitglieder Ihrer Organisation prüfen im Portal: Sie übernehmen bereitgestellte Importe, geben Werte frei und veröffentlichen Pässe. Ein Schlüssel kann nichts davon.
- Die Middleware liest über den Änderungsfeed zurück, was sie braucht (Passstatus, GS1 Digital Link, QR-Code), und schreibt es an den Satz im ERP.
Wer was tut
| Beteiligte | Kann | Kann nicht |
|---|---|---|
Schlüssel mit Scope import | Eine CSV- oder XLSX-Datei hochladen, zuordnen (auch mit einer Importvorlage), prüfen lassen und das Ergebnis lesen | Den Import übernehmen, Werte freigeben, veröffentlichen |
Schlüssel mit Scope condition | Gemessene Zustandsdaten und Lebenszyklus-Ereignisse melden | Deklarierte Daten wie Kapazität oder Zellchemie ändern |
Schlüssel mit Scope read | Modelle, Einheiten, Werte, Pässe, Exporte und den Änderungsfeed lesen | Etwas schreiben |
| Bearbeiter (Mitglied) | Einen geprüften Import übernehmen; die Einheiten entstehen als Entwürfe | Werte freigeben oder veröffentlichen |
| Prüfer, Admin, Inhaber (Mitglied) | Importierte Werte freigeben, Pässe veröffentlichen | Selbst erfasste Werte freigeben, solange das Vier-Augen-Prinzip eingeschaltet ist; veröffentlichen, solange Pflichtangaben fehlen |
| Inhaber (Mitglied) | API-Schlüssel unter Einstellungen → API-Schlüssel anlegen und widerrufen |
Das Vier-Augen-Prinzip ist eine Einstellung Ihrer Organisation. Zustandsdaten, die ein Schlüssel meldet, werden als freigegebene Messungen ohne Prüfer gespeichert; so sind Messdaten gedacht (siehe Zustandsdaten und Lebenszyklus).
Was nie fließt
BatteryPass braucht Daten über Batterien, nicht über Menschen. Behalten Sie diese Daten in Ihrem ERP:
- Namen, Adressen, Kontaktdaten und Auftragsnummern von Kundinnen und Kunden;
- Namen von Beschäftigten, Bedienpersonal oder Servicetechnikern;
- Preise, Margen und Lieferantenkonditionen;
- Fahrzeug-, Halter- oder Standortdaten einer Batterie im Betrieb.
Die Seriennummer genügt, um einen Pass, ein Ereignis oder eine Messung mit dem Satz in Ihrem ERP zu verbinden. Die Seite Sicherheit erklärt Datenminimierung und das übrige Sicherheitsmodell.
Die fünf Abläufe
Einheiten aus der Fertigung
Seriennummern werden als Import bereitgestellt; Mitglieder übernehmen, geben frei und veröffentlichen.
Pass-Links zurück ins ERP
Dem Änderungsfeed folgen und Digital Link und Status am Seriennummernsatz speichern.
Zustandsdaten aus BMS und Service
Messwerte mit ihrem Zeitpunkt melden; ältere werden übersprungen.
Rücksendungen und Reparaturen
Abgeschlossene Serviceaufträge werden Lebenszyklus-Ereignisse, ohne Kundendaten.
Produktänderung
Eine Änderung am Produktstamm benachrichtigt eine Person, die eine neue Modellversion anlegt.
Sicherheitsmodell
Schlüssel, Scopes, Wiederholungen, Outbox, Datenminimierung und die OWASP API Top 10.
Middleware und Standards
- iPaaS und Middleware: n8n, Make, Power Automate, MuleSoft, Boomi, Workato, Zapier und SAP Integration Suite mit einem BatteryPass-Schlüssel, und wie jede davon den Änderungsfeed abfragt.
- Standards: wie BatteryPass-Daten zu DIN DKE SPEC 99100, den IDTA-Teilmodellen des Batteriepasses und Catena-X stehen.
ERP-Systeme
Das ERP-Register nennt je System die Schnittstellen, die eine Integration nutzen kann, wie sie sich anmelden, ob sie Änderungen melden, und wie und wann wir jede Angabe geprüft haben. Es sind dieselben Daten, die das Portal unter Einstellungen → Integrationen zeigt.
| System | Hersteller | Betriebsarten | Prüfstand |
|---|---|---|---|
| SAP S/4HANA Cloud Public Edition | SAP | Cloud | geprüft in der Herstellerdokumentation |
| SAP S/4HANA (on-premise and Private Edition) | SAP | On-Premise | geprüft in der Herstellerdokumentation |
| SAP Business One | SAP | On-Premise | geprüft in der Herstellerdokumentation |
| Microsoft Dynamics 365 Business Central | Microsoft | Cloud, On-Premise | geprüft in der Herstellerdokumentation |
| Microsoft Dynamics NAV 2018 | Microsoft | On-Premise | geprüft in der Herstellerdokumentation |
| Microsoft Dynamics 365 Finance and Supply Chain Management | Microsoft | Cloud | geprüft in der Herstellerdokumentation |
| Oracle NetSuite | Oracle | Cloud | geprüft in der Herstellerdokumentation |
| Oracle Fusion Cloud Supply Chain Management | Oracle | Cloud | geprüft in der Herstellerdokumentation |
| Odoo | Odoo S.A. | Cloud, On-Premise | geprüft in der Herstellerdokumentation |
| Infor CloudSuite (M3, LN) | Infor | Cloud, On-Premise | geprüft in der Herstellerdokumentationnicht geprüft |
| IFS Cloud | IFS | Cloud, On-Premise | nur Community- oder Werbequelle |
| Epicor Kinetic | Epicor | Cloud, On-Premise | nur Community- oder Werbequelle |
| Sage X3 | Sage | Cloud, On-Premise | nicht geprüft |
| abas ERP | abas Software (Forterro) | On-Premise, Cloud | nur Community- oder Werbequelle |
| proALPHA ERP | proALPHA | On-Premise | nicht geprüft |
| weclapp | weclapp | Cloud | geprüft in der Herstellerdokumentation |
| Xentral | Xentral ERP Software | Cloud | geprüft in der Herstellerdokumentation |
„Geprüft in der Herstellerdokumentation“ heißt: Wir haben die öffentliche Dokumentation des Herstellers am angegebenen Tag gelesen. Das ist kein Test gegen ein laufendes System und keine Bestätigung durch den Hersteller. Einträge mit „nur Community- oder Werbequelle“ oder „nicht geprüft“ müssen Sie im Projekt bestätigen.