~~ODT~~

<PHP>
echo "<div style='display:block;float:right;'>"; 
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>


====== Listar/Alterar Documento do Veículo ======

Este caso de uso é utilizado pelos gestores de transportes com a finalidade listar/alterar o registro dos documentos de veículos já inseridos no sistema.

===== Descrição do Caso de Uso =====

O caso de uso está disponível através do caminho: //SIPAC -> Módulo Transportes -> Licenciamento ->  Documento do Veículo -> Listar/Alterar//.

Ao acessar o caso de uso, são solicitados dados para consulta de documentos dos veículos:

  * **Ano exercício**: Tipo - NUMÉRICO, formato: AAAA.
  * **Renavam**: Tipo - NUMÉRICO.
  * **Tipo da documento**: Tipo - TEXTO. Os tipos disponíveis são: 'Certificado de Registro de Veículo'' e ''Certificado de Registro e Licenciamento de Veículo".
  * **Órgão emissor**: Tipo - AUTOCOMPLETE, formato: SIGLA/NOME DO ÓRGÃO/SIGLA DO ESTADO.
  * **CPF/CNPJ**: Tipo - NUMÉRICO, formato: 999.999.999-99.
  * **Placa**: Tipo - AUTOCOMPLETE, formato: XXX-9999.
  * **Local da emissão**: Tipo - AUTOCOMPLETE, formato: CIDADE/SIGLA ESTADO.
  * **Período de emissão**: Tipo - DATA, formato: DD/MM/AAAA a DD/MM/AAAA. 

O resultado lista os documentos encontrados exibindo os seguintes dados:

  * **__Tipo do documento__**: Tipo - TEXTO.
  * **__Órgão emissor__**: Tipo - TEXTO.
  * **__RENAVAM/RNTRC__**: Tipo - TEXTO.
  * **__Via__**: Tipo - NUMÉRICO.
  * **__Local da emissão__**: Tipo - TEXTO.
  * **__Data da emissão__**: Tipo DATA.
  * **__Proprietário__**: Tipo - TEXTO.

Para cada documento do veículo listado, temos as seguintes opções:

  * //Detalhar// - Ao selecionar esta opção, serão listados os seguintes dados:
    * **__Tipo do documento__**: Tipo - TEXTO.
    * **__Órgão emissor__**: Tipo - TEXTO.
    * **__RENAVAM/RNTRC__**: Tipo - TEXTO.
    * **__Via do documento__**: Tipo - NUMÉRICO.
    * **__Ano exercício__**: Tipo NUMÉRICO, formato: AAAA.
    * **__Local da emissão__**: Tipo - TEXTO.
    * **__Data da emissão__**: Tipo DATA.
    * **Dados do Proprietário**
      * **__Cpf/Cnpj__**: Tipo - NUMÉRICO. Formato: 999.999.999-99.
      * **__Nome__**: Tipo - TEXTO.
      * **__Endereço__**: Tipo - TEXTO.
      * **__Bairro__**: Tipo - TEXTO.
      * **__Cidade/UF__**: Tipo - TEXTO, formato: DENOMINAÇÃO CIDADE/SIGLA UF.
    * **Dados do Veículo**
      * **__Placa__**: Tipo - TEXTO. Formato - XXX-9999.
      * **__Localidade da placa__**: Tipo TEXTO, formato: DENOMINAÇÃO CIDADE/SIGLA UF.
      * **__Chassi__**: Tipo - TEXTO.
      * **__Espécie tipo__**: Tipo - TEXTO.
      * **__Combustível__**: Tipo - TEXTO.
      * **__Marca/Modelo__**: Tipo - TEXTO, formato: DENOMINAÇÃO MARCA/ DENOMINAÇÃO MODELO.
      * **__Ano de fabricação__**: Tipo NUMÉRICO, formato: AAAA.
      * **__Ano do modelo__**: Tipo NUMÉRICO, formato: AAAA.
      * **__Cap/Pot/Cil__**: Tipo - TEXTO.
      * **__Categoria__**: Tipo - TEXTO.
      * **__Cor__**: Tipo - TEXTO.
    * **IPVA**
      * **__Faixa IPVA__**: Tipo - NUMÉRICO.
      * **Cota Única** - Caso seja cota única, exibirá os seguintes dados:
        * **__Cota única__**: Tipo - NUMÉRICO.
        * **__Vencimento__**: Tipo - DATA. Formato: DD/MM/AAAA.
      * **Parcelamento** - Caso tenha parcelamento, exibirá os seguintes dados:
        * **__Parcela/Cota__**: Tipo - NUMÉRICO.
        * **__Pagamento 1ª parcela__**: Tipo DATA.
        * **__Pagamento 2ª parcela__**: Tipo DATA.
        * **__Pagamento 3ª parcela__**: Tipo DATA.
    * **Dados Seguro Obrigatório**
      * **__Prêmio tarifário__**: Tipo NUMÉRICO.
      * **__IOF__**: Tipo NUMÉRICO.
      * **__Prêmio total__**: Tipo NUMÉRICO.
      * **__Data de pagamento__**: Tipo DATA.
    * **__Observações__**: Tipo TEXTO.
  * //Alterar//
    * Ao selecionar esta opção, o fluxo segue de acordo com o caso de uso de [[.cadastrar | cadastrar documento do veículo]]. 
  * //Remover//
    * Ao selecionar esta opção, irá remover o documento do veículo mediante uma confirmação positiva.
  
O caso de uso é finalizado.

===== Principais Regras de Negócio =====

Não se aplica.

==== Resoluções/Legislações Associadas ====
Não se aplica.

===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.sipac.transportes.dominio.DocumentoVeiculo | administrativo.transporte.documento_veiculo |
| br.ufrn.sipac.transportes.dominio.Veiculo | administrativo.transporte.veiculo |

====== Plano de Teste ======

Sistema: SIPAC

Módulo: TRANSPORTES

Link(s):  Licenciamento ->  Documento do Veículo -> Listar/Alterar

Usuário: bergue

Papel que usuário deve ter: 

  * SipacPapeis.GESTOR_TRANSPORTES_GLOBAL, 
  * SipacPapeis.GESTOR_TRANSPORTES_UNIDADES, 
  * SipacPapeis.GESTOR_TRANSPORTES_LICENCIAMENTO_MULTA, 
  * SipacPapeis.GESTOR_TRANSPORTES_VEICULO,
  * SipacPapeis.AUDITOR.
===== Cenários de Teste =====

Para verificar se os dados estão sendo listados corretamente, pode-se utilizar o caso de uso de [[.cadastrar | cadastrar documento do veículo]].


===== Dados para o Teste =====

Não se aplica.