Magento 2

Snelstart — in 15 minuten je eerste pakket

Genoeg om vandaag je eerste echte order te versturen. Dieper configureren doe je via Wat zoek je? hieronder.

1. Account. Heb je nog geen MyParcel-account? Maak er een aan via myparcel.nl/register.
2. API-key kopiëren. Log in op backoffice.myparcel.nl → Shopinstellingen → Integratie → kopieer de API-key.
3. Plugin installeren. Laat je developer of hostingpartij composer require myparcelnl/magento && bin/magento setup:upgrade && bin/magento setup:di:compile && bin/magento cache:flush uitvoeren.
4. Plugin koppelen. Open Stores → Configuration → MyParcel → Settings, plak je API-key in API key, klik Save Config en daarna Import MyParcel Backoffice settings.
5. Eerste label. Open Sales → Orders → kies een betaalde order → Print MyParcel Label → controleer pakkettype/opties → Create.

Wat zoek je?

1 · Voorbereiden in je MyParcel-account

Voordat je in Magento begint, regel je vier dingen in je MyParcel-backoffice:

1. Factuur- en retouradres — Shopinstellingen → Algemeen. Dit komt op al je labels.
2. Vervoerders activeren — Shopinstellingen → Vervoerders. Alleen aangevinkte vervoerders verschijnen later in de plugin.
3. API key genereren — Shopinstellingen → Integratie.
4. Orderinformatie importeren (optioneel) — aanzetten als je de Ordermodus wilt gebruiken.

2 · Plugin installeren

De Magento-plugin wordt via Composer geïnstalleerd. Laat je developer of hostingpartij de volgende commando's op de server uitvoeren:

composer require myparcelnl/magento
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

composer require hyva-themes/magento2-hyva-checkout-myparcelnl
bin/magento setup:upgrade

Na installatie vind je de plugin onder Stores → Configuration → MyParcel.

3 · Plugin koppelen (API-key)

Open Stores → Configuration → MyParcel → Settings en plak je API-key bovenaan in het veld API key. Klik daarna op Save Config.

1. Log in op de MyParcel-backoffice.
2. Ga naar Shopinstellingen → Integratie.
3. Kopieer de API-key (meestal 40 tekens).
4. Plak deze in Magento en sla op.

Met de knop Import MyParcel Backoffice settings haal je je contract- en vervoerderinstellingen in één klik op. Vervoerder-tabs verschijnen pas na deze import.

Na een geldige key verschijnen de vervoerder-tabs.

Wat doet de plugin in je Magento-admin?

4 · Welk shop-profiel ben jij?

Drie typische profielen met aanbevolen settings. Eén kiezen, instellingen overnemen, dan met 5 · Settings · General finetunen.

Klein — paar orders per dag, alleen NL

Drukke shop — 50+ orders/dag

Brievenbus-only — koffie, kaarten, cosmetica

5 · Settings · General

De algemene tab regelt de koppeling, de verzendkostenregels, bezorgdagen, printinstellingen en hoe het MyParcel-blok in de checkout er uitziet.

API settings

• API key — koppelt je shop aan MyParcel. Zonder geldige key werken de bezorgopties niet.
• Import MyParcel Backoffice settings — haalt je actuele contract- en vervoerderinstellingen op uit MyParcel.

Delivery costs

Definieer welke verzendprijs klanten in de checkout zien. Elke regel bestaat uit een Rule name, een Price en één of meer condities (gewicht, pakkettype, land). Bv. "Brievenbuspakje binnen Nederland < 12 kg" met prijs €4,97.

• Show or hide JSON textarea — geavanceerde weergave voor wie regels als JSON wil bewerken.
• Use Free Shipping — respecteer Magento's gratis-verzending-regels.

Date settings

• Number of days — hoeveel dagen vooruit klanten een bezorgdag mogen kiezen. Standaard 7.
• Drop-off delay — werkdagen tussen bestelling en aanleveren. Zet op 1 als je bestellingen pas de volgende dag verwerkt.

Print settings

