> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gohusky.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Detalhes da entrega

> Retorna informações detalhadas sobre uma entrega específica.

Este endpoint retorna todas as informações relacionadas a uma entrega, incluindo:

* Dados do pedido e merchant
* Status e eventos da entrega
* Informações do veículo e entregador
* Preços e tempos
* Problemas reportados (se houver)


## OpenAPI

````yaml GET /v1/logistics/delivery/{orderId}
openapi: 3.1.0
info:
  title: API Módulo Logístico
  description: >
    API para integração com o módulo logístico do OpenDelivery.


    Esta API utiliza autenticação OAuth 2.0 com o fluxo Client Credentials para
    obter tokens de acesso.

    Todos os endpoints protegidos requerem o token de acesso no header
    Authorization.
  version: 1.2.0
  contact:
    name: Suporte OpenDelivery
servers:
  - url: https://opendelivery.gohusky.net/logistic
    description: Servidor de produção
  - url: https://sandbox.opendelivery.gohusky.net/logistic
    description: Servidor Homologação
security: []
tags:
  - name: Autenticação
    description: Endpoints relacionados à autenticação e obtenção de tokens de acesso
  - name: Entregas
    description: Endpoints relacionados à gestão de entregas e pedidos logísticos
paths:
  /v1/logistics/delivery/{orderId}:
    get:
      tags:
        - Entregas
      summary: Obter detalhes da entrega
      description: Retorna informações detalhadas sobre uma entrega específica.
      operationId: getDeliveryDetails
      parameters:
        - name: orderId
          in: path
          required: true
          description: Identificador único do pedido
          schema:
            type: string
          example: ORDER-12345
      responses:
        '200':
          description: Detalhes da entrega retornados com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeliveryDetailsResponse'
              examples:
                success:
                  summary: Detalhes da entrega
                  value:
                    deliveryId: 123e4567-e89b-12d3-a456-426614174000
                    orderId: ORDER-12345
                    orderDisplayId: ORD-12345
                    merchant:
                      id: MERCHANT-001
                      name: Restaurante Exemplo
                    customerName: João Silva
                    events:
                      - type: PENDING
                        datetime: '2024-01-15T10:30:00.000Z'
                      - type: ACCEPTED
                        datetime: '2024-01-15T10:35:00.000Z'
                    vehicle:
                      type:
                        - MOTORBIKE_BAG
                      container: NORMAL
                    deliveryPrice:
                      value: 8.5
                      currency: BRL
                    times:
                      deliveryEtaDate: '2024-01-15T11:30:00.000Z'
                      maxDeliveryTime: '2024-01-15T12:00:00.000Z'
                      isDeliveryFinished: false
                    deliveryPerson:
                      id: DELIVERY-001
                      name: Entregador Exemplo
        '400':
          description: Erro na requisição
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                error:
                  summary: Erro inesperado
                  value:
                    title: Erro inesperado.
                    status: 400
        '401':
          description: Não autorizado - Token inválido ou ausente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Pedido não encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                not_found:
                  summary: Pedido não encontrado
                  value:
                    title: Pedido não encontrado.
                    status: 404
      security:
        - BearerAuth: []
