Planejamento de Vendas
Linha de Produto: | Microsiga Protheus. | ||||||||||||||||||
Segmento: | Gestão Agroindústria. | ||||||||||||||||||
Módulo: | SIGAAGR | ||||||||||||||||||
Rotina: |
| ||||||||||||||||||
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 | ||||||||||||||||||
País(es): | Todos. | ||||||||||||||||||
Banco(s) de Dados: | Todos. | ||||||||||||||||||
Tabelas Utilizadas: | NJ2, N8Y, N8V, N8W, N7K | ||||||||||||||||||
Sistema(s) Operacional(is): | Todos | ||||||||||||||||||
Pacote: | Informe o [linkdopacote] |
Este documento técnico tem por objetivo contemplar as melhorias implementadas para a gestão do planejamento de vendas agro comercial.
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:
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:
Contate o Help Desk Framework EM CASO DE DÚVIDAS! |
---|
Descreva se há algum procedimento necessário após a aplicação do compatibilizador.
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.
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 |
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
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:
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ão | SM0 |
Grup de Campo | 033 |
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:
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écnico | http://tdn.totvs.com/x/0zm2Fg |
Nome da Variável | MV_AGRO035 |
Tipo | L - Lógico |
Descrição | Serve para indicar que na atualização do plano de vendas, para os produtos resultantes de produção e que possuem conjunto, a quantidade prevista e a produzir deverá ser buscada com base no produto base (ex. algodão em caroço). |
Valor Padrão | .F. |
Doc. Técnico | http://tdn.totvs.com/x/agdEG |
8. Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:
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) |
(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou rotinas no menu).
CONFIGURAÇÃO DE PARÂMETROS
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 |
1. No Configurador (SIGACFG), acesse Ambiente/ Cadastros/ Parametros
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.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.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
O sistema apresenta a janela de Planos de Venda.
6.1. Ao inserir um Item do Plano de Vendas por meio de "Outras Ações" - "Itens do plano de Vendas", se não existir nenhum Volume Disponível para o Plano de Vendas, o sistema insere um registro com os volumes vazios.
6.2. Ao importar um Item do Plano de Vendas por meio de "Outras Ações" - "Importar" - "Itens do plano de Vendas", se não existir nenhum Volume Disponível para o Plano de Vendas, o sistema insere um registro com os volumes vazios.
7. OGA410 - Componentes de Preço
No cadastro de Componentes de Preço foi incluído um campo chamado Plano Vendas, cujas opções são: 1 – Não utilizado, 2 – Utilizado, 3 – Exclusivo. Este campo somente deve estar habilitado quando o componente é aplicado a Vendas ou Ambos.
8. OGA490 - Cadastro de Fórmula para Cálculo de Componentes
É possível cadastrar componentes que sejam do tipo de cálculo Resultado e Tributo (desde que este último tenha uso Exclusivo para o Planejamento de Vendas).
9. Importação dos Itens do Plano de Vendas
Os itens do plano de vendas podem ser importados por meio de "Outras Ações" - "Importar" - "Itens do Plano de Vendas";
O leiaute do arquivo com extensão .CSV deve seguir o exemplo abaixo:
Filial do Plano de Vendas (N8W_FILPLA) Máximo 8 caracteres | Cód. do Grupo de Produtos (N8W_GRPROD) Máximo 4 caracteres | Cód. do Produto (N8W_CODPRO) Máximo 15 caracteres | Tipo de Mercado (N8W_TIPMER) Máximo 1 Caractere | Código da Moeda (N8W_MOEDA) Máximo 1 caractere | Data Inicial (N8W_DTINIC) Máximo 8 caracteres | Percentual de Venda (N8W_PERVEN) Máximo 3 caracteres |
---|---|---|---|---|---|---|
D MG 01 | 0001 | 000000000000001 | 1 | 1 | 20180701 | 30 |
D MG 01 | 0002 | 000000000000002 | 1 | 1 | 20180701 | 20 |
|
10. Importação dos Itens de Condição de Recebimento do Plano de Vendas
Os itens de condição de recebimento do plano de vendas podem ser importados por meio de "Outras Ações" - "Importar" - "Condições de Recebimento";
O leiaute do arquivo com extensão .CSV deve seguir o exemplo abaixo:
Cód. do Grupo de Produtos (NCU_GRPROD) Máximo 4 caracteres | Cód. do Produto (NCU_CODPRO) Máximo 15 caracteres | Tipo de Mercado (NCU_MESANO) Máximo 1 Caractere | Código da Moeda (N8W_MOEDA) Máximo 1 caractere | Percentual de Recebimento (N8X_PERREC) Máximo 3 caracteres | Quantidade de Períodos (N8X_QTPRRE) Máximo 10 caracteres |
---|---|---|---|---|---|
0001 | 000000000000001 | 01/04/19 | 1 | 100 | 9 |
0002 | 000000000000002 | 01/05/19 | 1 | 100 | 10 |
|
11. Atualizar Plano de Vendas
Os dados do Plano vendas podem ser atualizados por meio de "Outras Ações" - "Atualizar Plano".
Os dados de volumes disponíveis serão atualizados conforme dados de reservas e saldos do produto informado nos registros de volumes disponíveis do plano de vendas.
O parâmetro MV_AGRO028 é do tipo Carácter e está localizado na rotina OGA840 , essa rotina é utilizada para Atualizar os Volumes Disponíveis do Plano de Vendas. Nesse contexto esse Parâmetro contém a posição inicial e o tamanho da informação de Safra dentro do Lote do Produto, Ex: se o conteúdo do parâmetro for 65, significa que a safra estará informada a partir do caractere 6 e tem tamanho 5, por exemplo: Lote:0000018/19 então Safra: 18/19 O Parâmetro deve ser configurado em SIGACFG – Ambiente – Cadastros – Parâmetros. 1 - B1_RASTRO = S-SubLote ou L-Lote e MV_RASTRO = ‘S’ Quando o produto usa controle por lote (B1_RASTRO = S-SubLote ou L-Lote e MV_RASTRO = ‘S’), o sistema busca os dados da tabela SB8 – Saldos por lote; Quando informado o produto, o sistema atualiza o campo N8Y_QTESTO somando os registros da SB8 que tem a safra do plano contida no lote. Quando informado somente o grupo de produtos, o sistema busca todos os produtos do grupo e soma os registros da SB8 relacionados ao produto que tem a safra do plano contida no lote. 2 - B1_RASTRO = N-Não Utiliza e MV_RASTRO = ‘N’ Quando o produto não é controlado por lote (B1_RASTRO = N-Não Utiliza e MV_RASTRO = ‘N’), o sistema busca os dados da tabela SB2 – Saldos Físico e Financeiro. Quando informado o produto, o sistema atualiza o campo N8Y_QTESTO somando os registros da SB2 quem sejam relacionados ao produto. Quando informado somente o grupo de produtos, o sistema busca todos os produtos do grupo e soma os registros da SB2 relacionados ao produto. Quando o produto não é controlado por lote, o sistema verifica a data inicial do plano e se for meio que a data atual não atualiza o campo N8Y_QTESTO. |
11.1. Produtos que fazem parte de conjuntos
Quando o conteúdo do parâmetro MV_AGRO035 for .T. e o produto informado no Volume Disponível(OGA840) pertencer a um conjunto(AGRA611), o sistema busca a quantidade produzida e a quantidade a produzir nas Ordens de Produção (MATA650) conforme os percentuais configurados no conjunto.
Se o produto pertence a um conjunto(AGRA611) significa que este é extraído de um produto matéria prima, desta forma o sistema busca a quantidade das ordens de produção desta matéria prima para descobrir quanto está previsto a ser produzido do produto com base no percentual(DXC_PERC) informado no conjunto.
Quando o tipo do percentual do produto(DXC_TIPO) for 3 – Realizado o percentual de rendimento com base no produto original se obtém do campo % Rd. Med. Informado na 3ª pasta do cadastro de conjuntos.
Quando o tipo do percentual do produto(DXC_TIPO) for 1 – Fixo o percentual de rendimento com base no produto original se obtém do campo Percentual. Informado na 2ª pasta(% de Separação e Produção) do cadastro de conjuntos.
Quando o tipo do percentual do produto(DXC_TIPO) for 2 – Variável o percentual de rendimento com base no produto original se obtém do campo Percentual. Informado na 2ª pasta(% de Separação e Produção) do cadastro de conjuntos, porém deve somar os percentuais fixos(DXC_PERC) com o % Rd. Med.( DXE_RDMED) e aplicar o percentual sobre esta sobra, por exemplo:
Produto | Tipo % | Percentual |
Alg. Pluma p/ benef. | Realizado | 0% |
Fibrilha | fixo | 1% |
Caroço de algodão | fixo | 50% |
Cascas | variável | 50% |
Resíduos de Alg. | variável | 50% |
Se o % Rd. Med. fosse 42% + Fixos 51% - total 100% = 7%
Cascas 50 % de 7%(sobra) = 3,5% do total
Desta forma se o produto informado fosse por exemplo Cascas a quantidade de Alg. Pluma p/ benef. renderia 3,5% de Cascas.
12. Componentes de preço dos produtos do plano de vendas
No Plano de Vendas(OGA820), em “Outras Ações” - "Comp. Preço Plano", é possível dar manutenção nos componentes de preço dos produtos do plano de vendas;
Na Grid "Itens do Plano de Vendas"(esquerda), são exibidos os itens do plano de vendas agrupados pode Grupo de Produto, Produto e Mercado;
A legenda desta Grid pode ser visualizada ao dar dois click sobre o farol e representa as configuração do componente cadastrado:
No Browse “Componentes de Preços dos Produtos do Plano de Vendas” podem ser cadastrados os componentes para cada grupo de produto, produto e mercado;
Não é permitido informar um Componente(N8Z_CODCOM) que não possua a mesma moeda do Plano de Vendas;
Não é permitido informar um Componente(N8Z_CODCOM) que não esteja configurado com o campo “Plano de Vendas” igual a 2-Utilizado ou 3-Exclusivo;
Não é permitido informar um Componente(N8Z_CODCOM) que não esteja configurado com o produto diferente do item do plano de vendas;
Na rotina de “Componentes de Preço”(OGA410) ao cadastrar o componente, podem ser vinculados os Produtos x Componentes de Preço.
Ao informar um índice(N8Z_INDICE), o sistema busca a unidade de medida e moeda por índice, produto e grupo de produto, se não encontrar pelos três, busca por produto e grupo de produto, se não encontrar busca por produto, e se ainda assim não encontrar busca no cadastro do índice de mercado informado(OGA080).
Os componentes podem ser ordenados por meio dos botões de seta azul contidos na grid “Componentes de Preços dos Produtos do Plano de Vendas”, deve-se dar dois clicks para mover para cima ou para baixo a ordem do componente.
Na Ação Relacionada "Copiar" será possível efetuar cópia de todos os componentes de um grupo/produto/mercado para outro grupo/produto/mercado.
13 - Painel de Acompanhamento do Plano de Vendas
No programa de cadastro do Plano de Vendas(OGA820), em “Outras Ações”, foi adicionada a opção “Painel de Acompanhamento”;
Ao clicar na opção, se o status do plano de vendas posicionado estiver igual a 2-Confirmado ou 3-Encerrado, é aberta a tela de parâmetros de acesso a nova rotina que será implementada nas próximas issues:
As opções de agrupamento que podem ser selecionadas por meio do pergunte são:
4-Gr. Prod. 1: Grupo Produto, Mercado, Und. Negócio, Moeda.
1-Merc. 1: Mercado, Grupo Produto, Und. Negócio, Moeda.
O sistema Busca os itens do plano de vendas posicionado e carrega a tree de filtragem conforme a ordenação escolhida no pergunte, os itens da mesma data de atualização do plano são selecionados e agrupados para se obter uma visualização macro:
Em "Outras Ações"-"Alterar Item do Plano de Vendas", é possível editar a quantidade prevista de venda e o percentual de venda, ao alterar algum dos campos, o sistema já calcula o ou outro bem como os totalizadores com base no volume disponível;
O sistema valida se o Total % Prev. Venda não está diferente de 100% e se a Soma da Qtd Prev Venda não é maior que o Volume Disponível;
Ao confirmar as alterações, o sistema atualiza o plano de vendas e os dados exibidos no painel de acompanhamento.
** Canal do youtube e software de vídeoem definição.
Título do Vídeo: | Disponibilizado pelo Marketing. |
Introdução: | Disponibilizado pelo Marketing. |
Passo a Passo: | Capturar diretamente do sistema. |
Finalização: | Disponibilizado pelo Marketing. |
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: |
|
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