OpenCart 4

Snelstart, je eerste pakket in 15 minuten

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

1. Haal je API-key op. Log in op backoffice.myparcel.com, ga naar Instellingen → API-toegang en kopieer je API-key.
2. Installeer de extensie. Ga in OpenCart naar Extensies → Installer en upload het .ocmod.zip-pakket. Open daarna Extensies → Extensies, installeer de MyParcel Module en de MyParcel Verzendmethode, en ververs de modifications-cache wanneer daarom wordt gevraagd.
3. Voer de API-key in. Open de instellingen van de MyParcel-module, plak je API-key op het tabblad Algemeen en klik op Opslaan.
4. Importeer je vervoerders. Klik op het tabblad Vervoerders op Vervoerderconfiguratie importeren. Je vervoerders verschijnen met hun beschikbare services.
5. Verzend een order. Open Verkoop → Bestellingen, klik op de groene exportknop bij een order en daarna op de labelknop om de PDF te downloaden.

Wat zoek je?

1 · Je MyParcel-account voorbereiden

Voordat je in OpenCart begint, regel je twee dingen in je MyParcel-backoffice:

1. Kopieer je API-key. Log in op backoffice.myparcel.com, ga naar Instellingen → API-toegang en kopieer de key. Houd hem privé, hij geeft toegang tot je account.
2. Activeer je vervoerders. Zorg er onder Instellingen → Vervoerders voor dat de vervoerders waarmee je wilt verzenden actief zijn op je account. Alleen actieve vervoerders kunnen later in de extensie worden geïmporteerd.

2 · De extensie installeren

De MyParcel-extensie wordt geleverd als OpenCart-modificatiepakket (.ocmod.zip).

1. Download de nieuwste myparcel.ocmod.zip via github.com/myparcelnl/opencart4/releases.
2. Ga in je OpenCart-admin naar Extensies → Installer en upload het pakket.
3. Ga naar Extensies → Extensies en kies Modules in de dropdown Kies het extensietype. Zoek MyParcel en klik op de groene installatieknop.
4. Kies op dezelfde pagina Verzendmethoden in de dropdown. Zoek MyParcel, klik op installeren en open daarna de instellingen om het tarief, de geozone en de status in te stellen (zie 4 · De twee onderdelen uitgelegd).
5. Ververs de modifications-cache wanneer OpenCart daarom vraagt (Extensies → Modificaties → Verversen).

3 · De extensie koppelen (API-key)

Open de MyParcel Module (Extensies → Extensies → Modules → MyParcel, bewerkknop) en ga naar het tabblad Algemeen.

1. Zet Status op ingeschakeld.
2. Plak je API-key.
3. Laat Omgeving op Productie staan voor live verzenden. Gebruik Acceptatie (test) alleen wanneer je test tegen de MyParcel-testomgeving.
4. Klik op Opslaan en klik daarna op API-key testen om de verbinding te bevestigen.

4 · De twee onderdelen uitgelegd

Anders dan bij een enkele alles-in-één plugin leeft MyParcel voor OpenCart op twee plekken onder Extensies. Je gebruikt ze allebei.

• Verzendmethode (Extensies → Extensies → Verzendmethoden → MyParcel) is wat je klant in de checkout kiest en betaalt. Hier stel je de Weergavenaam in die klanten zien, het Tarief, de Belastingklasse, de Geozone waarop hij van toepassing is, de Status en de Sorteervolgorde.
• Module (Extensies → Extensies → Modules → MyParcel) is het controlecentrum: API-key, vervoerders, checkout-gedrag, douane en labelinstellingen. Hier ben je het meeste tijd kwijt.

Je springt tussen beide met de knoppen Verzendinstellingen en Module-instellingen rechtsboven op elk scherm.

5 · Instellingen · Algemeen

Op het tabblad Module → Algemeen:

6 · Instellingen · Standaard zendingsgegevens

Deze waarden worden gebruikt wanneer een order geen eigen gegevens meedraagt. Op het tabblad Standaard zendingsgegevens:

7 · Instellingen · Vervoerders

Het tabblad Vervoerders weerspiegelt de vervoerders die actief zijn op je MyParcel-account.

1. Klik op Vervoerderconfiguratie importeren om je vervoerders op te halen. Sla eerst je API-key op, de mogelijkheden worden opgehaald met de opgeslagen key. Het scherm toont hoeveel vervoerders zijn geïmporteerd en wanneer.
2. Elke vervoerder heeft een aan/uit-schakelaar. Zet de vervoerders aan die je wilt aanbieden.
3. Zet per vervoerder de Services aan die je wilt, zoals Standaardbezorging en Afhaallocaties. Standaardbezorging en afhalen staan standaard aan, premium services moet je bewust inschakelen.

