Cadastro de Documento. - API Zen 2

Este endpoint realiza o cadastro de um novo documento no QColabore.

Pré-requisitos para o cadastro:

O usuário deve ser um usuário de escritório e possuir permissões para realizar o cadastro, identificado pelo usuarioId.

O documento deve conter um anexo previamente enviado no endpoint de Anexos, enviando o ID deste anexo referenciado na propriedade !:CadastroDocumentoQcolaboreApiModel.AnexoId no modelo.

O documento deve ser associado a uma empresa, especificada na propriedade QuestorZen.Application.Edoc.Models.CadastroDocumentoQcolaboreApiModel.Empresa do modelo.
Caso o usuário informado no documento não exista ou não possua permissão de acesso à empresa, perfis de acesso ou departamentos correspondentes,
irá cadastrar ou atualizar o usuário, garantindo que ele receba as permissões adequadas para o cadastro do documento.

Validações executadas:

O usuarioId é obrigatório e deve corresponder a um usuário válido e com permissões.

O anexo referenciado deve existir previamente cadastrado via endpoint M:QuestorZen.Api.Controllers.v2.Arquivos.ArquivosApiController.InserirAnexoDocumento(System.Collections.Generic.List{Microsoft.AspNetCore.Http.IFormFile}) e ser válido.

Exemplo de Requisição (Body JSON):

Corpo da Requisição:

{
    "subPastaId": 104,
    "assunto": "Teste questor",
    "dataCompetencia": "",
    "dataVencimento": "",
    "valor": 50.00,
    "anexoId": "66c32ed1ef1602d339ce930c",
    "empresa": {
        "empresaId": 8,
        "usuario": {
            "nome": "FUNCIONARIO DOIS",
            "email": "questor@questores.com.br",
            "cpf": "323423423432"
        }
    }
}

Respostas:

Sucesso: Retorna o documento cadastrado.

Falhas: Detalha os erros ocorridos, como permissões inválidas, anexo não encontrado, ou dados incorretos no modelo.
Exemplo de Resposta de Sucesso(201 - Created) :

{
    "sucesso": true,
    "mensagens": "Documento cadastrado com sucesso",
    "dados": {
        "Id": "12345",
        "Nome": "Documento XYZ"
    }
}

Exemplo de Resposta de Erro (400 - Bad Request):

{
    "sucesso": false,
    "mensagens": "Dados fornecidos no modelo são inválidos.",
    "dados": null
}

curl --location --request POST '/v2/Qcolabore/Usuarios/0/Documentos' \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data-raw '{ "subPastaId": 0, "assunto": "string", "dataVencimento": "string", "dataCompetencia": "string", "observacao": "string", "valor": 0, "anexoId": "string", "empresa": {} }'