Rating With FedEx Same Day City

FedExSameDayCity: Getting Rates

FedExSameDayCity requires some undocumented shipment options that you are required to input into your shipment details in order to return FedEx rates. Why is this? Because if you don’t use these options, you will get this rating error from FedEx:

"totalDeclaredValue.amount is a required field"

What is the totalDeclaredValue?

The totalDeclaredValue is a declaration within your shipment that tells FedEx the total value of your shipment. Within EasyPost, we’ve mapped the shipment.options.carrier_insurance_amount to the FedEx totalDeclaredValue.amount.

Here is a JSON example of it’s usage:

"options": {
    "carrier_insurance_amount": 100, 
    "currency": "USD", 
    "pickup_min_datetime": "2022-04-11T16:00:00+00:00Z"
     	}

This will create the required declaration for FedEx of the total value that is within the shipment.

Why declare the currency type?

The currency is required for FedEx to know which currency you are declaring the value in. Currency options would include examples such as "USD", "CAD", or "GBP". This is also documented here.

What is pickup_min_datetime for?

The pickup_min_datetime is another undocumented option that is required for FedExSameDayCity ratings.

This value needs to be present and set to be within business hours of the local timezone of the city. If it isn't set we'll default to current time + 30 minutes. If this happens to be outside of business hours, instead of returning FedExSameDayCity rates, the FedEx API will return only the priority level with a large after-hours fee.