FedEx Courier Integration with Voila

This document provides a step-by-step guide to integration with Voila.

Last updated 4 months ago

Integrating FedEx with Voila.

Follow these instructions to integrate FedEx into your system:

  1. Begin by navigating to the left panel and hovering your cursor over "API Accounts."

  2. Click the plus icon to initiate the setup process under your preferred API Account.

  3. In the first row, choose "FedEx" from the list of available options.

  4. The following fields are required for setting up FedEx integration:

    • Company: Enter any identifier you prefer.

    • Testing: This is a simple yes or no selection. If enabled, the information will not be transmitted to the courier through their API, making it suitable for testing.

    • User_Key, User_Password, Account_Number, Meter_Number, Letter_Head_Imagine_ID, Letter_Head_Base64, Signature_Image_ID, Signature_Base64: Obtain these details through FedEx's platform or contact them directly to acquire this information.

    • Notes: Use this field to enter relevant information or notes regarding this courier. It will only be visible to you.

  5. To complete the setup, click on "Save Changes."

By following these steps, you will successfully configure the FedEx integration with your Voila account.

Click to Play/Pause or Maximise the Video.

Additional Guidance for FedEx Integration with Voila

FedEx v1 Integration: Uploading Letterhead and Signature Images

To send your Letterhead and Signature to FedEx via their API, you’ll need to provide the following fields:

  • ‎`letter_head_image_id`

  • ‎`letter_head_base64`

  • ‎`signature_image_id`

  • ‎`signature_base64`

How to prepare your images:

  1. Create your images: Use an image editor (such as Photoshop) to create your Letterhead and Signature images.

    • Letterhead: Maximum size is 700 x 50 pixels.

    • Signature: Maximum size is 240 x 25 pixels.

    • Both images must be in PNG format.

  2. Name your files:

    • Letterhead image file name: e.g. ‎`IMAGE_1`

    • Signature image file name: e.g. ‎`IMAGE_2`

  3. Convert images to base64: Use an online tool such as Base64 Image Encoder ↗ to convert your PNG files to base64 format.

  4. Enter details in Voila: Copy and paste your image IDs and base64 data into the relevant fields.

Note: If you encounter errors despite correct credentials, please check with your FedEx Account Manager to ensure all required settings are enabled on your FedEx account.

FedEx v2 Integration: Uploading Letterhead and Signature Images

To send your Letterhead and Signature to FedEx via their API, please complete the following fields:

  • ‎`letter_head_image_id`

  • ‎`letter_head_base64`

  • ‎`letter_head_image_name`

  • ‎`signature_image_id`

  • ‎`signature_base64`

  • ‎`signature_image_name`

How to prepare your images:

  1. Create your images: Use an image editor to design your Letterhead and Signature images.

    • Letterhead: Maximum size is 700 x 50 pixels.

    • Signature: Maximum size is 240 x 25 pixels.

    • Both images must be in PNG format.

  2. Name your files:

    • Letterhead image ID: ‎`IMAGE_1`

    • Letterhead image name: ‎`IMAGE_1.png`

    • Signature image ID: ‎`IMAGE_2`

    • Signature image name: ‎`IMAGE_2.png`

  3. Convert images to base64: Use Base64 Image Encoder ↗ or another online tool to convert your PNG files to base64 format.

  4. Enter details in Voila: Paste your image IDs, image names, and base64 data into the corresponding fields.

Note: If you experience errors and your credentials are correct, please consult your FedEx Account Manager to confirm all necessary account settings are enabled.

Base64 Image Encoder

This online tool allows you to convert any image file or URL to Base64, HTML, CSS, JSON, or XML. All conversions happen securely in your browser.