FedEx SmartPost Shipping

FedEx SmartPost® and FedEx SmartPost® Returns each require a service contract. To sign up for FedEx SmartPost outbound shipping or FedEx SmartPost Returns, contact your FedEx account executive.

FedEx SmartPost helps you consolidate and deliver high volumes of low-weight, less time-sensitive business-to-consumer packages using the United States Postal Service (USPS) for final delivery to residences. This service provides delivery Monday through Saturday to all residential addresses in the U.S., including P.O. boxes and military APO and FPO destinations.

FedEx SmartPost also offers FedEx SmartPost Returns service, delivery and shipment e-mail notifications for U.S. outbound shipments, customizable labels, and Future Day shipping.

FedEx SmartPost Service Details

FedEx SmartPost Service includes the following features:

FedEx SmartPost is available for shipments originating in the 48 contiguous United States only. Alaska, Hawaii, Puerto Rico, and the U.S. territories are not included as origin points.
The FedEx SmartPost service allows delivery to all 50 United States and the U.S. territories, including PO boxes and military locations (Army Post office - APO, Fleet Post Office - FPO, Diplomatic Post Office - DPO), and Puerto Rico.
FedEx SmartPost supports customer packaging only. Because FedEx SmartPost employs the USPS for final delivery to residences, packages are subject to USPS restrictions.
Future Day shipping is available for FedEx SmartPost shipments.
Saturday delivery is possible by USPS. No FedEx surcharge applies in this case.
Packages can only be tracked using the Delivery Confirmation Number (DCN) assigned to each FedEx SmartPost package.
FedEx SmartPost Returns provides a U.S. to U.S. returns service for all shippers regardless of volume. Once contracted, a shipper can use any service for their outbound shipping and still use FedEx SmartPost Returns. Both print and e-mail return label options are available. Consumers can conveniently return packages from all 50 states, Puerto Rico, U.S. territories and military locations simply by placing it in their mailbox, dropping it off at their local Post Office, at a USPS collection box or handing it off to a USPS carrier by taking advantage of a free package pickup.
Note: A separate account number is given for FedEx SmartPost outbound shipments and FedEx SmartPost Returns. If a customer is contracted with return services, they need to use the associate account rollup to a national number.

For Standard Mail, Bound Printed Matter, and Media the following dimensions restriction applies:

Dimensions: No more than 84 inches in combined length and girth
No one dimension greater than 60 inches.
Minimum dimensions are 6" L x 4" W x 1"

For Parcel Select the following restrictions apply:

Dimensions: No more than 130 inches in combined length and girth.
No one dimension can be greater than 60 inches.
Minimum Dimensions are 6" L X 4" W X 1".
For a sample FedEx SmartPost label, refer to Appendix S: Ground Plain Paper Labels.

For more detailed information about FedEx SmartPost outbound shipping and returns, see fedex.com/us/smartpost.

FedEx SmartPost Request Elements

In addition to the elements required for all requests, the following elements are included in the FedEx SmartPostRequest:

Element

Description

ProcessShipmentRequest/
RequestedShipment/
ServiceType

Optional. Specify SMART_POST for FedEx SmartPost shipping services.

SmartPostDetail

Required. Specify the appropriate details for a FedEx SmartPost shipment.

SmartPostDetail/Indicia

Required. Specify the indicia type. Available options include:

MEDIA_MAIL
PARCEL_SELECT
PRESORTED_BOUND_PRINTED_MATTER
PRESORTED_STANDARD
PARCEL_RETURN

SmartPostDetail/
AncillaryEndorsement

Optional. Specify an endorsement type from the following valid values:

ADDRESS_CORRECTION
CARRIER_LEAVE_IF_NO_RESPONSE
CHANGE_SERVICE
FORWARDING_SERVICE
RETURN_SERVICE

Note: For FedEx SmartPost Standard Mail (Presorted Standard < 1 lb) shipments with delivery confirmation, either RETURN SERVICE REQUESTED or ADDRESS SERVICE REQUESTED is permitted.

SmartPostDetail/HubID

Required. Specify the HubID. Valid values are:

