Skip to content

Cotizar envíos

Descripción General

Esta API permite obtener estimaciones de tarifas para envíos a través de Ridery, basado en la ubicación de origen y destino. Antes de poder crear un envío es necesario crear una cotización

Endpoint

URL: baseURL/V2/corporate-api-partner/get-fare-estimates-shipments

Método: POST

Solicitud

Cuerpo de la Solicitud (sin location_id)

bash
{
    "sourceLocation": [
        10.4346014,
        -66.862743
    ],
    "destinationLocation": [
        10.4970614,
        -66.8879179
    ],
    "source_address": "Este es el inicio de la ruta",
    "destination_address": "Esta es la direccion final de la ruta"
}

Cuerpo de la Solicitud (con location_id)

bash
{
    "location_id": "x1",
    "destinationLocation": [
        10.4970614,
        -66.8879179
    ],
    "destination_address": "Esta es la direccion final de la ruta"
}

Descripción de los Campos

CampoDescripciónTipoRequerido/ Opcional
sourceLocationCoordenadas de la ubicación de origen [latitud, longitud]Array (float)Requerido si no se usa location_id
destinationLocationCoordenadas de la ubicación de destino [latitud, longitud]Array (float)Requerido
source_addressDirección de inicio de la rutaCadena de textoOpcional si se usa location_id, Requerido si no se usa location_id
destination_addressDirección final de la rutaCadena de textoRequerido
location_idID único de locación previamente configurada por administradorCadena de textoOpcional

Respuesta

Ejemplo de Respuesta Exitosa

bash
{
    "success": true,
    "code": "00",
    "msg": "ok",
    "data": {
        "fares": {
            "corporate_wallet_amount": 11819.47,
            "time": 14.84,
            "distance": 12.5905,
            "city_types": [
                {
                    "city_type_id": "62bf1af16b60baf9ac4c27e3",
                    "typename": "Envíos Moto",
                    "fare": 5,
                    "max_package_depth": 20,
                    "max_package_height": 15,
                    "max_package_weight": 5,
                    "max_package_width": 10
                },
                {
                    "city_type_id": "6304eed60bb78f6407c7c904",
                    "typename": "Envíos Económico",
                    "fare": 9.56,
                    "max_package_depth": 20,
                    "max_package_height": 32,
                    "max_package_weight": 25,
                    "max_package_width": 32
                }
            ],
            "fare_id": "667c5c3b8d79d5cbb016e073"
        }
    }
}

Descripción de los Campos de la Respuesta

CampoDescripciónTipo
successIndica si la solicitud fue exitosaBoolean
codeCódigo de estado de la respuestaString
msgMensaje de la respuestaString
dataDatos de la respuestaObject
faresInformación de tarifasObject
corporate_wallet_amountMonto disponible en el balance corporativoNumber
timeTiempo estimado de viaje en minutosNumber
distanceDistancia estimada del viaje en kilómetrosNumber
city_typesLista de tipos de ciudad con sus tarifas y restriccionesArray (Object)
city_type_idID del servicioString
typenameNombre del servicioString
fareTarifa del servicioNumber
max_package_depthProfundidad máxima del paquete en cmNumber
max_package_heightAltura máxima del paquete en cmNumber
max_package_weightPeso máximo del paquete en kgNumber
max_package_widthAncho máximo del paquete en cmNumber
fare_idID de la tarifa generada. Este ID se utiliza para crear un viajeString

TIP

Esta cotización tiene una expiración de 7 días calendario a partir de una respuesta exitosa del servidor.

TIP

Esta puede ser reutilizada si no se ubica conductor en el primer request

Hecho con ❤️ en Venezuela