Waar kunnen we je mee helpen?

Dit is de gebruikershandleiding voor onze plugin met WooCommerce. Bij vragen kun je support aanvragen via een e-mail naar ict@parcelpro.nl of bellen naar 085 273 2785. Kijk voor de meest recente informatie m.b.t. de WooCommerce plugin in het verzendsysteem via het menu Instellingen > Koppelingen > WooCommerce. Wij horen graag wat jouw bevindingen zijn m.b.t. deze koppeling. Met jouw feedback maken wij de plugin steeds een stap beter.

Installeren

De plugin kun je rechtstreeks installeren en activeren vanuit jouw Wordpress dashboard (optie 1). Een andere methode is de koppeling te installeren via optie 2, door middel van de API koppeling installatie.

Wij raden je aan om eerst een account aan te maken bij Parcel Pro en daarna de plugin te installeren.

Optie 1: Installatie Plugin

Stap 1
Login op de backoffice van jouw webwinkel.

Stap 2
Klik links op Plugins > Nieuwe plugin.

Stap 3
Rechtsboven zie je een zoekbalk, typ hier parcel pro in. Als je de app linksboven zie, klik dan op de button Nu installeren.

Klik na het installeren op Plugin activeren.

Stap 4
Indien de plugin is geïnstalleerd kan je die terugvinden via WooCommerce > Instellingen > Verzendmethoden > Parcel Pro. Als een update beschikbaar is, wordt dit weergegeven binnen jouw CMS en kun je de plugin met één klik updaten.

 

Stap 5
Om gebruik te mogen maken van de plugin moet je jouw Parcel Pro Gebruikers Id en Parcel Pro API Key gegevens invullen. Deze kun je vinden in het verzendsysteem op de pagina Koppelingen (zie volgende stap).

De ParcelPro WooCommerce plugin bevat een aantal configuratie opties:

• Inschakelen: Je kunt de plugin aan- of uitzetten door in de checkbox te klikken.
• Method Title: De titel die wordt weergeven tijdens het afrekenproces.
• Beschikbaarheid van methode: De landen waarop de plugin van toepassing is. Dit is op basis van land van de ontvanger.
• Parcel Pro Gebruiker Id: LoginId verkregen in het verzendsysteem.
• Parcel Pro Api Key: API Key verkregen in het verzendsysteem.
• Automatisch aanmelden: Door de checkbox aan te klikken worden zendingen direct ingeboekt in het verzendsysteem op het moment dat de status wordt bereikt zoals aangegeven bij Automatisch aanmelden status.
• Voeg tracking toe aan order: Door de checkbox aan te klikken worden tracking gegevens toegevoegd aan het order overzicht. Dit kan gebruikt worden in een mailing richting de klant binnen WooCommerce / externe plugins.
• Volgorde voor het tonen van de verzendopties: Hiermee kun je de volgorde bepalen van de verzendopties in het afrekenproces.

Stap 6
Nu kun je de verzendopties per vervoerder instellen. De verzendmethodes zijn open te klappen door op bijvoorbeeld Verzendmethodes van DHL te klikken.

Een verzendregel bevat het volgende:

• Titel (Method Title)
• Minimaal gewicht (Min Weight)
• Maximaal gewicht (Max Weight)
• Minimaal totaal (Min Total)
• Maximaal totaal (Max Total)
• Prijs (Price)

Indien de producten die op dat moment in de winkelwagen zitten tijdens het afrekenen voldoen aan deze ingestelde waarden zal het tarief zichtbaar zijn. Voorbeeld Bij een order tot 100 euro en een gewicht van maximaal 30 kg is de verzendoptie Parcelshop met een tarief van 4 euro zichtbaar. Boven de 100 euro met een gewicht van maximaal 30 kg zal het gratis verzending zijn naar een Parcelshop.

Stap 7
Om de wijzigingen vervolgens op te slaan klik je onderaan de pagina op de knop Wijzigingen opslaan.

Indien er een nieuwe order is en de instelling Automatisch aanmelden is niet geactiveerd kun je een order doorzetten doormiddel van de knop met het pijltje naar boven.

