~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Consolidação Manual da Importação de Arquivos ====== Este caso de uso é utilizado pelos gestores de transportes para realizar a consolidação dos registros importados dos arquivos de abastecimentos 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 -> Consolidação Manual da Importação de Arquivos.// O caso de uso começa com o usuário acessando a listagem de registros importados que ainda não foram consolidados (Todos os dados foram validados), que podem ser filtrados pelos seguintes dados: * **Número/Ano da Requisição**: Para os registros importados que já tem uma requisição de reserva associada, pode ser utilizado o NÚMERO/ANO da requisição, Tipo: NUMÉRICO. * **Veículo**: Filtro através da placa do veículo da frota. Formato: AAA-9999. Tipo AUTOCOMPLETE. * **Data de Abastecimento**: Data em que foi efetuado o abastecimento. Formato: DD/MM/YYYY. Tipo: DATA * **Data de Importação**: Data em que foi efetuada a importação do arquivo. Formato: DD/MM/YYYY. Tipo: DATA * **Abastecimentos com requisição associadas**: Filtrar apenas pelos registros que já possuem requisição de reserva associada. Tipo: LÓGICO. * **Abastecimentos consolidados**: Filtrar apenas pelos registros que já foram consolidados. Tipo: LÓGICO. Ao realizar a consulta, será apresentada a lista de registros consolidados ou não de acordo com os filtros informados. Na listagem serão exibidos os seguintes dados [[#principais_regras_de_negócio|(RN01)]]: ^ Requisição ^ Data do Abastecimento ^ Placa do Veículo ^ Hodômetro ^ Nº Autor. ^ Combustível ^ Volume ^ Valor ^ Data de Importação ^ | 99999/9999 | DD/MM/AAAA - hh:mm:ss | XXX-9999 | 99...9 | 9999999 | NOME_COMBUSTIVEL | 999 | 99L | DD/MM/AAAA - hh:mm:ss | | **Estabelecimento:** NOME_ESTABELECIMENTO |||| **Motorista:** NOME MOTORISTA ||||| Para cada registro, existem as opções: === 1) Definir Requisição === Nessa opção podemos definir uma requisição de reserva de veículo (para um período, para uma saída ou para um abastecimento), ou mesmo alterar um registro que já possua uma requisição já definida, esteja ela consolidada ou não. Ao escolher um registro com essa opção será exibido uma tela para escolher qual a requisição, e serão exibidos os seguintes dados detalhados do registro importado: * **__Requisição__***: Número da Requisição (caso possua). Formato: 99999/YYYY Tipo: NUMÉRICO. * **__Data/Hora de Abastecimento__**: Data que foi efetuado o abastecimento. Formato: DD/MM/YYYY - hh:mm:ss. Tipo: DATA * **__Placa__**: Placa do veículo da frota. Formato: AAA-9999. Tipo TEXTO. * **__Hodômetro__**: O hodômetro do veículo da frota no momento do abastecimento. Formato: 9999999. Tipo NUMÉRICO. * **__Estabelecimento__**: O estabelecimento que foi realizado o abastecimento. Formato: CNPJ/CPF - NOME_ESTABELECIMENTO. Tipo TEXTO. * **__Número da Autorização__**: Número da operação autorizada. Formato: 9999999. Tipo NUMÉRICO. * **__Combustível__**: O tipo de combustível do abastecimento. Formato: DENOMINACAO_TIPO_COMBUSTIVEL. Tipo TEXTO. * **__Volume Abastecido__**: Volume de combustível abastecido. Formato: 99999,99. Tipo NUMÉRICO. * **__Valor do Abastecimento__**: Valor devido pelo abastecimento. Formato: 99999,99. Tipo NUMÉRICO. * **__Motorista__**: O motorista responsável pelo veículo no momento do abastecimento. Formato: NOME_MOTORISTA (CPF). Tipo TEXTO. Será exibido uma busca pre-carregada com a sugestão de requisições para o veículo, com o motorista (caso exista na base de dados) e no dia do abastecimento. Caso a requisição esteja na lista pode-se filtrar os dados com os seguintes atributos: * **Número/Ano**: Número/Ano da Requisição (caso possua). Formato: 99999/YYYY Tipo: NUMÉRICO. * **Período da Reserva**: Período da reserva. Formato: DD/MM/YYYY a DD/MM/YYYY. Tipo: DATA * **Tipo de Uso da Reserva**: Combo com o tipo de uso da reserva. Formato: DENOMINACAO TIPO RESERVA. Tipo TEXTO. Ao selecionar uma requisição o sistema automaticamente tenta verificar todos os dados e consolidar o registro, caso seja consolidado será gerado o registro de abastecimento com os dados do registro importado, e será exibida novamente a lista de registros importados [[#principais_regras_de_negócio|(RN02)]]. No final o esse fluxo é encerrado. Caso não seja encontrado uma requisição para ser associada ao registro, deverá ser definido uma unidade para custear o abastecimento. Então devemos clicar na opção //Definir abastecimento sem requisição//. Com isso teremos que informar qual a unidade deverá ser responsável pelo abastecimento. Deverá ser preenchido os seguintes dados: * **Unidade**: Unidade de custo do abastecimento. Formato: NOME_UNIDADE (CODIGO). Tipo: AUTOCOMPLETE. Ao selecionar a unidade ocorre a validação dos dados, e caso não possua mais nenhuma ocorrência, será consolidado o registro. O fluxo é encerrado. === 2) Consolidar Requisição === Caso todas as ocorrências tenham sido resolvidas, o gestor poderá tentar consolidar o registro de importação, onde o sistema irá verificar novamente os dados, e caso tenha sucesso, será criado o registro de abastecimento, será informado na tela uma mensagem caso tenha sido consolidada com sucesso o registro. As pendências para consolidação poderão ser vistas em [[#ver_ocorrências | Ver Ocorrências]]. O fluxo é encerrado. === 3) Ver ocorrências === Ao clicar em ver ocorrências de um registro será exibido na tela as pendências para a consolidação dos dados do registro importado. Serão exibidos os dados detalhados do registro: * **__Data/Hora de Abastecimento__**: Data que foi efetuado o abastecimento. Formato: DD/MM/YYYY - hh:mm:ss. Tipo: DATA * **__Placa__**: Placa do veículo da frota. Formato: AAA-9999. Tipo TEXTO. * **__Hodômetro__**: O hodômetro do veículo da frota no momento do abastecimento. Formato: 9999999. Tipo NUMÉRICO. * **__Estabelecimento__**: O estabelecimento que foi realizado o abastecimento. Formato: CNPJ/CPF - NOME_ESTABELECIMENTO. Tipo TEXTO. * **__Número da Autorização__**: Número da operação autorizada. Formato: 9999999. Tipo NUMÉRICO. * **__Combustível__**: O tipo de combustível do abastecimento. Formato: DENOMINACAO_TIPO_COMBUSTIVEL. Tipo TEXTO. * **__Volume Abastecido__**: Volume de combustível abastecido. Formato: 99999,99. Tipo NUMÉRICO. * **__Valor do Abastecimento__**: Valor devido pelo abastecimento. Formato: 99999,99. Tipo NUMÉRICO. * **__Motorista__**: O motorista responsável pelo veículo no momento do abastecimento. Formato: NOME_MOTORISTA (CPF). Tipo TEXTO. Logo abaixo será exibido os dados das ocorrências e se estão em aberto ou se já se encontram resolvidas: ^ Mensagem ^ Data Ult. Processamento ^ Data da Correção ^ Status ^ | OCORRENCIA | DD/MM/YYYY hh:mm | DD/MM/YYYY hh:mm | [EM ABERTO .. RESOLVIDA] | O gestor tem a opção nesse fluxo de tentar consolidar novamente o registro visualizado. O fluxo é encerrado. === 4) Atualizar hodômetro === Segue o fluxo do caso de uso [[desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:frota:frota:veiculo:alterar_km_veiculo|Alterar km do veículo]]. Após a atualização, o usuário é reencaminhado para a listagem de consolidação. ===== Principais Regras de Negócio ===== * **RN01**: No processo de consolidação deverá verificado: a data do abastecimento, a placa do veículo, o hodômetro, o estabelecimento, o número de autorização do abastecimento, o tipo de combustível, o motorista, a requisição, o volume e o valor abastecido. Caso os dados estejam válidos, será gerado um registro de abastecimento para o veículo no sistema. * **RN02**: Um registro de importação de abastecimento poderá ter quantas tentativas de consolidação for necessária, e a medida que as ocorrências forem resolvidas deverão ser marcadas como tal, e ter a data da resolução marcada na ocorrência. ==== 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.Abastecimento | administrativo.transporte.abastecimento | | br.ufrn.sipac.transportes.dominio.LinhaImportacaoArquivoAbastecimento | administrativo.transporte.linha_importacao_arquivo_abastecimento | | br.ufrn.sipac.requisicoes.veiculo.dominio.RequisicaoReservaVeiculo | administrativo.requisicoes.requisicao_reserva_veiculo | ====== Plano de Teste ====== Sistema: SIPAC Módulo: TRANSPORTES Link(s): SIPAC → Módulo Transportes → Aba Abastecimento → Abastecimento → Consolidação Manual da Importação de Arquivos. Usuários: bergue Papel que usuário deve ter: * SipacPapeis.GESTOR_TRANSPORTES_GLOBAL. ===== Cenários de Teste ===== Para poder ter registros de importação deverá ser usado o caso de uso de [[desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:abastecimento:abastecimento:importar_dados_de_abastecimentos| Importar dados de Abastecimentos ]], e após ser consolidados e 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!