====== Relatório de produção por produtos ======

===== Resumo =====

Relatório que apresenta os produtores ou localidades que guiaram um determinado produto ou categoria de produtos.

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

O Relatório de produção por produtos tem o objetivo de informar quais produtores ou localidades produziram determinados produtos durante um intervalo de tempo. Na medida em que as notas fiscais são cadastradas corretamente com seus respectivos itens, é possível obter estas informações a respeito de cada produto constante nas notas.

===== Configurações e preferências do usuário =====

Os seguintes filtros devem estar disponíveis:

  * **Período**: Filtro obrigatório. O usuário deve informar uma data inicial e uma data final, que servirão para filtrar as notas fiscais pela data de emissão;
  * **Produto** ou **Categoria de Produtos** ou **Categoria da SEFAZ**:  Filtros obrigatórios. O sistema deve permitir que apenas um destes parâmetros seja selecionado para que somente um produto ou categoria (criada pelo usuário ou pela SEFAZ) seja exibido;
  * **Agrupamento**: Define se as notas devem ser somadas por produtor ou por localidade.

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

==== Timbre ====

O relatório deve imprimir, no topo da página, o timbre da empresa que está utilizando o software, contendo a logomarca da empresa, a Razão Social, o endereço, CNPJ e telefone. 

==== Cabeçalho ====

O cabeçalho deve exibir o título do relatório: "Relatório de Produção por Produtos"sem as aspas, além dos filtros:

  * Produto | Categoria | Categoria da SEFAZ;
  * Período;
  * Tipo de agrupamento.

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

O relatório deve exibir as seguintes informações, para cada Produto:

**<Descrição do Produto> - <Unidade de medida>**
|< 100% 20% 40% 20% 20% >|
^ Insc. Estadual          ^ Nome                                      ^                     Qtde.  ^                         Valor  ^
| <I.E. do produtor>      | <Nome do produtor>                        |               <Quantidade> |                        <Valor> |
| ...                     | ...                                       |                        ... |                            ... |
| **Subtotal**            | **<n> produtor(es)**                      |  **<subtotal quantidade>** |           **<subtotal valor>** |

ou

|< 100% 60% 20% 20% >|
^ Localidade               ^                                                 Qtde.  ^                 Valor  ^
| <Nome da localidade>     |                                           <Quantidade> |                <Valor> |
| ...                      |                                                    ... |                    ... |
| **<n> localidade(s)**    |                              **<subtotal quantidade>** |   **<subtotal valor>** |

|< 100% 80% 20% >|
^ Total                    ^                 <Valor total> ^

==== Rodapé ====

Ao fim do relatório devem ser exibidos:

  * O valor total de todos os produtos listados;
  * Total de registros do relatório;
  * Data e hora da emissão do relatório.

===== Origem dos dados =====

A quantidade é obtida convertendo todos os itens das notas fiscais emitidas no período especificado para a unidade principal do produto, de acordo com o agrupamento selecionado.

O valor é a soma dos valores dos itens, de acordo com o agrupamento selecionado.



O valor total é o somatório dos valores de cada produto.

Dependendo das opções do usuário, os totais de quantidades e valores devem ser agrupados por produto **e** unidade de medida **e** inscrição estadual do produtor ou localidade.

===== Pontos de verificação =====

  * A data inicial não pode ser posterior à data corrente;
  * A data inicial não pode ser posterior à data final;
  * O valor total do relatório num determinado período deve ser sempre o mesmo, independente do agrupamento, por produtor ou por localidade;
  * O subtotal de um produto quando todos os produtos são listados deve ser igual ao valor total quando a listagem inclui somente aquele produto;
  * As unidades de medida apresentadas devem ser as unidades principais de cada produto e as quantidades deve ser devidamente calculadas em função do fator de conversão;
  * Os valores dos relatório devem corresponder às notas fiscais emitidas, de acordo com os filtros escolhidos.

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

N/A