5303 ATGA Atlanta
5281 CHNC Charlotte
5602 CIIL Chicago
5929 COCA Chino
5751 DLTX Dallas
5802 DNCO Denver
5481 DTMI Detroit
5087 EDNJ Edison
5431 GCOH Grove City
5771 HOTX Houston
5465 ININ Indianapolis
5648 KCKS Kansas City
5902 LACA Los Angeles
5254 MAWV Martinsburg
5379 METN Memphis
5552 MPMN Minneapolis
5531 NBWI New Berlin
5110 NENY Newburgh
5015 NOMA Northborough
5327 ORFL Orlando
5194 PHPA Philadelphia
5854 PHAZ Phoenix
5150 PTPA Pittsburgh
5958 SACA Sacramento
5843 SCUT Salt Lake City
5983 SEWA Seattle
5631 STMO St. Louis

Note: Include only the numeric HubID value in your request.

SmartPostDetail/
CustomerManifestID

Optional. The CustomerManifestId is used to group FedEx SmartPost packages onto a manifest for each trailer that is being prepared.

If you have multiple trailers, you must assign a Manifest Id to each FedEx SmartPost package as determined by its trailer. The Manifest Id must be unique to your account number for a minimum of 6 months and cannot exceed 8 characters in length.

We recommend that you use the day of year, the trailer id (a sequential number for that trailer). For example, if there are 3 trailers that you started loading on Feb 10, then the 3 Manifest Ids would be 041001, 041002, 041003 (this example includes leading zeros on the trailer numbers).

The maximum length is 8 characters.

RequestedShipment/
RequestedPackageLineItems/
PhysicalPackaging

Optional

Provides additional detail on how the customer has physically packaged this item. Required for FedEx SmartPost services.

FedEx SmartPost Reply Elements

The following elements are returned in the FedEx SmartPost reply:

Element

Description

ProcessShipmentReply/
CompletedShipmentDetails/
SmartPostDetail/

Returns FedEx SmartPost shipment account details including:

Machine-able (indicates whether the shipment is deemed to be machine-able, based on dimensions, weight, and packaging)
AllowedHubs
MailerId
DistributionCenter
SmartPostId
PickUpCarrier (CarrierCodeType)
AllowedIndicia
AllowedSpecialServices
SmartPostHubId
MaximumTransitTime

FedEx SmartPost APO/FPO/DPO

FedEx SmartPost allows customers to ship orders to APO (Army/Air Force Post Office), FPO (Fleet Post Office) or DPO (Diplomatic/Defense Postal Office) addresses. Include the following element values to ship to these addresses:

Element

Value

City

Valid values are:

APO
FPO
DPO

StateOrProvinceCode

Valid values are:

AA - Armed Forces Americas
AE - Armed Forces Europe
AP - Armed Forces Pacific

Since packages shipped to APO/FPO/DPO are potentially dutiable, the USPS requires that all customers use Form 2976A when shipping APO/FPO/DPO packages, regardless of weight and value. For more information on customs and USPS requirements and to complete and print the forms online, refer to the USPS Website at http://ribbs.usps.gov/files/IntCustomsForms.

The following is an example of a FedEx SmartPost APO address:

StreetLines: PSC 2 box 7629

City: APO

StateOrProvinceCode: AE

PostalCode: 09012

CountryCode: US

The following reply elements would be returned for the FedEx SmartPost APO Address Validation:

<v2:ProposedAddressDetails>

<v2:Score>100</v2:Score>

<v2:Changes>MODIFIED_TO_ACHIEVE_MATCH</v2:Changes>

<v2:Changes>APO_OR_FPO_MATCH</v2:Changes>

<v2:DeliveryPointValidation>CONFIRMED</v2:DeliveryPointValidation>

<v2:Address>

<v2:StreetLines>Psc 2 Box 7629</v2:StreetLines>

<v2:City>APO</v2:City>

<v2:StateOrProvinceCode>Ae</v2:StateOrProvinceCode>

<v2:PostalCode>09012-0026</v2:PostalCode>

<v2:CountryCode>US</v2:CountryCode>

</v2:Address>

FedEx SmartPost Labels

FedEx SmartPost shipments use one of the following two types of labels based on the specified pickup carrier:

FedEx SmartPost label - FedEx SmartPost is the pickup carrier
FedEx Integrated label - FedEx Ground is the pickup carrier

