~~ODT~~

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

====== Cadastrar Serviço ======

Este caso de uso é utilizado pelos gestores de faturas com a finalidade de realizar o cadastro dos serviços no sistema. Cada fatura representa um documento de venda de serviços e está associada a uma empresa, que presta os serviços, e a uma unidade da instituição, que usufrui dos serviços. Os serviços representam as despesas a serem pagas através de uma fatura. Em cada serviço é discriminado o item comprado na operação, e por isso, a fatura também é usada como controle. 

Pré-condições: 
   * Para realizar o cadastro de um serviço de uma fatura, o usuário deve ter a fatura previamente cadastrada.
   * O processo que deverá ser associado ao serviço deve estar cadastrado no sistema.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Módulo Faturas -> Aba Operações -> Faturas -> Serviços -> Cadastrar Serviço//.

O sistema solicita que informe os dados da fatura:
  * **Empresa***: Tipo - TEXTO.
  * **Unidade***: Tipo - TEXTO. Entrada de dados: CÓDIGO ou NOME DA UNIDADE associada a fatura.
  * **Fatura***: Tipo TEXTO, formato: NÚMERO - UNIDADE FATURA ([[#pRINCIPAIS REGRAS DE NEGÓCIO|RN03]]).

O sistema solicita os dados para cadastro do item de serviço:
  * **Mês de Referência***: Tipo TEXTO, formato: NOME MÊS.
  * **Ano***: Tipo NUMÉRICO, formato: AAAA.
  * **Data de Vencimento***: Tipo DATA.
  * **Data de Pagamento**: Tipo DATA.
  * **Consumo**: Tipo NUMÉRICO.
  * **Processo***: Tipo NUMÉRICO, formato: ...9/AAAA.
  * **Ordem Bancária**: Tipo - NUMÉRICO.
  * **Valor Bruto***: Tipo - NUMÉRICO.
  * **Valor Desconto**: Tipo - NUMÉRICO.
  * **Valor Juros**: Tipo - NUMÉRICO.
  * **Imposto Retido***: Tipo - NUMÉRICO. ([[desenvolvimento:especificacoes:sipac:faturas:casos_de_uso:operacoes:faturas:servicos:cadastrar_servico#principais_regras_de_negócio|RN04]])
  * **Valor Líquido***: Tipo - NUMÉRICO.

É solicitado também a relação de Notas Fiscais vinculadas ao serviço: ([[desenvolvimento:especificacoes:sipac:faturas:casos_de_uso:operacoes:faturas:servicos:cadastrar_servico#principais_regras_de_negócio|RN02]])
  * **Número**: Formato - 99999999999, Tipo - NUMÉRICO.
  * **Série **: Formato - XXXXXX, Tipo - TEXTO.


O caso de uso é finalizado.

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

  * **RN01** - Em uma mesma fatura, não pode existir mais de um serviço que apresente o Processo, a Ordem Bancária e a Data de Pagamento iguais.
  * **RN02** - Deve ser permitido informar mais de uma Nota Fiscal para cada Fatura.
  * **RN03** - Esse campo é exibido caso existam faturas cadastradas e tanto à empresa quanto à unidade selecionada.
  * **RN04** - O Valor do Imposto Retido é obrigatório e deve ser maior que 0 (zero).

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

Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.faturas.dominio.Fatura | administrativo.contratos.fatura |
| br.ufrn.sipac.faturas.dominio.FaturaServico | administrativo.contratos.fatura_servicos |
| br.ufrn.comum.dominio.PessoaGeral (Empresa) | administrativo.public.pessoa |
| br.ufrn.sipac.cadastro.dominio.Unidade | administrativo.public.unidade |
| br.ufrn.sipac.faturas.dominio.LocalidadeUnidade | administrativo.contratos.localidade_unidade |
|br.ufrn.sipac.protocolo.dominio.processo | administrativo.protocolo.processo |

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

Sistema: SIPAC

Módulo: Faturas

Link(s): Aba Operações → Faturas → Serviços → Cadastrar Serviço

Usuário: lof

Papel que usuário deve ter: SipacPapeis.GESTOR_FATURAS

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

Preencher os dados conforme são solicitados.

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

Para realizar o teste é necessário obtermos uma fatura a partir da empresa e unidade associados e um processo válido. Para obter as empresas e unidades relacionadas acesse as faturas já cadastradas pelos caminhos: 
  * Faturas → Operações → Faturas → Faturas → Listagem de Faturas
  * Faturas → Operações → Faturas → Serviços → Listagem de Serviços

Já para obter um processo válido acesse por:
  * Portal Administrativo → Protocolo (Menu) → Processos → Consultar Processo