API de productos

Usa la API de productos para buscar productos sincronizados, verificar en lote la elegibilidad para la garantía y registrar productos para la cobertura de garantía.

Buscar productos

GET /api/public/products/search

Busca en tu catálogo de productos sincronizados por título, SKU, código de barras o proveedor.

Parámetros de consulta:

• search (obligatorio) — texto de búsqueda, mínimo 2 caracteres
• limit (opcional) — máximo de resultados; 20 de forma predeterminada, 50 como máximo
• myshopifyDomain (opcional) — filtra por dominio de la tienda
• orgId (opcional) — si se proporciona, los resultados incluyen datos de elegibilidad (isEligible, warrantyIds, reglas que coinciden)

Verificar la elegibilidad de productos (en lote)

GET /api/public/products/eligibility

Verifica la elegibilidad para la garantía de varios productos a la vez.

Parámetros de consulta:

• productIdsString (obligatorio) — IDs de productos separados por comas
• orgId (obligatorio) — ID de la organización

Devuelve cada producto con isEligible, defaultExtendedWarrantyId, defaultOEMWarrantyId y warrantyIds.

Registrar un producto

POST /api/public/products/register

Registra un producto para la cobertura de garantía a través del formulario de registro para clientes.

Campos obligatorios: productId, purchaseDate, purchasedFrom, customerName, customerEmail, shopDomain

Campos opcionales: customerPhone, orderNumber, serialNumber, warrantyId, warrantyType, warrantyTerm, purchaseProofFileCount, productPhotoFileCount

Reglas de validación:

• La fecha de compra debe ser hoy o anterior, y estar dentro de los últimos 2 años
• El correo electrónico debe tener un formato válido
• El producto debe existir en la tienda de Shopify
• El dominio de la tienda debe estar registrado en Umbrella

Si se completa correctamente, devuelve un registrationId y un registrationNumber con estado pending. Se envía un correo de confirmación al cliente, y el comerciante tiene 30 días para revisarlo.

Relacionado

• Autenticación — Credenciales de la API
• API de garantías — Gestión de planes de garantía
• API de registros y números de serie — Consulta de registros y validación de números de serie
• Resumen de endpoints — Lista completa de endpoints