The pickup carrier type is designated by the FedEx account executive based on the volume requirement at the time of the contract and is stored on FedEx system.

The FedEx SmartPost label type supports the Customer Reference bar code when <CustomerReference> element is used in the Ship request. The FedEx Integrated label supports FedEx Ground bar code below the USPS Delivery Confirmation bar code at the bottom half of the label.

See Appendix S: Ground Plain Paper Labels for a sample FedEx SmartPost and FedEx Integrated label.

FedEx SmartPost Returns Service Details

For an online retailer or other residential shipper, a no-hassle returns process is critical for customer satisfaction and loyalty. FedEx SmartPost® Returns service is an ideal solution because it provides your recipients with the convenience of U.S. Postal Service® (USPS®) access points for their returns, as well as free package pickup from their home or business address.

FedEx SmartPost Returns is a contract-only service for customers with high-volume returns (100 average daily volume) of low-weight residential packages. It’s a cost-effective, reliable solution that utilizes the strength of the FedEx® network and the access of the USPS. In addition, FedEx SmartPost Returns provides visibility throughout the returns process to your customer service and operations departments, as well as to the return shipper.

How it Works

When using FedEx SmartPost Returns, you can choose three methods of processing your return labels:

Include pre-printed return labels in your original shipments.
Direct your customers back to your Website to process and print online labels.
Send your customers an e-mail that includes a FedEx URL link to the return shipping label for them to print.

The return shipper then simply puts the label on the package and tenders it at a USPS access point including any of the 36,000 retail locations or thousands of collection boxes, or even their own mailbox. They can also call for the free USPS package pickup service.

Once your customers’ returns packages are picked up by the USPS, they’ll be consolidated into larger shipments at local post offices and picked up by FedEx for shipment to you.

FedEx SmartPost provides U.S. to U.S. returns to all shippers regardless of volume segment and includes E-Mail Return Labels and Future Day shipment. Shippers can use any FedEx Express or Competitor outbound service and still contract to use FedEx SmartPost Returns services.

Features

To use the FedEx SmartPost Returns service, shippers must have an account flagged as eligible for FedEx SmartPost Returns and be U.S. based payors. U.S. Dollars (USD) is the only currency that is supported for a FedEx SmartPost shipment.
Whenever customers request a return label, they must send in the Returns account number also.
The only packaging type available is the customer’s own packaging.
Eligible payment types are Bill Sender or Associated Account.
A prepaid USPS integrated return shipping label, which means your customers don’t have to stand in line at a shipping location to obtain the proper documentation and don’t incur any out-of-pocket expenses.
USPS daily pickup options of Monday through Saturday, offering your customers convenient access for tendering their package at a local post office, a postal collection box or their own mailbox. Return shippers also can request a free USPS package pickup at www.usps.gov/pickup.
Coverage to every residential address in the U.S., including P.O. boxes and APO/FPO/DPO destinations.
Transit times of 2 to 7 business days. This means you can quickly and efficiently cycle returned products back into inventory for faster redeployment into the market — generating revenue and reducing the effects of product depreciation.
Maximum package weight of 70 lbs.
No residential or Saturday pickup surcharges.
Inbound shipment visibility via FedEx InSight®. FedEx InSight e-mail notifications provide timely and automatic status information about your incoming FedEx SmartPost Returns packages and include an estimated delivery date — assigned when the FedEx SmartPost origin hub receives the package — enabling you to plan accordingly.
Visibility for your customers through the tracking or RMA number on fedex.com. With an up-to-the-minute view of their returns, customers are not calling your customer service department for shipment-status updates.

Customer reports via FedEx® Reporting Online. Limit of liability is $100.

FedEx SmartPost Returns Request Elements

Begin your ship request with the basic Ship Request elements as detailed in FedEx Express U.S. Shipping under the heading Express U.S. Coding Details . Add the following elements in your ProcessShipmentRequest to receive a FedEx SmartPost Return Label in your ship reply.

Element

Required or Optional

Description

SpecialServicesRequested/
SpecialServiceTypes

Required

Include the value:

RETURN_SHIPMENT

ReturnShipmentDetail/
ReturnType

Required

The type of return shipment being requested. The valid value is:

PRINT_RETURN_LABEL.

With this option you can print a return label to be applied to the box of a return. This option cannot be used to print an outbound label.

