Let op: Deze plugin communiceert alleen met het nieuwe platform van SendMyParcel. Heb je eerder gebruik gemaakt van een oudere versie? Dan is een nieuwe API-key noodzakelijk.

Inleiding

Deze handleiding beschrijft de functionaliteiten van de MyParcel BE extensie en hoe je de MyParcel BE extensie in jouw webwinkel kunt installeren.

In deze handleiding beschrijven wij de installatie via SSH/FTP. Mocht je hier hulp bij nodig hebben dan adviseren wij om contact op te nemen met je technisch beheerder.

Met deze Magento extensie kun je drie soorten MyParcel BE zendingen aanmaken:

  1. Normaal (gewone pakketten en Ophalen op Bpost locatie)
  2. Pakketten naar buitenland, zowel EU als buiten EU.

Inhoud

1 Installatie

Wij adviseren de installatie altijd eerst op een testomgeving uit te voeren en een back-up te maken van jouw webshop voor je begint.

1.1 Technische vereisten

Om de MyParcel BE Magento extensie te gebruiken dient uw server aan de onderstaande vereisten te voldoen:

De onderstaande Magento versies worden ondersteund:
Community 1.6, 1.7, 1.8, 1.9

1.2 Extensie downloaden

Je kunt de extensie op de volgende locatie downloaden:

1.3 Compiler uitschakelen

Voordat je met de installatie aan de slag gaat is het belangrijk dat de compiler in jouw Magento installatie uitgeschakeld wordt indien deze aan staat. Wanneer je bent ingelogd in jouw Magento omgeving kun je de compiler uitschakelen via het menu: Systeem → Hulpmiddelen → Compilatie.

1.4 Mappen & bestanden uploaden

Het .zip bestand bevat twee mappen:

Upload deze mappen naar jouw Magento installatie.
Er worden geen bestanden overschreven. Als het SSH/FTP programma vraagt of je de mappen wilt samenvoegen of vervangen kies dan voor de optie samenvoegen.

1.5 Cache legen & opnieuw inloggen

Login op jouw Magento beheeromgeving en ga naar het menu Systeem → Beheer cache. Klik op Selecteer alles, kies in het dropdownmenu voor de optie Ververs en klik op de Bevestig button.
Klik vervolgens rechtsboven op Uitloggen en log opnieuw in op jouw beheeromgeving.

1.6 Cron controleren

De MyParcel BE extensie maakt gebruik van enkele cronjobs. Deze zijn nodig om de statussen van zendingen periodiek bij te werken in jouw backend. De extensie haakt in op de cronfunctionaliteit van Magento.
Neem contact op met jouw ontwikkelaar als je hier vragen over hebt.

Server cronjob
De wijze waarop je cronjobs op jouw server instelt verschilt per hostingprovider omdat er meerdere webserverbeheer systemen bestaan. Voorbeelden hiervan zijn DirectAdmin, Plesk en Cpanel. Onderstaand een voorbeeld hoe je in DirectAdmin een cronjob insteld voor Magento.

  1. Ga naar het account waar de Magento omgeving op draait en klik Cronjobs aan.
  2. Voor een Magento Community webshop stel je in dat de cronjob elke 5 minuten geactiveerd moet worden (zoals in onderstaand voorbeeld).
  3. Controleer met SSH of je de cronjob kunt activeren.
    Dit kan door in een terminal venster in te loggen en het command in te voeren. In ons voorbeeld is dat /home/magento/public_html/cron.sh. Dit dien je te doen met root rechten. Mocht dit niet werken of mocht de server geen shell mogelijkheid hebben dan kunt je uitwijken naar het cron.php bestand. In dat geval kun je twee cronjobs aan maken. Je kunt aan geven waar PHP draait voor de opdrachten en de locatie achterhalen met de PHP constante PHP_BINDIR.
    Achter de opdrachten moet je een parameter te plaatsen:
    • Opdracht 1: cron.php -malways 1
    • Opdracht 2: cron.php -mdefault 1
    Zie onderstaand screenshot voor een voorbeeld.
  4. Zorg dat de cron.sh (of cron.php) bestand 755 rechten heeft. De server roept nu elke 5 minuten de cron functionaliteit van Magento aan.
  5. Magento cron
    1. Ga naar het menu System → Configuration → Advanced → System → Cron (Scheduled Tasks).
    2. Zorg dat de instellingen gelijk zijn aan onderstaande afbeelding.
    Je kunt het beste de database openen en de table cron_schedule openen om te controleren of de cron succesvol draait. Die zal direct gevuld worden en daarin kun je zien of de aanpassingen effect hebben.

2 Configuratie

Ga naar het menu Systeem → Configuratie → Verkoop → MyParcel om de MyParcel extensie te configureren.
Onder het kopje 'Versie & Support' kun je zien welke versie van de extensie jij gebruikt.

