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.

Links
Gratis te downloaden Inclusief levenslange updates en ondersteuning
Magento Cloud Ondersteuning GraphQL Ondersteuning Hyvä Ondersteuning Adobe Goedgekeurd Privé Composer Repo
Documentatie

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.

Het Webshop.nl-logo boven het ordergrid van Magento, waarin marketplace-orders een Webshopnl Order ID hebben.

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.

De instellingen onder General van de Webshop.nl-extensie met de knop Register now en de winkelgegevens die worden meegestuurd.
De instellingen onder Product Catalogue met Enable, Filename en Auto Generate, naast de CLI-opdracht die de feed genereert.

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.

Additional Fields onder Product Data, waar EAN-code, Brand, Color, Material, Size, Gender en Extra Info zijn ingevuld.
De instellingen onder Configurable Products en een tekening van één configurable product dat als drie simple producten wordt geëxporteerd.

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.
De instellingen Customers en Address & Invoice voor de orderimport, met de bevestiging die Magento teruggeeft voor een geïmporteerde order.
De trackinggegevens van een Magento-zending naast het statusantwoord waarin de trackingcode staat.

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_id en GET /V1/webshopnl/info, achter een eigen ACL-resource WebshopNL_Connect::webapi.
  • Validatie: een order zonder afleveradres, factuuradres, e-mailadres, naam, producten of verzendkosten krijgt de status REJECTED terug met de reden.
  • Cron en CLI: de feed draait in de cron-groep webshopnl met use_separate_process, en bin/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.

Bekijk de extensie Lees de documentatie

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.

Installatieartikelen

arrow-circle-right Installatie met Composer (aanbevolen) arrow-circle-right Installatie via de Adobe Marketplace arrow-circle-right Installatie via FTP en SSH

Configuratie

arrow-circle-right Configuratie arrow-circle-right De feed filteren arrow-circle-right Producttypes arrow-circle-right Aan de slag

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.

star star star star star
star star star star star
Gaaf - digital agency
We have tried the integration with SnelStart through several different providers, and this is the only solution that simply works. We needed support on two occasions, and it was provided quickly and professionally. We do recommend this company!
Google 12 May 2026
star star star star star
star star star star star
Andrew Velikiy
Great vendor with handy modules and quick support!
Google 13 Apr 2026
star star star star star
star star star star star
Alexandru-Manuel Carabus
Magmodules sets the bar for Magento module quality and support—we check their catalog first for client feature requests, and they’re our first choice for licenses.
Google 11 Nov 2025
star star star star star
star star star star star
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
Google 09 Sep 2025
star star star star star
star star star star star
Jan Privé
Dankzij de heldere uitleg en snelle reactie van Magmodules kon mijn vraag, en dus mijn Magento-probleem, binnen enkele uren worden beantwoord. Doeltreffend, zonder moeilijke termen, gewoon zo als het zou moeten zijn.... Bedankt!
Google 05 Sep 2025
star star star star star
star star star star star
Denis Metzler
To evaluate a provider, it is not enough to consider only the product offered, but also its after-sales service, such as support and troubleshooting. Magmodules has been extremely satisfactory at all levels on multiple occasions and sets the bar at the top when comparing the competition.
Google 02 Sep 2025
star star star star star
star star star star star
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
Google 30 Jul 2025
star star star star star
star star star star star
Patrick Verduijn
Magmodules biedt plugins aan die van hoge kwaliteit zijn tegen een goede prijs, waar dit bedrijf in uitblinkt is de bereidheid om de zeldzame feedback & problemen met de plugins te willen onderzoeken, mee te willen denken in het debuggen van problemen en goede oplossingen toe te passen. In mijn decennium ervaring met Magento & 3th parties is Magmodules absoluut een uniqum binnen de markt.
Google 25 Jul 2025
star star star star star
star star star star star
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
Google 18 Jul 2025
star star star star star
star star star star star
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
Google 30 Jun 2025