MyParcel to BPost plugin for nopCommerce 3.70+

Quick installation guide

1. Is this your first purchase at actOpus? If yes then first copy the License Manager plugin folder to the plugins directory

2. Copy the purchased plugin folder to the plugins directory

3. reload your plugins in nopCommerce

4. Is this your first purchase at actOpus? If yes then first install the License Manager plugin. No config needed

5. Install the purchased plugin

6. Register your plugin in the License Manager configuration screen.

7. Configure the purchased plugin

Contact us if you want to upgrade to an IP address license (199 euro). An IP license will allow you to use this plugin on any number of sites running on one IP adress. 

Features

webshop:

Allow customer to select the option 'Saturday only delivery' against a surcharge.

Admin config:

Enable the option 'saturday delivery'

Set a surcharge for 'saturday delivery' (In euro's)

Configure global MyParcel.be webservice settings and create individual api settings for your warehouses.

Set a default package weight in kg.

Enable the option 'Mark as 'sent' after succesfull post by default. This will move the shipment into the 'Shipped' state after receiving a tracking code. 

Shipment handling

Select the shipment that will receive the tracking code. Also select the warehouse, if necessary.  

Post a Pakket

Optionally select an insurance level

Select a different weight.

'Saturday delivery only' is shown if necessary. 

Select 'Request signature on delivery'

Create a definitive or concept consignment. (Concepts are not charged until you generate a label)

You have the option to manually check and override the address. (Street name, house number, extension and zip code)

Post the consignment to SendMyParcel and download the label.

Shipment tracking

Shipment tracking will be implemented as soon as we receive a valid tracking code from the first customer. Update is free, ofcourse.

Important notes about the MyParcel service:
As of publication of this plugin a few features do not work properly at the MyParcel side of the webservice. Please do not flood our helpdesk with questions about their issues. These are the known issues:

1. Labels are rotated 90 degrees prior to printing. A customer therefore suggested printing the labels with the pdf reader 'foxit'
2. The option 'signature upon delivery' is not saved by MyParcel
3. During creation of a consigment, the street adress and house number are correctly uploaded to MyParcel and stored at MyParcel. However when you attempt to change the consignment on the MyParcel website, you will loose the housenumber.  Beware of that!
4. For Luxembourg, the zipcode must be four digits. Zipcodes starting with 'L-' are rejected by the API.

To install this plugin, follow this procedure:

1. First check if you have installed the actOpus License Manager. You should see that plugin in group 'misc' of your plugins. If you don't see the actOpus License Manager then follow the procedure 'How to install the actOpus License Manager'  to install the license plugin.
2. Locate the root folder of your webshop. This folder should contain other folders like 'Administration, bin, Content, Plugins, Themes' and more.
3. Next open the folder 'Plugins'
4. Unzip the contents of the downloaded file into this 'Plugins' folder. The zip file already contains a folder for the plugin 'MyParcel' so when you unzip make sure you select the 'use folder names' option. 

Now your 'Plugins' folder should contain a folder named 'MyParcelBE'. Latter should contain a dozen files. 

To configure this plugin, follow this procedure:

1. Go to your nopCommerce administration environment.
2. From the top menu 'Configuration', select the sub menu 'Plugins'.
3. Click the button 'Reload list of plugins', usually located just below the right top of the screen.
4. After a minute or so, the list is renewed and you will be able to find the plugin 'MyParcel Select, Package and Ship'. Its system name is: Actopus.Nop.Plugin.Misc.MyParcel. You can find the plugin in the group 'Shipment', not in MISC!
5. Click on the button 'Install' at the end of the row and wait for the plugin to be installed
6. Now add your license using the actOpus License Manager by following the procedure 'How to add your licenses to the actOpus License Manager' at the end of this page. 
7. Now locate the plugin again in your 'Configuration' page.
8. Click on the button 'Edit', it's just below the plugin. Check 'is enabled' and save.
9. Back in the list: Click on the button 'Configure', it's just below the plugin.
10. Set a default weight (Kilograms) for packages that have a weight of zero (0). This is then passed to MyParcel as a zero will be rejected.
11. 'Mark order as sent after post': When checked the shipment will be marked 'sent' upon getting a valid PostNL trackingcode and a mail is sent.
12. 'Allow customers to select 'saturday delivery!': This allows customer to allow only delivery on saturdays. The surcharge for this option is entered in euro's in the field 'The extra price for the service 'saturday deliver'. This surcharge is automatically added to the shipping cost. 
13. Enter your MyParcel User name
14. Enter your MyParcel API key
15. repeat steps 13 and 14 optionally for your warehouses. You may leave these fields blank.
16. Click 'Save'

Now it's time to setup your webshop to actually use MyParcelBE

You'll need some technical background to change some of the Microsoft Razor code. Always backup your webshop before making changes. If you hired a design company then also provide them with the changes you are about to make:

--------------------------------------------------------------------------------------------------------------

Create a shipping method for BPost:

Make absolutely sure that either the name or the description of the shipping method contains the name BPOST (case insensitive) or myparcel as that will trigger the MyParcel plugin.

For example:
Naam: Snelle levering met BPost
Omschrijving: Verzonden binnen 1 werkdag en geleverd binnen 24 uur na betaling. Met Track en Trace code.

Now disable the inappropriate countries under 'Shipping Method Restrictions (verzendmethode Beperkingen)'. 
Do not forget: A cleared checkbox means the the shipping method is available for that country. 

Now configure the shipping prices under 'Shipping Rate Computation Methods'.

--------------------------------------------------------------------------------------------------------------

In Themes/<themeName>/Checkout/OpcShippingMethods.cshtml, around line 21, you should change the following source code:

 @if (!String.IsNullOrEmpty(shippingMethod.Description))
 {
     <div class="method-description">
      @Html.Raw(shippingMethod.Description)
     </div>
 }
 
Change it into:
 @if (!String.IsNullOrEmpty(shippingMethod.Description))
 {
 <div class="method-description">
 @Html.Raw(shippingMethod.Description)
 </div> 
 }
 <div class="method-description">
 @Html.Partial("_MyParcel", shippingMethod)
 </div>

--------------------------------------------------------------------------------------------------------------
If you don't use a custom theme then:

In Views/Checkout/OpcShippingMethods.cshtml, around line 21, you should change the following source code:

 @if (!String.IsNullOrEmpty(shippingMethod.Description))
 {
 <div class="method-description">
 @Html.Raw(shippingMethod.Description)
 </div>
 }
 
Change it into:
 @if (!String.IsNullOrEmpty(shippingMethod.Description))
 {
 <div class="method-description">
 @Html.Raw(shippingMethod.Description)
 </div>
 }
 <div class="method-description">
 @Html.Partial("_MyParcel", shippingMethod)
 </div>
--------------------------------------------------------------------------------------------------------------

In Themes/<themeName>/Checkout/ShippingMethod.cshtml, around line 30, you should change the following source code:

 @if (!String.IsNullOrEmpty(shippingMethod.Description))
 {
 <div class="method-description">
 @Html.Raw(shippingMethod.Description)
 </div>
 }

Change it into:

@if (!String.IsNullOrEmpty(shippingMethod.Description))
 {
     <div class="method-description">
          @Html.Raw(shippingMethod.Description)
     </div>
 }
 <div class="method-description">
       @Html.Partial("_MyParcel", shippingMethod)
 </div>

--------------------------------------------------------------------------------------------------------------

If you don't use a custom theme then:

In Views/Checkout/ShippingMethod.cshtml, around line 30, you should change the following source code:

 @if (!String.IsNullOrEmpty(shippingMethod.Description))
 {
 <div class="method-description">
 @Html.Raw(shippingMethod.Description)
 </div>
 }
 
Change it into:
 @if (!String.IsNullOrEmpty(shippingMethod.Description))
 {
 <div class="method-description">
 @Html.Raw(shippingMethod.Description)
 </div>
 }
 <div class="method-description">
 @Html.Partial("_MyParcel", shippingMethod)
 </div>
------------ 

How to install the actOpus License Manager

1. Locate the root folder of your webshop. This folder should contain other folders like 'Administration, bin, Content, Plugins, Themes' and more.
2. Next open the folder 'Plugins'
3. Unzip the contents of the downloaded file into this 'Plugins' folder. The zip file already contains a folder for the plugin 'Actopus.LicenseManager' so when you unzip make sure you select the 'use folder names' option. 
4. Go to your nopCommerce administration environment.
5. From the top menu 'Configuration', select the sub menu 'Plugins'.
6. Click the button 'Reload list of plugins', usually located just below the right top of the screen.
7. After a minute or so, the list is renewed and you will see the plugin 'actOpus License Manager'. Its system name is:  Actopus.Misc.LicenseManager
8. Install the plugin with 'install' button on the right side of the screen
9. Configuration is not necessary.

How to add your licenses to the actOpus License Manager

1. Go to your nopCommerce administration environment.
2. From the top menu 'Configuration', select the sub menu 'Plugins'.
3. Locate the plugin 'actOpus License Manager'. Its system name is:  Actopus.Misc.LicenseManager
4. Click the button 'Configure' (or 'Instellingen'), it's just below the plugin.
5. Click the button 'Add another license', it's just below the wrench icon.
6. In 'the license key' field, paste your license key that has been sent to you by email. Next click the 'Update' button at the end of the row. The license manager will now contact the actOpus server and retrieve the information about your license. 
7. Make sure the Domain/Url column matches your webshop's domain. Contact us if it doesn't match. Remember that your license is linked to the said domain/url and will only work for that domain.
8. Repeat steps 6, 7 and 8 for subsequent licenses.

Continue with the installation of you other plugin.

GDPR Information

What information is sent to MyParcel?
-Name, company name, street address, city
-Type of shipment
-Value of goods

What information is retrieved and stored from MyParcel?
-The current shipment status

What happens when a customer wants their NopCommerce account to be deleted?
-Nothing. Shop owners should contact MyParcel and request specific customer info to be deleted