FedEx Ground U.S. Shipping

Use the Shipping service to access the FedEx Ground® U.S. shipping features.

See Shipping Services by Region for a list of Ground U.S. services available by region.

Ground U.S. Service Details

The following rules apply to ground U.S. shipping:

Shipments can originate from and be delivered to the 50 United States. Delivery between 1 to 5 business days within the contiguous U.S. and between 3 to 7 business days to and from Alaska and Hawaii.
No Saturday pickup or delivery for ground; shipping and delivery days are Monday through Friday (8 a.m. to close of business day).
Ground accepts packages up to 150 lbs.. The dimensions must not exceed 108" in length or 165" in length plus girth (L + 2W + 2H).
Ground delivery is not available to P.O. boxes.
Hazmat shipments are allowed with restrictions. See the Hazardous Materials (Ground U.S.) section for details. No hazardous materials can be shipped to or from Alaska and Hawaii.
If the package is to a business, the service type is FedEx Ground®. If the package is to a residence, the service type is FedEx Home Delivery®.
For information about Home Delivery, see FedEx Home Delivery Service Details.
For more detailed information about the services offered by FedEx, see the electronic FedEx Service Guide.

Ground U.S. Service Options

The following service options are available for use with FedEx Ground U.S. shipping:

FedEx Home Delivery Service Details
Delivery Signature Services
FedEx Ground U.S. Collect On Delivery (C.O.D.)
Alcohol Shipping
Future Day Shipping
Hazardous Materials (Ground U.S.)
Shipment Notification in the Ship Request
Variable Handling Charges
Alternate Return Address
Mask Account Number

Ground U.S. Coding Details

Both commercial and residential shipments are allowed with FedEx Ground U.S. shipping. If you select FedEx Ground as the shipping service but are shipping to a residential address, the Ship reply returns an error and you must select Home Delivery as the shipping service. If you are unsure about the residential status of an address, use Address Validation Service to do a residential status check.
You can bill shipping costs to your own account, your recipient’s FedEx account, or a third-party FedEx account. You should always be sure you enter the appropriate FedEx account number if you want recipient or third-party billing. If the account number is missing or incorrect, you will be billed for the shipping costs.
You can add reference elements to your Ship request, which print on the shipping label, the customer invoice, or both. See the following tables for details.
Ground shipments that exceed the published ground limits are considered oversize shipments. A surcharge applies to any Ground package that measures greater than 60 inches in length but equal to or less than 108 inches in length. The oversize surcharge is returned in the Ship reply. For more information regarding oversize calculations, see the FedEx Service Guide.
Non-standard containers also incur an additional surcharge. The non-standard container definition is:
o A package not fully encased in an outer shipping container, or;
o A package encased in an outer shipping container made of wood, or;
o A drum or pail (less than 5 gallons) that is not fully encased in an outer shipping container made of corrugated cardboard.
Ground shipments may be created as multiple package shipments (MPS). This means that you can request up to 20 labels to a single recipient address in a single ship transaction. These packages are not tied together on the shipping label. If, for example, you have 10 packages going to New York, they do not have sequence indicators (1 of 10, 2 of 10, etc.) on the shipping label.

Required Elements

The following elements are available to ship a FedEx Ground U.S. package:

Recipient Information

Element

Multiple Occurrence

Description

CompanyName

No

Required. The name of the company associated with the recipient.

Contact

No

Required. The name of the person receiving the shipment.

StreetLines

No

Combination of number, street name, etc. At least one line is required for a valid physical address; empty lines should not be included.

Combination of number, street name, street type, and other defining attribute. At least one line is required for a valid physical address; empty lines should not be included.

Multiple occurrence field.

City

No

Required. Name of the city or town of the recipient.

StateOrProvinceCode

No

Required. Identifying abbreviation for US state or Canada province. Format and presence of this field will vary, depending on country. For more information, see Appendix B: U.S. State Codes and Appendix C: Canada Province Codes.

PostalCode

No

Required. Identification of a region (usually small) for mail/package delivery. Format and presence of this field will vary, depending on country.

Country Code

No

Identifies the recipient country.

PhoneNumber

No

Required. The recipient’s telephone number.

Residential

No

Optional. However, if you ship to a residential address and do not include the Residential element, your rate quote will be incorrect.

Billing

Element

Multiple Occurrence

Description

ShippingChargesPayment/PaymentType

No

Required. Values are:

COLLECT
SENDER
RECIPIENT
THIRD_PARTY

AccountNumber

No

Required. To ensure that shipping and customs charges are billed to the correct account number, include the AccountNumber element that corresponds to the BillTo element if payment type is COLLECT, RECIPIENT or THIRD_PARTY.

