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

# Leilões

> Gerenciamento completo de certames de veículos recolhidos: triagem, preparação, aprovações, publicidade, resultados e retirada.

Esta área é destinada aos perfis **administrador**, **supervisor** e **servidor** com permissões de leilão. A funcionalidade estará disponível no menu lateral, sob o item **Leilões de veículos**.

A tela organiza todo o ciclo de vida de um certame: desde a triagem dos veículos sob custódia até a retirada pelo arrematante. A sessão de lances propriamente dita ocorre em plataforma externa homologada; o sistema registra e acompanha a parte administrativa e documental.

## Permissões necessárias

| Permissão | Quem possui | O que permite |
| - | - | - |
| **auctions.read** | admin, supervisor, servidor | Ver certames e triagem |
| **auctions.prepare** | admin, supervisor, servidor | Preencher fichas, formar lotes, registrar publicação e dados operacionais |
| **auctions.approve** | admin, supervisor | Aprovar ou rejeitar etapas que exigem decisão sequencial |
| **auctions.finance** | admin, supervisor | Confirmar pagamentos e prestar contas |
| **auctions.admin** | admin | Reabrir etapas, avançar excepcionalmente e acessar a consulta técnica |

Servidores das unidades **JARI** ou **DEF** também conseguem acessar quando possuem as capabilities vinculadas ao perfil.

## Visão geral da tela

Ao abrir **Leilões de veículos**, você verá dois paineis numéricos logo abaixo do título:

* **Prazo de 60 dias atingido**: veículos que já atingiram o prazo legal máximo de permanência.
* **Preparação permitida**: veículos com 30 dias ou mais de custódia, já aptos a iniciar preparação.
* **Com dados a apurar**: veículos elegíveis, mas que ainda possuem informações pendentes.

Abaixo desses indicadores há duas abas principais:

* **Certames**: lista dos procedimentos de leilão já criados, com número, status, título, responsável, quantidade de veículos e etapas pendentes.
* **Triagem do acervo**: permite selecionar veículos para compor um novo certame.

## Triagem do acervo

A triagem mostra todos os veículos sob custódia do pátio. Cada veículo exibe:

* **Placa** (ou "Sem placa").
* **DRV** (número do documento de recolhimento).
* Tempo de custódia em dias.
* Badge de prazo: **60 dias ou mais**, **30 dias ou mais** ou **Menos de 30 dias**.

### Estados de elegibilidade

| Situação | Significado |
| - | - |
| Apto para inclusão em certame | Passou dos 30 dias, edital complementar publicado e sem pendências |
| Com dados a apurar | Elegível, mas campos como placa, chassi ou débitos ainda nao foram confirmados |
| Falta gerar e publicar o edital complementar previsto no art. 26 | Ainda não foi emitido o edital de 30 dias |
| Edital já publicado. Inclusão em certame liberada em \[data] | Edital emitido, mas ainda dentro dos 10 dias de publicação |
| Já vinculado ao certame \[número] | Veículo já faz parte de outro leilão |
| Ainda não atingiu 30 dias do recolhimento | Faltam dias para abrir a preparação |

> [!NOTE]
>
> Para selecionar um veículo, marque a caixa de seleção à esquerda. Apenas veículos aptos podem ser selecionados.

### Criar um certame

**1. Selecionar veículos**

Na triagem, marque os veículos aptos. O botão superior direito mostrará a contagem dinâmica: **Criar certame (X)**.

**2. Preencher dados do procedimento**

Informe o **Título do certame** e escolha a **Responsabilidade financeira**:

* **Pagamento externo: somente conferência**: o sistema registra valores, mas não recebe pagamentos.
* **Prestação de contas pelo DMGTTRANS**: o órgão assume a conciliação financeira.

**3. Confirmar criação**

Ao confirmar, o sistema cria automaticamente um processo interno na Custódia de Veículos, com etapas, aprovações e tarefas vinculadas.

## Acompanhamento de um certame

Ao clicar em um certame da lista, você entra na tela detalhada. No topo há o número do certame, seu status atual e botão para abrir o **Dossiê administrativo** (processo interno).

### Barra de progresso e fases

Logo abaixo, uma barra de progresso indica quantas das 18 etapas já foram concluídas. As fases são apresentadas em cards sequenciais:

* Verde (concluída)
* Azul (fase atual)
* Cinza (bloqueada)

### Etapa atual

O painel **Agora: etapa X de 18** mostra:

* Título da etapa
* Objetivo e instruções
* Responsável pela etapa
* Operador principal
* Prazo, se houver

> [!WARNING]
>
> Se houver bloqueios legais (por exemplo, prazo de publicação do edital do art. 26), a etapa não poderá ser avançada nem por exceção administrativa. Aguarde o prazo indicado.

## Etapas do procedimento

Cada etapa exige ações específicas. Abaixo estão as principais:

### 1. Organização inicial (triage)

Defina o **Operador principal** do certame escolhendo um servidor da lista. Confira os veículos selecionados. O processo interno já foi criado automaticamente e serve apenas como dossiê administrativo.

### 2. Designação do leiloeiro (designation)

**1. Escolher leiloeiro**

Selecione um leiloeiro já cadastrado no sistema. Se não houver, acesse primeiro a tela de cadastro de leiloeiros pela Administração.

**2. Informar a matrícula oficial**

O campo é preenchido automaticamente com a matrícula do leiloeiro selecionado, podendo ser ajustado.

**3. Registrar credenciamento e designação**

Preencha o **Instrumento de credenciamento** e o **Instrumento de designação** emitido pela CPL, anexando os arquivos PDF de cada um.

**4. Salvar**

Clique em **Registrar designação e concluir os dados**.

### 3. Fila veículo a veículo (diagnosis, notification, inventory, restrictions, classification, appraisal)

Cada veículo deve ter sua ficha individual preenchida. Clique no veículo na fila para abrir a ficha de preparação.

A ficha contém:

* **Dados do recolhimento** (somente leitura): placa, marca/modelo, chassi, Renavam.
* **Dados apurados para o leilão** (editáveis): placa, marca/modelo, chassi, Renavam confirmados.
* **Classificação**: Conservado, Sucata aproveitável ou Sucata inservível.
* **Referência de baixa**: obrigatória apenas para sucatas.
* **Avaliação sigilosa** e **Valor mínimo**.
* **Checklist de preparação**: Inventário e vistoria, Notificação complementar, Restrições e gravames, Pesquisa de débitos.
* **Observações ou justificativa**.

#### Fotografias da preparação

Cada certame possui uma galeria de fotos própria. As fotos históricas do recolhimento não são reutilizadas aqui.

* Escolha o tipo de tomada (ex.: frontal, traseira, interior, motor, número do chassi).
* Clique em **Tirar foto** (câmera) ou **Selecionar imagens** (galeria).
* Envie até 15 MB por arquivo.
* Fotos com tipo preenchido aparecem marcadas com ícone verde no checklist de tomadas.

> [!NOTE]
>
> Tomadas marcadas como "dispensável com justificativa" podem ser omitidas mediante motivação.

### 4. Formação dos lotes (lots)

**1. Criar novo lote**

Clique em **Novo lote**, informe o **Número**, **Categoria** (Conservado, Sucata aproveitável, Sucata inservível), **Título** e **Descrição pública**.

**2. Vincular veículos**

Marque os veículos compatíveis com a categoria do lote.

**3. Salvar**

Cada veículo ativo deve pertencer a exatamente um lote.

### 5. Aprovações sequenciais (approvals)

As aprovações ocorrem em três instâncias sequenciais:

1. **Custódia de Veículos**
2. **Jurídica**
3. **Diretoria Geral**

A tarefa da unidade seguinte só é aberta após a aprovação da anterior. Quem tem a permissão **auctions.approve** pode clicar em **Aprovar** ou **Rejeitar**. Ao rejeitar, é obrigatório informar a fundamentação.

### 6. Datas, visitação e plataforma (publication)

Preencha:

* **Título** do certame
* **Plataforma** externa de lances
* **Link externo** da plataforma
* **Sessão**: data e hora da sessão pública
* **Início da visitação** e **Fim da visitação**

Em seguida, registre a publicação do edital (ou retificação, se exigido):

* **Órgão** de publicação (padrão: Diário Oficial)
* **Número** do edital
* **Data e hora** da publicação
* **URL pública** do documento

