Questa è la guida rapida ai problemi più comuni di returnEasier. Per ogni sintomo trovi la causa più probabile e come risolverlo. Se dopo questi passi rimani bloccato, scrivici dal modulo di contatto del centro assistenza.
Il pulsante di recesso non appare nel negozio
La causa quasi sempre è che l'App Embed non è attivato nel theme editor.
- In Shopify, vai a Negozio online → Temi → Personalizza.
- Apri Incorporamenti dell'app (App embeds), in fondo al pannello sinistro.
- Attiva returnEasier e salva.
- Verifica di guardare il tema pubblicato (non una bozza) e che la posizione scelta (footer, header o fluttuante) sia visibile.
Se usi l'App Block «Link di recesso» (il link discreto collocabile in una colonna del piè di pagina o una sezione), ricorda che va aggiunto a una sezione: Aggiungi blocco → App → Link di recesso. Il dettaglio è in «Attivare il pulsante di recesso nel tuo tema».
Il rimborso fallisce
Il rimborso lo esegue Shopify con la sua API (refundCreate); returnEasier lo istruisce soltanto, non tocca mai il denaro. Se fallisce, il messaggio viene da Shopify e di solito è dovuto a:
- L'ordine era già rimborsato (totalmente o parzialmente) e l'importo restante non quadra.
- L'importo supera quanto rimborsabile.
- Il metodo di pagamento non ammette rimborso automatico.
- Manca un permesso oppure l'ordine è in uno stato che non lo consente.
Cosa fare: leggi l'errore, regola l'importo (puoi effettuare rimborsi parziali) e riprova. Se Shopify non lo consente, effettua il rimborso dall'ordine stesso in Shopify e segnalo nella richiesta. Più contesto in «Azioni del Flusso Legale».
L'etichetta di spedizione non si genera
Le etichette di spedizione sono del piano Scale+ e integrano Sendcloud. Verifica, in ordine:
- Piano: devi essere su Scale (o superiore).
- Chiavi di Sendcloud: valide. Vengono validate in tempo reale al salvataggio; se falliscono, incollale di nuovo.
- Configurazione: indirizzo di reso, corriere e peso corretti.
- Stato dell'etichetta: l'etichetta passa per vari stati (senza etichetta → in generazione → creata / in attesa di verifica / fallita). Se è rimasta in fallita, premi riprova; se è in attesa di verifica, completala in Sendcloud.
Il dettaglio di tutta l'integrazione è in «Etichette di spedizione con Sendcloud».
Non mi arriva l'email
Dipende da quale email manca:
- Notifica di nuova richiesta (a te): va all'indirizzo di contatto del tuo negozio in Shopify (Impostazioni → Generali). Se è vuoto o non aggiornato, non arriva. Controlla anche la cartella spam.
- Conferma al cliente: se il cliente dice di non averla ricevuta, apri il dettaglio della richiesta e premi «Reinvia conferma» (solo per i recessi). È idempotente: non duplica.
Quali email esistono e quando vengono inviate è in «Quali email invia returnEasier e a chi?».
Il piano non si sincronizza
Con la fatturazione gestita di Shopify, il piano attivo si legge dall'API di Partner, non dall'Admin API (che non vede i piani gestiti). returnEasier riconcilia il piano all'apertura del pannello o della pagina dei Piani.
Cosa fare: riapri Piani per forzare la lettura. Un cambio di piano appena effettuato può richiedere qualche secondo per riflettersi. Se sei sceso di piano o hai annullato, l'app passa a Free al rilevamento dell'evento di annullamento. Tutto il flusso è in «Cambiare piano e fatturazione».
Il cliente non trova il suo ordine o il link è scaduto
Questo è dal lato del cliente, ma te lo possono chiedere:
- Il cliente deve usare la stessa email dell'ordine e il numero d'ordine così com'è.
- Il link magico scade in 1 ora: se è passato, deve ricominciare dal pulsante.
- C'è un limite di 3 tentativi all'ora per indirizzo email (cambiare il numero d'ordine non lo azzera).
La versione per il cliente è nel centro assistenza, sezione acquirenti.
Continuo a non risolverlo
Se nulla di quanto sopra funziona, scrivici dal modulo di contatto del centro assistenza con il tuo dominio di negozio, l'identificatore della richiesta (se applicabile) e una schermata dell'errore. Più sei concreto, più rapidamente ti aiutiamo.