• Mode — Concept (eerst in MyParcel-backoffice) of Direct (direct definitief).
• Paper type — A4 (standaard printer) of A6 (labelprinter).
• Label description — tekst op het label, met variabelen zoals %order_nr%.
• Country of origin — herkomstland voor internationale zendingen. Standaard NL.
• Create Concept — labels eerst als concept zodat je nog kunt wijzigen.
• Return in the box — voegt automatisch een retourlabel bij.
• I use the following weight type — gram of kilogram (zelfde eenheid als in Magento).

Empty package weight

Elk pakkettype heeft een leeg-gewicht; MyParcel telt dit op bij het productgewicht.

Delivery methods

• Show details in summary — toont gekozen bezorgoptie in het besteloverzicht van de klant.
• Preferred pickup locations view — Lijst of Kaart als standaard.
• Switching the view is allowed — laat klanten zelf schakelen.
• Price shown in delivery options — laat de meerprijs per bezorgoptie zien.
• Exclude parcel lockers — verberg pakketautomaten.

6 · Settings · Vervoerders

Per vervoerder een eigen tab. Welke tabs zichtbaar zijn hangt af van wat in je MyParcel-contract staat.

PostNL settings

Bezorgtitels

De teksten die je klant in de checkout ziet. Standaard latin tenzij je eigen bewoordingen wilt.

• Delivery title — kop boven het PostNL-blok. Standaard: Thuis of op het werk bezorgd.
• Standard / Signature on receipt / Receipt code / Home address only / Priority / Morning / Evening / Mailbox / Digital stamp / Pickup title — tekst per bezorgoptie.

Drop-off days & Cut-off times

• Drop-off days — vink de dagen aan waarop je aanlevert bij PostNL.
• Cut-off time (per dag) — tot welk tijdstip een bestelling nog dezelfde dag meegaat. Standaard 15:30.

Default shipping options

Pas opties automatisch toe boven een drempelprijs.

• Automate 'Signature on receipt' + From price.
• Automate 'Collect package' + From price.
• Automate 'Home address only' + From price.
• Automate 'Larger than 100 × 70 × 58 cm' + From price.
• Automate 'Age check 18+'.

Verzekering

• Insure orders from (€) — drempel waarboven automatisch verzekerd.
• Insure orders up to (NL) / (BE) / (EU) / (ROW) — maxima per regio.
• Insure orders for percentage — verzeker een % van de orderwaarde.

Andere vervoerders — verschillen in het kort

7 · Productinstellingen

Op elk product verschijnt een sectie MyParcel Options op de edit-pagina. Deze overschrijft de globale defaults uit §6 per product — handig voor producten met bijzondere eisen.

• Dropoff-delay — extra werkdagen om dit product te pakken. Voor made-to-order of dropship.
• Age check 18+ — verplicht legitimatiecheck. Voor alcohol, tabak, messen. Kan niet samen met ochtend-/avondlevering.
• Fit in digital stamp — mag dit product als digitale postzegel?
• HS code — douanecode voor wereldwijde zendingen. Zoek op tarief.douane.nl.
• Fit in mailbox — hoeveel stuks passen in één brievenbuspakje? 0 = automatisch op gewicht, -1 = past niet in brievenbus.
• Disable delivery options — verbergt het MyParcel-bezorgoptieblok als dit product in het mandje ligt. Voor digitale producten of cadeaubonnen.
• Exclude parcel lockers — verbergt pakketautomaten als afhaalpunt voor dit product.
• 24 hour priority, biedt dit product aan met prioriteitslevering. Beschikbaar vanaf plugin-versie 5.9.0. Staat de algemene instelling voor prioriteitslevering uit, dan toont de checkout het vinkje alleen als minstens één product in het mandje dit aan heeft staan. De productinstelling kan prioriteit alleen aanzetten, nooit uitzetten: zet de klant het vinkje in de checkout uit, dan blijft die keuze staan.

8 · De checkout-ervaring

