Árvore de páginas

Planejamento de Vendas

Características do Requisito

Linha de Produto:

Microsiga Protheus.

Segmento:

Gestão Agroindústria.

Módulo:

SIGAAGR

Rotina:

Rotina

Nome Técnico

OGA040

Tipo de Reserva

OGA200Reserva
OGA410Componentes de Preço
OGA880Plano de Vendas

Cadastros Iniciais:

Relacione os cadastros necessários que precisam ser preenchidos antes da utilização desse requisito.

Parâmetro(s):

Informe os parâmetros utilizados.

Ponto de Entrada:

Informe o ponto de entrada relacionado (link).

Tickets relacionados

Informe o(s) chamado(s) relacionado(s).

Requisito/Story/Issue (informe o requisito relacionado):

DAGROGAP-5208 / DAGROGAP-7811

País(es):

Todos.

Banco(s) de Dados:

Todos.

Tabelas Utilizadas:

NJ2, N8Y, N8V, N8W, N7K, NCU

Sistema(s) Operacional(is):

Todos

Pacote:Informe o [linkdopacote]

Descrição

Este documento técnico tem por objetivo contemplar as melhorias implementadas para a gestão do planejamento de vendas agro comercial.


Importante

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:

  • Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão  11).
  • Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
  • Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
  • Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
  • O compatibilizador deve ser executado com a Integridade Referencial desativada*.


Atenção

O procedimento a seguir deve ser realizado por um profissional   qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

A ativação indevida da Integridade Referencial pode alterar   drasticamente o relacionamento entre tabelas no banco de dados. Portanto,   antes de utilizá-la, observe atentamente os procedimentos a seguir:

  1. No   Configurador (SIGACFG), veja se a empresa utiliza Integridade   Referencial, selecionando a opção Integridade/Verificação   (APCFG60A).
  2. Se não   há Integridade Referencial ativa,   são relacionadas em uma nova janela todas as empresas e filiais cadastradas   para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário   qualquer outro procedimento de ativação   ou desativação de integridade, basta finalizar a verificação e aplicar   normalmente o compatibilizador, conforme instruções.
  3.  Se há Integridade Referencial ativa   em todas as empresas e filiais, é   exibida uma mensagem na janela Verificação   de relacionamento entre tabelas. Confirme a mensagem para que a   verificação seja concluída, ou;
  4.  Se   há Integridade Referencial ativa   em uma ou mais empresas, que não   na sua totalidade, são relacionadas em uma nova janela todas as empresas e   filiais cadastradas para o sistema e, somente, a(s) que possui(em)   integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou   filial(is) possui(em) a integridade ativada e reserve esta anotação para   posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework   para informações quanto a um arquivo que contém essa informação).
  5. Nestes   casos descritos nos itens “iii” ou   “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
  6.  Quando desativada a Integridade Referencial,   execute o compatibilizador, conforme instruções.
  7. Aplicado o compatibilizador, a Integridade   Referencial deve ser reativada, SE E   SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as   informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da   integridade, selecione-a(s) novamente e confirme a ativação.


Contate o Help Desk Framework EM CASO DE DÚVIDAS!


  1. Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
  2. Clique em OK para continuar.
  3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
  4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
    1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
    2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
    3. Clique em Gravar para salvar o histórico (log) apresentado.
    4. Clique em OK para encerrar o processamento.


Descreva se há algum procedimento necessário após a aplicação do compatibilizador.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

  1. Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
  2. No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:

Nome da Variável:

Informe o Nome da Variável

Tipo:

Informe o Tipo

Descrição:

Informe a Descrição

Valor Padrão:

Informe o Valor Padrão



Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

  1. Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

Pergunte

(X1_PERGUNT)

Nome


Grupo

(X1_GRUPO)

Ordem

(X1_ORDEM)

Tipo

(X1_TIPO)

Tamanho

(X1_TAMANHO)


2.    Criação ou Alteração de tabela no arquivo SX2– Tabelas:

Chave

Nome

Modo

PYME

(X2_CHAVE)

(X2_NOME)

(X2_MODO)

(X2_PYME)


3.  Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

Chave

Ex.: AR

Descrição

Ex.: Tabela de IR de Aplicações Financeiras


4.  Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

  • Tabela BGD - Prod x Cob x Proc x Co-Part:


Campo

N8V_TIPREG

Tipo

C


Tamanho

3


Decimal

(X3_DECIMAL)

Formato

@!


Título

Tipo de Região

Descrição

Tipo de Região

Nível

(X3_NÍVEL)

Usado

Sim

Obrigatório

Sim

Browse

Sim

Opções

(X3_CBOX)

When

(X3_WHEN)

Relação

(X3_RELACAO)

Val. Sistema

ExistCpo('SX5','KF'+M->N8V_TIPREG) 

