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

# Recolhimentos do agente

> Como registrar um novo recolhimento, acompanhar seus veículos e solicitar cancelamento antes do recebimento no pátio.

Esta página explica o fluxo completo de recolhimento veicular feito pelo agente no campo: abertura do Documento de Remoção de Veículo (DRV), fotos, acompanhamento e cancelamento antes do recebimento no pátio.

## Quem pode usar

* **Perfil:** agente.
* **Permissões necessárias:** `agent.recoveries.create` para abrir um novo registro; `agent.recoveries.read` para consultar sua lista.

## Tela Meus Recolhimentos

Após o login, o agente cai na tela **Recolhimentos** (`/agent/my-recoveries`). Nela, você encontra:

* **Campo de busca:** filtra por placa, modelo, número do DRV ou bairro.
* **Cards de resumo:** Total · No Pátio · Liberados.
* **Lista de registros:** cada card mostra placa, status básico, marca/modelo, data, bairro e número do DRV.
* **Botão flutuante (+):** no canto inferior direito, abre o formulário de novo recolhimento.

> [!NOTE]
>
> A lista exibe apenas os veículos registrados pelo seu próprio usuário, do mais recente para o mais antigo.

## Como registrar um novo recolhimento

Toque no botão **(+)** flutuante para abrir o formulário **Novo Recolhimento** (`/agent/new-recovery`). O formulário está dividido em seções colapsáveis. Cada seção mostra um anel de progresso preenchido de acordo com os campos obrigatórios.

**1. Preencher Dados do Recolhimento**

* **Matrícula** e **Nome do Agente:** preenchidos automaticamente, somente leitura.
* **Data/Hora:** ajuste se necessário.
* **Pátio de Destino:** selecione o pátio ativo na lista (se houver apenas um, já vem preenchido).
* **Endereço do Recolhimento:** preencha logradouro, número e bairro. Cidade inicia como Gravatá, PE.

**2. Preencher os dados do Veículo**

Escolha a **Situação**:

* **Normal:** placa normal, preencha todos os campos (placa, UF, marca/modelo, cor, tipo).
* **Sem registro:** não há placa oficial, mas preencha marca/modelo, cor e tipo.
* **Sucata:** preencha apenas a descrição da sucata.
* **Estrangeiro:** preencha o país de registro, placa, marca/modelo, cor e tipo.

Selecione o **Tipo de veículo** na lista cadastrada. Se não houver tipo adequado, use o campo "Outro tipo".

**3. Tirar fotos do veículo**

Na seção de fotos, você pode:

* Toque em **Câmera** para capturar uma foto diretamente pelo celular.
* Toque em **Galeria** para escolher imagens do aparelho.

Você pode adicionar até **5 fotos**. O sistema comprime cada imagem automaticamente para reduzir o tempo de upload. Toque no **X** sobre uma miniatura para remover.

> [!WARNING]
>
> Use preferencialmente a câmera traseira do celular para melhor qualidade.

**4. Informar Proprietário e Condutor**

* Se o proprietário não for identificado, marque **"Proprietário não identificado"**.
* Caso contrário, preencha nome e CPF/CNPJ. O sistema valida automaticamente o dígito verificador.
* Se o proprietário também for o condutor, marque essa opção e os dados do condutor serão preenchidos automaticamente.
* Se o condutor for diferente, preencha nome e documento (CPF, CNH ou RG).
* Informe se o proprietário estava presente no recolhimento e se houve recusa de assinatura.

**5. Preencher Motivo e Amparo Legal**

* **Motivo do recolhimento:** escolha na lista (estacionamento irregular, abandono, ordem judicial, entre outros) ou use "Outros".
* **Amparo legal:** informe o artigo ou base legal que fundamenta o recolhimento.
* **Informações adicionais:** campo livre para observações.

**6. Preencher Estado Geral do Veículo**

* **Odômetro** e **Combustível:** preencha ou marque "N/V" (não verificado).
* **Lataria, pintura e pneus:** escolha entre Bom, Regular ou Ruim. Para pneus, há opções adicionais: Careca ou Furado.
* **Equipamentos faltantes:** toque nos botões para marcar o que está ausente (farol, lanterna, retrovisor, entre outros).
* **Equipamentos de som:** toque para marcar.
* **Outras observações:** campo livre.

