Pre checkout

post
Pre Checkout

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.
Request
Response
Request
Headers
content-language
required
string
es/en
Bearer Token
required
string
Token de autenticación del usuario.
Body Parameters
address
optional
string
Dirección del punto de entrega
latitude
optional
number
Coordenada de latitud del punto de entrega del pedido.
longitude
optional
number
Coordenada de longitud del punto de entrega del pedido.
Response
200: OK
{
"statusCode": 200,
"message": "Success",
"data": {
"deliveryFee": 2.07
}
}
400: Bad Request
{
"statusCode": 400,
"error": "Bad Request",
"message": "child 'latitude' fails because ['latitude' is required]",
"validation": {
"source": "payload",
"keys": [
"latitude"
]
}
}
409: Conflict
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.