Saltar a contenido

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 notificationType y messages: vea Respuestas.
  • Si un valor no es válido, la respuesta trae notificationType: 1 y los motivos en messages, 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.