Skip to main content

Shipping In-house With FedEx

Connect your FedEx account to Offset and print FedEx shipping labels directly from the Orders page.

Written by Siena Allen

Overview

If you pack and ship orders from your winery, you can connect your own FedEx account to Offset. Offset sends each order's details to FedEx and creates the shipping label, so you can manage everything in one place.
​

Setup happens in three stages:

  1. You create API credentials in your FedEx account and share them with the Offset team.

  2. The Offset team connects your account and creates a test labels.

  3. You submit the test labels to FedEx for approval. Once FedEx approves them, you can print live labels.

NOTE: FedEx's label review takes a few days after you submit. We recommend looping in your FedEx account rep, since they can often help with FedEx account questions and speed up approval.


Getting Started: What You'll Need

Step 1: Find Your FedEx Account Number and Billing Address

  1. Go to FedEx.com and log in.

  2. Open My Profile, then go to Account Management.

  3. Copy and save your account number.

  4. Click View/Edit Account and note your billing address. You'll need it in Step 2.

Step 2: Create a Ship Project in the FedEx Developer Portal

The FedEx Developer Portal is where you create the API credentials that let Offset create labels on your account. You'll create two projects: one for shipping (this step) and one for tracking (Step 4).

  1. Log in to the FedEx Developer Portal with the same FedEx ID you use on FedEx.com.

  2. Click My Projects. If you're asked to create an organization, create one. The person who creates it becomes its admin.

  3. When asked for an address, enter your billing address from Step 1, not your shipping address.

  4. Create a project under Ship, Rate & Other APIs and turn on these APIs:

    • Ship API

    • Address Validation API

    • Rates and Transit Times API

    • FedEx Location Search API

    • Pickup Request API

    • Postal Code Validation API

  5. Accept the FedEx Developer Portal License Agreement and create the project.

  6. Name the key (the default, API Key 1, is fine) and select your FedEx account.

  7. Copy your Ship API Key and Ship Secret Key.

IMPORTANT: FedEx shows each secret key only once. Save it as soon as it appears, ideally in a password manager such as 1Password. If you lose it, you'll need to create a new key.

Step 3: Copy Your Test Credentials

FedEx requires test labels before you can print live ones. In the same Ship project, open the Test Key tab and copy:

  • Test Account Number

  • Test API Key

  • Test Secret Key

Step 4: Create a Track Project

Repeat Step 2 to create a second project, this time with the Track API turned on.

  • Copy the Tracking API Key and Tracking Secret Key.

Step 5: Send Your Details to the Offset Team

Contact support@offsetpartners.com to let us know your FedEx credentials are ready. You will need to send us:

  • Your FedEx account number

  • Ship API Key and Ship Secret Key

  • Tracking API Key and Tracking Secret Key

  • Test Account Number, Test API Key and Test Secret Key

  • The return address to print on your labels

IMPORTANT: Your API keys and secret keys give access to your FedEx account, so share them securely using one of these options:

  • A 1Password vault (preferred): We’ll create a secure vault and add you as a guest. Add your credentials there, then let us know once they’re in.

  • A one-time secret link: If you can’t use 1Password, paste your credentials into a one-time link service such as Yopass, One-Time Secret, or Password Pusher, then send us the link. The link stops working once it’s opened, so your credentials don’t stay in anyone’s inbox.

Don’t send credentials in a regular email or chat message, or put them in Google Sheets or other shared documents.

The Offset team then connects your account and creates your test labels.
​

Step 6: Submit Your Test Labels to FedEx

Once your test labels are ready, we'll send them to you.

  1. We'll send you your test labels as a PDF or PNG file. Send them to FedEx as you receive them.

    1. Some brands report having issues with FedEx receiving the test label as a PDF. If you have any issues, try converting the file to a PNG and sending it to FedEx that way.

  2. Email the test labels to label@fedex.com, along with your FedEx account number and your Ship API Key. Copy your FedEx rep and the Offset support team.

    1. FedEx will also require you to fill out a "Web Integration Solutions Label Evaluation Cover Sheet". Your FedEx rep should be able to help fill this out if necessary.

  3. FedEx's Bar Code Analysis team reviews the labels, usually within a few business days.

  4. FedEx emails you once your account is approved to print live labels. Let the Offset support team know when you receive the approval.

NOTE: FedEx sometimes asks for changes before approving labels, including a different label file format. If they do, forward their reply to support@offsetpartners.com and we'll see what is needed.


Set Up Your FedEx Shipping Methods

Each shipping method you'll ship with FedEx needs FedEx selected as its fulfillment, with the matching method code.

  1. Go to Settings → Fulfillment Methods & Rates.

  2. Click the ellipsis (…) next to a FedEx shipping method, such as FedEx Ground, and select Edit Fulfillment Method.

  3. Under Method Details, change Fulfillment to FedEx.

  4. In Method Code, select the matching FedEx service from the table below

    1. If you use ShipCompliant for fulfillment with other methods, make sure you choose InHouseFedEx for the Fulfillment option. Additionally, set the ShipCompliant status for this method as "Payment Accepted" or "Delivered" since you're fulfilling in house.

  5. Save, and repeat for each FedEx shipping method.


Print FedEx Labels From the Orders Page

Once FedEx approves your account and your shipping methods are set up, you can print labels from Offset.

NOTE: If you use ShipCompliant, send your orders to ShipCompliant first. Select the orders and choose ShipCompliant Export [API] from the Choose an Action dropdown before moving on to the carrier exports.

  1. Go to Orders and filter for orders with a FedEx shipping method.

  2. Check the box next to each order you're shipping.

  3. Open the Choose an Action dropdown and, under Carrier Exports, run these steps in order:

    • Step 1) Carrier Export: Sends the orders to FedEx and creates a shipment for each one. Orders that are already Shipped or Canceled are skipped. Each submitted order changes to Processing. Orders should be Not Shipped prior to this step.

    • Step 2) Carrier Labels: Downloads your 4x6 shipping labels as a PDF and adds a tracking number to each order. Each label is followed by a pick slip with the order number, ship-to address, products, order comments, and an ICE PACK flag when the customer chose one. Orders change to Awaiting Pickup shortly after.

    • Step 3) Packing Slips (optional): Downloads packing slips to include in each box.

Before shipping in volume, print labels for one test order. Check that the label prints at the right size and scans cleanly.


Shipment Emails and Tracking Links

Your customer receives an email when their package is picked up, when it ships, when it's out for delivery, if there's a delivery exception, and when it's delivered.
​
Since these emails come from Offset, you can disable the customer email notifications within FedEx if you wish.

FedEx tracking numbers link to FedEx's tracking page, both on the order in Offset and in these emails.


Getting Help From FedEx

For questions about your FedEx account or Developer Portal credentials, contact your FedEx rep or FedEx support at 1.877.339.2774 (say "web services"). Hours are 7 a.m. to 9 p.m. Central Monday through Friday, 7 a.m. to 7 p.m. Central Saturday, and 9 a.m. to 7 p.m. Central Sunday.

Did this answer your question?