The Magento module allows a shop owner to implement the creation of orders in Boekuwzending.


The minimum requirements for running this module in Magento are:

  • Magento 2.3
  • PHP 7.4
  • Composer < 2 (e.g. 1.10.19)

And all transitive dependencies specified in the composer.json which will be installed during the module installation.

Retrieve your credentials

To let the module communicate securely with the Boekuwzending API, you will need to request credentials. These credentials can be retrieved via the Mijn Boekuwzending platform. When logged in click on your username, navigate to "Integraties" and click the "Integratie starten" button next to Magento.

Enter your Shop URL and choose the default sender address. You can change this address when processing the imported orders.

After submitting with "Koppelen" you will be shown your credentials. Keep these credentials safe, you will need them later to configure the Magento module.


This module only supports manual installation, meaning you can't install it from the Marketplace.

Manual installation

To install the module in your Magento installation you need shell access (SSH) to the server. Assuming Composer is already present, in the Magento directory, execute the following commands as the user that Magento runs as:

bin/magento maintenance:enable 
composer require boekuwzending/magento 
bin/magento module:enable Boekuwzending_Magento
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean
bin/magento maintenance:disable 

This is a common workflow for many Magento modules. First, the maintenance mode is enabled, ensuring no visitors of the site will encounter any errors. Then the module is downloaded from GitHub using Composer. Note that you'll need access keys for the Composer directory of Magento, available through

The Composer installation may take a while, as Composer carefully calculates all dependencies that are currently required and whether there will be any conflicts with the requirements of the module to be installed.

Then some Magento commands are run, which enable the module, upgrade the configuration and database, compile the classes for dependency injection (DI) and finally to clean the cache and disable the maintenance mode again.


The setup:upgrade command utilizes the db_schema.xml of the module to create a new database table boekuwzending_order, which allows linking one Magento order to zero or more Boekuwzending orders.


When a new version of the module is released, you can update it using the following commands in the Magento directory:

bin/magento maintenance:enable 
composer update boekuwzending/magento 
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean
bin/magento maintenance:disable

The same information as mentioned at the installation applies.

Composer can cache packages quite aggressively, so if you're trying to update to a version that was released recently, you might need to bypass the cache in the second command, replacing it with:

composer update boekuwzending/magento --no-cache

After running the composer command, you can verify the proper verison was installed using:

composer show | grep boekuwzending

You should see the expected version:

boekuwzending/magento     v1.1.0


The module is configured from the Admin interface. You can find the settings under Stores -> Configuration -> Sales -> Delivery methods.

Boekuwzending for Magento: Configure the module
Enabled for CheckoutWhen enabled, customers can choose this delivery method. Whether this configuration value is enabled or not, the module will send all orders to Boekuwzending, whichever delivery method was chosen.Yes | No1.0.0
TitleThe default title displayed for this shipping method, see also Usage below.Any string1.0.0
Method NameThe default name of this shipping method, see also Usage below.Any string1.0.0
Shipping Cost Without MatrixA fixed shipping fee for shipments that don't use the shipping matrixNumeric with decimals, in the currency of the store.1.0.0
Client IDThe id belonging to the integration you want to link to this shop.Any string1.0.0
Client SecretThe secret belonging to the integration you want to link to this shop.Any string1.0.0
Test ModeWhen "Yes", orders are created in the staging environment of Boekuwzending. When Test mode is disabled, orders will be created in the live environment.Yes | No1.0.0
Forward Order on Status Change toWhen an order changes state to any of the selected statuses, and no Boekuwzending order is known yet, the plugin will forward the order to Boekuwzending. Multiple statuses can be selected; by default "Processing" (after payment through PayPal and iDeal) and "Complete" (pay by check) are selected.All known order statuses1.1.0
Ship to Applicable CountriesIdentifies the countries where you offer this shipping method.All Allowed Countries - Customers from any country specified in the store configuration can use this shipping method.
Specific Countries - Customers from only specific countries (see option below) can use this shipping method.
Ship to Specific CountriesWhen the Ship to Applicable Countries option is set to "Specific Countries", you can select which countries here.Country selection1.0.0
Show Method if Not ApplicableWhether this method should be shown if it can't be selected for the current order.No | Yes1.0.0
Sort OrderAt which position to show this shipping methods. Only applicable if multiple shipping methods can be selected.Numeric1.0.0


When configured, the shipping method looks like this:

Boekuwzending for Magento: Use the shipping method

Users can now select this shipping method. When placing the order, it is immediately forwarded through the Boekuwzending API, making it known in Imported Shipments at


An order that is not linked to Boekuwzending looks like this:

Boekuwzending for Magento: Order not linked

Orders are usually linked on a one-to-one basis:

Boekuwzending for Magento: One order linked

It's also possible to click "Create new order" and split an order into multiple orders at Boekuwzending:

Boekuwzending for Magento: Multiple linked orders


Starting with version 2.0.0 of the plugin you'll be able to intercept the Boekuwzending order model before it gets sent to the Boekuwzending API.

To do so, register an observer in your site's /etc/events.xml:

<config xmlns:xsi="" xsi:noNamespaceSchemaLocation="urn:magento:framework:Event/etc/events.xsd">
    <event name="boekuwzending_order_create_before">
        <observer name="boekuwzending_order_create_before_observer" instance="YourNamespace\YourModule\Observer\OrderCreateBeforeObserver"/>

The event is dispatched after the model has been populated from the Magento order. The event data will be an array in this format:

    'boekuwzending_order' => /** @var Boekuwzending\Resource\Order */,
    'magento_order' => /** @var Magento\Sales\Model\Order */,

A sample implementation:


namespace YourNamespace\YourModule\Observer;

class OrderCreateBeforeObserver implements Magento\Framework\Event\ObserverInterface
    * Gets executed before an order will be sent to the Boekuwzending API.
    public function execute(\Magento\Framework\Event\Observer $observer): void
        /** @var Magento\Sales\Model\Order $magentoOrder */
        $magentoOrder = $observer->getData('magento_order');

        // Use for example $street = $magentoOrder->getShippingAddress()->getStreet()

        /** @var Boekuwzending\Resource\Order $order */
        $order = $observer->getData('boekuwzending_order');

        /** @var Boekuwzending\Resource\Address $shipTo */
        $shipTo = $order->getShipToAddress();

        // You could use $street[0], $street[1], $street[2],
        // but the array will be sized to the actual input.

        $shipTo->setStreet('Observerstreet'); // $street[0]
        $shipTo->setNumber('42'); // $street[1]
        $shipTo->setNumberAddition('A'); // $street[2]

        // Clear the result of our parsing

Our code puts $street[1] and $street[2] into the "address line 2" property if it can't parse it. You'll need to clear the "address line 2" property if you perform manual parsing as shown above, using $shipTo->setAddressLine2(null), otherwise you can end up with duplicate data.