Een klant heeft een product gepersonaliseerd, maar het komt niet in de winkelwagen. Deze handleiding loopt de gebruikelijke oorzaken door, in de volgorde die de moeite waard is om te controleren, zodat je degene vindt die bij jouw product past. Ze is geschreven voor merchants die problemen met hun eigen winkel onderzoeken.
Begin met verplichte velden en keuzes, de beschikbaarheid van varianten en de exacte foutmelding. Composerie kan de overdracht ook blokkeren voordat Shopify een winkelwagenverzoek ontvangt, bijvoorbeeld als de personalisatie of een verwerkte afbeelding nog niet is geaccepteerd.
Mist niet de customizer maar de eigen knop Toevoegen aan winkelwagen of Nu kopen van het thema, dan is dat bewust. Zie waarom Nu kopen verdwijnt.
Controleer eerst de voor de hand liggende oorzaken
Begin met de dingen die je binnen een paar seconden op het product zelf kunt bevestigen. Open het product zoals een klant dat doet en probeer het toe te voegen. De melding die je ziet, wijst meestal direct naar de oorzaak.
Vul elk verplicht veld in
Is een personalisatieveld verplicht en laat de klant het leeg, dan laat de customizer hem niet verder gaan. Hij noemt het veld, in rood, boven het veld zelf: “Vul in: Kop”. Vul dat veld in en ga dan verder.
Bij een customizer met stappen komt de weigering vroeg, bij de overgang tussen stappen, voordat er iets ergens heen wordt gestuurd. Bij een customizer van één pagina komt hij pas bij het toevoegen aan de winkelwagen, met een andere formulering: “Vul” gevolgd door de naam van het veld en “in”, bijvoorbeeld “Vul Kop in”.
Wil je bepalen welke velden verplicht zijn, zie dan velden bewerkbaar maken voor klanten.

Controleer of de variant op voorraad is
Is een variant uitverkocht, dan markeert de customizer die optie met “Uitverkocht” en zet hem uit. Een uitgeschakelde optie kan niet worden gekozen, dus toevoegen lukt niet voor die combinatie. Kies een beschikbare optie, of vul de voorraad van de variant aan in Shopify.
Controleer de variant zowel in de Composerie-publicatie als in Shopify. Een kiesbare optie alleen bewijst niet dat Shopify hem bij het afrekenen accepteert. Hoe varianten tot aan het afrekenen doorlopen, lees je in varianten, opties en add-ons.

Zoek naar een knop Aanpassen in plaats van Toevoegen aan winkelwagen
Controleer bij Volledige pagina of een werkende knop Aanpassen de bedoelde customizer opent en of de overdracht aan de winkelwagen werkt. Een ontbrekende knop voor de winkelwagen zegt op zich niet dat het product goed is ingesteld. Zie storefrontmodi uitgelegd.
Reproduceer het zelf
Open het product dat misgaat en doorloop het zoals een klant. Als je de echte melding in context ziet, weet je welke van de bovenstaande oorzaken van toepassing is. Noteer de formulering, want het volgende onderdeel gebruikt die.
Lees de melding die Shopify teruggeeft
Bereikt het verzoek om toe te voegen Shopify en wijst Shopify het af, dan faalt de customizer niet stil. Hij toont de foutmelding die Shopify zelf teruggeeft, zodat de klant (en jij) kan zien wat er misging. De knop schakelt over naar de status “Toevoegen mislukt, probeer opnieuw” en de onderliggende melding beschrijft de reden.
Die tekst komt uit de eigen afrekenregels van Shopify. Veelvoorkomende redenen zijn een niet-beschikbare variant, een hoeveelheidslimiet (een minimum of maximum per bestelling) of een uitverkochte variant met een weigerbeleid. Omdat de regel in Shopify zit, ligt de oplossing meestal in de voorraad- of verkoopinstellingen van het product en niet in Composerie.
Kopieer de exacte tekst die je ziet en vergelijk hem met foutmeldingen uitgelegd. Dat artikel koppelt de gewone meldingen aan hun oorzaak en oplossing.
Sluit een thema uit dat het toevoegen blokkeert
Het pad naar de winkelwagen hangt af van de storefrontmodus en de gebruikte onderdelen. De klantcustomizer slaat de personalisatie op en valideert haar vóór de overdracht aan de Shopify-winkelwagen. De thema-integratie moet ook de vereiste regelitem-eigenschappen behouden. Alleen de eigen knop van het thema controleren is geen volledige test.
Vervangt een aangepast thema of een andere app de toevoegflow, controleer dan of de personalisatie-eigenschappen behouden blijven. In dat geval kan het product nog steeds in de winkelwagen komen, maar worden de personalisatiegegevens uit de regel weggelaten.
Test hetzelfde product op een schoon standaardthema van Shopify (bijvoorbeeld Dawn) om te zien of het thema de oorzaak is. Komt de personalisatie wel door op het standaardthema en niet op het jouwe, dan zit het conflict in je thema of in een andere geïnstalleerde app.
Voor de technische details van hoe deze koppeling werkt, zie hoe de winkelwagen-interceptor werkt. Om te controleren of varianten bij het afrekenen met Shopify overeenkomen, zie variantsynchronisatie en afrekenen.
Veelgestelde vragen
De knop voor in de winkelwagen doet niets. Wat is er mis?
Controleer verplichte velden en keuzes, de status van de beeldverwerking, de gekozen variant en de foutmelding. Ontbreekt de knop, controleer dan de weergavemodus en of er een werkende knop Aanpassen aanwezig is.
Er is helemaal geen knop voor in de winkelwagen bij dit product.
Controleer de publicatiemodus. Bij Volledige pagina hoort een werkende knop Aanpassen naar de personalisatie en de overdracht aan de winkelwagen te leiden. Ontbreekt of werkt ook die niet, volg dan de controlelijst voor themaplaatsing.
Het product komt in de winkelwagen, maar de personalisatie ontbreekt in de bestelling.
Een andere app of een aangepast thema vervangt mogelijk het toevoegverzoek, waardoor de personalisatie-eigenschappen wegvallen. Test hetzelfde product op een standaardthema om dat te bevestigen.
Heb je alle drie de oorzaken doorlopen en komt het product nog steeds niet in de winkelwagen, neem dan contact op met support met de link naar het product en de exacte melding die je ziet.
Hierna
Houd foutmeldingen uitgelegd bij de hand om elke Shopify-melding naar de oplossing te vertalen.