GitHub Magento 2.x Module Installation Guide

GitHub Magento 2.x Module - front titel

Module functionality:

– Parcel delivery service to Smartposti parcel shop pickup points (hereinafter referred to as “parcel shop“) located in Finland, Lithuania, Latvia, Estonia;
– Parcel delivery by a courier within the European Union;
– Parcel collection from Smartposti parcel shops in Lithuania;
– It is possible to print out either parcel labels and manifest from the e-shop’s administrative environment;
– It is possible, from the administrative e-shop environment, to call a courier for parcel collection;
– COD (cash on delivery service).

Server requirements

The module is compatible with 7.0 and higher PHP versions. Before installing the module it is important to find out whether 7.0 or higher PHP version is installed in the server.

Installation procedure

Before installing the Smartposti Shipping module make sure you have the login credentials (username and password) for the Smartposti API.

Installing the Smartposti Shipping module

When the Smartposti Shipping module is extracted it needs to be loaded into magento root directory. You need to connect to the server using SSH access. This can be done by going to the root folder and running such commands:
composer require mijora/itella-api
rm -rf pub/media/catalog/product/cache/*
rm -rf var/cache/*
php bin/magento setup:upgrade php -d memory_limit=2G
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy –language lt_LT
php bin/magento setup:static-content:deploy –language en_US
php bin/magento indexer:reindex
php bin/magento cache:flush

GitHub Magento 2.x Module - commands

To perform basic Smartposti Shipping module settings go to Stores -> Configuration. On the left side of the menu find the block named Sales and then select the item named Shipping Methods. In newer versions of the system, this item is called Delivery Methods.

GitHub Magento 2.x Module - Shipping Methods

On the page that opens, the Smartposti Shipping section will be visible, which contains all the module settings:

GitHub Magento 2.x Module - module settings
GitHub Magento 2.x Module - module settings

Note: There are two API users because the product of the courier and pickup point may be given by different users.

GitHub Magento 2.x Module - Company details page GitHub Magento 2.x Module - Company details page

GitHub Magento 2.x Module - Courier shipping details page
GitHub Magento 2.x Module - Courier shipping details page

GitHub Magento 2.x Module - Methods
GitHub Magento 2.x Module - Methods
GitHub Magento 2.x Module - Methods

When the required information is entered click the button named Save Config in the upper right corner.

GitHub Magento 2.x Module - Save Config

COD (cash on delivery)

Smartposti Shipping module is compatible with Magento COD module. To enable COD you need to select Stores -> Configuration -> Sales -> Payment methods

GitHub Magento 2.x Module - Payment methods

Then find Cash On Delivery Payment select it and enter the following information:

GitHub Magento 2.x Module - Cash On Delivery Payment

GitHub Magento 2.x Module - Cash On Delivery Payment
GitHub Magento 2.x Module - Cash On Delivery Payment
GitHub Magento 2.x Module - Cash On Delivery Payment

When the required information is entered click the button named Save Config in the upper right corner.
GitHub Magento 2.x Module - Save Config

Manifest generation part

In order to generate all available order labels and manifest select Sales → Smartposti shipping in the system window.

GitHub Magento 2.x Module - Sales to Smartposti shipping

In the opened window the history of all orders with the dates of each of them will be seen. Each order can be printed separately (when the specific order is marked with a tick) or printed all at once.

GitHub Magento 2.x Module - Smartposti Manifest

To print all labels at once click Print labels button at the bottom of the window.
Alternatively, in order to print the daily manifest select the button named Generate manifest.

GitHub Magento 2.x Module - Generate manifest

Note: the courier is called automatically so all that remains is to print the labels and manifest.

Order information part

To view all available orders select Sales -> Orders. The order list can be sorted, filtered as well as the required orders can be found. Also, other specific actions can be applied to selected orders while using standard controls.

GitHub Magento 2.x Module - Order information part

Can view existing orders and create new ones. The tabs above the pagination button are for filtering the order list, changing the default image, changing or rearranging columns and exporting data as CSV or Excel files.

GitHub Magento 2.x Module - order list

You can select one order at a time in the order table or all at once by choosing the Select All option in the selection control on the column header. Also, marked orders can be deselected as well.GitHub Magento 2.x Module - Select All option

Action – Press View to view the order in edit mode.
GitHub Magento 2.x Module - order View

If the order is formed by choosing a courier, when selecting the order view will see section named Smartposti courier services with optional additional service fields. A charge will be applied for each additional service.

Additional services:
– Cash On Delivery – the payment only available by credit card
– Multi Parcel – also need to specify how many shipments there will be
– Fragile
– Call before Delivery
– Oversized

GitHub Magento 2.x Module - Smartposti courier service

At the same time, the order review is segregated into the following sections:
GitHub Magento 2.x Module - order review

GitHub Magento 2.x Module - order review

 

Documents / Resources

GitHub Magento 2.x Module [pdf] Installation Guide
2.x, 23en, Magento 2.x Module, 2.x Module, Module

References

Leave a comment

Your email address will not be published. Required fields are marked *