Magento 2 plugin handleiding

Lees hier alles over de Magent 2 plugin.

Inleiding

De Vendiro Magento2 plugin is ontwikkeld om een bestaande Magento webshop eenvoudig te kunnen koppelen aan het Vendiro platform.
Met deze plugin kunnen bestellingen van bijvoorbeeld Amazon en Bol.com geïmporteerd worden en kan de voorraad op de Marketplaces bijgehouden worden.
Ook de track & trace informatie kan hiermee doorgeven worden aan de Marketplaces.

Om volledig te koppelen met het Vendiro platform zijn naast de plugin ook data-feeds nodig met informatie over de te verkopen producten.
Belangrijk is om hierbij de SKU van de producten te gebruiken en niet het interne productnummer van Magento.

Om de Vendiro plugin te kunnen gebruiken zijn een API Key en API Token nodig, deze zijn op te vragen bij Vendiro.

De automatische taken lopen via de Magento cron, het is dus van belang dat de cronjob hiervoor ingesteld staat.
De plugin is getest voor Magento 2.3.5 tot Magento 2.4.6

1. Installatie

De laatste versie van de plugin kan gedownload worden via Github.
Let op: Dit betreft een nieuwe versie van de plugin. Neem contact op met Vendiro als je al gebruik maakt van de Magento plugin van Vendiro. 

2. Modules

De Vendiro Magento plugin bestaat uit 5 modules, de configuratie, de voorraad koppeling, de order import, de verzend bevestiging en factuur export.

Configuratie

De instellingen zijn te vinden via Stores > Configuration en vervolgens onder het kopje Sales is Vendiro te vinden.

Onder General Configuration kan gekozen worden of er verbinding gemaakt moet worden de productie of test omgeving van Vendiro.
Ook kan ervoor worden gekozen om de plugin uit te schakelen.

Bij de Vendiro Configuration kunnen de API Key en API Token ingevuld worden.
Daarnaast kan er gekozen worden om één of meer modules van de plugin te (de)activeren.
Ook kan er gekozen worden welke voorraad niveau gecommuniceerd moet worden met Vendiro.

De knop “Force queue all products” kan gebruikt worden om de voorraad van alle producten naar Vendiro te laten sturen.

Tot slot kan de default shipment provider ingesteld worden.
Hier kies je de verzendmaatschappij waarmee de pakketten verstuurd worden.

Bij de Cron settings kunnen de intervallen worden ingesteld voor de verschillende taken.
De taken worden vervolgens via de Magento cron uitgevoerd.

Voorraad koppeling

De voorraad koppeling zorgt ervoor dat de voorraad wijzigingen doorgestuurd worden naar Vendiro.
Bij een voorraad mutatie worden de producten in een queue gezet, om vervolgens periodiek door te sturen naar Vendiro.

Het interval waarmee de voorraad updates doorgestuurd worden kan ingesteld worden bij de Cron settings, standaard wordt de voorraad iedere 5 minuten doorgestuurd.

Daarnaast is het aan te raden om één keer per dag een volledige voorraad update te sturen, zodat nieuwe producten ook de actuele voorraad stand krijgen.
Deze update wordt standaard om 6 uur 's nachts verzonden.

Een volledige voorraad update kan eventueel ook handmatig via de configuratie pagina gestart worden.

Order import

In de Vendiro portal kan per Marketplace een Internal reference gevuld worden via Settings > Marketplaces.
Door in het Internal reference veld de Magento store code in te vullen, worden de bestellingen geïmporteerd in de specifieke shop.

De Internal reference dient altijd gevuld te worden, anders worden de orders niet geïmporteerd in Magento.
De Magento store codes zijn te vinden via Stores > All Stores en staan in de derde kolom (Store view).

Het interval waarmee de orders worden opgehaald kan ingesteld worden bij de Cron settings, standaard worden de nieuwe bestellingen iedere 5 minuten opgehaald.
Bij het ophalen van de orders worden alleen de orders opgehaald die de status ‘New – Validated’ hebben.

Indien Magento de order niet kan importeren, bijvoorbeeld omdat het product niet op voorraad is, dan zal de plugin een update sturen naar Vendiro om de status van de order aan te passen naar ‘On hold - Refused by client’.
In de portal verschijnt de order vervolgens op de Refused lijst, welke is te vinden via Orders > Refused.

Naast reguliere (Merchant Fulfilled) orders, kan de plugin ook overweg met FBA en LVB (Marketplaces Fulfilled) orders.
In plaats van de status ‘Processing’ zal de plugin de status van de order direct op ‘Complete’ zetten.

In Magento is het verplicht om een voornaam en achternaam apart aan te leveren, omdat Vendiro deze niet kent is ervoor gekozen om de voornaam altijd te vullen met de volledige naam en de achternaam met een spatie ( ).
Indien gewenst kan de waarde van de achternaam ook gevuld worden met een ster (*) of een streep (-).

Bij het importeren van de orders slaat de plugin ook het interne Vendiro volgnummer op.
Op basis van dit volgnummer kan een order ook herkent worden bij de import, waardoor een order van Vendiro slechts één maal geïmporteerd kan worden.

Bij administratiekosten (meer info in dit artikel) zal de de plugin deze bij de orderimport optellen bij de verzendkosten.

Verzendbevestiging

Nadat de orders zijn verzonden worden de track & trace codes, samen met de carrier code, automatisch doorgezet naar Vendiro.
Het is van belang om eerst de default carrier in te stellen bij de configuratie (zie hiervoor het kopje Configuratie), omdat Vendiro de verzendbevestiging anders weigert.

Het interval waarmee de track & trace codes worden verstuurd kan ingesteld worden bij de Cron settings, standaard worden deze iedere 5 minuten verzonden.

Foutafhandeling

Wanneer de plugin fouten aantreft, bijvoorbeeld bij de calls naar het Vendiro platform, worden deze gelogd in de algemene Magento Exception log.

3. Disclaimer

Omdat iedere Magento installatie anders is, kan het altijd gebeuren dat de plugin niet werkt zoals verwacht. Vendiro raadt daarom aan om de plugin altijd eerst op een test omgeving te installeren die vergelijkbaar is aan de productie omgeving.
Op deze manier kan door de gebruiker gecontroleerd worden of de plugin naar behoren werkt.

Vendiro heeft een test omgeving beschikbaar waar de plugin verbinding mee kan maken.
Op deze manier kunnen vooraf de voorraad koppeling, order koppeling en track & trace koppeling getest worden. Nadat de testen zijn afgerond kan de gebruiker de plugin installeren op de productie omgeving.