PrestaShop

Snelstart — in 15 minuten je eerste pakket

Genoeg om vandaag je eerste echte order te versturen. Dieper configureren doe je later 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. Download de release-ZIP via github.com/myparcelnl/prestashop/releases. In PrestaShop: Modules → Module manager → Upload een module → ZIP slepen.
4. Plugin koppelen. Zoek na installatie op myparcel, klik Configureer, plak je API-key onder API key wijzigen en klik Opslaan. De status-badge bovenaan moet Gekoppeld met MyParcel tonen.
5. Eerste label. Open een betaalde order, ga naar het MyParcel-blok onderaan, klik Exporteren en daarna Print label. Je PDF rolt eruit.

Wat zoek je?

1 · Voorbereiden in je MyParcel-account

Voordat je in PrestaShop 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 Ordermodus wilt gebruiken.

2 · Plugin installeren

1. Download de release-ZIP via github.com/myparcelnl/prestashop/releases.
2. Modules → Module manager → Upload een module → sleep de ZIP.
3. Wacht tot installatie klaar is, zoek op myparcel en klik Configureer.

Sales channel via de MyParcel Backoffice

Naast het koppelen van de plugin met je API key (zie Plugin koppelen) kun je PrestaShop ook registreren als Sales channel in je MyParcel-backoffice. De plugin verzorgt de PrestaShop-checkout en -instellingen; de sales channel laat MyParcel rechtstreeks via de webservice-API met je shop praten en je bestellingen ophalen.

De sales channel aanmaken

1. Log in op backoffice.myparcel.com en ga naar Shop settings → Sales Channels (Shopinstellingen → Verkoopkanalen).
2. Klik rechtsboven op Add sales channel (Verkoopkanaal toevoegen).

