Skip to content

OpenCart 3

Koppel je OpenCart 3-shop aan MyParcel met de extensie MyParcel NL. Over het installeren van de module, de verzendmethode en het order total, het invullen van je API-key, de standaard exportinstellingen, de PostNL-bezorgopties in de checkout, orders exporteren en labels printen vanuit de orderlijst, retourlabels en een diagnose-tabel.

In het kort

De extensie MyParcel NL koppelt je OpenCart 3-shop aan MyParcel. Je exporteert orders en print PostNL-labels direct vanuit de orderlijst van OpenCart, je klanten kunnen in de checkout een bezorgmoment of een PostNL-afhaalpunt kiezen, en de Track & Trace-code kan in de orderbevestiging mee. De extensie bestaat uit drie delen: een Module met alle instellingen, een Verzendmethode voor de checkout en een Order Total dat de meerprijs van bezorgopties bij de order optelt.

Alleen onderhoud

Deze handleiding beschrijft versie 1 van de extensie, gebouwd voor OpenCart 3.0.x en getest op OpenCart 3.0.2.0 met PHP tot en met 8.2. De extensie ondersteunt alleen PostNL.

MyParcel voegt geen nieuwe functies meer toe aan deze extensie. MyParcel past hem alleen aan als een wijziging in de MyParcel-API ervoor zorgt dat hij niet meer werkt. Zet je een nieuwe shop op, gebruik dan de OpenCart 4-extensie.

Snelstart, je eerste label in 20 minuten

Genoeg om vandaag je eerste order te verzenden. Voor de details, zie 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. Extensie installeren. Download de .ocmod.zip bij de laatste release, upload hem onder Extensions → Installer en klik op Refresh onder Extensions → Modifications.
  4. De drie delen aanzetten. Installeer onder Extensions → Extensions de onderdelen Myparcel NL (type Modules), MyParcel Shipping (type Shipping) en MyParcel Total (type Order Total).
  5. Key plakken. Open System → MyParcel, plak de key in API op het tabblad General en sla op.
  6. Label printen. Klik in Sales → Orders naast een order op Export to MyParcel en daarna op Print MyParcel label.

Klaar als je dit ziet

  • De label-PDF downloadt of opent in een nieuw tabblad
  • De order toont een Track & Trace-code en een status zoals pending - registered
  • De zending staat in je MyParcel-backoffice

Wat zoek je?

Wat wil je doen?Ga naar
De drie delen begrijpen1 · Hoe de extensie werkt
De extensie installeren2 · Installeren
De API-key en algemene instellingen invullen3 · Instellingen · General
Pakkettypes en standaardopties kiezen4 · Instellingen · Default export settings
Bezorgmomenten en afhaalpunten aanbieden5 · Instellingen · Checkout
HS-codes voor de douane instellen6 · Productinstellingen
Zien wat je klanten zien7 · De checkout voor je klant
Orders exporteren en labels printen8 · Dagelijks gebruik
Er werkt iets niet9 · Er werkt iets niet, diagnose
Antwoord op een veelgestelde vraag10 · FAQ

1 · Hoe de extensie werkt

De extensie bestaat uit drie delen. Voor alle functies heb je ze alle drie nodig.

OnderdeelWaarWat het doet
Myparcel NLExtensions → Extensions → ModulesAlle instellingen, en de MyParcel-acties in je orderlijst. Ook te vinden onder System → MyParcel.
MyParcel ShippingExtensions → Extensions → ShippingDe verzendmethode die je klant in de checkout kiest. De MyParcel-bezorgopties staan daarbinnen.
MyParcel TotalExtensions → Extensions → Order TotalTelt de meerprijs van een gekozen bezorgoptie, zoals avondlevering, op bij het ordertotaal.

Vanuit de orderlijst stuur je een order naar MyParcel (exporteren) en de extensie downloadt het PostNL-label. De Track & Trace-code wordt bij de order bewaard en kan in de e-mail aan je klant mee.

