Tipos Documentais
Nível de acesso requerido
Admin ou Super Admin
Um Tipo Documental é o rótulo que classifica um arquivo anexado a uma instância ou tarefa: "RG", "Comprovante de Residência", "Nota Fiscal", "Contrato de Prestação de Serviço". O arquivo carrega esse rótulo pelo resto da vida do processo, e é por ele que se responde que documento é este sem depender do nome que o remetente deu ao arquivo.
Gerenciando os tipos
- Acesse Modelagem → Tipos Documentais na barra lateral
- Clique em Novo Tipo
- Preencha:
- Nome do Tipo — obrigatório, é o rótulo que aparece na classificação
- Descrição — para que serve o documento
- Ativo (Permite novos uploads) — desmarque para aposentar o tipo
- Clique em Salvar
A lista mostra Nome, Descrição e Status, com os botões de editar e excluir em cada linha.
Criar, editar e excluir é do Admin do tenant
A tela fica escondida de quem não é Admin, mas o que fecha o cadastro é a API: POST, PUT e DELETE em /a/document-types exigem Admin do tenant ou Super Admin, e recusam com 403 quem chega por outro caminho. A leitura desce até o Gerente, porque é ela que preenche o seletor de tipo no construtor de formulários; o usuário comum não lê o catálogo.
Inativar, não excluir
Um tipo Inativo deixa de ser oferecido para novos envios, mas os arquivos já classificados com ele continuam classificados. Excluir é o caminho para um tipo criado por engano; para um tipo que saiu de uso, inativar preserva a leitura do histórico.
Onde o tipo é aplicado
O tipo é escolhido no construtor de formulários: ao selecionar um campo do tipo Arquivo, o painel de propriedades traz o seletor de Tipo Documental. Todo arquivo enviado por aquele campo nasce classificado com o tipo escolhido — a pessoa que preenche a tarefa não precisa classificar nada, e não tem como classificar errado.
Um campo de arquivo sem tipo documental continua funcionando: o arquivo entra sem classificação.
Global e do tenant
- Tipos do tenant — criados em Modelagem → Tipos Documentais pelo Admin (ex.: "Planilha de Fechamento Interno"). Valem só para a sua empresa, e só ela os enxerga.
- Tipos globais — criados pelo Super Admin dentro de um template global, na aba Tipos Documentais daquele template. Eles pertencem àquele processo global e ficam disponíveis para os formulários dele em todo tenant inscrito. Veja Templates Globais.
Um tipo global não é editável pelo tenant, pelo mesmo motivo que o desenho e os formulários do template também não são: o tenant herda o pacote, não bifurca.
Escrever na camada global é do Super Admin
Criar tipo global (POST /a/document-types?isGlobal=true), alterá-lo ou excluí-lo exige Super Admin. Um Admin de tenant recebe 403: o tipo global vale para todos os tenants que assinam o processo, e o Admin de um tenant responde só pelo próprio. A leitura dos tipos globais de um processo assinado (GET /a/document-types?isGlobal=true&processKey=...) continua liberada ao tenant — é ela que preenche o seletor do campo Arquivo nos formulários daquele processo.