# Cancelar documentos

**Observaciones**

* **Permisos:** Puede ser usado por administradores, propietarios o grupos con acceso.
* **Estado final:** El documento queda con estado **"rechazado"** y no puede ser firmado nuevamente.
* **Marca de agua:** Se añade la marca de agua **"Documento rechazado"** en el PDF final indicando la cancelación.
* **Webhook:** Puede disparar el webhook **"doc\_signed"** después de la cancelación (PDF actualizado).
* **Estado del documento:** Debe estar **"en curso"** para poder ser cancelado.
* **User-Agent:** Header obligatorio para evitar spam.

### Endpoint

<mark style="color:green;">`POST`</mark>`https://api.zapsign.com.br/api/v1/refuse/`

**Headers**

<table><thead><tr><th width="152">Name</th><th width="97">Type</th><th>Description</th></tr></thead><tbody><tr><td>Authorization<mark style="color:red;">*</mark></td><td>string</td><td>Token de API precedido del texto "Bearer".<br>Ejemplo: <code>Bearer c7f35c84-7893-4087-b4fb-d1f06c23</code>.</td></tr></tbody></table>

#### Request Body

<table><thead><tr><th width="158">Name</th><th width="125">Type</th><th>Description</th></tr></thead><tbody><tr><td>doc_token<mark style="color:red;">*</mark></td><td>string</td><td>Token del documento</td></tr><tr><td>rejected_reason<mark style="color:red;">*</mark></td><td>string</td><td>Motivo de la cancelación del documento. Esta información estará disponible en la plataforma web en los detalles del documento.</td></tr><tr><td>notify_signer</td><td>boolean</td><td>Si true, notifica a los firmantes por correo electrónico cuando el documento se cancele. Si false, no se envía ninguna notificación. Default: false.</td></tr></tbody></table>

Ejemplo request

```json
{
  "doc_token": "bfe4e2c7-33be-4a70-8669-a0491f92e795",
  "rejected_reason": "Documento cancelado por la empresa"
}
```

Response

{% tabs %}
{% tab title="200 - exitoso" %}

```json
{
    "message": "Documento rechazado con éxito. Recuerde: este endpoint es asíncrono, por lo tanto, espere a que los PDF finales estén listos a través de webhooks o verifíquelos en unos minutos."
}
```

{% endtab %}
{% endtabs %}

#### Códigos de error

* **400 missing\_doc\_token:** Debe enviar el `doc_token` (string)
* **400 missing\_rejected\_reason:** Debe enviar el `rejected_reason` (string)
* **400 invalid\_json:** El JSON enviado es inválido
* **403 document\_already\_signed:** No se puede cancelar un documento ya firmado
* **403 document\_already\_refused:** No se puede cancelar un documento que ya fue cancelado/rechazado
* **403 refuse\_not\_allowed:** No está permitido rechazar este documento
* **404 document\_not\_found:** Documento no encontrado
* **500 internal\_error:** Error interno al procesar la solicitud


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zapsign.com.br/espanol/documentos/cancelar-documentos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.