2 · Installeren

  1. Maak een back-up van je shop, of probeer de extensie eerst op een kopie.
  2. Download het .ocmod.zip-bestand bij de nieuwste MyParcel OpenCart 3-release.
  3. Ga naar Extensions → Installer, klik op Upload en kies het zipbestand.
  4. Ga naar Extensions → Modifications en klik op Refresh (de blauwe knop rechtsboven). Zonder deze stap werkt de extensie niet.
  5. Ga naar Extensions → Extensions en installeer de drie delen met de groene +-knop:
    • kies Modules en installeer Myparcel NL;
    • kies Shipping en installeer MyParcel Shipping;
    • kies Order Total en installeer MyParcel Total.

De lijst met verzendextensies met MyParcel Shipping, de bewerkknop en de groene installatieknop.

Klik daarna op het potloodje naast MyParcel Shipping en controleer de instellingen:

De instellingen van MyParcel Shipping: titel, kosten, belastingklasse, status en sorteervolgorde.

InstellingWat het doet
TitleDe naam van de verzendmethode in de checkout.
CostDe basisverzendkosten. De meerprijs van bezorgopties komt daar bovenop.
Tax ClassDe belastingklasse voor de verzendkosten.
StatusZet op Enabled om de methode in de checkout te tonen.
Sort OrderDe plek tussen je andere verzendmethoden.

Controleer tot slot of MyParcel Total aan staat onder Order Total. De sorteervolgorde bepaalt waar de meerprijs in de totalen verschijnt.

De lijst met Order Total-extensies met MyParcel Total.

Shipping is niet de instellingenpagina

Het potloodje naast MyParcel Shipping toont alleen de velden hierboven. Alle andere instellingen zitten in de module: System → MyParcel, of het potloodje naast Myparcel NL onder Modules.

3 · Instellingen · General

Open System → MyParcel. De instellingenpagina heeft drie tabbladen: General, Default Export Settings en Checkout. Klik na elke wijziging op de blauwe opslaanknop rechtsboven.

Het tabblad General met de API-key, de admin-map, de labelweergave en het papierformaat.

InstellingWat het doetAanbevolen
APIJe MyParcel API-key, uit backoffice.myparcel.nl onder Shopinstellingen → Integratie.Plakken zonder spaties.
Admin folderDe naam van je OpenCart-adminmap. Alleen wijzigen als je die map hebt hernoemd.admin
Label displayDownload PDF slaat het label op, Open de PDF in a new tab opent het in je browser.Naar voorkeur.
Paper formatA4 voor een gewone printer, A6 voor een labelprinter. Bij A4 kies je bij het printen de plek op het vel.A6 bij een labelprinter.

De rest van het tabblad General: Track & Trace, verwerking, orderstatus, adresvelden en het logbestand.

InstellingWat het doetWanneer aanzetten
Track&trace in emailZet de Track & Trace-code in de ordermail aan je klant.Als je wilt dat OpenCart de code verstuurt. Zet dan de Track & Trace-mail in je MyParcel-backoffice uit, anders krijgt je klant twee mails.
Track&trace in My AccountToont de code en een link bij de order in het account van je klant.Aanbevolen.
Process shipments directlyMeldt de zending direct aan bij PostNL zodra je hem exporteert, zodat het label en de Track & Trace-code meteen klaar zijn. Uit, dan blijft de zending als concept in je MyParcel-backoffice staan.Als je labels direct vanuit OpenCart print.
Order status automationZet de order na een geslaagde export op een status naar keuze.Gebruik je dit samen met Track&trace in email, zet dan ook Process shipments directly aan, anders gaat de mail zonder code de deur uit.
Keep old shipmentsBewaart de Track & Trace-links van eerdere zendingen bij de order als je hem opnieuw exporteert.Als je een order soms in meerdere delen verstuurt.
Use addition address as number suffixHoe straat, huisnummer en toevoeging uit de adresvelden worden gelezen: beide velden als volledig adres, veld 1 als straat en veld 2 als huisnummer, of een derde veld voor de toevoeging.Stem het af op hoe je checkout om het adres vraagt.
Log API communicationSchrijft het verkeer met MyParcel naar een logbestand, dat je downloadt met Download log file.Alleen tijdens het oplossen van een probleem.

