Mudanças entre as edições de "Relatório de Faturamento"

De GeoSales
Ir para navegação Ir para pesquisar
(Criou página com '== Histórico de Alterações == {| class="wikitable" ! Data ! Quem ! Comentários |- | 13/08/2018 || Ana Júlia || Criação do documento |- |} == Necessidade == Os su...')
 
 
(32 revisões intermediárias por 3 usuários não estão sendo mostradas)
Linha 6: Linha 6:
 
|-
 
|-
 
|  13/08/2018  || Ana Júlia || Criação do documento  
 
|  13/08/2018  || Ana Júlia || Criação do documento  
 +
|-
 +
|  08/05/2019  || Ana Júlia || Alteração do documento
 
|-
 
|-
 
|}
 
|}
Linha 11: Linha 13:
 
== Necessidade ==
 
== Necessidade ==
  
Os supervisores e vendedores precisam ter um controle maior dos pedidos não entregues, sendo necessário a visualização dos pedidos que não foram faturados.  
+
Os supervisores e vendedores precisam ter um controle maior dos pedidos faturados, sendo necessário a visualização dos pedidos que possuem nota fiscal.  
  
Os pedidos que não ativerem nota fiscal, ou seja, não tiveram sido faturados, devem estar presentes nesse conjunto de pedidos não entregues.
+
Os pedidos que possuírem nota fiscal, ou seja, tiveram sido faturados, devem estar presentes nesse conjunto de pedidos faturados.
  
 
== Solução ==
 
== Solução ==
  
O relatório de pedidos não entregues, funciona atualmente pelo status 'Não Entregue', fazendo com que exiba no relatório os pedidos que tiverem esse status, ou seja, pedidos que não possuem nota fiscal.  
+
O relatório de faturamento, funciona atualmente pela consulta de nota fiscal, fazendo com que exiba no relatório os pedidos que tiverem esse status, ou seja, pedidos que não possuem nota fiscal.  
  
É necessário que seja feita uma validação pela nota fiscal, onde pedidos que não tiverem nota fiscal, devem fazer parte do relatório de pedidos não entregues.
+
É necessário que seja feita uma validação pela nota fiscal, onde pedidos e itens que tiverem nota fiscal, devem fazer parte do relatório de faturamento.
  
 
== Implementação ==
 
== Implementação ==
Linha 25: Linha 27:
 
=== Desenvolvimento ===
 
=== Desenvolvimento ===
  
Deverá ser feito um ajuste no relatório de pedidos não entregues, que permitirá ao vendedor e supervisor a visualização dos pedidos que possuam itens que não tenham sido entregues (faturados).  
+
Deverá ser feito um ajuste no relatório de faturamento, que permitirá ao vendedor e supervisor a visualização dos pedidos que possuam itens que tenham sido faturados.  
  
As informações do relatório de pedidos não entregues, devem ser baseadas nas tabelas ITEM_NOTA_FISCAL, PEDIDO_NOTA_FISCAL, NOTA_FISCAL, PEDIDO_RETORNO e ITEM_PEDIDO_RETORNO, onde, no relatório de pedidos não entregues deverá ter os pedidos que não tiverem nota fiscal (faturados)
+
As informações do relatório de faturamento, devem ser baseadas nas tabelas NOTA_FISCAL, PEDIDO_NOTA_FISCAL, PEDIDO_RETORNO, CLIENTE, VENDEDOR e PRODUTO, onde, no relatório de faturamento deverá ter os pedidos que tiverem nota fiscal (faturados)
  
  Por exemplo: O vendedor tirou 1 (um) pedido 'X' com 5 (cinco) itens, sendo eles respectivamente 'A,B,C,D,E', tendo como data de emissão o dia 12 de outubro. O pedido 'X' entrou no ERP com os 5 (cinco) itens no dia 12 de outubro, e retornou para o GeoSales com o status em 'aberto' no dia 12 de outubro. Por instancia, o pedido 'X' com seus 5 (cinco) itens devem ficar visíveis no relatório.
+
  Por exemplo: O vendedor tirou 1 (um) pedido 'X' com 5 (cinco) itens, sendo eles respectivamente 'A,B,C,D,E', tendo como data de emissão o dia 12 de outubro. O pedido 'X' entrou no ERP com os 5 (cinco) itens no dia 12 de outubro, e retornou para o GeoSales com o status em 'aberto' no dia 12 de outubro. Por instancia, o pedido 'X' com seus 5 (cinco) itens não devem ficar visíveis no relatório, já que não houve faturamento
  No dia 13 de outubro o pedido 'X' teve os itens 'A,B e C' faturados, ou seja, no relatório de pedido não entregue deverá ficar visível o pedido 'X' e os itens D e E.