3. Vul een Name (Naam) in waaraan je het kanaal herkent (bijv. Mijn PrestaShop-shop).
4. Kies bij Type of sales channel (Type verkoopkanaal) voor PrestaShop.
5. Vul je Webshop URL in — het adres van je PrestaShop-shop (bijvoorbeeld https://jouw-shop.nl).
6. Klik op Save (Opslaan). Het kanaal wordt aangemaakt en krijgt een label Missing data (Gegevens ontbreken) tot je de API key toevoegt.

Het kanaal authenticeren (API key)

PrestaShop laat MyParcel je bestellingen lezen met een webservice-API key.

1. Ga in je PrestaShop back office naar Advanced Parameters → Webservice (Geavanceerde parameters → Webservice), zet de webservice aan en klik op Add new webservice key. Genereer een sleutel, geef die de resources die MyParcel nodig heeft en sla op. Kopieer de gegenereerde sleutel.
2. Open in de backoffice het kanaal en klik op Set credentials (Gegevens instellen).
3. Plak in de dialoog Set API key (API key instellen) je PrestaShop API key.
4. Klik op Connect (Verbinden).

Zodra de verbinding er is, verdwijnt het label Missing data, toont het kanaal Connected (Verbonden) en begint MyParcel je PrestaShop-bestellingen te synchroniseren.

Wat gebeurt er als je een zending exporteert

Je exporteert en print een zending vanuit de bestellingenlijst of vanaf de order-detailpagina (§11). Wat je in je MyParcel-backoffice krijgt, hangt af van wat er eerst was: de zending of de order.

3 · Plugin koppelen (API-key)

Open Modules → Module manager → MyParcelNL → Configureer. Bovenaan zie je drie knoppen — API key wijzigen, Webhooks wijzigen, Debugopties — plus de status-badge.

De koppelingsbalk verschijnt op élke plugin-pagina.

1. Klik API key wijzigen.
2. Plak de key uit je MyParcel-backoffice.
3. Klik Opslaan — binnen enkele seconden wisselt de status naar Gekoppeld met MyParcel.

4 · Welk shop-profiel ben jij?

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

Klein — 1–10 orders/dag, alleen NL

Medium — 10–50 orders/dag, NL + BE

Brievenbus-only — koffie, kaarten, cosmetica

5 · Settings · Bestellingen

De eerste tab — hier bepaal je hoe orders door je shop stromen.

Algemeen

• Ordermodus — Aan: volledige order (klantdata, productregels, notities) naar MyParcel. Uit: alleen een label. Aanbevolen aan, mits Orderinformatie importeren in je MyParcel-account ook aan staat.
• Concept zendingen — Aan: zending blijft concept in MyParcel, je kunt nog wijzigen. Uit: direct aanmelden bij vervoerder. Aan tijdens setup, uit als alles stabiel draait.
• Automatisch verwerken — Welke PrestaShop-orderstatus triggert export? Geen / Wachtend op betaling / In behandeling / Verzonden. Begin met Geen.
• Stuur retour e-mail — Klant krijgt automatisch een retour-link.
• Klantadres opslaan in adresboek — Adressen belanden in je MyParcel-adresboek.
• Deel klantinformatie — E-mail + telefoonnummer naar MyParcel. Nodig voor track & trace-mail vanaf MyParcel én voor internationale zendingen. Aanbevolen aan.

Automatisering orderstatus

Koppel MyParcel-events aan PrestaShop-statussen — pakketstatus blijft synchroon zonder handwerk.

• Bestelstatus bij label aanmaken — vaak Verzending in voorbereiding.
• Bestelstatus bij label scannen — vaak Verzonden.
• Bestelstatus bij bezorging — vaak Afgeleverd.
• Stuur notificatie na — vanaf welke status een klantmail uitgaat. Zet op Verzonden zodat klanten direct hun track & trace ontvangen.

Track & Trace

• Track & Trace in e-mail — link in PrestaShop-bestelmails. Aanbevolen aan.
• Track & Trace in account — ook zichtbaar in het klantaccount op de webshop.

Standaard gewichten

Vangnet voor producten zonder gewicht in de catalogus.

Bestelnotities

• Barcode in notitie — track & trace-barcode automatisch in de ordernotitie. Handig voor pickers in het magazijn.
• Barcode in notitie titel — kop boven de barcode, bv. Track & Trace.

6 · Settings · Labels

Hoe verzendlabels eruitzien én hoe ze afgedrukt worden.

Omschrijving op het label

• Omschrijving — vrije tekst, bv. ordernummer of interne referentie.

Printgedrag

• Meteen afdrukken — label direct naar je printer-groep zodra je een zending exporteert. Aanbevolen aan met labelprinter.
• Label positie opvragen — prompt voor formaat, uitvoer en positie per label. Aan voor flexibiliteit; uit voor snelheid bij vast formaat.

Standaardwaarden

• Label uitvoer — Open in nieuw tabblad (snelst voor handmatig) of Download label.
• Label formaat — A4 (4 per pagina) of A6 (labelprinter).
• Label positie(s) op A4 — meervoudige selectie Linksboven/Rechtsboven/Linksonder/Rechtsonder om vellen volledig te benutten.

7 · Settings · Douane

Verplicht bij zendingen buiten de EU. Per product te overrulen — zie 10 · Productinstellingen.

• Inhoud pakket — Goederen (standaard voor webshops), Documenten, Cadeau, Commercieel monster, Retourzending.
• HS-code — geharmoniseerde douanecode. Zoek op tarief.douane.nl. Voorbeelden: 6109.10 (T-shirts), 9503.00 (speelgoed), 3304.99 (make-up).
• Herkomstland — waar het product vandaan komt (niet waar je het opslaat).

8 · Settings · Checkout

Wat je klant in de checkout ziet — of liever niet ziet.

Bezorgopties

• Bezorgopties tonen — hoofdschakelaar voor de MyParcel-checkout-widget. Aanbevolen aan.
• Bezorgopties tonen voor backorders — uit: bij niet-voorradige producten verbergt de plugin de bezorgopties. Aan als levertijden zeker zijn.
• Prijs type — Inbegrepen (in totaalprijs) of Apart (los getoond). Inbegrepen voorkomt verrassingen.
• Bezorgopties titel — kop boven het MyParcel-blok. Bv. Hoe wil je je pakket ontvangen?
• Toon belastingvelden bij het afrekenen — BTW-velden voor zakelijke bestellingen.

• Gesloten dagen — datumkiezer voor feestdagen. Op deze dagen verbergt de checkout bezorgopties.

Afhaalpunten

• Standaard weergave — Lijst (overzichtelijk) of Kaart (visueler).
• Gebruikers kunnen wisselen tussen lijst en kaart — Aanbevolen aan.
• Pakautomaten uitsluiten — verberg pakautomaten als bezorgoptie. Aan als producten te groot zijn.

9 · Settings · Vervoerders

De grootste tab. Sub-tabs voor élke vervoerder die je MyParcel-account ondersteunt: PostNL, DHL Parcel Connect, DHL Europlus, UPS Standard, UPS Express Saver, plus eventueel DHL For You / DPD / Bol Parcel Carrier afhankelijk van je contract.

Standaard export instellingen

Welke opties standaard meegegeven worden aan elke nieuwe zending.

• Activeer leeftijdscontrole (18+) — voor alcohol/tabak/messen.
• Activeer handtekening — voor waardevolle zendingen.
• Activeer alleen ontvanger — geen buren.
• Activeer ontvangstcode — extra zekerheid.
• Activeer groter dan 100 × 70 × 58 cm — markeer oversized; vervoerderstoeslag mogelijk.
• Activeer direct retour — automatisch retourlabel bij kleding/elektronica.
• Activeer verzekering — schakelt verzekering aan.

Verzekering

• Verzekeren vanaf (€) — drempelbedrag.
• Verzekeren tot / (NL) / (EU) / (EU + Rest Wereld) — maxima per regio.
• Verzekeren voor percentage — bv. 100% van orderwaarde.

Standaard exportinstellingen voor retouren

• Standaard pakkettype — Pakket / Klein pakket / Brievenbuspakje / Digitale postzegel.
• Activeer groter dan 100 × 70 × 58 cm — voor oversized retouren.

Bezorgopties (hoofdschakelaar)

• Bezorgopties inschakelen — zonder deze toggle verschijnt deze vervoerder helemaal niet in de checkout.

10 · Productinstellingen

Open een product, ga naar Modules en klik Configureer bij MyParcelNL. Hier overrule je de globale Vervoerders- en Douane-instellingen per product.

MyParcel opties

• Pakkettype — Standaard of forceer een type voor dit product.
• in mailbox — hoeveel van dit product passen in één brievenbuspakje. 5 = vijf passen erin. -1 = standaard gebruiken. Bestelt klant méér dan past, dan gaat de order automatisch als Pakket.

Product bezorgopties

• Verzending vertragen — extra werkdagen voor producten op bestelling / dropship / made-to-order.
• Verzendopties uitschakelen — verbergt de hele MyParcel-bezorgwidget als dit product in het mandje zit. Voor cadeaubonnen of digitale producten.
• Pakautomaten uitsluiten — sluit pakautomaten uit voor dit product.

Product douane opties

• Land van herkomst — overrult §7. Bv. globaal Nederland, dropship-product China.
• Douane code — product-specifieke HS-code.

Product export opties

• Activeer leeftijdscontrole (18+), Activeer verzekering, Activeer groter dan 100 × 70 × 58 cm, Activeer alleen ontvanger, Activeer handtekening, Activeer direct retour — forceer per product.

11 · De order-detailpagina

Open een individuele order. Onder de standaard PrestaShop-gegevens zie je een MyParcel-blok met:

• Vervoerder en pakkettype voor deze zending
• Verzekering aan/uit + verzekerd bedrag
• Geselecteerde bezorgopties (avondbezorging, handtekening, alleen ontvanger…)
• Vanaf 5.7.3 ook sameday, vroege ochtend, vers en diepvries, voor zover de vervoerder ze aanbiedt. Daarvoor vielen deze vier weg bij de order-import en bleven ze hier leeg.
• Knoppen: Exporteren · Print label · Track & Trace bekijken

12 · De checkout-ervaring

De MyParcel-checkout-widget verschijnt na het invullen van het bezorgadres, zodra ten minste één vervoerder is ingeschakeld én PrestaShop-vervoerders aan de juiste verzendzone gekoppeld zijn — zie diagnose.

Boven de widget kiest de klant een vervoerder + dienst (bv. PostNL — Super snelle levering — €9,95 incl. btw). Daaronder klapt Levering thuis of op het werk open met:

• Datum-carrousel met de eerstvolgende werkbare dagen.
• Tijdvak voor aanbieding (bv. 10:45–13:15).
• Extra opties zoals Handtekening (€2,00) of Alleen ontvanger met aparte toeslagen.

Onder thuisbezorging staat een tweede blok Ophalen bij een afhaallocatie, gemarkeerd Meest duurzaam. Bij openen verschijnt een interactieve kaart met PostNL/DHL-punten in de buurt, met openingstijden per dag. De klant kan switchen tussen Lijst en Kaart (mits ingeschakeld in §8).

Zakelijke en particuliere klanten zien hier niet per se dezelfde bezorgopties. Vult de klant een bedrijfsnaam in, dan telt de order als zakelijk, zie §8.

13 · Dagelijks gebruik

Workflow 1 — per order

1. Open de order-detailpagina.
2. Controleer pakkettype en bezorgopties in het MyParcel-blok.
3. Klik Exporteren (concept) → controleer in MyParcel → klik Print label.

Workflow 2 — bulk (10+ orders/dag)

1. Op Bestellingen filter je een tijdvak (bv. Vandaag betaald).
2. Per order via het actiemenu Exporteren kiezen.
3. In MyParcel zendingen verwerken (handmatig óf met Automatisch verwerken uit §5).
4. Labels in bulk printen via MyParcel.

Retouren

• Activeer direct retour (§9) of de product-override → automatisch retourlabel bij elke zending.
• Stuur retour e-mail (§5) → klant kan zelfstandig een retourlabel opvragen.

14 · 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.

15 · FAQ

Werkt de plugin op PrestaShop 9?

Ja, vanaf plugin-versie 5.2.0. Die release voegde ondersteuning toe voor PrestaShop 9 en PHP 8.5, en dekt de Hummingbird-checkout die met PrestaShop 9 meekomt. Zie PR #483.

Kan ik meerdere vervoerders tegelijk gebruiken?

Ja. Activeer per vervoerder onder Vervoerders → [Vervoerdernaam] → Bezorgopties → Bezorgopties inschakelen.

Hoe verander ik mijn afzenderadres op het label?

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

Welke statussen voor "Automatisch verwerken"?

In behandeling of Wachtend op betaling werkt voor de meeste shops. Begin op Geen tijdens setup; activeer als de workflow stabiel draait.

Klant kiest een afhaalpunt — hoe zie ik dat op het label?

Het afhaalpunt verschijnt automatisch als bezorgadres op het MyParcel-label én in het MyParcel-blok op de order-detailpagina (§11). In sommige PrestaShop-thema's komt het afhaalpunt niet terug op de PDF-factuur — thema-issue, geen plugin-bug (issue #390).

Plugin-update gedaan en nu werkt iets niet meer

Open de plugin opnieuw, controleer de status-badge en doorloop §14. Update-issues lossen vaak op door uit/in loggen of browser-cache legen.

Kost de plugin geld?

Nee. De plugin is gratis. Je betaalt alleen voor de zendingen via je MyParcel-tarief.

Bronnen & support

• github.com/myparcelnl/prestashop ↗ — broncode, releases, issues.
• github.com/myparcelnl/prestashop/releases ↗ — changelog & ZIP-downloads.
• backoffice.myparcel.nl ↗ — account, API key, facturatie.
• Contact MyParcel-support — 023 - 30 30 315 · info@myparcel.nl.

Deze handleiding is geschreven voor plugin-versie 5.7.x. Bij nieuwere versies kunnen veld-namen of -volgorde licht afwijken; de hoofdindeling van de plugin blijft hetzelfde.