Webshop.nl Marktplaats voor Magento 2
Koppel Magento 2 direct aan de marketplace Webshop.nl: exporteer je catalogus als productfeed en ontvang Webshop.nl-orders als gewone Magento-orders.





Koppel Magento 2 direct aan de marketplace Webshop.nl
Je catalogus op Webshop.nl, de orders in Magento
De extensie Webshop.nl Marketplace koppelt je Magento 2-winkel direct aan de marketplace Webshop.nl. Je producten gaan als productfeed naar buiten en orders die op Webshop.nl worden geplaatst, komen als gewone orders in Magento binnen.
Je regelt de koppeling vanuit de Magento-admin. De knop "Register now" opent het Webshop.nl-partnerportaal en stuurt je winkelgegevens mee, zodat je ze niet opnieuw hoeft in te vullen. Daarna communiceert Webshop.nl met je winkel via de eigen REST-endpoints van de extensie.
De extensie is gebouwd door Magmodules, een pluginontwikkelaar uit Nederland. Versie 1.2.0 draait op Magento 2.4.6 en nieuwer met PHP 8.2 of hoger.

Wat de extensie doet
Direct registreren
"Register now" opent het Webshop.nl-partnerportaal en stuurt je bedrijfsnaam, btw-nummer, adres en integratietoken mee.
NDJSON-productfeed
Eén feed per store view, gegenereerd volgens een schema, vanuit de admin of met een CLI-opdracht.
Attributen koppelen
Koppel naam, omschrijvingen, EAN, merk, kleur, materiaal, maat en geslacht aan je eigen Magento-attributen.
Varianten en filters
Bepaal hoe configurable, bundel- en gegroepeerde producten worden geëxporteerd en filter op zichtbaarheid, categorie en voorraad.
Orderimport
Orders van Webshop.nl worden in Magento aangemaakt, gefactureerd en op processing gezet, met de Webshop.nl-order-ID in het ordergrid.
Status en logs
Webshop.nl kan de orderstatus en trackingcodes opvragen, en de admin toont de laatste 100 regels van het debug- en errorlog.
Registreer bij Webshop.nl vanuit de Magento-admin
De extensie voegt een eigen tab "Webshop.nl" toe aan de Magento-configuratie, met de secties "General", "Product Catalogue" en "Orders". Bovenaan de instellingen staat de knop "Register now", die het Webshop.nl-partnerportaal opent.
De knop stuurt deze gegevens mee: bedrijfsnaam, btw-nummer, straat, huisnummer, postcode, plaats en land uit de Store Information van Magento, plus de integratietoken en de URL van het info-endpoint. Het alleen-lezen veld "Magento Integration Token" toont dezelfde token.
Het veld "Mode" verschijnt zodra "Enabled" op "Yes" staat en staat standaard op "Production". Kies "Development" alleen als je tegen een ontwikkelportaal test.
Wat Webshop.nl uit je winkel leest
Via GET /V1/webshopnl/info ziet Webshop.nl of de extensie aan staat, de module- en Magento-versie, de feed-URL per store view, de URL's voor orders en orderstatus, het moment van de laatste orderimport en de actieve stores.


Een NDJSON-productfeed per store view
Onder "Product Catalogue" zet je de feed aan met "Enable" en kies je de "Filename", standaard webshop.ndjson. Elke store view krijgt een eigen feed in NDJSON-formaat, dus elke taal of elk assortiment heeft een eigen bestand.
"Auto Generate" ververst de feed via cron: "Daily at 0:00" (de standaard), "Every 6 hours", "Every 4 hours", "Every 2 hours", "Every hour" of "Custom". Bij "Custom" vul je onder "Custom Frequency" je eigen schema in crontab-notatie in. De feed volgt je catalogus dan zonder handmatige exports.
Genereren, bekijken en downloaden
Het feedoverzicht toont per store view de NDJSON-URL, met het moment van generatie en het aantal producten. Daar gebruik je "Generate", "Preview" en "Download". Sla de configuratie op voordat je een feed genereert.
Developers draaien dezelfde generatie met bin/magento webshopnl:feed:create, of voor één store view met --store-id=<id>. De voorraad in de feed houdt rekening met MSI-reserveringen.
Koppel je eigen attributen aan de velden van Webshop.nl
Onder "Product Data" kies je per veld welk Magento-attribuut het vult: "Name", "Short Description", "Long Description", "EAN-code", "Brand", "Color", "Material", "Size" en "Gender". De standaarden zijn name, short_description, description, manufacturer, color, material, size en gender.
"EAN-code" verwijst standaard naar sku. Kies daar dus je EAN-attribuut als je EAN's in een apart attribuut bewaart. "Extra Info" is een vrij tekstveld, bijvoorbeeld: Free pickup from store.
Categorie, levertijd en btw
- Categorie: met "Type" gebruik je de "Magento Category Tree", een "Custom Category Value" of "Use Attribute".
- Levertijd: kies "Static Values" en vul "Delivery Time - In Stock" en "Delivery Time - Out of Stock" in, of kies "Use Attribute".
- Btw: "VAT Percentage" staat standaard uit, terwijl de admin vermeldt dat Webshop.nl dit veld verplicht stelt. Zet "Enable" aan en gebruik de "Fixed Value" (standaard 21) of een attribuut.
- Afbeeldingen: "Source" bepaalt welke afbeeldingen worden geëxporteerd. Exporteer je alle afbeeldingen, dan bepaalt "Main Image" welke de hoofdafbeelding is.
Onder "Additional Configuration" voeg je "Extra Fields" toe voor eigen velden, "Shipping Settings" voor verzendprijzen per prijsklasse en een "UTM Code" voor Google Analytics.