+
  No dia 13 de outubro o pedido 'X' teve os itens 'A,B e C' faturados, ou seja, no relatório de faturamento deverá ficar visível o pedido 'X' e os itens 'A,B e C'.
  
 
Alguns itens podem ser entregues em partes, devido a unidade de medida utilizada.  
 
Alguns itens podem ser entregues em partes, devido a unidade de medida utilizada.  
Linha 36: Linha 38:
 
  Por exemplo: O vendedor tirou o pedido 'X' tendo os itens 'Y' e 'Z', onde o 'Y' teve o valor 1.980000 e o 'Z' 0.960000 de quantidade solicitada, e só foi faturado de 'Y' 1.000000 e 'Z' 0.000000, ou seja, quantidade entregue.
 
  Por exemplo: O vendedor tirou o pedido 'X' tendo os itens 'Y' e 'Z', onde o 'Y' teve o valor 1.980000 e o 'Z' 0.960000 de quantidade solicitada, e só foi faturado de 'Y' 1.000000 e 'Z' 0.000000, ou seja, quantidade entregue.
  
Caso o item não tenha sido faturado totalmente, deverá ser exibido na relatório a nota fiscal da quantidade já faturada e a quantidade que falta para que seja faturado por completo.  
+
Caso o item não tenha sido faturado totalmente, deverá ser exibido no relatório de faturamento, a nota fiscal e a quantidade já faturada.
 +
 
 +
Deverá ser criada um novo campo na tabela de item nota fiscal, onde receberá a data em que o item foi faturado.
  
O relatório de pedido não entregue terá os seguintes campos, pegando como base as seguintes tabelas:
+
O relatório de faturamento terá os seguintes campos, pegando como base as seguintes tabelas:
  
Onde o campo 'Informação do Relatório' se referencia ao campo que ficará disponível no relatório de pedidos não entregues, o campo 'Tabelas que serão consultadas' e 'Campos' é referente as tabelas que serão consultadas para que fique visível as informações de pedidos não entregues no relatório.
+
Onde o campo 'Informação do Relatório' é referente ao campo que ficará disponível no relatório de faturamento, o campo 'Tabelas que serão consultadas' e 'Campos' é referente as tabelas que serão consultadas para que fique visível as informações de pedidos faturados.
  
 
{| class="wikitable"
 
{| class="wikitable"
! colspan="6"  | RELATÓRIO DE PEDIDO NÃO ENTREGUE
+
! colspan="6"  | RELATÓRIO DE FATURAMENTO
 
|-
 
|-
 
! |Informação do Relatório
 
! |Informação do Relatório
Linha 52: Linha 56:
 
|-  
 
|-  
 
| Descrição Cliente || CLIENTE || NM_CLIENTE
 
| Descrição Cliente || CLIENTE || NM_CLIENTE
 +
|-
 +
| Código Produto || PRODUTO || CD_PRODUTO
 
|-  
 
|-  
 
| Descrição Produto || PRODUTO || NM_PRODUTO
 
| Descrição Produto || PRODUTO || NM_PRODUTO
 
|-  
 
|-  
| Código do Pedido || PEDIDO_RETORNO || CD_PEDIDO_PALM
+
| Organização venda (Filial)  || CD_ORG_VENDA || NOTA_FISCAL
 +
|-
 +
| Numeração da nota fiscal || ITEM_NOTA_FISCAL || CD_NOTA_FISCAL
 
|-  
 
|-  
| Código dos itens do Pedido || ITEM_PEDIDO_RETORNO || CD_PRODUTO
+
| Serie da nota fiscal || ITEM_NOTA_FISCAL || NM_SERIE
 
|-  
 
|-  
| Data de Faturamento || NOTA_FISCAL || DT_EMISSAO
+
| Data de emissão da nota fiscal || NOTA_FISCAL || DT_EMISSAO
|-
+
|-
| Quantidade de Produto Solicitado || ITEM_PEDIDO_RETORNO || QT_ITEM
+
| Quantidade de Produto Entregue || ITEM_NOTA_FISCAL|| QT_ITEM
|-  
+
|-
| Quantidade de Produto Entregue || ITEM_NOTA_FISCAL || QT_ITEM
+
| Valor Unitário || ITEM_NOTA_FISCAL || VR_UNITARIO
|-  
 
| Diferença de Quantidade Solicitado e Quantidade Entregue || O Calculo será realizado no Geosales || *
 
|-
 
|}
 
 
 
A tela de consulta do relatório de pedidos não entregues, será composta pelos seguintes campos:
 
 
 
A tabela 'filtros' é sobre os filtros disponibilizados no portal, para facilitar a busca do usuário.
 
 
 
{| class="wikitable"
 
! colspan="6"  | FILTROS
 
! |CAMPO
 
! |DESCRIÇÃO
 
|-
 
| Período || Espaço de tempo entre dois acontecimentos ou datas diferentes
 
 
|-
 
|-
| Cliente|| Devem aparecer os clientes de acordo com a hierarquia, onde o vendedor só poderá ver seus próprios e o supervisor, poderá visualizar os clientes que estão vinculados aos vendedores abaixo.
+
| Valor Total || ITEM_NOTA_FISCAL || VR_TOTAL_ITEM
 
|-
 
|-
| Organização de venda|| Organizações de vendas disponíveis no GeoSales (Filial)
+
| Código do vendedor || VENDEDOR || CD_VENDEDOR
 
|-
 
|-
| Supervisor || Supervisores cadastrados no Geosales, para os vendedores só deverá aparecer o supervisor que estiver vinculado, de acordo com a tela de pesquisa vendedor
+
| Total Item || Será calculado no GeoSales || *
 
|-
 
|-
| Vendedor || Para o usuário vendedor, deverá aparecer ele mesmo, já para o usuário supervisor deverá aparecer todos os vendedores vinculados ao usuário de supervisor que estiver logado.
+
| Total Geral || Será calculado no GeoSales || *
 
|-
 
|-
 
|}
 
|}
  