4 · Instellingen · Default export settings

Deze instellingen zijn de standaard voor elke zending die je exporteert. Per order pas je ze aan voordat je exporteert, zie §8.

De pakkettypes met de gekoppelde verzendmethoden, de HS-code, het land van herkomst en de instellingen voor e-mail en telefoon van de klant.

Pakkettypes

Onder Package Types koppel je je OpenCart-verzendmethoden aan een MyParcel-pakkettype. Orders met MyParcel Shipping zijn altijd een Parcel (pakket). Voor elk ander type kies je een of meer verzendmethoden, bijvoorbeeld Flat Rate:

PakkettypeWanneer gebruiken
Mailbox package (Brievenbuspakje)Kleine, platte artikelen die door de brievenbus passen.
Unpaid letter (Ongefrankeerd label)Een label zonder porto.
Digital Stamp (Digitale postzegel)Brieven met een digitale postzegel. Kies de gewichtsklasse onder Default Weight.

Douane en contactgegevens

  • Default HS code en The country of origin. Gebruikt voor zendingen buiten de EU als een product zelf geen waarden heeft, zie §6.
  • Connect customer email. Stuurt het e-mailadres van je klant mee met de zending, zodat MyParcel de Track & Trace-mail kan sturen. Die mail zet je aan of uit in je MyParcel-backoffice.
  • Connect customer phone. Stuurt het telefoonnummer mee, zodat de vervoerder je klant kan bereiken. Dat helpt veel bij zendingen naar het buitenland.

Zendingopties

De standaard zendingopties: extra groot formaat, alleen huisadres, handtekening, leeftijdscheck, retour bij geen gehoor, verzekering en de labelomschrijving.

Elke optie wordt aan elk pakket toegevoegd dat je exporteert. Opties kunnen extra kosten, kijk in je MyParcel-tarieven. De prijzen die de extensie naast de labels toont, komen uit een oudere tariefkaart.

InstellingWat het doet
Extra large size (Extra groot formaat)Voor pakketten die groter zijn dan het standaardformaat.
Home address only (Alleen huisadres)Het pakket wordt alleen op het adres van de ontvanger bezorgd, nooit bij de buren.
Signature on delivery (Handtekening voor ontvangst)De ontvanger tekent voor het pakket.
Age check (Leeftijdscheck)De bezorger controleert of de ontvanger 18 jaar of ouder is.
Return if no answer (Retour bij geen gehoor)Is er niemand thuis, dan komt het pakket naar jou terug in plaats van naar een afhaalpunt.
Insured shipment (Verzekerd verzenden)Verzekert de aankoopwaarde. Een verzekerd pakket heeft altijd ook alleen huisadres en handtekening voor ontvangst.
Label description (Labelomschrijving)Tekst linksboven op het label. Gebruik [ORDER_NR] om het ordernummer te printen, zodat je erop kunt zoeken in je MyParcel-backoffice.

5 · Instellingen · Checkout

Het tabblad Checkout bepaalt welke PostNL-bezorgopties je klanten kunnen kiezen. Vink Enable MyParcel delivery options aan om alle instellingen te zien.

Het tabblad Checkout met de bezorgopties aan: twee prijskolommen op subtotaal en de opties met een prijs per kolom.

Bezorgopties en meerprijzen

Vink elke optie aan die je wilt aanbieden. Een aangevinkte optie krijgt twee prijsvelden, één per Subtotal-kolom. De twee Subtotal-rijen bepalen het orderbedrag waarvoor elke kolom geldt. Zo kun je bijvoorbeeld avondlevering bij kleine orders laten betalen en vanaf € 50 gratis aanbieden.

