====== Relatório de entrega de notas ======

===== Resumo =====

Relatório que apresenta a numeração das notas emitidas, canceladas e não entregues para cada produtor.

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

Este relatório irá possibilitar ao usuário fazer o controle de talões e saber quais notas foram ou não entregues pelo produtor. O relatório se baseia nas informações fornecidas pelo próprio usuário em dois momentos:
  *  No [[softwares:geagro:requisitos:modulos:cadastros:propriedades|cadastro de propriedades]], onde o usuário pode informar os talões que foram distribuídos para cada produtor, o que também pode ser feito através dos processos de [[softwares:geagro:requisitos:modulos:cadastros:acompanhamento_processos|requisição de talões notas fiscais]];
  *  No [[softwares:geagro:requisitos:modulos:cadastros:notas_fiscais|cadastro de notas fiscais]], onde é registrada a entrega das mesmas.

As informações do cadastro do produtor servem como base para determinar quais talões foram entregues ao produtor e compará-los com as notas cadastradas **pela data e numeração**. A comparação deve ser feita de acordo com o seguinte critério:

<note>Todas as notas com número dentro da numeração inicial e final de um determinado talão e com data igual ou posterior à data da AIDF deste, mas anterior à AIDF do talão  seguinte, são candidatas a pertencerem àquele talão.

Para as notas emitidas, a data considerada é a data de emissão. Para as canceladas, a data de entrega.</note>

Portanto, assume-se que:
  * Novos talões só sejam distribuídos ao produtor após o término do talão anterior e
  * As notas canceladas sejam entregues antes da distribuição do próximo talão. 

Para cada produtor que tenha talões cadastrados, o relatório deve buscar as notas emitidas e canceladas de cada talão, segundo os critérios especificados acima.

Caso nenhuma nota seja encontrada, todo o talão é considerado como não entregue.

Caso contrário, devem ser feitas as devidas comparações para determinar quais notas do talão ainda não foram entregues.

**Somente os talões incompletos serão incluídos no relatório. São considerados incompletos os talões com ao menos uma nota ainda não entregue.**

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

O relatório deve permitir que o usuário filtre os produtores de acordo com os seguintes critérios:
  * **Exibir todos os produtores** ou 
  * **Exibir somente os produtores das propriedades nestes locais**:
    *  **Distrito**: Filtro opcional. O sistema deve permitir que o usuário selecione um distrito para que somente os dados dos produtores de um determinado distrito sejam exibidos. Valor padrão: TODOS;
    *  **Localidade**: Filtro opcional. O sistema deve permitir que o usuário selecione uma localidade para que somente os dados dos produtores de uma determinada localidade sejam exibidos. Só será permitido selecionar uma localidade se tiver sido selecionado um distrito específico. Neste caso, só serão exibidas as localidades do distrito selecionado. Valor padrão: TODAS.

O sistema deve permitir ainda que todos os produtores sejam incluídos no relatório, independente de quaisquer filtros.

===== 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 do relatório deve exibir as seguintes informações:
  *  **Título**: Deve exibir o título do relatório: "Relatório de Entrega de Notas";
  *  **Distrito**: Deve exibir o distrito selecionado ou a palavra "TODOS";
  *  **Localidade**: Deve exibir a localidade selecionada ou a palavra "TODAS".

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

O relatório deve exibir as seguintes informações para todos os produtores com notas ainda não entregues:

**<Nome do produtor>** - **<Número da inscrição estadual>**
|< 100% >|
^  **Nº AIDF**      ^  **Notas do talão**                 ^  **Nºs das notas emitidas**      ^  **Nºs das notas canceladas**      ^  **Nºs das notas não entregues**      ^
|  <AIDF do talão>  |  <número inicial e final do talão>  |  <intervalos de notas emitidas>  |  <intervalos de notas canceladas>  |  <intervalos de notas não entregues>  |

Podem ser exibidos vários talões para um único produtor.

==== 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 número da AIDF e a numeração inicial e final de cada talão é obtido dos talões distribuídos para os produtores no cadastro de propriedades.

Os intervalos de notas emitidas e canceladas vem da comparação dos talões com as notas cadastradas no sistema.

As notas não entregues são todas aquelas que não constarem no sistema, dentro da numeração de cada talão.

===== Pontos de verificação =====
  * Os dados apresentados no relatório devem ser compatíveis com os talões e com as notas cadastradas para os respectivos produtores;
  * Ao filtrar por distritos e/ou localidades, verificar se o relatório apresenta somente os produtores do local selecionado;
  * Para os produtores com talões cadastrados mas nenhuma nota fiscal entregue, o relatório deve apresentar todas as notas do talão como não entregues;
  * Talões que tem todas as notas entregues **não** devem ser exibidos no relatório.

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

N/A