Contendo também na tela de pesquisa, os botões de 'Gerar PDF', 'Gerar XLS' e 'Limpas', tendo as seguintes funções:
+
O campo 'Total Geral' e 'Total Item' será utilizada para exibir o valor total da nota, de acordo com o período filtrado.
  
* '''Gerar PRF:''' Será gerado um relatório em PRF com as informações de pedidos não entregues.
+
O campo dt_emissao do relatório de faturamento, deverá buscar da tabela NOTA_FISCAL do campo DT_EMISSAO.
* '''Gerar XLS:''' Será gerado um relatório excel com as informações de pedidos não entregues.
 
* '''Limpas:''' Limpará os dados preenchidos na tela de consulta do relatório de pedidos não entregues.
 
  
 
=== Integração ===
 
=== Integração ===
  
Atualmente no banco SQL da Ferronorte, a tabela ITEM_NOTA_FISCAL tem o campo QT_ITEM trazendo valores inteiros, será necessário ajustar para que traga valores decimais.
+
O relatório de faturamento se baseia nas tabelas de pedido, nota fiscal e pedido nota fiscal. Onde a nota fiscal do pedido se baseia na tabela de item do ERP, ou seja, caso um mesmo pedido tenha itens em distintas notas fiscais, será exibido no relatório.
 +
 
 +
Por exemplo: o pedido 'X' possui 2 (dois) itens 'Y' e 'Z', possuindo 2 notas fiscais distintas no item, onde o item 'Y' possui a nota fiscal 1000048138 e o item 'Z' possui a nota fiscal 1000048142.
 +
 
 +
Mesmo os itens estando na situação exemplificada acima, deverá trazer no relatório de faturamento.
 +
 
 +
=== Estrutura de banco ===
 +
 
 +
{| class="wikitable"
 +
! colspan="5"  | ITEM_NOTA_FISCAL
 +
|-
 +
! style="width:200px" |Coluna
 +
! Tipo
 +
! style="width:200px" |Obrigatório
 +
! style="width:300px" |Chave Primária
 +
! style="width:300px" |Explicação
 +
|-
 +
| DT_EMISSAO
 +
| datetime (8)
 +
| NÃO
 +
| NÃO
 +
| Irá receber a data em que o item foi faturado
 +
|-
 +
|}
  
 
== Regras de Negócios ==
 
== Regras de Negócios ==
Linha 104: Linha 118:
 
'''RN1 -''' Não será criado nenhum outro campo além dos que estão contemplados neste documento.
 
