Waar kunnen we je mee helpen?

WooCommerce handleiding

Dit is de gebruikershandleiding voor onze plugin met WooCommerce. Bij vragen kunt u 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 uw bevindingen zijn m.b.t. deze koppeling. Met uw feedback maken wij de plugin steeds een stap beter.

Installeren

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

Wij raden u 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 uw webwinkel.

Stap 2
Klik links op Plugins > Nieuwe plugin.

stap 2

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

 

Klik na het installeren op Plugin activeren.


stap 3 - plugin activeren

 

 

 


 

Stap 4
Indien de plugin is geïnstalleerd kunt u die terugvinden via WooCommerce > Instellingen > Verzendmethoden > Parcel Pro. Als er een update beschikbaar is, wordt dit weergegeven binnen uw CMS en kunt u de plugin met één klik updaten.
stap 4
 

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

De ParcelPro WooCommerce plugin bevat een aantal configuratie opties:

  • Inschakelen: U 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 kunt u de volgorde bepalen van de verzendopties in het afrekenproces.


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

stap 6

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 klikt u onderaan de pagina op de knop Wijzigingen opslaan.

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

stap 7

 

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 navigeert u naar de track & trace pagina van de zending.

stap 7

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

stap 7

De koppeling met de WooCommerce plugin is nu gereed!

 

Optie 2: Installatie API koppeling

 

Stap 1
Login op de backoffice van uw 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 ziet u 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!

stap 8

stap 8

 


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 u 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 u 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 kunt u 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 uw custom check out!

 

Veelgestelde vragen 

Hoe kan ik een WooCommerce Multi Vendor Shop koppelen aan het verzendsysteem? 
Heeft u in uw 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. U 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 uw GebruikerID en API Key gegevens juist zijn in de configuratie van de plugin. Deze kunt u terugvinden via WooCommerce > Instellingen > Verzendmethoden > Parcel Pro. En in het verzendsysteem op de pagina Koppelingen.

Welke vervoerders worden ondersteund?
De vervoerders DHL, DPD, Fietskoeriers.nl, GLS, PostNL, Red je Pakketje en UPS worden ondersteund op basis van de geactiveerde contracten onder uw 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.

Heeft dit artikel je geholpen? Ja Nee
Gewijzigd op: 20 mei 2020