Hoe metadata-sleutels werken
Elk item op een order kan een of meer metadata-items dragen — een key en een value. Uw platform stuurt deze naar Zonos wanneer een order wordt aangemaakt. Standaard slaat Zonos deze metadata op maar toont deze niet in het orderoverzicht.
Wanneer u een sleutel toevoegt op de voorkeurenpagina, zoekt Zonos naar die sleutel op elk orderitem en toont de bijbehorende waarde als extra rij onder het item.
- Meerdere waarden voor dezelfde sleutel worden samengevoegd met een komma — bijvoorbeeld
red, large. - Items zonder de sleutel tonen de rij simpelweg niet, zodat orderdetails overzichtelijk blijven.
- Sleutels zijn org-breed geconfigureerd. Elke gebruiker in uw organisatie ziet dezelfde metadata-rijen.
Wanneer u dit gebruikt
Veelvoorkomende use cases:
- Gravering of personalisatie — toon een
engraving-text-sleutel zodat het magazijn weet dat de order custom work nodig heeft vóór verzending. - Cadeauorders — toon een
gift-message- ofgift-wrap-sleutel zodat inpakkers de juiste insert kunnen toevoegen. - Abonnementen of loyalty — toon een
subscription-id- ofloyalty-tier-sleutel voor support- en fulfillmentcontext. - Aangepaste platformvelden — elk itemniveau-veld dat uw platform doorgeeft en dat uw team op de order moet zien.
Een metadata-sleutel toevoegen
- Ga naar Dashboard -> Settings -> Orders -> Preferences.
- Typ in het veld Metadata keys de exacte sleutelnaam die uw platform verstuurt (bijvoorbeeld
engraving-text). - Klik op Add.
De sleutel wordt direct toegepast op alle orderdetailpagina's. Open een orderoverzicht om te bevestigen dat de nieuwe rij verschijnt onder elk item dat die metadata draagt.

Sleutelnamen zijn hoofdlettergevoelig en moeten exact overeenkomen met wat uw platform verstuurt. Als u de exacte sleutel niet zeker weet, controleer de ruwe metadata van een recente order of vraag het aan uw developer.
Een metadata-sleutel verwijderen
- Ga naar Dashboard -> Settings -> Orders -> Preferences.
- Zoek de sleutel die u wilt verwijderen in de lijst.
- Klik op het prullenbakpictogram rechts van de rij.
De rij verschijnt niet meer in het orderoverzicht voor nieuwe en bestaande orders.
Problemen oplossen
De rij verschijnt niet op de orderdetailpagina.
- Bevestig dat de sleutelnaam exact overeenkomt, inclusief hoofdletters en streepjes of underscores (
engraving-textis niet hetzelfde alsEngraving_Text). - Bevestig dat het orderitem die metadata daadwerkelijk heeft. Oudere orders die zijn aangemaakt vóór uw platform de sleutel begon te versturen, hebben deze niet.
De rij verschijnt maar is leeg.
- Het platform heeft de sleutel met een lege waarde verstuurd. Controleer de integratie aan platformzijde om te bevestigen dat de waarde wordt ingevuld.
Een sleutel wordt op sommige items getoond maar niet op andere.
- Dit is verwacht — metadata is per item, niet per order. Alleen items waarvoor het platform de sleutel heeft verstuurd, tonen de rij.
Ordervoorkeuren
Platform-metadata op elk orderitem tonen.Wanneer uw e-commerceplatform extra informatie met elke order meestuurt — zoals een graveringnotitie, cadeaubericht of abonnements-ID — ontvangt Zonos dit als metadata. Op de pagina ordervoorkeuren kiest u welke metadata-sleutels op elk orderitem in het orderoverzicht moeten worden weergegeven, zodat uw fulfillmentteam in één oogopslag ziet wat nodig is zonder het oorspronkelijke platform te openen.