ReturnShipmentDetail/Rma

Optional

Return Merchant Authorization (RMA).

If included, this element has two optional fields:

Number: The RMA number associated with the return shipment. Including this number in your request allows you to track by RMA number up to 20 alpha-numeric characters.

If the RMA element is included in the Ship Request, the return reason description may be entered. This element allows you to enter up to 60 alpha-numeric characters.

ProcessShipmentRequest/
RequestedShipment/
ServiceType

Required

Specify SMART_POST for FedEx SmartPost shipping services.

SmartPostDetail

Required

Required. Specify the appropriate details for a FedEx SmartPost shipment.

SmartPostDetail/Indicia

Required

Required. Specify the indicia type. Available options include:

PARCEL_RETURN

SmartPostDetail/HubID

Required

Required. Specify the HubID. Valid values are:

5303 ATGA Atlanta
5281 CHNC Charlotte
5602 CIIL Chicago
5929 COCA Chino
5751 DLTX Dallas
5802 DNCO Denver
5481 DTMI Detroit
5087 EDNJ Edison
5431 GCOH Grove City
5771 HOTX Houston
5465 ININ Indianapolis
5648 KCKS Kansas City
5902 LACA Los Angeles
5254 MAWV Martinsburg
5379 METN Memphis
5552 MPMN Minneapolis
5531 NBWI New Berlin
5110 NENY Newburgh
5015 NOMA Northborough
5327 ORFL Orlando
5194 PHPA Philadelphia
5854 PHAZ Phoenix
5150 PTPA Pittsburgh
5958 SACA Sacramento
5843 SCUT Salt Lake City
5983 SEWA Seattle
5631 STMO St. Louis

Note: Include only the numeric HubID value in your request.

FedEx SmartPost Return Labels

You can create a return label that can be printed using a variation of the Ship Web Service. The recipient can then apply this label to the return package as needed and drop the package off at a U.S. Postal Service drop-off location, or their local mail carrier will pick up the package at the home address. No charges are assessed until the label is used. In addition, a Returns Material Authorization (RMA) reference number can be included in your ship transaction. The RMA number prints on the label and can be used to track the return package.

FedEx SmartPost Returns support both Print and E-Mail Return Labels. You can request Shipment and Delivery E-Mail Notifications for FedEx SmartPost Returns. However, Ancillary Endorsements are not supported for FedEx SmartPost Returns.
The maximum number of packages allowed for Print Return shipments is 999, and for an e-mail label is 25.
For FedEx SmartPost Returns, Ground Integrated Print and E-Mail Return labels options are available.
FedEx SmartPost return labels are not available for international destinations.
Dangerous Goods and Hazardous Materials cannot be shipped.
Declared value is not available for FedEx SmartPost return labels. If you wish to declare a value, please use FedEx Express or Ground return label services instead.
Return labels do not expire.
Returns shipments are not billed until a possession scan is initiated by FedEx and the package moves.
All label formats supported by Web Services (laser, thermal, etc.) are available for FedEx SmartPost Returns shipping labels.
E-Mail return labels are not available for U.S. territories and Puerto Rico.

FedEx SmartPost E-Mail Return Labels

You can use the power of fedex.com to create return shipping labels for FedEx SmartPost Returns. Fedex.com will e-mail your customer with a link to view and print the label. The customer can take the package to any local United States Postal Center or have their local mail carrier collect the package during their normal mail rounds. The package will be returned to your location using FedEx SmartPost.

You will use the ShipService CreatePendingShipment Web service to trigger fedex.com to create the appropriate FedEx SmartPost Return Label and notify the customer through an e-mail from FedEx. You can also cancel the label before it expires by using the ShipService CancelPendingShipment request.

Delivery Area

FedEx SmartPost Returns Service is available throughout the 50 United States, U.S. territories, APOs, FPOs and DPOs. FedEx customer e-mails can be sent to any standard e-mail address.

E-Mail Return Labels 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 SmartPost Returns.
The e-mail label request is canceled using elements from the CancelPendingShipmentRequest in the ShipService WSDL for FedEx SmartPost Return 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 expiration time stamp you specify in your request.
After the customer prints the label, the label does not expire but can be used indefinitely.
The only label format supported is 8-1/2" x 11" plain paper printed on a Laser printer.
A surcharge is added to a returns 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.

