Back to Top

SMSA Shipping for Magento 2

Updated 26 March 2024

SMSA Shipping for Magento 2 is one of the best service providers in the courier industry which makes it the most cost-effective, diverse express, freight, outbound, and inbound shipping services available.

SMSA endeavors to meet the needs of citizens and businesses for domestic and international parcel delivery. The origin of delivery should be Saudi Arabia or the United Arab Emirates.

From these origins, the product can be delivered to all the allowed countries by admin.

For Magento 2, we have created an add-on called SMSA Shipping for Magento 2. By installing this module, the admin will be able to provide the SMSA Shipping method to the customers for shipping the goods.

Also, the admin can even generate shipping labels and can set tracking numbers to improve business efficiency.

Searching for an experienced
Magento 2 Company ?
Find out More

Note- The maximum weight which is allowed to ship by SMSA Express Shipping is 35 kg.

Check the brief overview of the plugin –


  • It will allow the admin to enable or disable the SMSA Shipping module.
  • The admin can set the rate according to the weight.
  • Admin can create a shipping label.
  • Shipping will be calculated by using the weight cost set by the admin.
  • Admin can set specific countries for shipping.
  • The admin can add the methods allowed for shipping.
  • Facilitates the admin to set adding price for per kg in case of shipment with weight more than 15 kg.

Note: It is required to enter the weight of the product which is to be shipped.


The installation is quite simple just like the standard Magento 2 extensions.

#1 Download Module

Firstly, you need to log in to the Webkul Store, go to My Account>My Purchased Products section, verify, and then download and extract the contents of this zip folder on the system.

#2 Upload Folder

Customers will get one zip folder and they have to extract the contents of the zip folder on their system.

Also, the extracted folder will have an src folder, inside the src folder you have the app folder. 

Then, You need to transfer this app folder into the Magento2 root directory on the server as shown below.


After the successful installation, you have to run these commands in the Magento2 root directory:

#3 Run Commands

After uploading the module folder, you need to run the following commands in the Magento 2 root directory:

  • php bin/magento setup:upgrade
  • php bin/magento setup:di:compile
  • php bin/magento setup:static-content:deploy

Install Extension from Magento Marketplace

If you have purchased this extension from the Magento Marketplace then please follow the below process or visit this link.

#1 Get Access Keys

You need to get access keys, navigate to My Profile in Magento Marketplace, then choose Access Keys in the My Products section.


Go to Magento 2 and then you need to copy both the Access Keys – Public Key and Private Key. These access keys will be needed in the next steps for authentication.


If access keys are not created earlier, click Create A New Access Key, enter any name and click OK.


#2 Update composer.json File

To know the component name and version number, go to your Magento Marketplace account section, My Profile>My Purchases, then find this extension to view the details. Please note – Below is an example image, every extension will have its unique component name and version.


After that, navigate to your Magento project directory and update your composer.json file in the following format.

composer require <component-name>:<version>

For example, to install version 4.0.1 of this extension you need to run the following command:

composer require webkul/smsa-shipping:4.0.1

#3 Enter Access Keys

Now you will need to enter the Access Keys that you obtained as explained in the first step #1 Get Access Keys. Wait for Composer to finish updating your project dependencies and make sure there aren’t any errors.

#4 Run Command

You need to run the following commands:

  • php bin/magento setup:upgrade
  • php bin/magento setup:di:compile
  • php bin/magento setup:static-content:deploy
  • php bin/magento indexer:reindex
  • php bin/magento cache:clear

So, post running the commands, you have to flush the cache from the Magento admin panel by navigating through->System->Cache management.

Installation Of  Shipping

SMSA Shipping – Account and Pricing Details

Thus, for the merchant to add the SMSA Express Shipping service to the website, they must have their account at the SMSA end from here.

However, the only fee required here is for shipping the order to the customer. Thus, here the cost depends on the weight cost, set by the admin or vendors between the source(merchant address) and destination(customer address).

To see the respective cost details the merchant can check the same here- SMSA Shipping Rates.

Multilingual Support

For multilingual support, the admin will navigate through Store->Configuration->General ->Locale Options. Henceforth, select the locale as German (the language into which the admin wants to translate his store content).

Google-Translate-lang1- SMSA Shipping for Magento 2

Module Translation

If a user wants to translate their module from English to German. Henceforth, they need to follow the path app/code/Webkul/SMSA/i18n in their unzipped Magento2 SMSA folder. Therein one can get a CSV file with the name “en_US.csv”.

Now they will rename that CSV as “de_DE.csv” and translate all right side content after the comma in the German language.

So, after editing the CSV, save it and then upload it to the path app/code/Webkul/SMSA/i18n where they have installed Magento2 on the server. So, the module will get translated into the German Language. It supports both RTL and LTR languages.

Shipping Translation-
Shipping Translation- SMSA Shipping for Magento 2

Thus, the user can edit the CSV like the image below.

 Shipping Translation

Admin Configuration

