E-Mail Labels

You can create either an e-mail (non-returns) shipping label or an e-mail returns shipping label by using the ShipService’s CreatePendingShipment RequestCancel Pending Shipment. You can also cancel either of these requests by using the ShipService’s CancelPendingShipment Request.

The E-Mail Return Label option allows you to e-mail a return label directly to your customer. Your customer can then print the label, apply it to the package, and call for pickup or drop the package off at the nearest FedEx drop-off location. For your customer’s convenience, the e-mail also includes links for scheduling a pickup and finding drop-off locations in the area.

E-Mail Label Service Details

The following service details apply to e-mail labels:

Delivery Area

Available for FedEx First Overnight®, FedEx Priority Overnight®, FedEx Standard Overnight®, FedEx 2Day®, FedEx Ground®, FedEx Home Delivery®, FedEx 2Day® Freight, and FedEx 3Day® Freight throughout the 50 United States.

FedEx Express and FedEx Ground return labels are not available for international destinations.

Exceptions

FedEx Express Saver® and FedEx 1Day® Freight services are not available.

Dangerous Goods and Hazardous Materials (Ground U.S.) cannot be shipped.

Additional Information

Additional service options include Saturday Service, Dry Ice Shipments, and Hold at FedEx Location and Redirect To Hold.

The maximum declared value is $1,000USD for FedEx First Overnight, FedEx Priority Overnight, FedEx Standard Overnight, and FedEx 2Day.

The maximum declared value is $50,000USD for FedEx 2Day Freight and FedEx 3Day Freight.

The maximum declared value is $100USD for FedEx Ground and FedEx Home Delivery.

E-Mail Label Coding Details

The following coding details apply to e-mail labels:

The e-mail label is created using elements from the CreatingPendingShipmentRequest in the ShipService WSDL for FedEx Ground or FedEx Express shipments. Requirements that apply to ground and express shipments also apply to e-mail labels.
The e-mail label request is canceled using elements from the CancelPendingShipmentRequest in the ShipService WSDL for FedEx Ground or FedEx Express shipments. Requirements that apply to FedEx Ground and FedEx Express shipments also apply to e-mail labels.
You may request up to 25 e-mail labels to one e-mail address using one request transaction.
E-Mail label URLs expire according to your expiration time stamp.
After the customer prints the label, the label does not expire but can be used indefinitely.
A FedEx Ground Manifest is not required for an e-mail label.
The only label format supported is laser (or plain paper).
A surcharge is added to a returns e-mail label. No surcharge is applied to a non-return
e-mail label.
The maximum expiration date for an e-mail label must be greater or equal to the day of the label request and no greater than 30 days in future.

Return (Inbound) E-Mail Label Elements

In addition to the basic FedEx Ground or FedEx Express shipping elements required to request an e-mail label, the following elements must be included in the CreatePendingShipmentRequest:

Element

Description

RequestedShipment/
SpecialServicesRequested/
SpecialServiceTypes

Required. Specify the type of special service. Valid values for a return e-mail label:

PENDING_SHIPMENT
RETURN_SHIPMENT

RequestedShipment/
SpecialServicesRequested/
ReturnShipmentDetail

Required. Specify the Return Type. Include the following value:

PENDING

RequestedShipment/
SpecialServicesRequested/
ReturnShipmentDetail/Rma

Optional. Includes the Rma Number and Rma Reason elements. Note that if an Rma Number is specified, the package can also be tracked by this value.

RequestedShipment/
SpecialServicesRequested/
ReturnShipmentDetail/
ReturnEmailDetail/
MerchantPhoneNumber

Required. Include the phone number for the merchant, such as a general customer service phone number.

RequestedShipment/
SpecialServicesRequested/
ReturnShipmentDetail/
ReturnEmailDetail/
AllowedSpecialServices

Optional. Allow specific special services for the end-user. Valid values are:

SATURDAY_DELIVERY
SATURDAY_PICKUP

RequestedShipment/
SpecialServicesRequested/
PendingShipmentDetail

Required. Specify the Pending Shipment Type. Include the following value:

e-mail

RequestedShipment/
SpecialServicesRequested/
PendingShipmentDetail/
ExpirationDate

Required. Specify the e-mail label expiration date: for example, 2009-01-31.

The maximum expiration date must be greater or equal to the day of the label request and not greater than 30 days in the future.

RequestedShipment/
SpecialServicesRequested/
PendingShipmentDetail/
EmailLabelDetail/
NotificationEmailAddress

Required. E-Mail address of the end-user to be notified of the return label. This element has a 200-character maximum.

RequestedShipment/
SpecialServicesRequested/
PendingShipmentDetail/
EmailLabelDetail/
NotificationMessage

Optional. Notification message included in the e-mail to the end-user.

Non-Return E-Mail Label Elements

In addition to the basic FedEx Ground or FedEx Express shipping elements required to request an e-mail label, the following elements must be included in the CreatePendingShipmentRequest:

Element

Description

RequestedShipment/
SpecialServicesRequested/
SpecialServiceTypes

Required. Specify the type of special service.

Include the following values for a return e-mail label:

PENDING_SHIPMENT
RETURN_SHIPMENT

RequestedShipment/
SpecialServicesRequested/
PendingShipmentDetail/
HomeDeliveryPremiumDetail

Optional. Special service elements for FedEx Home Delivery shipments.

RequestedShipment/
SpecialServicesRequested/
PendingShipmentDetail/
ShipmentDryIceDetail

Optional. PackageCount and TotalWeight elements for Dry Ice shipments.

RequestedShipment/
SpecialServicesRequested/
PendingShipmentDetail/
EmailLabelDetail/
NotificationMessage

Optional. Notification message included in the e-mail to the end user (200-character maximum).

RequestedShipment/
SpecialServicesRequested/
PendingShipmentDetailEmailLabelDetail/
Notificatione-mailAddress

Required. E-Mail address of the end-user to be notified of the label.

RequestedShipment/
SpecialServicesRequested/
PendingShipmentDetail/
ExpirationDate

Required. Specify the e-mail label expiration date: for example, 2009-01-31.

The maximum expiration date must be greater than or equal to the day of the label request and no greater than 30 days in future.

RequestedShipment/
SpecialServicesRequested/
SpecialServiceTypes

Required. Specify the type of special service.

Include the following value for a non-return e-mail label:

PENDING_SHIPMENT

RequestedShipment/
SpecialServicesRequested/
PendingShipmentDetail

Required. Specify the pending shipment type.

Include the following value:

EMAIL

Cancel E-Mail Label Elements

In addition to the basic FedEx Ground or FedEx Express shipping elements required to request an e-mail label, the following element must be included in the CancelPendingShipmentRequest:

Element

Description

TrackingNumber

The tracking number associated with the pending shipment to be canceled.

XML Schema

See the XML Schema section of the FedEx Web Services Developer Guide in the Support area of the FedEx Developer Resource Center at fedex.com/developer.

Samples

You can download sample service requests and replies with the WSDLs from the FedEx Developer Resource Center Technical Resources.