> ## 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.

# Alicoolemia

> Registro e consulta de testes de alicoolemia por etilômetro, com fluxo de cancelamento e revisão.

A tela de **Alcoolemia** centraliza o registro, a consulta e o acompanhamento de testes de alcoolemia realizados com etilômetro. Ela está disponível para perfis **Admin**, **Supervisor** e **Servidor** no menu **Operação > Alcoolemia**, e para o perfil **Agente** no menu inferior **Alcoolemia**.

A revisão de solicitações de cancelamento é restrita aos perfis **Admin** e **Supervisor**.

## Lista de Testes

Ao abrir a tela, você vê a lista de testes já registrados. No topo há um campo de busca onde você pode pesquisar por número do teste, nome do condutor ou bairro. Cada item da lista exibe:

* Número do teste
* Nome do condutor (quando informado)
* Endereço e bairro
* Data e hora da medição
* Status do registro

> [!NOTE]
>
> O sistema exibe contagens dinâmicas: o total de testes e a quantidade de resultados quando você usa a busca.

## Status dos Testes

| Status | Descrição |
| - | - |
| **Ativo** | Teste registrado e válido |
| **Cancelado** | Teste cancelado após aprovação de solicitação |
| **Cancelamento pendente** | Solicitação de cancelamento enviada, aguardando revisão |

## Como Registrar um Novo Teste

**1. Iniciar o registro**

Toque em **Novo Teste** no canto superior direito.

**2. Preencher os Dados do Registro**

Expanda a seção **Dados do Registro** e informe:

* **Equipamento (Etilômetro)**\*: selecione o aparelho utilizado na lista de etilômetros cadastrados e ativos
* **Data/Hora exibida no aparelho**\*: preencha com a data e hora mostradas no visor do equipamento

**3. Preencher a Medição**

Expanda a seção **Medição** e informe:

* **Nº do Teste (visor do aparelho)**\*: digite os 5 dígitos numéricos exibidos no etilômetro
* **Condutor recusou-se a ser submetido ao teste**: marque esta opção quando o condutor se recusar a soprar o etilômetro. A medição será dispensada e a recusa registrada
* **Medição Realizada (mg/L)**\*: informe o valor medido pelo aparelho (aparece somente se não houver recusa)

**4. Verificar o Valor Considerado**

O sistema calcula automaticamente o **Valor Considerado** aplicando a dedução de 0,04 mg/L (erro máximo admissível). A interface mostra uma classificação visual:

* **Verde**: dentro do erro máximo admissível - não há alcoolemia
* **Amarelo**: infração de trânsito - Art. 165 do CTB
* **Vermelho**: crime de trânsito - infração do Art. 165 cumulada com crime do Art. 306, ambos do CTB

**5. Identificar o Condutor**

Expanda a seção **Identificação do Condutor** e preencha, se possível:

* **Nome do Condutor**
* **CPF do Condutor**: o sistema valida o formato e exibe alerta se o CPF for inválido

**6. Informar o Endereço da Medição**

Expanda a seção **Endereço da Medição** e preencha:

* **Logradouro**
* **Número**
* **Bairro**
* **Complemento**
* **Cidade**
* **UF**

**7. Adicionar Observações**

Expanda a seção **Observações** e digite qualquer informação complementar no campo disponível.

**8. Registrar**

Toque em **Registrar Teste** para salvar. O sistema exibe a confirmação e redireciona para a tela de detalhes do teste.

> [!TIP]
>
> As seções do formulário funcionam como acordeões. Você pode abrir e fechar cada uma. O sistema valida se todas as seções obrigatórias foram visitadas antes de permitir o registro.

> [!WARNING]
>
> O número do teste deve ter exatamente 5 dígitos numéricos. O sistema não permite registrar um número já existente.

## Detalhes do Teste

Abra um teste da lista para visualizar todos os dados. A tela de detalhes exibe:

