---
title: "Consultar cotización y ruta de una entrega sin pedido"
method: POST
path: "/admin/deliveries/preview"
---

# Consultar cotización y ruta de una entrega sin pedido

`POST /admin/deliveries/preview`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/admin/deliveries/preview`
- Auth: none declared

Devuelve la cotización junto con coordenadas de origen y destino, distancia en metros, duración estimada de conducción en segundos y puntos de la ruta. Requiere un local autorizado, cuyo ID se obtiene en GET /ecommerce/stores. No solicita un despacho ni reserva el precio. La duración no incluye la espera de un repartidor y no es una promesa de llegada o vehículo. En ida y vuelta, el precio incluye la vuelta, pero la ruta y su duración describen solo la ida. Si falla el cálculo de ruta después de cotizar, devuelve success=true con quote y routeError, sin route, conservando las coordenadas que se hayan resuelto.

## Request body

- object
  - `storeId` string, required: ID Justo del local solicitante.
  - `fromAddress` ApiDeliveryPreviewAddressInput, required: Dirección para cotizar y calcular la ruta. Las coordenadas son opcionales; si se envían, deben incluir latitud y longitud válidas.
    - `streetAddress` string, required: Calle y numeración ingresada por el customer o sistema externo.
    - `countryCode` string, required: Código de país ISO 3166-1 alpha-2.
    - `extendedAddress` string: Departamento, oficina u otra información secundaria.
    - `location` ApiDeliveryCoordinates: Coordenadas geográficas válidas de un punto del recorrido.
      - `lat` number, required: Latitud en grados.
      - `lng` number, required: Longitud en grados.
    - `acceptsNoLine2` boolean: Indica si el customer confirmó que no tiene línea 2.
    - `comment` string: Comentario o instrucciones de entrega.
    - `locality` string: Localidad o comuna.
    - `region` string: Región o estado.
    - `postalCode` string: Código postal.
  - `toAddress` ApiDeliveryPreviewAddressInput, required: Dirección para cotizar y calcular la ruta. Las coordenadas son opcionales; si se envían, deben incluir latitud y longitud válidas.
    - `streetAddress` string, required: Calle y numeración ingresada por el customer o sistema externo.
    - `countryCode` string, required: Código de país ISO 3166-1 alpha-2.
    - `extendedAddress` string: Departamento, oficina u otra información secundaria.
    - `location` ApiDeliveryCoordinates: Coordenadas geográficas válidas de un punto del recorrido.
      - `lat` number, required: Latitud en grados.
      - `lng` number, required: Longitud en grados.
    - `acceptsNoLine2` boolean: Indica si el customer confirmó que no tiene línea 2.
    - `comment` string: Comentario o instrucciones de entrega.
    - `locality` string: Localidad o comuna.
    - `region` string: Región o estado.
    - `postalCode` string: Código postal.
  - `isCash` boolean: Si es true, considera cobro en efectivo.
  - `amountToPay` number: Monto que debe cobrarse si isCash es true.
  - `tipAmount` number: Propina para el repartidor en moneda del local. Se suma al precio con impuestos para obtener totalAmount. Usa el mismo tipAmount al crear el despacho.
  - `isRoundTrip` boolean: Si es true, considera vuelta al origen.
  - `useCarForDelivery` boolean: Si es true, cotiza con vehículo tipo auto.

## Response `200`

The OpenAPI spec

- object
  - `success` boolean
  - `data` ApiDeliveryPreview: Cotización y ruta referencial de una entrega sin pedido, sin crear un despacho. Si el cálculo de ruta falla, conserva la cotización y las coordenadas resueltas, omite route e incluye routeError.
    - `kind` 'preview', required: Tipo de resultado.
    - `quote` ApiDeliveryWithoutOrderQuote, required: Cotización estimada de una entrega sin pedido. No reserva un precio ni genera un identificador de cotización; el precio se calcula nuevamente al crear el despacho.
      - `price` number: Precio estimado sin impuestos.
      - `priceWithTax` number: Precio estimado con impuestos.
      - `tipAmount` number: Propina para el repartidor, en moneda del local. Por defecto: 0.
      - `totalAmount` number: Total estimado a pagar: priceWithTax más tipAmount.
    - `from` ApiDeliveryPreviewAddress, required: Dirección recibida, acompañada de las coordenadas resueltas cuando están disponibles. Si la geocodificación falla, conserva los datos de la dirección sin inventar coordenadas.
      - `streetAddress` string, required: Calle y numeración ingresada por el customer o sistema externo.
      - `countryCode` string, required: Código de país ISO 3166-1 alpha-2.
      - `extendedAddress` string: Departamento, oficina u otra información secundaria.
      - `location` ApiDeliveryCoordinates: Coordenadas geográficas válidas de un punto del recorrido.
        - `lat` number, required: Latitud en grados.
        - `lng` number, required: Longitud en grados.
      - `acceptsNoLine2` boolean: Indica si el customer confirmó que no tiene línea 2.
      - `comment` string: Comentario o instrucciones de entrega.
      - `locality` string: Localidad o comuna.
      - `region` string: Región o estado.
      - `postalCode` string: Código postal.
    - `to` ApiDeliveryPreviewAddress, required: Dirección recibida, acompañada de las coordenadas resueltas cuando están disponibles. Si la geocodificación falla, conserva los datos de la dirección sin inventar coordenadas.
      - `streetAddress` string, required: Calle y numeración ingresada por el customer o sistema externo.
      - `countryCode` string, required: Código de país ISO 3166-1 alpha-2.
      - `extendedAddress` string: Departamento, oficina u otra información secundaria.
      - `location` ApiDeliveryCoordinates: Coordenadas geográficas válidas de un punto del recorrido.
        - `lat` number, required: Latitud en grados.
        - `lng` number, required: Longitud en grados.
      - `acceptsNoLine2` boolean: Indica si el customer confirmó que no tiene línea 2.
      - `comment` string: Comentario o instrucciones de entrega.
      - `locality` string: Localidad o comuna.
      - `region` string: Región o estado.
      - `postalCode` string: Código postal.
    - `isRoundTrip` boolean, required: Indica si el precio incluye vuelta al origen. La geometría y duración describen solo la ida.
    - `route` object: Recorrido referencial en vehículo. No incluye espera ni asignación de repartidor y no garantiza una hora de llegada o un tipo de vehículo.
      - `path` ApiDeliveryCoordinates[], required: Puntos ordenados de la ruta, desde el origen hasta el destino.
        - `lat` number, required: Latitud en grados.
        - `lng` number, required: Longitud en grados.
      - `distance` number, required: Distancia del recorrido de ida, en metros.
      - `duration` number, required: Duración estimada de conducción de ida, en segundos.
    - `routeError` string: Descripción del problema al calcular la ruta. Solo está presente cuando route no está disponible; la cotización sigue siendo válida como estimación.

## Other responses

- `400`: Solicitud rechazada por validación, autorización o reglas de la operación. Los problemas de pago y deuda reconocidos incluyen información para resolverlos.
- `500`: Error al procesar la solicitud. Un error o timeout de creación no garantiza que el despacho no se haya creado.

## Changes

- **2026-11-01** `4b46b8f3312f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/admin/deliveries/preview/post.md)

---

[API](https://skmtc.dev/getjusto/apis/justo-api.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api/revisions/c810bd8246fd?raw)