API Prodotti

Usa l’API Prodotti per cercare i prodotti sincronizzati, verificare in blocco l’idoneità alla garanzia e registrare i prodotti per la copertura in garanzia.

Cercare prodotti

GET /api/public/products/search

Cerca nel catalogo prodotti sincronizzato per titolo, SKU, codice a barre o fornitore.

Parametri di query:

• search (obbligatorio) — testo di ricerca, minimo 2 caratteri
• limit (facoltativo) — numero massimo di risultati, predefinito 20, massimo 50
• myshopifyDomain (facoltativo) — filtra per dominio del negozio
• orgId (facoltativo) — se indicato, i risultati includono i dati di idoneità (isEligible, warrantyIds, regole corrispondenti)

Verificare l’idoneità dei prodotti (in blocco)

GET /api/public/products/eligibility

Verifica l’idoneità alla garanzia di più prodotti contemporaneamente.

Parametri di query:

• productIdsString (obbligatorio) — ID dei prodotti separati da virgole
• orgId (obbligatorio) — ID dell’organizzazione

Restituisce ogni prodotto con isEligible, defaultExtendedWarrantyId, defaultOEMWarrantyId e warrantyIds.

Registrare un prodotto

POST /api/public/products/register

Registra un prodotto per la copertura in garanzia tramite il modulo di registrazione rivolto ai clienti.

Campi obbligatori: productId, purchaseDate, purchasedFrom, customerName, customerEmail, shopDomain

Campi facoltativi: customerPhone, orderNumber, serialNumber, warrantyId, warrantyType, warrantyTerm, purchaseProofFileCount, productPhotoFileCount

Regole di convalida:

• La data di acquisto deve essere oggi o precedente, e compresa negli ultimi 2 anni
• L’email deve avere un formato valido
• Il prodotto deve esistere nel negozio Shopify
• Il dominio del negozio deve essere registrato in Umbrella

In caso di successo, restituisce un registrationId e un registrationNumber con stato pending. Al cliente viene inviata un’email di conferma e il commerciante ha 30 giorni per esaminare la registrazione.

Correlati

• Autenticazione — Credenziali API
• API Garanzie — Gestione dei piani di garanzia
• API Registrazioni e numeri di serie — Ricerca delle registrazioni e convalida dei numeri di serie
• Panoramica degli endpoint — Elenco completo degli endpoint