* Status do registro (com distintivo colorido)
* Data e hora do registro no sistema
* Valor medido e valor considerado (com classificação visual)
* Indicação de recusa ao teste, quando aplicável
* Equipamento utilizado (fabricante, modelo, número de série e próxima verificação)
* Local e data da medição
* Dados do condutor (nome e CPF)
* Observações

Ações disponíveis no detalhe:

| Ação | Quem pode usar | Descrição |
| - | - | - |
| **Imprimir** | Todos os perfis com acesso | Gera a impressão do registro do teste |
| **Solicitar Cancelamento** | Quem tem acesso e o teste está **Ativo** | Abre o diálogo para enviar solicitação de cancelamento |

## Como Solicitar o Cancelamento de um Teste

**1. Abrir a solicitação**

Na tela de detalhes de um teste com status **Ativo**, toque em **Solicitar Cancelamento**.

**2. Informar o motivo**

No diálogo que abre, preencha o campo **Motivo da solicitação**\* com pelo menos 10 caracteres. Descreva detalhadamente o motivo do cancelamento.

**3. Enviar**

Toque em **Enviar Solicitação**. A solicitação será encaminhada para aprovação de um supervisor.

> [!NOTE]
>
> Após o envio, o teste recebe o status **Cancelamento pendente** e fica aguardando análise. Você pode acompanhar o andamento na aba **Cancelamentos**.

## Aba Cancelamentos

A aba **Cancelamentos** aparece na tela de Alcoolemia para perfis com permissão de revisão (**Admin** e **Supervisor**). Ela contém três subabas:

* **Pendentes**: solicitações aguardando decisão
* **Aprovados**: cancelamentos já aprovados
* **Negados**: solicitações recusadas

Cada solicitação lista:

* Número do teste
* Nome do agente solicitante
* Motivo da solicitação
* Data do pedido
* Status com distintivo colorido

Ações por status:

| Status | Ações disponíveis |
| - | - |
| **Pendente** | **Analisar** - abre o diálogo de revisão |
| **Aprovado** / **Negado** | **Ver** - exibe os detalhes da solicitação, incluindo revisor, data da revisão e motivo da decisão |

## Como Revisar uma Solicitação de Cancelamento

**1. Selecionar a solicitação**

Na aba **Pendentes**, toque em **Analisar** na linha da solicitação desejada.

**2. Analisar os dados**

O diálogo exibe as informações do teste, o nome do solicitante, a data do pedido e o motivo da solicitação.

**3. Decidir**

* Para aprovar, toque em **Aprovar Cancelamento**
* Para recusar, toque em **Recusar**. Neste caso, você deve informar o motivo da recusa no campo de observações

**4. Confirmar**

Após a decisão, o solicitante recebe uma notificação no sistema informando se a solicitação foi aprovada ou negada.

> [!TIP]
>
> Use o campo de observações para deixar registrado o fundamento da decisão, especialmente em casos de recusa.

## Equipamentos (Etilômetros)

Os etilômetros cadastrados no sistema aparecem no campo **Equipamento (Etilômetro)** do formulário de registro. Cada equipamento é identificado por:

* Fabricante
* Modelo
* Número de série

Quando disponível, o sistema também exibe a data da próxima verificação do equipamento na tela de detalhes do teste. Apenas equipamentos do tipo **etilômetro** e com status ativo aparecem na lista de seleção.

> [!WARNING]
>
> Se nenhum etilômetro aparecer na lista, verifique com a administração se há equipamentos cadastrados e ativos no sistema.

## Dicas de Uso

* Sempre confira a **Data/Hora exibida no aparelho** com o visor do etilômetro no momento do teste
* Anote o **Nº do Teste** diretamente do visor do equipamento para evitar erros de digitação
* Quando o condutor se recusar ao teste, marque a opção de recusa em vez de inventar um valor de medição
* Para cancelamentos, seja claro e objetivo no motivo para facilitar a análise do supervisor


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