# Obtener información de una entrega

Este endpoint te proporciona una visión completa de una entrega, ya sea con el identificador de la entrega o con el id de referencia del mismo.

## Consulta la información de entregas

> Recuperar datos de una entrega por su ID o referencia.

```json
{"openapi":"3.0.0","info":{"title":"API de Shippify","version":"1.0.0"},"servers":[{"url":"https://api.shippify.co","description":"Servidor de desarrollo"}],"security":[{"Basic_Auth":[]}],"components":{"securitySchemes":{"Basic_Auth":{"type":"http","scheme":"basic"}},"schemas":{"getDelivery":{"successfulResponse":{"type":"object","properties":{"id":{"type":"string","description":"Identificador de la entrega en Shippify."},"route":{"type":"object","description":"Información sobre la ruta a la que pertenece la entrega.","properties":{"id":{"type":"string","description":"Identificador de la ruta en Shippify."},"order":{"description":"Orden de la entrega dentro de la ruta.","type":"integer","minimum":1}}},"recipient":{"description":"Información de contacto en el almacén","$ref":"#/components/schemas/delivery/contact"},"pickup":{"type":"object","properties":{"date":{"type":"string","description":"Fecha de recolección."}}},"dropoff":{"description":"Información de entrega","type":"object","location":{"$ref":"#/components/schemas/delivery/location"},"date":{"type":"string","description":"Fecha de entrega."}},"courier":{"description":"Detalles del conductor","type":"object","properties":{"info":{"type":"object","properties":{"shipperId":{"description":"Identificador del conductor que realiza la entrega.","type":"integer","minimum":1},"shipperDocId":{"type":"string","description":"Identificación del conductor, cédula, etc."},"shipperName":{"type":"string","description":"Nombre del conductor."},"shipperCapacity":{"type":"string","description":"Capacidad del conductor."},"vehicleLicensePlate":{"type":"string","description":"Placa del vehículo del conductor."},"vehicleType":{"type":"string","description":"Marca del vehículo del conductor."},"vehicleModel":{"type":"string","description":"Modelo del vehículo del conductor."}}},"location":{"type":"object","description":"Ubicación actual del conductor.","properties":{"lat":{"type":"string"},"lng":{"type":"string"}}}}},"items":{"description":"Paquetes de entrega","type":"array","items":{"description":"Información del paquete.","type":"array","items":{"$ref":"#/components/schemas/delivery/package"}}},"status":{"description":"Código de estado de la entrega","type":"integer","minimum":1},"_status":{"type":"string","description":"Nombre del estado de la entrega"},"status_lang":{"type":"string","description":"Nombre del estado de la entrega en el idioma de la cuenta"},"distance":{"description":"Distancia entre puntos de recolección y entrega","type":"number","minimum":0},"company":{"type":"string","description":"Nombre de la empresa de la tarea"},"referenceId":{"type":"string","description":"Identificador externo de la entrega, como número de orden"},"reasonId":{"description":"Identificador de la razón del cambio de estado","type":"integer","minimum":1},"reasonText":{"type":"string","description":"Descripción de la razón del cambio de estado"},"problem_note":{"type":"string","description":"Comentario del cambio de estado"},"lastStatusDate":{"type":"string","description":"Fecha del último cambio de estado"},"tags":{"description":"Nombres de etiquetas digitales de entrega.","type":"array","items":{"description":"Nombre de la etiqueta digital","type":"string","maxLength":50}}}}},"delivery":{"contact":{"description":"Información de contacto de la persona responsable de entregar los paquetes en el almacén de recolección.","type":"object","required":["name","email"],"properties":{"name":{"description":"Nombre de la persona responsable.","type":"string"},"email":{"description":"Email de la persona responsable.","type":"string","format":"email"},"phonenumber":{"description":"Número de teléfono de la persona responsable.","type":"string"}}},"location":{"description":"Información de dirección de la ubicación de recolección de los paquetes de entrega.","type":"object","required":["address"],"properties":{"address":{"description":"Dirección de entrega.","type":"string"},"instructions":{"description":"Información extra sobre la dirección.","type":"string"},"lat":{"description":"Latitud del punto de recolección.","type":"string"},"lng":{"description":"Longitud del punto de recolección.","type":"string"}}},"package":{"type":"object","required":["name","qty","size"],"properties":{"id":{"type":"string","description":"Identificador del paquete"},"name":{"type":"string","description":"Nombre del paquete"},"qty":{"description":"Número de paquetes en la orden (no el número de productos dentro del paquete).","type":"integer","minimum":0},"weight":{"description":"Peso unitario * cantidad en Kg","type":"number","minimum":0},"size":{"description":"Package size","type":"string","enum":["xs","s","m","l","xl"]},"price":{"description":"Precio unitario * cantidad en la moneda de la empresa","type":"number","minimum":0}}}},"Unauthenticated":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object"}}},"paths":{"/v1/deliveries/{id}/complete":{"get":{"tags":["Entregas"],"summary":"Consulta la información de entregas","description":"Recuperar datos de una entrega por su ID o referencia.","responses":{"200":{"description":"Operación exitosa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/getDelivery/successfulResponse"}}}},"401":{"description":"No autorizado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthenticated"}}}}},"parameters":[{"name":"id","in":"path","description":"Identificador o ID de referencia de la entrega a consultar.","required":true,"schema":{"type":"string"}}]}}}}
```

## Casos de uso

<details>

<summary>Obtener información de una entrega por su id</summary>

Puedes utilizar el id de la entrega en la url de la petición para traer su información.

</details>

<details>

<summary>Obtener información de una entrega por su reference id</summary>

Puedes utilizar el reference id de la entrega en la url de la petición para traer su información.

</details>