> [!NOTE]
>
> A antecedência legal é calculada automaticamente pelo sistema.

### 7. Resultados da sessão (results, payment)

Após a sessão externa, importe os resultados via planilha CSV:

**1. Baixar planilha-base**

Clique em **Planilha-base** para obter o modelo com os lotes e colunas previamente formatadas.

**2. Preencher e importar**

Preencha as colunas obrigatórias `lot_number` e `result_status`, além de campos opcionais como valor arrematado e dados do arrematante. Selecione o CSV e clique em **Importar**.

Os resultados possíveis são: **sold** (vendido), **unsold** (não vendido), **withdrawn** (retirado) e **cancelled** (cancelado).

Para cada lote vendido, registre o pagamento informando:

* **Valor**
* **Data e hora**
* **Comprovante** (anexo do dossiê)

### 8. Retirada dos veículos (registry, withdrawal)

Para encerrar a permanência física no pátio, registre a retirada de cada veículo informando:

* **Recebedor**
* **Documento** do recebedor
* **Autorização / nota**
* **Data e hora** da retirada

## Consulta técnica

O botão **Consulta técnica** (disponível apenas para quem tem **auctions.admin**) abre uma visão lateral com:

* Lista completa das 18 etapas e seus status
* Opção de **Reabrir etapa** (com justificativa obrigatória)
* Registro de auditoria imutável com data/hora de cada evento

> [!WARNING]
>
> Reabrir uma etapa após a publicação pode exigir **Retificação obrigatória**. O sistema exibirá alerta e bloqueará o avanço até que a retificação seja comprovada.

## Notificações e editais de custódia

Dentro da aba **Triagem do acervo**, há uma sub-aba **Notificações e editais**.

### Notificação inicial (art. 15)

Para veículos cujo proprietário ou condutor não estava presente no momento do recolhimento:

**1. Selecionar veículos pendentes**

Marque os veículos listados. O sistema indica se o prazo está vencido ou próximo do vencimento.

**2. Preencher endereços**

Informe o endereço completo de cada destinatário. Use o botão de lupa ao lado do CEP para preenchimento automático via ViaCEP.

**3. Gerar correspondências**

Clique em **Gerar correspondências**. O sistema gera um PDF consolidado com uma carta simples por página.

**4. Gerar edital simultâneo**

Após as cartas, clique em **Próximo: gerar edital** para publicar o edital simultâneo dos mesmos veículos.

**5. Registrar postagem**

Para cada veículo, registre a data e o comprovante de postagem da carta simples. Não há AR nem acompanhamento de entrega.

### Edital complementar (art. 26)

Veículos com 30 dias ou mais de custódia precisam do edital complementar. O sistema exibe alerta vermelho quando há veículos nessa condição. Clique em **Gerar edital do art. 26** para publicar automaticamente.

> [!NOTE]
>
> O edital deve permanecer publicado por 10 dias antes que o veículo possa ser incluído em um certame.

## Tabela de status do certame

| Status | Significado |
| - | - |
| **Rascunho** | Certame criado, mas não iniciado |
| **Triagem** | Em organização inicial e seleção |
| **Preparação** | Fichas veículo a veículo em andamento |
| **Revisão** | Revisão interna dos dados |
| **Edital aprovado** | Aprovado pelas instâncias sequenciais |
| **Publicado** | Edital publicado no órgão de imprensa |
| **Sessão realizada** | Sessão de lances concluída na plataforma externa |
| **Conferência de pagamento** | Pagamentos dos arrematantes em análise |
| **Homologado** | Resultado homologado administrativamente |
| **Retirada** | Veículos sendo retirados do pátio |
| **Encerrado** | Procedimento finalizado |
| **Cancelado** | Certame cancelado |

## Dicas e boas práticas

> [!TIP]
>
> Sempre preencha a ficha veículo a veículo com dados atualizados, mesmo que o recolhimento tenha sido antigo. O sistema mantém o registro original inalterado e cria uma cópia de trabalho para o leilão.

> [!TIP]
>
> Use os filtros da triagem ("Sem certame", "Vinculados", "Todos") e a busca por placa, DRV, chassi, Renavam ou modelo para localizar veículos rapidamente.


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