After the successful installation of the module, the admin will have to configure the module. Hence, the admin will have to fill in all the details for the proper functioning of the module else it might not work.

Also, the admin is required to get the Pass Key from the SMSA customer account.

So, the admin has to fill in all the details by navigating to Store> Configuration> Sales> Delivery Methods.

SMSA Shipping- SMSA Shipping for Magento 2
  • Enable- Here, the admin can enable or disable the module.
  • Title- The admin can give the title to be displayed on the customer side.
  • Method Name- The admin can customize the method name as per the choice.
  • Sandbox Mode- Here, the admin can enable/disable sandbox mode.
  • Pass Key- The admin has to write Pass Key.
  • Price for first 15 kg- The admin can set the price for the first 15 kg.
  • Price for Additional per Kg- Additional charges can be set by admin, above 15 kg.
  • Ship to Applicable countries- The admin can set applicable countries to avail of this service.
  • Ship to Specific Countries- The admin can select specific countries.
  • Sort Order- Here, the admin can set the sort order to display.
  • Show Method if Not Applicable- The admin can set the method to be displayed even if it is not applicable.
  • Display Error Message- Here, the admin can customize the error message as per the choice.

Note: The admin has to put the Pass Key as it is a required field.


Store Information

So, the admin can add the store information by navigating to Store> Configuration.

admin configuration- SMSA Shipping for Magento 2

Here, from the General tab, the admin can click on General to fill in the Store Information. Thus, post filling the Store information click on the Save Config to save the details.

Store Information- SMSA Shipping for Magento 2

Here, the admin can-

  • Enter the Store Name
  • Add the phone number of the store
  • Provide the details for the operation hours of the store
  • Enter the country of the store
  • Enter the Region/ state of the store
  • Input the Zip/ Postal code of the store
  • City of the store
  • Store street address
  • Enter the street address line 2 of the store
  • VAT number of the store.

Hence by entering and making selections for all the fields in the configuration settings for this module, the module is all set to be used by the customers.

Shipping Origin

The admin can set Shipping Origin by navigating to Stores>Configuration>Sales>Shipping Settings

Origin- SMSA Shipping for Magento 2

Here, the admin can set Origin details.

Customer View

After the setup, the customer can easily use this shipping method for their purchases.

Thus, when any buyer adds the product to the cart then there will be an option to fill up the zip/postal code. Henceforth, then shipping methods and prices will be displayed on the cart page like this screenshot.

Shopping Cart- SMSA Shipping for Magento 2

After clicking on the “Proceed to checkout” the customer will be redirected to the checkout page, here the customer will have to select the shipping method for their purchases.

Shipping Address- SMSA Shipping for Magento 2

After selecting the SMSA Shipping method customer will click next to select the payment method and review the order. Thus, on the order review page, the shipping method will be displayed like this and with the cost of shipping.

By clicking on place order the order will be placed.

Payment method- SMSA Shipping for Magento 2

Admin Order Management

Now the Admin views the order from “Sales > Order” and the admin can generate invoices for the ordered products, generate shipment for the order of the products.

However,  the admin can notify the customers by sending them emails, cancel/hold the order, and even edit/reorder the product order.

order Information- SMSA Shipping for Magento 2


After viewing the order the admin will create the Invoice for the order. However, the invoice post creation is visible in the invoices section of the side panel.

Here, the invoice will contain all the shipping information and the cost of shipping for that particular order.

Invoice-SMSA Shipping for Magento 2

After creating the Invoice, the admin will create the shipping for the order. So, you can refer to the below screenshot to understand it in a better way.

Order detail SMSA Shipping for Magento 2

The admin post submission of the shipping can click on the Shipment Option. Here the admin can Track the shipment, Create shipping Label, Print Shipping Label, and Show Package. So, the admin can even Send the tacking details to customers from here.

Create Shipping Label

The admin click on this option to open a window to enter the packaging.

Shipping label SMSA Shipping for Magento 2

Thus, in this, the admin will add the following details-

  • Type– Here the admin will specify if the Package is the document type of or not.
  • Total Weight– The weight of the package is written here.
  • The admin will mention the dimension of the product in length, width, and height.

Then the admin can click on the ‘Add selected Product(s) to Package’, which will enable a list of products. The admin can select a product as per choice and click on the Save button.

Remember the Save button here will enable only when to Add the selected product(s) to Package is enabled.

Print Shipping Label

The admin can print the SMSA Shipping label as shown below in the screenshot.

labels SMSA Shipping for Magento 2

That’s all for the SMSA Shipping for Magento 2 still have any issue feel free to add a ticket and let us know your views to make the module better

Current Product Version - 4.0.4-p1

Supported Framework Version - Magento 2.0.x, 2.1.x, 2.2.x,2.3.x, 2.4.x

. . .

Leave a Comment

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

Be the first to comment.

Back to Top

Message Sent!

If you have more details or questions, you can reply to the received confirmation email.

Back to Home

Table of Content