Help

Tipo de Região

Campo

N8Z_INDICE

Tipo

C

Tamanho

15

Decimal

(X3_DECIMAL)

Formato

@

Título

Índice      

Descrição

Índice de Mercado        

Nível

(X3_NÍVEL)

Usado

Sim

Obrigatório

Não

Browse

Sim

Opções

(X3_CBOX)

When

(X3_WHEN)

Relação

(X3_RELACAO)

Val. Sistema

ExistCpo("NK0") .And. OGA860VAL()

Help

Descreva o conteúdo informado para Help de Campo no ATUSX



Campo

NJ2_TIPOOP

Tipo

C


Tamanho

1


Decimal

(X3_DECIMAL)

Formato


Título

Tipo

Descrição

Tipo de uso do tipo de reserva


Nível

(X3_NÍVEL)

Usado

Sim

Obrigatório

Não

Browse

Sim

Opções

1-Contratos;2-Plano de Vendas;3-Ambos

When

(X3_WHEN)

Relação

(X3_RELACAO)

Val. Sistema

Pertence('123')

Help

Tipo de uso do tipo de Reserva

Campo

NJB_FILPVN

Tipo

C


Tamanho

2


Decimal

(X3_DECIMAL)

Formato

@!

Título

Fil.Pl.Venda

Descrição

Filial Plano de Vendas

Nível

(X3_NÍVEL)

Usado

Sim

Obrigatório

Não

Browse

Sim

Opções


When

(X3_WHEN)

Relação

(X3_RELACAO)

Val. Sistema

ExistCpo("SM0",cEmpAnt+M->NJB_FILPVN)

Consulta PadrãoSM0
Grup de Campo033

Help

Filial do Plano de Vendas

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.


5.  Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:

  • Pesquisa B05PLS:

Alias

(XB_ALIAS)

Tipo

(XB_TIPO)

Sequência

(XB_SEQ)

Coluna

(XB_COLUNA)

Descrição

(XB_DESCRI)

Contém

(XB_CONTEM)


6.  Criação ou Alteração de Índices no arquivo SIX – Índices:

Índice

xxx

Ordem

1

Chave


Descrição

Número

Proprietário

S


7.  Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

Nome da Variável

MV_AGRO028

Tipo

C - Caractere

Descrição

Posição inicial e tamanho do código da Safra dentro do campo lote, EX: '65', Lote:0000018/19 => safra 18/19.

Valor Padrão

'65'

Doc. Técnicohttp://tdn.totvs.com/x/0zm2Fg


8.  Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

  • Tabela BD5 – Contas Médicas:

Campo

Informe o conteúdo do (X7_CAMPO)

Sequência

Informe o conteúdo do (X7_SEQUENC)

Campo Domínio

Informe o conteúdo do (X7_CDOMIN)

Tipo

Informe o conteúdo do (X7_TIPO)

Regra

Informe o conteúdo do (X7_REGRA)

Posiciona?

Informe o conteúdo do (X7_SEEK)

Chave

Informe o conteúdo do (X7_CHAVE)

Condição

Informe o conteúdo do (X7_CONDIC)

Proprietário

Informe o conteúdo do (X7_PROPRI)



Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).


