You can integrate Shippit to your Magento store by adding an extension.
Need assistance in implementing your integration? Connect with your account manager, sales contact, or visit our website to avail professional services today!
You may also review this full detail guide divided into the following sections:
Integration Process
Configuration Options
Frequently Asked Questions
Integration Process
Install Through Magento Marketplace
The first option in installing the Shippit extension is by downloading it through the Magento Marketplace.
Login to your Shippit store
Go to Settings > Integrations and select Magento
On the new page, select Your Store Version and click Add to Cart
Complete the checkout process
On the new page, click Install and take new of your Access Keys
Follow the instruction document to complete the installation process
Install Through GitHub
You may also install the extension by downloading it through GitHub. If you have already completed the installation process outlined above, you may skip this portion and proceed to Enter API Key.
This method of installation should be completed by a developer or someone comfortable with working with the Magento Application Structure. PLease test in a staging/test environment before applying in your live/production environment.
Go to the Shippit extension for Magento2 in GitHub
Click on Clone or Download and select Download ZIP
In the magento installation, create a folder path of app/code/Shippit/Shipping
Move the contents of the extension to app/code/Shippit/Shipping
On the server and in the Magento installation directory, run the command php bin/magento setup:upgrade
If required, run the production di compilation and static asset compilation
Enter the API Key
To complete the installation, you need to enter the API Key from Shippit into Magento.
In Magento, click on System on the navigation menu
Select Configuration and on the new page under Sales click Shippit
Copy the API Key from your Shippit store
Back in Magento, paste it on the the the API Key field
Click on Save Config
The example captured above is set at the Shippit staging environment. If you are setting up your live/production environment, make sure that the Environment dropdown is set to Live.
If you do not see your API Key populated in Shippit, click on the downward arrow at the upper right portion of the screen, click on Billing Details, and enter your Credit Card information.
CHECK your integration by ensuring you now have a Webhook URL. If you do not see the Webhook URL field populated, email us right away at [email protected]
Configuration Options
Live Quotes
Live Quotes allow you to provide customers with real-time shipping quotes at the cart page and during check out. Go to Stores > Configuration > Sales > Shipping Methods > Shippit - Live Quotes to access your configuration options.
Enabled - if enabled, your customers will see the cost of each shipping option per service class upon checkout
Title - identify how this shipping method will be shown
Allowed Methods - identify the service classes (Standard, Express, or Priority) that you want to allow
Margin Enabled - allows you to apply a maximum amount to the shipping rates that customers see by subsidising what is in excess
Margin Amount - if you enabled the previous setting, indicate the maximum amount here
Maximum Time Slots - identify a limit to the number of timeslots displayed for the Priority service class
Filter by Enabled Products - allows you to filter orders by product for items that are available for shipping via Shippit
Filter by Product Attribute - allows you to filter orders by product attribute for items that are available for shipping via Shippit
Ship to Applicable Countries - select whether or not restrictions are placed on the countries your customers can ship to
Ship to Specific Countries - if you choose Specific Countries in the previous option, you need to identify those countries here
Sort Order - choose how you would like the Live Quotes to appear in the order with all other shipping methods
Checkout Options
In your Magento admin page, go to Stores > Configuration > Sales > Shippit > Checkout Options to configure the checkout options related to shipping.
Display Authority to Leave - allows you to provide your customers an option to grant the courier an Authority to Leave for the order; this information will be sent to Shippit and the involved courier
Display Delivery Instructions - allows you provide a field where customers can enter delivery instructions; this information will be sent to Shippit and the involved courier
Order Sync
This set of options can be found in your Magento admin page. Just go to Stores > Configuration > Sales > Shippit > Order Sync.
Enabled - allows you to enable or disable your Magento orders from being automatically pulled across into Shippit
Manual Sync Enabled - this option will add action buttons on the order and order list so you can send an order to Shippit whenever you want, even if that order has been automatically sent already
Order Status Filtering - allows to choose the order's status at which it should be pulled across into Shippit
Order Statuses - if the above option is set to Yes, you need to identify the order status here
Sync Mode - if the first option is set to Yes, this option allows to choose the frequency of the order synchronisation
Realtime- new orders that are marked as paid will sync immediately
Scheduled - new orders using the Magento Scheduler (cron) will sync every 5 minutes
Custom - this option is equivalent to Scheduled but is used for custom integrations; it simply prevents orders from automatically being synced
Send All Orders To Shippit - if this option is set to No, only orders that use (1) live quotes and (2) shipping methods that are mapped (see section below) will be pulled across into Shippit.
Shipping Method Mapping
You can map the shipping methods you set-up in Magento to a specific service class (Standard, Express or Priority) in Shippit.
For example: if you have a shipping method called Free Shipping you can map it to the cheapest courier you know so that you can manage costs.
To a create a shipping method map:
Click on Add Mapping
Select the shipping method in Magento from the first drop down
Then select the Shippit service class you would like to map it to on the corresponding dropdown
Click on Save Config to update your settings
Remember that you can only map to service classes where you have active couriers. This means that if you are mapping to the Express service class, you must have an Express courier activated in Shippit.
If you map to the Priority service class, Shippit will book the order for the next available time slot so make sure that you keep an eye on priority orders that come in.
Shippit Orders Queue
Orders that are in the Processing status and have shippable stock are sent to the Shippit Orders queue in Magento before they are actually sent to Shippit. You can access this in the Magento admin page by hovering over to the left navigation pane and then click Sales > Shippit > Orders.
Filter the list through the open fields under the column label then, click on Search
Force sync an order by expanding the Action dropdown then, choose Sync Now
Items Sync
Configure how additional order details are synchronised from Magento to Shippit. Just go to your Magento admin page and click Stores > Configuration > Sales > Shippit > Items Sync.
Product Weight Unit - the unit of measurement used for product weight
Send Product Dimensions - If this is enabled, the length, width, and height of the order will also be sent to Shippit apart from the weight that is sent by default.
If the product dimensions in Magento are the box/package dimensions already and you will no longer package it differently for shipping, you may turn off all of the the preset and custom package types in Shippit and enable Send Product Dimensions.
This will stop Shippit from allocating the order to a package type. All your orders will be assigned to Parcel with weight and package dimension sourced from Magento.
Product Dimensions Unit - specify the unit of measurement used for the product dimensions
Product Length Attribute Code - identify the product attribute to be used for length data
Product Width Attribute Code - identify the product attribute to be used for width data
Product Depth Attribute Code - identify the product attribute to be used for depth data
Send Product Location - allows you to also sync the product stock location in Magento to Shippit; this information appears in the pick slip downloadable from the Shippit New Orders tab
Product Location Attribute Code - identify the product attribute to be used for location information on the pick slip in Shippit
Send Product Tariff Codes to Shippit - allows you to also sync the product tariff codes to Shippit
Product Location Attribute Code - identify the the product attribute to be used for tariff code information sent to Shippit
Send Product Country Of Origin to Shippit - allows you to also sync the product's country of origin in Magento to Shippit
Product Country of Origin Attribute Code - identify the Product Attribute to be used for country of origin information sent to Shippit
Shipping Sync
Shipping Sync allows you to configure how you would like to synchronise your orders' shipment status from Shippit to Magento through the following options:
Enabled - if set to Yes, Shippit will update all tracking information on the order in your shopping cart
Update Shipping Template - if set to Yes, this will allow the creation of a shipment record (containing recipient, product, and delivery information) against the sales order in Magento
Shippit Shipments Queue
When orders are booked in Shippit, it will create a shipment record in the Shippit Shipments queue in Magento before the status is actually updated. You can access this in the Magento admin page by hovering over to the left navigation pane and then click Sales > Shippit > Shipments.
Filter the list through the open fields under the column label then, click on Search
Force sync an order by expanding the Action dropdown then, choose Sync Now
TEST your configuration by creating a dummy order in Magento2 based on the different order sync criteria you have identified here. If you encounter any challenges, email us right away at [email protected]
Frequently Asked Questions
Why isn’t my order appearing in Shippit?
This could be due to one of the following:
Check your API key and the environment is pointing to the correct instance.
Check the status of the order. If processing, then it should be appearing in Shippit.
Check to see if your Magento cron jobs are enabled.
Why am I not receiving tracking updates for the orders I have booked through Shippit?
Check your Shippit Shipping Sync in Magento to see if they are enabled. If it is, check your Shippit Webhook URL in Shippit. If empty, re-register your Webhook by disabling Shipping Sync in Magento, and then re-enabling.
Why didn’t my order sync to Shippit?
This could be due to:
Check the user and delivery address details of the order are correct.
Confirm you have the appropriate carriers enabled in Shippit e.g. international carriers.
If I delete or modify an order in Shippit, will it delete/update in Magento?
No.
How do I connect multiple Shippit accounts with Magento?
You can take advantage of Magento’s Store View configuration to route the order to the correct Shippit store though the stores' API key.
Go to Stores > Configuration > Store View and select a store you want to configure
Click on Sales > Shippit > General Settings
Uncheck the API Key Use Default checkbox
Enter API Key of the Shippit store you want to match to the Magento store
How can I resend an order to Shippit?
You can do this in the Magento admin page through one of three ways:
Click on Sales > Orders > Click an order > Click Send to Shippit
Click on Sales > Orders > Tick the orders you want to resend > On the Actions dropdown, select Sync with Shippit
Click on Sales > Shippit Order Sync > On the Actions dropdown > Select Sync Now
Take note that the last option will override the previously assigned tracking number.
How do I install the matrix rate app?
In order to set up the matrix rate app, first install these two modules:
Shippit module for Magento
Extra add-on module for Shippit Matrixates app compatibility
Once these two modules have been correctly installed, please navigate to System > Configuration > Sales > Shippit > Shipping Method Mapping.
If you have uploaded your matrix rates correctly, they should appear in the dropdown list as "Matrix Rates - Magento-WebShopAppsMatrixRates”.
If you update your Matrix Rates methods, you will need to re-map them to a Shippit service class as the previous methods become obsolete.
Can I live quote on international orders within the Shopping Cart?
Unfortunately, not.
Magento Tips
You can customise how you send orders to Shippit! By default, all orders and shippable products sync with Shippit as soon as the order moves to the “processed” state; however, you can override this functionality and create a custom integration in order to dictate what should be sent to Shippit and when.
There are two ways you can do this:
Event Listener (recommended) - enables you to trigger orders to be sent to Shippit based on business requirements, all while simplifying the details you need to send to Shippit/the Shippit module. It would allow you to determine when, and under what conditions, an order should be sent to Shippit, including whether all or only some items are to be sent to Shippit.
This can be activated by setting the order sync mode to “Custom” and then developing the logic/conditions on your end to hook into the “Shippit Add Order” event when those conditions are met. A good example is choosing not to sync pre-orders with Shippit, or, at the very least, filter out products in a sales order that contain a pre-order identifier.
An order will flow in and go through the regular order processing cycle with the exception that when the “shippit_add_order” event is called, they can either specify to have the entire order or part of the sales order synced with Shippit.
Modal API - once the logic to filter out pre-order products in an order has been implemented, you can then send that order and the product details directly to the Shippit module calling the modal API (outlined in the documentation). Once those order details have been passed through, the order should sync with Shippit and appear in the New Orders page.
Both methods will still add the order to the Sales > Shippit > Orders queue before being processed via the order sync cron job.
You can apply a negative margin amount to the cost of freight, if you have enabled this in your Shippit - Live Quotes settings.
Customise your Magento2 order fulfilment notification email by hyperlinking the tracking number to easily follow your order via the Shippit tracking page (note: minor development is required).
Please take note that some changes have been made to older versions of Magento software. Check here to check if this impacts you.