Before you start
To configure the FedEx courier on Poleepo you need to create a Developer account on the FedEx website: https://developer.fedex.com/api/it-it/home.html
You will need to log in or register by entering your User ID and Password .
Create an organization
To create and use FedEx API in transactions, you must be a member of an organization. Ask a member of an organization to invite you to join, or if your company is new to the FedEx Developer portal, create a new organization.
To create an organization, you need a FedEx account number and some information about your billing.
To create an organization, you need to provide FedEx with some information about your company.
In the example case in the figure below, the first option will be selected.
You will then need to enter your company name, company website, and organization name.
1. Create your integration projects
You then need to create integration projects: click on create a project to start making API requests.
To create an API project, you must first communicate why you need API access.
1) Poleepo Shipping Integration → is used to manage shipments with Poleepo
-Select the API shipping, rates and more button )
You then need to select all the APIs that appear after clicking the orange button:
You will then need to name your project and indicate Italy as the country you intend to ship from, so that FedEx can assign you a test account number.
You will then have to choose whether to ship with FedEx Smart Post or FedEx Freight LTL and click on "next".
You will then need to accept the terms and create the API project:
You will have thus created the Test API key and the Test secret API key for shipments (copy them as you will have to send them later to Poleepo support together with the Tracking API keys that we will show you how to create below)
2) Poleepo Tracking Integration → used to retrieve shipment tracking,
To create it you will need to create a new project , tell FedEx why you need API access and select the API Tracking option .
You will need to give the project a name again, select Italy as the country you intend to ship from so that FedEx can assign you a trial customer code and click next.
You will have created the Test API key and the Test secret API key for tracking that you will need to copy and send to Poleepo together with the pair of test keys for shipping previously created.
Finally send the two pairs of test API keys created
( shipping API key pair and tracking API key pair) to Poleepo support by opening a ticket, which will send you 4 test shipments to forward to your FedEx representative asking for validation.
2. How do I add my account number on FedEx?
In these steps we will see how to add the customer code on FedEx , to be inserted in the courier configuration on Poleepo and to create the Production Shipping and Tracking keys to be inserted in the configuration.
Starting from the FedEx menu, go to the "manage organization" section > Shipping account number > add account number.
You will then need to enter your nine-digit FedEx Account Number and Account Name.
You will then need to enter the company billing address, indicating Italy as the Country, adding the other information in the boxes, leaving the State/Province field blank and click on "next".
You will then have to declare that the above statements are true in order to click and open the link above "final license agreement".
NB if you do not open the link at the beginning you will not be able to tick the final option "I have read, understood and accepted" to continue.
After accepting all the terms click on "add customer code".
You will have successfully added the customer code to your FedEx organization that you will need to configure the courier on Poleepo and to bring the API keys for shipping and tracking into production .
3. How do I get my production keys, shipping and tracking?
To obtain your production, shipping and tracking keys, click on the "My Projects" section of your FedEx account.
1) Poleepo Shipping Integration -Click on Poleepo Shipping
Click on "Production Key".
Give the Key a name, select the customer code in the figure and click next.
You will have now generated the API key and the secret production key for shipping to use in the Poleepo configuration.
Copy them and keep them safe, remember that they are sensitive information.
2) Poleepo Tracking Integration -Clicca su Poleepo Tracking
Click on "Production Key".
Give the Key a name, select the customer code in the figure and click next.
You will have now generated the API key and the production secret key for tracking to use in the Poleepo configuration.
Copy them and keep them safe, remember that they are sensitive information.
Once you have created your Shipping and Tracking key pairs, you will need to submit them to FedEx for validation.
4. Configure FedEx your Poleepo
Foreword: Where can I find the requested data?
The data needed to configure Fedex are normally provided by the courier itself.
In the "Customer Code" field, enter the customer code, which is typically made up of 7 numeric characters.
The "API Key" and "Secret Key" fields must be requested from FEDEX specifying that a user is required for the integration via FEDEX API.
The "AutoConfirm" working mode must be decided during the activation phase with FedEx staff. With this operating mode, when you entrust the shipments to FEDEX, these shipments are directly confirmable by the management branch.
Configure FedEx
To reach the FedEx configuration on Poleepo go to menu > configuration > couriers and click on the FedEx courier .
You will need to fill in the required fields:
Customer Code ;
API Key ;
Secret Key ;
Configuration name ;
Tracking API Key ;
Secret Key Tracking ;
Default print type (PDF or ZEBRA);
Customs costs management (whether paid by the sender, the recipient, paid by third parties or paid on delivery by the recipient)
You will need to select the type of shipping service (domestic and international)
Check the white box if you have a collection already scheduled ;
Indicate the opening and closing times in the morning and afternoon, the time of availability of the goods and the time of collection;
Then click on the " save " button at the bottom right to save the configuration.
Finally enable the FedEx courier with the check mark in the top right and choose whether to set it as the Default courier by clicking on the star next to the button.
