# 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

```mermaid
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)"]
```

1. 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.
2. Die **Middleware** (ein eigener Dienst oder eine iPaaS) holt die Änderung ab, bringt sie in die Form, die
   BatteryPass erwartet, und ruft die [API](https://passport.kabin.sh/docs/de/api-reference) mit einem Schlüssel Ihrer Organisation auf.
3. **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.
4. **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.
5. Die Middleware liest über den [Änderungsfeed](https://passport.kabin.sh/docs/de/api-reference/changes/list-changes) 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](https://passport.kabin.sh/docs/de/concepts/condition-and-lifecycle)).

## 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](https://passport.kabin.sh/docs/de/integrations/security) erklärt Datenminimierung und das übrige Sicherheitsmodell.

## Die fünf Abläufe

[**Einheiten aus der Fertigung**](https://passport.kabin.sh/docs/de/integrations/workflows/units-from-production): Seriennummern werden als Import bereitgestellt; Mitglieder übernehmen, geben frei und veröffentlichen.

[**Pass-Links zurück ins ERP**](https://passport.kabin.sh/docs/de/integrations/workflows/passport-links-to-erp): Dem Änderungsfeed folgen und Digital Link und Status am Seriennummernsatz speichern.

[**Zustandsdaten aus BMS und Service**](https://passport.kabin.sh/docs/de/integrations/workflows/condition-from-bms): Messwerte mit ihrem Zeitpunkt melden; ältere werden übersprungen.

[**Rücksendungen und Reparaturen**](https://passport.kabin.sh/docs/de/integrations/workflows/returns-and-repairs): Abgeschlossene Serviceaufträge werden Lebenszyklus-Ereignisse, ohne Kundendaten.

[**Produktänderung**](https://passport.kabin.sh/docs/de/integrations/workflows/product-change): Eine Änderung am Produktstamm benachrichtigt eine Person, die eine neue Modellversion anlegt.

[**Sicherheitsmodell**](https://passport.kabin.sh/docs/de/integrations/security): Schlüssel, Scopes, Wiederholungen, Outbox, Datenminimierung und die OWASP API Top 10.

## Middleware und Standards

- [iPaaS und Middleware](https://passport.kabin.sh/docs/de/integrations/ipaas): 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](https://passport.kabin.sh/docs/de/integrations/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](https://passport.kabin.sh/docs/de/integrations/erp/sap-s4hana-cloud.md)                                          | SAP                      | Cloud             | geprüft in der Herstellerdokumentation                |
| [SAP S/4HANA (on-premise and Private Edition)](https://passport.kabin.sh/docs/de/integrations/erp/sap-s4hana-on-premise.md)                         | SAP                      | On-Premise        | geprüft in der Herstellerdokumentation                |
| [SAP Business One](https://passport.kabin.sh/docs/de/integrations/erp/sap-business-one.md)                                                          | SAP                      | On-Premise        | geprüft in der Herstellerdokumentation                |
| [Microsoft Dynamics 365 Business Central](https://passport.kabin.sh/docs/de/integrations/erp/dynamics-365-business-central.md)                      | Microsoft                | Cloud, On-Premise | geprüft in der Herstellerdokumentation                |
| [Microsoft Dynamics NAV 2018](https://passport.kabin.sh/docs/de/integrations/erp/dynamics-nav-2018.md)                                              | Microsoft                | On-Premise        | geprüft in der Herstellerdokumentation                |
| [Microsoft Dynamics 365 Finance and Supply Chain Management](https://passport.kabin.sh/docs/de/integrations/erp/dynamics-365-finance-operations.md) | Microsoft                | Cloud             | geprüft in der Herstellerdokumentation                |
| [Oracle NetSuite](https://passport.kabin.sh/docs/de/integrations/erp/oracle-netsuite.md)                                                            | Oracle                   | Cloud             | geprüft in der Herstellerdokumentation                |
| [Oracle Fusion Cloud Supply Chain Management](https://passport.kabin.sh/docs/de/integrations/erp/oracle-fusion-scm.md)                              | Oracle                   | Cloud             | geprüft in der Herstellerdokumentation                |
| [Odoo](https://passport.kabin.sh/docs/de/integrations/erp/odoo.md)                                                                                  | Odoo S.A.                | Cloud, On-Premise | geprüft in der Herstellerdokumentation                |
| [Infor CloudSuite (M3, LN)](https://passport.kabin.sh/docs/de/integrations/erp/infor-cloudsuite.md)                                                 | Infor                    | Cloud, On-Premise | geprüft in der Herstellerdokumentation; nicht geprüft |
| [IFS Cloud](https://passport.kabin.sh/docs/de/integrations/erp/ifs-cloud.md)                                                                        | IFS                      | Cloud, On-Premise | nur Community- oder Werbequelle                       |
| [Epicor Kinetic](https://passport.kabin.sh/docs/de/integrations/erp/epicor-kinetic.md)                                                              | Epicor                   | Cloud, On-Premise | nur Community- oder Werbequelle                       |
| [Sage X3](https://passport.kabin.sh/docs/de/integrations/erp/sage-x3.md)                                                                            | Sage                     | Cloud, On-Premise | nicht geprüft                                         |
| [abas ERP](https://passport.kabin.sh/docs/de/integrations/erp/abas-erp.md)                                                                          | abas Software (Forterro) | On-Premise, Cloud | nur Community- oder Werbequelle                       |
| [proALPHA ERP](https://passport.kabin.sh/docs/de/integrations/erp/proalpha.md)                                                                      | proALPHA                 | On-Premise        | nicht geprüft                                         |
| [weclapp](https://passport.kabin.sh/docs/de/integrations/erp/weclapp.md)                                                                            | weclapp                  | Cloud             | geprüft in der Herstellerdokumentation                |
| [Xentral](https://passport.kabin.sh/docs/de/integrations/erp/xentral.md)                                                                            | Xentral ERP Software     | Cloud             | geprüft in der Herstellerdokumentation                |

> [!NOTE]
> „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.