Currency

No

Required. The currency code of the monetary exchange for FedEx services. See Appendix E: Currency Codes for a list of codes.

Note: FedEx will provide currency conversion using Web Services. If you enter a currency other than the currency associated with your FedEx account number, rate quotes will be returned based on the specified currency.

CountryCode

No

The country code associated with the currency type.

CustomerReferenceType

No

Optional. This element allows you to add reference information that prints on the shipping label and on your invoice. Reference information may also be used to track packages. Values are:

BILL_OF_LADING
CUSTOMER_REFERENCE
INVOICE_NUMBER
P_O_NUMBER
SHIPMENT_INTEGRITY
STORE_NUMBER

SHIPMENT_INTEGRITY prints only on the invoice.

Note: Reference information is submitted on the shipment level. However, you may add up to four references per shipment.

Note: See the Reference Elements with Output Location table for more information about where your reference information prints.

CustomerReference/Value

No

Optional. Reference information to be associated with the CustomerReferenceType. For example, if you designate INVOICE_NUMBER in the CustomerReferenceType element, the actual invoice number associated with the package is included in the CustomerReference/Value element.

Multiple Package Shipment (MPS) Elements

This option is available for Express U.S. Domestic and International multiple-package shipments, Ground US Domestic and International multiple-package shipments, Express Domestic C.O.D. and International C.O.D. multiple-package shipments and Ground Domestic C.O.D. and International C.O.D. multiple-package shipments.

For more information about MPS see Domestic Express Multiple Package Shipments (MPS).

Note: Up to 100 MPS packages may be created for one master shipment.

Element

Multiple Occurrence

Description

PackageCount

No

Required for MPS shipments. Total number of packages in the shipment.

SequenceNumber

No

Required if PackageCount is greater than 1. The sequence number determines the master package and is important when shipment level information is added for that package. The shipment level information added to a master package applies to all packages in the shipment.

MasterTrackingID

No

Required. The MasterTrackingID element is returned with the first package reply. This element contains both the MasterTrackingNumber and the FormID elements. The MasterTrackingID element must be added to each subsequent ship request for all other packages in the MPS shipment.

Package and Shipment Details

Element

Multiple Occurrence

Description

ServiceType

No

Required. Valid values are:

FEDEX_GROUND
GROUND_HOME_DELIVERY

Note: If you ship to a residential address, your service type must be GROUND_HOME_DELIVERY.

PackagingType

Yes

Required. Valid value is YOUR_PACKAGING.

Weight

Yes

Required. Units and Value are included in this element. Values for the Units element are:

LB
KG

The Value element must contain the actual package weight. For MPS shipments, each ship request must contain the package weight.

TotalWeight

No

Required for MPS shipments. The TotalWeight element is submitted for the master package only, not the subsequent child packages. The master package (designated as 1 in the PackageCount element) contains the total package weight in the MPS shipment.

Units and Value are included in this Element. Values for the Units element are:

LB
KG

The Value element must contain actual package weight.

Dimensions/Height

Yes

Optional. Submitted in the Ship request on the package level.

Dimensions/Width

Yes

Optional. Submitted in the Ship request on the package level.

Dimensions/Length

Yes

Optional. Submitted in the Ship request on the package level.

Dimensions/Units

Yes

Required if dimensions (Height, Width, Length) are submitted. Values are:

IN
CM

TotalInsuredValue/Amount

No

You may enter a value in this element to declare additional value for this shipment. For MPS shipments, the master package should contain the total declared value for the shipment. No declared value is added to subsequent child shipments. FedEx does not provide insurance of any kind.

ShipTimestamp

No

Date of shipment. For ground and Home Delivery packages, this date can be the current date or up to 10 days in advance.

Time of shipment based on shipper’s time zone. Defaults to CDT.

The date format must be YYYY-MM-DDTHH:MM:SS-xx:xx. The time must be in the format: HH:MM:SS using a 24-hour clock. The date and time are separated by the letter T (e.g., 2009-06-26T17:00:00). The UTC offset indicates the number of hours/minutes (e.g. xx:xx) from UTC (e.g., 2009-06-26T17:00:00-04:00 is defined as June 26, 2009 5:00 p.m. Eastern Time). See Appendix L: Time Zone Table for more information about time zones.

Label Requirements

Element

Multiple Occurrence

Description

LabelSpecification

No

To identify the type of label format you will receive, elements in the LabelSpecification complex type element should be included in the ProcessShipment request (depending on your label format). More information about label printing is provided in Creating a Label.

To determine if special options apply at the shipment level (controls every package in the MPS) or at the package level (levied for a particular package), refer to the following chart:

Shipping Option

Package vs. Shipment Level

