Return (Inbound) Email Label Elements

In addition to the basic FedEx Ground or FedEx Express shipping elements required to request an email 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 email 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: 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/ ReturnShipmentDetail/ ReturnAssociation Optional. Describes the data for the outbound shipment associated with the return.
RequestedShipment/ SpecialServicesRequested/ PendingShipmentDetail Required. Specify the Pending Shipment Type. Include the following value:
  • EMAIL
RequestedShipment/ SpecialServicesRequested/ PendingShipmentDetail/ ExpirationDate Required. Specify the email 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. Email 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 email to the end-user.