8 · Instellingen · Checkout

Het tabblad Checkout bepaalt de MyParcel-bezorgopties-widget die klanten zien. Op het tabblad Checkout:

9 · Instellingen · Douane

Nodig wanneer je buiten de EU verzendt. Op het tabblad Douane:

10 · Productinstellingen

Wanneer Douanevelden op product is ingeschakeld, verschijnt er een sectie MyParcel douane bovenaan het tabblad Data van een product (Catalogus → Producten → bewerk een product → Data).

• HS-code, de harmonised system-code voor dit product.
• Land van herkomst, waar het product is gemaakt.

MyParcel gebruikt ook de standaard OpenCart-velden Afmetingen (L x B x H) en Gewicht van hetzelfde tabblad Data om de zending te berekenen. Vul deze in voor nauwkeurige labels, ze vallen terug op de waarden uit Standaard zendingsgegevens wanneer ze leeg zijn.

11 · De bestellingenlijst

Open Verkoop → Bestellingen. De MyParcel-extensie voegt actieknoppen toe aan elke orderregel:

De werkbalk rechtsboven biedt dezelfde acties in bulk voor geselecteerde orders.

12 · De order-detailpagina

Open een order (de blauwe oog-knop). Bovenaan vind je het paneel MyParcel-zendingen.

• Elke export maakt een aparte zending aan, een order kan er meerdere hebben. De werkbalkacties gebruiken de nieuwste zending, de acties in de tabel werken op een specifieke zending.
• Elke regel toont het Zendingsnummer, de Barcode, de Tracking-status (bijvoorbeeld Nog niet beschikbaar of Gereed), het tijdstip Aangemaakt en per-zending-acties om het label te downloaden en de afhaallocatie te bekijken.

13 · De checkout-ervaring

Met Bezorgopties ingeschakeld zien klanten de MyParcel-widget in de checkout nadat ze hun adres hebben ingevoerd. Ze kunnen kiezen uit de vervoerders en services die je hebt ingeschakeld op het tabblad Vervoerders.

Afhankelijk van de vervoerder en je instellingen kan een klant kiezen:

• Standaardbezorging, bezorging op het adres.
• Priority-bezorging of andere premium services, wanneer ingeschakeld voor de vervoerder.
• Een Afhaallocatie, een afhaalpunt in de buurt, getoond als lijst of op een kaart. Afhaalpunten kunnen een label Milieuvriendelijk dragen.

De keuze van de klant wordt doorgegeven aan de order, zodat bij het exporteren de juiste vervoerder, service en afhaalpunt al zijn ingevuld.

14 · Dagelijks gebruik

Een typische verzenddag:

1. Open Verkoop → Bestellingen en filter op nieuwe orders.
2. Selecteer de orders die je wilt verzenden en gebruik de exportknop in de werkbalk, of exporteer ze één voor één met de groene vrachtwagenknop.
3. Download de labels (los PDF of in bulk) en print ze.
4. Overhandig de pakketten aan de vervoerder. Track & Trace wordt automatisch aangemaakt en, waar ondersteund, gedeeld met je klant.

15 · Iets werkt niet, diagnose

16 · FAQ

Heb ik zowel de Module als de Verzendmethode nodig? Ja. De Verzendmethode is het tarief dat klanten in de checkout kiezen, de Module bevat de API-key, vervoerders en labelverwerking. Installeer en schakel beide in.

Waar stel ik de verzendprijs in? Op de MyParcel Verzendmethode (Extensies → Extensies → Verzendmethoden → MyParcel), in het veld Tarief.

Kan één order meer dan één pakket hebben? Ja. Elke export maakt een aparte, onafhankelijke zending aan. Exporteer opnieuw om nog een pakket aan dezelfde order toe te voegen.

Moet ik per product gewichten en maten invoeren? Het helpt de nauwkeurigheid. Wanneer een product geen gewicht of afmetingen heeft, gebruikt MyParcel het Terugval-gewicht en de Terugval-pakketmaat uit Standaard zendingsgegevens. Sommige vervoerders vereisen echte afmetingen.

Wordt de afhaalkeuze van mijn klant bewaard? Ja. Het afhaalpunt dat een klant in de checkout selecteert, wordt op de order opgeslagen en gebruikt bij het exporteren.