Cancelar Documento. - API Zen 2

Este endpoint realiza o cancelamento de um documento no QColabore.

Pré-requisitos para o cancelamento:

O usuário deve ser um usuário de escritório com permissões para cancelar o documento, identificado pelo usuarioId.

O documento deve existir, estar com status "Aberto" e o ID do documento deve ser passado pelo documentoId.

Validações:

O usuarioId é obrigatório e deve corresponder a um usuário válido com permissão para realizar o cancelamento.

O documentoId é obrigatório e deve corresponder a um documento existente no QColabore.

O documento precisa estar com status "Aberto" para ser cancelado. Documentos com outros status (como "Cancelado" ou "Fechado") não podem ser cancelados.

Será verificado se o usuário tem permissão para acessar a subpasta do documento e se o departamento associado está ativo.

Será verificado se os usuários das empresas destinatárias possuem perfil de acesso e permissões adequadas para o tipo de documento.

Exemplo de Requisição (Rota):

Respostas:

Sucesso: Retorna a mensagem "Documento cancelado com sucesso".

Falha: Retorna detalhes sobre erros como permissões inválidas, documento não encontrado, ou status do documento não permitindo cancelamento.
/// Exemplo de Resposta de Sucesso (200 - OK):

{
    "sucesso": true,
    "mensagens": "Documento cancelado com sucesso",
    "dados": null
}

Exemplo de Resposta de Erro (403 - Forbidden):

{
    "sucesso": false,
    "mensagens": "Permissão insuficiente ou dados inválidos.",
    "dados": null
}