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

====== Relatório de Gastos Mensais com Telefonia ======


Este relatório tem como finalidade exibir o gasto mensal com telefonia móvel e fixa no decorrer de um ano. É utilizado por usuários que tem acesso a relatórios gerenciais e tem permissão para fazer registro de notas fiscais, emissão de processo de pagamento e lançamento de ordem bancária.

Pré-condição: O usuário deve possuir um perfil de Gestor de Faturas para executar esta funcionalidade.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Faturas -> Telefonia -> Relatórios -> Gastos Mensais com Telefonia.//

O sistema solicita ao usuário que informe:
  * **Ano***: Formato - AAAA, Tipo - NUMÉRICO.
  * **Unidade**: Formato - <NOME DA UNIDADE> (<CÓDIGO>). Tipo - AUTOCOMPLETE. Entrada de dados: NOME ou CÓDIGO. ([[desenvolvimento:especificacoes:sipac:faturas:casos_de_uso:consultas_relatorios:faturas_de_energia_eletrica:total_faturado_no_ano#principais_regras_de_negócio|RN01]])
  * **Tipo de Telefone***: Tipo - TEXTO. As opções exibidas são: ''CELULAR'', ''FAX'', ''FIXO'', ''VOIP''.

O sistema exibe o relatório conforme modelo abaixo:

{{:desenvolvimento:especificacoes:sipac:faturas:casos_de_uso:telefonia:contas_telefonicas:relatorios:relatorio.png|}}

O caso de uso é finalizado.


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


  * **RN01** - Totalização dos valores:
      * **//Total do Ano//**: //Somatório do valor cobrado nas ligações telefônicas para cada mês//. Valores separados para cada tipo existente.
      * **//Total Gasto//**: //Somatório do valor cobrado nas ligações telefônicas para cada um dos resultados//. Valores separados para cada tipo existente.


==== Resoluções/Legislações Associadas ====


Não se Aplica.  


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


^ Classe ^ Tabela |
| br.ufrn.sipac.faturas.telefones.dominio.LigacaoTelefonica | administrativo.contratos.ligacao_telefonica |
| br.ufrn.sipac.faturas.telefones.dominio.LinhaTelefonica | administrativo.contratos.linha_telefonica |
| br.ufrn.sipac.faturas.dominio.FaturaProcessada | administrativo.contratos.fatura_processada |
| br.ufrn.comum.dominio.UnidadeGeral | administrativo.comum.unidade |


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

Sistema: SIPAC

Módulo: Faturas

Link(s): Faturas -> Telefonia -> Relatórios -> Gastos Mensais com Telefonia

Usuários: lof (GESTOR_FATURAS).


Papel que usuário deve ter: SipacPapeis.GESTOR_FATURAS, SipacPapeis.GESTOR_ACOMPANHAMENTO_FATURAS, SipacPapeis.GESTOR_TELEFONES.

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

 
  * Para alterar os dados do relatório a fatura precisa ser processada.
          - Ir em Faturas -> Telefonia -> Contas Telefônicas -> [[desenvolvimento:especificacoes:sipac:faturas:casos_de_uso:telefonia:contas_telefonicas:carregar_arquivo_de_contas_telefonicas|Carregar Arquivo de Contas Telefônicas]]
          - Selecionar o mês, ano e o tipo de telefone e carregar o arquivo da conta telefônica.
          - Enviar o arquivo:


{{:desenvolvimento:especificacoes:sipac:faturas:casos_de_uso:telefonia:contas_telefonicas:relatorios:contas.rar|Arquivo de Contas Telefônicas}}

O procedimento deve alterar os dados do relatório.

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

Resultado da busca:
<code sql>
SELECT distinct u.id_unidade,u.codigo_unidade,u.sigla   
	FROM contratos.ligacao_telefonica lt 
	LEFT JOIN contratos.linha_telefonica linha ON (linha.id_linha_telefonica = lt.id_linha_telefonica) 
	LEFT JOIN contratos.fatura_processada f ON (f.id_fatura_processada = lt.id_fatura_processada) 
	LEFT JOIN comum.unidade u ON (linha.id_unidade_pagadora = u.id_unidade) 
  
        -- alterar o ano e o tipo de telefone para o desejado. Tipos de telefone: 1 - FIXO, 2 - CELULAR, 3 - FAX, 4 - VOIP
	WHERE lt.id_linha_telefonica is not null AND f.ano = 2010 AND f.id_tipo_fatura = 1 AND f.id_tipo_telefone in ( 2 )
</code>