How to set up FedEx Express

Table of Contents

• Overview
• Requirements
• How to set up FedEx Express
• How to migrate from FedEx Web Services to FedEx REST API
• FedEx Express Available Products
• FedEx Express Additional Features 
• Returns with FedEx
• Invoice Declaration Statement
• Duty and Tax Account Number
• Sold To Address
• Drop off types
• Common errors

Overview

• FedEx's Express integration with Starshipit allows you to generate packing slips and shipping labels, send branded tracking notifications, generate live rates at checkout and writeback tracking to your chosen platform.

• This article outlines how to set up FedEx Express in your Starshipit account.

Before you begin

Before getting started with the integration you will first need a FedEx Express account.

How to set up FedEx Express (REST API)

1. Go to Settings > Couriers > Add New Courier > FedEx.
2. Enter your FedEx Express account number.
3. Tick Enable FedEx.
4. Read and accept the End User License Agreement (EULA).

5. Select your form of Pin validation (options are email, phone, or SMS—these should be the email or phone number associated with your FedEx account). Click Generate Pin. 

6. Enter the pin and your company name, then select Validate Pin. If successful, your child key and secret will populate. If unsuccessful, please try again with a different form of pin validation.

7. Click Save. 
8. Enter your product codes with the FedEx Express services you wish to use. Available services are listed below and on the FedEx Express settings in Starshipit.
9. Upload an image of your signature to be displayed on the commercial invoice. Digital Signature – The limitation for signature is 240x25 pixels and the images can be in PNG formats.
10. Upload an image of your company letterhead to be displayed on the commercial invoice. Company Letterhead/Logo – The limitation for Logo is 700x50 pixels and images can be in PNG formats.
11. Select your FedEx Express packaging type. You can select one packaging type for FedEx Express shipments.

How to migrate from FedEx Express (Legacy) to FedEx Express (REST API)

1. Log into your Starshipit account.
2. Navigate to Settings > Couriers > FedEx.
3. Toggle to Rest API - New.
4. Enter your FedEx account number and click Register.
5. Select your form of Pin validation (options are email, phone, or SMS—these should be the email or phone number associated with your FedEx account). Click Generate Pin.
6. Enter the pin and your company name, then select Validate Pin. If successful, your child key and secret will populate. If unsuccessful, please try again with a different form of pin validation.
7. Then click Save.
8. Upload an image of your signature to be displayed on the commercial invoice. Digital Signature – The limitation for signature is 240x25 pixels and the images can be in PNG formats.
9. Upload an image of your company letterhead to be displayed on the commercial invoice. Company Letterhead/Logo – The limitation for Logo is 700x50 pixels and images can be in PNG formats.
10. Select your preferred additional FedEx settings.

How to set up FedEx Express (Legacy)

1. Go to Settings > Couriers > Add New Courier > FedEx.
2. Enter your FedEx Express account number.
3. Tick Enable FedEx.
4. Read and accept the End User License Agreement (EULA).
5. Select register - your API details and meter number will auto-populate.
6. Enter your product codes with the FedEx Express services you wish to use. Available services are listed below and on the FedEx Express settings in Starshipit.
7. Upload an image of your signature to be displayed on the commercial invoice.
8. Upload an image of your company letterhead to be displayed on the commercial invoice.
9. Select your FedEx Express packaging type. You can select one packaging type for FedEx Express shipments.

FedEx Express's Available Products

FedEx Express Additional Features 

Signature & Letterhead

You are required to upload a signature and letter head that will be used on your commercial invoices. To add this, go to Settings > Couriers > FedEx Settings and upload a signature/letter head in the Logos section.

Electronic Trade Documents

For a smoother customs clearance process, submit your trade documents electronically with FedEx Electronic Trade Documents. To enable this on your account, navigate to Settings > Couriers > FedEx > tick Use Electronic Trade Documents When enabled, your invoices will be created automatically when you print the shipping labels.

Order reference on label

The order number (our ref) is shown on the label in the 'ref' field. This is enabled by default.

Residential Flagging

You can flag your FedEx orders as being sent to a Residential Address. Set all of your FedEx orders as Residential as a default in Settings > Couriers > FedEx or mark individuals orders as Residential.

Reason for Export

Set a reason for export for your FedEx shipments. You can set export reason per Starshipit account. To set your reason for export, navigate to Settings > Couriers > FedEx > Reason for Export and select from the dropdown list. 

Cancel a shipment

You can cancel a FedEx Express shipment through the Starshipit portal. To do this, take the tracking number you'd like to cancel and go to the Settings > Couriers > FedEx > Tools > and enter the number. Click cancel to initiate the cancellation with FedEx Express.

Returns with FedEx 

You can generate a return label from an outbound shipment with FedEx. At this time, returns with FedEx are not supported in the Returns Portal. 

To create a return:

1. Go to the Printed or Shipped tab
2. Select the order you would like to generate a return for. 
3. Go to 'More actions' and 'Create a return order'
4. Check the details of your shipment.
5. Print or email your label to the sender. 

Invoice declaration statement

If you have information you would like to include on the commercial invoice which only applies in certain scenarios, you can use the rules engine.

1. Go to Settings > Rules > Create a new Rule.
2. For the condition, select when you would like it to apply (For example Destination Country contains US).
3. For the action, select Set Invoice Declaration Text and then enter what you would like to include.
4. Click Save.

Duty and Tax Account Number

You can now set a dedicated duties and taxes account number for FedEx international shipments. This alternative account number will be used when 'DDP' (Delivered Duty Paid) is flagged, ensuring that duties are billed directly to the specified account.

To set up your duty and tax account number:

1. In Starshipit, navigate to Settings > Couriers > FedEx Settings.
2. Tick Delivered Duty Paid.
   
3. Click Save.

You can also set your Duty and Tax account type. The options are Seller, Recipient and Third Party. 

Sold to Address

You can now set your sold to address for FedEx International Ground shipments. These details will be sent to FedEx in the shipment request and shown on the commercial invoice. 

To set up your sold to address for FedEx:

1. In Starshipit, navigate to Settings > Options > Additional Parties Customs > Add new.
2. Ensure that the 'Buyer' party type is selected. 
3. Add your Sold to Address details. You can also add a duties and taxes account number specific to the sold to address. 
4. Click Save. 

When you process shipments with the FedEx International Ground service the Sold To address will be populated with the details you have entered.

Drop off types

You can now set your default drop off type for your FedEx shipments. This will inform FedEx of how they will receive your shipments. Please note, the drop off types available in regions differ. Please reach out to your FedEx account manager to see what drop off types are available in your region. There are five drop off types available for FedEx:

• Regular pickup - Your regular scheduled pickup will apply
• Request courier - You will need to contact FedEx to request a pickup
• Business Service Center - Packages will be dropped off to a FedEx Business Service Center
• Drop Box - Packages will be dropped off at a FedEx Drop Box
• Station - Packages will be dropped off at a FedEx Station

To set your default Drop Off type navigate to Settings > Couriers > FedEx > Select pickup type.

Please note this pickup type will apply to all of your FedEx shipments. 

Common errors

Internal Service Error

If you get an "Internal Service Error." when trying to authenticate, this may mean your street address is too long. FedEx Express requires this to be less than 35 characters. Shorten your address and add it again to see if that resolves the error.

FedEx Economy

If the product code FEDEX_INTERNATIONAL_ECONOMY is not returning within orders please use INTERNATIONAL_ECONOMY as the product code.