BOXO Herbruikbare Verpakking voor Magento 2




Krachtige Magento 2 BOXO-koppeling voor herbruikbare verzendverpakkingen
Laat klanten in de checkout kiezen voor een herbruikbare verpakking
Steeds meer shoppers willen hun online bestelling ontvangen zonder een berg karton en plastic. BOXO maakt dat mogelijk met herbruikbare verzendverpakkingen op basis van statiegeld: de klant ontvangt de bestelling in een stevige box en levert die in bij een BOXO inleverpunt in de buurt.
De BOXO Herbruikbare Verpakking-extensie brengt die keuze naar je Magento 2-checkout. In de verzendstap kiezen klanten voor een herbruikbare verpakking met statiegeld of een gewone wegwerpverpakking, en de module controleert realtime of de verpakking in de buurt van hun adres echt kan worden ingeleverd.
De extensie is door Magmodules ontwikkeld in samenwerking met BOXO en regelt beschikbaarheid, prijzen, productregels en orderverwerking voor je. Duurzaam verzenden aanbieden kost zo een paar instellingen in plaats van een ontwikkelproject.

Herbruikbaar of wegwerp, gekozen in de verzendstap
De verpakkingskeuze staat precies waar hij hoort: in de verzendstap, naast de bezorggegevens. De herbruikbare verpakking is standaard voorgeselecteerd, zodat klanten bewust moeten afzien van de duurzame optie in plaats van die zelf te moeten vinden. Wil je het rustiger introduceren? Selecteer dan standaard de wegwerpverpakking.
Voor beide opties worden de kosten correct berekend:
- Herbruikbare verpakking: gerekend als statiegeld dat door BOXO is vastgesteld, zonder btw, omdat statiegeld geen verkoop is.
- Wegwerpverpakking: gratis, of met een kleine toeslag die de btw-instellingen van je webshop volgt of met een zelf in te stellen kleine toeslag.
- Geen lege regels: is de wegwerpverpakking gratis, dan wordt er geen orderregel toegevoegd, terwijl de keuze wel op de bestelling wordt opgeslagen.
Een info-icoon naast de herbruikbare optie legt uit hoe inleveren werkt. Het linkt standaard naar de BOXO inleverpunten, of naar je eigen informatiepagina als je dat liever hebt.

Realtime beschikbaarheid
Controleert de verzendpostcode via de BOXO API, zodat de herbruikbare verpakking alleen verschijnt waar die kan worden ingeleverd.
Productregels
Bepaal welke producten in aanmerking komen en hoeveel artikelen in één herbruikbare verpakking passen.
Statiegeld en toeslag
Statiegeld zonder btw, met een optionele toeslag inclusief btw op de wegwerpverpakking.
Zichtbaar bij de bestelling
De gekozen verpakking staat in de orderweergave in de admin en is filterbaar in het orderoverzicht.
Alleen aangeboden waar de box terug kan komen
Statiegeld heeft alleen zin als de klant het ook terug kan krijgen. Zodra het verzendadres compleet is, vraagt de module aan de BOXO API of de postcode wordt bediend. Alleen dan, en alleen als de winkelwagen aan je productregels voldoet, verschijnen de verpakkingsopties.
Gebouwd voor het Nederlandse BOXO-netwerk
Inleveren bij BOXO kan op dit moment in Nederland, dus de check draait alleen voor Nederlandse adressen. Klanten in andere klanten of zonder lokaal BOXO inleverpunt, zien gewoon je standaard checkout.
Licht voor je checkout
De beschikbaarheidscheck is één API-call, die pas wordt gedaan als het adres compleet is. Voor adressen buiten Nederland wordt hij overgeslagen en zolang de module uitstaat gebeurt er helemaal niets, dus je checkout blijft snel.


