> ## 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.

# Ulepszenia subskrypcji z Loop

> Przewodnik krok po kroku dotyczący łączenia Loop i konfigurowania ulepszeń subskrypcji (Subscription Upgrades) w Aftersell, w tym ograniczeń specyficznych dla Loop.

Ta strona opisuje wszystko, co dotyczy korzystania z **Loop** z ulepszeniami subskrypcji (Subscription Upgrades), w tym jego unikalne ograniczenia. Pełny przegląd działania ulepszeń subskrypcji znajdziesz w artykule [Ulepszenia subskrypcji](/pl/aftersell/subscription-upgrades).

<div id="supported-features">
  ## Obsługiwane funkcje
</div>

Loop obsługuje wszystkie typy ulepszeń subskrypcji:

* Zmiana częstotliwości dostaw lub rozliczeń
* Zamiana na inny produkt
* Oba – zmiana częstotliwości i zamiana produktu
* Dodanie kolejnego produktu subskrybowalnego do subskrypcji (zobacz [Dodawanie produktu](/pl/aftersell/subscription-upgrades-add-item))
* Wyłącznie częstotliwości postpaid (prepaid nie jest obsługiwany — zobacz [Ograniczenia](#loop-specific-limitations) poniżej)

<div id="loop-specific-limitations">
  ## Ograniczenia specyficzne dla Loop
</div>

* **Częstotliwość rozliczeń musi być równa częstotliwości dostaw.** Loop nie obsługuje subskrypcji prepaid przez tę integrację. Pole częstotliwości rozliczeń jest wyłączone i automatycznie synchronizowane z częstotliwością dostaw. To największe ograniczenie, o którym warto pamiętać, jeśli Twój sklep opiera się na planach prepaid.
* **Subskrypcje wielopozycyjne** są obsługiwane w dwóch krokach: docelowa pozycja produktowa jest wydzielana do nowej subskrypcji z żądaną częstotliwością, a następnie usuwana z pierwotnej. Wiąże się to z wieloma wywołaniami API i w oknie synchronizacji w panelu Loop mogą pojawić się tymczasowe pozycje w trakcie przetwarzania.
* **Niestandardowa częstotliwość nie jest obsługiwana dla subskrypcji wielopozycyjnych.** Gdy ustawisz częstotliwość ręcznie (bez wybierania planu sprzedaży), ulepszenie działa dla klientów, których subskrypcja zawiera jedną pozycję produktową. U klientów z subskrypcją wieloproduktową lub pakietową (dwie lub więcej aktywnych pozycji) ulepszenie nie powiedzie się, jeśli nie istnieje pasujący plan sprzedaży dla docelowej częstotliwości. Aby obsłużyć tych klientów, utwórz odpowiedni plan sprzedaży w panelu Loop.

<div id="generating-your-loop-api-token">
  ## Generowanie tokenu API Loop
</div>

1. Otwórz aplikację Loop i przejdź do **Settings** w lewym dolnym rogu.
2. W sekcji **Admin** kliknij **API Tokens**.
3. Ustaw uprawnienia, których potrzebuje Aftersell: **Read and Write** dla Subscription contracts oraz **Read** dla Orders i Selling plans. Dostęp do zapisu jest wymagany tylko dla subskrypcji.
4. Kliknij **Generate New Token**.
5. Podaj nazwę, wybierz odpowiednie zakresy uprawnień i kliknij **Generate Token**.
6. Kliknij **Show Token**, aby wyświetlić i skopiować klucz. Traktuj go jak hasło i przechowuj w bezpiecznym miejscu.

Więcej szczegółów znajdziesz w [dokumentacji API Loop](https://loop.app/docs).

<div id="connecting-loop-in-the-setup-wizard">
  ## Łączenie Loop w kreatorze konfiguracji
</div>

Gdy dotrzesz do **Kroku 1: Połącz dostawcę** w kreatorze ulepszeń subskrypcji:

1. Wybierz **Loop** z listy rozwijanej **Subscription provider**.
2. Wklej swój token API w pole **API token**.
3. Kliknij **Test API key**. Aftersell zweryfikuje token, sprawdzając, czy uwierzytelnia się poprawnie, posiada wszystkie wymagane zakresy uprawnień i należy do Twojego sklepu.
4. Gdy test zakończy się pomyślnie (zielony znacznik), kliknij **Continue**, aby przejść do Kroku 2.

Wynik testu pokazuje jeden z dwóch stanów:

* **Zielony znacznik — „API key verified”.** Token został uwierzytelniony, wszystkie wymagane zakresy uprawnień są obecne, a token należy do Twojego sklepu. Przycisk **Continue** jest teraz aktywny.
* **Czerwona ikona anulowania.** Weryfikacja nie przebiegła pomyślnie. Przeczytaj komunikat obok ikony: albo token został odrzucony lub brakuje mu wymaganych zakresów uprawnień — komunikat wymienia konkretne brakujące zakresy; popraw token w Loop i przetestuj ponownie. Albo Aftersell nie mógł ukończyć weryfikacji („Could not verify the API key. Please try again.”), co oznacza nieudane wywołanie, a nie zły token — w takim przypadku po prostu przetestuj ponownie.

Wynik „nie można zweryfikować” wygląda dokładnie jak odrzucenie, więc kieruj się komunikatem, a nie ikoną. Przycisk **Continue** pozostaje nieaktywny, dopóki weryfikacja nie zakończy się na zielono, a edycja dostawcy lub tokenu czyści poprzedni wynik.

<div id="before-you-configure-the-upgrade-step-3">
  ## Zanim skonfigurujesz ulepszenie (Krok 3)
</div>

Konfigurując zmianę częstotliwości, możesz wybrać istniejący plan sprzedaży lub ustawić częstotliwość ręcznie:

* **Użyj istniejącego planu sprzedaży.** Wybierz z listy rozwijanej planów sprzedaży. Plan musi już istnieć i być aktywny w Twoim panelu Loop.
* **Ustaw częstotliwość ręcznie.** Wprowadź częstotliwość dostaw samodzielnie. Loop akceptuje dowolny cykl bez wymagania pasującego planu sprzedaży. Przy częstotliwości ręcznej możesz też zastosować rabat cykliczny.

<Note>
  Jeśli ustawisz częstotliwość ręcznie, a subskrypcja klienta zawiera dwie lub więcej aktywnych pozycji produktowych (kontrakt wieloproduktowy lub pakietowy), ulepszenie nie powiedzie się, chyba że istnieje pasujący plan sprzedaży dla docelowej częstotliwości. Szczegóły znajdziesz w sekcji [Ograniczenia](#loop-specific-limitations).
</Note>

<div id="selecting-a-recurring-discount-tier">
  ### Wybór progu rabatu cyklicznego
</div>

Niektóre plany sprzedaży Loop stosują różne rabaty w różnych momentach subskrypcji — na przykład \$20 zniżki na pierwsze obciążenie i \$10 zniżki od drugiego obciążenia wzwyż. Gdy wybierzesz taki plan, pole **Recurring discount** zostaje zastąpione listą przycisków opcji pokazujących poszczególne progi rabatowe planu wraz z zakresem obciążeń (na przykład „Charge 1” lub „Charge 2 onward”).

Wybierz próg, który ma być stosowany do każdego przyszłego odnowienia ulepszonej subskrypcji. Wybrany próg jest zapisywany z ofertą i stosowany, gdy klient zaakceptuje ulepszenie.

Jeśli wybrany plan nie ma progów rabatowych albo ustawiasz częstotliwość ręcznie, zamiast tego pojawia się standardowe pole rabatu z dowolną wartością.

<div id="verifying-an-upgrade-in-loop">
  ## Weryfikacja ulepszenia w Loop
</div>

Po złożeniu zamówienia testowego i zaakceptowaniu oferty ulepszenia:

Przejdź do **Subscriptions** w panelu Loop i znajdź subskrypcję klienta. Wywołania ulepszeń w Loop są synchroniczne, więc po stronie Aftersell nie ma opóźnienia przetwarzania — zmiana jest stosowana w Loop w momencie zwrócenia wywołania. Sama *lista* subskrypcji Loop może potrzebować chwili, aby się zaktualizować, więc jeśli zmiany jeszcze tam nie ma, odczekaj kilka minut i odśwież, zanim uznasz to za błąd.

Jeśli zmiany tam nie ma, to znaczy, że nie została zastosowana — zobacz poniżej.

<div id="troubleshooting-loop-specific-issues">
  ## Rozwiązywanie problemów specyficznych dla Loop
</div>

**Nie mogę zmienić częstotliwości rozliczeń**

To oczekiwane zachowanie. Loop nie obsługuje subskrypcji prepaid przez tę integrację. Pole częstotliwości rozliczeń jest wyłączone i automatycznie synchronizowane z częstotliwością dostaw.

**Ulepszenie zostało zaakceptowane, ale subskrypcja nie została zmodyfikowana**

Jeśli subskrypcja pozostała bez zmian, najczęstsze przyczyny to:

* Częstotliwość została ustawiona ręcznie, a subskrypcja klienta zawiera dwie lub więcej aktywnych pozycji produktowych. W takim przypadku Loop wymaga pasującego planu sprzedaży dla docelowej częstotliwości. Utwórz plan sprzedaży w Loop lub przełącz się na opcję **Use an existing selling plan** w konfiguracji oferty.
* Użyto opcji **Use an existing selling plan**, a wybrany plan sprzedaży już nie istnieje w panelu Loop. Utwórz plan sprzedaży w Loop i spróbuj ponownie.
* Twój token API wygasł lub brakuje mu wymaganych uprawnień: **write** dla Subscription contracts, **read** dla Orders i Selling 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ł.

Aftersell automatycznie ponawia nieudane wywołania dostawcy w procesie działającym w tle. Jeśli wszystkie ponowienia się nie powiodą, skontaktuj się z pomocą techniczną, podając adres URL sklepu, identyfikator zamówienia Shopify, adres e-mail klienta, przybliżony czas zaakceptowania ulepszenia oraz używanego dostawcę.

**Lista rozwijana planów sprzedaży jest pusta**

Opcja „Use an existing selling plan” pobiera plany bezpośrednio z Loop. Jeśli lista jest pusta:

* Potwierdź, że plany sprzedaży są skonfigurowane w panelu Loop.
* Upewnij się, że Twój token API ma dostęp **Read** do Selling plans.
* Wróć do **Kroku 1: Połącz dostawcę**, ponownie przetestuj token API i kontynuuj.

**W moim panelu Loop pojawiają się tymczasowe pozycje w trakcie przetwarzania**

To oczekiwane zachowanie w przypadku subskrypcji wielopozycyjnych. Loop obsługuje je w dwóch krokach (podział, a następnie usunięcie), więc między nimi może pojawić się tymczasowa pozycja. Znika ona, gdy tylko drugi krok zostanie zakończony.

***

← Wróć do [Przeglądu ulepszeń subskrypcji](/pl/aftersell/subscription-upgrades) · [Konfiguracja](/pl/aftersell/subscription-upgrades-setup) · [Czym są integracje?](/pl/aftersell/subscription-upgrades-integrations)