Rechazar documentos por el firmante

Este endpoint permite rechazar un documento individual o un sobre (conjunto de documentos en lote) por el firmante.

POSThttps://api.zapsign.com.br/api/v1/refuse/by-user/

Cómo Usar: Envíe un payload en formato JSON con los siguientes campos:

• doc_token: (string) Token del documento a ser rechazado.

• user_token: (string) Token del usuario que está rechazando el documento.

• signer_token: (string) Token del firmante relacionado con el documento.

• rejected_reason: (string, opcional) Motivo del rechazo del documento.

Conoce más sobre los tipos de tokens aqui

Condiciones

• El documento debe tener el estado “En curso”.

• Al crear el documento, el parametro allow_refuse_signature debe estar como true.

• El correo del firmante y el usuario debe ser el mismo.

Observaciones:

• El sistema aplicará automáticamente la marca de agua predeterminada: "Documento rechazado".

• La respuesta del endpoint también será devuelta en formato JSON.

Headers

Nombre	Tipo	Descripción
Authorization*	string	Token de API precedido del texto "Bearer". Ejemplo: Bearer c7f35c84-7893-4087-b4fb-d1f06c23.

Request Body

Nombre	Tipo	Descripción
doc_token*	string	Token del documento
user_token*	string	Token del usuario
signer_token*	string	Token del firmante
rejected_reason	string	Motivo del rechazo

Ejemplo request

{
    "doc_token":"e082d806-6b31-4e27-ae9a-e16b603a70b3",
    "user_token":"97ab0000-36d4-xxxx-9ded-00005d690xxxx",
    "signer_token": "8be272d8-20a9-xx-899c-db4edbb846cd",
    "rejected_reason": ""
}

Response:

200 - exitoso

{
    "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."
}

403

{
    "error": "El rechazo de éste documento no esta permitido."
}

400

{
    "error": "El correo del firmante y el usuario son diferentes"
}