====== Especificação funcional: Relatório de análise financeira ======

===== Descrição =====

O relatório de análise financeira resume a movimentação de títulos recebidos,  títulos pagos e transferências entre contas realizadas no sistema, além de exibir o saldo do módulo de cheques e de todas as contas cadastradas no módulo de movimentações bancárias. Ao final do resumo de títulos a pagar, títulos a receber e transferências, o relatório deve exibir os totais para as colunas que possuírem valores monetários.

===== Opções e filtros =====
O relatório deve permitir que o usuário utilize os seguintes filtros:
  * //Data inicial//: Determina o início do período do relatório.
  * //Data final//: Determina o fim do período, que não deve ser anterior à data inicial.

Para facilitar o preenchimento dos filtros, o sistema deverá trazer, como opção, o campo data inicial preenchido com o primeiro dia do mês corrente e o campo data final preenchido com a data atual.

===== 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 (Análise financeira) e o período informado pelo usuário.

==== Corpo do relatório ====

|<100% 10% 10% 10% 20% 20% 10% 10% 10%>|
^                                                                                            Títulos Recebidos                                                                                                   ^^^^^^^^
^ Cód.               ^ Vencimento        ^ Pagamento          ^ Pessoa            ^ Histórico             ^ Forma de pagamento                          ^ Valor                    ^ Valor recebido                     ^
| <Código do título> | <Data vencimento> | <Data do pagamento> | <Nome da pessoa> | <Histórico do título> | <Descrição da forma de pagamento utilizada> |        <Valor do título> |                   <Valor recebido> |
|                                                                                                                                                  ||||||   **<Soma dos valores>** |   **<Soma dos valores recebidos>** |

|<100% 10% 10% 10% 20% 20% 10% 10% 10%>|
^                                                                                            Títulos Pagos                                                                                                   ^^^^^^^^
^ Cód.               ^ Vencimento        ^ Pagamento          ^ Pessoa            ^ Histórico             ^ Forma de pagamento                          ^ Valor                    ^ Valor pago                     ^
| <Código do título> | <Data vencimento> | <Data do pagamento> | <Nome da pessoa> | <Histórico do título> | <Descrição da forma de pagamento utilizada> |        <Valor do título> |                   <Valor pago> |
|                                                                                                                                                  ||||||   **<Soma dos valores>** |   **<Soma dos valores pagos>** |

|<100% 10% 10% 10% 20% 30% 10% 10%>|
^                                                                                              Transferências realizadas                                                                                    ^^^^^^^^
^ Cód.                        ^ Pré-data   ^ Compensação           ^ Origem                   ^ Histórico                   ^ Crédito                                    ^ Débito                                    ^
| <Código da transferência>   | <Pré-data> | <Data de compensação> | <Origem da movimentação> | <Histórico da movimentação> |   <Valor da movimentação (se for crédito)> |   <Valor da movimentação (se for débito)> |


|<100% 25% 15% 15% 15% 15% 15%>|
^                                                                                              Saldos                                                                                          ^^^^^^
^ Contas               ^ Saldo Real Anterior                ^ Total de entradas                ^ Total Saídas                   ^ Saldo Real                    ^ Saldo Bancário                    ^
| <Descrição da conta> |    <Saldo anterior à data inicial> |   <Total de entradas no período> |   <Total de saídas no período> |         <Saldo real da conta> |         <Saldo bancário da conta> |
| **Total**            |   **<Soma dos saldos anteriores>** |          **<Soma dos créditos>** |         **<Soma dos débitos>** |   **<Soma dos saldos reais>** |   **<Soma dos saldos bancários>** |

==== 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 necessários de duas fontes:
  * Do cadastro de títulos, para os títulos recebidos e títulos pagos.
  * Das movimentações de contas bancárias, para transferências e saldos.

==== Registros ====
Cada título pago e recebido cujos dados correspondam com os filtros definidos deve corresponder a um registro no relatório, separados de acordo com seu tipo (a pagar/a receber). Esses registros são ordenados pela data de pagamento, em ordem crescente. Abaixo da lista de registros de cada tipo de título as colunas de valor devem ser totalizadas.

Para as transferências, cada operação deve gerar dois registros: um para a conta de origem e outro para a conta de destino. Esses registros são agrupados e subtotalizados por conta bancária, e são ordenados por pré-data, em ordem crescente. Abaixo da lista de registros as colunas de valor devem ser totalizadas.

=== Cálculo dos saldos ===
== Cheques ==
  * //Caso o sistema esteja configurado para considerar cheques devolvidos//: Soma dos valores dos cheques recebidos até a data inicial, não compensados ou compensados após a data inicial + soma dos cheques devolvidos até a data atual.
  * //Caso o sistema esteja configurado para NÃO considerar cheques devolvidos//: Soma dos valores dos cheques recebidos até a data inicial, não compensados ou compensados após a data inicial.

== Contas bancárias ==

  * //Saldo real anterior//: Saldo inicial da conta + entradas (crédito) até o período - saídas (débito) até o período.
  * //Total das entradas//: Soma do valor de todos os lançamentos de crédito do relatório.
  * //Total das saídas//: Soma do valor de todos os lançamentos de débito do relatório.
  * //Saldo real//: Saldo anterior + total das entradas - total das saídas.
  * //Saldo bancário//: Idêntico ao saldo real, porém calculado com base apenas nos lançamentos conciliados.
  * //Total//: Totais de cada coluna de dados da tabela de saldos.

===== Modelo =====
{{:softwares:monnae:requisitos:relatorios:modelo_relatorio_analise_financeira.pdf|Modelo do Relatório de análise financeira.}}

===== Pontos de verificação =====
  * 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.
  * Os dados de contas bancárias exibidos no sistema deverão ser relativos apenas as contas ativas.

===== Observações =====

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