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

# Cancelar Entrega

> Cancela uma entrega existente.

Este endpoint permite cancelar uma entrega que já foi criada. O sistema retorna se há cobranças adicionais associadas ao cancelamento.


## OpenAPI

````yaml POST /v1/logistics/cancel/{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/cancel/{orderId}:
    post:
      tags:
        - Entregas
      summary: Cancelar entrega
      description: Cancela uma entrega existente.
      operationId: cancelDelivery
      parameters:
        - name: orderId
          in: path
          required: true
          description: Identificador único do pedido
          schema:
            type: string
          example: ORDER-12345
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CancelDeliveryRequest'
            examples:
              consumer_cancellation:
                summary: Cancelamento pelo consumidor
                value:
                  reason: CONSUMER_CANCELLATION_REQUESTED
                  action: CANCEL_DELIVERY
                  message: Cliente solicitou cancelamento
              no_show:
                summary: Cliente não compareceu
                value:
                  reason: NO_SHOW
                  action: RETURN_TO_STORE
                  message: Cliente não estava no endereço
      responses:
        '202':
          description: Cancelamento aceito para processamento
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancelDeliveryResponse'
              examples:
                success:
                  summary: Cancelamento aceito
                  value:
                    additionalCharges: false
        '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:
    CancelDeliveryRequest:
      type: object
      required:
        - reason
      properties:
        reason:
          type: string
          enum:
            - CONSUMER_CANCELLATION_REQUESTED
            - NO_SHOW
            - PROBLEM_AT_MERCHANT
            - HIGH_ACCEPTANCE_TIME
            - INCORRECT_ORDER_OR_PRODUCT_PICKUP
            - PROBLEM_RESOLUTION
            - DISCOMBINE_ORDER
            - OTHER
          description: Motivo do cancelamento
          example: CONSUMER_CANCELLATION_REQUESTED
        action:
          type: string
          enum:
            - RETURN_TO_STORE
            - CANCEL_DELIVERY
          description: Ação a ser tomada após o cancelamento
          example: CANCEL_DELIVERY
        message:
          type: string
          description: Mensagem adicional sobre o cancelamento
          example: Cliente solicitou cancelamento
    CancelDeliveryResponse:
      type: object
      required:
        - additionalCharges
      properties:
        additionalCharges:
          type: boolean
          description: Se há cobranças adicionais associadas ao cancelamento
          example: false
    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
  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.

````