API Garanzie

Usa l’API Garanzie per recuperare i dettagli dei piani di garanzia e verificare l’idoneità dei prodotti alla copertura in garanzia.

Ottenere una garanzia per ID

GET /api/public/warranty/{warrantyId}

Restituisce i dettagli del piano di garanzia e il prodotto Shopify che lo rappresenta (usato per aggiungere la garanzia al carrello).

Parametro di percorso: warrantyId (obbligatorio) — l’ID del piano di garanzia.

Restituisce l’oggetto garanzia con tipo di piano, stato, termini (durata e prezzo), dettagli della copertura e il prodotto Shopify corrispondente con ID e prezzi delle varianti.

Verificare l’idoneità alla garanzia (per prodotto)

GET / POST /api/public/warranty-eligibility

Verifica se un prodotto è idoneo alla copertura in garanzia e restituisce i piani disponibili. È l’endpoint principale usato dal widget del negozio.

Header obbligatori:

• X-Shopify-Shop-Domain — il dominio del tuo negozio
• X-Shopify-Product-Id — l’ID del prodotto da verificare (oppure passalo nel body o nella query)

Parametri del body POST o della query GET:

• shopifyShopDomain (obbligatorio) — il dominio del tuo negozio
• eligibleProductId (obbligatorio) — l’ID del prodotto Shopify
• cached (facoltativo) — imposta false per ignorare la cache

Restituisce la garanzia estesa idonea (con i dati del prodotto Shopify), la garanzia OEM idonea, i limiti del piano, le informazioni sul commerciante, la lingua, le traduzioni e i dati sulla valuta.

Verificare l’idoneità alla garanzia (riga d’ordine)

POST /api/public/warranty/eligibility

Verifica l’idoneità di una specifica riga d’ordine. Usato nei contesti post-acquisto e della pagina di stato dell’ordine.

Header obbligatorio: X-Shopify-Shop-Domain

Parametri del body:

• orderId o orderName (uno dei due obbligatorio) — identifica l’ordine
• lineItemId, variantId o position (almeno uno obbligatorio) — identifica la riga d’ordine

L’endpoint cerca la riga d’ordine prima per lineItemId, poi per variantId, infine per position. Il formato della risposta è lo stesso dell’endpoint di idoneità per prodotto.

Tipi di piano

Tipo di piano	Valore	Descrizione
Garanzia estesa	extended_warranty	Garanzia a pagamento acquistata al checkout
Garanzia OEM	oem_warranty	Garanzia del produttore inclusa senza costi

Correlati

• Autenticazione — Credenziali API e limiti di frequenza
• Panoramica degli endpoint — Elenco completo degli endpoint
• API Prodotti — Ricerca dei prodotti e idoneità
• API Polizze — Gestione delle polizze dopo l’acquisto