Returns (Inbound) E-Mail Label Elements

Basic information is required in a CreatePendingShipment Request:

Element

Required

Description

CreatePendingShipment

Optional and/or Required

The Web Service inside the Ship Service WSDL file used to create all E-Mail Return Labels

WebAuthenticationDetail/
UserCredential/Key

Optional and/or Required

The value for the Key was provided by FedEx upon your request through the FedEx Developer Resource Center. It is an alphanumeric mixed-case string.

WebAuthenticationDetail/
UserCredential/Password

Optional and/or Required

The value for the Password was provided by FedEx upon your request through the FedEx Developer Resource Center. It is an alphanumeric mixed-case string.

ClientDetail/AccountNumber

Optional and/or Required

The FedEx Express nine-digit meter number that was provided by FedEx upon your request through the FedEx Developer Resource Center.

ClientDetail/MeterNumber

Optional and/or Required

The FedEx Express meter number that was provided by FedEx upon your request through the FedEx Developer Resource Center.

Version/ServiceId

Optional and/or Required

The value is “ship”

Version/Major

Optional and/or Required

The current value is "9".

Version/Intermediate

Optional and/or Required

The current value is "0".

Version/Minor

Optional and/or Required

The current value is "0".

RequestedShipment/
ServiceType

Optional and/or Required

For this transaction the valid value is SMART_POST

RequestedShipment/
Shipper/Contact/
PersonName

Optional and/or Required

Required if Contact name is blank.

RequestedShipment/
Shipper/Contact/
CompanyName

Optional and/or Required

Required if Company name is blank.

RequestedShipment/
Shipper/Contact/
PhoneNumber

Optional and/or Required

Required. Shipper phone number. Numeric only.

RequestedShipment/
Shipper/Contact/

Optional and/or Required

There are additional fields available. They are optional.

RequestedShipment/
Shipper/Address/
StreetLines

Optional and/or Required

At least one street address line is required. This is a multiple occurrence field.

RequestedShipment/
Shipper/Address/City

Optional and/or Required

Required. Shipper city.

RequestedShipment/
Shipper/Address/
StateOrProvinceCode

Optional and/or Required

Required. Please refer to Appendix B for a list of State Codes.

RequestedShipment/
Shipper/Address/
PostalCode

Optional and/or Required

Required. Shipper postal code.

RequestedShipment/
Shipper/Address/
CountryCode

Optional and/or Required

Required. Valid value - US

RequestedShipment/
Shipper/Address/

Optional and/or Required

There are additional fields available. They are optional.

RequestedShipment/
Recipient/Contact/
PersonName

Optional and/or Required

Required if Contact name is blank.

RequestedShipment/
Recipient/Contact/
CompanyName

Optional and/or Required

Required if Company name is blank.

RequestedShipment/
Recipient/Contact/
PhoneNumber

Optional and/or Required

Required. Recipient phone number. Numeric only.

RequestedShipment/
Recipient/Contact/

Optional and/or Required

There are additional fields available. They are optional.

RequestedShipment/
Recipient/Address/
StreetLines

Optional and/or Required

At least one street address line is required. This is a multiple occurrence field.

RequestedShipment/
Recipient/Address/City

Optional and/or Required

Required. Recipient city.

RequestedShipment/
Recipient/Address/
StateOrProvinceCode

Optional and/or Required

Required. Please refer to Appendix B for a list of State Codes.

RequestedShipment/
Recipient/Address/
PostalCode

Optional and/or Required

Required. Recipient postal code.

RequestedShipment/
Recipient/Address/
CountryCode

Optional and/or Required

Required. Valid value - US

RequestedShipment/
Recipient/Address/

Optional and/or Required

There are additional fields available. They are optional.

 

In addition to the basic shipping elements, the following elements must be included in the CreatePendingShipmentRequest to trigger an E-Mail Return Label through fedex.com:

Element

Required

Description

RequestedShipment/
SpecialServicesRequested/
SpecialServiceTypes

Optional and/or Required

Required. Specify the type of special service. Both of these Service Types must be included for a returns e-mail label:

PENDING_SHIPMENT
RETURN_SHIPMENT

RequestedShipment/
SpecialServicesRequested/
ReturnShipmentDetail

