weclapp und der Batteriepass: Integrationsmuster
Wie Daten aus weclapp (weclapp) über die BatteryPass-API in den Batteriepass kommen: Schnittstellen, Abläufe und Prüfstand.
Ein Integrationsmuster, kein fertiger Konnektor: Ihr ERP oder Ihre Integrationsplattform liest und schreibt über die BatteryPass-API mit einem Organisationsschlüssel. Die Angaben unten stammen aus der Dokumentation des Herstellers und wurden am genannten Datum geprüft.
- Hersteller
- weclapp
- Betriebsarten
- Cloud (weclapp (REST API v1))
- Geprüft
- Herstellerdokumentation, 24. Oktober 2026
- Verwaltete Integration
- —
Der API-Token steht im Header AuthenticationToken; er gehört einem Benutzer, also einen technischen Benutzer mit knappen Rechten anlegen.
Schnittstellen
| Schnittstelle | Protokoll | Anmeldung | Ereignisse | Objekte | Geprüft |
|---|---|---|---|---|---|
| REST APIArtikel, Seriennummern, Lieferungen | REST | API-Schlüssel | keine | Produkt-/Materialstamm, Charge/Seriennummer, Lieferung/Warenausgang | geprüft in der Herstellerdokumentation, 24.10.2026 |
Passende Abläufe
Einheiten aus der Fertigung
Seriennummern aus Fertigungsrückmeldung oder Wareneingang werden als Import bereitgestellt; Mitglieder prüfen, übernehmen und geben frei, bevor ein Pass erscheint.
Pass-Links zurück ins ERP
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.
Rücksendungen und Reparaturen als Lebenszyklus-Ereignisse
Abgeschlossene Reparaturen, Prüfungen und Komponententausche aus Service- oder Retourenaufträgen erscheinen als Ereignisse in der Historie der Einheit.
Produktänderung führt zu neuer Modellversion
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.
Importvorlagen
- Allgemeine CSV-Datei: 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.