Verder zie je 2 tabbladen om uit te kiezen. Een tabblad voor de Algemene instellingen en een tabblad voor de checkout instellingen.

2.1 Algemene instellingen

Op het tabblad 'Algemene instellingen' kun je 'Api instellingen', 'Basis instellingen' en de 'Standaardverzendinstellingen' wijzigen en/of aanvullen naar jouw wensen.

2.1.1 API instellingen

Hier kun je jouw API gebruikersnaam en jouw API Key invullen. Deze zijn nodig om de zendingen door te kunnen zetten naar MyParcel.
Deze gegevens kun je vinden in jouw MyParcel BE account op backoffice.sendmyparcel.be en ga vervolgens naar Instellingen -> Algemeen

2.2 Basis Instellingen

Bij dit kopje kun je alle instellingen voor het gebruiken van de MyParcel BE Extensie invullen.

2.2.1 Print oriëntatie

Kies de Print oriëntatie. Als je kiest voor A4 formaat zullen vier verzendlabels per A4 vel geprint worden. Als je kiest voor A6 formaat zijn de verzendlabels geschikt voor het printen met een speciale labelprinter zoals een Zebra of Dymo 4XL.

2.2.2 Track&Trace e-mail template

Je kunt uit 2 opties kiezen voor het versturen van Track en Trace e-mails.

  1. De Track&Trace mails via MyParcel BE versturen, of
  2. De Track&Trace mails vanuit je Magento shop versturen.

Via MyParcel BE

Volg hiervoor onderstaande stappen:

  1. Log in op sendmyparcel.be
  2. Ga naar het menu Instellingen → Track & Trace
  3. Stel hier jouw Track&Trace mails naar wens in

Via je Magento webshop:

Volg hiervoor onderstaande stappen:

  1. Ga naar Systeem → Transactionele Emails
  2. Kies voor de button Nieuw Sjabloon Toevoegen
  3. Selecteer het sjabloon Verzendings update en kies Laad Sjabloon.
  4. Geef een naam aan het sjabloon in het veld Naam Sjabloon. Dit is voor intern gebruik.
  5. Pas de inhoud van het sjabloon naar wens aan. Je kunt hiervoor de variabele {{var tracktrace_url}} en {{var retourlabel_url}} gebruiken.
  6. Om er voor te zorgen dat er alleen tekst wordt getoond wanneer deze variabelen aanwezig zijn, kan je gebruik maken van {{depend tracktrace_url}} en {{depend retourlabel_url}}.
  7. Kies voor de button Sjabloon Opslaan.
  8. Ga naar het menu Systeem → Configuratie → MyParcel en vervolgens naar de tab Algemene instellingen.
  9. Selecteer in de dropdown Track&Trace email template het sjabloon dat je zojuist hebt aangemaakt.

2.2.3 Gebruik MyParcel voor alle verzendmethodes

Kies hier voor de optie Ja om alle bestaande verzendmethodes in Magento gebruiken om door te zetten naar MyParcel BE.
Wanneer je deze optie niet wilt gebruiken kies je voor Nee. Je kunt nu de verzendmethoden zelf kiezen welke gebruikt kunnen worden door de MyParcel BE plugin.

2.3 Standaard verzendinstellingen

2.3.1 Standaard verzendopties

Op basis van de ingevulde orderwaarde worden de onderstaande opties geactiveerd. Voorbeeld: ndien je bij Verzekerd tot € 500 bijvoorbeeld de waarde 100 invult, worden orders met een verkoopwaarde boven de € 100 automatisch verzekerd tot een waarde van € 500. Deze logica is ook voor Handtekening voor ontvangst optie in te stellen:

Let op: Op het moment dat 0 ingevuld staat, is de optie niet geactiveerd. Bij invullen van 1 of hoger staat de optie actief.

2.3.2 Douane verzend type

Kies in het dropdownmenu bij het configuratieveld Douane verzend type de optie die bij uw zendingen past.
Dit is een standaard instelling voor 'Rest Of World' zendingen. Wanneer je een zending gaat doorzetten naar MyParcel BE, kun je dit per zending nog aanpassen. Deze optie vervalt als labels in batch aanmaakt.

Douane goederen HS code

Vul in het veld Douane goederen HS code de gewenste HS code in.

Je kunt de codes vinden op deze link: https://financien.belgium.be/nl/douane_accijnzen
Let op: de HS code moet exact vier cijfers zijn.

Dit is een standaard instelling voor 'Rest Of World' zendingen. Wanneer je een zending gaat doorzetten naar MyParcel BE, kun je dit per zending nog aanpassen. Deze optie vervalt als labels in batch aanmaakt.

Het is ook mogelijk om per productcategorie een eigen HS code mee te geven. Deze optie kun je invullen onderaan de pagina van een gewenste categorie. Ga naar Catalogus -> Beheer categorieën .

