API de registros e números de série
Gerencie registros de produtos e números de série pela API
API de registros e números de série
Use estes endpoints para consultar registros de produtos e validar números de série para a cobertura de garantia.
Consultar um registro
GET /api/public/registration/lookup
Parâmetros de consulta:
registrationNumber(obrigatório) — por exemplo,UMB-REG-00089orgId(obrigatório) — ID da organização
Retorna o registro, incluindo os detalhes do produto, os dados do cliente, o status, a data da compra e a garantia associada.
Status de registro
| Status | Descrição |
|---|---|
pending | Enviado, aguardando a análise do lojista |
approved | Aprovado pelo lojista |
denied | Negado pelo lojista |
expired | O prazo de análise de 30 dias expirou sem nenhuma ação |
Fluxo de registro
- O cliente envia o registro via
POST /api/public/products/register(veja a API de produtos) - O sistema valida os dados do produto e do cliente e cria um registro com status
pending - O cliente recebe um e-mail de confirmação com o número do registro
- O lojista analisa e aprova ou nega no painel
- O cliente pode verificar o status usando este endpoint de consulta
Validar um número de série
POST /api/public/serial-numbers/validate
Campos obrigatórios no corpo: serialNumber, orgId
Se o número for válido, retorna { "valid": true } com os detalhes do número de série (ID do produto, ID da garantia, datas de validade).
Se for inválido, retorna { "valid": false } com o motivo: já registrado, expirado, revogado, ainda não válido, prazo de registro encerrado ou não encontrado.
Status de números de série
| Status | Descrição |
|---|---|
active | Disponível para registro |
registered | Já usado em um registro |
expired | Prazo de validade encerrado |
revoked | Revogado pelo lojista |
Envio de números de série em massa
Os números de série são enviados por CSV no painel:
- Acesse Painel > Números de série > Enviar
- Envie um CSV com as colunas:
serialNumber(obrigatória),productId,warrantyId,validFrom,validUntil
Os números de série devem ser únicos dentro de uma organização. Lotes grandes são processados de forma assíncrona.
Relacionados
- API de produtos — Endpoint de registro de produtos
- API de garantias — Detalhes dos planos de garantia
- Autenticação — Credenciais da API