Zodra de klant een bezorgadres invult verschijnt het MyParcel-blok met bezorgopties. Welke opties er staan hangt af van: de actieve vervoerders, de producten in het winkelwagentje en de product-specifieke overrides uit §7.

Bezorgopties

• Standaardlevering — bezorging tijdens kantooruren.
• Ochtendlevering — PostNL bezorgt 's ochtends (meerprijs).
• Avondlevering — tussen 18:00 en 22:00 (meerprijs).
• Zaterdaglevering — alleen zichtbaar als per vervoerder ingeschakeld.
• Handtekening voor ontvangst — bezorger laat klant tekenen.
• Niet bij de buren bezorgen — alleen aan ontvanger.
• 18+ legitimatiecheck — verschijnt automatisch als een product dit vereist.
• Ophalen bij een PostNL-locatie — lijst of kaart; pakketautomaten afhankelijk van Exclude parcel lockers.
• Brievenbuspakje — als het mandje binnen de maatvoering past.
• Digitale postzegel — voor platte, lichte zendingen.
• Prio 24 uur — prioriteitsbezorging (alleen indien geactiveerd).

9 · Dagelijks gebruik

Workflow 1 — per order

1. Ga naar Sales → Orders en open een bestelling.
2. Klik Print MyParcel Label.
3. Pas eventueel pakkettype, verzekering of bezorgopties aan voor deze order.
4. Klik Create. Het label wordt in de MyParcel-backoffice aangemaakt.

Workflow 2 — bulk (10+ orders/dag)

1. Ga naar Sales → Orders.
2. Selecteer meerdere orders met de checkboxes.
3. Onder Actions → Create & print MyParcel track(s).

Track & Trace in bevestigingsmail

Onder Stores → Configuration → Sales → Sales Emails → MyParcel Track zet je de tracking-link in de verzendmail. Zie FAQ voor mail-template-conflicten.

10 · Iets werkt niet — diagnose

Werkt iets niet zoals verwacht? Loop deze tabel van boven naar onder door — drie op de vier issues zijn binnen 5 minuten opgelost.

11 · FAQ

Hoe wissel ik het pakkettype voor één specifieke bestelling?

Open de order, klik Print MyParcel Label en pas in het popup-venster het pakkettype aan voordat je het label aanmaakt.

Mag ik meerdere vervoerders tegelijk gebruiken?

Ja, als ze in je MyParcel-contract staan. Activeer elke vervoerder in zijn eigen tab. Klanten zien dan meerdere bezorgblokken in de checkout.

Ik wil geen pakketautomaten aanbieden — kan dat?

Ga naar General settings → Delivery methods → Exclude parcel lockers. Per product kun je dit ook regelen via Exclude parcel lockers op de product-edit-pagina.

Werkt de plugin met third-party checkouts?

Officieel ondersteund: standaard Magento-checkout én Hyvä-checkout (met de hyva-themes/magento2-hyva-checkout-myparcelnl module). Andere checkouts werken mogelijk niet volledig — test altijd vóór live.

Hoe rol ik terug naar een oudere versie?

Composer: composer require myparcelnl/magento:5.4.0 gevolgd door bin/magento setup:upgrade en cache:flush. Meld de bug op github.com/myparcelnl/magento/issues.

Mijn klanten krijgen geen bezorgopties als ze postcode eerst invullen

Bekend issue met sommige Postcode-checker plugins. Configureer de checker zo dat straat en huisnummer als aparte velden behouden blijven.

Hoe verander ik mijn afzenderadres op het label?

Het afzenderadres komt uit je MyParcel-backoffice (Shopinstellingen → Algemeen), niet uit Magento.

Kost de plugin geld?

Nee. Je betaalt alleen voor de zendingen via je MyParcel-tarief.

Bronnen & support

• github.com/myparcelnl/magento ↗ — broncode, releases, issues.
• developer.myparcel.nl — Magento 2 ↗ — officiële installatie- en configuratiehandleiding.
• backoffice.myparcel.nl ↗ — account, API key, facturatie.
• Contact MyParcel-support — 023 - 30 30 315 · info@myparcel.nl.