FedEx - Rules & Guidelines

This section includes an outline of the rules you must follow when using a FedEx integration, as well as information that may be useful before using.

Table of Contents


When using a FedEx US account and the following services it is mandatory to file the manifest at the end of the day:

  • FedEx Ground® 
  • FedEx SmartPost® 

If the manifest is not filed when labels have been generated for these services, no information will be forwarded to FedEx.

For all other services under FedEx US accounts and all services under FedEx EU accounts, all information is submitted to FedEx during label generation and manifests are created purely for internal purposes.

Multiple integrations with one FedEx account

In cases where you are e.g.shipping from different warehouse locations, you may need to add multiple integrations in Linnworks using the same FedEx account.

In order for the system to allow you to do this, you need to enable the Multiple integrations setting in your existing FedEx shipping integration to avoid any errors occurring during the second integration setup.

This setting is available under Shipping > Integrations > Config > Account Details > Multiple integrations and by default is disabled. 

Note that this setting needs to be ticked only on the first added FedEx integration and can be left unticked on any secondary integrations.

Production credentials for non-EMEA accounts

In order to add a FedEx integration to Linnworks using a non-EMEA (e.g. a US) FedEx account, you will first need to create a test integration to provide FedEx with sample labels for verification. After the verification, FedEx will provide you with production credentials to use for adding a new integration.

Full steps for the above procedure are provided in this article.

International Shipments considerations

Some FedEx International services including those to some European destinations must, where necessary, have weight, dimensions and content of each package clearly specified. The actual requirements will depend on service, the destination country and contract type (e.g. volumetric) – Full details are available from FexEx.

In order to successfully print international labels the following minimum conditions must be met for each international label:

  • The order must have weight. Ideally, each order item must have weight specified in Linnworks. The packaging must be selected.
  • Each order item cost must be specified in the order (0 order items will result in an error unless this is a resend in which case Linnworks will set the order item value to 0.0001).
  • In the case of split order packaging, each package must have weight, dimensions and a number of items in the package.

Electronic Trade Documents

Various items require Electronic Trade Documents (ETD) in order to go through customs or be shipped by FedEx in general. Linnworks allows the submission of additional documents (apart from those generated automatically by the integration) with FedEx integration if:

  • The documents exist somewhere that they can be accessed via HTTP, e.g. Dropbox, Google Drive, etc.
  • The stock items must have: 
    • UploadDocumentUrl as an extended property that contains the URL of the document 
    • UploadDocumentFileName that contains its filename, including the extension
  • Only PDF, TXT, PNG, JPG, GIF, BMP, TIF, RTF, DOC and XLS are accepted
  • If more than one item in order has the same URL property then only one copy of the document will be submitted, i.e. duplicates are ignored.
  • If the order has: UploadDocumentUrl and UploadDocumentFileName as extended properties then these document will be uploaded instead of any associated with the order items

When the order label is printed in Linnworks, the URL referenced in the extended property will be sent to FedEx, returning a document ID that is in turn processed in the shipment request as an EDT. For more information on adding extended properties see this guide

Document Options

FedEx gives you the option to insert customised letterhead and signature image in all your Electronic Trade documents if you wish to. Many countries require the letterhead and signature for electronic documents, so it is important that you upload these prior to processing shipments.  To start using this option or change your current ones, go to Shipping > Integrations > FedEx > Config > Document Options

  • The images will need to be created and copied to a file sharing service such as Dropbox, Google Drive or an FTP server.
  • Maximum size is 700 x 50 pixels for the letterhead and 240 x 25 pixels for the signature.
  • The links to these files must then be entered into the image URL fields.


Next Steps