~~ODT~~

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



====== Importar Dados de Abastecimento ======

Este caso de uso é utilizado pelos gestores de transportes para realizar a importação de abastecimentos de arquivos fornecidos pelas empresas com contratos de abastecimentos. 

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

O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Módulo Transportes -> Aba Abastecimento -> Abastecimento -> Importar Dados de Abastecimentos.

O caso de uso começa com o usuário acessando o sistema e preenchendo os dados do cadastro como segue abaixo:
  * **Empresa***: Empresa que forneceu, ou é responsável pelo produto. Formato: RAZÃO SOCIAL OU NOME (CNPJ), Tipo: AUTOCOMPLETE .
  * **Somente Importar? (Não consolidar)**: Tipo LÓGICO
  * **Arquivo possui cabeçalho?**: Tipo: LÓGICO 
  * **Arquivo***: Arquivo com os abastecimentos a serem importados no formato csv. Formato: CAMINHO DO ARQUIVO, Tipo: TEXTO. .  
   
Ao adicionar um arquivo, ele irá aparecer em uma lista com os seguintes atributos e com opção de //Remover Arquivo//:

^ Nº ^ Arquivo ^ Content/Type ^ Tamanho ^ 
| 999 |  NOME DO ARQUIVO IMPORTADO  |  TIPO DO ARQUIVO    |   99999.9     |  



Ao //Efetuar Importação// será exibido a seguinte tabela com os itens do abastecimento [[#principais_regras_de_negócio|(RN02)]]:

^ Data ^ Hora ^ Placa do Veículo ^ Hodômetro ^ Horímetro ^ Estabelecimento ^ Nº Autor. ^ Combustível ^ Volume ^ Valor ^ Motorista ^
| DD/MM/AAAA |  hh:mm  |  XXX-9999    |   99...9     |  hh:mm   |     Nome       |      Nome     |    999     |  99L    |    99.9   |    Nome       |


Se a opção ''Somente Importar? (Não consolidar)'' não foi marcada, para finalizar o caso de uso o usuário deve clicar em 'Consolidar Abastecimentos', caso contrário a opção será 'Importar Abastecimentos'.

Se os arquivos foram apenas importados ou se houve algum problema na consolidação deles, o sistema exibe as ocorrências:

^  Req. Veículo ^  Data de Abastecimento  ^  Placa do Veículo  ^  Hodômetro ^ Nº Autor.  ^ Combustível         ^   Volume ^     Valor ^ Data de Importação      ^
|     9999/AAAA |  DD/MM/AAAA - HH:MM:SS  |      AAA-9999      |       9999 | 999999     | DENOMINAÇÃO - TIPO  |  99,99 l |  R$ 99,99 |  DD/MM/AAAA - HH:MM:SS  |

Para cada registro, existe as opções:

  * **[[desenvolvimento:especificacoes:sipac:fluxos:fluxo_definir_requisicao|Definir Requisição]]**: opção que associa o abastecimento a uma Requisição de Reserva de Veículo.

  * **Consolidar Linha**: Consolida apenas esse registro.

  * **[[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_os_erros_de_consolidacao&#fluxo_visualizar_os_erros_de_consolidação|Ver Ocorrências]]**



O caso de uso é finalizado.

===== Principais Regras de Negócio =====
  * **RN01**: O arquivo a ser inserido deve obedecer ao seguinte formato: {{:desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:abastecimento:abastecimento:edicao_arquivo_importacao_abastecimento_v2.pdf|}}
  * **RN02**: Ao importar o arquivo com o item "Somente Importar? (Não consolidar)" marcado, não deverá haver o processamento do arquivo, apenas a importação, não deverão ser gerados abastecimentos.
  * **RN03**: Quando o parâmetro ''UTILIZA_REQUISICAO_ABASTECIMENTO''estiver com valor ''TRUE'', indica que na importação e consolidação dos abastecimentos será necessário informar uma requisição de abastecimento. No caso do parâmetro estar com valor ''FALSE'', o usuário poderá consolidar o abastecimento sem informar uma requisição de abastecimento.
==== Resoluções/Legislações Associadas ====
Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.transportes.dominio.ImportacaoAbastecimento | administrativo.transporte.importacao_abastecimento |
| br.ufrn.sipac.transportes.dominio.AbastecimentoVeiculo | administrativo.transporte.abastecimento |




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

Sistema: SIPAC

Módulo: TRANSPORTES

Link(s): SIPAC → Módulo Transportes → Aba Abastecimento → Abastecimento → Importar Dados de Abastecimentos 

Usuários: bergue

Papel que usuário deve ter: 
  * SipacPapeis.GESTOR_TRANSPORTES_GLOBAL, 
  * SipacPapeis.GESTOR_TRANSPORTES_UNIDADES, 
  * SipacPapeis.GESTOR_TRANSPORTES_ABASTECIMENTO.

===== Cenários de Teste =====

Para verificar se os dados foram cadastrados/alterados corretamente, pode-se verificar a listagem exibida em Menu Transportes -> Veículo -> Abastecimento -> Listar/Alterar.



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

Não se aplica!