Nota Técnica

Resumo da Nota Técnica

A partir desta orientação, foi documentado o processo de configuração do relatório “Relatório Resumido de Pedidos por Data de Entrega” no módulo de Gerenciamento de Relatórios do sistema FACILITE - Comércio.

Importante destacar que esta Nota Técnica trata apenas da configuração do relatório no sistema, ou seja, do cadastro do relatório, vinculação dos arquivos `.FR3` e `.SQL`, definição dos parâmetros de consulta e validação da impressão. Não se trata de alteração de regra de negócio, cálculo, layout interno do relatório ou desenvolvimento de nova rotina.

Detalhes da Nota Técnica

Foi realizada a configuração de um relatório Fast Report para permitir a emissão do Relatório Resumido de Pedidos por Data de Entrega dentro do sistema.

O objetivo dessa configuração é disponibilizar o relatório no caminho correto do menu de relatórios, permitindo que os usuários autorizados consigam acessá-lo, informar os filtros necessários e realizar a impressão ou visualização dos pedidos conforme a data de entrega.

Para que o relatório funcione corretamente, é necessário que os arquivos do relatório estejam disponíveis na pasta de relatórios do sistema. Os arquivos utilizados na configuração são:

`REL_PEDIDORESUMIDOPORENTREGAGRADESINTETICA.FR3`
`REL_PEDIDORESUMIDOPORENTREGAGRADESINTETICA.SQL`

Esses arquivos devem estar salvos no diretório de relatórios utilizado pelo sistema, por exemplo:

`[UNIDADE]:\Sinco\Integrado\Relatorios`

Após garantir que os arquivos estão na pasta correta, o relatório deve ser configurado através do menu:

Utilitários > Gerenciamento de Relatórios

Dentro da tela de gerenciamento, o relatório deve ser criado como um SubItem no caminho:

Relatórios Fast > Operações > Pedido de Vendas

A descrição utilizada para o relatório deve ser:

Relatório Resumido de Pedidos por Data de Entrega

Na configuração, deve ser selecionado o arquivo `.FR3` correspondente ao relatório e, em seguida, devem ser definidos os usuários que terão permissão para acessá-lo. Após salvar o cadastro, o sistema abrirá a tela de Consulta Personalizada em SQL, onde deverá ser selecionado o arquivo `.SQL` do relatório e feita a validação dos parâmetros.

## Procedimento de Configuração

1. Copiar os arquivos do relatório para a pasta de relatórios do sistema:

`REL_PEDIDORESUMIDOPORENTREGAGRADESINTETICA.FR3`
`REL_PEDIDORESUMIDOPORENTREGAGRADESINTETICA.SQL`

2. Acessar o sistema FACILITE - Comércio.

3. Entrar no menu:

Utilitários > Gerenciamento de Relatórios

4. Localizar o caminho:

Relatórios Fast > Operações > Pedido de Vendas

5. Clicar no botão + SubItem.

6. No campo Descrição, informar:

Relatório Resumido de Pedidos por Data de Entrega

7. No campo Caminho, selecionar o arquivo:

`REL_PEDIDORESUMIDOPORENTREGAGRADESINTETICA.FR3`

8. Marcar os usuários que terão acesso ao relatório.

9. Clicar no botão de gravação para salvar a configuração.

10. Na tela [1211] - FACILITE - CPSql - Consulta Personalizada em SQL, selecionar o arquivo:

`REL_PEDIDORESUMIDOPORENTREGAGRADESINTETICA.SQL`

11. Conferir os parâmetros identificados pelo sistema e avançar as etapas até finalizar a configuração.

Durante a validação do arquivo SQL, deve-se configurar da seguinte forma:

| Parâmetro | Descrição para o Usuário | Tipo | Obrigatório |
| ------------- | ------------------------------------------------- | --------------------------- | ----------- |
| EMPRESA | Código da Empresa | Campo Relacional / Consulta | Não |
| CLIENTE | Código do Cliente | Campo Relacional / Consulta | Não |
| REPRESENTANTE | Código do Representante | Campo Relacional / Consulta | Não |
| NEGOCIACAO | Negociação | Campo Relacional / Lista | Não |
| DATAINICIAL | Data Inicial | Data | Sim |
| DATAFINAL | Data Final | Data | Sim |
| STATUS | Status (I = Impressa / C = Cancelada / A = Ambas) | Texto | Não |
| PRODUTO | Código do Produto | Campo Relacional / Consulta | Não |

Os campos Data Inicial e Data Final são obrigatórios, pois definem o período de entrega que será considerado na emissão do relatório.

## Relacionamento dos Campos

Na configuração dos campos relacionais, foram utilizadas as seguintes tabelas:

| Parâmetro | Tabela Relacionada |
| ------------- | ------------------ |
| EMPRESA | EMPRESA |
| CLIENTE | CLIENTE |
| REPRESENTANTE | REPRESE |
| NEGOCIACAO | NEGOCIA |
| PRODUTO | PRODUTO |

Os campos utilizados como referência para consulta foram:

| Tabela | Campo Relacionado |
| ------- | ----------------- |
| EMPRESA | EMP_CODIGO |
| CLIENTE | CLI_CODIGO |
| REPRESE | REP_CODIGO |
| NEGOCIA | NEG_DESCRICAO |
| PRODUTO | PRO_CODIGO |

## Validação do Relatório

Após finalizar a configuração, o relatório deve ser acessado pelo caminho configurado em:

Relatórios Fast > Operações > Pedido de Vendas > Relatório Resumido de Pedidos por Data de Entrega

Na tela de parâmetros, o usuário deverá informar os filtros desejados, principalmente o período de entrega, preenchendo os campos Data Inicial e Data Final.

Após informar os filtros, o relatório poderá ser visualizado ou impresso.

Na validação apresentada, o relatório foi gerado corretamente, exibindo os filtros aplicados no cabeçalho, como empresa, cliente, representante, período de entrega, negociação, produto e status dos pedidos. Também foram exibidas as informações resumidas dos pedidos encontrados, como pedido, cliente, data do pedido, data de entrega, quantidade, valor, frete, desconto, vendedor e negociação.

## Observações Importantes

Esta configuração apenas disponibiliza o relatório no sistema e vincula os arquivos necessários para sua execução.

Caso o relatório não seja exibido, não abra corretamente ou não retorne informações, devem ser verificados os seguintes pontos:

Se os arquivos `.FR3` e `.SQL` estão na pasta correta.
Se o caminho do arquivo `.FR3` foi informado corretamente no cadastro do relatório.
Se o arquivo `.SQL` correto foi selecionado na etapa de Consulta Personalizada em SQL.
Se os usuários necessários foram marcados na permissão do relatório.
Se os filtros obrigatórios, principalmente Data Inicial e Data Final, foram preenchidos.
Se existem pedidos cadastrados dentro do período informado.

Questões:

Parâmetros Envolvidos

Não há parâmetros envolvidos.