# proALPHA ERP

> proALPHA mit einem Dateiexport an BatteryPass anbinden, bis eine Schnittstelle bestätigt ist.

> [!WARNING]
> Nicht geprüft: eine REST-Schnittstelle mit OpenAPI-Beschreibung wird nur von Dritten erwähnt. Bis der Hersteller sie
> bestätigt, planen Sie mit einem Dateiexport.

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

Ein Dateiexport ist der sichere Weg: ein geplanter Bericht oder eine kleine Middleware schreibt die Seriennummern
fertiggemeldeter Produktion mit den Spaltennamen des Presets `generic-csv` (GTIN, Seriennummer, Herstelldatum,
Produktionsstätte, Modellversion, Batteriestatus). Die Middleware lädt die Datei mit einem Schlüssel hoch, der nur den
Scope `import` hat; Mitglieder übernehmen und geben sie im Portal frei, wie unter
[Einheiten aus der Fertigung](https://passport.kabin.sh/docs/de/integrations/workflows/units-from-production) beschrieben.

## Schnittstellen und Prüfstand

- **Hersteller:** proALPHA
- **On-Premise:** proALPHA ERP

Nicht geprüft: eine REST-Schnittstelle mit OpenAPI-Beschreibung wird nur von Dritten erwähnt. Bis zur Klärung mit dem Hersteller ist ein Dateiexport mit der allgemeinen Vorlage der sichere Weg.

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

| Schnittstelle                                           | Protokoll | Anmeldung | Ereignisse | Objekte                                     | Prüfstand     |
| ------------------------------------------------------- | --------- | --------- | ---------- | ------------------------------------------- | ------------- |
| `REST interface` (REST-Schnittstelle (nicht bestätigt)) | REST      | Token     | keine      | Produkt-/Materialstamm, Charge/Seriennummer | 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