Op deze pagina
Voordat je begint
vtwonen is een marketplace voor wonen en interieur, met meubels en woonaccessoires, en verkoopt naar Nederland en België. Je kunt je niet zelf inschrijven: vtwonen beslist wie er verkoopt, dus zorg eerst dat je seller account goedgekeurd is. De API key en de Store Id komen allebei uit de back office van vtwonen op Mirakl. Eén koppeling draagt één verkooplocatie.
vtwonen draait op Mirakl, de software achter de meeste retailer marketplaces die we koppelen, dus de wizard ziet er hetzelfde uit als bij elke andere Mirakl marketplace. Je hebt één API key van vtwonen nodig.
We koppelen vtwonen voor Nederland en België.
Stappen
Neem de API key en de Store Id precies zo over als de back office van vtwonen ze laat zien, zonder spatie ervoor of erachter, en kies de verkooplocatie waarin je winkel verkoopt.
Open "Settings" in het menu links en klik op "Connections".
Klik op "New connection", of open de marketplace wizard direct.
Kies "Marketplace" en klik op het logo van vtwonen onder "Connect marketplace provider".

De wizard voor vtwonen: "Fill in required connection tokens" met de velden van vtwonen Vul "Connection name" in, je eigen referentie voor deze koppeling.
Plak de waarde in "API KEY". Het veld is gemaskeerd, dus je ziet puntjes in plaats van wat je plakte.
Kies onder "Where do you offer your products?" het land waarin je verkoopt. De lijst bevat "Belgium (Dutch)", "Belgium (French)" en "The Netherlands".
Vul "Store Id" in.
Klik op "Save".
Klik op "Validation" in het menu links, kies de tegel van vtwonen en klik op "Add missing PIM tabs" bij elke categorie die je daar verkoopt.
Vul de verplichte velden van vtwonen op die tabs in en klik op "Validate products". Een product live krijgen loopt dat scherm stap voor stap door.
Klik op "Listing", kies de tegel van vtwonen, selecteer je gevalideerde producten en klik op "List content". Klik op "List offers" zodra de content erdoor is.
Wat er daarna gebeurt
vtwonen draait op Mirakl, dus je product en je aanbod reizen apart: het product draagt de EAN, de titel, het merk, de beelden en de attributen van zijn categorie, het aanbod draagt je eigen SKU, prijs, staat en voorraad. Mirakl meldt per regel terug, dus het ene product gaat erdoor terwijl het volgende het veld noemt dat het tegenhield.
De koppeling verschijnt op de pagina "API connections" en als kaart onder "Existing connections" op het dashboard, en voedt vanaf dan je dashboard, je orders en je voorraad. Orders van vtwonen komen binnen onder "Fulfillment" en dan "Orders", met dezelfde filters "Open", "Processing" en "Closed" als je andere kanalen.
Veelvoorkomende problemen
Welke velden de categorie verplicht maakt staan op de marketplace-tab in e-tailize, dus lees de melding die Mirakl teruggeeft op de regel die niet doorging, vul het veld in dat zij noemt en list opnieuw. Noemt zij een veld dat nog niet op je tab staat, klik dan eerst "Refresh category" op de kaart van die categorie.
Gerelateerd
Was dit nuttig?