> ## 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.

# Create delivery without order

> Crea una entrega sin pedido para la marca autorizada. Esta operación solicita un despacho de Justo Delivery sin crear ni asociar un pedido de Justo Ecommerce, útil para ventas tomadas por teléfono, WhatsApp, POS, backoffice o integraciones externas. Requiere origen, destino, local y datos de contacto. Si la cotización cambió, puede requerir confirmation=true.

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.


## OpenAPI

````yaml post /admin/deliveries
openapi: 3.1.0
info:
  title: Justo API
  version: 3.0.0
servers:
  - url: https://api.service.getjusto.com/v3
    description: Production server
security: []
paths:
  /admin/deliveries:
    post:
      summary: Create delivery without order
      description: >-
        Crea una entrega sin pedido para la marca autorizada. Esta operación
        solicita un despacho de Justo Delivery sin crear ni asociar un pedido de
        Justo Ecommerce, útil para ventas tomadas por teléfono, WhatsApp, POS,
        backoffice o integraciones externas. Requiere origen, destino, local y
        datos de contacto. Si la cotización cambió, puede requerir
        confirmation=true.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - storeId
                - fromAddress
                - toAddress
                - fromName
                - toName
              anyOf:
                - required:
                    - fromPhone
                - required:
                    - toPhone
              properties:
                storeId:
                  type: string
                  description: ID Justo del local solicitante.
                fromAddress:
                  $ref: '#/components/schemas/apiDeliveryAddressInput'
                toAddress:
                  $ref: '#/components/schemas/apiDeliveryAddressInput'
                fromName:
                  type: string
                  description: Nombre de contacto de origen.
                toName:
                  type: string
                  description: Nombre de contacto de destino.
                fromPhone:
                  type: string
                  description: Teléfono de origen. Debe venir fromPhone o toPhone.
                toPhone:
                  type: string
                  description: Teléfono de destino. Debe venir fromPhone o toPhone.
                instructions:
                  type: string
                  description: Instrucciones para el repartidor.
                isCash:
                  type: boolean
                  description: Si es true, el repartidor debe cobrar efectivo.
                amountToPay:
                  type: number
                  description: Monto que debe cobrar el repartidor si isCash es true.
                cashAmount:
                  type: number
                  description: Efectivo estimado que entregará el cliente.
                isRoundTrip:
                  type: boolean
                  description: Si es true, el repartidor vuelve al origen.
                tipAmount:
                  type: number
                  description: Propina para el repartidor.
                toExpectedDate:
                  type: string
                  format: date-time
                  description: Fecha esperada de entrega.
                deliveryPriority:
                  type: number
                  description: Prioridad logística. 2 alta, 3 normal, 4 baja.
                sendNotificationToReceiver:
                  type: boolean
                  description: Si es true, envía notificación al receptor.
                useCarForDelivery:
                  type: boolean
                  description: Si es true, solicita vehículo tipo auto.
                confirmation:
                  type: boolean
                  description: >-
                    Confirma creación cuando el precio requiere confirmación
                    explícita.
                externalId:
                  type: string
                  description: Identificador externo para idempotencia o conciliación.
      responses:
        '200':
          description: The OpenAPI spec
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    $ref: '#/components/schemas/apiDeliveryWithoutOrder'
        '400':
          description: Errors
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: 'false'
                  error:
                    type: object
                    properties:
                      error:
                        type: string
                        example: error
                      message:
                        type: string
                        example: The request has an error
components:
  schemas:
    apiDeliveryAddressInput:
      type: object
      description: >-
        Dirección de origen o destino provista por la app externa. API la
        resuelve internamente a placeId.
      required:
        - streetAddress
        - countryCode
      properties:
        streetAddress:
          type: string
          description: Calle y numeración ingresada por el customer o sistema externo.
        countryCode:
          type: string
          description: Código de país ISO 3166-1 alpha-2.
          example: CL
        extendedAddress:
          type: string
          description: Departamento, oficina u otra información secundaria.
        location:
          type: object
          description: Coordenadas opcionales para mejorar la resolución de la dirección.
          properties:
            lat:
              type: number
              description: Latitud.
            lng:
              type: number
              description: Longitud.
        acceptsNoLine2:
          type: boolean
          description: Indica si el customer confirmó que no tiene línea 2.
        comment:
          type: string
          description: Comentario o instrucciones de entrega.
        locality:
          type: string
          description: Localidad o comuna.
        region:
          type: string
          description: Región o estado.
        postalCode:
          type: string
          description: Código postal.
      additionalProperties: false
    apiDeliveryWithoutOrder:
      type: object
      description: >-
        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.
      properties:
        _id:
          type: string
          description: ID Justo de la entrega.
        websiteId:
          type: string
          description: ID de la marca autorizada.
        storeId:
          type: string
          description: ID Justo del local que solicita la entrega.
        orderId:
          type: string
          description: Siempre null para entregas sin pedido.
        partner:
          type: string
          description: Partner logístico usado para la entrega.
        status:
          type: string
          description: Estado actual de la entrega.
          enum:
            - active
            - canceled
            - done
            - error
            - pending
            - scheduled
            - delivering
            - waiting
            - unconfirmed
        specialCode:
          type: string
          description: Código corto de entrega especial.
        externalId:
          type: string
          description: Identificador externo opcional enviado por la integración.
        price:
          type: number
          description: Precio final con impuestos.
        priceWithoutTax:
          type: number
          description: Precio sin impuestos.
        isCash:
          type: boolean
          description: Indica si el repartidor debe cobrar efectivo.
        isRoundTrip:
          type: boolean
          description: Indica si el repartidor debe volver al origen.
        instructions:
          type: string
          description: Instrucciones operativas para el repartidor.
        fromName:
          type: string
          description: Nombre de contacto en origen.
        toName:
          type: string
          description: Nombre de contacto en destino.
        fromPlaceId:
          type: string
          description: Place ID de origen.
        toPlaceId:
          type: string
          description: Place ID de destino.
        fromAddressLine2:
          type: string
          description: Complemento de dirección de origen.
        toAddressLine2:
          type: string
          description: Complemento de dirección de destino.
        fromLocation:
          $ref: '#/components/schemas/apiDeliveryLocation'
        toLocation:
          $ref: '#/components/schemas/apiDeliveryLocation'
        driverPassword:
          type: string
          description: Código de verificación del repartidor, si aplica.
        trackingURL:
          type: string
          description: URL de tracking público de la entrega.
        createdAt:
          type: string
          example: '2020-01-01T00:00:00.000Z'
          format: date-time
          description: Fecha de creación.
        forDate:
          type: string
          example: '2020-01-01T00:00:00.000Z'
          format: date-time
          description: Fecha programada de la entrega.
        canceledAt:
          type: string
          example: '2020-01-01T00:00:00.000Z'
          format: date-time
          description: Fecha de cancelación.
        completedAt:
          type: string
          example: '2020-01-01T00:00:00.000Z'
          format: date-time
          description: Fecha de término.
    apiDeliveryLocation:
      type: object
      description: Punto de origen o destino de una entrega sin pedido.
      properties:
        address:
          type: string
          description: Dirección principal.
        addressSecondary:
          type: string
          description: Comuna, ciudad o referencia secundaria.
        placeId:
          type: string
          description: ID del lugar.
        streetAddress:
          type: string
          description: Calle y número.
        extendedAddress:
          type: string
          description: Departamento, oficina o referencia.
        contactPhone:
          type: string
          description: Teléfono de contacto del punto.
        contactName:
          type: string
          description: Nombre de contacto del punto.
        lat:
          type: number
          description: Latitud.
        lng:
          type: number
          description: Longitud.

````