getaRates
Do you have questions about our APIs?
If you need help, don’t forget to use our artificial intelligence — it will help you generate examples that fit your specific needs, variations, and the required parameters for using each Hound Express API.
Our api provides you with a tool that allows you to check the availability of coverage, the rates and types of service that we have available to carry out your shipment. This in order that by means of this consultation you can choose the possibility that best suits your needs among those that we offer you.
The quote / coverage service allows you to evaluate if there is coverage from a zip code that will be the origin of the order to a destination zip code. The result of the consumption is an array with the fees, where if it is an empty array it will mean that there is no coverage for the origin-destination that you have consulted. Otherwise, the fee array may contain one or more options depending on the services assigned in your account settings.
Name Description Service name getRates/coverage EndPoint https://ws_pods.hound-express.com/Sabueso/ws/deliveryServices/getRates Headers https://apis-hound-express.readme.io/docs/the-headers-request Method POST Parameters JsonObject see: The guide object
### Request
To make the quote, it is necessary to send a json object of type guide that requires the filling of the following fields:
Guide
Field name
Type
MaxLength
Required
Comments
Address
Required
It is an address type object, it will be used to determine the origin of the shipment, the data is optional because according to the characteristics and configuration of your account, the coverage verification and rates may depend on the relationship of the origin and destination of the shipment.
It is possible to omit this data in cases where the collections are going to be in a predetermined direction that can be configured in the initial parameters of your organization.
In case this parameter is included in the request, the system will check if there are collection possibilities in this origin.
Address
Required
It is an address type object, it is used to check if there are delivery options
packagePieces
Required
List of packages to be quoted, at least one object is required within the array to quote, this data is necessary because in many cases there are restrictions on the weight and size of the shipment
tipo_peso
Integer
1
Required
1: kg/cm
isExportacion
Boolean
Required
True
Child objectsThe guide object contains sub-objects of which the filling of the following values is require
sender (Address)
Field Name
Type
Maxlength
Required
Comments
zip
(zip code)
Integer
10
Required
ZIP code of the sender, in case of omitting it or being an importer, this value is taken from the default address in the account configuration and is fixed.
receiver(Address)
Field Name
Type
Maxlength
Required
Comments
zip
(zip code)
Integer
10
Required
ZIP code of the consignee, is the data used to determine if there is the possibility of making the delivery to this destination.
state
String
2
Required
US, State, Province, or other top-level administrative region. Mandatory for some countries (AU, CA, CN, MX, MY, US). Ideally, use the abbreviations (2 letters for US/CA).
city
String
100
Required
packagePieces
Field Name
Type
Maxlength
Required
Comments
height
Integer
9
Required
In centimeters.
It must be an integer number.
length
Integer
9
Required
In centimeters.
It must be an integer number.
width
Integer
9
Required
In centimeters.
It must be an integer number.
weight
Float
7.1
Required
In kilograms.
Min 0.1
items
9
Required
Must not be empty
Item
Field Name Type Maxlength Required Comments description String 100 Required Item description height Float 99.9 Required In centimeters. Min 0.1 quantity Integer 99 Required Min. 1 piece length Float 99.9 Required In centimeters. Min 0.1 actual_weight Float 7.1 Required In kilograms. Min 0.1 declared_customs_value Float 999.9 Required In Mexico and other countries there is a regulation where the law requires that the value of the merchandise is declared and the description of the material that the shipment contains must be announced. declared_currency String 3 Required USD (CODIGO de ISO-4217 ) width Float 99.9 Required In centimeters. Min 0.1
Response
Upon consumption, the API will return an object with the following characteristics
### Successful response
Guide
Field name
Type
MaxLength
Comments
sender
Address
This field contains the data as originally received at the request.
receiver
Address
This field contains the data as originally received at the request.
packagePieces
Package (Array)
This field contains the data as originally received at the request.
quotes
Quotes(Array)
This field contains the quotes data.
The quotes object contains the results of its consumption
Quotes
Field Name
Type
MaxLength
Comments
Id
Integer
10
Service id (can be used later as a parameter for documentation)
In the event that after the consumption of this service (quote / coverage) and its process continue with the creation of the order, this data can be used to fill in the id of the serviceType in the JSON object of the request and by this way specify that you would like to use this specific service.
(this option is available depending on the configuration of your account and according to your contract).
Code
String
20
Service Code
Value
String
20
Quote fee In order for you to receive the correct rate within the result, it is necessary that your account is configured correctly for these purposes. That is to say: "THIS SERVICE WILL NOT ALWAYS RETURN YOUR RATE", it depends on the configuration of your account that allows it.
The above is due to the fact that not in all implementations the client that consumes this service must have a visualization of the negotiated rates.
type
Integer
10
Delivery provider key
description
String
100
Description of the service
date
String
20
Delivery commitment date
aux
BaseObject (Array)
Additional information in if there is a breakdown of the fee
dropOffLocations
Address (Array)
In case the client prefers to take the order to an office to be sent instead of requesting a collection, this is the list that our system detects of the offices that are closest to the origin zip code.
### Failed Response
wsErrors elements
Field Name Type Comments id Integer Error id code String Error code type Integer Severity of the error description String Description with more details of the detected error