# weclapp

> Wie weclapp über seine REST-API Artikel und Seriennummern an BatteryPass übergibt.

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

Die REST-API von weclapp erwartet den API-Token im Header `AuthenticationToken`. Der Token gehört einem Benutzer; legen
Sie für die Integration deshalb einen technischen Benutzer mit knappen Rechten an und bewahren Sie seinen Token im
Tresor neben dem Schlüssel für BatteryPass auf.

Die Middleware liest Artikel und 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. Webhooks sind nicht geprüft; fragen Sie zeitgesteuert ab, solange Sie sie nicht bestätigt haben. Pass-Links
können an den Artikel- oder Seriennummernsatz zurückgehen wie unter
[Pass-Links zurück ins ERP](https://passport.kabin.sh/docs/de/integrations/workflows/passport-links-to-erp).

## Schnittstellen und Prüfstand

- **Hersteller:** weclapp
- **Cloud:** weclapp (REST API v1)

Der API-Token steht im Header AuthenticationToken; er gehört einem Benutzer, also einen technischen Benutzer mit knappen Rechten 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://www.weclapp.com/api/) (Artikel, Seriennummern, Lieferungen) | REST      | API-Schlüssel | keine      | Produkt-/Materialstamm, Charge/Seriennummer, Lieferung/Warenausgang | geprüft in der Herstellerdokumentation, 24.10.2026 |

**Hinweise**

- `REST API`: Webhooks 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
- [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