Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

FedEx

The FedEx integration is one of the most advanced integrations in UltraCart.  By configuring your FedEx API information, UltraCart will not only be able to estimate rates using the discounts that you have with FedEx, but also print domestic shipping labels directly to PDF. 

Info

If you do not have complete product FedEx web service credentials on file, then UltraCart will only be able to obtain estimates limited to standard list rates for shipments originating in the US or destined for the US only.

FEDEX Credentials

There are two sets of API credentials required for the FEDEX API integration:

  1. "Sandbox " Test Credentials (Used to complete the Label Certification)
  2. Production Credentials 

The 4 API credentials are:

  1. Account Number
  2. Meter Number
  3. Web Service Authentication Key
  4. Web Service Password

Obtaining Your Sandbox Test Credentials

Your test credentials are required to complete the Label printing certification step. 

To obtain your FEDEX Test API credentials:

  1. Register for a FedEx developer account if you do not already have one.
  2. Login to your FedEx online account. 
  3. Visit FedEx Web Services Page --> FedEx Web Services --> Develop and Test --> Get your test key
  4. Complete the form and make sure you select "Global and US" , then accept the agreement to continue. 
    (If you're testing intra-country within European countries, select the right country in addtion to a US and Global account number.)
  5. Next:
    Image Removed
  6. You'll be presented with Account Number, and Meter Number and Authentication Key
    Copy and save your credentials, you'll enter these into your UltraCart account in a little bit.
  7. Finally, check your email that is associated to your FedEx account.
    You should receive an email titled:"Your Developer Test Key Registration is complete"
    Copy and save your Test Password.

Obtaining Your Productions API Credentials

  1. Visit FedEx Web Services, then navigate:
    FedEx Web Services → Move to Production →  Get Production Key
  2. Fill out the presented forms, then accept the agreement to continue.
    See example form selections below:
    Image Removed
  3. You'll be presented with the Production Authentication Key and Meter Number. Copy and save the credentials.
  4. Next, navigate to: 
    My Profile → Account Management
    Copy and save your Production Account Number.
  5. Finally, check your email that is associated to your FedEx account.
    You should receive an email titled:"Your developer Production Key Registration is complete"
    Copy and save your Production Password.

Now that we have our Test and Production API credentials, we can configure them within UltraCart.

Log into your UltraCart account, then navigate:

Info
titleNavigation
Main Menu → Configuration → (middle menu) Checkout → Shipping → (Middle Menu) Under "Carriers", click "FedEx"

The FedEx configuration shown below. Fill in your Test and Production Credentials:

Image Removed

Now that you have your TEST and Production credentials saved, you'll need to complete the rest of the UltraCart FEDEX Configuration form.

  • For Web Service Version choose "26" from the drop down list
  • For Rating you'll choose between "List" (retail pricing) or "Discounted" (your negotiated rates)
  • Enter your Sender Address details
  • For SmartPost Hub, enter your Hub ID.
  • SmartPost Rate < 1 LB (Checkbox field) select if you wish to apply SmartPost rate for packages that weight less than one pound.
  • SmartPost Ship > $100 (Fedex will only insure up to $100 with SmartPost) (Checkbox field)
  • SmartPost Minimum Weight ____LB (Allows you to specify the minimum weight that SmartPost Rate will be used for estimates.)

General Settings

There are 5 general settings for the API:

...

Sender Label Type: Choose "4x6" or "Half Sheet" and also optional setting "( packing slip with 4x6 label)"

Tip

There are two types of labels that FedEx can print (half sheet and 4x6).  Most merchants get a Zebra LP2844 label printer and print the 4x6 labels.  The signature type option allows you to control how the customer will be required to sign for the package.  The label reference allows you to print custom fields 1-5 on the label.

...

Table of Contents

FedEx

The FedEx integration is one of the most advanced integrations in UltraCart.  By configuring your FedEx API information, UltraCart will not only be able to estimate rates using the discounts that you have with FedEx, but also print domestic shipping labels directly to PDF. 

Info

If you do not have complete product FedEx web service credentials on file, then UltraCart will only be able to obtain estimates limited to standard list rates for shipments originating in the US or destined for the US only.

FEDEX Credentials

There are two sets of API credentials required for the FEDEX API integration:

  1. "Sandbox " Test Credentials (Used to complete the Label Certification)
  2. Production Credentials 

The 4 API credentials are:

  1. Account Number
  2. Meter Number
  3. Web Service Authentication Key
  4. Web Service Password

Obtaining Your Sandbox Test Credentials

Your test credentials are required to complete the Label printing certification step. 


To obtain your FEDEX Test API credentials:

  1. Register for a FedEx developer account if you do not already have one.
  2. Login to your FedEx online account. 
  3. Visit FedEx Web Services Page --> FedEx Web Services --> Develop and Test --> Get your test key
  4. Complete the form and make sure you select "Global and US" , then accept the agreement to continue. 
    (If you're testing intra-country within European countries, select the right country in addtion to a US and Global account number.)
  5. Next:
    Image Added
  6. You'll be presented with Account Number, and Meter Number and Authentication Key
    Copy and save your credentials, you'll enter these into your UltraCart account in a little bit.
  7. Finally, check your email that is associated to your FedEx account.
    You should receive an email titled:"Your Developer Test Key Registration is complete"
    Copy and save your Test Password.

Obtaining Your Productions API Credentials

  1. Visit FedEx Web Services, then navigate:
    FedEx Web Services → Move to Production →  Get Production Key
  2. Fill out the presented forms, then accept the agreement to continue.
    See example form selections below:
    Image Added
  3. You'll be presented with the Production Authentication Key and Meter Number. Copy and save the credentials.
  4. Next, navigate to: 
    My Profile → Account Management
    Copy and save your Production Account Number.
  5. Finally, check your email that is associated to your FedEx account.
    You should receive an email titled:"Your developer Production Key Registration is complete"
    Copy and save your Production Password.

Now that we have our Test and Production API credentials, we can configure them within UltraCart.

Log into your UltraCart account, then navigate:

Info
titleNavigation
Main Menu → Configuration → (middle menu) Checkout → Shipping → (Middle Menu) Under "Carriers", click "FedEx"

The FedEx configuration shown below. Fill in your Test and Production Credentials:

Image Added

Now that you have your TEST and Production credentials saved, you'll need to complete the rest of the UltraCart FEDEX Configuration form.

  • For Web Service Version choose "26" from the drop down list
  • For Rating you'll choose between "List" (retail pricing) or "Discounted" (your negotiated rates)
  • Enter your Sender Address details
  • For SmartPost Hub, enter your Hub ID.
  • SmartPost Rate < 1 LB (Checkbox field) select if you wish to apply SmartPost rate for packages that weight less than one pound.
  • SmartPost Ship > $100 (Fedex will only insure up to $100 with SmartPost) (Checkbox field)
  • SmartPost Minimum Weight ____LB (Allows you to specify the minimum weight that SmartPost Rate will be used for estimates.)

General Settings

There are 5 general settings for the API:

  1. Web Service Environment (Choose either: Test or Production)
    *Select test during the Label Certification then switch to Production after the Label Certification step is completed.
  2. Sender Label Type: Choose "4x6" or "Half Sheet" and also optional setting "( packing slip with 4x6 label)"

    Tip

    There are two types of labels that FedEx can print (half sheet and 4x6).  Most merchants get a Zebra LP2844 label printer and print the 4x6 labels.  The signature type option allows you to control how the customer will be required to sign for the package.  The label reference allows you to print custom fields 1-5 on the label.


  3. Signature Type: Choose "Indirect", "Direct", or "Adult"
  4. Include Clearance Entry Fee (Checkbox field)

Customs

FieldDescription
Include Clearance Entry FeeSelect this checkbox to include Clearance Entry Fee
Merchant Paid DutiesSelect this checkbox to designate duties to be paid by merchant.
Electronic Trade Docs (ETD)Select this checkbox to instruct FedEx to submit customs documents electronically. See ITN for more details.
Hard CopySelect checkbox if using ETD, but still wish provide local copy of customs for printing.
LetterheadUpload your letterhead in either *.gif or *.png (Attention: Max Size for image 700x50 pixels.)
SignatureUpload your digital signature in either *.gif or *.png (Attention: Max Size for image 700x50 pixels.)

Completing the FEDEX Label Certification Step

Most likely you'll want to take advantage of FEDEX Label printing directly within the UltraCart Shipping department. To enable FEDEX Label printing, navigate to the FEDEX configuration tab:

...

  1. Scroll down the Test credentials column, to the blue button titled "Generate certification labels in test environment", then click the button.
  2. You'll be presented with a table of 10 label scenarios, click the button titled "stock test scenarios", then click the save button.
  3. Next, click the "Generate labels".
  4. Generate test labels within the FedEx test environment associated with the application and
    then submit the test labels to the FedEx label evaluation team(s) for approval.

    Note: The Bar Code Analysis group requires a three-business-day turnaround time for
    label evaluation.

    To avoid processing delays, follow the below best practices:
    Labels must be printed on the model printer that will be used in production. These labels
    must be scanned at a minimum resolution of 600 DPI to ensure clear imagesare available
    for the certification process. DO NOT SEND WEB SERVICES GENERATED FILES.
    • For thermal printers, the label image type must be requested in accordance with the
    printer model. Example: ZPLII for Zebra printers
    • Use the sender shipper/recipient address information when creating sample labels for
    evaluation. Only create sample labels for the specific services that are being applied for.
    • FedEx®
    Collect on Delivery (C.O.D.) label must also include the corresponding C.O.D.
    Return label.
    • FedEx International Express®
    shipments must also include the auxiliary/secondary Air
    Waybill (AWB) label.
    • Multi-piece shipments (MPS) must include one label for each package in the shipment.
    • Certain customized FedEx SmartPost® labels require up to 72 hours forevaluation.
    • FedEx Freight® labels do not requireevaluation.
    • Email the PDF and Label Cover sheet to: label@fedex.com

    Physical labels may be sent to:
    FedEx Services
    WTC – Business Solutions Testing
    10 FedEx Parkway
    2nd Floor Horizontal
    Collierville, TN 38017

    Note: If the scanned labels are without visible defects (such as lines going through the
    barcode, spots in the ink, or physical damage), then they may pass inspection and approval will
    be granted. However, if there are defects, physical copies will be requested.
    If sending physical labels, pay attention to print quality and accidental enlargement/shrinkage
    of labels (i.e. scaling). These are the top two reasons why labels do not pass the label evaluation
    process.
    Step 6. Label Evaluation
    The Bar Code Analysis group will evaluate the submitted test labels and approve or reject the
    labels. The Bar Code Analysis group will contact you regarding the approval or rejection of the
    submitted labels. If the labels are approved, continue to the next step. If the labels are rejected,
    correct the labels as instructed and resubmit them for approval.

...

Info

The new FedEx Freight configuration area will now allow your UltraCart account to pull rates directly from FedEx Freight. Theses settings will be different from the regular FedEx account. Please make sure you are not using the same credentials in both sections.


Warning

Web Service Version 26 required for Freight rate estimates.

...