2.4 Versturingsmethodes configuratie

Ga naar het menu Systeem → Configuratie → Verkoop → Versturings Methodes → MyParcel.
Activeer de versturingsmethode. Kies vervolgens een Titel en een Methodenaam.

2.4.1 Tarief type

Je kunt gebruik maken van twee methodes om de verzendkosten te berekenen:

3 Checkout instellingen

Op het tabblad 'Checkout instellingen' kun je alle gewenste instellingen toepassen die zichtbaar zijn in de checkout. Dit tabblad wordt onderverdeeld in 'Basis instellingen' , 'Bezorging' en 'Ophalen bij een bpost locatie'

3.1 Basis instellingen

3.1.1 Aantal dagen

Met de functie 'aantal dagen vooruit' kun je aangeven hoeveel dagen vooruit jouw klant een levermoment kan kiezen. Wanneer je kiest voor 7 dagen is laatste keuzemogelijkheid precies 7 dagen later. De dagen waarop er geen leveringen mogelijk zijn, worden niet weergegeven in de checkout.

In de afbeelding hierboven kun je zien dat er is gekozen om 7 dagen vooruit te laten zien. In de afbeelding hieronder kun je zien hoe jouw klant dit te zien krijgt in de checkout. Er worden in totaal 5 leverdagen laten zien omdat de zondag en maandag geen leverdagen zijn. Het laatste levermoment is precies 7 dagen verder.

3.1.2 Laatste bestelmoment

Hiermee kun je instellen tot welk moment het mogelijk is voor jou een bestelling klaar te maken voor levering. Indien jij hier tot 16:00 uur instelt, zullen alle klanten na dit tijdstip een latere dag in hun checkout te zien krijgen als eerste levermogelijkheid.
Bijvoorbeeld: Jij hebt een verwerktijd van 1 dag en kunt tot 16:00 bestellingen verwerken. De bestelling komt binnen op dinsdag 04 oktober om 16:02, de eerst volgende mogelijkheid voor jouw klant zou dan donderdag 06 oktober worden. Dit betekent voor jou dat je het pakket op woensdag zal inleveren bij een Bpost punt.

3.1.3 Verzenddagen

Bij de verzenddagen kun je invullen op welke dagen het voor jou mogelijk is pakketten in te leveren voor collectie op dezelfde dag. In de checkout wordt hier rekening mee gehouden qua keuzes die worden getoond aan jouw klant.

3.1.4 Vertraging

Indien jij een langere verwerkingstijd nodig hebt om tot leveren over te gaan kun je dat hier aangeven. Hier zal rekening mee worden gehouden in het tonen van de beschikbare bezorgdagen in de checkout.

3.1.5 Kleuren

Het is mogelijk om kleuren van het venster waarin de verzendopties worden weergegeven in de checkout geheel naar jouw stijl aan te passen.

3.2 Bezorging

3.2.1 Titel bezorging

Je kunt zelf kiezen welke titel jij de bezorging geeft. Het advies is om "Bpost" hierin te plaatsen.

3.2.2 Handtekening voor ontvangst

Je kunt hiermee aangeven of jouw klanten hier zelf voor kunnen kiezen in de checkout. Indien jij dit wilt weergeven in de checkout kies dan voor Ja Ook is het mogelijk om aan deze optie een eigen naam mee te geven, in het voorbeeld heet deze optie 'Handtekening voor ontvangst'. Als laatste optie kun je er ook een meerprijs aan koppelen, in het voorbeeld kost deze optie €0.45 extra.

Er is ook een optie gemaakt voor een gecombineerde meerprijs voor de keuzes samenAlleen bij mij bezorgen en Handtekening voor ontvangst te bepalen. Je kunt zelf een prijs naar eigen inzicht invullen.

3.2.3 Zaterdagbezorging

Er kan ook gekozen worden om een pakket op zaterdag te laten bezorgen, houd er rekening mee dat je bij verzenddagen wel de vrijdag selecteert als verzenddag.

3.3 Ophalen bij Bpost locatie

Met deze optie kunnen jouw klanten kiezen om hun pakket bij een Bpost locatie op te halen. Deze locatie kunnen zij zelf kiezen in de checkout. Je kunt hier eventueel ook een meerprijs voor rekenen, maar MyParcel BE rekent er geen extra kosten voor.

4 Backend functionaliteiten

Om de backend functionaliteiten te kunnen gebruiken dient de MyParcel BE extensie te zijn ingeschakeld.

4.1 Verzending aanmaken

Een MyParcel BE zending aanmaken kan op twee manieren:

1. Batch methode in het bestellingenoverzicht.

  1. Selecteer de orders die je wilt exporteren naar MyParcel BE
  2. Kies in de actie balk MyParcel - creëer labels en vervolgens kun je klikken op verstuur
  3. Kies voor de juiste printpositie, indien je voor A4 hebt gekozen
  4. Het PDF verschijnt op je computer en is klaar om te printen

