# IFS Cloud

> Wie IFS Cloud über seine OData-Projektionen Seriennummern an BatteryPass liefern könnte.

> [!WARNING]
> Die Angaben auf dieser Seite stammen nur aus Community-Quellen und sind nicht gegen die Dokumentation von IFS geprüft.
> Klären Sie Schnittstellen, Anmeldung und Entitäten vor einem Projekt mit IFS oder Ihrem Partner.

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

Laut Community-Quellen sind die APIs von IFS Cloud OData-Projektionen der Anwendungen, und die Anmeldung läuft über
OAuth 2.0. Eine Middleware würde die Seriennummern fertiggemeldeter Werkstattaufträge über eine solche Projektion lesen,
mit einem Dienstbenutzer, der nur lesen darf, und eine Datei mit dem Preset `generic-csv` für
[Einheiten aus der Fertigung](https://passport.kabin.sh/docs/de/integrations/workflows/units-from-production) schreiben.

Änderungsereignisse sind nicht geprüft; bis dahin fragt die Middleware zeitgesteuert ab. IFS wird oft auch für
Serviceprozesse genutzt, deshalb können [Rücksendungen und Reparaturen](https://passport.kabin.sh/docs/de/integrations/workflows/returns-and-repairs)
und [Zustandsdaten](https://passport.kabin.sh/docs/de/integrations/workflows/condition-from-bms) ebenfalls passen.

## Schnittstellen und Prüfstand

- **Hersteller:** IFS
- **Cloud:** IFS Cloud
- **On-Premise:** IFS Cloud (remote deployment)

Nur aus Community-Quellen: die APIs sind OData-Projektionen, die Anmeldung läuft über OAuth 2.0.

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

| Schnittstelle                                                                                           | Protokoll | Anmeldung                    | Ereignisse | Objekte                                                        | Prüfstand                                   |
| ------------------------------------------------------------------------------------------------------- | --------- | ---------------------------- | ---------- | -------------------------------------------------------------- | ------------------------------------------- |
| [`Projections (OData)`](https://community.ifs.com/questions/37795) (OData-Projektionen der Anwendungen) | OData V4  | OAuth 2.0 Client Credentials | keine      | Produkt-/Materialstamm, Charge/Seriennummer, Fertigungsauftrag | nur Community- oder Werbequelle, 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](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