'''RN1 -''' Não será criado nenhum outro campo além dos que estão contemplados neste documento.
  
'''RN2 -''' Só poderão ser visualizados os pedidos que não foram entregues para seus respectivos vendedores.  
+
'''RN2 -''' Só poderão ser visualizados os pedidos que foram faturados para seus respectivos vendedores.  
  
'''RN3 -''' Só poderão ser visualizados os pedidos não entregues para o supervisor de acordo com a hierarquia cadastrada.
+
'''RN3 -''' Só poderão ser visualizados os pedidos faturados para o supervisor de acordo com a hierarquia cadastrada.
  
 
== Regras de Integração ==
 
== Regras de Integração ==
 +
 +
'''RI1 -''' As informações de nota fiscal por item, serão consultadas na tabela de item do ERP (SC6) da coluna C6_NOTA.
  
 
== Resultados Esperados ==  
 
== Resultados Esperados ==  
Linha 114: Linha 130:
 
=== Protótipos ===
 
=== Protótipos ===
  
[[Arquivo:Consulta Pedido Não Entregue.JPG]]
+
[[Arquivo:Relatorio de faturamento.JPG]]
  
[[Arquivo:Relatório de Pedido Não Entregue.jpg]]
+
[[Arquivo:Relatorio de faturamento exemplo ferronorte cenario.png]]
  
 
=== Fluxos Padrão ===
 
=== Fluxos Padrão ===
Linha 140: Linha 156:
 
! style="width:200px" |Assinatura
 
! style="width:200px" |Assinatura
 
|-  
 
|-  
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000 ||  
+
| Desenvolvimento - GeoSales || Luan Lima || 16/08/2018 ||  
 
|-  
 
|-  
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000 ||
+
| Integração - GeoSales || Pessoa que aprovou || 16/08/2018 || Carlos Robson
|-
 
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000 ||
 
 
|-
 
|-
 
|}
 
|}

Edição atual tal como às 13h47min de 8 de maio de 2019

Histórico de Alterações

Data Quem Comentários
13/08/2018 Ana Júlia Criação do documento
08/05/2019 Ana Júlia Alteração do documento

Necessidade

Os supervisores e vendedores precisam ter um controle maior dos pedidos faturados, sendo necessário a visualização dos pedidos que possuem nota fiscal.

Os pedidos que possuírem nota fiscal, ou seja, tiveram sido faturados, devem estar presentes nesse conjunto de pedidos faturados.

Solução

O relatório de faturamento, funciona atualmente pela consulta de nota fiscal, fazendo com que exiba no relatório os pedidos que tiverem esse status, ou seja, pedidos que não possuem nota fiscal.

É necessário que seja feita uma validação pela nota fiscal, onde pedidos e itens que tiverem nota fiscal, devem fazer parte do relatório de faturamento.

Implementação

Desenvolvimento

Deverá ser feito um ajuste no relatório de faturamento, que permitirá ao vendedor e supervisor a visualização dos pedidos que possuam itens que tenham sido faturados.

As informações do relatório de faturamento, devem ser baseadas nas tabelas NOTA_FISCAL, PEDIDO_NOTA_FISCAL, PEDIDO_RETORNO, CLIENTE, VENDEDOR e PRODUTO, onde, no relatório de faturamento deverá ter os pedidos que tiverem nota fiscal (faturados)

Por exemplo: O vendedor tirou 1 (um) pedido 'X' com 5 (cinco) itens, sendo eles respectivamente 'A,B,C,D,E', tendo como data de emissão o dia 12 de outubro. O pedido 'X' entrou no ERP com os 5 (cinco) itens no dia 12 de outubro, e retornou para o GeoSales com o status em 'aberto' no dia 12 de outubro. Por instancia, o pedido 'X' com seus 5 (cinco) itens não devem ficar visíveis no relatório, já que não houve faturamento
No dia 13 de outubro o pedido 'X' teve os itens 'A,B e C' faturados, ou seja, no relatório de faturamento deverá ficar visível o pedido 'X' e os itens 'A,B e C'.

Alguns itens podem ser entregues em partes, devido a unidade de medida utilizada.

Por exemplo: O vendedor tirou o pedido 'X' tendo os itens 'Y' e 'Z', onde o 'Y' teve o valor 1.980000 e o 'Z' 0.960000 de quantidade solicitada, e só foi faturado de 'Y' 1.000000 e 'Z' 0.000000, ou seja, quantidade entregue.

