Laravel Marketplace Aramex Shipping

• Admin will enter account country name and account PIN.
• Enable or disable Aramex shipping on checkout.
• Enable or disable Aramex testing.
• Select specific or all channels to enable Aramex shipping.
• Select specific or all countries to enable Aramex shipping.
• Enable or disable COD service for Aramex
• Admin can specify the weight class (Kilograms, Pounds).
• Easy to configure and manage at admin end.
• The codes are open to being further customized easily.
• Works for Both Domestic & International.

Customers will get a zip folder and they have to extract the contents of this zip folder on their system. The extracted folder has the packages folder inside AramexCore folder. You need to transfer this packages folder into the Bagisto root directory on the server as shown below.

Goto config/app.php file and add the following line under ‘providers’

Webkul\Aramex\Providers\AramexServiceProvider::class

Goto composer.json file and add the following line under ‘psr-4’

"Webkul\\Aramex\\": "packages/Webkul/Aramex"

Run the below commands below to complete the setup

composer dump-autoload

That’s it, now just execute the project on your specified domain or entry point.

After the successful installation of the module, the admin will have to configure the module. Go to Configure icon which is there on the left-hand side menu bar.

Next, in the Sales section, go to Shipping.

Within the Configuration option, at first, you need to define the Origin address. This address will be used in the calculation of Shipment.

Next, you need to configure Aramex Settings. Below is the field information that you need to provide:

• Enable On Checkout: To enable/disable Aramex shipping during checkout, you can simply enable/disable this option based on your preference.
• Sandboxing (Testing): Enabling this field uses Aramex test account otherwise you need to use the account as provided from Aramex. All account information related fields are below. If you disable this option, you will only be allowed to use your live credentials only.
• Weight Unit: Here you can provide the weight units as you need in Aramex. The options available here are kilograms and pounds.
• Enable COD Service: It will allow Aramex to collect cash on your behalf from your customers.
• Ship To Countries: List of all the countries in the world, the Aramex API later verifies if it serves in that country.
• Ship To: If option ‘Specified Countries’ is selected then it will only allow Aramex for countries selected in above field Ship To Countries.
• Ship To Channels: List all the channels, for selecting which channel will get used with Aramex.
• Ship To Applicable Channel: If option ‘Specified Channels’ is selected then channels select in the above field Ship To Channels(Multiselect box) will be enabled for Aramex. if option ‘All Channels’ is selected then all channels will be allowed for Aramex.
• Aramex Account Country Code: Here you need to provide the two-letter code identifying your respective country.
• Account Entity: This is the account identification code by the transmitting party as provided to you by Aramex.
• Account Number: Here you need to provide your Aramex customer account number as provided when the contract is signed.
• Username: Provide username of your Aramex customer’s account.
• Password: Provide password of your Aramex customer’s account.
• Account Pin: Here a key has to be provided that is associated with your Aramex account to validate your identity.
• Allowed Domestic Methods: Here you will find the list of services of shipping parcels to the domestic region as offered by Aramex. You can select the service based on your preference.
• Allowed International Methods: Here you will find the list of services of shipping parcels to the international region as offered by Aramex. You can select the service based on your preference.

Note: To test this module use these test credentials of Aramex:
~~~
‘AccountCountryCode’ => ‘IN’,
‘AccountEntity’ => ‘AMM’,
‘AccountNumber’ => ‘20016’,
‘AccountPin’ => ‘331421’,
‘UserName’ => ‘testingapi@aramex.com’,
‘Password’ => ‘R123456789$r’,
‘Version’ => ‘v1.0’
~~~

After the setup of the Laravel Aramex Shipping method, the customer can easily use this shipping method for their purchases.

When any customer adds the product to cart then there will be an option in Billing Address to fill up the zip/postal code as below.

*Note: Make sure to fill the valid zip code and address of the respective country you have chosen as they are checked by the Aramex Shipping Module in that stage(in case of invalid parameters in the zip code, Aramex shipping option will not be visible in the later stage)

Next, the shipping method will be displayed like this and with the cost of shipping.

Next, choosing the Aramex Shipping option, you will be asked for Payment Information in the later stage.

You can choose your preferred payment method and move on to complete your order.

Once you have reviewed the order for the details you can place the order by clicking Place Order button.