MyParcel to PostNL plugin for nopCommerce 4.2, 4.1, 3.7 and 3.9. NOT FOR 4.3

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

Features

webshop:

Allow customer to select the option 'no delivery at neighbour' against a surcharge.

Admin config:

Enable the option 'no delivery at neighbour'

Set a surcharge for 'no delivery at neighbour' (In euro's)

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

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, a brievenbuspakket or create a blanc address label.

Optionally select an insurance level

Select if package is oversized 

Select 'Request signature on delivery'

Create a definitive or concept consignment.

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

Post the consignment to MyParcel and download the label.

Shipment tracking

The shipment status is retrieved through the internationalparceltracking api and the raw json is incorporated into you shipment's admincomment field.

Upon delivery the shipment is automatically move to the delivered state.

The list above is an exhaustive list of features. All other features of MyParcel are not supported and should be set on the MyParcel site. 

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 'MyParcel'. Latter should contain a dozen files. 

To configure this plugin, follow this procedure:

1. Go to your nopCommerce administration environment.
2. Add Address2 as mandatory field. Name this field in the webshop 'house number'. The plugin uses address2 to get the house number.
3. From the top menu 'Configuration', select the sub menu 'Plugins'.
4. Click the button 'Reload list of plugins', usually located just below the right top of the screen.
5. 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
6. Click on the button 'Install' at the end of the row and wait for the plugin to be installed
7. 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. 
8. Now locate the plugin again in your 'Configuration' page.
9. Click on the button 'Edit', it's just below the plugin. Check 'is enabled' and save.
10. Back in the list: Click on the button 'Configure', it's just below the plugin.
11. 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.
12. '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.
13. 'Allow customers to select 'no delivery at neighbour!': This allows customer to allow only home delivery. The surcharge for this option is entered in euro's in the field 'The extra price for the service 'no delivery at neighbour'. This surcharge is automatically added to the shipping cost. 
14. Enter your MyParcel User name
15. Enter your MyParcel API key
16. repeat steps 13 and 14 optionally for your warehouses. You may leave these fields blank.
17. Click 'Save'

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

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 PostNL:

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

For example:
Naam: Snelle levering met PostNL
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/OpcShippingMethod.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>
}
@await Component.InvokeAsync(typeof(Nop.Plugin.Actopus.MyParcel.Components.MyParcelViewComponent), shippingMethod)

 
--------------------------------------------------------------------------------------------------------------
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>
}
@await Component.InvokeAsync(typeof(Nop.Plugin.Actopus.MyParcel.Components.MyParcelViewComponent), shippingMethod)

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

In Themes/<themeName>/Checkout/ShippingMethod.cshtml, around line 31, 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>
}
@await Component.InvokeAsync(typeof(Nop.Plugin.Actopus.MyParcel.Components.MyParcelViewComponent), shippingMethod)
 

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

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>
}
@await Component.InvokeAsync(typeof(Nop.Plugin.Actopus.MyParcel.Components.MyParcelViewComponent), shippingMethod)

Finally configure the shipment Widget

This step is only for NopCommerce 4.2. Older versions do not use the widget mechanism!

1. Go to the Widget list editor under Configuration >Widgets
2. Locate the MyParcel shipping provider widget and click 'Edit'
3. Activate this widget!

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

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. 

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. 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 see the plugin 'actOpus License Manager'. Its system name is:  Actopus.Misc.LicenseManager
5. Click the button 'Configure' (or 'Instellingen'), it's just below the plugin.
6. Click the button 'Add another license', it's just below the wrench icon.
7. 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. 
8. 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.
9. 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