# Xentral

> Wie Xentral über seine REST-API und Webhooks Produkte und Lieferungen an BatteryPass übergibt.

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

Die REST-API von Xentral meldet sich mit persönlichen Zugriffstoken an. Legen Sie für die Integration einen technischen
Benutzer an, damit der Token nicht aufhört zu funktionieren, wenn eine Kollegin geht, und bewahren Sie ihn im Tresor auf.

Webhooks lassen sich über die API verwalten und melden der Middleware neue Produkte oder Lieferungen. Ob die Zustellungen
signiert sind, ist nicht geprüft; die Middleware prüft deshalb Absender und Inhalt und liest den Datensatz über die API,
bevor sie handelt. Seriennummern fertiggemeldeter Produktion gehen mit dem Preset `generic-csv` in eine Datei und werden
bereitgestellt wie unter [Einheiten aus der Fertigung](https://passport.kabin.sh/docs/de/integrations/workflows/units-from-production) beschrieben.

## Schnittstellen und Prüfstand

- **Hersteller:** Xentral ERP Software
- **Cloud:** Xentral (REST API)

Anmeldung mit persönlichen Zugriffstoken; einen technischen Benutzer für die Integration anlegen.

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

| Schnittstelle                                                                                      | Protokoll | Anmeldung | Ereignisse                | Objekte                                                             | Prüfstand                                          |
| -------------------------------------------------------------------------------------------------- | --------- | --------- | ------------------------- | ------------------------------------------------------------------- | -------------------------------------------------- |
| [`REST API`](https://developer.xentral.com/reference/authentication) (Artikel, Lager, Lieferungen) | REST      | Token     | keine                     | Produkt-/Materialstamm, Charge/Seriennummer, Lieferung/Warenausgang | geprüft in der Herstellerdokumentation, 24.10.2026 |
| [`Webhooks`](https://developer.xentral.com/reference/webhooks) (Webhooks verwalten und empfangen)  | REST      | Token     | Webhooks (nicht signiert) | Produkt-/Materialstamm, Lieferung/Warenausgang                      | geprüft in der Herstellerdokumentation, 24.10.2026 |

**Hinweise**

- `Webhooks`: Signatur der Zustellungen nicht geprüft; die Middleware prüft Absender und Inhalt, bevor sie handelt.

**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
- [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