> ## 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.
# Referentie voor abonnementsupsells
Deze pagina bevat de werking en platformregels achter Subscription Upsell: hoe het abonnement wordt toegevoegd, hoe abonnementen en kortingen worden bepaald, wat de klant ziet, fulfillment, de beperkingen van het Shopify-platform en de volledige catalogus voor probleemoplossing. Zie [Abonnementen in post-purchase aanbiedingen](/nl/aftersell/subscriptions_in_post_purchase_offers) voor hoe je er een bouwt.
## Hoe het abonnement wordt toegevoegd
Subscription Upsell gebruikt de native post-purchase changeset `add_subscription` van Shopify. Aftersell roept voor deze flow niet rechtstreeks de API van je abonnementsapp aan: het abonnement wordt door Shopify aangemaakt en je abonnementsapp pikt het op via zijn eigen Shopify-integratie. Daarom werkt Subscription Upsell met elke abonnementsapp die de native Subscription API van Shopify gebruikt.
De eerste cyclus van het abonnement wordt als normaal regelitem uitgeleverd vanuit de **oorspronkelijke Shopify-bestelling**. Volgende verlengingen worden beheerd door je abonnementsprovider, net als elk abonnement dat tijdens de reguliere checkout is aangemaakt.
## Compatibele abonnementsplatforms
Subscription Upsell is aan de kant van Aftersell volledig provideronafhankelijk. Aftersell voegt het abonnement toe via de native changeset `add_subscription` van Shopify, en Shopify stuurt de inschrijving door naar de abonnementsapp die je op de Shopify Subscription API hebt geïnstalleerd. Elke abonnementsapp die de native Subscription API van Shopify gebruikt, werkt zonder extra configuratie, waaronder Recharge, Skio, Loop, Stay.ai, Appstle, Smartrr, Bold Subscriptions (wanneer deze op de native subscriptions API van Shopify draait) en de native selling plans van Shopify.
Selling plans die je in je abonnementsapp aanmaakt, worden automatisch in Aftersell opgehaald. (Compatibiliteit voor Subscription Upgrade is anders en providerspecifiek; zie [Abonnementsupgrades](/nl/aftersell/subscription-upgrades).)
## Hoe selling plans worden bepaald
### Toegestane abonnementen
De instelling **Allowed subscription plans** is een toegestane lijst die **per variant** wordt toegepast. Voor de variant die een klant selecteert, ziet die alleen de toegestane abonnementen die voor die variant beschikbaar zijn:
* Als er precies één toegestaan abonnement van toepassing is, wordt de naam ervan als statische tekst getoond en hoeft er niets te worden gekozen.
* Als er meerdere van toepassing zijn, kiest de klant ertussen in een dropdown **Purchase options**.
* Als er geen van toepassing is, valt die variant terug op het tonen van al zijn eigen abonnementen.
Door die afbakening per variant kan één toegestane lijst correct omgaan met een product waarvan de varianten verschillende selling plans hebben. Als geen van de toegestane abonnementen beschikbaar is voor een variant (omdat een abonnement in Shopify is verwijderd of uitgeschakeld), valt de aanbieding terug op het tonen van alle beschikbare abonnementen voor die variant, zodat klanten de aankoop toch kunnen voltooien. De instelling voor toegestane abonnementen wordt ook automatisch gewist als je de aankoopoptie van het product wijzigt in alleen eenmalige aankoop, wat configuratiefouten voorkomt wanneer abonnementsopties worden verwijderd.
### Welk selling plan standaard wordt getoond
Wanneer er in **Allowed subscription plans** geen abonnementen zijn geselecteerd, selecteert de aanbieding vooraf het **eerste selling plan** dat in Shopify op het product is geconfigureerd. Als die variant meer dan één beschikbaar abonnement heeft, kunnen klanten het wijzigen in de dropdown **Purchase options**. Zo bepaal je welk abonnement klanten zien:
* **Beperk de abonnementen** (aanbevolen). Gebruik de meervoudige selectie **Allowed subscription plans**. Sta er precies één toe en klanten zien alleen dat abonnement, zonder dropdown.
* **Herschik selling plans in Shopify.** De volgorde van de selling plans op het product bepaalt welke als eerste wordt getoond.
* **Verwijder ongebruikte selling plans van het product.** Als je meerdere frequenties hebt en er maar één wilt tonen, laat dan alleen het relevante selling plan aan het product gekoppeld.
De belangrijkste factor voor klantbehoud is het afstemmen van de frequentie op het daadwerkelijke productgebruik. Een shampoo-abonnement van 30 dagen waarbij de fles 60 dagen meegaat, wordt opgezegd; een abonnement van 60 dagen waarbij de fles 30 dagen meegaat, wordt overgeslagen. Bekijk je gegevens over eenmalige herhaalaankopen om de natuurlijke frequentie per product te vinden.
## Hoe abonnementskortingen worden getoond
Een korting op een Subscription Upsell-aanbieding geldt **alleen voor de eerste factureringscyclus**; toekomstige terugkerende bestellingen worden afgerekend tegen de reguliere abonnementsprijs. De post-purchase aanbieding toont twee verschillende prijzen:
* De **knop Accept Offer** en het subtotaal van het regelitem tonen de **prijs voor de eerste cyclus**, inclusief eventuele korting op de eerste cyclus.
* Het veld **Recurring subtotal** toont wat de klant bij **volgende verlengingen** betaalt tegen de reguliere abonnementsprijs.
Dit is duidelijk bij gangbare kortingen op de eerste cyclus (10 tot 25 procent korting op de eerste levering). Het kan verwarrend zijn bij een extreme korting op de eerste cyclus, zoals 100% korting, omdat de terugkerende prijs (niet de prijs van \$0 voor de eerste cyclus) het meest zichtbare getal is. Als je een gratis eerste levering bedoelt, wees dan expliciet in de aanbiedingstekst ("Eerste box gratis, daarna \$59.99 elke 30 dagen").
Kortingen kunnen een **percentage** zijn (bijvoorbeeld 15% korting) of een **vast bedrag** (bijvoorbeeld \$5 korting). De korting gaat mee met de changeset `add_subscription` van Shopify in plaats van via je abonnementsapp te worden toegepast, en is alleen van invloed op het abonnement dat door deze aanbieding wordt aangemaakt.
De korting komt alleen bij het abonnement terecht als je **Apply discount to subscriptions** aanvinkt. Zonder deze optie bevat de changeset `add_subscription` geen korting en wordt het abonnement tegen de volledige prijs gefactureerd; de korting van de aanbieding geldt dan alleen voor de eenmalige regel.
## Wat de klant ziet
Wanneer een klant een Subscription Upsell accepteert, gebeuren er drie dingen in twee systemen.
**Op de Shopify-bestelling.** De orderbevestiging bevat zowel het **oorspronkelijke eenmalige regelitem** als het **nieuwe abonnementsregelitem** (gefactureerd tegen de afgeprijsde prijs voor de eerste cyclus). De klant betaalt voor beide regels op de oorspronkelijke bestelling, en de eerste abonnementslevering wordt vanuit deze bestelling als normaal regelitem verzonden.
**In de bevestigingsmails.** Shopify stuurt de standaard orderbevestiging met beide regelitems. Je abonnementsprovider stuurt doorgaans een eigen welkomstmail voor het abonnement waarin het terugkerende schema wordt uitgelegd. Configureer die welkomstmail zo dat deze binnen enkele minuten na acceptatie wordt verstuurd, met de naam van de klant en het product, de frequentie, de volgende afschrijvingsdatum en een directe link naar het klantportaal.
**In het portaal van de abonnementsprovider.** De klant beheert het nieuwe abonnement in het portaal van je provider, waar die doorgaans een levering kan pauzeren of overslaan, de frequentie kan wijzigen, producten kan wisselen of kan opzeggen. Het portaal is van je provider, niet van Aftersell; zorg ervoor dat het bereikbaar is vanuit het accountgedeelte van je winkel of de welkomstmail, anders nemen klanten contact op met support om op te zeggen.
## Fulfillment van abonnementen
* **Eerste cyclus.** De eerste abonnementsbestelling maakt deel uit van de oorspronkelijke Shopify-bestelling, dus deze doorloopt het fulfillmentproces dat je voor eenmalige bestellingen gebruikt (3PL, in eigen beheer, dropshipping). De abonnementsregel wordt samen met de oorspronkelijke eenmalige aankoop verzonden.
* **Volgende verlengingen.** Toekomstige cycli worden door je abonnementsprovider aangemaakt volgens de verlengingsfrequentie. Elke verlenging wordt een nieuwe Shopify-bestelling, die op dezelfde manier wordt uitgeleverd als elke andere bestelling.
Als je 3PL rechtstreeks met je abonnementsprovider is geïntegreerd, verlopen verlengingen meestal automatisch. Als je 3PL alleen synchroniseert vanuit Shopify-bestellingen, is er geen extra configuratie nodig, omdat elke verlenging een Shopify-bestelling aanmaakt.
## Beperkingen van het Shopify-platform
Een paar regels van het Shopify-platform gelden voor post-purchase aanbiedingen met abonnementen, ongeacht welke Aftersell-functie je gebruikt.
### Eén abonnement per bestelling
Shopify staat niet toe dat een post-purchase upsell een abonnement toevoegt aan een bestelling die al een abonnement bevat. Deze beperking is door Shopify ingesteld en geldt voor alle post-purchase apps.
**Het koppelen van een abonnementsprovider heft deze beperking op voor Subscription Upsell.** Wanneer Recharge, Skio of Loop is gekoppeld, maakt Aftersell het nieuwe abonnement aan bij je provider in plaats van Shopify te vragen het toe te voegen, zodat abonnementsaanbiedingen ook klanten bereiken van wie de bestelling al een abonnement bevat. Zie [upsellen aan bestaande abonnees](/nl/aftersell/subscription-upsell-existing-subscribers).
Als er **geen provider is gekoppeld**, handelt Aftersell het geval "abonnement al in de cart" automatisch af:
* **Producten die alleen als abonnement beschikbaar zijn** in een aanbieding worden voor die klant uit de funnel verwijderd.
* **Producten met beide modi** (eenmalig en abonnement) worden automatisch teruggezet naar alleen eenmalig, zodat de aanbieding nog steeds wordt getoond, maar zonder de abonnementsoptie.
Hoe dan ook kun je een Subscription Upsell-aanbieding in je funnel laten staan zonder je zorgen te maken dat deze onterecht afgaat bij bestellingen die al een abonnement bevatten. Gebruik [Subscription Upgrade](/nl/aftersell/subscription-upgrades) om het abonnement dat de klant al heeft te wijzigen in plaats van een tweede toe te voegen.
### Producten die alleen als abonnement beschikbaar zijn
Als een product in je aanbieding zo is geconfigureerd dat het alleen als abonnement wordt verkocht, en er geen provider is gekoppeld, wordt de aanbieding overgeslagen wanneer de bestelling van de klant al een abonnementsproduct bevat. Wat de funnel-editor toont, hangt af van je configuratie:
* **Er is een provider gekoppeld.** Geen banner; de beperking is niet van toepassing.
* **Er is geen provider gekoppeld.** Een banner **Unlock more reach** met een actie **Connect a provider**, die uitlegt dat klanten van wie de bestelling al een abonnement bevat de abonnementsoptie van deze aanbieding niet zien.
* **De funnel sluit abonnementsbestellingen al uit.** Geen banner, omdat de aanbieding die klanten nooit bereikt.
Waar de oudere waarschuwingsbanner **Subscription limitations** verschijnt, worden de betreffende producten vermeld en wordt voorgesteld de **Subscription trigger** in te stellen op **do not include a subscription**.
### Meerdere abonnementsaanbiedingen in dezelfde funnel
Als meer dan één aanbieding in je funnel een abonnementsproduct bevat, wordt alleen het eerste geaccepteerde abonnement aan de bestelling toegevoegd; volgende abonnementsaanbiedingen worden overgeslagen. De funnel-editor waarschuwt je wanneer dit conflict wordt gedetecteerd en vermeldt de andere aanbiedingen die ook abonnementsproducten bevatten. Om overgeslagen aanbiedingen te voorkomen, beperk je je funnel tot één abonnementsaanbieding, of gebruik je de **Subscription trigger** om bestellingen uit te sluiten die al een abonnement bevatten.
## Probleemoplossing
Om abonnementsopties te laten verschijnen, moet het geselecteerde product in Shopify minstens één actief selling plan hebben. Controleer of je abonnementsapp selling plans voor dit product heeft aangemaakt en of deze actief zijn en aan het product zijn toegewezen.
De aanbieding selecteert vooraf het eerste selling plan dat in Shopify op het product is geconfigureerd, en klanten kunnen het wijzigen in de dropdown **Purchase options** wanneer er meer dan één abonnement op hun variant van toepassing is. Om te bepalen welk abonnement ze zien, beperk je de aanbieding met de meervoudige selectie **Allowed subscription plans**, herschik je de selling plans op het product in Shopify zodat het gewenste plan bovenaan staat, of verwijder je ongebruikte selling plans volledig van het product. Als je precies één abonnement toestaat, verdwijnt de dropdown.
Ja, wanneer er meer dan één abonnement van toepassing is op de geselecteerde variant, toont de aanbieding een dropdown **Purchase options**. Om dat te voorkomen, gebruik je **Allowed subscription plans** om één abonnement toe te staan; de frequentie wordt dan als statische tekst weergegeven. Klanten kunnen de frequentie daarna nog steeds wijzigen in het portaal van je abonnementsprovider.
Gebruik de modus **One-time purchase only** in de instelling voor aankoopopties van de aanbieding. Aftersell heeft drie modi voor producten met abonnementsoptie: **One-time purchase only**, **Subscription only** en **One-time purchase and subscription**. Met **One-time purchase only** wordt de abonnementsoptie volledig verborgen, zelfs wanneer het product actieve selling plans heeft.
Dit is een van de meest ontwrichtende foutsituaties, omdat er bij de klant is afgeschreven maar het abonnement nooit bij je provider is aangemaakt. Verreweg de meest voorkomende oorzaak is een **selling plan dat is gedeactiveerd tussen het weergeven van de aanbieding en de acceptatie door de klant**. Shopify accepteert de changeset omdat er op het moment van weergave een geldig selling plan-ID is, maar als het plan wordt gedeactiveerd voordat de klant accepteert, wordt er verderop geen abonnement aangemaakt en verschijnt er geen foutmelding.
Andere veelvoorkomende oorzaken:
* **De webhook van de abonnementsapp faalt.** Elke abonnementsapp die nieuwe abonnementen uit Shopify ophaalt, is afhankelijk van Shopify-webhooks. Controleer de status van webhookleveringen in de logs van je abonnementsapp.
* **Het selling plan is losgekoppeld van het product**, maar heeft nog een actief ID. Shopify accepteert de changeset en het regelitem komt op de bestelling, maar de abonnementsprovider heeft geen record om op te reageren.
**Belangrijk:** er is geen automatische nieuwe poging op het native `add_subscription`-pad; Shopify is daar eigenaar van de inschrijving, dus Aftersell heeft niets om opnieuw af te spelen. (Het aparte providerpad, dat wordt gebruikt wanneer de bestelling al een abonnement bevat, *valt wel* onder de [workflow voor nieuwe pogingen bij abonnementsupgrades](/nl/aftersell/subscription-upgrades-troubleshooting).) Als dit gebeurt:
1. Controleer of het selling plan nog actief is in Shopify en aan het product is toegewezen.
2. Bekijk de orderimport- / webhooklogs van je abonnementsapp voor de betreffende bestelling.
3. Als het abonnement echt ontbreekt, kan het supportteam van je abonnementsapp de klant meestal handmatig inschrijven aan de hand van het bestellings-ID.
Als meerdere klanten worden getroffen, neem dan contact op met Aftersell support met de bestellings-ID's en je abonnementsprovider, maar verwacht dat de oplossing aan de kant van de abonnementsprovider plaatsvindt, niet in Aftersell.
Dit doet zich meestal voor wanneer de korting op de eerste cyclus extreem is (bijvoorbeeld 100% korting op de eerste cyclus). De knop Accept toont de prijs voor de eerste cyclus, maar als die prijs er hetzelfde uitziet als de terugkerende prijs, kan het lijken alsof de korting niet is toegepast. Controleer in de voorbeeldweergave van de aanbieding of de korting correct is geconfigureerd, en gebruik de aanbiedingstekst ("Eerste box gratis, daarna \$X elke Y dagen") om de voorwaarden ondubbelzinnig te maken.
Kortingen gelden standaard **alleen voor de eerste factureringscyclus**. Als een klant vraagt waarom de tweede of derde bestelling geen korting heeft, is dat verwacht. Terugkerende bestellingen worden afgerekend tegen de reguliere abonnementsprijs, die de klant in de aanbieding als **Recurring subtotal** zag.
Als je Recharge, Skio of Loop hebt gekoppeld, is dit verwacht en werkt de aanbieding: Aftersell maakt het nieuwe abonnement aan bij je provider. Zie [upsellen aan bestaande abonnees](/nl/aftersell/subscription-upsell-existing-subscribers).
Als er geen provider is gekoppeld, blokkeert Shopify het toevoegen van een tweede abonnement en wordt de aanbieding tijdens runtime zonder melding overgeslagen. Koppel een provider, of voorkom dat de aanbieding aan die klanten wordt getoond door de **Subscription trigger** in te stellen op **do not include a subscription**.
Shopify staat slechts één abonnement per bestelling toe. Als je meerdere abonnementsaanbiedingen in dezelfde funnel hebt, wint de eerste geaccepteerde en worden de rest overgeslagen. Beperk je funnel tot één abonnementsaanbieding, of gebruik de Subscription trigger om bestellingen uit te sluiten die al een abonnement hebben.
Het nieuwe abonnement wordt beheerd in het klantportaal van je abonnementsprovider, niet rechtstreeks in Shopify. Zorg ervoor dat het portaal is gelinkt vanuit het accountgedeelte van je winkel en controleer of de welkomstmail van je provider zo is geconfigureerd dat deze direct na acceptatie wordt verstuurd.
De eerste cyclus is betaald als onderdeel van de Shopify-bestelling, dus terugbetalingen werken hetzelfde als voor elk ander regelitem. Het annuleren van toekomstige cycli gebeurt bij je abonnementsprovider, niet in Aftersell. Het terugbetalen van de regel in Shopify annuleert het abonnement niet automatisch; je moet het ook in het providerportaal annuleren.