Odoo und der Batteriepass: Integrationsmuster
Wie Daten aus Odoo (Odoo S.A.) ü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
- Odoo S.A.
- Betriebsarten
- Cloud (Odoo Online and Odoo.sh 19); On-Premise (Odoo 19 Community and Enterprise)
- Geprüft
- Herstellerdokumentation, 24. Oktober 2026
- Verwaltete Integration
- geplant
Odoo 19 bietet die JSON-2-API mit API-Schlüsseln als Bearer-Token; XML-RPC und JSON-RPC sind abgekündigt und fallen mit Odoo 22 (Herbst 2028) beziehungsweise Odoo Online 21.1 weg. API-Schlüssel haben ein Ablaufdatum: die Rotation gehört in den Betriebsplan.
Schnittstellen
| Schnittstelle | Protokoll | Anmeldung | Ereignisse | Objekte | Geprüft |
|---|---|---|---|---|---|
| JSON-2 API (/json/2/<model>/<method>)Alle Modelle, etwa product.product, stock.lot, mrp.production | REST | API-Schlüssel | keine | Produkt-/Materialstamm, Charge/Seriennummer, Fertigungsauftrag, Lieferung/Warenausgang, Retoure | geprüft in der Herstellerdokumentation, 24.10.2026 |
| Webhooks (automation rules)Ausgehende Webhooks aus Automatisierungsregeln | REST | API-Schlüssel | Webhooks | Produkt-/Materialstamm, Charge/Seriennummer, Fertigungsauftrag | geprüft in der Herstellerdokumentation, 24.10.2026 |
| XML-RPC and JSON-RPC (deprecated)Ältere externe API | XML-RPC | API-Schlüssel, Sitzung | keine | Produkt-/Materialstamm, Charge/Seriennummer, Fertigungsauftrag, Lieferung/Warenausgang, Retoure | 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
- Odoo – Los-/Seriennummern (stock.lot): Ein Export des Modells stock.lot aus Odoo mit der internen Referenz des Produkts. Odoo führt am Los kein Herstelldatum; die Middleware ergänzt die Spalte „Manufacturing Date“, zum Beispiel aus dem Enddatum des Fertigungsauftrags.
- 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.