> [!NOTE]
>
> O sistema adiciona automaticamente irregularidades na lista quando você marca equipamentos faltantes ou pneus em mau estado.

**7. Preencher Pertences**

Marque se o veículo possui:

* **Chave**
* **Documentos**
* **Outros pertences:** descreva o que mais foi encontrado no veículo.

**8. Preencher Serviço de Remoção**

Escolha o tipo de serviço:

* **Próprio/DMGTTRANS**
* **Contratado**
* **Conveniado**
* **Concessionária**
* **A cargo do proprietário/condutor**

Se for diferente de "Próprio", informe o nome da transportadora e o responsável pela remoção.

**9. Revisar o checklist de irregularidades**

A seção mostra irregularidades já preenchidas automaticamente e permite adicionar outras manualmente. Toque em um botão para adicionar ou remover. A irregularidade de sucata não pode ser removida se a situação do veículo for "Sucata".

**10. Confirmar e registrar**

Toque no botão **"Registrar Recolhimento"**. Uma caixa de confirmação aparece. Após confirmar, o sistema valida os campos obrigatórios, salva o registro e abre a tela de detalhes do veículo recém-criado.

## Tela de detalhes do veículo

Após abrir um recolhimento (ou tocar em um card da lista), você entra na tela **Detalhes do Veículo** (`/agent/vehicle/:id`). Nela, são exibidos:

* **Placa** e número do **DRV** (se já gerado).
* **Status atual** do veículo e **status do DRV**.
* **Local do recolhimento:** endereço completo, data e hora.
* **Proprietário e condutor.**
* **Motivo e amparo legal.**
* **Pendências:** lista de irregularidades com indicação de pendentes e resolvidas.
* **Pertences:** chave, documentos e outros.
* **Estado do veículo:** odômetro, combustível, lataria.
* **Fotos:** miniaturas em grade. Toque para ampliar.

> [!WARNING]
>
> Quando o veículo está com status **Aguardando Recebimento**, ele ainda não foi recebido fisicamente no pátio.

## Status de veículo e de DRV

### Status do veículo

| Status | Significado |
| - | - |
| **Aguardando Recebimento** | O agente registrou o recolhimento, mas o pátio ainda não confirmou o recebimento físico. |
| **No Pátio** | O veículo já foi recebido e está no pátio de destino. |
| **Em Reparo** | O veículo está na oficina para reparos. |
| **Liberado** | O veículo pode ser retirado pelo proprietário. |
| **Leiloado** | O veículo foi destinado a leilão. |

### Status do DRV

| Status | Significado |
| - | - |
| **Ativo** | O DRV está vigente e pode ser impresso. |
| **Cancelamento Pendente** | O agente solicitou o cancelamento e aguarda aprovação de um supervisor. |
| **Cancelado** | O DRV foi cancelado; a justificativa é exibida na tela. |

> [!NOTE]
>
> O número do DRV é gerado automaticamente pelo sistema após o registro do recolhimento.

## Cancelamento antes do recebimento

Enquanto o veículo estiver com status **Aguardando Recebimento** e o DRV estiver **Ativo**, o agente pode solicitar o cancelamento. Isso acontece quando:

* Houve erro no preenchimento.
* O veículo não pôde ser levado ao pátio.
* A ocorrência foi regularizada no local.

**1. Abrir o detalhe do veículo**

Toque no card do recolhimento na lista.

**2. Solicitar cancelamento**

Na parte inferior da tela, toque no botão **"Solicitar Cancelamento"**.

**3. Informar o motivo**

Preencha o campo com pelo menos 10 caracteres, descrevendo detalhadamente o motivo. Quanto mais específico, mais rápida será a avaliação.

**4. Aguardar aprovação**

Após enviar, o status do DRV muda para **Cancelamento Pendente**. Um supervisor analisará a solicitação e aprovará ou rejeitará.

> [!NOTE]
>
> O cancelamento só pode ser solicitado enquanto o DRV está ativo. Se já foi cancelado ou está pendente, o botão não aparece.

> [!WARNING]
>
> O cancelamento é uma ação séria. Solicitações sem justificativa adequada podem ser rejeitadas pela supervisão.


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