(cette documentation est également disponible en français)

A Prestashop module that provides an interface to the web services provided by MY FLYING BOX (company registered in France, see http://www.myflyingbox.com).

This module provides two distinct sets of features :

• order shipments through the MY FLYING BOX API via a dedicated back-office interface
• automatically calculate transportation costs when a customer check out its cart

To use this module, you need the following:

• a Prestashop 1.7+ instance up and running
• php-curl module activated on the server
• an active LCE account and API keys

Please note that the module is not compatible with Prestashop versions before 1.7. It was developed and tested on Prestashop 1.7 with php 7.4, Prestashop 8 with PHP 8.1 and Prestashop 9 with PHP 8.4.

Go to the /modules directory of your prestashop instance (replace PS_ROOT_DIR by the PATH to your prestashop instance):

cd PS_ROOT_DIR/modules

Get the code by cloning the github repository (note: the module directory name MUST be lowcostexpress):

git clone --recursive https://github.com/lce/prestashop-lce.git lowcostexpress

One of the module libs (php-lce) has dependencies of its own, which you must initialize with 'composer':

cd lowcostexpress/lib/php-lce
curl -s http://getcomposer.org/installer | php
php composer.phar install

If you are running the module on a PHP version before 8.0, do the same with the legacy version of the library:

cd lowcostexpress/lib/php-lce-0.0.3
curl -s http://getcomposer.org/installer | php
php composer.phar install

Go to the list of releases and download the latest package. You can then upload the file as-is in your Prestashop's module manager.

Go to prestashop's module management page, and install the lowcostexpress module, which should be listed.

The following settings can be fine-tuned on the module's configuration page:

• MY FLYING BOX API ID and password
• MY FLYING BOX API environment to use (staging or production)

• Default shipper information
• Calculation rules for automatic transport cost evaluation during cart check-out. Be especially careful when specifying a correspondance between weight and package dimensions: the module cannot guess the final packing dimensions for a given cart, so it will only base its calculation on the total weight of the cart and the correspondance rules you define on the module configuration.

If you want your customers to be able to select an LCE carrier (with automatic price calculation), you must initialize a set of carriers (in the sense of 'prestashop carriers') based on LCE transport products. The configuration page allows you to automatically initialize/update the list of carriers available for a given country of departure.

Please note that you do not need to initialize carriers if you only want to use the back-office features of the LCE module. Whenever you request offers for your shipment, all available offers will be returned anyway.

When a customer proceeds to cart checkout, transportation offers will be dynamically proposed based on MY FLYING BOX API calls and the calculation settings you have specificed on the module configuration page.

The customer can then select these offers, and will be invoiced the calculated amount.

When an order is shipped through an LCE carrier (in the back-office, regardless of whether or not the customer has selected a LCE carrier when proceeding to check-out), real-time tracking information for each package is available on the order details page.

On the back-office page of an order, a new area 'LCE shipments' will be displayed. From there, you can initiate a new shipment.

LCE shipments have their own page, on which you can:

• change/correct departure and delivery addresses;
• specify the pack-list, with detailed dimensions, weight, customs information and references;

• obtain transportation offers from the MY FLYING BOX API, with price and conditions;
• order a transportation offer from the MY FLYING BOX API;

• download labels provided by the carrier, to apply on packages before pickup/dropoff;
• track the progress of the shipment.

This module is maintained directly by the developers of the MY FLYING BOX API. You can contact us at [email protected] if you need any help using or setting up the module on your prestashop instance.