GetRates Method

Returns rate information for a specified or all available FedEx services.

Syntax

[VB.NET]
Public Sub GetRates()

[C#]
public void GetRates();

Remarks

To get the courtesy rate quotes for FedEx services, you can call the GetRates method. If the rates are needed for a specific service type, you will have to pass a value of the RequestedService (other than 'UNSPECIFIED') in the request. The RequestedService identifies the FedEx service for which you want to retrieve rate information. If the rates are wanted for all available FedEx services, you should not set a value to RequestedService before sending the request to the FedEx Server. It will default to 'UNSPECIFIED').

In either case, the following properties or config settings are sent in the request (if any of these have not been set, their default values will be used instead):

• Server (required)
• DeveloperKey (required)
• Password (required)
• AccountNumber (required)
• MeterNumber (required)
• RateType (required)
• ShipDate (optional)
• PackagingType (required)
• DropoffType (required)
• SenderAddress (required)
• RecipientAddress (required)
• TotalWeight (required)
• InsuredValue (optional)
• Packages (required)
• ShipmentSpecialServices that can affect rates and/or service availability (such as COD, Saturday Pickup, Saturday Delivery, Hold At Location, Dry Ice, etc.) (optional)

Regarding the Packages, please note the following:

• when requesting rates for all available services (RequestedService set to 'UNSPECIFIED'), only one package should be added to this collection even for MPS. When rating MPS, just specify the Packages and the details for one package only. FedEx will consider all packages the same;
• when requesting rates for a specific service (RequestedService set to a value other than 'UNSPECIFIED'), you will have to add as many packages as there are in the MPS specifying the package detail for each package included in the shipment.

In each above mentioned cases, if there are no packages added and specified (Packages = null), the component will throw an error.

Upon a successful response, the Services property gets populated.

If there is a problem with any of the input values within the request, the response will either raise an error (when it's an hard error) and transaction will fail, or give a warning (when it's a soft error), which can be accessed via Warning, and the transaction will go through.

For more details on errors codes and descriptions, please refer to the Error Messages section.