> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Risoluzione dei problemi degli upgrade degli abbonamenti
> Soluzioni per i problemi più comuni degli Upgrade degli abbonamenti, inclusi gli avvisi di upgrade non riusciti, i problemi di connessione al provider e i menu a tendina dei piani di vendita vuoti.
Soluzioni per i problemi più comuni degli Upgrade degli abbonamenti. Se dopo aver provato queste soluzioni sei ancora bloccato, contatta il supporto con i dettagli elencati in [Test e verifica](/it/aftersell/subscription-upgrades-testing#when-something-looks-wrong).
## Monitorare gli upgrade non riusciti
Aftersell monitora gli upgrade con fallimento definitivo su una finestra mobile di 7 giorni. Se il numero di fallimenti supera la soglia di avviso, sulla tua home page compare un **banner di avvertimento** che descrive quanti upgrade sono falliti e in quanti giorni. Lo stesso avviso compare anche nel pannello **Needs attention** della [home page](/it/aftersell/home/needs-attention).
L'avviso include un pulsante **Review orders** che ti porta direttamente al browser degli ordini filtrato sui problemi di upgrade degli abbonamenti, così puoi vedere gli ordini interessati e la causa specifica di ciascun fallimento. Si cancella automaticamente quando il numero di fallimenti scende sotto la soglia entro la finestra mobile. Se vedi questo avviso, apri il browser degli ordini e controlla la causa mostrata su ogni ordine interessato, poi fai riferimento ai passaggi di risoluzione pertinenti qui sotto.
Il template **Subscription Upgrade** non è mai nascosto — è sempre elencato sotto **Add Funnel**, qualunque sia la configurazione del tuo provider. Ciò che ti blocca è il controllo di connessione dello Step 1: **Continue** resta disabilitato finché **Test API key** non restituisce **API key verified** con una spunta verde.
Due esiti diversi mostrano la stessa icona rossa di annullamento, quindi leggi il messaggio accanto ad essa:
* **Il tuo provider ha rifiutato la chiave.** Il token è privo degli scope richiesti o è stato revocato, e il messaggio indica il problema specifico. Emetti un nuovo token nella dashboard del tuo provider con gli scope elencati in [Configurazione e impostazioni](/it/aftersell/subscription-upgrades-setup), incollalo e ripeti il test.
* **Aftersell non è riuscito a raggiungere il tuo provider** — "Could not verify the API key. Please try again." Non c'è necessariamente nulla di sbagliato nel token; la chiamata stessa è fallita. Clicca di nuovo su **Test API key**.
Modificare il provider o il token azzera il verdetto precedente, quindi ripeti il test dopo ogni modifica.
È il comportamento previsto. Il prodotto è il prodotto dell'offerta, la riga segnaposto aggiunta all'ordine Shopify come registrazione dell'upgrade accettato. Per ridurre la confusione, rinomina il prodotto dell'offerta con un nome chiaro e aggiungi una descrizione in Shopify Admin che spieghi cosa rappresenta. Vedi [Cosa vede il cliente](/it/aftersell/subscription-upgrades#what-the-customer-sees).
Il changeset di Shopify e la chiamata API al provider sono indipendenti. Se il prodotto dell'offerta è stato aggiunto all'ordine ma l'abbonamento non è stato modificato, le cause più comuni sono:
* Il token API del tuo provider è scaduto o non dispone delle autorizzazioni richieste. Per Recharge, il token deve avere `read_orders`, `read_subscriptions`, `write_subscriptions` e `read_plans`. Vai allo **Step 1: Connect provider**, ripeti il test della chiave e controlla il messaggio di errore per gli scope specifici mancanti.
* Il prodotto idoneo nel funnel non corrisponde a ciò a cui il cliente si è effettivamente abbonato.
* Per Loop, il piano di vendita target non esiste nella tua dashboard di Loop per la frequenza configurata.
* Il flusso di lavoro dei nuovi tentativi potrebbe essere ancora in corso secondo la sua pianificazione: dopo una chiamata fallita riprova a +1 ora e poi a +24 ore. Questo vale per ogni provider — Loop incluso, le cui chiamate di upgrade sono sincrone e compaiono nella dashboard immediatamente quando riescono.
Aftersell riprova automaticamente le chiamate al provider non riuscite in un flusso di lavoro in background. Il flusso di lavoro controlla lo stato corrente del provider prima di rieseguire la chiamata, quindi un upgrade riuscito ma lento non viene applicato due volte.
Se un nuovo tentativo non può risolvere la causa, il flusso di lavoro **rimborsa l'addebito** — quando nessuna modifica presso il provider è riuscita e la riga addebitata era un segnaposto — oppure contrassegna l'upgrade per la **riconciliazione manuale**, lasciando l'ordine intatto. I nuovi abbonamenti e gli upgrade di box non vengono mai rimborsati automaticamente, perché l'acquirente riceve prodotti reali. Contatta il supporto con i dettagli elencati in [Test e verifica](/it/aftersell/subscription-upgrades-testing#when-something-looks-wrong).
L'opzione "Use an existing selling plan" recupera i piani direttamente da Recharge, Skio o Loop. Se il menu a tendina è vuoto:
* Verifica che i piani di vendita siano configurati nella dashboard del tuo provider.
* Assicurati che il tuo token API abbia accesso in lettura ai Plans (Recharge: scope `read_plans`) o gli scope appropriati (Skio, Loop).
* Torna allo **Step 1: Connect provider**, ripeti il test della tua chiave API e continua.
È il comportamento previsto. Su Loop il campo **Billing frequency** non viene mostrato affatto — solo **Delivery frequency**, con la nota "Loop syncs billing to delivery — customers are charged on each renewal". Qualunque cosa imposti come frequenza di consegna è anche la frequenza di fatturazione.
È anche il motivo per cui gli abbonamenti prepagati — una frequenza di fatturazione più lunga della frequenza di consegna — non sono supportati su Loop: l'integrazione li rifiuta direttamente anziché offrire un campo che non puoi usare. Gli altri provider mostrano entrambi i campi.
Il prodotto dell'offerta è solo in abbonamento — il prodotto stesso, oppure ognuna delle sue varianti — e il checkout del cliente conteneva già un abbonamento. Shopify non consente un secondo abbonamento sullo stesso ordine, quindi l'offerta è stata saltata.
Il pannello dei dettagli dell'ordine specifica quale dei due casi si è verificato: "The customer's checkout already has a subscription, and the offer product is subscription-only", oppure "All variants of the offer product are subscriptions, and the customer's checkout already has one." Entrambi si risolvono allo stesso modo — modifica la selezione del prodotto dell'offerta sostituendolo con un prodotto ad acquisto una tantum, oppure usa l'opzione **Create new** nello **Step 4: Offer product** per generare un segnaposto.
* Verifica che **Show this funnel for all customers** non sia abilitato. Sovrascrive tutti gli altri trigger.
* Controlla il trigger **Variant on subscription**. Mostra il funnel solo quando l'ordine include uno dei prodotti selezionati *acquistato come abbonamento*. In un funnel che ha un'offerta di upgrade dell'abbonamento, la procedura guidata gestisce questo trigger e lo mantiene sincronizzato con il prodotto oggetto dell'upgrade, quindi è in sola lettura — il pannello riporta "Managed by this funnel's subscription upgrade offer." Se sta puntando ai prodotti sbagliati, correggi il prodotto trigger dell'offerta di upgrade anziché il trigger stesso.
* Controlla la priorità dei funnel. Un funnel con priorità più alta e trigger più ampi potrebbe attivarsi per primo.
Non provare a riprodurre questo comportamento con un trigger di prodotto separato più un trigger di abbonamento. Quella coppia è esattamente ciò che **Variant on subscription** ha sostituito: le due condizioni venivano valutate in modo indipendente, quindi un ordine contenente il tuo prodotto trigger come acquisto una tantum *e* un articolo in abbonamento non correlato le soddisfaceva entrambe, attivava il funnel, e l'upgrade falliva poi a valle. Un unico trigger, che abbina insieme prodotto e stato di abbonamento, è la configurazione supportata.