Indien alles succesvol verloopt bij het doorzetten van een order verschijnen er twee knoppen. Een knop met een document icoon, hiermee kan een verzendlabel afgedrukt worden. En een vrachtwagen icoon, een klik daarop navigeer je naar de track & trace pagina van de zending.

Meer zendingen tegelijk afdrukken of aanmelden kan met onderstaande selectielijst. Deze is te vinden bovenaan de orderlijst Acties.

De koppeling met de WooCommerce plugin is nu gereed!

Optie 2: Installatie API koppeling

Stap 1
Login op de backoffice van jouw webwinkel.

Stap 2
Ga links in het menu naar WooCommerce en klik op Instellingen.

Stap 3
Kies bovenin voor het tabblad Geavanceerd en klik vervolgens op REST API > Sleutel toevoegen.

Stap 4
Vul de volgende gegevens in:

• Beschrijving
• Gebruiker (deze staat meestal al goed)
• Rechten aanpassen naar Lezen en schrijven

Klik vervolgens op de blauwe button API-Sleutel genereren. 

Stap 5
Kopieer de Klantsleutel en het Klantgeheim.

Stap 6
Om via de API een verbinding te leggen moet de optie legacy API aangezet worden onder Geavanceerd.

Stap 7
Ga in in het verzendsysteem via het menu Instellingen > Koppelingen > Nieuwe koppeling naar WooCommerce. Vervolgens zie je op de pagina direct de invulvelden Klantsleutel (API Key) en Klantgeheim (Secret).

Plak hier de gegevens uit WooCommerce en klik onderaan op de button Verbinden.

De koppeling is nu gereed!

Optioneel: Custom Hooks (technische kennis vereist)

Let op, dit is een technische uitleg bedoeld voor websitebouwers!

Voor onze Parcel Pro plugin hebben wij ook de mogelijkheid om bepaalde waardes te overschrijven via externe code voordat deze naar onze server verstuurd worden. Dit is handig als je een aparte implementatie hebt van de checkout waarin standaard velden van WooCommerce aangepast zijn. Een veelvoorkomend voorbeeld hiervan is bijvoorbeeld het veld address_1 die vaak gesplitst wordt in aparte velden: straatnaam en huisnummer. Als deze gegevens doorgestuurd worden, komen de huisnummers vaak niet goed binnen.

Hieronder laten wij zien hoe dit met onze custom hook in de WooCommerce code aangepast kan worden.

1 Functie

De eerste stap is het maken van een onafhankelijke functie. Dat betekent een functie buiten de scope van een class zodat deze makkelijk gevonden kan worden door het WooCommerce systeem tijdens de aanroep.

//een functie die niet in de scope van class zit om aan de custom hook toe te voegen.

 function independent_function_to_process_data($data){
    if(!$data)return null;
    $data_new = $data;

    //overschrijf de waardes met je nieuwe waardes.

    $data_new['shipping_address']['address_1'] = 'Griede' . ' '. '22';

    return $data_new;

}

Deze functie zal de waarde $data ontvangen. Deze wordt opgevuld met de volledige verzendgegevens die naar het Parcel Pro systeem verstuurd worden. Hier beneden is de json-weergave van deze data gegeven.

In dit voorbeeld pakken wij de waarde shipping_address en daarvan het veld address_1 en overschrijven deze met onze nieuwe waarde, straatnaam en huisnummer aan elkaar geplakt. In dit geval hebben wij Griede en 22 daarvoor gekozen, deze zou je kunnen vervangen met variabelen.

JSON $data