CONFIGURAÇÃO DE PARÂMETROS

 

  1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
    (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

Itens/Pastas

Descrição

Nome:

MV_AGRO027

Tipo:

LOGICO

Cont. Por.:

.F.

Descrição:

Define se usa o plano de vendas agro comercial

 

CONFIGURAÇÃO DE MENUS

 

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Menu


Submenu


Nome da Rotina


Programa


Módulo


Tipo


Procedimento para Utilização

1.            No Configurador (SIGACFG), acesse Ambiente/ Cadastros/ Parametros

  • Ative o parâmetro MV_AGRO027 setando seu valor para .T.


2.            No Gestão Agroindústria (SIGAAGR), acesse Atualizações / Originação / Cadastros Basicos/ Tipos de Reserva(OGA040)

O sistema apresenta a janela de Tipos de Reserva .

       1.1.            Para incluir um novo tipo de reserva, basta clicar em "Incluir".

       1.2.            Informe os dados conforme orientação do help de campo e observe o preenchimento dos campos:

    1. O campo "Tipo" define se o tipo de reserva será usado para "Contratos" ou para "Plano de Vendas" ou para "Ambos".

       1.3.            Confira os dados e confirme.

       1.4.            Para alterar um Tipos de Reserva, basta clicar em "Alterar".

       1.5.            Para excluir um Tipos de Reserva, basta clicar em "Excluir".

3.            No Gestão Agroindústria (SIGAAGR), acesse Atualizações / Originação / Cadastros Básicos/ Reserva(OGA200)

O sistema apresenta a janela de Tipos de Reserva .

       1.1.            Para incluir uma nova reserva, basta clicar em "Incluir".

       1.2.            Informe os dados conforme orientação do help de campo e observe o preenchimento dos campos:

    1. No campo "Tipo Reserva" selecione uma tipo de reserva para plano de vendas

       1.3.            Confira os dados e confirme.

       1.4.            Para alterar uma Reserva, basta clicar em "Alterar".

       1.5.            Para excluir Reserva, basta clicar em "Excluir".

       1.6.            Para reservar o registro da reserva para uso no plano de vendas, basta clicar em "Reservar".


4.            No Gestão Agroindústria (SIGAAGR), acesse Atualizações / Originação / Planejamento de Vendas / Planos de Venda

O sistema apresenta a janela de Planos de Venda.

       4.1.            Para incluir um novo plano, basta clicar em "Incluir".

       4.2.            Informe os dados conforme orientação do help de campo e observe o preenchimento dos campos:

      4.3.            Confira os dados e confirme.

       4.4.            Para alterar um Plano de Vendas, basta clicar em "Alterar".

       4.5.            Para excluir um Plano de Vendas, basta clicar em "Excluir".

       4.6             Para incluir Itens do Plano de Venda, clicar em "Itens do Plano de Venda".


5.            No Gestão Agroindústria (SIGAAGR), acesse Atualizações / Originação / Planejamento de Vendas / Planos de Venda

O sistema apresenta a janela de Planos de Venda.

    5.1. O Plano de Vendas(OGA820) possui o campo de Ativo?( N8V_ATIVO) Que indica se o plano está 1=Pendente;2=Confirmado;3=Encerrado;

    5.2. Na Lista(browse) da tela de Plano de Vendas(OGA820), em “Outras Ações” – “Confirmar”, é possível alterar o Status do plano de vendas(N8V_ATIVO) para 2=Confirmado;

    5.3. Ao confirmar, o Status(N8V_ATIVO) é alterado para 2=Confirmado;

    5.4. Se a soma dos percentuais do itens do plano de vendas por por produto, grupo, unidade de negócio e data de atualização não for 100%, o sistema não permite a confirmação do Plano de Negócio;

   5.5. Ao alterar um item do plano de vendas o sistema retorna o status para 1=Pendente;

   5.6. Na Lista(browse) da tela de Plano de Vendas(OGA820), em “Outras Ações” – “Encerrar”, é possível alterar o Status do plano de vendas(N8V_ATIVO) para 3=Encerrado;

   5.7. Uma vez 3= Encerrado, o sistema não permite alterar o Plano de venda, bem como incluir, ou alterar os seus itens e volumes disponíveis;

   5.8. Na Lista(browse) da tela de Plano de Vendas(OGA820), em “Outras Ações” – “Reabrir”, é possível alterar o Status do plano de vendas(N8V_ATIVO) para 1=Pendente, desta forma os dados do Plano de Vendas, seus Itens e volumes disponíveis podem ser alterados;

   5.9. Uma vez 2=Confirmado ou 3= Encerrado, o sistema não permite a confirmação do Plano de Vendas;

   5.10. Por meio de “Outras Ações”-“Histórico”, é possível visualizar o histórico das alterações do campo N8V_ATIVO.


6.     No Gestão Agroindústria (SIGAAGR), acesse Atualizações / Originação / Planejamento de Vendas / Planos de Venda



6.1        Acesso a Rotina

Ao abrir a rotina de plano de vendas será aberto uma tela de parâmetro para informar qual a forma da ordem de visualização da Tree de filtragem do plano de venda.

Abaixo segue um print de cada forma:  1-UN,Safra ,  2-Gr Prd, UN e 3-Safra, Un

Inclusa a opção de filtro dos status do plano , status financeiro, status de preço e status do faturamento sendo possivel escolher os não iniciados, iniciados , finalizados ou todos (qualquer status). Também é  possível filtra por Safra, unidade de negocio e Grupo e produto os registros do plano desejado.

O filtro é feito conforme selecionado, se o plano tiver o código do produto informado será agrupado pelo produto, senão será pelo grupo de produto.

6.2.       Botão Refresh

Pelo botão de refresh na parte superior do painel direito, é atualizado a tree.

Uso se faz necessário qdo se deseja mostrar todos os registros.


6.3.       Tecla F12

Opção F12 da tela, chama novamente a tela de parâmetro para permitir alterar a forma de filtragem da tree.

6.4       Clique na Tree

Conforme for clicando nos níveis da Tree, será filtrado os dados na painel esquerdo conforme o nível da tree clicado.

Ao clicar no terceiro nível da tree, apresentará a descrição do plano de venda na parte superior do painel esquerdo.

Será apresentado a Filial, safra, grupo de produto e produto, sendo que o produto só será apresentado se tiver sido informado no plano de venda.

Ao clicar no terceiro nível da tree, nas abas Programar Volumes e Gestão de preço será carregados os dados.


6.5       Aba Volume Disponível

Na aba Volume disponível poderá ser incluído, alterado, visualizado ou excluído um plano de vendas, independentemente do nível da tree selecionado.

Nesta aba é apresentado o plano de vendas(N8Y). Os dados desta listagem será filtrada conforme o nível da Tree selecionado.

Na opção de incluir, independentemente do nível da tree selecionado, as tree e as abas serão atualizadas.


6.6       Aba Programar Volumes

Na aba programar volumes, possível incluir, alterar ou excluir os itens do plano de venda, assim como as condições de recebimento para cada item do plano de venda.

Somente no nível 3 da Tree será carregado os dados conforme o plano de venda selecionado no nível 3 da tree.

Na grid de itens do plano de venda é possível incluir, alterar ou excluir um item do plano de venda.

Não poderá repetir o tipo de mercado, a moeda e Mês/Ano.

A soma do percentual dos itens do plano de venda não podem ultrapassar 100%, independentemente do tipo de mercado, moeda e Mês/Ano. É a soma do percentual das linhas.

Para cada linha dos itens do plano de venda pé possível incluir a condição de recebimento.

A soma do percentual de recebimento das linhas da condição de recebimento do item do plano de venda deve somar 100%.

Caso não seja 100% será apresentado validação.

A condição de recebimento não é obrigatório


6.7 Botão consultar Preço

No botão Consultar Preço será aberto a tela de composição de preço(OGA420).

Caso o plano de venda não tenha o produto cadastrado, mas somente o grupo de produto, a tela não será aberta e será apresentado uma mensagem ao usuário.

Caso o plano de venda tiver o produto cadastrado, a tela de composição de preço será aberta.

       Apenas serão apresentados os componentes e valores cadastrados na aba Gestão de Preço.


6.8 Botão Destribuir Saldo

O botão Distribuir Saldos, irá distribuir o saldo disponível do plano de venda, nos itens do plano de venda conforme o percentual inicial informado.

O botão cancelar irá cancelar qualquer alteração realizado nas grids que não foram salvo. É um refresh dos dados conforme estão no banco de dados.

6.9.       Botão copia


Implementar a opção copiar dos Itens do plano de vendas.





7       Aba Gestão de Preço.

Na aba de gestão de preços, poderá ser incluído, alterado ou excluído os componentes de preço para os itens do plano de vendas.

É apresentado uma grid com os itens do plano de venda(N8W).

A grid Componentes de preço dos produtos do plano de vendas é filha da Grid itens do plano de vendas, onde para cada itens do plano de venda é possível cadastrar os componentes de preço.

Para componentes do tipo Valor igual a preço global será obrigatório informar o campo Val. Fixado.

Caso não informar será apresentado mensagem de alerta na tela.

Para componentes de preço do tipo valor igual a preço especificado, o campo val. Fixado ficará desabilitado e será obrigatório informar na grid valor especifico do componentes uma data de vigência e um valor.



8 - Registro de Negocio


Ao incluir registro de negócio ou altera-lo consistir para que  o volume dos  contratos de Vendas possuam saldo a vender para a safra\grupo\produto e periodo.

Apresentar mensagem de alerta quando o volume vendido for maior que o saldo disponível planejado.





9 - Cadastro de Metas do Faturamento

Disponibilizar acompanhamento de Meta de Faturamento e preço.

Mostrar ultima versão ativa e permitir altera-la.

Permitir consultar o histórico das alteradas realizadas da meta de faturamento.


10 - Cronograma de Faturamento por Contrato

No relatório de plano de vendas quebrar por contratos e demonstrar os volumes de Vendas(SC e %) ,Preço Demonstrativo(US$/SC e R$/SC) e Preço Acertado Cliente. US$ e R$, por fazenda, contrato e período



11 - Recebimento por Vencimentos - Detalhado

No relatório de plano de vendas quebrar por contratos e demonstrar os volumes de Vendas(SC e %) ,Preço Demonstrativo(US$/SC e R$/SC) e Preço Acertado Cliente. US$ e R$, por fazenda, contrato e período





Vídeo 

Ponto de Entrada

Descrição:

Informe o Menu em que estará localizada a rotina

Localização:

Informe o Submenu em que estará localizada a rotina

Eventos:

Informe o Título da rotina

Programa Fonte:

Informe o Fonte da rotina

Função:

Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”

Retorno:

Nome

Tipo

Descrição

Obrigatório

 




 




 




 

Exemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

    aCab[4][2]:= 'NF' //Validações do usuário

EndIf

Return aCab