Gratis Magento 2 onderdelenmodule: het juiste onderdeel bij het juiste product

“Welk onderdeel past bij dit model?” is de vraag die elke verkoper van machine-, apparaat- en voertuigonderdelen steeds opnieuw krijgt. In de meeste Magento-webshops staat het antwoord in een pdf, een spreadsheet of in het hoofd van één ervaren collega bij sales. Elke keer dat een koper moet navragen, wordt het een e-mail, een telefoontje of een supportticket in plaats van een bestelling.

We raakten dit al aan in ons artikel Wat B2B-kopers echt willen van een self-service portaal. Dit is de diepere blik op de module die we ervoor bouwden: Spare Parts, een gratis Magento 2-extensie voor onderdelen.

Het idee: een onderdeel is gewoon een product

De eenvoudigste manier om “deze machine heeft deze onderdelen” in Magento te modelleren is ook de meest robuuste: producten aan producten koppelen. Een onderdeel is een gewoon catalogusproduct met een eigen SKU, prijs, voorraadstatus, afbeeldingen en een knop voor in winkelwagen. De module voegt alleen de relatie toe tussen een hoofdproduct (de machine, het apparaat, het model) en de onderdelen die erbij horen.

Dat klinkt bijna te simpel, maar het maakt het verschil. Omdat onderdelen echte producten zijn, blijft alles werken wat Magento al voor producten doet: voorraad, staffelprijzen, prijzen per klantgroep, zoeken, layered navigation en QuickOrder als je dat gebruikt. Er is geen tweede catalogus om te onderhouden.

Wat de koper ziet

Op twee plekken in de webshop:

  • Een blok “Vervangende onderdelen” op de productpagina. De koper opent de machine en ziet de gekoppelde onderdelen direct als productraster met prijs en winkelwagenknop. Geen pdf, geen telefoontje.
  • Een eigen overzichtspagina. Heeft een machine veel onderdelen, dan is een kort blok niet genoeg. De link “Alles bekijken” opent de volledige lijst op /replacement-parts voor dat product, met de layered navigation van Magento, zodat de koper kan filteren in plaats van scrollen.

Beide zijn te regelen via de winkelconfiguratie: hoeveel items op de productpagina, of het blok alleen bij voorradige onderdelen verschijnt, en vanaf welk aantal de link “Alles bekijken” getoond wordt.

Wat de beheerder doet

Op de productbewerkpagina staat een eigen tab Spare Parts. Zet “Show Spare Parts” aan, kies de onderdelen in een productkiezer, sla op. Koppelingen zijn per store view in te stellen, dus een catalogus met een ander assortiment per markt heeft geen omweg nodig. Toegang loopt via een eigen ACL-resource, zodat jij bepaalt welke beheerdersrollen de koppelingen mogen bewerken.

Er is ook een REST-endpoint, GET /V1/replacement-parts, dat de aan een product gekoppelde onderdelen teruggeeft. Handig als de data naar een app, een headless frontend of een dealerportaal moet.

Hyvä-storefronts

Het blok op de productpagina wordt geleverd met Luma-markup. Voor Hyvä-webshops is er een kleine aanvullende module, Spare Parts Hyvä, die het vervangt door native Tailwind-kaarten en een gewoon HTML-formulier voor de winkelwagen, zonder jQuery of RequireJS. De volledige overzichtspagina werkt op Hyvä al zonder, omdat die de categorie- en layered navigation-templates van Magento hergebruikt.

Waar de scope meestal fout gaat

Dezelfde drie fouten zien we steeds in onderdelenprojecten, met of zonder onze module.

  • Een directe koppeling behandelen als fitment-database. Product-naar-product-koppelingen beantwoorden “welke onderdelen horen bij deze machine”. Ze beantwoorden niet “welke onderdelen passen op bouwjaar 2019 met deze motorvariant”. Zoeken jullie kopers op bouwjaar, merk en motorcode, dan heb je daarbovenop gestructureerde fitment-data nodig. De simpele koppeling dekt verrassend veel catalogi, maar wees eerlijk over welk type je hebt voordat je je vastlegt.
  • Alles voor altijd met de hand koppelen. Een onderdeel dat op 30 machines past, heeft 30 koppelingen nodig. Bij een kleine catalogus is dat prima. Bij duizenden onderdelen hoort de import vanuit je ERP of PIM vanaf dag één in het plan, niet in “fase twee”.
  • Vergeten wat er gebeurt als een onderdeel uit productie gaat. Een onderdelenblok dat een niet meer leverbaar onderdeel toont, is erger dan geen blok. Daarom hebben we de afhandeling van uitgefaseerde producten zo gebouwd dat die samenwerkt met de onderdelen, in plaats van als nog een doodlopende weg.

Installatie

composer require brosolutions/spare-parts
bin/magento module:enable BroSolutions_SpareParts
bin/magento setup:upgrade

Voor Hyvä installeer je ook brosolutions/spare-parts-hyva. Beide pakketten staan op Packagist: brosolutions/spare-parts en brosolutions/spare-parts-hyva. De module is gratis en uitgebracht onder de MIT-licentie. De broncode staat op GitHub.

Hulp nodig met onderdelen in Magento?

Staat jullie onderdelendata in een ERP, is er fitment-logica nodig, of moet het samenwerken met QuickOrder en uitgefaseerde producten, dan is dat precies het werk dat wij doen. Mail naar contact@brosolutions.net en vertel hoe jullie kopers nu onderdelen vinden.