Optional and/or Required

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

PENDING

RequestedShipment/
SpecialServicesRequested/
ReturnShipmentDetail/Rma

Optional and/or Required

Optional. This value is a string. It will be printed on the label as both a barcode and in human-readable text.

Note: That if an Rma Number is specified, the package can also be tracked by this value.

RequestedShipment/
SpecialServicesRequested/
ReturnShipmentDetail/
ReturnE-mailDetail/
MerchantPhoneNumber

Optional and/or Required

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

Max 10 characters, numeric-only string.

RequestedShipment/
SpecialServicesRequested/
PendingShipmentDetail/
Type

Optional and/or Required

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

E-MAIL

RequestedShipment/
SpecialServicesRequested/
PendingShipmentDetail/
ExpirationDate

Optional and/or Required

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/
e-mailLabelDetail/
Notificatione-mailAddress

Optional and/or Required

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/
E-mailLabelDetail/
NotificationMessage

Optional and/or Required

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

 

Finally, the following elements are included in a request for the E-Mail Return label to be a SmartPost Returns label:

Element

Required

Description

SmartPostDetail

Optional and/or Required

Required. Specify the appropriate details for a FedEx SmartPost shipment.

SmartPostDetail/Indicia

Optional and/or Required

Required. Specify the indicia type. The value for this transaction is PARCEL_RETURN.

SmartPostDetail/
AncillaryEndorsement

Optional and/or Required

Optional. Specify an endorsement type from the following valid values:

ADDRESS_CORRECTION
CARRIER_LEAVE_IF_NO_RESPONSE
CHANGE_SERVICE
FORWARDING_SERVICE
RETURN_SERVICE

Note: These services are of little practical use for a return package, but they will not cause the transaction to fail.

SmartPostDetail/HubId

Optional and/or Required

Required. Specify the HubID. Valid values are:

5303 ATGA Atlanta
5281 CHNC Charlotte
5602 CIIL Chicago
5929 COCA Chino
5751 DLTX Dallas
5802 DNCO Denver
5481 DTMI Detroit
5087 EDNJ Edison
5431 GCOH Grove City
5771 HOTX Houston
5465 ININ Indianapolis
5648 KCKS Kansas City
5902 LACA Los Angeles
5254 MAWV Martinsburg

 

5379 METN Memphis
5552 MPMN Minneapolis
5531 NBWI New Berlin
5110 NENY Newburgh
5015 NOMA Northborough
5327 ORFL Orlando
5194 PHPA Philadelphia
5854 PHAZ Phoenix
5150 PTPA Pittsburgh
5958 SACA Sacramento
5843 SCUT Salt Lake City
5983 SEWA Seattle
5631 STMO St. Louis

Note: Include only the numeric HubID value in your request.

SmartPostDetail/
CustomerManifestId

Optional and/or Required

Optional. This field is of little practical use for a returns package.

The CustomerManifestId is used to group FedEx SmartPost packages onto a manifest for each trailer that is being prepared.

If you have multiple trailers, you must assign a Manifest Id to each FedEx SmartPost package as determined by its trailer. The Manifest Id must be unique to your account number for a minimum of 6 months and cannot exceed 8 characters in length.

We recommend that you use the day of year, the trailer id (a sequential number for that trailer). For example, if there are 3 trailers that you started loading on Feb 10, then the 3 Manifest Ids would be 041001, 041002, 041003 (this example includes leading zeros on the trailer numbers).

The maximum length is 8 characters.

RequestedShipment/
RequestedPackageLineItems/
PhysicalPackaging

Optional and/or Required

Optional. Provides additional detail on how the customer has physically packaged this item. Required for FedEx SmartPost services.

General Reply Elements

The following elements are returned in every FedEx reply:

Element

Required

Description

Notifications/Severity

Optional and/or Required

One of five string values returned in every reply:

SUCCESS - Your transaction succeeded with no other applicable information.
NOTE - Additional information that may be of interest to you about your transaction is in the reply.
WARNING - Additional information you need to know about your transaction that you may need to take action on.
ERROR - Information about an error that occurred while processing your transaction.
FAILURE - FedEx was unable to process your transaction at this time due to a system failure. Please try again later.

Notifications/Code

