Sincronizzazione dei prodotti Shopify
Come prodotti, ordini e collezioni si sincronizzano tra Shopify e Umbrella.
Sincronizzazione dei prodotti Shopify
Umbrella usa i Webhook di Shopify per sincronizzare automaticamente e in tempo reale prodotti, collezioni, ordini, clienti e dati di evasione. Quando nel tuo negozio Shopify cambia qualcosa, Umbrella aggiorna in automatico l’idoneità alla garanzia, i prezzi e i record delle polizze.
Cosa viene sincronizzato
Prodotti
Umbrella sincronizza titolo, handle, tipo, fornitore, tag, varianti (ID, titolo, prezzo, SKU), immagini e appartenenza alle collezioni dei prodotti. Questi dati alimentano le regole di abbinamento dei piani di garanzia (ad esempio “applica a tutti i prodotti con tag ‘electronics’”).
Ordini
Umbrella elabora numero d’ordine, articoli, informazioni sul cliente, stato del pagamento, stato dell’evasione e dati su rimborsi e annullamenti. Su questi dati si basano la creazione e l’attivazione delle polizze di garanzia e il calcolo delle finestre per i sinistri.
Altri dati
- Collezioni — Usate per le regole di idoneità alla garanzia basate sulle collezioni
- Clienti — Associati alle polizze di garanzia per le ricerche per account
- Evasioni — Monitorate per stabilire quando si aprono le finestre per i sinistri (se configurate per partire alla spedizione)
Rielaborazione manuale
Se i dati non sembrano sincronizzati, avvia una rielaborazione manuale da Dashboard → Impostazioni → Integrazioni → Shopify:
- Rielabora prodotti — Recupera di nuovo tutti i prodotti e aggiorna la cache locale
- Rielabora ordini — Recupera di nuovo gli ordini recenti e riconcilia le polizze di garanzia
- Rielabora collezioni — Recupera di nuovo le collezioni e aggiorna le regole di idoneità
Con cataloghi di grandi dimensioni l’operazione può richiedere diversi minuti.
Affidabilità dei Webhook
- Shopify consegna i Webhook almeno una volta (i duplicati vengono gestiti in modo sicuro)
- Se l’endpoint del Webhook è temporaneamente non disponibile, Shopify ritenta con backoff esponenziale per un massimo di 48 ore
- Usa la rielaborazione manuale per recuperare eventuali dati mancanti
Risoluzione dei problemi
| Problema | Soluzione |
|---|---|
| I nuovi prodotti non compaiono nelle regole di garanzia | Attendi 1-2 minuti per l’elaborazione del Webhook, poi controlla lo stato di sincronizzazione dei prodotti |
| L’ordine non crea una polizza di garanzia | Verifica che l’ordine contenga un articolo di garanzia e che sia stato pagato |
| La finestra per i sinistri non si apre | Verifica che l’ordine sia stato evaso |
| Prodotti non sincronizzati dopo un’importazione in blocco | Usa la rielaborazione manuale per aggiornare tutti i dati dei prodotti |
Correlati
- Integrazione con Shopify — Configurazione generale della connessione a Shopify
- Estensioni di checkout Shopify — Visualizzazione della garanzia al checkout
- Creare piani di garanzia — Regole di idoneità dei prodotti