OptieWat je klant krijgt
Standard delivery (Standaard bezorging)Bezorging overdag.
Morning delivery (Ochtendlevering)Bezorging in de ochtend.
Evening delivery (Avondlevering)Bezorging in de avond.
Signature on delivery (Handtekening voor ontvangst)Je klant kan om een handtekening bij bezorging vragen.
Home address only (Alleen huisadres)Je klant kan kiezen voor bezorging alleen op het huisadres.
PostNL pickup (Afhalen bij PostNL)Afhalen bij een PostNL-punt in de buurt.
Early PostNL pickup (Vroeg afhalen bij PostNL)Afhalen bij een PostNL-punt vanaf de vroege ochtend.
Belgium pickup (Afhalen in België)Bezorgopties voor klanten in België, met een tarief voor standaardbezorging en een voor afhalen.

Met Mailbox options kan je klant in de checkout een brievenbuspakje kiezen. Je stelt een titel, een prijs en het maximale gewicht in.

Verwerkingsinstellingen

Inleverdagen, uiterste besteltijd, verwerkingstijd, bezorgdagenvenster en de weergave-instellingen.

InstellingWat het doet
Dropoff days (Inleverdagen)De dagen waarop je pakketten aan PostNL geeft. Leeg betekent maandag tot en met vrijdag.
Cut-off time (Uiterste besteltijd)Het tijdstip waarop je stopt met orders verwerken voor die dag, als uu:mm. Leeg betekent 15:30. Vink Weekdays aan om per dag een andere tijd in te stellen.
Dropoff delay (Verwerkingstijd)Het aantal dagen, 0 tot en met 14, dat je nodig hebt voordat een order naar PostNL gaat.
Delivery days window (Bezorgdagenvenster)Het aantal dagen dat je klant de bezorging kan uitstellen. Verplicht zodra bezorgopties aan staan, anders lukt opslaan niet.

De instellingen onder Only apply for Xtension Best Checkout (afstandsformaat, afronding, de tekst bij een prijs van 0 en het tijdformaat) worden alleen gebruikt met de extensie Xtensions Best Checkout.

Opmaak

Basiskleur, accentkleur, eigen stijl en Google Fonts.

Base color en Highlight color bepalen de kleuren van de bezorgopties, in Custom style zet je je eigen CSS, en Automatically load Google fonts laadt de lettertypes die de bezorgopties gebruiken.

6 · Productinstellingen

De extensie voegt aan elk product een tabblad My parcel toe, met twee velden voor zendingen buiten de EU.

Het tabblad My parcel bij een product, met HS Code en Country Code.

  • HS Code. De douanecode van het product.
  • Country Code. Het land van herkomst, bijvoorbeeld NL.

Lege velden vallen terug op de standaardwaarden uit §4.

7 · De checkout voor je klant

Staan de bezorgopties aan, dan ziet je klant de PostNL-opties onder Delivery Method in de checkout, binnen MyParcel Shipping. De opties worden in het Nederlands getoond.

De checkout met de bezorgdag, de tijdvakken voor thuisbezorging en de optie handtekening voor ontvangst.

Onder Thuis of op het werk bezorgd kiest je klant een bezorgdag en een tijdvak, en de extra opties die je hebt aangezet, zoals handtekening voor ontvangst.

De checkout met een gekozen PostNL-afhaalpunt, de openingstijd en het adres.

Onder Ophalen bij een PostNL locatie kiest je klant een afhaalpunt. Het potloodje opent de lijst met punten in de buurt.

De keuze wordt bij de order bewaard en overgenomen als je hem exporteert.

8 · Dagelijks gebruik

De extensie voegt MyParcel-acties toe aan Sales → Orders.

De orderlijst met de bulkknoppen bovenaan en de kolom MyParcel met de iconen voor exporteren, label en retour.

