Pre checkout

Pre Checkout

POST https://api.pickerexpress.com/api/preCheckout

Este endpoint calcula el precio exacto de delivery basado en la distancia entre los puntos de recogida y entrega.

Headers

Name	Type	Description
content-language	string	es/en
Bearer Token	string	Token de autenticación del usuario.

Request Body

Name	Type	Description
address	string	Dirección del punto de entrega
latitude	number	Coordenada de latitud del punto de entrega del pedido.
longitude	number	Coordenada de longitud del punto de entrega del pedido.

200

{
    "statusCode": 200,
    "message": "Success",
    "data": {
        "deliveryFee": 2.07
    }
}

400

{
    "statusCode": 400,
    "error": "Bad Request",
    "message": "child 'latitude' fails because ['latitude' is required]",
    "validation": {
        "source": "payload",
        "keys": [
            "latitude"
        ]
    }
}

409 Se devuelve este error cuando el punto de delivery se encuentra a una distancia mayor a la permitida por el negocio.

{
    "statusCode": 400,
    "error": "Conflict",
    "message": "Sorry, we don't have coverage in this area yet
}

Existen 2 manera para consultar el precio del delivery con este endpoint:

• Por geolocalización (Recomendado): Se envía al request los parámetros de latitude y longitude para determinar el punto exacto de entrega del pedido. A partir de esto, determinamos el precio de acuerdo al tarifario establecido. Si se envía los parámetros de latitude y longitude, ya no es necesario enviar el parámetro address.

• Por dirección: En el caso de no tener una geolocalización, es posible enviar la dirección en el parámetro address. Al enviar solo la dirección, en nuestro sistema intentamos convertir la dirección en una geolocalización para poder determinar la tarifa a cobrar por la carrera. Tener muy en consideración que si se utiliza este método, el parámetro address debe iniciar con la dirección principal de entrega. Ejemplo: Urbanización Las Palmas, Alborada 2da Etapa (para el caso de urbanizaciones o ciudadelas), 9 de Octubre 1022 y Malecón (para el caso de calles). Al enviar solo address, ya no es necesario enviar los parámetros de latitude y longitude.

El precio del delivery se calcula utilizando la distancia que hay entre los puntos de entrega y recogida.

El punto de entrega es el que se ingresa en el endpoint.

El punto de recogida está seteado en el sistema de acuerdo al usuario que hace el requerimiento.