Webshop-voorraad klopt niet: bron en koppeling controleren (2026)
Klopt de voorraad in je webshop niet? Vergelijk één product, variant en bron tegelijk om te zien waar de afwijking ontstaat zonder live voorraad te overschrijven.
Een voorraadfout los je op door één bestelbare variant in alle betrokken systemen op hetzelfde moment te vergelijken. Overschrijf geen live aantallen voordat je weet welk systeem de bron is, welke voorraaddefinitie wordt getoond en of een koppeling de waarde opnieuw kan veranderen.
Begin met het tijdstip waarop de afwijking voor het eerst zichtbaar werd. Een verschil kan ontstaan door een verkeerde variantreferentie, locatie, reservering, handmatige mutatie, vertraagde synchronisatie, annulering of retour. Door één gebeurtenis te reconstrueren voorkom je een brede correctie zonder bekende oorzaak.
Stappenplan
1. Kies één product en exact één variant
Noteer een veilige interne testreferentie, de bestelbare variant en de zichtbare voorraadstatus. Gebruik niet alleen de producttitel, want meerdere varianten kunnen dezelfde titel delen. Controleer in ieder systeem dat je werkelijk dezelfde variant en dezelfde locatie bekijkt.
Shopify licht voorraadbeheer, voorraadniveaus en aanpassingsgeschiedenis toe in de officiële voorraaddocumentatie. WooCommerce documenteert voorraadbeheer. Gebruik de actuele termen van jouw eigen platform en apps, want benamingen en beschikbare niveaus verschillen.
2. Schrijf op wat ieder voorraadgetal betekent
Maak geen vergelijking totdat de definities duidelijk zijn. Fysiek aanwezig, beschikbaar voor verkoop, gereserveerd, verwacht en zichtbaar als op voorraad kunnen verschillende waarden zijn. Leg per systeem vast welk getal je ziet en welke gebeurtenissen dat getal mogen wijzigen.
| Systeem | Variantreferentie | Locatie | Betekenis van waarde | Tijdstip | | --- | --- | --- | --- | --- | | webshop | fictieve referentie | gekozen locatie | zichtbaar of verkoopbaar | controlepunt | | magazijn | dezelfde referentie | dezelfde locatie | volgens magazijndefinitie | controlepunt | | koppeling | veilige testreferentie | route | verzonden of ontvangen waarde | runmoment |
Gebruik alleen fictieve voorbeelden in gedeelde notities. Een echte order of klantnaam is niet nodig om een voorraadmutatie te volgen.
3. Wijs één bronsysteem aan
Bepaal welk systeem de leidende voorraadwaarde beheert. Leg ook vast of de synchronisatie één richting of twee richtingen heeft. Als webshop en magazijn hetzelfde veld beide mogen overschrijven, kan een correctie heen en weer blijven gaan.
Vergelijk de zichtbare productpagina met de productinformatiecontrole. Een juiste bronwaarde kan door een oud cachebeeld, ander locatieprofiel of varianttemplate alsnog verkeerd worden getoond. Behandel bron, synchronisatie en presentatie daarom als afzonderlijke controlepunten.
4. Maak een tijdlijn van de eerste afwijking
Noteer relevante gebeurtenissen rond één variant: import, handmatige aanpassing, testorder, reservering, annulering, fulfilment, retour en synchronisatie. Gebruik tijdstippen en vaste foutcategorieën, geen volledige orderpayload. Zoek het eerste moment waarop bron en bestemming uiteenlopen.
Controleer de aanpassingsgeschiedenis van het platform als die beschikbaar is. Vraag: welk systeem of welke gebruiker veranderde de waarde, kwam daarna een koppeling terug en werd dezelfde gebeurtenis misschien twee keer verwerkt? Een huidige screenshot zonder tijdlijn laat die volgorde niet zien.
5. Controleer identiteit en mapping
Vergelijk variantreferentie teken voor teken, inclusief eventuele voorloopnullen, hoofdletters of externe sleutels. Controleer of de koppeling een hoofdproduct, variant of locatieveld gebruikt. Een product kan technisch bestaan en toch aan de verkeerde externe referentie zijn gekoppeld.
Volg bij meerdere systemen het koppelingstestplan. Leg bronveld, doelveld, formaat, gedrag bij ontbrekende waarden en unieke referentie vast. Laat een lege waarde niet stil als nul of onbeperkt beschikbaar behandelen zonder bewust ontwerp.
6. Voer één omkeerbare voorraadtest uit
Gebruik een speciaal testproduct of afgescheiden testomgeving. Noteer beginwaarde, testactie en verwachte eindwaarde. Verander één kleine fictieve waarde via het aangewezen bronsysteem en controleer achtereenvolgens bron, koppeling, bestemming en zichtbare productpagina.
Herhaal de synchronisatie met dezelfde testreferentie. De waarde mag niet nogmaals veranderen als dezelfde gebeurtenis opnieuw wordt aangeboden, tenzij jouw gedocumenteerde proces dat bewust vereist. Controleer ook dat een oudere testupdate geen nieuwere waarde overschrijft.
7. Test order, annulering en retour afzonderlijk
Gebruik de officiële testmodus en één fictieve variant. Controleer welke voorraadstatus verandert wanneer de testorder wordt aangemaakt en wat bij een afgebroken of geannuleerde test gebeurt. Gebruik daarna een apart retourscenario; retour gemeld betekent niet automatisch dat een product weer verkoopbaar is.
Leg per gebeurtenis vast wie eigenaar is en wanneer de voorraad mag wijzigen. Een retour kan eerst ontvangen en beoordeeld moeten worden binnen je eigen proces. Deze handleiding geeft geen juridisch, boekhoudkundig of magazijnadvies, maar helpt de technische statussen te scheiden.
8. Controleer de zichtbare klantreis
Bekijk dezelfde variant op productpagina en in winkelmand. Doorloop vervolgens een testcheckout zonder echte betaling. Controleer dat de beschikbaarheid niet onverwacht wisselt en dat een begrijpelijke melding verschijnt als het testscenario niet bestelbaar hoort te zijn.
Kijk na de test naar de order- en voorraadstatus in de bevoegde omgeving. Een productpagina die goed toont is niet genoeg als de order een andere variant of locatie muteert. Controleer precies één mutatie en ruim het testscenario via de gedocumenteerde route op.
9. Herstel pas na bevestigde oorzaak
Heb je het eerste afwijkende punt gevonden, bepaal dan met de broneigenaar welke kleine correctie nodig is. Pauzeer zo nodig de betreffende testkoppeling volgens het herstelplan, wijzig één record en controleer dat de synchronisatie de correctie niet terugdraait.
Voer geen bulkcorrectie uit op basis van één voorbeeld. Controleer eerst meerdere representatieve varianten als read-only steekproef om vast te stellen of dezelfde oorzaak werkelijk terugkomt. Maak vóór een bredere wijziging een herstel- en verificatieplan met de bevoegde eigenaar.
10. Richt een eenvoudige controle in
Leg vast wie afwijkingen beoordeelt, welke bron leidend is en welke minimale gegevens voor diagnose nodig zijn. Een waarschuwing kan variantreferentie, locatie, tijdstip en foutcategorie gebruiken zonder klant- of betaalgegevens. Controleer periodiek testscenario's na wijzigingen aan productfeed, locatie, fulfilment of koppeling.
Acceptatiecontrole
De oorzaak is voldoende afgebakend wanneer:
- in ieder systeem exact dezelfde variant en locatie zijn vergeleken;
- de betekenis van ieder voorraadgetal is vastgelegd;
- één bronsysteem en eigenaar zijn aangewezen;
- de tijdlijn het eerste afwijkende controlepunt laat zien;
- mapping en unieke referentie zijn gecontroleerd;
- één omkeerbare test de verwachte enkele mutatie gaf;
- order, annulering en retour als aparte gebeurtenissen zijn getest;
- productpagina, winkelmand en testcheckout consistent reageren.
Veelgemaakte fouten
- Varianten met het hoofdproduct verwarren. Vergelijk altijd de werkelijk bestelbare variantreferentie.
- Verschillende voorraaddefinities naast elkaar zetten. Leg eerst vast wat aanwezig, gereserveerd en beschikbaar betekenen.
- Een oude import als actuele bron zien. Controleer tijdstip en aanpassingsgeschiedenis.
- Live voorraad corrigeren zonder herstelroute. Een actieve koppeling kan de wijziging direct overschrijven.
- Een retourmelding direct als verkoopbare voorraad boeken. Scheid melding, ontvangst, beoordeling en vrijgave.
- Een echte klantorder gebruiken voor diagnose. Werk met een testproduct en officiële testmodus.
- Alle afwijkingen tegelijk herstellen. Bevestig eerst één oorzaak en controleer daarna een read-only steekproef.
Officiële bronnen
Laatste controle
De gelinkte voorraadhandleidingen van Shopify en WooCommerce zijn op 31 juli 2026 inhoudelijk opnieuw gecontroleerd. Platformtermen, voorraadniveaus en functies kunnen wijzigen; vergelijk ze bij uitvoering opnieuw met je huidige inrichting.
Laatst bijgewerkt: 31 juli 2026.
Hulp nodig?
Wil je weten bij welke variant, locatie of synchronisatiestap het voorraadverschil begint? stel je vraag via WhatsApp.
Veelgestelde vragen
- Waarom wijkt webshopvoorraad af van mijn voorraadbron?
- De afwijking kan ontstaan door een andere variantreferentie, een vertraagde koppeling, een handmatige wijziging of een andere definitie van beschikbare voorraad. Vergelijk eerst één product.
- Kan ik voorraad handmatig overschrijven?
- Alleen wanneer je zeker weet dat geen koppeling de waarde daarna weer terugzet. Maak eerst duidelijk welk systeem de bron is en hoe je herstelt.
- Hoe test ik een voorraadkoppeling veilig?
- Gebruik één testproduct of een afgescheiden testomgeving, met een herkenbare referentie en een vooraf vastgelegde verwachte uitkomst.
- Wat doe ik bij negatieve voorraad?
- Stop met bulkcorrecties. Controleer eerst reserveringen, retouren, annuleringen en de laatste synchronisatie bij één product.
- Moet voorraad ook in de checkout kloppen?
- Ja. Test na een veilige productcontrole of de gekozen variant in de checkout nog dezelfde beschikbaarheid toont.
Lees ook
Hulp nodig bij jouw situatie?
Kom je er niet uit? Stuur kort wat context, wat je wilt bereiken en waar je vastloopt. Dan kijken we samen naar een passende volgende stap.