🚧
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.
https://ia.hound-express.com/app/techhoundchannel

Introducction:

It is important that you know the difference between Master Air Waybill (MAWB) and Internal Air Waybill (HAWB), since information from both concepts will be entered.

The AWB” (Air Waybill), Air Waybill or Air Waybill, is the main document of the contract of carriage by air.

This document, unlike the bill of lading, does not give right over the merchandise but it does give the right to claim it. It is generally nominative, therefore not endorsable and non-negotiable. The document itself indicates it with the mention Not negotiable Air Waybill. It bears the signature of the carrier or its agent and an issue date. If the AWB is issued by a freight forwarder instead of a regular airline, then the AWB is called House Air Waybill (HAWB)

So that: The Master Air Waybill (MAWB) is issued by the airline and delivered to the consolidator or consolidator. Aerial Knowledge covers a consolidated expedition, indicating the freight agent and/or the consolidator as shipper and the deconsolidator as consignee. However, the Master Air Waybill is the document that certifies each individual shipment of consolidated merchandise. It is issued by the consolidator and/or transitory and contains instructions for the deconsolidation agent.

Name Description
Service name receiveMAWBImp
EndPoint https://ws_pods.hound-express.com/Sabueso/ws/deliveryServices/receiveMAWBImp
Headers https://apis-hound-express.readme.io/docs/the-headers-request
Method POST
Parameters JsonObject see: The guide object

📘
### Request
To carry out the consumption of the service for the creation of the order it is necessary to send a json object of the MAWB type that contains the following fields:
MAWB/ BOL
Field name
Type
MaxLength
Required
Comments
mawb_number
String
30
Required
In this field, you must enter your BOL number.
mawb_object
Package

Required
General mawb data, some values are decimal, integer and text.
manifest_type
String
10-11
Required
USA-MEX = Origin from USA to destination MEX
MEX-USA = MEX origin to USA destination.
mawb_content
Guide (Array)

Required
This field must contain all the HAWB numbers, the numbers added here must correspond to the assigned tracking guide number generated using the
create order service
, if the order was created before you only need to fill the field guideNumber of each element of the array
expected_arrive_date
String
20
Optional
Please inform us about the date when the MAWB will arrive with us
the spected format of the string is: yyyy-MM-dd HH:mm:ss using 24h standard
MAWB CONTENT
Field Name
Type
maxLength
Required
Comments
guideNumber
String
30
Required
Guide number of HAWB
saca
String
30
Optional
it´s the bag id or your cartoon number of your product, or house
description_complementary
String
100
Optional
This field is for additional description
client_reference
String
60
Optional
Client´s Reference of your product in the case exists if not exists you can use a dummy. The BOL number must be entered
zip code
String
5
Optional
Zip of your consignee
rfc_curp
String
18
Optional
RFC: It is the unique registration key that identifies any person who carries out an economic activity and must contribute to public spending before the SAT.
CURP: The Unique Population Registration Code (CURP) is an instrument that individually registers all inhabitants of the country, both nationals and foreign residents, as well as Mexican men and women who live in other countries.
The tax identification number of the country of residence or the social security number in the case of foreigners.
piece
Integer

Required
Min 1 piece
valor_declarado
Float
10,2
Required
enter the declared value of the merchandise, since in Mexico and other countries there is a regulation in which the law requires the value of the merchandise to be declared and the description of the material contained in the shipment to be announced.
packagePieces
Package (Array)
Package (Array)
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

( This section is only for users who don’t generate guides with Hound Express.)
🚧
This section is only for users who don’t generate guides with Hound Express. If that’s not your case, you can skip it. If have duds, don’t forget you can use our artificial intelligence to generate an example
packagePieces
Field Name
Type
Maxlength
Required
Comments
declaredValue
Float
10,2
Required
enter the declared value of the merchandise, since in Mexico and other countries there is a regulation in which the law requires the value of the merchandise to be declared and the description of the material contained in the shipment to be announced.
description
String
500
Optional
Use this field to enter the description of the contents of the package
descriptionSpanish
String
500
Optional
Use this field to enter the description spanish of the contents of the package
height
Integer
9
Required
In centimeters.
It must be an integer number.
hts_code
Integer
10
Min 6
Optional
HTS stands for Harmonized Tariff Schedule, a classification system used in the United States to help determine customs duties to be paid on imports. HTS codes are 10-digits (the first six digits are the same as the HS code for the goods).
weight
Float
10,2
Required
In kilograms.
It may be a number with decimal point, and there must be a maximum of two figures after it. If the value contains more than two, the following figures will be ignored.
Example: if the user inputs 6.2375, the system will record 6.23
items
Item(Array)

