Webshop.nl Marketplace for Magento 2
Connect Magento 2 directly to the marketplace Webshop.nl: export your catalogue as a product feed and receive Webshop.nl orders as regular Magento orders.





Connect Magento 2 Directly to the Marketplace Webshop.nl
Your Catalogue on Webshop.nl, the Orders in Magento
The Webshop.nl Marketplace extension connects your Magento 2 store directly to the marketplace Webshop.nl. Your products go out as a product feed, and orders placed on Webshop.nl arrive in Magento as regular orders.
You set up the connection from the Magento admin. The "Register now" button opens the Webshop.nl partner portal and sends your store details along, so you do not have to type them in again. From then on Webshop.nl talks to your store through the extension's own REST endpoints.
The extension is built by Magmodules, a plugin developer from the Netherlands. Version 1.2.0 runs on Magento 2.4.6 and newer with PHP 8.2 or higher.

What the Extension Does
Direct Registration
"Register now" opens the Webshop.nl partner portal and sends your company name, VAT number, address and integration token along.
NDJSON Product Feed
One feed per store view, generated on a schedule, from the admin or with a CLI command.
Attribute Mapping
Link name, descriptions, EAN, brand, colour, material, size and gender to your own Magento attributes.
Variants and Filters
Decide how configurable, bundle and grouped products are exported and filter on visibility, category and stock.
Order Import
Webshop.nl orders are created in Magento, invoiced and set to processing, with the Webshop.nl order ID in the order grid.
Status and Logs
Webshop.nl can request the order status and tracking codes, and the admin shows the last 100 debug and error log records.
Register with Webshop.nl from the Magento Admin
The extension adds its own tab "Webshop.nl" to the Magento configuration, with the sections "General", "Product Catalogue" and "Orders". At the top of the settings you find the "Register now" button, which opens the Webshop.nl partner portal.
The button sends the following along: company name, VAT number, street, house number, postcode, city and country from the Magento Store Information, plus the integration token and the URL of the info endpoint. The read-only field "Magento Integration Token" shows the same token.
The field "Mode" appears once "Enabled" is set to "Yes" and is "Production" by default. Choose "Development" only when you test against a development portal.
What Webshop.nl Reads from Your Store
Through GET /V1/webshopnl/info Webshop.nl sees whether the extension is enabled, the module and Magento version, the feed URL per store view, the URLs for orders and order status, the time of the last order import and the active stores.


An NDJSON Product Feed per Store View
Under "Product Catalogue" you turn on the feed with "Enable" and choose the "Filename", by default webshop.ndjson. Every store view gets its own feed in NDJSON format, so each language or assortment has its own file.
"Auto Generate" refreshes the feed by cron: "Daily at 0:00" (the default), "Every 6 hours", "Every 4 hours", "Every 2 hours", "Every hour" or "Custom". With "Custom" you enter your own schedule in crontab notation under "Custom Frequency". The feed then follows your catalogue without manual exports.
Generate, Preview and Download
The feeds overview lists the NDJSON URL per store view, with the time of generation and the number of products. From there you use "Generate", "Preview" and "Download". Save the configuration before you generate a feed.
Developers run the same generation with bin/magento webshopnl:feed:create, or for one store view with --store-id=<id>. The stock in the feed takes MSI reservations into account.
Link Your Own Attributes to the Webshop.nl Fields
Under "Product Data" you choose per field which Magento attribute fills it: "Name", "Short Description", "Long Description", "EAN-code", "Brand", "Color", "Material", "Size" and "Gender". The defaults are name, short_description, description, manufacturer, color, material, size and gender.
"EAN-code" points to sku by default, so select your EAN attribute there if you keep EANs in a separate attribute. "Extra Info" is a free text field, for example: Free pickup from store.
Category, Delivery Time and VAT
- Category: with "Type" you use the "Magento Category Tree", a "Custom Category Value" or "Use Attribute".
- Delivery time: choose "Static Values" and fill in "Delivery Time - In Stock" and "Delivery Time - Out of Stock", or choose "Use Attribute".
- VAT: "VAT Percentage" is off by default, while the admin states that Webshop.nl requires this field. Turn on "Enable" and use the "Fixed Value" (21 by default) or an attribute.
- Images: "Source" sets which images are exported. When all images are exported, "Main Image" sets which one is the main image.
Under "Additional Configuration" you add "Extra Fields" for custom fields, "Shipping Settings" for shipping prices per price range and a "UTM Code" for Google Analytics.