Bepaal precies welke producten in aanmerking komen
Niet alles past in een herbruikbare verzendverpakking. Een parasol, een ingelijste spiegel of een zak potgrond van 25 kilo hoort in een gewone verpakking. Met de productregels bepaal je welke producten in een herbruikbare verpakking mogen, via een van drie standen: alle producten, alle producten behalve de producten die je selecteert, of alleen de producten die je selecteert.
Elke stand gebruikt een eigen productvlag, zodat je een pilot kunt draaien op één merk, later kunt overstappen naar een volledige uitrol en je lijst gewoon bewaard blijft. Producten markeer je in bulk vanuit het productoverzicht met Update Attributes, zonder elk product apart te hoeven bewerken.
Stel in hoeveel artikelen er in een box passen
Met de instelling voor het maximaal aantal producten bepaal je hoeveel artikelen er nog in één herbruikbare verpakking passen. Daarbij telt het totale aantal stuks, dus vijf dezelfde T-shirts tellen als vijf, en configureerbare of bundelproducten tellen één keer via het hoofdproduct. Staat er één product in de winkelwagen dat niet is toegestaan, of wordt het maximum overschreden, dan valt de winkelwagen terug op de wegwerpverpakking, omdat de bestelling als één pakket wordt verzonden.
De verpakkingskeuze reist mee met de bestelling
Je magazijn moet weten welke verpakking het moet gebruiken zonder dat erom gevraagd hoeft te worden. De gekozen verpakking wordt op de bestelling opgeslagen en getoond in de orderweergave in de admin, en je kunt erop filteren in het orderoverzicht. Zo kan fulfilment vanaf het begin op de juiste manier picken en inpakken.
Omdat de keuze op de bestelling zelf staat, is die er altijd, of er nu een orderregel is toegevoegd of niet. Dat houdt je rapportages betrouwbaar en voorkomt giswerk bij je klantenservice.
Afhalen in de winkel gaat vanzelf goed
Kiest een klant voor afhalen in de winkel, dan wordt de verpakkingsregel verwijderd. Een pakket dat niet wordt verzonden heeft geen verzendverpakking nodig, dus je hoeft hiervoor niets extra in te stellen.

In een paar minuten ingesteld, getest voordat je live gaat
Installeer de extensie, plak je BOXO API-sleutel en klik op Test Connection. De test vertelt je precies wat er aan de hand is: de sleutel werkt, BOXO heeft de sleutel geweigerd, of de API was helemaal niet bereikbaar. Zo weet je of je naar je sleutel of naar je server moet kijken.
composer require magmodules/magento2-boxo
De module staat na installatie uit, dus er verandert niets in je checkout tot je er klaar voor bent. Een ingebouwde Selftest controleert in één keer je PHP- en Magento-versie, de modulestatus, de BOXO-verpakkingsproducten en de API-verbinding, en de debug- en foutlogs bekijk je direct vanuit het configuratiescherm, zonder shell-toegang.
Voegt een herbruikbare en een wegwerpverpakking toe aan de Magento 2-checkout.
Controleert de BOXO-beschikbaarheid realtime op de Nederlandse verzendpostcode.
Rekent statiegeld zonder btw voor de herbruikbare verpakking.
Optionele toeslag inclusief btw voor de wegwerpverpakking, of bied die gratis aan.
Productregels met drie standen en een maximaal aantal artikelen per verpakking.
Verpakkingskeuze in de orderweergave en filterbaar in het orderoverzicht.
Magento 2 BOXO-koppeling: technische details voor developers en webshopeigenaren
De voordelen voor developers
De extensie ondersteunt Magento 2.4.6 tot en met 2.4.9 op PHP 8.1+ en volgt de Magento-codeerstandaard. Bij installatie maakt hij twee virtuele producten aan (het statiegeld voor de herbruikbare verpakking en de toeslag voor de wegwerpverpakking), plus de productattributen voor de productregels. De API-sleutel wordt versleuteld opgeslagen en alleen gemaskeerd in de debuglog geschreven. Bij elke pull request draaien PHP-linting, de Magento-codeerstandaard, PHPStan en unittests, en een Playwright end-to-end-testsuite test de checkout tegen een nagebootste BOXO API, inclusief de foutsituaties.
Goed om te weten voor webshopeigenaren
Voor webshopeigenaren maakt de extensie duurzaam verzenden een vast onderdeel van je checkout. Klanten krijgen een duidelijke keuze, statiegeld en toeslag worden correct berekend en je team ziet bij elke bestelling welke verpakking is gekozen. Begin met een pilot op een deel van je assortiment, rol uit wanneer je er klaar voor bent en beheer alles vanuit de Magento-admin, zonder developer.

Maak de herbruikbare verpakking de standaardkeuze
Elke herbruikbare box die de deur uitgaat, vervangt een wegwerpverpakking die anders in de container was beland. BOXO vat het zelf mooi samen: kleine moeite, grote impact. Voor je klanten is het één klik in de checkout en een korte wandeling naar een inleverpunt.
Met de BOXO Herbruikbare Verpakking-extensie biedt je Magento 2-webshop die keuze aan waar het telt: in de checkout, alleen waar het werkt en met het statiegeld correct afgehandeld. Zo verminder je eenvoudig verpakkingsafval, laat je klanten zien waar je voor staat en wordt duurzaam verzenden een vast onderdeel van je webshop.
Kennisbank
Alle bekende helpartikelen
Een lijst met de meest gestelde vragen over de BOXO Herbruikbare Verpakking-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
Configuratie

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.