Chargement de la page…
Een status "beschikbaar" bewijst alleen dat een bron het artikel op het waargenomen moment als bestelbaar toont; het geeft geen aantal eenheden. Een exacte hoeveelheid, bijvoorbeeld 27, levert preciezere informatie, maar garandeert geen reservering, geen afwezigheid van concurrerende bestellingen en geen levering. Bewaar dus de ruwe waarde, het type, de bron en de tijdstempel ervan. Zet InStock nooit om naar 1 of een veronderstelde hoeveelheid. Pas voor een aankoop het minimum en de bestelstap toe op een recente numerieke hoeveelheid, en vraag bevestiging als het belang groter is dan wat de data bewijst.
Vijf vormen van voorraad die je niet mag samenvoegen
Catalogi gebruiken zeer uiteenlopende vocabulaires. Een veld genaamd stock kan een geheel getal, true, tekst zoals "binnen 5 dagen", een drempelklasse of een aanvuldatum bevatten. Ken vóór elke berekening een bewijscategorie toe.
| Waargenomen type | Voorbeeldvorm | Wat het mogelijk maakt | Wat je er niet uit mag afleiden |
|---|---|---|---|
| Exacte hoeveelheid | niet-negatief geheel getal | vergelijken met een gevraagde hoeveelheid | gereserveerde of toekomstige voorraad |
| Booleaans | waar/onwaar, InStock/OutOfStock | een opgegeven status filteren | aantal eenheden |
| Drempel | "meer dan 10", laag/hoog | beschikbaarheid gedeeltelijk afbakenen | exacte waarde |
| Levertijd | verzonden binnen X dagen | een aangekondigde levertijd inschatten | onmiddellijke fysieke aanwezigheid |
| Onbekend | leeg, null, ontbrekend | niets zonder documentatie | uitverkocht of beschikbaar |
Schema.org definieert ItemAvailability als een lijst met mogelijke statussen van een aanbieding, waaronder InStock, OutOfStock, BackOrder of PreOrder. De pagina InStock geeft simpelweg aan dat het artikel op voorraad is. Er wordt geen hoeveelheid gespecificeerd. Deze conventie is nuttig om gestructureerde publieke data te interpreteren, maar vormt geen commerciële garantie van de leverancier.
De exacte hoeveelheid blijft een observatie, geen belofte
Zelfs wanneer een leverancier stock_quantity=27 toont, blijven drie vragen open: op welk tijdstip is de hoeveelheid berekend, voor welk magazijn en welk deel is al gereserveerd? Hetzelfde getal kan globaal, lokaal, verkoopbaar of fysiek vóór verplichtingen zijn. De documentatie moet het bereik aangeven.
Bewaar afzonderlijke velden: stock_raw, stock_type, stock_quantity, availability, warehouse_scope, source_generated_at en observed_at. Als de bron een exacte hoeveelheid levert maar geen magazijnbereik, vul dat laatste dan niet aan met een gok. Onvolledige informatie kan bruikbaar blijven met een waarschuwing; verzonnen informatie niet.
Het actualiteitsbeleid voor prijs en voorraad moet vóór elk gebruik worden toegepast. Een oude hoeveelheid wordt niet booleaans: het blijft een historische hoeveelheid, gemarkeerd als verlopen voor acties die een recente observatie vereisen.
Bestelbare hoeveelheid, MOQ en bestelstap
Voorraad en bestelbare hoeveelheid zijn niet hetzelfde. Stel, als hypothetisch voorbeeld, dat een bron 27 eenheden toont, een minimale bestelhoeveelheid van 10 en een bestelstap van 5. De toegestane hoeveelheden zouden dan 10, 15, 20 of 25 zijn, binnen de grens van de waargenomen voorraad. Een vraag om 12 respecteert de stap niet, en 30 overschrijdt de weergegeven voorraad. Deze logica hangt af van de contractuele definitie van MOQ en bestelstap; ze mag niet worden afgeleid uit een titel of een foto.
Voeg de verpakking toe: een doos die zes eenheden aangeeft, kan betekenen dat stock_quantity=27 dozen of eenheden telt. Zolang de eenheid van de hoeveelheid niet gedocumenteerd is, moet de aankoopberekening geblokkeerd blijven. Het lezen van de kolommen van een groothandelscatalogus helpt om deze afhankelijkheden vóór import op te sporen.
Een veilige regel volgt deze volgorde:
1. Bepaal de verkoopeenheid. 2. Verifieer de verpakkingsinhoud met gestructureerd of contractueel bewijs. 3. Lees MOQ en bestelstap als aparte velden. 4. Classificeer de voorraad naar bewijsniveau. 5. Pas de actualiteitsregel toe op de observatie. 6. Bereken toegestane hoeveelheden alleen als de eenheden compatibel zijn. 7. Bevestig bij de leverancier vlak vóór de bestelling.
Lege, nul- en negatieve waarden
0 kan redelijkerwijs een afwezige hoeveelheid vertegenwoordigen als de velddocumentatie dit bevestigt. Een lege cel is niet gelijkwaardig: ze kan onbeschikbare informatie, een niet-beheerd product of een fout vertalen. Behandel null, een lege tekenreeks en een ontbrekend veld tijdens de diagnose als afzonderlijke statussen, en koppel ze pas op basis van de documentatie.
Een negatieve hoeveelheid kan een resterend saldo in een intern systeem voorstellen, maar is geen verkoopbare voorraad. Verwerp haar uit het bruikbare veld stock_quantity en bewaar haar in de ruwe waarde met een reden. Ook een decimaal getal voor een product dat per stuk wordt verkocht, hoort in review; voor een product dat op gewicht wordt gemeten, kan het legitiem zijn. De context van de eenheid beslist.
Verberg nooit een probleem door alle anomalieën door nul te vervangen. Deze praktijk verwart gebrek aan bewijs met een zekere uitverkoop en vertekent brondiagnoses.
Voorraad testen op een testpartij
Een testpartij bij een leverancier moet minstens gevarieerde statussen bevatten: beschikbaar product, uitverkocht, lege waarde, lage hoeveelheid, eventuele aanvulling en meerdere varianten. Het doel is niet de hele catalogus uit te putten, maar de parser te confronteren met gevallen die de beslissing veranderen.
Vergelijk voor elke regel de ruwe respons, de geautoriseerde officiële fiche en het genormaliseerde veld. Wacht een geplande update af of doe een nieuwe observatie in het toegestane ritme om te controleren of overgangen correct worden verwerkt. Een product dat van InStock naar OutOfStock gaat, mag geen hoeveelheid uit een eerdere verzameling behouden.
Checklist voor voorraadbewijs
- De ruwe waarde is bewaard.
- Booleaans, hoeveelheid, drempel, levertijd en onbekend zijn gescheiden.
- De eenheid van de hoeveelheid is gedocumenteerd.
- Het magazijn of bereik is vermeld indien geleverd.
- De brontijdstempel wordt niet verward met het scripttijdstip.
- Een lege waarde wordt niet omgezet naar nul.
- MOQ, bestelstap en verpakking zijn gescheiden.
- Een verlopen hoeveelheid triggert geen stille beslissing.
- Een beschikbaarheidsovergang wist incompatibele afgeleide waarden.
- De beschikbaarheid wordt bevestigd vóór aankoop.
Wat ArbitragePro+ kan automatiseren / wat de verkoper zelf moet controleren
De voorgestelde specificatie controle-stock zou elke waarde kunnen typeren, de omzetting van een booleaan naar een hoeveelheid kunnen voorkomen, actualiteitsregels kunnen toepassen en inconsistenties met MOQ, bestelstap of verpakking kunnen signaleren. Het rapport zou altijd het ruwe bewijs moeten tonen.
De verkoper moet de contractuele betekenis van de voorraad, de eenheid, het magazijnbereik, eventuele reserveringen en de daadwerkelijk geaccepteerde hoeveelheid op het moment van bestellen bevestigen.
De gezondheid van voorraaddata controleren
Bekijk de gezondheid van bronnen om de beschikbare beschikbaarheids- en verzamelinformatie te bekijken.
Officiële bronnen
- Schema.org, "ItemAvailability", https://schema.org/ItemAvailability — geraadpleegd op 17-08-2026.
- Schema.org, "InStock", https://schema.org/InStock — geraadpleegd op 17-08-2026.
- IETF, RFC 9110, "HTTP Semantics", https://www.rfc-editor.org/rfc/rfc9110.html — geraadpleegd op 17-08-2026.