Choose Which Products and Variants Go into the Feed
A configurable product cannot be bought on its own, only its variants can. Under "Product Types" the setting "Use Configurable/Simple Products" therefore has four options: "No", "Only Configurable Product", "Only Linked Simple Products (Recommended)" and "Configurable and Linked Simple Products". After installation it is set to "Configurable and Linked Simple Products".
With "Only Linked Simple Products (Recommended)" an Oslo Lounge Chair in oak, walnut and black is exported as three items, one per variant.
"Use Parent URL for Simples" with "Yes, with Auto-Link (Recommended)" sends the shopper to the configurable product page, linked to the right variant. "Use Parent Image for Simples" and "Use Parent Data for Simples" take the image and the attributes you select from the parent product. "Use Fallback only on Non Visible Simples" limits that to variants that are not visible individually. Bundle and grouped products have the same kind of settings, and grouped products also have "Parent Price".
Filter Options
Under "Filter Options" you narrow the feed down by visibility, by category (include or exclude) with "Filter by Category", by stock with "Exclude Out of Stock" and by your own rules with "Advanced Filters" and "Filter Conditions". All filters are off by default.
Webshop.nl Orders as Regular Magento Orders
Webshop.nl sends every order to your store through POST /V1/webshopnl/order/:store_id. The extension creates a Magento order with the payment method webshopnl, invoices it and sets the status to processing, so it shows up in your normal fulfilment flow. The Webshop.nl order ID is stored on the order and shown in the order grid as the column "Webshopnl Order ID".
The import has its own "Enable" under "Orders" and is off by default. As long as it is off, an order is rejected with the message "Order import is disabled for this store". An order that was imported before is rejected as well, so you do not get duplicates.
Shipping, Customers and E-mails
- Shipping: "Default Shipping Method" is used for imported orders. When that method is not available for an order, "Fallback for Shipping Method" takes over. The shipping cost comes from the Webshop.nl order.
- Customers: "Import Customers" is off by default. Set it to "Yes" and the field "Customer Group" appears.
- Address: turn on "Separate house number" when your store uses the second street line for the house number.
- E-mails: "Send order e-mail to the customer" and "Send invoice e-mail to the customer" are both off by default.


Order Status and Tracking Codes for Webshop.nl
You handle a Webshop.nl order like any other order: create the shipment in Magento and add the tracking number. Webshop.nl requests the status through GET /V1/webshopnl/status/:order_id.
The response contains the Magento order status, whether a shipment exists and, per tracking number, the shipment date, the tracking code and the carrier title. The shipping information comes straight from your Magento shipments.
The time of the last order import is stored as well and is part of the info endpoint. That helps when you check whether the connection is still active.
New in Version 1.2.0
Feed generation runs in its own cron group webshopnl, in a separate process from the other Magento cron jobs.
The order import has its own "Enable" under "Orders", apart from the product feed.
The stock in the feed takes MSI reservations into account.
Webshop.nl Marketplace for Magento 2: Technical Details for Developers and Store Owners
The Advantages for Developers
- REST API: three routes,
POST /V1/webshopnl/order/:store_id,GET /V1/webshopnl/status/:order_idandGET /V1/webshopnl/info, behind their own ACL resourceWebshopNL_Connect::webapi. - Validation: an order without delivery address, billing address, e-mail address, name, products or shipping cost is answered with the status
REJECTEDand the reason. - Cron and CLI: the feed runs in the cron group
webshopnlwithuse_separate_process, andbin/magento webshopnl:feed:create --store-id=<id>generates one store view on demand. - Logging: "Debug Mode" plus the buttons "Debug Log" and "Error Log", which show the last 100 records and offer them as a .txt download. A failed order import is written to the error log.
- Requirements: Magento 2.4.6 or newer and PHP 8.2 or higher, installed with
composer require webshop-nl/magento2.
Good to Know for Store Owners
- Nothing runs until you turn it on: "Enabled" under "General", "Enable" for the feed and "Enable" for the order import are all set to "No" after installation.
- Turn on "VAT Percentage": it is off by default, and the admin states that Webshop.nl requires the field.
- Check "EAN-code": it points to
skuby default. - Imported orders are created in euros.
- Save the configuration before you generate a feed, as the feeds overview points out.
Connect Your Magento 2 Store to Webshop.nl
Register from the admin, turn on the feed and the order import, and your catalogue and marketplace orders run through Magento.
Magmodules builds and maintains the extension and supports the merchants who use it.
Knowledgebase
All familiar Help articles
A list of the most frequently asked questions from the Webshop.nl Marketplace extension for Magento 2. We've tried our best to help you with the installation, configuration and troubleshooting. If you do not find the answer you were looking for, you can always send us a message through this form.
Quality
Approved, Compatible and Tested

Adobe Commerce Marketplace Approved
This extension is listed on the official Adobe Commerce Marketplace and has passed their review process for code quality, performance and security.
Adobe Marketplace approval means the extension follows Magento coding standards and integrates properly with the platform. Updates go through the same review process.

Hyvä Compatible Plugin
This extension includes full support for Hyva Themes. All frontend components, widgets and templates work natively with Hyva's Alpine.js and Tailwind CSS stack.
The extension works out of the box on Hyva and is tested with every new Hyva release to ensure continued compatibility.

GraphQL Made Ready
This extension exposes its data and configuration through Magento's GraphQL API. You can query and mutate data directly from headless frontends or custom applications.
The GraphQL schema follows Magento's conventions and covers all key functionality of the extension. This makes it ready for PWA Studio, Vue Storefront or any other headless setup.

Magento Cloud Support
This extension is fully compatible with Adobe Commerce Cloud (Magento Cloud). It works with the read-only filesystem, the build and deploy pipeline and cloud-specific caching layers.
No additional configuration or workarounds are needed for cloud environments. The extension handles static content deployment and config management the same way as on-premise installations.

Private Composer Repo
After purchase you get access to a private Composer repository with personal credentials. Install and update the extension with a single composer command, just like any other dependency.
Your Composer credentials are available in your account dashboard. Updates are published to the repository as soon as a new version is released, so you always have access to the latest version.