Cotización

Con este endpoint se realiza la cotización (tarifas) de la operadora. A continuación las pautas para la construcción del mismo.

Request

{
    // Dirección de origen
    "origin": {

        // nombre del país
        "country": "Colombia",

        // nombre del estado
        "state": "Bogotá",

        // nombre de la ciudad
        "city": "Bogotá",

        // código nacional de la ciudad (opcional, para colombia es el código dane)
        "city_code": "11001",

        // código postal (opcional)
        "zip_code": "11001",

        // dirección
        "address": "Cra 7 # 32-95",

        // complemento de la dirección (opcional)
        "address_complement": "Edificio Torre 7 Piso 5",

        // coordenadas de la dirección (opcional)
        "lat": 4.648625,
        "lng": -74.063644
    },

    // Dirección de destino
    // La estructura es la misma que la dirección de origen
    "destination": {
        "country": "Colombia",
        "state": "Antioquia",
        "city": "Medellín",
        "city_code": "05001",
        "zip_code": "05001",
        "address": "Cra 70 # 52-21",
        "address_complement": "Edificio Torre 5 Piso 3",
        "lat": 6.251840,
        "lng": -75.563591
    },

    // Información del cliente
    "customer": {
        "identification": "123456789",
        "name": "Jane Doe",
        "phone": "3001234567",
        "email": "jane@doe.com",
    },

    // Valor declarado de la mercancía
    "declared_value": 10000,
    
     // Indica si el envío es contraentrega
    "is_cod": false,

    // Valor de la contraentrega en caso de ser contraentrega
    "cod_value": 0,

    // lista de paquetes a enviar
    "packages": [
        {
            // peso del paquete en gramos
            "weight": 2000,

            // alto del paquete en centímetros
            "height": 10,

            // ancho del paquete en centímetros
            "width": 10,

            // largo del paquete en centímetros
            "length": 10
        }
    ]

}

Response

{
    // lista de cotizaciones
    // puede ser una o varias cotizaciones en caso de que la operadora tenga varios servicios
    "data": [
        {
            // identificador de la cotización, este id se enviará en la creación de envío
            // puede ser opcional
            "id": "string",

            // tiempo de entrega en horas
            "delivery_time": 24,

            // precio de la cotización
            "price": 10000,

            // comisión por contraentrega
            "cod_commission": 0,

            // nombre del servicio
            "service_name": "Servicio con entrega en 24 horas"
        }
    ],

    // Mensaje de error si existe, si no existe no enviar este campo
    "error": ""
}