Start / Integration
Ihre Reklamationsdaten gehören in Ihre Systeme.
ServClaim liefert jede Reklamation strukturiert und versioniert, als Delta seit dem letzten Abruf. Fremdsysteme binden sich über eine dokumentierte REST-API und signierte Webhooks an.
Strukturierte Daten: Delta je Reklamation
Zehn Tabellen im Schema v1, ohne personenbezogene Daten. Jeder Abruf liefert, was sich seit dem letzten Wasserzeichen geändert hat, als NDJSON, CSV oder JSON. Im Ziel wird per MERGE je claim_id geladen.
ServClaim
?since=…
STAGE · NDJSON
ON claim_id
ZIEL-DWH · QC_RAW
-- Beispiel Snowflake/ANSI-SQL -- Reklamationsquote je Typ, letzte 6 Monate SELECT c.machine_type_name, COUNT(*) AS claims, SUM(d.quantity) AS delivered, ROUND(1e6 * claims / delivered) AS ppm FROM qc_raw.qc_claims c JOIN qc_raw.qc_deliveries d USING (machine_type_code) WHERE c.claim_type = 'OBX' -- Inbetriebnahme AND c.created_at >= DATEADD(month, -6, CURRENT_DATE) GROUP BY 1 ORDER BY ppm DESC;
Ergebnis · ppm je Typ
Beispieldaten (fiktiv) · Skala 0–2.500 ppm
Delta mit Wasserzeichen
Delta per GET /api/dwh/v1/<tabelle>?since=…: nur geänderte Zeilen und das nächste Wasserzeichen. Dank MERGE je claim_id ist ein wiederholter Abruf unschädlich.
Manifest
Unter /api/dwh/v1/_manifest stehen Tabellen, Spalten, Typen und Schemaversion. Ladestrecken und DDL lassen sich daraus erzeugen.
Jedes Zielsystem
Zum Beispiel Snowflake, Databricks, Google BigQuery, Microsoft Fabric / Power BI, SAP Datasphere oder jede ETL-Strecke.
CAQ-Schnittstelle
Der 8D-Datensatz geht in Ihr CAQ-System, die Ergebnisse kommen zurück.
ServClaim ist an kein CAQ-Produkt gebunden. Babtec ist als Profil vorbereitet, weitere Systeme werden per Spaltenzuordnung eingerichtet.
Reklamationsdatensatz in 8D-Struktur
Problem (D2 aus den Befunden), Sofortmaßnahme und Eindämmung, Ursache, Verursacher, Lieferant, Teile, Mengen, Seriennummern, Kosten, Einheit, Status und CAQ-Nummer.
Abrufen
Per REST GET /api/v1/caq/complaints?updated_since=…&format=json|csv|xml oder je Fall als Datei.
Zurückmelden
8D-Ergebnisse per REST POST /api/v1/caq/complaints/{claim}/eightd oder per Dateiimport: CSV, Excel, XML/VDA QDX oder PDF-Formularbericht.
REST-API und Webhooks
OpenAPI 3.1, ein Schlüssel je System mit Berechtigungen, gespeichert nur als Hash. Ereignisse kommen sofort per HTTPS, signiert mit HMAC-SHA256, mit bis zu zwei Wiederholungen.
Webhook-Zustellungen
Berechtigungen je Schlüssel
claims:read|write, masterdata:read, knowledge:read|write. Schreiben schließt Lesen ein, alles steht im Audit-Log.
Gleiche Regeln wie die App
Statuswechsel über die API folgen denselben Regeln: kein Abschluss ohne Owner und CAQ-Nummer (z. B. Babtec).
Ereignisse
claim.created · claim.status_changed · claim.link_added · eightd.imported · cluster.detected · bundle.suggested
Angebundene Systeme