> ## 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.
# Rozwiązywanie problemów z ulepszeniami subskrypcji
> Rozwiązania typowych problemów z ulepszeniami subskrypcji, w tym alertów o nieudanych ulepszeniach, problemów z połączeniem dostawcy i pustych list planów sprzedaży.
Rozwiązania najczęstszych problemów z ulepszeniami subskrypcji. Jeśli po ich wypróbowaniu nadal masz problem, skontaktuj się z pomocą techniczną, podając dane wymienione w sekcji [Testowanie i weryfikacja](/pl/aftersell/subscription-upgrades-testing#when-something-looks-wrong).
## Monitorowanie nieudanych ulepszeń
Aftersell monitoruje ostateczne niepowodzenia ulepszeń w kroczącym oknie 7-dniowym. Jeśli liczba niepowodzeń przekroczy próg alertu, na Twojej stronie głównej pojawi się **baner ostrzegawczy** informujący, ile ulepszeń się nie powiodło i w ciągu ilu dni. Ten sam alert pojawia się także w panelu **Needs attention** na [stronie głównej](/pl/aftersell/home/needs-attention).
Alert zawiera przycisk **Review orders**, który przenosi Cię bezpośrednio do przeglądarki zamówień odfiltrowanej do problemów z ulepszeniami subskrypcji, dzięki czemu możesz zobaczyć dotknięte zamówienia i konkretną przyczynę każdego niepowodzenia. Alert znika automatycznie, gdy liczba niepowodzeń spadnie poniżej progu w kroczącym oknie. Jeśli widzisz ten alert, otwórz przeglądarkę zamówień, sprawdź przyczynę pokazaną przy każdym dotkniętym zamówieniu, a następnie skorzystaj z odpowiednich kroków rozwiązywania problemów poniżej.
Szablon **Subscription Upgrade** nigdy nie jest ukryty — jest zawsze widoczny w sekcji **Add Funnel**, niezależnie od konfiguracji dostawcy. Blokuje Cię weryfikacja połączenia w Kroku 1: przycisk **Continue** pozostaje nieaktywny, dopóki **Test API key** nie zwróci **API key verified** z zielonym znacznikiem.
Dwa różne wyniki wyświetlają tę samą czerwoną ikonę anulowania, więc przeczytaj komunikat obok niej:
* **Twój dostawca odrzucił klucz.** Tokenowi brakuje wymaganych zakresów uprawnień lub został unieważniony, a komunikat wskazuje konkretny problem. Wydaj nowy token w panelu dostawcy z zakresami wymienionymi w artykule [Konfiguracja](/pl/aftersell/subscription-upgrades-setup), wklej go i przetestuj ponownie.
* **Aftersell nie mógł połączyć się z dostawcą** — „Could not verify the API key. Please try again.” Z tokenem niekoniecznie jest coś nie tak; samo wywołanie się nie powiodło. Kliknij ponownie **Test API key**.
Edycja dostawcy lub tokenu czyści poprzedni wynik, więc po każdej zmianie przetestuj ponownie.
To oczekiwane zachowanie. Ten produkt to produkt oferty — pozycja zastępcza dodana do zamówienia Shopify jako zapis zaakceptowanego ulepszenia. Aby ograniczyć nieporozumienia, zmień nazwę produktu oferty na coś jasnego i dodaj w Shopify Admin opis wyjaśniający, co on reprezentuje. Zobacz [Co widzi klient](/pl/aftersell/subscription-upgrades#what-the-customer-sees).
Zestaw zmian w Shopify i wywołanie API dostawcy są od siebie niezależne. Jeśli produkt oferty został dodany do zamówienia, ale subskrypcja nie została zmieniona, najczęstsze przyczyny to:
* Twój token API dostawcy wygasł lub brakuje mu wymaganych uprawnień. W przypadku Recharge token musi mieć zakresy `read_orders`, `read_subscriptions`, `write_subscriptions` i `read_plans`. Przejdź do **Kroku 1: Połącz dostawcę**, ponownie przetestuj klucz i sprawdź w komunikacie błędu konkretne brakujące zakresy.
* Kwalifikujący się produkt w lejku nie odpowiada temu, co klient faktycznie subskrybował.
* W przypadku Loop docelowy plan sprzedaży nie istnieje w Twoim panelu Loop dla skonfigurowanej częstotliwości.
* Proces ponawiania może wciąż realizować swój harmonogram: po nieudanym wywołaniu próbuje ponownie po +1 godzinie, a następnie po +24 godzinach. Dotyczy to każdego dostawcy — również Loop, którego wywołania ulepszeń są synchroniczne i po powodzeniu od razu widoczne w panelu.
Aftersell automatycznie ponawia nieudane wywołania dostawcy w procesie działającym w tle. Proces sprawdza bieżący stan u dostawcy przed ponownym uruchomieniem, więc udane, ale powolne ulepszenie nie zostanie zastosowane dwukrotnie.
Jeśli ponowienie nie może naprawić przyczyny, proces albo **zwraca opłatę** — gdy żadna modyfikacja u dostawcy się nie powiodła, a obciążona pozycja była produktem zastępczym — albo oznacza ulepszenie do **ręcznego rozliczenia**, pozostawiając zamówienie bez zmian. Zupełnie nowe subskrypcje i ulepszenia boxów nigdy nie są automatycznie zwracane, ponieważ kupujący otrzymuje prawdziwe produkty. Skontaktuj się z pomocą techniczną, podając dane wymienione w sekcji [Testowanie i weryfikacja](/pl/aftersell/subscription-upgrades-testing#when-something-looks-wrong).
Opcja „Use an existing selling plan” pobiera plany bezpośrednio z Recharge, Skio lub Loop. Jeśli lista jest pusta:
* Potwierdź, że plany sprzedaży są skonfigurowane w panelu dostawcy.
* Upewnij się, że Twój token API ma dostęp do odczytu Plans (Recharge: zakres `read_plans`) lub odpowiednie zakresy (Skio, Loop).
* Wróć do **Kroku 1: Połącz dostawcę**, ponownie przetestuj klucz API i kontynuuj.
To oczekiwane zachowanie. W Loop pole **Billing frequency** w ogóle nie jest wyświetlane — tylko **Delivery frequency**, z adnotacją „Loop syncs billing to delivery — customers are charged on each renewal”. Cokolwiek ustawisz jako częstotliwość dostaw, jest też częstotliwością rozliczeń.
Właśnie dlatego subskrypcje prepaid — z częstotliwością rozliczeń dłuższą niż częstotliwość dostaw — nie są obsługiwane w Loop: integracja odrzuca je wprost, zamiast oferować pole, którego nie możesz użyć. Pozostali dostawcy pokazują oba pola.
Produkt oferty jest dostępny wyłącznie w subskrypcji — sam produkt lub wszystkie jego warianty — a checkout klienta zawierał już subskrypcję. Shopify nie pozwala na drugą subskrypcję w tym samym zamówieniu, więc oferta została pominięta.
Panel szczegółów zamówienia precyzuje, który to był przypadek: „The customer's checkout already has a subscription, and the offer product is subscription-only” albo „All variants of the offer product are subscriptions, and the customer's checkout already has one.” Oba naprawia się tak samo — edytuj wybór produktu w ofercie i podmień na produkt do zakupu jednorazowego, albo użyj opcji **Create new** w **Kroku 4: Produkt oferty**, aby wygenerować produkt zastępczy.
* Sprawdź, czy opcja **Show this funnel for all customers** nie jest włączona. Nadpisuje ona wszystkie inne wyzwalacze.
* Sprawdź wyzwalacz **Variant on subscription**. Wyświetla on lejek tylko wtedy, gdy zamówienie zawiera jeden z wybranych produktów *kupionych w subskrypcji*. W lejku z ofertą ulepszenia subskrypcji kreator zarządza tym wyzwalaczem i utrzymuje go w synchronizacji z ulepszanym produktem, więc jest on tylko do odczytu — panel wyświetla „Managed by this funnel's subscription upgrade offer.” Jeśli celuje w niewłaściwe produkty, popraw produkt wyzwalający oferty ulepszenia, a nie sam wyzwalacz.
* Sprawdź priorytet lejków. Lejek o wyższym priorytecie z szerszymi wyzwalaczami może uruchamiać się jako pierwszy.
Nie próbuj odtwarzać tego za pomocą osobnego wyzwalacza produktowego w połączeniu z wyzwalaczem subskrypcyjnym. To połączenie jest dokładnie tym, co zastąpił **Variant on subscription**: oba warunki były dopasowywane niezależnie, więc zamówienie zawierające Twój produkt wyzwalający jako zakup jednorazowy *oraz* niepowiązany produkt subskrypcyjny spełniało oba, uruchamiało lejek, a ulepszenie kończyło się później błędem. Jeden wyzwalacz, dopasowujący jednocześnie produkt i stan subskrypcji, to wspierana konfiguracja.