Cadastro de Documento.

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

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 QuestorZen.Application.Edoc.Models.CadastroDocumentoApiModel.AnexoId no modelo.

O documento deve ser associado a uma ou mais empresas, especificadas na propriedade QuestorZen.Application.Edoc.Models.CadastroDocumentoEdocApiModel.Empresas do modelo,
incluindo usuários vinculados às empresas. Caso os usuários não sejam especificados no documento será vinculado a todos os usuários das empresas que possuem permissão para o tipo de documento.

Validações:

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.

Devem ser fornecidas uma ou mais empresas. Caso os usuários não sejam especificados, o documento será vinculado a todos os usuários das empresas que possuem permissão para o tipo de documento.

Exemplo de Requisição:

Exemplo de Resposta de Sucesso (201):

{
    "sucesso": true,
    "mensagens" : "Documento cadastrado com sucesso",
    "dados": {
    "Id" : 6
    }
    
}

Exemplo de Resposta de Erro (400 - Dados Inválidos):

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

Exemplo de Resposta de Erro (403 - Permissões Insuficientes):

{
    "sucesso": false,
    "mensagens": "Usuário sem permissão para cadastrar o documento.",
    "dados": null
}

Exemplo de Resposta de Erro (500 - Erro Interno):

{
    "sucesso": false,
    "mensagens": "Erro interno ao processar o cadastro do documento.",
    "dados": null
}

curl --location --request POST '/v2/EDoc/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", "nomeInterno": "string", "empresas": [ {} ] }'

Requisição

Respostas