Kies welke producten en varianten in de feed komen
Een configurable product kun je niet los kopen, alleen de varianten. Onder "Product Types" heeft de instelling "Use Configurable/Simple Products" daarom vier opties: "No", "Only Configurable Product", "Only Linked Simple Products (Recommended)" en "Configurable and Linked Simple Products". Na installatie staat de instelling op "Configurable and Linked Simple Products".
Met "Only Linked Simple Products (Recommended)" wordt een Oslo Lounge Chair in eiken, walnoot en zwart als drie items geëxporteerd, één per variant.
"Use Parent URL for Simples" met "Yes, with Auto-Link (Recommended)" stuurt de bezoeker naar de pagina van het configurable product, gekoppeld aan de juiste variant. "Use Parent Image for Simples" en "Use Parent Data for Simples" nemen de afbeelding en de attributen die je selecteert over van het bovenliggende product. "Use Fallback only on Non Visible Simples" beperkt dat tot varianten die niet afzonderlijk zichtbaar zijn. Bundel- en gegroepeerde producten hebben vergelijkbare instellingen, en gegroepeerde producten hebben daarnaast "Parent Price".
Filteropties
Onder "Filter Options" beperk je de feed op zichtbaarheid, op categorie (opnemen of uitsluiten) met "Filter by Category", op voorraad met "Exclude Out of Stock" en op eigen regels met "Advanced Filters" en "Filter Conditions". Alle filters staan standaard uit.
Webshop.nl-orders als gewone Magento-orders
Webshop.nl stuurt elke order naar je winkel via POST /V1/webshopnl/order/:store_id. De extensie maakt een Magento-order aan met de betaalmethode webshopnl, factureert die en zet de status op processing, zodat de order in je normale afhandeling terechtkomt. De Webshop.nl-order-ID wordt op de order opgeslagen en staat in het ordergrid als kolom "Webshopnl Order ID".
De import heeft een eigen "Enable" onder "Orders" en staat standaard uit. Zolang die uit staat, wordt een order geweigerd met de melding "Order import is disabled for this store". Een order die al eerder is geïmporteerd, wordt ook geweigerd, dus je krijgt geen dubbele orders.
Verzending, klanten en e-mails
- Verzending: "Default Shipping Method" wordt gebruikt voor geïmporteerde orders. Is die methode voor een order niet beschikbaar, dan neemt "Fallback for Shipping Method" het over. De verzendkosten komen uit de Webshop.nl-order.
- Klanten: "Import Customers" staat standaard uit. Zet je de optie op "Yes", dan verschijnt het veld "Customer Group".
- Adres: zet "Separate house number" aan als je winkel de tweede straatregel voor het huisnummer gebruikt.
- E-mails: "Send order e-mail to the customer" en "Send invoice e-mail to the customer" staan allebei standaard uit.


