API dei sinistri
Apri e gestisci i sinistri in garanzia in modo programmatico
API dei sinistri
Usa l’API dei sinistri per inviare sinistri in garanzia, caricare i file delle prove e consultare lo stato dei sinistri.
Inviare un sinistro
POST /api/public/claims/submit
Invia un sinistro su una polizza esistente. Il sinistro viene creato con stato pending e attiva le notifiche email al cliente e al commerciante.
Header (consigliati): X-Shopify-Shop-Domain, X-Shopify-Customer-Id
Campi obbligatori del body:
policyId— la polizza su cui aprire il sinistroclaimType— vedi i tipi di sinistro più sottodescription— cosa è successodateOfIncident— data ISO dell’evento
Facoltativi: additionalInfo
Tipi di sinistro
| Valore | Descrizione |
|---|---|
manufacturer_defect | Il prodotto si è guastato per un difetto di fabbricazione |
accidental_damage | Danneggiato accidentalmente |
wear_and_tear | Deteriorato dal normale utilizzo |
spill_or_stain | Danneggiato da liquidi o macchie |
lost_or_stolen | Smarrito o rubato |
other | Altro motivo |
In caso di successo restituisce claimId. Se la polizza ha raggiunto il limite di sinistri, restituisce un errore CLAIM_LIMIT_REACHED con i dettagli.
Inviare un sinistro manuale
POST /api/public/claims/submit-manual
Invia un sinistro senza una polizza esistente. Si usa per i sinistri avviati dal commerciante (ad esempio dal POS).
Header obbligatorio: X-Shopify-Shop-Domain
Campi obbligatori del body: customerEmail, customerName, productName, claimType, description, dateOfIncident
Facoltativi: customerPhone, orderNumber, additionalInfo
Recuperare i sinistri di una polizza
GET /api/public/claims/fetch?policy_id={policyId}
Header obbligatori: X-Shopify-Shop-Domain, X-Shopify-Customer-Id
Restituisce tutti i sinistri della polizza e del cliente indicati, con numero del sinistro, stato, tipo, motivo e date.
Ottenere le prove di un sinistro
GET /api/public/claims/{id}/evidence
Header obbligatori: X-Shopify-Shop-Domain, X-Shopify-Customer-Id
Restituisce i file delle prove (foto, video) allegati al sinistro.
Caricare i file delle prove
POST /api/public/claims/upload-urls
Genera un URL prefirmato per caricare le prove direttamente nel cloud storage.
Campi obbligatori del body: fileName, fileType (tipo MIME), fileSize (byte), claimId, fileCategory (photo o video)
Limiti dei file:
- Foto (JPEG, PNG, GIF, WebP): massimo 10 MB
- Video (MP4, QuickTime, WebM): massimo 100 MB
Flusso di caricamento:
- Chiama
/claims/upload-urlsper ottenere un URL prefirmato - Invia il file con PUT direttamente a quell’URL con l’header Content-Type corretto
Stati dei sinistri
| Stato | Descrizione |
|---|---|
pending | Inviato, in attesa della revisione del commerciante |
approved | Approvato dal commerciante |
denied | Rifiutato dal commerciante |
in_review | In fase di revisione |
resolved | Completamente risolto (sostituzione, rimborso, ecc.) |
Correlati
- API delle polizze — Cerca le polizze prima di aprire i sinistri
- API delle garanzie — Dettagli dei piani di garanzia
- Riferimento Webhook — Ricevi una notifica quando cambia lo stato di un sinistro
