PostNord shipping provider plugin for nopCommerce

A fully featured PostNord shipping plugin for nopCommerce (https://portal.postnord.com/).

No need to access the PostNord portal in your day to day business; everything is automatically done under the hood!

Get it here: https://www.majako.net/nopcommerce-post-nord

NOTE: Only swedish retailers are currently supported.

Features

• Dynamically retrieve shipping options based on your PostNord configuration
• Let your customers select service point
• Automatically create and reserve the PostNord shipment (of the type your customer chose) when creating a shipment in nopCommerce
• Automatically book the shipment in PostNord when it is marked as sent in nopCommerce
• Automatically delete the reserved shipment in PostNord when it is deleted in nopCommerce
• Tracking id and url is set on the shipment in nopCommerce
• Print one or many shipping labels directly from nopCommerce in PDF format
• Handle your shipments one by one or in bulk from the shipment list in nopCommerce

Getting started

Sign up in test environment

Sign up for a test business account here: https://atportal.postnord.com/onboard/

In the plugin settings, make sure "Run in PostNord's test environment" is checked.

Sign up in live environment

Sign up for a live business account here: https://portal.postnord.com/onboard/

In the plugin settings, make sure "Run in PostNord's test environment" is not checked.

Set up the store connection in the PostNord portal

In the PostNord portal, first go to "Skicka Direkt Business" in the left menu, then select "E-commerce" in the top menu, then click the "Create new store connection" button:

Choose the platform "nopCommerce by Majako", click "Next", then enter a store name, select a sender address, then click the "Confirm" button.

Save the store identifier and the store key (you will enter these in the plugin configuration later), and click the "Done!" button:

Configure the shipping options in the PostNord portal

Click your newly created store connection to add and configure your delivery methods/shipping options that will be available in nopCommerce.

Plugin configuration

Make sure to restart the application after save, to make sure the changes are applied.

Subscription key

Purchase a valid subscription here: https://www.majako.net/nopcommerce-post-nord

Enter the subscription key you've got when purchasing the product subscription. Make sure that you've entered the store domain name without https://www and ending slash etc, e.g. domain.com will work for both domain.com and www.domain.com.

The license key should be provided in the order confirmation email. If you haven't received one, contact us at support@majako.se.

Run in PostNord's test environment

Make sure that this setting is checked, when running against PostNord's test portal (https://atportal.postnord.com/onboard/) Make sure it is unchecked when running against PostNord's live environment. (https://portal.postnord.com/onboard/)

Debug mode

Enable verbose logging to the nopCommerce log.

PostNord store identifier

Enter the store identifier you've got when creating the store connection in the PostNord portal. See Set up the store connection in the PostNord portal above.

PostNord store key

Enter the store key you've got when creating the store connection in the PostNord portal. See Set up the store connection in the PostNord portal above.

Shipping option prefix

Optional text for prefixing all the shipping options' names with.

Numbers of service points to show per shipping option

For shipping options supporting service points, a shipping option will be created for the X closest service points. This setting specifies what X is.

Shipping label paper size

Paper size used for printing shipping labels. Avaliable values are A5, A4, LETTER and LABEL. Use "(default)" to use the global setting configured in Skicka Direkt Business.

Shipping label size

Label size used for printing shipping labels. Avaliable values are standard and small. Use "(default)" to use the global setting configured in Skicka Direkt Business.

Troubleshooting

Find out what's failing

Debug mode. Check this plugin setting to enable verbose logging to the nopCommerce log.

Future development

Automatic ZPL printing to printers connected to Skicka Direkt Business

Currently, PostNord's API only supports PDF format. We are in discussions with PostNord about extending the API so connected ZPL printers will be supported.

Two-way synchronization

Currently, the plugin only supports working in nopCommerce, so changes will be written to PostNord and the responses will be used to update nopCommerce. But the plugin doesn't support syncing data to nopCommerce when working in the PostNord portal. (with one exception: when marking a shipment that already has been booked in PostNord as sent in nopCommerce, its trackingIds and trackingUrls will be retrieved from PostNord and set to the shipment in nopCommerce)