Fixação

xação de preço á fixar, Basis e Fixo

Características do Requisito

Linha de Produto:

Microsiga Protheus®

Segmento:

Gestão Agroindústria

Módulo:

SIGAAGR.

Rotina:

Rotina	Nome Técnico
OGA280	Contrato de compra.
OGA290	Contrato de vendas

Rotina(s) envolvida(s)	Nome Técnico
Informe a(s) rotina(s) envolvidas.	Informe o nome técnico da(s) rotina(s) envolvidas.

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).

OGA410	Componentes de Preço
OGA430F	Fixação de preço
OGA420	Composição de Preço

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

DAGROGAP-1444/DAGROGAP-1445/DAGROGAP-1446

País(es):

Argentina, Paraguai

Banco(s) de Dados:

Todos

Tabelas Utilizadas:

NJR, NN8, NK7

Sistema(s) Operacional(is):

Windows® / Linux®

Descrição

Este projeto tem por objetivo registrar e manter os históricos dos tipo de fixação de preço, á fixar, Basis e Fixo, para que o mesmo seja utilizado como base no processo seguinte.

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:

No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação (APCFG60A).
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.
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;
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).
Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.
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!

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 ___/___/____.
Clique em OK para continuar.
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().
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.

Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
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

4. Criação e Alteração de Campos no arquivo SX3 – Campos:

Campo	NN8_TIPO
Tipo	C
Tamanho	1
Decimal	0
Formato	@!
Título	Tipo Ctr.
Descrição	Tipo do Contrato
Nível	0
Usado	(X3_USADO) Informe Sim ou Não
Obrigatório	(X3_OBRIGAT) Informe Sim ou Não
Browse	Sim
Opções	1=Compra;2=Venda;3=Armazenagem De 3;4=Armazenagem Em 3
When	(X3_WHEN)
Relação	POSICIONE('NJR',1,XFILIAL('NJR')+NN8->NN8_CODCTR,'NJR_TIPO')
Val. Sistema	(X3_VALID)

Campo	NN8_CODENT
Tipo	C
Tamanho	6
Decimal	0
Formato	@!
Título	Cod.Entidade
Descrição	Codigo da Entidade
Nível	0
Usado	(X3_USADO) Informe Sim ou Não
Obrigatório	(X3_OBRIGAT) Informe Sim ou Não
Browse	Sim
Opções
When	(X3_WHEN)
Relação	POSICIONE('NJR',1,XFILIAL('NJR')+NN8->NN8_CODCTR,'NJR_CODENT')
Val. Sistema	(X3_VALID)

Campo	NN8_LOJENT
Tipo	C
Tamanho	2
Decimal	0
Formato	@!
Título	Loj.Entidade
Descrição	Loja da Entidade
Nível	0
Usado	(X3_USADO) Informe Sim ou Não
Obrigatório	(X3_OBRIGAT) Informe Sim ou Não
Browse	Sim
Opções
When	(X3_WHEN)
Relação	POSICIONE('NJR',1,XFILIAL('NJR')+NN8->NN8_CODCTR,'NJR_LOJENT')
Val. Sistema	(X3_VALID)

Campo	NN8_NOMENT
Tipo	C
Tamanho	40
Decimal	0
Formato	@!
Título	Nom.Entidade
Descrição	Nome da Entidade
Nível	0
Usado	(X3_USADO) Informe Sim ou Não
Obrigatório	(X3_OBRIGAT) Informe Sim ou Não
Browse	Sim
Opções
When	(X3_WHEN)
Relação	POSICIONE('NJ0',1,XFILIAL('NJ0')+M->(NN8_CODENT+NN8_LOJENT),'NJ0_NOME')
Val. Sistema	(X3_VALID)

Campo	NN8_NLJENT
Tipo	C
Tamanho	20
Decimal	0
Formato	@!
Título	Nom.Loj.Ent
Descrição	Nome da Loja da Entidade
Nível	0
Usado	(X3_USADO) Informe Sim ou Não
Obrigatório	(X3_OBRIGAT) Informe Sim ou Não
Browse	Sim
Opções
When	(X3_WHEN)
Relação	POSICIONE('NJ0',1,XFILIAL('NJ0')+M->(NN8_CODENT+NN8_LOJENT),'NJ0_NOMLOJ')
Val. Sistema	(X3_VALID)

Campo	NN8_CODPRO
Tipo	C
Tamanho	20
Decimal	0
Formato	@!
Título	Cod. Produto
Descrição	Codigo do Produto
Nível	0

Atualizações do Compatibilizador

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

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

B04

