# Infor CloudSuite (M3, LN)

> Wie Infor M3 und Infor LN über das ION API Gateway BatteryPass erreichen.

> [!NOTE]
> Diese Seite beschreibt ein Integrationsmuster. BatteryPass liefert keinen Konnektor für Infor und hat keine
> Partnerschaft mit Infor; nichts hier ist eine Freigabe des Herstellers.

> [!WARNING]
> Die LN-OData-Entitäten und die BOD-Nachrichten unten sind nicht gegen die Dokumentation von Infor geprüft (in der
> Tabelle als „nicht geprüft“ markiert). Klären Sie Protokollversionen und Entitäten mit Infor oder Ihrem Partner, bevor
> Sie darauf aufbauen.

Jeder Aufruf läuft über das ION API Gateway mit OAuth 2.0 Client Credentials. Die Zugangsdaten stehen in einer
`.ionapi`-Datei; behandeln Sie sie wie den Schlüssel für BatteryPass als Geheimnis: im Tresor, nie in einem Repository,
und eine eigene Datei je Integration. In M3 ruft die Middleware MI-Programme über das Gateway auf, in LN liest sie
Business Data Entities.

Für [Einheiten aus der Fertigung](https://passport.kabin.sh/docs/de/integrations/workflows/units-from-production) liest die Middleware die
Seriennummern fertiggemeldeter Aufträge und schreibt eine Datei mit dem Preset `generic-csv`. Infor ION kann bei
Änderungen außerdem Business Object Documents (BODs) veröffentlichen; nutzen Sie sie als Auslöser und lesen Sie die
Einzelheiten über das Gateway.

## Schnittstellen und Prüfstand

- **Hersteller:** Infor
- **Cloud:** Infor M3 and Infor LN on Infor OS
- **On-Premise:** Infor M3 and Infor LN with Infor OS on-premises

Alle Aufrufe laufen über das ION API Gateway; die Zugangsdaten stehen in einer .ionapi-Datei, die wie ein Geheimnis zu behandeln ist.

Integrationsmuster, kein Konnektor: BatteryPass liefert keine ERP-Anbindung und ist bei keinem Hersteller zertifiziert.

| Schnittstelle                                                                                                                                                   | Protokoll       | Anmeldung                    | Ereignisse                           | Objekte                                                                                         | Prüfstand                                          |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ---------------------------- | ------------------------------------ | ----------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| [`ION API Gateway`](https://docs.infor.com/inforos/2026.x/en-us/useradminlib_cloud/apigatewayag_cloud/wxo1761727799964.html) (Zugang zu den APIs von M3 und LN) | REST            | OAuth 2.0 Client Credentials | keine                                | Produkt-/Materialstamm, Charge/Seriennummer, Fertigungsauftrag, Lieferung/Warenausgang, Retoure | geprüft in der Herstellerdokumentation, 24.10.2026 |
| `M3 MI programs` (M3-Programme über das ION API Gateway)                                                                                                        | REST            | OAuth 2.0 Client Credentials | keine                                | Produkt-/Materialstamm, Charge/Seriennummer, Fertigungsauftrag, Lieferung/Warenausgang          | geprüft in der Herstellerdokumentation, 24.10.2026 |
| `LN OData (BDE)` (LN-Business-Data-Entities)                                                                                                                    | OData V4        | OAuth 2.0 Client Credentials | keine                                | Produkt-/Materialstamm, Charge/Seriennummer, Fertigungsauftrag                                  | nicht geprüft                                      |
| `Business Object Documents (BODs)` (Nachrichten über Infor ION)                                                                                                 | BOD (Infor ION) | OAuth 2.0 Client Credentials | Geschäftsereignisse (nicht signiert) | Produkt-/Materialstamm, Fertigungsauftrag, Lieferung/Warenausgang                               | nicht geprüft                                      |

**Hinweise**

- `LN OData (BDE)`: Protokollversion und Entitäten nicht geprüft.

**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](https://passport.kabin.sh/docs/de/integrations/workflows/units-from-production.md): 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](https://passport.kabin.sh/docs/de/integrations/workflows/passport-links-to-erp.md): 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](https://passport.kabin.sh/docs/de/integrations/workflows/condition-from-bms.md): 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: read, condition
- [Rücksendungen und Reparaturen als Lebenszyklus-Ereignisse](https://passport.kabin.sh/docs/de/integrations/workflows/returns-and-repairs.md): Abgeschlossene Reparaturen, Prüfungen und Komponententausche aus Service- oder Retourenaufträgen erscheinen als Ereignisse in der Historie der Einheit. Scopes des Schlüssels: read, condition
- [Produktänderung führt zu neuer Modellversion](https://passport.kabin.sh/docs/de/integrations/workflows/product-change.md): 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