Optional and/or Required

A three or four digit standardized string that matches the message field below. Please refer to Appendix O for a complete list of codes and their matching messages.

Notifications/Message

Optional and/or Required

A message that matches the code. The message for a NOTE includes additional information. The message for a WARNING might specify a system assumption or additional action you may need to take. The message for an ERROR usually specifies a problem with your request that prevented processing.

Version

Optional and/or Required

The system will echo back the Version elements you specified in your request.

FedEx SmartPost Reply Elements

The following elements are returned in the FedEx SmartPost reply:

Element

Required

Description

CompletedShipmentDetail/
RoutingDetail/TransitTime

Optional and/or Required

String. The minimum number of days for the package to be delivered.

CompletedShipmentDetail/
RoutingDetail/
MaximumTransitTime

Optional and/or Required

String. The maximum number of days for the package to be delivered.

CompletedShipmentDetail/
AccessDetail/
E-mailLabelUrl

Optional and/or Required

The URL the customer will receive in the e-mail from FedEx to take them to the label that has been generated for them.

CompletedShipmentDetail/
CompletedPackageDetails/
TrackingIds/TrackingIdType

Optional and/or Required

The reply will include tracking numbers for the package. The TrackingIdType will specify whether a specific Tracking Number provided is USPS or GROUND.

CompletedShipmentDetail/
CompletedPackageDetails/
TrackingIds/
TrackingNumber

Optional and/or Required

The reply will usually include two tracking numbers for the package. The TrackingNumber will show the Tracking number value. USPS is 22 digits, Ground is 15 digits.

The customer will receive an e-mail from FedEx that uses the data as provided in your request. The e-mail will look like this:

 

Following the link, the user will see a fedex.com screen and use the data you provided in your request. This screen will allow them to choose which shipping label to display and print:

Cancel E-Mail Label Elements

The following information is required to cancel an E-Mail Return Label using a CancelPendingShipment Web Service Request:

Element

Required

Description

CancelPendingShipment

Optional and/or Required

The Web Service inside the Ship Service WSDL file used to cancel all E-Mail Return Labels

WebAuthenticationDetail/
UserCredential/Key

Optional and/or Required

The value for the Key was provided by FedEx upon your request through the FedEx Developer Resource Center. It is an alphanumeric mixed-case string.

WebAuthenticationDetail/
UserCredential/
Password

Optional and/or Required

The value for the Password was provided by FedEx upon your request through the FedEx Developer Resource Center. It is an alphanumeric mixed-case string.

ClientDetail/
AccountNumber

Optional and/or Required

The FedEx Express nine-digit meter number that was provided by FedEx upon your request through the FedEx Developer Resource Center.

ClientDetail/
MeterNumber

Optional and/or Required

The FedEx Express meter number that was provided by FedEx upon your request through the FedEx Developer Resource Center.

Version/ServiceId

Optional and/or Required

The value is “ship”

Version/Major

Optional and/or Required

The current value is "9".

Version/Intermediate

Optional and/or Required

The current value is "0".

Version/Minor

Optional and/or Required

The current value is "0".

RequestedShipment/
ServiceType

Optional and/or Required

For this transaction the valid value is SMART_POST

TrackingId/
TrackingIdType

Optional and/or Required

Required. You will use a Tracking number to cancel a specific package. This field specifies which tracking number will be specified. The valid values for this service are:

GROUND
USPS

TrackingId/
TrackingNumber

Optional and/or Required

Required. The Tracking number for the active package you wish to cancel.

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.  

Customizable Labels

Shippers will be offered a customizable area on the labels for FedEx SmartPost and FedEx SmartPost Returns.

The customizable label size is 4" x 8" which is a 4" x 6" format with an additional 1-1/2 inch area available for customization. The customizable label can be printed with and without doc-tabs.

Future Day Shipping

Customers can process FedEx SmartPost future day shipments in the same way as FedEx Ground. This includes the same limit on the number of days (10 days) as FedEx Ground future day shipments

Tracking Numbers

Customers can track FedEx SmartPost shipments using:

Customer reference number
P.O. number
Invoice number
Return Material Authorization (RMA) number

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.

Error Messages for FedEx SmartPost

See Appendix O: Error Codes for a list of their error codes and associated messages.

Samples

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