Optional
In this field, you can specify the information for each item contained in the package
Items
Field Name Type Maxlength Required Comments
actual_weight Float 7.1 Required In kilograms. Min 0.1
country String 2 Optional Country item
declared_currency String 3 Required USD (CODIGO de ISO-4217 )
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.
description String 100 Required Item description
height Float 99.9 Required In centimeters. Min 0.1
length Float 99.9 Required In centimeters. Min 0.1
quantity Integer 99 Required Min. 1 piece
width Float 99.9 Required In centimeters. Min 0.1
MAWB OBJECT
Field name
Type
maxlength
Required
Comments
bultos
Integer
5
Required
Mawb lumps
colocacion
String
3
Required
Indicate the customs office of arrival if your arrival is to: MEX-USA, you must indicate NLR. If it is USA-MEX, you must indicate any of the following: NLR, MEX, GDL, NLU.
id_origen
Integer
2
Required
If the origin of the shipment is for MX origin, write 26, otherwise type 19.
paquetes
Integer
5
Required
Number of mawb packets
physicalWeight
Double
5
Required
Physical weight of the mawb
In kilograms.
volumetricWeight
Double
5
Required
Volumetric weight of the mawb Please review the section “VolumetricWeight.”
weigth
Double
5
Required
Weight of the mawb
In kilograms.
carrier
String
5
opcional
This field is for the carrier

🚧
VolumetricWeight
Is a measure used in logistics and shipping to determine how much space a package occupies in relation to its actual weight.
It is calculated using the formula:
Volumetric Weight = (length × height × width) / 5000
where the dimensions are in centimeters and the result is in kilograms.

Response

👍
Successful response
Field Name Type Comments
type String Severity of the success
code String Success code
description String Description with the details of manifest create

❗️
### Failed Response

wsErrors elements

Field Name Type Comments
type String Severity of the error
code String Error code
description String Description with more details of the detected error

❗️
### Errors
Type Code Description
error ECGOFJ The object json is malformed, it must have a correctr structure, please verify the documentation on: [URL API DOCS]
error NOMAWBF The field: mawb_format_fileName must not be empty
error NOMAWBC The field: mawb_format must not be null and must have the byteArray of the digitalized MAWB
error NOMAWBDF The field: Expected_arrive_date must be on yyyy-MM-dd HH:mm:ss format
error NOWEIG The field: weight in mawb object is requered
error NOPAQ The field: paquetes in mawb object is requered
error NOPAQ The field: id_origen in mawb object is requered
error NOPAQ The field: physicalWeight in mawb object is requered
error NOPAQ The field: volumetricWeight in mawb object is requered
error NOPAQ The field: colocacion in mawb object is requered
error NOPAQ The field: bultos in mawb object is requered
error NOMAT The field: manifest type in mawb object is requered
error NOMAT The format is incorrect, we expect these two options MEX-USA or USA-MEX, you are sending: ( [MESSAGE] ) please check the information.
error NOMAWBO The field: Mawb object is requered
error ERROR The field: colocacion is incorrect in this case it is USA-MEX the customs can not be NLR, put arrival in AIFA put NLU if not your mawb arrival in CDMX put MEX if not your mawb arrival in GDL put GDL
error ERROR The field: colocacion is incorrect in this case it is MEX-USA the customs can not be NLR, put arrival in AIFA put NLU if not your mawb arrival in CDMX put MEX if not your mawb arrival in GDL put GDL
error ERROR The field: guideNumber not exist, the guide is: ( [MESSAGE] ) please check this data
error ERROR The field: valor_declarado is required on guide: ( [MESSAGE] )
error ERROR The field: peso is required on guide: ( [MESSAGE] )
error ERROR we detect an error: ( [MESSAGE] )