Cotizar un envío de última milla
curl --request POST \
--url https://api.service.getjusto.com/v3/admin/last-mile/quotes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"storeIds": [
"bodega-providencia",
"bodega-las-condes"
],
"toAddress": {
"line": "Av. Apoquindo 4500, depto 1203, Las Condes",
"countryCode": "CL"
},
"package": {
"weightKg": 1.2,
"lengthCm": 30,
"widthCm": 20,
"heightCm": 10,
"valueAmount": 25990
},
"pickupAt": "2026-11-03T13:00:00.000Z",
"externalId": "FL-000123"
}
'import requests
url = "https://api.service.getjusto.com/v3/admin/last-mile/quotes"
payload = {
"storeIds": ["bodega-providencia", "bodega-las-condes"],
"toAddress": {
"line": "Av. Apoquindo 4500, depto 1203, Las Condes",
"countryCode": "CL"
},
"package": {
"weightKg": 1.2,
"lengthCm": 30,
"widthCm": 20,
"heightCm": 10,
"valueAmount": 25990
},
"pickupAt": "2026-11-03T13:00:00.000Z",
"externalId": "FL-000123"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
storeIds: ['bodega-providencia', 'bodega-las-condes'],
toAddress: {line: 'Av. Apoquindo 4500, depto 1203, Las Condes', countryCode: 'CL'},
package: {weightKg: 1.2, lengthCm: 30, widthCm: 20, heightCm: 10, valueAmount: 25990},
pickupAt: '2026-11-03T13:00:00.000Z',
externalId: 'FL-000123'
})
};
fetch('https://api.service.getjusto.com/v3/admin/last-mile/quotes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.service.getjusto.com/v3/admin/last-mile/quotes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'storeIds' => [
'bodega-providencia',
'bodega-las-condes'
],
'toAddress' => [
'line' => 'Av. Apoquindo 4500, depto 1203, Las Condes',
'countryCode' => 'CL'
],
'package' => [
'weightKg' => 1.2,
'lengthCm' => 30,
'widthCm' => 20,
'heightCm' => 10,
'valueAmount' => 25990
],
'pickupAt' => '2026-11-03T13:00:00.000Z',
'externalId' => 'FL-000123'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.service.getjusto.com/v3/admin/last-mile/quotes"
payload := strings.NewReader("{\n \"storeIds\": [\n \"bodega-providencia\",\n \"bodega-las-condes\"\n ],\n \"toAddress\": {\n \"line\": \"Av. Apoquindo 4500, depto 1203, Las Condes\",\n \"countryCode\": \"CL\"\n },\n \"package\": {\n \"weightKg\": 1.2,\n \"lengthCm\": 30,\n \"widthCm\": 20,\n \"heightCm\": 10,\n \"valueAmount\": 25990\n },\n \"pickupAt\": \"2026-11-03T13:00:00.000Z\",\n \"externalId\": \"FL-000123\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.service.getjusto.com/v3/admin/last-mile/quotes")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"storeIds\": [\n \"bodega-providencia\",\n \"bodega-las-condes\"\n ],\n \"toAddress\": {\n \"line\": \"Av. Apoquindo 4500, depto 1203, Las Condes\",\n \"countryCode\": \"CL\"\n },\n \"package\": {\n \"weightKg\": 1.2,\n \"lengthCm\": 30,\n \"widthCm\": 20,\n \"heightCm\": 10,\n \"valueAmount\": 25990\n },\n \"pickupAt\": \"2026-11-03T13:00:00.000Z\",\n \"externalId\": \"FL-000123\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.service.getjusto.com/v3/admin/last-mile/quotes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"storeIds\": [\n \"bodega-providencia\",\n \"bodega-las-condes\"\n ],\n \"toAddress\": {\n \"line\": \"Av. Apoquindo 4500, depto 1203, Las Condes\",\n \"countryCode\": \"CL\"\n },\n \"package\": {\n \"weightKg\": 1.2,\n \"lengthCm\": 30,\n \"widthCm\": 20,\n \"heightCm\": 10,\n \"valueAmount\": 25990\n },\n \"pickupAt\": \"2026-11-03T13:00:00.000Z\",\n \"externalId\": \"FL-000123\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"id": "lmq-0193...",
"status": "open",
"expiresAt": "2020-01-01T00:00:00.000Z",
"pickupAt": "2020-01-01T00:00:00.000Z",
"estimatedDeliveryAt": "2020-01-01T00:00:00.000Z",
"store": {
"storeId": "<string>",
"name": "<string>"
},
"fromAddress": {
"streetAddress": "<string>",
"extendedAddress": "<string>",
"locality": "<string>",
"region": "<string>",
"countryCode": "<string>",
"location": {
"lat": -33.4290115,
"lng": -70.6211027
}
},
"toAddress": {
"streetAddress": "<string>",
"extendedAddress": "<string>",
"locality": "<string>",
"region": "<string>",
"countryCode": "<string>",
"location": {
"lat": -33.4290115,
"lng": -70.6211027
}
},
"package": {
"weightKg": 1.2,
"lengthCm": 30,
"widthCm": 20,
"heightCm": 10,
"valueAmount": 25990
},
"vehicleType": "moto",
"distanceMeters": 123,
"price": 123,
"priceWithTax": 123,
"currency": "<string>",
"externalId": "<string>",
"deliveryId": "<string>",
"createdAt": "2020-01-01T00:00:00.000Z"
}
}{
"success": "false",
"error": {
"error": "error",
"message": "The request has an error"
}
}Envíos
Cotizar un envío
Cotiza un paquete desde uno de tus locales hasta una dirección y guarda la cotización con un id. La cotización garantiza el precio y la hora de retiro (pickupAt) hasta expiresAt (20 minutos por defecto). Justo ubica la dirección (si no envías coordenadas), elige el local candidato más cercano que esté abierto y mide la distancia por calle. pickupAt es la hora de retiro que Justo asegura. El precio sale de la tarifa acordada con tu cuenta. Errores: addressNotFound, storeNotFound, storeClosed (ningún local está abierto para el retiro; el mensaje dice cuándo abre), distanceTooLong (más de 20 km), packageTooLarge, vehicleNotAvailable, noTariff.
POST
/
admin
/
last-mile
/
quotes
Cotizar un envío de última milla
curl --request POST \
--url https://api.service.getjusto.com/v3/admin/last-mile/quotes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"storeIds": [
"bodega-providencia",
"bodega-las-condes"
],
"toAddress": {
"line": "Av. Apoquindo 4500, depto 1203, Las Condes",
"countryCode": "CL"
},
"package": {
"weightKg": 1.2,
"lengthCm": 30,
"widthCm": 20,
"heightCm": 10,
"valueAmount": 25990
},
"pickupAt": "2026-11-03T13:00:00.000Z",
"externalId": "FL-000123"
}
'import requests
url = "https://api.service.getjusto.com/v3/admin/last-mile/quotes"
payload = {
"storeIds": ["bodega-providencia", "bodega-las-condes"],
"toAddress": {
"line": "Av. Apoquindo 4500, depto 1203, Las Condes",
"countryCode": "CL"
},
"package": {
"weightKg": 1.2,
"lengthCm": 30,
"widthCm": 20,
"heightCm": 10,
"valueAmount": 25990
},
"pickupAt": "2026-11-03T13:00:00.000Z",
"externalId": "FL-000123"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
storeIds: ['bodega-providencia', 'bodega-las-condes'],
toAddress: {line: 'Av. Apoquindo 4500, depto 1203, Las Condes', countryCode: 'CL'},
package: {weightKg: 1.2, lengthCm: 30, widthCm: 20, heightCm: 10, valueAmount: 25990},
pickupAt: '2026-11-03T13:00:00.000Z',
externalId: 'FL-000123'
})
};
fetch('https://api.service.getjusto.com/v3/admin/last-mile/quotes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.service.getjusto.com/v3/admin/last-mile/quotes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'storeIds' => [
'bodega-providencia',
'bodega-las-condes'
],
'toAddress' => [
'line' => 'Av. Apoquindo 4500, depto 1203, Las Condes',
'countryCode' => 'CL'
],
'package' => [
'weightKg' => 1.2,
'lengthCm' => 30,
'widthCm' => 20,
'heightCm' => 10,
'valueAmount' => 25990
],
'pickupAt' => '2026-11-03T13:00:00.000Z',
'externalId' => 'FL-000123'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.service.getjusto.com/v3/admin/last-mile/quotes"
payload := strings.NewReader("{\n \"storeIds\": [\n \"bodega-providencia\",\n \"bodega-las-condes\"\n ],\n \"toAddress\": {\n \"line\": \"Av. Apoquindo 4500, depto 1203, Las Condes\",\n \"countryCode\": \"CL\"\n },\n \"package\": {\n \"weightKg\": 1.2,\n \"lengthCm\": 30,\n \"widthCm\": 20,\n \"heightCm\": 10,\n \"valueAmount\": 25990\n },\n \"pickupAt\": \"2026-11-03T13:00:00.000Z\",\n \"externalId\": \"FL-000123\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.service.getjusto.com/v3/admin/last-mile/quotes")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"storeIds\": [\n \"bodega-providencia\",\n \"bodega-las-condes\"\n ],\n \"toAddress\": {\n \"line\": \"Av. Apoquindo 4500, depto 1203, Las Condes\",\n \"countryCode\": \"CL\"\n },\n \"package\": {\n \"weightKg\": 1.2,\n \"lengthCm\": 30,\n \"widthCm\": 20,\n \"heightCm\": 10,\n \"valueAmount\": 25990\n },\n \"pickupAt\": \"2026-11-03T13:00:00.000Z\",\n \"externalId\": \"FL-000123\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.service.getjusto.com/v3/admin/last-mile/quotes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"storeIds\": [\n \"bodega-providencia\",\n \"bodega-las-condes\"\n ],\n \"toAddress\": {\n \"line\": \"Av. Apoquindo 4500, depto 1203, Las Condes\",\n \"countryCode\": \"CL\"\n },\n \"package\": {\n \"weightKg\": 1.2,\n \"lengthCm\": 30,\n \"widthCm\": 20,\n \"heightCm\": 10,\n \"valueAmount\": 25990\n },\n \"pickupAt\": \"2026-11-03T13:00:00.000Z\",\n \"externalId\": \"FL-000123\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"id": "lmq-0193...",
"status": "open",
"expiresAt": "2020-01-01T00:00:00.000Z",
"pickupAt": "2020-01-01T00:00:00.000Z",
"estimatedDeliveryAt": "2020-01-01T00:00:00.000Z",
"store": {
"storeId": "<string>",
"name": "<string>"
},
"fromAddress": {
"streetAddress": "<string>",
"extendedAddress": "<string>",
"locality": "<string>",
"region": "<string>",
"countryCode": "<string>",
"location": {
"lat": -33.4290115,
"lng": -70.6211027
}
},
"toAddress": {
"streetAddress": "<string>",
"extendedAddress": "<string>",
"locality": "<string>",
"region": "<string>",
"countryCode": "<string>",
"location": {
"lat": -33.4290115,
"lng": -70.6211027
}
},
"package": {
"weightKg": 1.2,
"lengthCm": 30,
"widthCm": 20,
"heightCm": 10,
"valueAmount": 25990
},
"vehicleType": "moto",
"distanceMeters": 123,
"price": 123,
"priceWithTax": 123,
"currency": "<string>",
"externalId": "<string>",
"deliveryId": "<string>",
"createdAt": "2020-01-01T00:00:00.000Z"
}
}{
"success": "false",
"error": {
"error": "error",
"message": "The request has an error"
}
}Cotiza un paquete desde uno de tus locales hasta una dirección y guarda la cotización con un
id. La cotización garantiza el precio (priceWithTax) y la hora de retiro (pickupAt) hasta expiresAt, que por defecto es 20 minutos después de cotizar. Para usarla, envía su id a Crear un envío antes de que venza.
Indica el local de origen con storeId o con varios candidatos en storeIds (hasta 20); Justo cotiza desde el más cercano al destino que esté abierto para el retiro. Sin ninguno de los dos, considera todos los locales de tu cuenta que piden despachos. Según el peso y las medidas del paquete, Justo envía un repartidor en un vehículo que pueda transportarlo; si no cabe en una moto, va en auto con un recargo fijo incluido en el precio, y el local debe tener acceptsCar: true. Envía pickupAt si el paquete estará listo más tarde. El pickupAt de la respuesta es la hora de retiro que Justo te asegura.
Revisa los códigos de error y los formatos de dirección en la introducción.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Dirección. Puedes mandarla en una sola línea (line, por ejemplo "Av. Providencia 1234, depto 501, Providencia") o por campos. Las coordenadas son opcionales: si no vienen, Justo ubica la dirección. Si no la puede ubicar con certeza, la cotización responde addressNotFound.
Show child attributes
Show child attributes
Example:
{
"line": "Av. Apoquindo 4500, Las Condes",
"countryCode": "CL"
}
Paquete a despachar. Según su peso y sus medidas, Justo envía un repartidor en un vehículo que pueda transportarlo. Si el paquete necesita un auto, el local debe tener acceptsCar: true y el precio incluye un recargo fijo por auto.
Show child attributes
Show child attributes
Example:
{
"weightKg": 1.2,
"lengthCm": 30,
"widthCm": 20,
"heightCm": 10,
"valueAmount": 25990
}
Local desde donde sale el paquete (ID Justo o tu externalId). Ver GET /stores y POST /stores.
Varios locales candidatos (por ejemplo, los que tienen stock). Justo cotiza desde el más cercano al destino que esté abierto para el retiro, según el horario del local (PATCH /ecommerce/stores/{storeId}/schedule). Sin storeId ni storeIds, considera todos los locales de la cuenta que piden despachos.
Maximum array length:
20Desde cuándo el paquete está listo para retirarse. Si no lo envías, desde ahora.
Example:
"2020-01-01T00:00:00.000Z"
Tu identificador del envío. Se copia a la entrega y evita duplicados si reintentas la creación.