====== Especificação funcional: Relatório de produtos e serviços ======

===== Descrição =====
O relatório de produtos e serviços exibe os saldos dos produtos ou serviços cadastrados ou a movimentação de um produto ou serviço específico em um determinado intervalo de tempo. Como o Monnae não controla diretamente as movimentações de produtos e serviços, o cálculo é realizado através dos itens dos títulos e as operações de entrada e saída são definidas pelo tipo de operação dos lançamentos: títulos a receber (crédito) são considerados como saídas, enquanto títulos a pagar (débitos) são considerados como entradas.

===== Opções e filtros =====
O relatório deve permitir que o usuário utilize os seguintes filtros:
  * //Período//: Determina a data inicial e a data final do relatório.
  * //Produto/serviço//: Permite que o usuário selecione um produto ou serviço específico para que apenas as movimentações desse produto/serviço sejam exibidas.


===== Estrutura do relatório =====

==== Timbre ====
O relatório deve conter no topo da página a logomarca do emitente e os seus dados básicos: Razão Social, endereço, CNPJ e telefone.

==== Cabeçalho ====
O cabeçalho do relatório deve mencionar o título do relatório (Títulos), a data pela qual os registros estão sendo filtrados e o período informado pelo usuário.

==== Corpo do relatório (todos os produtos) ====
|<100% 10% 10% 30% 10% 10% 10% 10% 10%>|
^    Produtos e serviços                                                                                                                                                                                                                                                                      ^^^^^^^^
^           Código            ^            Referência           ^          Descrição             ^                  Unidade                   ^                                             Saldo anterior^                         Entradas^                             Saídas^                            Saldo atual^ 
| <Código do produto/serviço> | <Referência do produto/serviço> | <Descrição do produto/serviço> | <Unidade de medida do produto (principal)> |     <Saldo inicial + entradas - saídas até a data inicial>|   <Soma das entradas no período>|       <Soma das saídas no período>|   <Saldo anterior + entradas - saídas>|

==== Corpo do relatório (um produto específico) ====
|<100% 10% 10% 30% 10% 10% 10% 10% 10%>|
^    Produtos e serviços                                                                                                                                                                                                                                                                                            ^^^^^^^^
^          Data Mov.          ^                Cód. Título                  ^                  Nº Doc.                  ^           Operação             ^         Histórico          ^                                       Entradas^                                      Saídas^                                  Saldo^ 
| Saldo anterior                                                                                                                                                                                                                                          |||||||    <saldo inicial + entradas - saídas até a data inicial>|
| <Data de emissão do título> | <Código do título que gerou a movimentação> | <Número do documento informado no título> | <Operação (crédito ou débito)> |    <Histórico do título>   |   <Valor do item (se for operação de entrada)>|  <Valor do item (se for operação de saída)>|   <Saldo anterior + entradas - saídas>|

==== Rodapé ====
Ao fim do relatório devem ser exibidos:  
  * Total de registros do relatório;
  * Data e hora da emissão do relatório.

===== Origem dos dados =====
O relatório extrai os dados de produtos e serviços do cadastro de produtos/serviços, nas configurações do sistema. As movimentações são extraídas dos itens vinculados aos títulos, no cadastro de títulos. 


==== Registros ====
Quando não for selecionado nenhum produto/serviço específico, cada produto/serviço cadastrado no sistema deve corresponder a um registro no relatório, independente se houveram ou não movimentações durante o período. Quando um produto/serviço específico for selecionado, cada movimentação desse produto/serviço através do cadastro de títulos deve corresponder a um registro no relatório.

Os saldos e as quantidades movimentadas serão apresentados sempre na unidade de medida principal do produto. 

Os registros, quando corresponderem às movimentações de um produto/serviço específico, devem ser ordenados por data de movimentação e por código, em ordem crescente. Quando corresponderem aos saldos dos produtos/serviços deverão ser ordenados por código, em ordem crescente. 


===== Modelo =====
{{{{:softwares:monnae:requisitos:relatorios:modelo_relatorio_servicos.pdf|Modelo do Relatório de produtos e serviços.}}

===== Pontos de verificação =====
  * As características gerais do relatório devem ser validadas através do [[desenvolvimento:checklists:testes_relatorio|checklist para testes de relatório]].
  * As palavras e frases exibidas no relatório devem estar livres de erros de ortografia e gramática, bem como serem escritas de acordo com as regras gerais da Língua Portuguesa.
  * O preenchimento da data inicial e data final deve ser obrigatório.
  * O sistema não deve permitir que o usuário informe uma data final anterior à data inicial.
  * Os registros devem estar ordenados de acordo com as definições dessa documentação.

===== Observações =====
Nenhuma.

~~DISCUSSION|Sugira mudanças, aponte falhas ou contribua de alguma forma aqui:~~