Eén order

  1. Klik in de kolom Ship To op het pakkettype, bijvoorbeeld Parcel, om de zending te controleren of aan te passen.
  2. Klik in de kolom MyParcel op Export to MyParcel.
  3. Klik op Print MyParcel label om het label te downloaden of te openen.

Het zendingvenster met zendingtype, aantal labels, de zendingopties en een eigen kenmerk.

In het zendingvenster wijzig je voor deze order het Shipment type, het Number of labels (meerdere pakketten voor één order), de zendingopties en een Custom ID dat linksboven op het label komt. Klik op Save.

Meerdere orders tegelijk

Vink de orders aan en gebruik de knoppen bovenaan de orderlijst:

  • Export Batch stuurt de geselecteerde orders naar MyParcel.
  • Print Batch print de labels van orders die al geëxporteerd zijn.
  • Export Print Batch doet beide in één keer.

Retourlabels

Het icoon Email return label stuurt je klant een mail met een link om een retourlabel te printen.

Op de order zelf

De orderpagina toont dezelfde MyParcel-acties, de Track & Trace-code met de status van de zending, en het verzendadres met het gekozen pakkettype.

De ordergegevens met de MyParcel-acties, de Track & Trace-code en status, en het verzendadres.

Je betaalt pas voor een zending als die echt aan PostNL is overgedragen.

9 · Er werkt iets niet, diagnose

Loop deze tabel van boven naar beneden door, de meeste problemen zijn binnen een paar minuten opgelost.

SymptoomWat je controleert
De module verschijnt niet onder ModulesHeb je op Refresh geklikt onder Extensions → Modifications (§2)? Controleer je PHP-versie: de extensie is getest tot en met PHP 8.2.
Ik zie alleen Title en CostJe hebt de verzendmethode geopend. De instellingen staan onder System → MyParcel (§2).
Opslaan mislukt met "Delivery day windows cannot be empty"Vul Delivery days window in op het tabblad Checkout (§5).
Geen bezorgopties in de checkoutIs Enable MyParcel delivery options aangevinkt en staat er minstens één optie aan (§5)? Zijn MyParcel Shipping en MyParcel Total geïnstalleerd en ingeschakeld (§2)? Heeft je klant een Nederlands of Belgisch adres ingevuld?
De meerprijs ontbreekt in het totaalIs MyParcel Total geïnstalleerd en ingeschakeld onder Order Total?
Exporteren mislukt of geeft een foutKlopt de API-key, zonder spaties (§3)? Zet Log API communication aan, probeer het opnieuw en download het logbestand voor MyParcel support.
Het huisnummer komt in het verkeerde veldStem Use addition address as number suffix af op je checkout (§3).
Mijn klant krijgt twee Track & Trace-mailsZet Track&trace in email in OpenCart uit, of de Track & Trace-mail in je MyParcel-backoffice.
Export Print Batch toont de labels nietGebruik eerst Export Batch en daarna Print Batch.

10 · FAQ

Moet ik deze extensie nog gebruiken?

Hij werkt voor shops die op OpenCart 3 blijven. MyParcel voegt geen nieuwe functies toe en past hem alleen aan als een wijziging in de MyParcel-API ervoor zorgt dat hij niet meer werkt. Nieuwe ontwikkeling gaat naar de OpenCart 4-extensie, die ook meer vervoerders ondersteunt.

Welke vervoerders kan ik gebruiken?

Alleen PostNL.

Waar vind ik mijn API-key?

In backoffice.myparcel.nl onder Shopinstellingen → Integratie.

Kan ik meerdere pakketten voor één order versturen?

Ja. Stel het Number of labels in het zendingvenster in voordat je exporteert (§8).

Werkt de extensie met mijn one-page checkout of Journal-thema?

De extensie ondersteunt de standaard checkout van OpenCart en een aantal andere, zoals Journal en Xtensions Best Checkout. Test de checkout op een kopie van je shop voordat je live gaat.

Wanneer betaal ik?

MyParcel factureert een zending pas als die echt aan PostNL is overgedragen.

Bronnen & support