Crear un envío desde una cotización
curl --request POST \
--url https://api.service.getjusto.com/v3/admin/last-mile/deliveries \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"quoteId": "lmq-0193...",
"receiver": {
"name": "Camila Rojas",
"phone": "+56912345678"
},
"instructions": "Dejar en conserjería"
}
'import requests
url = "https://api.service.getjusto.com/v3/admin/last-mile/deliveries"
payload = {
"quoteId": "lmq-0193...",
"receiver": {
"name": "Camila Rojas",
"phone": "+56912345678"
},
"instructions": "Dejar en conserjería"
}
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({
quoteId: 'lmq-0193...',
receiver: {name: 'Camila Rojas', phone: '+56912345678'},
instructions: 'Dejar en conserjería'
})
};
fetch('https://api.service.getjusto.com/v3/admin/last-mile/deliveries', 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/deliveries",
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([
'quoteId' => 'lmq-0193...',
'receiver' => [
'name' => 'Camila Rojas',
'phone' => '+56912345678'
],
'instructions' => 'Dejar en conserjería'
]),
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/deliveries"
payload := strings.NewReader("{\n \"quoteId\": \"lmq-0193...\",\n \"receiver\": {\n \"name\": \"Camila Rojas\",\n \"phone\": \"+56912345678\"\n },\n \"instructions\": \"Dejar en conserjería\"\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/deliveries")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"quoteId\": \"lmq-0193...\",\n \"receiver\": {\n \"name\": \"Camila Rojas\",\n \"phone\": \"+56912345678\"\n },\n \"instructions\": \"Dejar en conserjería\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.service.getjusto.com/v3/admin/last-mile/deliveries")
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 \"quoteId\": \"lmq-0193...\",\n \"receiver\": {\n \"name\": \"Camila Rojas\",\n \"phone\": \"+56912345678\"\n },\n \"instructions\": \"Dejar en conserjería\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"quote": {
"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"
},
"delivery": {
"_id": "<string>",
"websiteId": "<string>",
"storeId": "<string>",
"orderId": "<string>",
"partner": "<string>",
"status": "active",
"specialCode": "<string>",
"externalId": "<string>",
"price": 123,
"priceWithoutTax": 123,
"tipAmount": 123,
"receiveProofImage": "<string>",
"deliverProofImage": "<string>",
"isCash": true,
"isRoundTrip": true,
"instructions": "<string>",
"fromName": "<string>",
"toName": "<string>",
"fromPlaceId": "<string>",
"toPlaceId": "<string>",
"fromAddressLine2": "<string>",
"toAddressLine2": "<string>",
"fromLocation": {
"address": "<string>",
"addressSecondary": "<string>",
"placeId": "<string>",
"streetAddress": "<string>",
"extendedAddress": "<string>",
"contactPhone": "<string>",
"contactName": "<string>",
"lat": 123,
"lng": 123
},
"toLocation": {
"address": "<string>",
"addressSecondary": "<string>",
"placeId": "<string>",
"streetAddress": "<string>",
"extendedAddress": "<string>",
"contactPhone": "<string>",
"contactName": "<string>",
"lat": 123,
"lng": 123
},
"location": {
"lat": 123,
"lng": 123,
"updatedAt": "2020-01-01T00:00:00.000Z"
},
"driverInformation": {
"name": "<string>",
"code": "<string>",
"type": "<string>"
},
"driverPassword": "<string>",
"trackingURL": "<string>",
"requiresDeliveryVerificationCode": "<string>",
"lastMileQuoteId": "<string>",
"createdAt": "2020-01-01T00:00:00.000Z",
"forDate": "2020-01-01T00:00:00.000Z",
"canceledAt": "2020-01-01T00:00:00.000Z",
"completedAt": "2020-01-01T00:00:00.000Z"
}
}
}{
"success": "false",
"error": {
"error": "error",
"message": "The request has an error"
}
}{
"success": false,
"error": {
"error": "quoteExpired",
"message": "<string>"
}
}Envíos
Crear un envío
Acepta una cotización vigente y crea la entrega con el precio y la hora de retiro cotizados, sin recalcular nada. Se cobra a tu cuenta (si tu cuenta usa saldo prepago, debe alcanzar). Puedes reintentar sin riesgo: la misma cotización siempre devuelve la misma entrega. Responde 409 si la cotización venció. Si aceptas tarde, la hora de retiro puede correrse; si el local ya no está abierto para retirar, responde storeClosed. La entrega trae requiresDeliveryVerificationCode: el código que tu cliente debe decirle al repartidor para cerrar la entrega. Entrégaselo a tu cliente (por ejemplo, en el seguimiento o en un mensaje). Si recibes un error 500 o un timeout, reintenta con la misma cotización: si la entrega alcanzó a crearse, la recibes (en el peor caso, tras 5 minutos). Un externalId ya usado en otra entrega responde externalIdAlreadyUsed. Para seguir la entrega usa GET /deliveries/, el webhook deliveries.delivery.updated y POST /deliveries//cancel para cancelarla.
POST
/
admin
/
last-mile
/
deliveries
Crear un envío desde una cotización
curl --request POST \
--url https://api.service.getjusto.com/v3/admin/last-mile/deliveries \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"quoteId": "lmq-0193...",
"receiver": {
"name": "Camila Rojas",
"phone": "+56912345678"
},
"instructions": "Dejar en conserjería"
}
'import requests
url = "https://api.service.getjusto.com/v3/admin/last-mile/deliveries"
payload = {
"quoteId": "lmq-0193...",
"receiver": {
"name": "Camila Rojas",
"phone": "+56912345678"
},
"instructions": "Dejar en conserjería"
}
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({
quoteId: 'lmq-0193...',
receiver: {name: 'Camila Rojas', phone: '+56912345678'},
instructions: 'Dejar en conserjería'
})
};
fetch('https://api.service.getjusto.com/v3/admin/last-mile/deliveries', 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/deliveries",
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([
'quoteId' => 'lmq-0193...',
'receiver' => [
'name' => 'Camila Rojas',
'phone' => '+56912345678'
],
'instructions' => 'Dejar en conserjería'
]),
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/deliveries"
payload := strings.NewReader("{\n \"quoteId\": \"lmq-0193...\",\n \"receiver\": {\n \"name\": \"Camila Rojas\",\n \"phone\": \"+56912345678\"\n },\n \"instructions\": \"Dejar en conserjería\"\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/deliveries")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"quoteId\": \"lmq-0193...\",\n \"receiver\": {\n \"name\": \"Camila Rojas\",\n \"phone\": \"+56912345678\"\n },\n \"instructions\": \"Dejar en conserjería\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.service.getjusto.com/v3/admin/last-mile/deliveries")
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 \"quoteId\": \"lmq-0193...\",\n \"receiver\": {\n \"name\": \"Camila Rojas\",\n \"phone\": \"+56912345678\"\n },\n \"instructions\": \"Dejar en conserjería\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"quote": {
"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"
},
"delivery": {
"_id": "<string>",
"websiteId": "<string>",
"storeId": "<string>",
"orderId": "<string>",
"partner": "<string>",
"status": "active",
"specialCode": "<string>",
"externalId": "<string>",
"price": 123,
"priceWithoutTax": 123,
"tipAmount": 123,
"receiveProofImage": "<string>",
"deliverProofImage": "<string>",
"isCash": true,
"isRoundTrip": true,
"instructions": "<string>",
"fromName": "<string>",
"toName": "<string>",
"fromPlaceId": "<string>",
"toPlaceId": "<string>",
"fromAddressLine2": "<string>",
"toAddressLine2": "<string>",
"fromLocation": {
"address": "<string>",
"addressSecondary": "<string>",
"placeId": "<string>",
"streetAddress": "<string>",
"extendedAddress": "<string>",
"contactPhone": "<string>",
"contactName": "<string>",
"lat": 123,
"lng": 123
},
"toLocation": {
"address": "<string>",
"addressSecondary": "<string>",
"placeId": "<string>",
"streetAddress": "<string>",
"extendedAddress": "<string>",
"contactPhone": "<string>",
"contactName": "<string>",
"lat": 123,
"lng": 123
},
"location": {
"lat": 123,
"lng": 123,
"updatedAt": "2020-01-01T00:00:00.000Z"
},
"driverInformation": {
"name": "<string>",
"code": "<string>",
"type": "<string>"
},
"driverPassword": "<string>",
"trackingURL": "<string>",
"requiresDeliveryVerificationCode": "<string>",
"lastMileQuoteId": "<string>",
"createdAt": "2020-01-01T00:00:00.000Z",
"forDate": "2020-01-01T00:00:00.000Z",
"canceledAt": "2020-01-01T00:00:00.000Z",
"completedAt": "2020-01-01T00:00:00.000Z"
}
}
}{
"success": "false",
"error": {
"error": "error",
"message": "The request has an error"
}
}{
"success": false,
"error": {
"error": "quoteExpired",
"message": "<string>"
}
}Acepta una cotización vigente y crea la entrega con el precio y la hora de retiro cotizados, sin recalcular nada. Envía el
quoteId y los datos de quien recibe en receiver (nombre y teléfono con código de país). El contacto en el local de retiro (sender) usa por defecto el nombre y el teléfono del local.
La entrega se cobra a tu cuenta de integrador. Si tu cuenta usa saldo prepago, debe alcanzar para cubrirla. La respuesta incluye la cotización aceptada en quote (con status: "accepted", el deliveryId y la hora de retiro definitiva) y la entrega en delivery, con el mismo formato que Obtener una entrega. La entrega trae el código de entrega (requiresDeliveryVerificationCode) que tu cliente debe decirle al repartidor para recibir el paquete: entrégaselo.
Puedes reintentar sin riesgo con los mismos datos: la misma cotización siempre devuelve la misma entrega. Si reintentas con otro externalId u otro valor de simulation mientras la cotización se está aceptando, responde 409 con bookingMismatch. Si la cotización venció responde 409 con quoteExpired, y si otra solicitud la está aceptando en ese momento, 409 con quoteBeingAccepted. Para seguir la entrega usa Obtener una entrega, el webhook deliveries.delivery.updated y Cancelar una entrega.
Para probar tu integración sin repartidores reales, crea el envío desde una cuenta de pruebas con el campo simulation: lo atiende una flota simulada y no se cobra. Ver Probar la integración.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
ID de una cotización vigente (POST /last-mile/quotes).
Quién recibe el paquete.
Show child attributes
Show child attributes
Contacto en el local. Por defecto, el nombre y el teléfono del local.
Show child attributes
Show child attributes
Indicaciones para el repartidor.
Departamento u oficina, si no venía en la dirección cotizada.
Tu identificador del envío. Reemplaza el enviado en la cotización.
Entrega de prueba atendida por la flota simulada de Justo: no se ofrece a repartidores reales ni se cobra, y dispara los mismos webhooks que una entrega real. Solo está disponible para cuentas que todavía no están activas; si tu cuenta ya opera, pide a Justo una cuenta de pruebas (si no, responde simulationNotAllowed). Justo habilita el simulador por zona.
Show child attributes
Show child attributes