MyParcel to PostNL plugin for nopCommerce 4.3 (source code included)

Quick installation guide for NopCommerce 4.30

• 1. Install the purchased plugin
• 2. Go to the configuration page of the MyParcel plugin
• 3. Enter the license key as sent to you when you purchased the licentie into the textbox behind 'License key'.
• 4. Click 'Save to activate'
• 5. In section Webservice settings under 'API Key' copy your API Id, provided by MyParcel
• 6. In Description on the label enter any of the four provided tags. The order-specific text of this tag will be placed at the left top of your label.
• 7. In default package weight, enter the default package weight in kilograms
• 8. Click 'Save'

• Stay in your nopCommerce administration environment.
• Add Address2 as mandatory field. Name this field in the webshop 'house number'. The plugin uses address2 to get the house number.

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. 

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:

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

IMPORTANT: Make sure the name ofthe shipping method contains at least one of the following words: PostNL, MyParcel
This will trigger the module to render the shipping method properly.

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 37, 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(Actopus.Nop.Plugin.Shipments.MyParcel.Components.MyParcelViewComponent), shippingMethod)

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

In Themes/<themeName>/Checkout/ShippingMethod.cshtml, around line 49, 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(Actopus.Nop.Plugin.Shipments.MyParcel.Components.MyParcelViewComponent), shippingMethod) 

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

If you don't use a custom theme then change the code in Views/Checkout/ShippingMethod.cshtml or Views/Checkout/OpcShippingMethod.cshtml

Finally configure the shipment Widget

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

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

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