Orderstatus en trackingcodes voor Webshop.nl
Je handelt een Webshop.nl-order af zoals elke andere order: maak de zending aan in Magento en voeg het trackingnummer toe. Webshop.nl vraagt de status op via GET /V1/webshopnl/status/:order_id.
Het antwoord bevat de orderstatus in Magento, of er een zending is en per trackingnummer de verzenddatum, de trackingcode en de naam van de vervoerder. De verzendinformatie komt dus rechtstreeks uit je Magento-zendingen.
Het moment van de laatste orderimport wordt ook opgeslagen en is onderdeel van het info-endpoint. Dat helpt als je wilt nagaan of de koppeling nog actief is.
Nieuw in versie 1.2.0
De feedgeneratie draait in een eigen cron-groep webshopnl, in een apart proces naast de andere cronjobs van Magento.
De orderimport heeft een eigen "Enable" onder "Orders", los van de productfeed.
De voorraad in de feed houdt rekening met MSI-reserveringen.
Webshop.nl Marketplace voor Magento 2: technische details voor developers en winkeleigenaren
De voordelen voor developers
- REST API: drie routes,
POST /V1/webshopnl/order/:store_id,GET /V1/webshopnl/status/:order_idenGET /V1/webshopnl/info, achter een eigen ACL-resourceWebshopNL_Connect::webapi. - Validatie: een order zonder afleveradres, factuuradres, e-mailadres, naam, producten of verzendkosten krijgt de status
REJECTEDterug met de reden. - Cron en CLI: de feed draait in de cron-groep
webshopnlmetuse_separate_process, enbin/magento webshopnl:feed:create --store-id=<id>genereert één store view op aanvraag. - Logging: "Debug Mode" plus de knoppen "Debug Log" en "Error Log", die de laatste 100 regels tonen en als .txt-bestand aanbieden. Een mislukte orderimport komt in het errorlog.
- Systeemeisen: Magento 2.4.6 of nieuwer en PHP 8.2 of hoger, te installeren met
composer require webshop-nl/magento2.
Goed om te weten voor winkeleigenaren
- Er draait niets totdat je het aanzet: "Enabled" onder "General", "Enable" voor de feed en "Enable" voor de orderimport staan na installatie alle drie op "No".
- Zet "VAT Percentage" aan: het staat standaard uit, terwijl de admin vermeldt dat Webshop.nl het veld verplicht stelt.
- Controleer "EAN-code": dit veld verwijst standaard naar
sku. - Geïmporteerde orders worden in euro's aangemaakt.
- Sla de configuratie op voordat je een feed genereert, zoals het feedoverzicht aangeeft.
Koppel je Magento 2-winkel aan Webshop.nl
Registreer vanuit de admin, zet de feed en de orderimport aan, en je catalogus en marketplace-orders lopen via Magento.
Magmodules bouwt en onderhoudt de extensie en ondersteunt de merchants die haar gebruiken.
Kennisbank
Alle bekende helpartikelen
Een lijst met de meest gestelde vragen over de Webshop.nl Marktplaats-extensie voor Magento 2. We hebben ons best gedaan om je te helpen met de installatie, configuratie en probleemoplossing. Als je het antwoord dat je zocht niet kunt vinden, kun je ons altijd een bericht sturen via dit formulier.
Kwaliteit
Goedgekeurd, compatibel en getest

Adobe Commerce Goedgekeurd door Marketplace
Deze extensie staat op de officiele Adobe Commerce Marketplace en heeft het reviewproces doorlopen op codekwaliteit, performance en beveiliging.
Goedkeuring via de Adobe Marketplace betekent dat de extensie voldoet aan de Magento coding standards en correct integreert met het platform. Updates doorlopen hetzelfde reviewproces.

Hyvä Compatibele Plugin
Deze extensie biedt volledige ondersteuning voor Hyva Themes. Alle frontend-componenten, widgets en templates werken native met Hyva's Alpine.js en Tailwind CSS stack.
De extensie werkt direct op Hyva en wordt bij elke nieuwe Hyva-release getest om compatibiliteit te blijven garanderen.

GraphQL Klaargemaakt
Deze extensie stelt data en configuratie beschikbaar via Magento's GraphQL API. Je kunt data direct opvragen en muteren vanuit headless frontends of eigen applicaties.
Het GraphQL-schema volgt de conventies van Magento en dekt alle kernfunctionaliteit van de extensie. Hierdoor is het geschikt voor PWA Studio, Vue Storefront of elke andere headless setup.

Magento Cloud Ondersteuning
Deze extensie is volledig compatibel met Adobe Commerce Cloud (Magento Cloud). Het werkt met het read-only filesystem, de build- en deploy-pipeline en cloud-specifieke caching-lagen.
Er is geen extra configuratie of workaround nodig voor cloud-omgevingen. De extensie gaat op dezelfde manier om met static content deployment en configuratiebeheer als bij on-premise installaties.

Privé Composer Repo
Na aankoop krijg je toegang tot een prive Composer-repository met persoonlijke credentials. Installeer en update de extensie met een enkel composer-commando, net als elke andere dependency.
Je Composer-credentials zijn beschikbaar in je accountdashboard. Updates worden gepubliceerd zodra een nieuwe versie beschikbaar is, zodat je altijd toegang hebt tot de laatste versie.