# Sage X3

> Was über die Anbindung von Sage X3 an BatteryPass bekannt ist und was noch zu klären ist.

> [!WARNING]
> Nicht geprüft: Sage nennt für X3 eine GraphQL-API, deren Referenz aber nur Partnern offensteht; Anmeldung und Objekte
> konnten wir nicht bestätigen. Klären Sie die Schnittstelle vor einem Projekt mit Sage oder Ihrem Partner.

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

Welche Schnittstelle Ihr X3 auch anbietet, auf der Seite von BatteryPass bleibt der Ablauf gleich: eine Middleware liest
die Seriennummern fertiggemeldeter Produktion, schreibt eine Datei mit dem Preset `generic-csv` und stellt sie bereit wie
unter [Einheiten aus der Fertigung](https://passport.kabin.sh/docs/de/integrations/workflows/units-from-production) beschrieben; Mitglieder
übernehmen und geben sie im Portal frei. Bis die Schnittstelle geklärt ist, ist ein geplanter Export einer Datei mit
diesen Spalten ein sicherer Anfang.

## Schnittstellen und Prüfstand

- **Hersteller:** Sage
- **Cloud:** Sage X3
- **On-Premise:** Sage X3

Nicht geprüft: Sage nennt eine GraphQL-API; die Referenz ist nur für Partner zugänglich. Vor dem Projekt beim Hersteller klären.

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

| Schnittstelle                                                        | Protokoll | Anmeldung                    | Ereignisse | Objekte                                     | Prüfstand     |
| -------------------------------------------------------------------- | --------- | ---------------------------- | ---------- | ------------------------------------------- | ------------- |
| [`GraphQL API`](https://developer.sage.com/x3/graphql) (GraphQL-API) | GraphQL   | OAuth 2.0 Client Credentials | keine      | Produkt-/Materialstamm, Charge/Seriennummer | nicht geprüft |

**Hinweise**

- `GraphQL API`: Anmeldeverfahren und Objekte 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
- [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