> ## Documentation Index
> Fetch the complete documentation index at: https://dmgttrans.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Requerimentos e Campos

> Configure tipos de requerimento e a biblioteca de campos personalizados usados nos formulários do sistema.

Esta funcionalidade é destinada a perfis com permissão de **administração** (capability `administration.manage`). Você pode acessar pelo menu lateral, na seção **Administração**, clicando em **Tipos de Requerimento** ou **Campos Personalizados**.

## Tipos de Requerimento

Cada processo do sistema é aberto a partir de um tipo de requerimento. Aqui você define quais campos serão solicitados, se o processo será interno ou externo, e automações de documentos.

### Criar ou editar um tipo

**1. Abrir o editor**

Clique em **Novo Tipo** ou no ícone de lápis para editar um existente.

**2. Preencher informações básicas**

* **Nome**: nome exibido ao abrir processos.
* **Categoria**: Interno ou Externo (SEI).
* **Unidade Padrão**: define a unidade inicial do processo.

**3. Configurar comportamentos opcionais**

* **Permitir anonimato**: permite abrir o processo sem identificar o requerente.
* **Permitir protocolo remoto**: habilita o protocolo por assinatura remota.
* **Permitir processos internos**: permite criar o processo sem requerente, usando a unidade como origem.

**4. Adicionar campos personalizados**

Use o campo **Adicionar da biblioteca** para incluir campos existentes, ou clique em **Novo Campo** para criar um campo novo e adicioná-lo ao tipo. Veja a seção Campos Personalizados abaixo.

**5. Organizar campos e blocos**

Use os ícones de seta para mudar a ordem. Os campos **Requerente** e **CPF/CNPJ** são fixos e não podem ser removidos.

**6. Salvar**

Clique em **Criar** ou **Salvar**.

### Blocos condicionais

Você pode agrupar campos em **Blocos** que aparecem ou desaparecem conforme o valor de outro campo. Isso é útil para formulários longos onde nem todas as informações são necessárias em todos os casos.

**1. Criar um bloco**

No campo **Nome do bloco**, digite um nome (ex.: "Dados Complementares"). Marque **Visibilidade condicional** se o bloco deve aparecer apenas em certas condições.

**2. Definir a condição**

Escolha o campo controlador e o tipo de comparação:

* **Texto/Seleção**: igual a um ou mais valores (modo OR ou AND).
* **Número**: operadores igual, diferente, maior, menor, maior ou igual, menor ou igual.
* **Data**: pode comparar por data exata, dias de deslocamento, ou por idade (anos, meses ou dias).

**3. Vincular campos ao bloco**

Para cada campo, use o select **Bloco** para associá-lo a um bloco. O campo seguirá a regra de visibilidade do bloco.

### Documento inicial e automações

* **Documento inicial do processo**: escolha um modelo de documento já publicado. Quando um processo deste tipo for criado, o sistema gera automaticamente o primeiro documento.
* **Documentos automáticos**: defina em JSON regras para criar documentos automaticamente quando eventos acontecem (ex.: ao criar processo ou ao criar um documento de origem).

> [!NOTE]
>
> O campo **Webhook do Tipo (Comprovante)** permite especificar um webhook para comprovante de protocolo.

### Campo AAR

> [!NOTE]
>
> O campo **AAR nº** vincula o processo ao Auto de Apreensão e Remoção existente na Fiscalização. Ao preencher, o sistema confere se o AAR existe.

## Campos Personalizados

A biblioteca de campos reúne todos os campos reutilizáveis nos tipos de requerimento e nos modelos de documento.

### Tipos de campo disponíveis

| Tipo | Uso |
| - | - |
| Texto | Texto curto, livre. |
| Área de Texto | Texto longo, multilinha. |
| Múltipla Escolha | Checkbox com várias opções. |
| Caixa de Seleção | Sim/Não. |
| Seleção Única | Dropdown de uma opção. |
| Data | Campo de data. |
| Hora | Campo de hora. |
| Documento | Upload de arquivo. |
| CPF/CNPJ | Com validação de formato e dígitos verificadores. |
| Telefone | Com máscara de telefone. |
| E-mail | Com validação de formato. |
| UF | Seleção de estado brasileiro. |
| Endereço | CEP, logradouro, número, complemento, bairro, cidade e UF. |
| Número | Valor numérico. |
| DRV | Vinculação a Documento de Remoção de Veículo. |
| Placa | Placa de veículo. |
| AIT | Auto de Infração de Trânsito. |
| Foto | Upload de imagem. |
| Dados Bancários | Agência, conta, tipo. |
| Irregularidades pendentes do veículo | Lista de irregularidades associadas ao veículo. |
| SEI | Número de processo no SEI. |

### Criar um campo

**1. Abrir o formulário**

Clique em **Novo Campo**.

**2. Preencher nome e identificador**

O **Identificador** é usado em modelos de documento e no código. Deve começar com letra minúscula e conter apenas letras, números e underscore.

**3. Escolher o tipo**

Selecione o tipo de campo na lista. Para tipos com opções (seleção, múltipla escolha), informe as opções separadas por vírgula.

**4. Adicionar validações opcionais**

* **Regex**: expressão regular para validar o formato do texto.
* **Múltipla escolha**: marque "Permitir múltipla escolha" para aceitar mais de uma opção.

**5. Salvar**

Clique em **Criar Campo**.

### Desativar um campo

Na lista de campos, clique no ícone de lixeira. O campo será desativado, mas os dados já preenchidos em processos antigos são preservados.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.