API Registrazioni e numeri di serie
Gestisci le registrazioni dei prodotti e i numeri di serie tramite l'API
API Registrazioni e numeri di serie
Usa questi endpoint per consultare le registrazioni dei prodotti e convalidare i numeri di serie ai fini della copertura in garanzia.
Consultare una registrazione
GET /api/public/registration/lookup
Parametri di query:
registrationNumber(obbligatorio) — ad es.UMB-REG-00089orgId(obbligatorio) — ID dell’organizzazione
Restituisce il record della registrazione, con dettagli del prodotto, informazioni sul cliente, stato, data di acquisto e garanzia associata.
Stati della registrazione
| Stato | Descrizione |
|---|---|
pending | Inviata, in attesa dell’esame del commerciante |
approved | Approvata dal commerciante |
denied | Rifiutata dal commerciante |
expired | Periodo di esame di 30 giorni scaduto senza alcuna azione |
Flusso di registrazione
- Il cliente invia la registrazione tramite
POST /api/public/products/register(vedi API Prodotti) - Il sistema convalida i dati del prodotto e del cliente e crea una registrazione con stato
pending - Il cliente riceve un’email di conferma con il proprio numero di registrazione
- Il commerciante esamina la registrazione e la approva o la rifiuta nella dashboard
- Il cliente può controllarne lo stato con questo endpoint di consultazione
Convalidare un numero di serie
POST /api/public/serial-numbers/validate
Campi obbligatori del body: serialNumber, orgId
Se il numero è valido, restituisce { "valid": true } con i dettagli del numero di serie (ID prodotto, ID garanzia, date di validità).
Se non è valido, restituisce { "valid": false } con il motivo: già registrato, scaduto, revocato, non ancora valido, periodo di registrazione terminato o non trovato.
Stati del numero di serie
| Stato | Descrizione |
|---|---|
active | Disponibile per la registrazione |
registered | Già usato in una registrazione |
expired | Periodo di validità terminato |
revoked | Revocato dal commerciante |
Caricare numeri di serie in blocco
I numeri di serie si caricano tramite CSV nella dashboard:
- Vai su Dashboard > Numeri di serie > Carica
- Carica un CSV con le colonne:
serialNumber(obbligatoria),productId,warrantyId,validFrom,validUntil
I numeri di serie devono essere univoci all’interno di un’organizzazione. I lotti di grandi dimensioni vengono elaborati in modo asincrono.
Correlati
- API Prodotti — Endpoint di registrazione dei prodotti
- API Garanzie — Dettagli dei piani di garanzia
- Autenticazione — Credenziali API