Caso o item não tenha sido faturado totalmente, deverá ser exibido no relatório de faturamento, a nota fiscal e a quantidade já faturada.

Deverá ser criada um novo campo na tabela de item nota fiscal, onde receberá a data em que o item foi faturado.

O relatório de faturamento terá os seguintes campos, pegando como base as seguintes tabelas:

Onde o campo 'Informação do Relatório' é referente ao campo que ficará disponível no relatório de faturamento, o campo 'Tabelas que serão consultadas' e 'Campos' é referente as tabelas que serão consultadas para que fique visível as informações de pedidos faturados.

RELATÓRIO DE FATURAMENTO
Informação do Relatório Tabelas que serão consultadas Campos
Código Cliente CLIENTE CD_CLIENTE
Descrição Cliente CLIENTE NM_CLIENTE
Código Produto PRODUTO CD_PRODUTO
Descrição Produto PRODUTO NM_PRODUTO
Organização venda (Filial) CD_ORG_VENDA NOTA_FISCAL
Numeração da nota fiscal ITEM_NOTA_FISCAL CD_NOTA_FISCAL
Serie da nota fiscal ITEM_NOTA_FISCAL NM_SERIE
Data de emissão da nota fiscal NOTA_FISCAL DT_EMISSAO
Quantidade de Produto Entregue ITEM_NOTA_FISCAL QT_ITEM
Valor Unitário ITEM_NOTA_FISCAL VR_UNITARIO
Valor Total ITEM_NOTA_FISCAL VR_TOTAL_ITEM
Código do vendedor VENDEDOR CD_VENDEDOR
Total Item Será calculado no GeoSales *
Total Geral Será calculado no GeoSales *

O campo 'Total Geral' e 'Total Item' será utilizada para exibir o valor total da nota, de acordo com o período filtrado.

O campo dt_emissao do relatório de faturamento, deverá buscar da tabela NOTA_FISCAL do campo DT_EMISSAO.

Integração

O relatório de faturamento se baseia nas tabelas de pedido, nota fiscal e pedido nota fiscal. Onde a nota fiscal do pedido se baseia na tabela de item do ERP, ou seja, caso um mesmo pedido tenha itens em distintas notas fiscais, será exibido no relatório.

Por exemplo: o pedido 'X' possui 2 (dois) itens 'Y' e 'Z', possuindo 2 notas fiscais distintas no item, onde o item 'Y' possui a nota fiscal 1000048138 e o item 'Z' possui a nota fiscal 1000048142.

Mesmo os itens estando na situação exemplificada acima, deverá trazer no relatório de faturamento.

Estrutura de banco

ITEM_NOTA_FISCAL
Coluna Tipo Obrigatório Chave Primária Explicação
DT_EMISSAO datetime (8) NÃO NÃO Irá receber a data em que o item foi faturado

Regras de Negócios

RN1 - Não será criado nenhum outro campo além dos que estão contemplados neste documento.

RN2 - Só poderão ser visualizados os pedidos que foram faturados para seus respectivos vendedores.

RN3 - Só poderão ser visualizados os pedidos faturados para o supervisor de acordo com a hierarquia cadastrada.

Regras de Integração

RI1 - As informações de nota fiscal por item, serão consultadas na tabela de item do ERP (SC6) da coluna C6_NOTA.

Resultados Esperados

Protótipos

Relatorio de faturamento.JPG

Relatorio de faturamento exemplo ferronorte cenario.png

Fluxos Padrão

  1. Acessar com o usuário vendedor;
    1. Preencher o filtro de período;
    2. Clicar em 'Gerar PDF' ou 'Gerar XLS';
  2. Acessar com o usuário supervisor;
    1. Preencher o filtro de período;
    2. Escolher um vendedor;
    3. Clicar em 'Gerar PDF' ou 'Gerar XLS';

Aprovação

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

GeoSales

Setor Aprovado Por Data Assinatura
Desenvolvimento - GeoSales Luan Lima 16/08/2018
Integração - GeoSales Pessoa que aprovou 16/08/2018 Carlos Robson

Empresa solicitante

Setor Aprovado Por Data Assinatura
Gerente TI - Cliente Pessoa que aprovou 00/00/0000
Gerente de Projeto - Cliente Pessoa que aprovou 00/00/0000
Gerente Comercial - Cliente Pessoa que aprovou 00/00/0000