{

   "orderNR":"421",

   "increment_id":421,

   "order":{

   },

   "items":[

      {

         "id":135,

         "order_id":421,

         "name":"Product 7"

         "product_id":15,

         "variation_id":0,

         "quantity":2,

         "tax_class":"",

         "subtotal":"0",

         "subtotal_tax":"0",

         "total":"0",

         "total_tax":"0",

         "taxes":{

            "total":[

            ],

            "subtotal":[

            ]

         },

         "meta_data":[

         ],

         "sku":""

      }

   ],

   "billing_address":{

       "firstname":"ICT",

      "lastname":"Parcel Pro",

      "company":"",

      "address_1":"Griede 22",

      "address_2":"",

      "city":"hoogvliet",

      "state":"",

      "postcode":"3191 EE",

      "country_id":"NL",

      "email":" ict @parcelpro.nl",

      "telephone":""

   },

   "shipping_address":{

      "firstname":"ICT",

      "lastname":"Parcel Pro",

      "company":"",

      "address_1":"Griede 22",

      "address_2":"",

      "city":"hoogvliet",

      "state":"",

      "postcode":"3191 EE",

      "country_id":"NL",

      "email":"ict@parcelpro.nl",

      "telephone":""

   },

   "subtotal":0,

   "subtotal_incl_tax":0,

   "grand_total":"0.00",

   "shipping_method":"parcelpro_maatwerk_5_0",

   "created_at":{

      "date":"2020-03-24 14:10:27.000000",

      "timezone_type":1,

      "timezone":"+00:00"

   },

   "aantal_pakketten":1

}

2 Add_action

Om ervoor te zorgen dat deze functie aangeroepen wordt, moeten wij daarvoor een actie toevoegen voor onze hook parcelpro_format_order_data. Dat kun je doen via de volgende regel:

add_action('parcelpro_format_order_data','independent_function_to_process_data');

Na deze aanpassing wordt de eerder gemaakte functie aangeroepen en worden de gegevens aangepast. Daarna wordt dit naar het Parcel Pro verzendsysteem verstuurd, nu met de juiste waarde van jouw custom check out!

Veelgestelde vragen

Hoe kan ik een WooCommerce Multi Vendor Shop koppelen aan het verzendsysteem? 
Heb je in jouw WooCommerce de mogelijkheid per multi shop de plug-in te installeren? Zo ja, dan kunnen we per shop een koppeling maken met een account in het verzendsysteem. Je kan dan per shop een account bij ons afnemen, en de orders zullen dan op het juiste account binnenkomen.

Een order doorzetten d.m.v. de knop lukt niet.
Controleer of jouw GebruikerID en API Key gegevens juist zijn in de configuratie van de plugin. Deze kun je terugvinden via WooCommerce > Instellingen > Verzendmethoden > Parcel Pro. En in het verzendsysteem op de pagina Koppelingen.

Is het ook mogelijk om meerdere WooCommerce koppelingen te maken?
Ja, dit is mogelijk zolang er voor elke koppeling een aparte back-end omgeving is. Je kunt de koppeling in de nieuwe back-end dan op precies dezelfde manier installeren.

Welke vervoerders worden ondersteund?
De vervoerders DHL, DPD, Cycloon, GLS, PostNL en UPS worden ondersteund op basis van de geactiveerde contracten onder jouw account in het verzendsysteem.

De track & trace knop laat een lege pagina zien
Voor de beste werking raden wij aan gebruik te maken van de verzendmethoden uit onze plugin. Op die manier kan een consument een gekoppelde verzendmethode kiezen. Bij het doorzetten van de data kan het verzendsysteem een bijhorend verzendtype bepalen en direct de benodigde track & trace gegevens terugkoppelen. Indien dat niet het geval is, zal het op basis van de standaard ingestelde verzendmethode in het verzendsysteem gaan.

Indien er niet gebruik gemaakt wordt van onze verzendmethoden in de plugin, worden alle zendingen op basis van de standaard verzendtype in ons verzendsysteem ingeboekt. Dit kan dus betekenen dat er een foute track & trace code teruggekoppeld wordt naar WooCommerce. In dit geval is het handig om de checkbox Voeg tracking toe aan order uit te zetten.

Een zending bevat verkeerde gegevens of een verkeerd verzendtype
Dit moet handmatig in ons verzendsysteem veranderd worden. Het is vooralsnog niet mogelijk om – na een bestelling met gekozen verzendtype van de consument - in WooCommerce een wijziging aan te brengen aan het verzendtype, of een order opnieuw door te zetten.