Manifiesto de Importación y Exportación Terrestre

mawbIMP

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
🚧

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.

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.

📘

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 nameTypeMaxLengthRequiredComments
mawb_numberString30RequiredIn this field, you must enter your BOL number.
mawb_objectPackage

RequiredGeneral mawb data, some values are decimal, integer and text.
manifest_typeString10-11Required

USA-MEX = Origin from USA to destination MEX

MEX-USA = MEX origin to USA destination.

mawb_contentGuide (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_dateString20Optional

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 NameTypemaxLengthRequiredComments
guideNumberString30RequiredGuide number of HAWB
sacaString30Optionalit´s the bag id or your cartoon number of your product, or house
description_complementaryString100OptionalThis field is for additional description
client_referenceString60OptionalClient´s Reference of your product in the case exists if not exists you can use a dummy. The BOL number must be entered
zip codeString5OptionalZip of your consignee
rfc_curpString18Optional

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.

pieceInteger

RequiredMin 1 piece
valor_declaradoFloat10,2Requiredenter 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.
packagePiecesPackage (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 NameTypeMaxlengthRequiredComments
heightInteger9Required

In centimeters.

It must be an integer number.

lengthIntegerMin Lenght: 1Required

In centimeters. This field is for the parcel measurements.

It must be an integer number.

widthIntegerMin Lenght: 1Required

In centimeters. This field is for the parcel measurements.

It must be an integer number.

weightFloat10,2Required

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

descriptionString500OptionalUse this field to enter the description of the contents of the package
declaredValueFloat10,2Requiredenter 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.
descriptionSpanishString500OptionalUse this field to enter the description spanish of the contents of the package
pieceIntegerMin Lenght: 1Required

Is the sum for each item

It is the TOTAL quantity of items that the package contains, regardless their variety.

Example: Assuming the shipment contains mice and cables, the pieces field must include the total number of articles:

For this example, if you bring 5 mice and 4 cables, the piece field should be filled as 9.

We fully understand that sometimes you have this information repeated for several shipments, so just as in the other cases you can place a fixed value.

made_inStringMax Lenght: 3StringIn this field, the CatCountryCode catalog code_alpha_3 must be sent. This field refers to the physical location of the final production of an item (where the product was manufactured).
itemsItem(Array)

OptionalIn this field, you can specify the information for each item contained in the package

Items

Field NameTypeMaxlengthRequiredComments
quantityInteger99RequiredMin. 1 piece
descriptionString100RequiredItem description
declaredValueFloatMin Lenght: 0.1RequiredIn Mexico and other countries there is a regulation requiring the merchandise value to be declared and the shipment contents to be described.)
htsCodeString30RequiredHTS 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).
made_inString3RequiredIn this field, the CatCountryCode catalog code_alpha_3 must be sent. This field refers to the physical location of the final production of an item (where the product was manufactured.
skuString500OpttionalSKU Item

MAWB OBJECT

Field nameTypemaxlengthRequiredComments
bultosInteger5RequiredMawb lumps
colocacionString3RequiredIndicate 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_origenInteger2RequiredIf the origin of the shipment is for MX origin, write 26, otherwise type 19.
paquetesInteger5RequiredNumber of mawb packets
physicalWeightDouble5RequiredPhysical weight of the mawb
In kilograms.
volumetricWeightDouble5RequiredVolumetric weight of the mawb Please review the section “VolumetricWeight.”
weigthDouble5RequiredWeight of the mawb
In kilograms.
carrierString5opcionalThis 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 NameTypeComments
typeStringSeverity of the success
codeStringSuccess code
descriptionStringDescription with the details of manifest create
❗️

Failed Response

wsErrors elements

Field NameTypeComments
typeStringSeverity of the error
codeStringError code
descriptionStringDescription with more details of the detected error

❗️

Errors

TypeCodeDescription
errorECGOFJThe object json is malformed, it must have a correctr structure, please verify the documentation on: [URL API DOCS]
errorNOMAWBFThe field: mawb_format_fileName must not be empty
errorNOMAWBCThe field: mawb_format must not be null and must have the byteArray of the digitalized MAWB
errorNOMAWBDFThe field: Expected_arrive_date must be on yyyy-MM-dd HH:mm:ss format
errorNOWEIGThe field: weight in mawb object is requered
errorNOPAQThe field: paquetes in mawb object is requered
errorNOPAQThe field: id_origen in mawb object is requered
errorNOPAQThe field: physicalWeight in mawb object is requered
errorNOPAQThe field: volumetricWeight in mawb object is requered
errorNOPAQThe field: colocacion in mawb object is requered
errorNOPAQThe field: bultos in mawb object is requered
errorNOMATThe field: manifest type in mawb object is requered
errorNOMATThe format is incorrect, we expect these two options MEX-USA or USA-MEX, you are sending: ( [MESSAGE] ) please check the information.
errorNOMAWBOThe field: Mawb object is requered
errorERRORThe 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
errorERRORThe 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
errorERRORThe field: guideNumber not exist, the guide is: ( [MESSAGE] ) please check this data
errorERRORThe field: valor_declarado is required on guide: ( [MESSAGE] )
errorERRORThe field: peso is required on guide: ( [MESSAGE] )
errorERRORwe detect an error: ( [MESSAGE] )
Body Params
string
string
string
mawb_object
object
mawb_content
array
mawb_content
Headers
string
Response
200

OK

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here!