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 Pulsante flottante) 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 e riprova. Nell'app l'importo è quello suggerito da Shopify per gli articoli selezionati e non si modifica; se ti serve un importo diverso, effettua il rimborso dall'ordine stesso in Shopify: returnEasier lo registra solo se quell'ordine ha un'unica richiesta in sospeso (se ce ne sono diverse, non lo assegna), se il rimborso copre esattamente gli articoli e le quantità di quella richiesta e se restituisce denaro (un rimborso del solo importo, senza articoli, non conta; in un recesso, inoltre, deve andare al metodo di pagamento originale, non al saldo del negozio). Altrimenti la richiesta resta aperta in returnEasier anche se Shopify ha già restituito il denaro. 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 («Generazione dell'etichetta…» e poi «Etichetta pronta», «In attesa di verifica» o «Etichetta non generata»). Se è rimasta in «Etichetta non generata», premi «Riprova etichetta»; se è «In attesa di verifica», premi «Verifica in Sendcloud» nel dettaglio della richiesta (o «Scarta etichetta in sospeso» se non è stata creata).
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 email del tuo negozio in Shopify (quello che Shopify usa per scrivere a te, non quello di contatto con i clienti). 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 «Invia di nuovo la conferma» (solo per i recessi). È idempotente: non duplica. Se la cronologia mostra «Ricevuta non inviata (rinviala da questa schermata)», l'invio automatico non è riuscito e il pulsante si chiama «Invia conferma».
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 hai annullato, l'app passa a Free quando rileva l'annullamento; se sei sceso di piano, al piano che Shopify indica come attivo. 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.
- Gestiamo al massimo 3 richieste all'ora per indirizzo email, negozio e via —recesso e reso commerciale hanno quote separate—, non per ordine (cambiare il numero d'ordine non lo azzera). Conta la richiesta verificata, non l'email ricevuta: se il nostro invio fallisce, il tentativo è già consumato. Quel limite è silenzioso: la schermata continua a dire «stiamo verificando» e semplicemente non parte un'altra email; il link precedente resta valido per la sua ora.
- Se quello che vede è l'avviso «troppi tentativi», quello è un altro limite: va per connessione a internet (IP), non per email, e protegge il modulo da chi prova dati a caso. Che attenda un po': il limite si libera da solo. Se è urgente, verifica tu i dati dell'ordine e ricontattalo.
La versione per il cliente è nel centro assistenza, sezione acquirenti.
Il blocco «Gestione resi» non appare nel negozio
È di Pro e superiori: in Free e Compliance non viene mostrato anche se lo posizioni. Dopo aver cambiato piano, apri returnEasier perché l'app sincronizzi il tuo piano con il negozio. Se scendi sotto Pro, il portale commerciale non è più disponibile.
Se il servizio che limita i tentativi non funziona
Se quel servizio non risponde, il recesso continua a funzionare (con un limite provvisorio); il reso commerciale e il caricamento delle foto vengono rifiutati finché non torna disponibile.
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.