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

# Cancelar Proposta

> Cancele uma proposta que ainda não foi efetivada

# Cancelar Proposta

Cancele uma proposta em andamento. Só é possível cancelar propostas que ainda não foram efetivadas.

<Info>
  Todos os endpoints requerem autenticação via **Bearer token** no header `Authorization`.
  Consulte o [guia de autenticação](/authentication) para obter suas credenciais e gerar um token.
</Info>

## Parâmetros

<ParamField path="nu_proposta" type="integer" required>
  Número da proposta
</ParamField>

<ParamField body="motivo" type="string" required>
  Motivo do cancelamento
</ParamField>

## Exemplo

```bash cURL theme={null}
curl -X POST https://api.zipdin.com.br/api/v1/propostas/789456/cancelar \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"motivo": "Cliente desistiu"}'
```

<ResponseExample>
  ```json 200 - Cancelada theme={null}
  {
    "nu_proposta": 789456,
    "status": "cancelada",
    "message": "Proposta cancelada com sucesso"
  }
  ```

  ```json 422 - Não pode cancelar theme={null}
  {
    "error": "BUSINESS_RULE_VIOLATION",
    "message": "Proposta já efetivada não pode ser cancelada"
  }
  ```
</ResponseExample>