Skip to main content
POST
/
admin
/
deliveries
Create delivery without order
curl --request POST \
  --url https://api.service.getjusto.com/v3/admin/deliveries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "storeId": "<string>",
  "fromPlaceId": "<string>",
  "toPlaceId": "<string>",
  "fromName": "<string>",
  "toName": "<string>",
  "fromPhone": "<string>",
  "toPhone": "<string>",
  "fromAddressLine2": "<string>",
  "toAddressLine2": "<string>",
  "instructions": "<string>",
  "isCash": true,
  "amountToPay": 123,
  "cashAmount": 123,
  "isRoundTrip": true,
  "tipAmount": 123,
  "toExpectedDate": "2023-11-07T05:31:56Z",
  "deliveryPriority": 123,
  "sendNotificationToReceiver": true,
  "useCarForDelivery": true,
  "confirmation": true,
  "externalId": "<string>"
}
'
{
  "success": true,
  "data": {
    "_id": "<string>",
    "websiteId": "<string>",
    "storeId": "<string>",
    "orderId": "<string>",
    "partner": "<string>",
    "specialCode": "<string>",
    "externalId": "<string>",
    "price": 123,
    "priceWithoutTax": 123,
    "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
    },
    "driverPassword": "<string>",
    "trackingURL": "<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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.getjusto.com/llms.txt

Use this file to discover all available pages before exploring further.

Crea una entrega sin pedido para la marca autorizada. Esta operación pide un despacho de Justo Delivery sin crear ni asociar un pedido de Justo Ecommerce; la entrega queda como un recurso logístico independiente. Usa este endpoint cuando la marca ya tomó la venta o la solicitud en otro canal y solo necesita que Justo coordine el retiro y la entrega. Por ejemplo, un pedido ingresado por teléfono, WhatsApp, POS, backoffice o una integración externa. El storeId debe pertenecer a la marca autorizada. Debes enviar al menos un teléfono de contacto en fromPhone o toPhone para que la operación pueda coordinar la entrega. En Justo Admin MCP esta operación requiere confirmación explícita del usuario porque crea una entrega real.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
storeId
string
required

ID Justo del local solicitante.

​
fromPlaceId
string
required

Place ID de origen.

​
toPlaceId
string
required

Place ID de destino.

​
fromName
string
required

Nombre de contacto de origen.

​
toName
string
required

Nombre de contacto de destino.

​
fromPhone
string
required

Teléfono de origen. Debe venir fromPhone o toPhone.

​
toPhone
string

Teléfono de destino. Debe venir fromPhone o toPhone.

​
fromAddressLine2
string

Complemento de dirección de origen.

​
toAddressLine2
string

Complemento de dirección de destino.

​
instructions
string

Instrucciones para el repartidor.

​
isCash
boolean

Si es true, el repartidor debe cobrar efectivo.

​
amountToPay
number

Monto que debe cobrar el repartidor si isCash es true.

​
cashAmount
number

Efectivo estimado que entregará el cliente.

​
isRoundTrip
boolean

Si es true, el repartidor vuelve al origen.

​
tipAmount
number

Propina para el repartidor.

​
toExpectedDate
string<date-time>

Fecha esperada de entrega.

​
deliveryPriority
number

Prioridad logística. 2 alta, 3 normal, 4 baja.

​
sendNotificationToReceiver
boolean

Si es true, envía notificación al receptor.

​
useCarForDelivery
boolean

Si es true, solicita vehículo tipo auto.

​
confirmation
boolean

Confirma creación cuando el precio requiere confirmación explícita.

​
externalId
string

Identificador externo para idempotencia o conciliación.

Response

The OpenAPI spec

​
success
boolean
Example:

true

​
data
object

Entrega de Justo Delivery creada sin un pedido de Justo Ecommerce asociado. Se usa para despachos manuales o integraciones externas que necesitan logística fuera del checkout de Justo.