API товаров

С помощью API товаров вы можете искать синхронизированные товары, пакетно проверять право на гарантию и регистрировать товары для гарантийного покрытия.

Поиск товаров

GET /api/public/products/search

Ищет в синхронизированном каталоге товаров по названию, SKU, штрихкоду или поставщику.

Параметры запроса:

• search (обязательный) — поисковый запрос, не менее 2 символов
• limit (необязательный) — максимум результатов, по умолчанию 20, не более 50
• myshopifyDomain (необязательный) — фильтр по домену магазина
• orgId (необязательный) — если указан, результаты включают данные о праве на гарантию (isEligible, warrantyIds, сработавшие правила)

Проверка права на гарантию (пакетно)

GET /api/public/products/eligibility

Проверяет право на гарантию сразу для нескольких товаров.

Параметры запроса:

• productIdsString (обязательный) — ID товаров через запятую
• orgId (обязательный) — ID организации

Возвращает каждый товар с полями isEligible, defaultExtendedWarrantyId, defaultOEMWarrantyId и warrantyIds.

Регистрация товара

POST /api/public/products/register

Регистрирует товар для гарантийного покрытия через форму регистрации для покупателей.

Обязательные поля: productId, purchaseDate, purchasedFrom, customerName, customerEmail, shopDomain

Необязательные поля: customerPhone, orderNumber, serialNumber, warrantyId, warrantyType, warrantyTerm, purchaseProofFileCount, productPhotoFileCount

Правила проверки:

• Дата покупки должна быть не позже сегодняшнего дня и не раньше чем 2 года назад
• Адрес электронной почты должен быть в корректном формате
• Товар должен существовать в магазине Shopify
• Домен магазина должен быть зарегистрирован в Umbrella

При успехе возвращает registrationId и registrationNumber со статусом pending. Покупателю отправляется письмо с подтверждением, а у продавца есть 30 дней на рассмотрение.

Связанные материалы

• Аутентификация — учётные данные API
• API гарантий — управление гарантийными планами
• API регистраций и серийных номеров — поиск регистраций и проверка серийных номеров
• Обзор эндпоинтов — полный список эндпоинтов