(X2_CHAVE)

Dente/Região

(X2_NOME)

C

(X2_MODO)

N

(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	(X3_CAMPO)
Tipo	(X3_TIPO)
Tamanho	(X3_TAMANHO)
Decimal	(X3_DECIMAL)
Formato	(X3_PICTURE)
Título	(X3_TITULO)
Descrição	(X3_DESCRIC)
Nível	(X3_NÍVEL)
Usado	(X3_USADO) Informe Sim ou Não
Obrigatório	(X3_OBRIGAT) Informe Sim ou Não
Browse	(X3_BROWSE) Informe Sim ou Não
Opções	(X3_CBOX)
When	(X3_WHEN)
Relação	(X3_RELACAOPOSICIONE('NJR',1,XFILIAL('NJR')+NN8->NN8_CODCTR,'NJR_CODPRO')
Val. Sistema	(X3_VALID)
Grupo
Help	Descreva o conteúdo informado para Help de Campo no ATUSX

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	AA1
Ordem	6
Chave	AA1_FILIAL+AA1_CODVEN
Descrição	Cod. Vendedor
Proprietário	S

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

Nome da Variável	(X6_VAR)
Tipo	(X6_TIPO)
Descrição	(X6_DESCRIC + X6_DESC1 + X6_DESC2)
Valor Padrão	(X6_CONTEUD)

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

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:
Tipo:	Informe o Tipo do parâmetro
Cont. Por.:	Informe o Conteúdo padrão
Descrição:

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	Informe o Menu em que estará localizada a rotina
Submenu	Informe o Submenu em que estará localizada a rotina
Nome da Rotina	Informe o Título da rotina
Programa	Informe o Fonte da rotina
Módulo	Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”
Tipo	Informe a Função

Procedimento para Utilização

Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
Localização da rotina no menu;
Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
Caso seja necessário ter algum cadastro feito previamente, faça uma observação.

Exemplo:

1. Nos contratos de compra(OGA280) e contratos de venda(OGA290), quando no pais Paraguai ou Argentina, não é mais obrigatório informar o campo Vlr.Unit.(Valor Unitário).

Vídeo

Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** 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.

030

Campo	NN8_CODSAF
Tipo	C
Tamanho	15
Decimal	0
Formato	@!
Título	Cod. Safra
Descrição	Codigo da Safra
Nível	0
Usado	(X3_USADO) Informe Sim ou Não
Obrigatório	(X3_OBRIGAT) Informe Sim ou Não
Browse	Sim
Opções
When	(X3_WHEN)
Relação	POSICIONE('NJR',1,XFILIAL('NJR')+NN8->NN8_CODCTR,'NJR_CODSAF')
Val. Sistema	(X3_VALID)

Campo	NN8_UMPRC
Tipo	C
Tamanho	2
Decimal	0
Formato	@!
Título	UM. Preco
Descrição	Unidade de Medida de Preço
Nível	0
Usado	(X3_USADO) Informe Sim ou Não
Obrigatório	(X3_OBRIGAT) Informe Sim ou Não
Browse	Sim
Opções
When	(X3_WHEN)
Relação	POSICIONE('NJR',1,XFILIAL('NJR')+NN8->NN8_CODCTR,'NJR_UMPRC')
Val. Sistema	(X3_VALID)

Campo	NN8_DTREF
Tipo	D
Tamanho	8
Decimal	0
Formato	@!
Título	DT.REF.FIX
Descrição	Dt Referencia Fixação
Nível	0
Usado	(X3_USADO) Informe Sim ou Não
Obrigatório	(X3_OBRIGAT) Informe Sim ou Não
Browse	Sim
Opções
When	(X3_WHEN)
Relação
Val. Sistema	(X3_VALID)

Campo	NN8_ITORIG
Tipo	C
Tamanho	3
Decimal	0
Formato	@!
Título	FixaçãoOrig
Descrição	Fixação Origem
Nível	0
Usado	(X3_USADO) Informe Sim ou Não
Obrigatório	(X3_OBRIGAT) Informe Sim ou Não
Browse	Sim
Opções
When	(X3_WHEN)
Relação
Val. Sistema	(X3_VALID)

Campo	NN8_TIPOFX
Tipo	C
Tamanho	1
Decimal	0
Formato	@!
Título	Tipo Fix.
Descrição	Tipo da Fixacao
Nível	0
Usado	(X3_USADO) Informe Sim ou Não
Obrigatório	(X3_OBRIGAT) Informe Sim ou Não
Browse	Sim
Opções	0=Prevista;1=Firme;2=Basis
When	(X3_WHEN)
Relação	'1'
Val. Sistema	Pertence('012')

Campo	NJR_DTREF
Tipo	D
Tamanho	8
Decimal	0
Formato	@!
Título	DT.REF.FIX
Descrição	Dt Referencia Fixação
Nível	0
Usado	(X3_USADO) Informe Sim ou Não
Obrigatório	(X3_OBRIGAT) Informe Sim ou Não
Browse	Sim
Opções
When	(X3_WHEN)
Relação
Val. Sistema
Folder	4

Campo	NJR_TIPFIX
Tipo	C
Tamanho	1
Decimal	0
Formato	@!
Título	Tipo Fix.
Descrição	Tipo de Fixacao
Nível	0
Usado	(X3_USADO) Informe Sim ou Não
Obrigatório	(X3_OBRIGAT) Informe Sim ou Não
Browse	Sim
Opções	1=Fixo;2=A Fixar;3=Basis
When	(X3_WHEN)
Relação	'1'
Val. Sistema	Pertence('123')
Folder	4

Campo	NK7_GRUPO
Tipo	C
Tamanho	1
Decimal	0
Formato	@!
Título	Grupo
Descrição	Grupo
Nível	1
Usado	(X3_USADO) Informe Sim ou Não
Obrigatório	(X3_OBRIGAT) Informe Sim ou Não
Browse	Sim
Opções	1=Basis;2=Fixo
When	(X3_WHEN)
Relação	'1'
Val. Sistema	Pertence("1,2")

Procedimento para Utilização

Após aplicar o compatibilizador, no cadastro de componentes de preço(OGA410) será possível definir se o componente e do tipo 1-Basis ou 2-Fixo através do campo "GRUPO".

Na rotina de contrato de compra(OGA280) ou venda(OGA290) foi adicionado no campo "TIPO FIXAÇÂO" na aba financeiro a opção Basis.

Na rotina de fixação de preço(OGA430F) é possível realizar o ROLLVER da fixação. Para fixação do tipo "A fixar" não será apresentado componentes de preço. Para fixação do tipo Basis será apresentado apenas componentes do tipo Basis. Para fixação do tipo "Firme" será apresentado todos os componentes. Fixação do tipo Basis que foi realizado o ROLLOVER para Firme, os componentes de preço do tipo Basis não poderão ser alterados.

Componentes de Preço (OGA410)

Ao cadastrar componentes de preço adicionado campo "GRUPO" permitindo definir qual o tipo do componente(1-Basis; 2-Fixo)

Image Added

Contrato de compra/Contrato de venda

No cadastro de contrato de compra ou contrato de venda, na aba Financeiro adicionado no campo "Tipo de Fixação" a opção "Basis".

Image Added

Os componentes de preço seram mostrado conforme a fixação do contrato.

Para contrato com tipo de fixação "1-Fixo" será mostrado todos os componentes de preço

Image Added

Para contrato com tipo de fixação "2-A Fixar" não será mostrado componentes de preço.

Image Added

Para contrato com tipo de fixação "3-Basis" será mostrado os componentes de preço do tipo Basis.

Image Added

Gestor de Entidade(OGA450)->Financeiro(OGA430)

Na fixação do contrato será possivel realizar o ROLLOVER parcial ou total através do botão INCLUIR.

Image Added

Os componentes de preço da fixação do contrato será mostrados conforme o tipo da fixação.

Fixação do tipo "0-Prevista" não terá componentes de preço.

Image Added

Fixação do tipo "1-Firme" mostrará todos os componentes. Se realizado rollover de uma fixação do tipo "2-Basis" para "1-Firme", os componentes do tipo "Basis" não poderão ter seus valores alterados.

Image Added

Fixação do tipo "2-Basis" mostrará somente os componentes de preço do tipo "Basis"

Image Added

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

Árvore de páginas

Versões comparadas

Versão antiga 3

Nova versão Atual

Chave

xação de preço á fixar, Basis e Fixo

Características do Requisito

Descrição

Importante

Procedimento para Implantação

Atualizações do Compatibilizador

Atualizações do Compatibilizador

Procedimento para Configuração

Procedimento para Utilização

Vídeo

Procedimento para Utilização

Ponto de Entrada

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 3

Nova versão Atual

Chave

xação de preço á fixar, Basis e Fixo

Características do Requisito

Descrição

Importante

Procedimento para Implantação

Atualizações do Compatibilizador

Atualizações do Compatibilizador

Procedimento para Configuração

Procedimento para Utilização

Vídeo

Procedimento para Utilização

Ponto de Entrada