2. Per bestelling als je een Magento zending aanmaakt.

  1. Klik op de desbetreffende order
  2. Kies rechtsboven voor de knop verstuur
  3. Rechts onderin verschijnt een geel vak. Hier kan je zowel het verzendtype aanpassen als de beschikbare verzendopties per verzentype.
  4. Verstuur zending naar MyParcel BE

Het is ook mogelijk om een order in deelleveringen te versturen, bijvoorbeeld wanneer de order in totaliteit te zwaar of te groot is om in één doos te versturen of wanneer een deel van de levering tijdelijk niet voorradig is en je deze later alsnog wil toesturen.

  1. Je kunt hiervoor de order bekijken en rechtsboven kiezen voor Verstuur.
  2. Pas de hoeveelheid aan bij Items te verzenden en kies rechtsonder voor Stuur verzending.
  3. Je kunt hierna op dezelfde wijze nog een verzendlabel aanmaken voor dezelfde order. Beide verzendingen worden opgeslagen in de order.

4.2 Genereer retourlabel

Klik in het order overzicht op de betreffende order. Op het detailscherm klik je links in het menu op de tab Zendingen. Klik de betreffende zending aan die geretourneerd moet worden. Je bent nu op het verzending detail scherm waar je rechtsboven de button Genereer retourlabel ziet staan.

Jouw klant zal van MyParcel BE een e-mail ontvangen met een link naar het verzendlabel indien er een e-mailadres is ingevuld bij de zending. Je kunt jouw e-mail voor retouren binnen MyParcel BE eventueel nog personaliseren. Ook is het mogelijk om een eigen bijdrage voor jouw klant in te stellen. Je kunt dit doen door in te loggen bij MyParcel BE bij Instellingen → Retour en dan onderaan de pagina Pas e-mail aan.

4.2.1 Genereer ongerelateerde retourlabel

Je kunt vanuit jouw order overzicht een retourlabel versturen naar jouw klant. Klik hiervoor op de button Mail retourlabel


Vervolgens opent er een scherm waarin je de naam en het e-mailadres van jouw klant invullen. Ook is het mogelijk een kenmerk mee te geven zodat je eenvoudig kunt zien om welke zending het gaat.

5 Upgraden

Klik hier voor de nieuwste versie van de MyParcel BE extensie.
Om het zip bestand te downloaden klik onder Downloads op source code.

Voor meer informatie over de release notes kun je hier klikken.

5.1 Upgrade stappen

1 Compiler uitschakelen
Schakel de compiler uit indien deze is ingeschakeld.
Dit kan ingesteld worden in het menu Systeem → Gereedschap → Compilatie.

2 Mappen & bestanden uploaden
Het .zip bestand bevat twee mappen:

  1. app
  2. skin

Upload deze mappen naar jouw Magento installatie.
Als het SSH/FTP programma vraagt of je mappen wilt samenvoegen of vervangen kies dan voor samenvoegen.

3 Cache legen & opnieuw inloggen
Login op jouw Magento beheeromgeving en ga naar het menu Systeem → Beheer cache. Klik op Selecteer alles, kies in de dropdown voor Ververs en klik op de Bevestig button.
Klik rechtsboven op Uitloggen en log opnieuw in op uw beheeromgeving.
De extensie is nu geüpgraded.

6 Veel gestelde vragen

6.1 Ondersteunen jullie mijn checkout?

De verzendmethode MyParcel BE maakt gebruik van standaard Magento functionaliteiten. Dit houdt in dat de verzendmethode in elke checkout die volgens de Magento richtlijnen is opgebouwd werkt.
MyParcel BE 'Ophalen op een Bpost locatie' wordt ondersteund voor de onderstaande checkout extensies:

6.2 Ik gebruik een postcode check extensie, is dat een probleem?

In principe is het mogelijk een postcode check extensie te gebruiken in combinatie met de MyParcel Magento extensie.

6.3 Hoe kan ik gratis verzendkosten instellen?

Naast de Table Rates kun je ook gratis verzendkosten instellen via Promoties > Winkelwagen prijsregels.

  1. Klik rechts bovenin op Nieuwe regel toevoegen.
  2. Bij Regelgegevens geef je de regel een naam (voorbeeld: ‘gratis verzenden vanaf 50’). Zet de status op actief en kies bij websites en klantengroepen alle opties.
  3. Klik links boven op Voorwaarden en schrijf zelf de regel door op + te klikken. (voorbeeld: Subtotaal gelijk aan of groter dan 50)
  4. Ga naar de volgende stap acties en geef bij gratis verzending aan Alleen voor betreffende artikelen.
  5. Klik rechts bovenin op opslaan.