API für Registrierungen & Seriennummern

Mit diesen Endpunkten fragen Sie Produktregistrierungen ab und prüfen Seriennummern für die Garantiedeckung.

Registrierung abfragen

GET /api/public/registration/lookup

Abfrageparameter:

• registrationNumber (erforderlich) — z. B. UMB-REG-00089
• orgId (erforderlich) — Organisations-ID

Gibt den Registrierungsdatensatz zurück, einschließlich Produktdetails, Kundendaten, Status, Kaufdatum und zugehöriger Garantie.

Registrierungsstatus

Ablauf der Registrierung

1. Der Kunde reicht die Registrierung über POST /api/public/products/register ein (siehe Produkt-API)
2. Das System prüft Produkt- und Kundendaten und legt eine Registrierung mit dem Status pending an
3. Der Kunde erhält eine Bestätigungs-E-Mail mit seiner Registrierungsnummer
4. Der Händler prüft die Registrierung im Dashboard und genehmigt oder lehnt sie ab
5. Der Kunde kann den Status über diesen Abfrage-Endpunkt prüfen

Seriennummer prüfen

POST /api/public/serial-numbers/validate

Pflichtfelder im Body: serialNumber, orgId

Gibt bei gültiger Seriennummer { "valid": true } mit den Details der Seriennummer zurück (Produkt-ID, Garantie-ID, Gültigkeitszeitraum).

Ist sie ungültig, wird { "valid": false } mit dem Grund zurückgegeben: bereits registriert, abgelaufen, widerrufen, noch nicht gültig, Registrierungszeitraum beendet oder nicht gefunden.

Status von Seriennummern

Seriennummern im Massenupload hochladen

Seriennummern werden im Dashboard per CSV hochgeladen:

1. Gehen Sie zu Dashboard > Seriennummern > Hochladen
2. Laden Sie eine CSV-Datei mit den Spalten serialNumber (erforderlich), productId, warrantyId, validFrom, validUntil hoch

Seriennummern müssen innerhalb einer Organisation eindeutig sein. Große Chargen werden asynchron verarbeitet.

Verwandte Themen

• Produkt-API — Endpunkt für die Produktregistrierung
• Garantie-API — Details zu Garantieplänen
• Authentifizierung — API-Zugangsdaten