API d'enregistrement et de numéros de série
Gérez les enregistrements de produits et les numéros de série via l'API
API d’enregistrement et de numéros de série
Utilisez ces points de terminaison pour rechercher des enregistrements de produits et valider des numéros de série en vue de la couverture de garantie.
Rechercher un enregistrement
GET /api/public/registration/lookup
Paramètres de requête :
registrationNumber(obligatoire) — par ex.UMB-REG-00089orgId(obligatoire) — ID de l’organisation
Renvoie la fiche d’enregistrement, avec le détail du produit, les informations du client, le statut, la date d’achat et la garantie associée.
Statuts d’enregistrement
| Statut | Description |
|---|---|
pending | Soumis, en attente d’examen par le commerçant |
approved | Approuvé par le commerçant |
denied | Refusé par le commerçant |
expired | Délai d’examen de 30 jours expiré sans action |
Processus d’enregistrement
- Le client soumet son enregistrement via
POST /api/public/products/register(voir API Produits) - Le système valide les données du produit et du client, puis crée un enregistrement au statut
pending - Le client reçoit un e-mail de confirmation avec son numéro d’enregistrement
- Le commerçant l’examine, puis l’approuve ou le refuse dans le tableau de bord
- Le client peut vérifier le statut à l’aide de ce point de terminaison de recherche
Valider un numéro de série
POST /api/public/serial-numbers/validate
Champs obligatoires du corps : serialNumber, orgId
S’il est valide, renvoie { "valid": true } avec le détail du numéro de série (ID du produit, ID de la garantie, dates de validité).
S’il n’est pas valide, renvoie { "valid": false } avec le motif : déjà enregistré, expiré, révoqué, pas encore valide, période d’enregistrement terminée ou introuvable.
Statuts des numéros de série
| Statut | Description |
|---|---|
active | Disponible pour l’enregistrement |
registered | Déjà utilisé dans un enregistrement |
expired | Période de validité terminée |
revoked | Révoqué par le commerçant |
Importer des numéros de série en masse
Les numéros de série s’importent au format CSV depuis le tableau de bord :
- Allez dans Tableau de bord > Numéros de série > Importer
- Importez un fichier CSV avec les colonnes :
serialNumber(obligatoire),productId,warrantyId,validFrom,validUntil
Les numéros de série doivent être uniques au sein d’une organisation. Les lots volumineux sont traités de manière asynchrone.
Voir aussi
- API Produits — Point de terminaison d’enregistrement des produits
- API Garanties — Détail des plans de garantie
- Authentification — Identifiants d’API
