Oracle NetSuite und der Batteriepass: Integrationsmuster
Wie Daten aus Oracle NetSuite (Oracle) ü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
- Oracle
- Betriebsarten
- Cloud (NetSuite (SuiteTalk REST web services))
- Geprüft
- Herstellerdokumentation, 25. Oktober 2026
- Verwaltete Integration
- —
Für neue Integrationen OAuth 2.0 mit Client Credentials (ein mit Zertifikat signiertes JWT) statt Token-based Authentication: Partnerquellen nennen 2027.1 als Ende für neue TBA-Integrationen, auf Oracles Seiten war das nicht zu bestätigen.
Schnittstellen
| Schnittstelle | Protokoll | Anmeldung | Ereignisse | Objekte | Geprüft |
|---|---|---|---|---|---|
| SuiteTalk REST web servicesDatensätze (Artikel, Fertigungsaufträge, Lieferungen, Retouren) | REST | OAuth 2.0 Client Credentials, Token | keine | Produkt-/Materialstamm, Charge/Seriennummer, Fertigungsauftrag, Lieferung/Warenausgang, Retoure | geprüft in der Herstellerdokumentation, 24.10.2026 |
| SuiteQLAbfragen, etwa über den Datensatz inventorynumber | REST | OAuth 2.0 Client Credentials, Token | keine | Charge/Seriennummer | geprüft in der Herstellerdokumentation, 24.10.2026 |
| SuiteScript afterSubmit with N/httpsEigene Benachrichtigung nach dem Speichern eines Datensatzes | REST | OAuth 2.0 Client Credentials | Webhooks | Produkt-/Materialstamm, Charge/Seriennummer, Fertigungsauftrag | geprüft in der Herstellerdokumentation, 25.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
- NetSuite – Gespeicherte Suche über Inventarnummern: Eine gespeicherte Suche über den Datensatz Inventarnummer (inventorynumber) in Oracle NetSuite, als CSV exportiert oder per SuiteQL abgefragt. Setzt voraus, dass die Modellkennung der Artikelname ist. Das Herstelldatum ergänzt die Middleware, etwa aus dem Fertigungsauftrag.
- 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.