ShippingQuote¶
Cotiza un envío sin crearlo. Los precios dependen de su acuerdo con Servientrega USA. Para crear la guía aérea, use GenerateAWBData.
URL¶
POST https://ocelot.servientrega.us/api/KiwiService20/kwapi/ShippingQuote
POST https://ocelotkiwi.azurewebsites.net/api/KiwiService20/kwapi/ShippingQuote
Parámetros¶
Se envían como JSON (Content-Type: application/json).
| Nombre | Tipo | Obligatorio | Reglas |
|---|---|---|---|
userId |
texto | Sí | Su usuario de Kiwi (el mismo con el que pide el token) |
password |
texto | Sí | Su contraseña de Kiwi. Distingue mayúsculas y minúsculas |
senderCity |
texto | Sí | Ciudad del remitente. Para envíos desde fuera de Estados Unidos, use MIAMI |
senderState |
texto | Sí | Estado del remitente. Para envíos desde fuera de Estados Unidos, use FL |
senderCountry |
texto | Sí | País del remitente, código ISO de 2 letras. Para envíos desde fuera de Estados Unidos, use US |
recipientCity |
texto | Sí | Nombre de la ciudad de destino, como aparece en el listado de ciudades de destino, o su código oficial |
recipientState |
texto | Condicional | Departamento, provincia o estado. Obligatorio si recipientCity es un nombre; opcional con el código oficial |
destinationCountry |
texto | Sí | País de destino, código ISO de 2 letras: CO Colombia, EC Ecuador |
units |
número | No | Siempre 1 |
weight |
número | Sí | Peso en libras (o kilos, ver unitWeight), hasta 3 decimales |
unitWeight |
texto | No | LB (por defecto) o KG. Con KG, weight se convierte a libras. Las medidas van siempre en pulgadas |
declaredValue |
número | Sí | Valor declarado en USD, mayor que 0, hasta 2 decimales |
long |
número | No | Largo en pulgadas, hasta 2 decimales |
wide |
número | No | Ancho en pulgadas, hasta 2 decimales |
high |
número | No | Alto en pulgadas, hasta 2 decimales |
shippingType |
texto | Sí | SPX, DOC, CTC o BFR. Vea Tipos de envío y posiciones arancelarias |
tariffPosition |
texto | Sí | Posición arancelaria. Vea Tipos de envío y posiciones arancelarias |
Nota
Use punto (.) como separador decimal en todos los números.
Las unidades no son iguales a las de GenerateAWBData
ShippingQuote convierte kilos a libras cuando unitWeight es KG;
GenerateAWBData no. Para que la cotización coincida con la guía, envíe el peso en libras
(LB) en los dos métodos.
Ejemplo de petición¶
curl -X POST "https://ocelot.servientrega.us/api/KiwiService20/kwapi/ShippingQuote" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d @quote.json
curl -X POST "https://ocelotkiwi.azurewebsites.net/api/KiwiService20/kwapi/ShippingQuote" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d @quote.json
quote.json:
{
"userId": "<YOUR_USERNAME>",
"password": "<YOUR_PASSWORD>",
"senderCity": "MIAMI",
"senderState": "FL",
"senderCountry": "US",
"recipientCity": "MEDELLIN",
"recipientState": "ANTIOQUIA",
"destinationCountry": "CO",
"units": 1,
"weight": 8.000,
"unitWeight": "LB",
"declaredValue": 100.00,
"long": 10.00,
"wide": 7.00,
"high": 2.00,
"shippingType": "SPX",
"tariffPosition": "98.07.20.00.00"
}
Ejemplo de respuesta¶
{
"result": true,
"entities": [
{
"freightValue": 13.90,
"overFreightValue": 0.00,
"taxValue": 0.00,
"valueOthers": 0.00,
"totalValue": 13.90,
"volumeInvoice": 0
}
],
"messages": [
"Liquidated AWB"
],
"notificationType": 3
}
| Campo | Significado |
|---|---|
freightValue |
Flete |
overFreightValue |
Sobreflete |
taxValue |
Impuestos |
valueOthers |
Otros cargos |
totalValue |
Total |
volumeInvoice |
Siempre 0 en este método |
Notas¶
- Revise
notificationTypeymessages: vea Respuestas. - Si un valor no es válido, la respuesta trae
notificationType: 1y los motivos enmessages, por ejemplo"- City destination provided not found."o"- Declared value is required.". Pueden venir varios motivos en el mismo mensaje. - La cotización no crea la guía ni reserva el precio.