Installation & Configuration of the PrestaShop Module

After downloading, open the module manager in your PrestaShop back-office and click on the "Install a module" button. Select the file you previously downloaded.

The module will install automatically.

Then click on the "Configure" button to proceed to the next step.

Configure General Settings

Click on the "Configure" button in the module manager to open the general configuration page. The form includes comprehensive explanations for each field, take the time to read them.

Firstly, you must enter your login details, which you can find on your My Flying Box client account (https://dashboard.myflyingbox.com/en/registrations/new) under Tools -> API -> "Accounts" tab.

Also, enter your default shipping address and then click on the "Save" button.

If the connection could not be established, an error message will display. Ensure the information entered and the selected environment are correct. If the environment you selected is not activated for your account, please contact our customer service.

If the connection has been established, continue with the configuration.

• Price Calculation Options

There are numerous strategies for calculating shipping costs. You may want a dynamic pricing that closely reflects reality, or you might prefer to present a flat rate or even include shipping costs in the price of your products.

To maintain maximum flexibility, the module uses standard "carriers" mechanisms native to PrestaShop. By default, a carrier associated with the My Flying Box module will use dynamic pricing, calculated by the module with a request to our web service to present an up-to-date rate. If you wish to use static pricing, you can simply use the native PrestaShop mechanisms on the carrier configuration page (see below).

When you allow the module to dynamically determine the shipping rate based on the cart, you can finely control the calculation modalities.

Some options allow for the modification of the calculated price (percentage surcharge, absolute surcharge, rounding, optional insurance), while other options affect how the module attempts to determine virtual packaging for the considered cart (for any price calculation, we need precise packaging information).

Thus, you can indicate to the module that each virtual package must never exceed a certain weight (real or volumetric), which will force a multi-package calculation if the total cart weight exceeds the limit you have set.

The option "Force the use of the weight/dimensions correlation table" compels the module to ignore the dimensions of the items in the cart, and to use only the weight of the items to calculate the dimensions of the packages, based on a weight/dimensions correlation defined by yourself.

• Default Dimensions

The weight/dimensions correlation table allows you to specify a correlation between a weight range and a package size. For example, if you sell wine bottles in 3 standard packaging (1 bottle, 3 bottles, 6 bottles), you can populate this table based on three weight limits: up to 2kg (1 bottle + packaging weight), up to 5kg (3 bottles + packaging weight), up to 10kg (weight of 6 bottles + packaging weight).

Note that if your product catalog includes the dimensions of products in addition to their weight, the module initially attempts to simulate a virtual package by stacking the products flat, unless you check the option "Force the use of the weight/dimensions correlation table."

• List of Shipping Services

Under the heading "List of Products" on the configuration page, you will find the list of shipping services initialized by the module. This list is automatically synchronized from our web service when the connection between the module and your My Flying Box account is established.

You can force a manual synchronization if you notice that some services are presented via our web interface and are not present on the module.

For each service, the module creates a PrestaShop carrier. Thus, when you open the PrestaShop configuration page "Shipping" -> "Carriers", you will find the carriers initialized by the module.

Configure Carriers

When the connection to our web service is properly established, the module initializes a list of carriers in PrestaShop, each carrier corresponding to a transport service supported by My Flying Box.

By default, carriers are disabled. You can choose which carriers to offer to your clients and activate them on demand.

Some carriers may have the same name, as they correspond to the same service but with different options (on-site pickup or drop-off, relay delivery, etc.). These characteristics are visible on the list of services presented at the bottom of the module's configuration page, along with the PrestaShop carrier ID. To determine the right carrier to activate, start by identifying the service that interests you on the module's configuration page, then note the carrier ID; use this ID to identify the correct carrier in the list of carriers on the Shipping -> Carriers page.

• Static Pricing
  

If you wish to precisely control the rate offered to your clients, you can use the standard mechanisms of PrestaShop to determine a statically defined price grid.

When at least one static rule is defined for a transport linked to the My Flying Box module, the module deactivates dynamic mechanisms and returns the rate generated by the native PrestaShop mechanisms.

Testing Rate Calculation

When you have completed the configuration, the best way to test the operation of the rate rules is to switch the module to the 'production' environment (be sure to specify the correct password) and make an order simulation.

If all goes well, when choosing the delivery options, you should see the carriers that you have configured and activated.

• Web Dashboard Analysis
  

When the module is configured with the production environment, the rate requests sent to the web service are viewable via the web interface of your client account (https://dashboard.myflyingbox.com/en/registrations/new) under Tools -> API -> "Quotes" tab.

During your order tests, you can thus analyze in real time the requests sent by the module. By observing the dimensions of the virtual packaging determined by the module as well as the list of returned services and their prices, you can identify any configuration issues and make informed adjustments to achieve the desired result.

• Registering a Shipment
  

The first step in generating a label is to initialize a My Flying Box shipment: open the order you wish to ship, then look for the "MY FLYING BOX Shipments" section. Click on the "Add a shipment" link.

A new draft status shipment will be created. The data is pre-filled according to the following mechanisms:

• delivery address: address provided by the client during the order
• shipping address: address entered in the module configuration options
• packaging: the rules defined in the module options are used (weight/dimensions correlation table, maximum weight per package) to determine the distribution of items in virtual packages; the value of each package is calculated based on the distribution determined by the module; the merchandise description corresponds to the value entered in the module options.
• insurance: checked automatically if you have activated this option in the configuration of the module.

As long as you have not generated a label, you can modify all the data of the shipment, to ensure that they correspond accurately to reality. Be particularly attentive to the packaging (weight and dimensions), as a discrepancy with reality may result in an initial overcharge, a subsequent re-billing, or blockages with the carrier.

Any modification of the shipment data triggers a new calculation of transport rates. This operation can take a few seconds.

• Selecting a Transport Service
  

If the client had chosen a carrier linked to the module, the corresponding service will be automatically selected. However, you still have access to all services available for this shipment. By clicking on the 'search for a transport offer' link, you have access to the complete list and can thus select another service.

If no service is presented, the most probable causes are:

• • • incorrect data at the level of the shipment (re-check the departure and destination addresses, ensure that all packaging data is entered and consistent)
    • a problem with the module's communication with our web service (check your identifiers, check the status of your account via our web interface at https://dashboard.myflyingbox.com/en/registrations/new).

Depending on the selected service, various additional options will be displayed: pick-up date, relay point for delivery, insurance.

• Order and Download the Shipping Label
  

When all the data is correct and you have chosen your transport service and specified the associated options, click on "Confirm the transport order" to validate the order.

In case of an error, a message will be displayed. The main causes of error are an incorrect or problematic address (special characters, lines too long, etc.) or insufficient credit on your account. If you do not understand the error returned by the module, do not hesitate to contact our customer service.

Once the order is validated, click on "Download labels" to download the label(s) in PDF format.

Your shipment is also viewable on your client account via our web interface, from which you can also track and open incident tickets as necessary.

If you have checked the "Update order status" option in the module configuration, the order will automatically switch to "In progress" status, triggering the sending of a notification email to the client (a native mechanism of PrestaShop, not specific to the module).