API de registros y números de serie
Gestiona los registros de productos y los números de serie mediante la API
API de registros y números de serie
Usa estos endpoints para consultar registros de productos y validar números de serie para la cobertura de garantía.
Consultar un registro
GET /api/public/registration/lookup
Parámetros de consulta:
registrationNumber(obligatorio) — p. ej.,UMB-REG-00089orgId(obligatorio) — ID de la organización
Devuelve el registro con los detalles del producto, los datos del cliente, el estado, la fecha de compra y la garantía asociada.
Estados del registro
| Estado | Descripción |
|---|---|
pending | Enviado, en espera de la revisión del comerciante |
approved | Aprobado por el comerciante |
denied | Rechazado por el comerciante |
expired | El periodo de revisión de 30 días venció sin ninguna acción |
Flujo de registro
- El cliente envía el registro mediante
POST /api/public/products/register(consulta la API de productos) - El sistema valida los datos del producto y del cliente, y crea un registro con estado
pending - El cliente recibe un correo electrónico de confirmación con su número de registro
- El comerciante lo revisa y lo aprueba o rechaza en el panel
- El cliente puede consultar el estado con este endpoint de consulta
Validar un número de serie
POST /api/public/serial-numbers/validate
Campos obligatorios del cuerpo: serialNumber, orgId
Si es válido, devuelve { "valid": true } con los detalles del número de serie (ID del producto, ID de la garantía, fechas de validez).
Si no es válido, devuelve { "valid": false } con el motivo: ya registrado, vencido, revocado, aún no válido, periodo de registro finalizado o no encontrado.
Estados del número de serie
| Estado | Descripción |
|---|---|
active | Disponible para registro |
registered | Ya se usó en un registro |
expired | El periodo de validez terminó |
revoked | Revocado por el comerciante |
Carga masiva de números de serie
Los números de serie se cargan mediante un CSV en el panel:
- Ve a Panel > Números de serie > Subir
- Sube un CSV con las columnas:
serialNumber(obligatoria),productId,warrantyId,validFrom,validUntil
Los números de serie deben ser únicos dentro de una organización. Los lotes grandes se procesan de forma asíncrona.
Relacionado
- API de productos — Endpoint de registro de productos
- API de garantías — Detalles de los planes de garantía
- Autenticación — Credenciales de la API