components:
  schemas:
    DeliveryDetailsResponse:
      type: object
      properties:
        deliveryId:
          type: string
          format: uuid
          description: Identificador único da entrega
          example: 123e4567-e89b-12d3-a456-426614174000
        orderId:
          type: string
          description: Identificador único do pedido
          example: ORDER-12345
        orderDisplayId:
          type: string
          description: Identificador de exibição do pedido
          example: ORD-12345
        merchant:
          $ref: '#/components/schemas/MerchantData'
        customerName:
          type: string
          description: Nome do cliente
          example: João Silva
        events:
          type: array
          description: Lista de eventos da entrega
          items:
            type: object
            required:
              - type
              - datetime
            properties:
              type:
                type: string
                enum:
                  - PENDING
                  - ACCEPTED
                  - REJECTED
                  - PICKUP_ONGOING
                  - ARRIVED_AT_MERCHANT
                  - ORDER_PICKED
                  - DELIVERY_ONGOING
                  - ARRIVED_AT_CUSTOMER
                  - ORDER_DELIVERED
                  - RETURNING_TO_MERCHANT
                  - RETURNED_TO_MERCHANT
                  - DELIVERY_FINISHED
                  - CANCELLED
                description: Tipo do evento
                example: ACCEPTED
              datetime:
                type: string
                format: date-time
                description: Data e hora do evento (ISO 8601)
                example: '2024-01-15T10:35:00.000Z'
        problem:
          type: array
          description: Lista de problemas reportados
          items:
            type: object
            properties:
              type:
                type: string
                description: Tipo do problema
                example: PAYMENT_PROBLEMS
              datetime:
                type: string
                format: date-time
                description: Data e hora do problema (ISO 8601)
                example: '2024-01-15T11:00:00.000Z'
              resolved:
                type: boolean
                description: Se o problema foi resolvido
                example: false
              message:
                type: string
                description: Mensagem sobre o problema
                example: Cliente não possui o valor exato
        vehicle:
          type: object
          properties:
            type:
              type: array
              description: Tipos de veículo
              items:
                type: string
                enum:
                  - MOTORBIKE_BAG
                  - MOTORBIKE_BOX
                  - CAR
                  - BICYCLE
                  - SCOOTER
                  - VUC
            container:
              type: string
              enum:
                - NORMAL
                - THERMIC
              description: Tipo de container
        deliveryPrice:
          $ref: '#/components/schemas/PriceData'
        times:
          type: object
          properties:
            deliveryEtaDate:
              type: string
              format: date-time
              description: Data e hora estimada para entrega (ISO 8601)
              example: '2024-01-15T11:30:00.000Z'
            maxDeliveryTime:
              type: string
              format: date-time
              description: Data e hora máxima para entrega (ISO 8601)
              example: '2024-01-15T12:00:00.000Z'
            isDeliveryFinished:
              type: boolean
              description: Se a entrega foi finalizada
              example: false
            deliveryFinishDate:
              type: string
              format: date-time
              description: >-
                Data e hora de finalização da entrega (ISO 8601, apenas se
                isDeliveryFinished for true)
              example: '2024-01-15T11:45:00.000Z'
        deliveryPerson:
          type: object
          properties:
            id:
              type: string
              description: Identificador do entregador
              example: DELIVERY-001
            name:
              type: string
              description: Nome do entregador
              example: Entregador Exemplo
        combinedOrdersIds:
          type: array
          description: IDs de pedidos combinados
          items:
            type: string
          example:
            - ORDER-123
            - ORDER-124
        externalTrackingURL:
          type: string
          format: uri
          description: URL externa para rastreamento
          example: https://tracking.example.com/ORDER-12345
    ErrorResponse:
      type: object
      required:
        - title
        - status
      properties:
        title:
          type: string
          description: Mensagem de erro descritiva
          example: Não autorizado
        status:
          type: integer
          description: Código de status HTTP
          example: 401
    MerchantData:
      type: object
      required:
        - id
        - name
      properties:
        id:
          type: string
          description: Identificador único do merchant
          example: MERCHANT-001
        name:
          type: string
          description: Nome do merchant
          example: Restaurante Exemplo
    PriceData:
      type: object
      required:
        - value
        - currency
      properties:
        value:
          type: number
          format: float
          description: Valor monetário
          minimum: 0
          example: 45.5
        currency:
          type: string
          enum:
            - BRL
            - USD
            - EUR
          description: Moeda. Padrão ISO 4217.
          minLength: 3
          maxLength: 3
          exclusiveMinimum: true
          example: BRL
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        Token de acesso OAuth 2.0 obtido através do endpoint `/oauth/token`.


        Use o formato: `Authorization: Bearer {access_token}`


        O token deve ser incluído em todas as requisições aos endpoints
        protegidos.

````