API регистраций и серийных номеров
Управление регистрациями товаров и серийными номерами через API
API регистраций и серийных номеров
Используйте эти эндпоинты, чтобы находить регистрации товаров и проверять серийные номера для гарантийного покрытия.
Поиск регистрации
GET /api/public/registration/lookup
Параметры запроса:
registrationNumber(обязательный) — например,UMB-REG-00089orgId(обязательный) — ID организации
Возвращает запись о регистрации, включая сведения о товаре, данные покупателя, статус, дату покупки и связанную гарантию.
Статусы регистрации
| Статус | Описание |
|---|---|
pending | Отправлена, ожидает рассмотрения продавцом |
approved | Одобрена продавцом |
denied | Отклонена продавцом |
expired | 30-дневный срок рассмотрения истёк без действий |
Процесс регистрации
- Покупатель отправляет регистрацию через
POST /api/public/products/register(см. API товаров) - Система проверяет данные товара и покупателя и создаёт регистрацию со статусом
pending - Покупатель получает письмо с подтверждением и номером регистрации
- Продавец рассматривает её в панели управления и одобряет или отклоняет
- Покупатель может проверить статус через этот эндпоинт поиска
Проверка серийного номера
POST /api/public/serial-numbers/validate
Обязательные поля тела запроса: serialNumber, orgId
Если номер действителен, возвращает { "valid": true } со сведениями о серийном номере (ID товара, ID гарантии, даты действия).
Если номер недействителен, возвращает { "valid": false } с причиной: уже зарегистрирован, истёк, отозван, ещё не действует, срок регистрации закончился или не найден.
Статусы серийных номеров
| Статус | Описание |
|---|---|
active | Доступен для регистрации |
registered | Уже использован в регистрации |
expired | Срок действия истёк |
revoked | Отозван продавцом |
Массовая загрузка серийных номеров
Серийные номера загружаются в панели управления через CSV:
- Перейдите в Панель управления > Серийные номера > Загрузить
- Загрузите CSV со столбцами:
serialNumber(обязательный),productId,warrantyId,validFrom,validUntil
Серийные номера должны быть уникальными в пределах организации. Большие партии обрабатываются асинхронно.
Связанные материалы
- API товаров — эндпоинт регистрации товаров
- API гарантий — сведения о гарантийных планах
- Аутентификация — учётные данные API