Delivery Signature Options

Shipment

Hazmat

Shipment

Reference Elements

Package

Shipment Notification

Package

Home Delivery Premium Services

You may also choose three premium options for your FedEx Home Delivery® shipments:

FedEx Date Certain Home Delivery: FedEx contacts the recipient (recipient’s phone number is required in transaction) and schedules a specific date for package delivery.
FedEx Evening Home Delivery: Just like “Date Certain Delivery,” FedEx contacts the customer (recipient’s phone number is required in transaction) and schedules an evening package delivery.
FedEx Appointment Home Delivery: This option is time-specific. If you want your package delivered at 1:30 on Tuesday, FedEx calls the recipient to confirm this date/time. The recipient phone number is required in the transaction.

Note: Home Delivery premium services are requested on the package level and incur surcharges.

Elements for Home Delivery Premium Services

Element

Description

HomeDeliveryPremiumDetail/ HomeDeliveryPremiumType

Valid values are:

APPOINTMENT
DATE_CERTAIN
EVENING

HomeDeliveryPremiumDetail/Date

Required for Date Certain Home Delivery. Valid dates are Monday through Saturday.

HomeDeliveryPremiumDetail/ DeliveryInstructions

Optional. Allows additional delivery instructions are for any Home Delivery premium services.

HomeDeliveryPremiumDelivery/ PhoneNumber

Required for Date Certain and Appointment Home Delivery. FedEx contacts the recipient at this number to schedule delivery.

Reply Elements

In the ShipResponse/ProcessShipmentReply, the following elements are returned:

Error messages with severity
Tracking number(s)—are assigned to all packages. For ground C.O.D., you receive the origin shipment tracking number and the C.O.D. return payment tracking number.
Rates and surcharges—for more information see Rate Services.
Service commitment
Routing code
Origin commitment
Time in transit detail
Station ID (where applicable)

Reference Elements with Output Location

The ShipService WSDL includes these CustomerReference/CustomerReferenceType elements:

Value

Prints

BILL_OF_LADING

Shipping label and invoice.

CUSTOMER_REFERENCE

Shipping label, Ground shipping reports, and in the Customer Reference element on the invoice.

INVOICE_NUMBER

Shipping label and invoice.

P_O_NUMBER

Shipping label and invoice.

SHIPMENT_INTEGRITY

Invoice.

STORE_NUMBER

Shipping label and invoice.

Note: Additional surcharges apply to FedEx Home Delivery premium services.

Note: These elements can also be configured to print on the thermal label DocTab. For more information, see the DocTab Configuration.

Note: You may use reference elements to track packages or to tie packages together for a single track request. See Tracking and Visibility Services for more information.

XML Schema

Find the XML Schema in Appendix V: XML Schema.

FedEx Home Delivery Service Details

The following rules apply to Home Delivery (residential flag checked):

Shipment can originate from and be delivered to the 50 United States, although longer transit times apply to Alaska and Hawaii.
Shipping and delivery days are Tuesday through Saturday from 9 a.m. to 8 p.m.
Package weight and size can be up to 70 lbs., 108 inches in length, or 165 inches in combined length plus girth (L+2W+2H).
Home Delivery is not available to P.O. boxes.
No hazmat except ORM-D packages: see Hazardous Materials (Ground U.S.) for details.
Options include Delivery Signature Services, Signature Proof of Delivery (SPOD), and Creating a Label.
Non-standard packaging: Include this element in your transaction to indicate that your shipment is packaged in a non-standard or irregularly shaped container (such as a pail). A surcharge may apply. Contact FedEx Ground Customer Service 1.800.Go.FedEx, 1.800.463.3339 for guidelines or to find out if your packaging is non-standard.
For shipments including alcohol, see Alcohol Shipping for more information.

For more detailed information about the services offered by FedEx, see the electronic FedEx Service Guide.

Home Delivery Premium Services

FedEx Home Delivery is part of FedEx Ground shipping. You can use FedEx Home Delivery to ship packages to residential addresses. You can use the basic FedEx Ground transaction for FedEx Home Delivery shipments. You can also use the following options as needed:

FedEx Date Certain Home DeliverySM

Use this service option to specify a delivery date for FedEx Home Delivery®. For example, if your recipient is available to accept packages on Thursdays only, you may enter a specific Thursday as the delivery date in your shipping transaction.

FedEx Evening Home DeliverySM

Use this service option to specify delivery between 5 P.M. and 8 P.M., based on the recipient’s local time zone.

FedEx Appointment Home DeliverySM

Use this service option to specify an appointment for delivery. The recipient is contacted by the local FedEx Home Delivery terminal when the shipment arrives, to set a delivery appointment.