ELABORAR

LABORAR PROGRAMAÇÃO DE ENTREGA

Características do Requisito

Linha de Produto:

Microsiga Protheus

Segmento:

Agroindustria

Módulo:

SIGAGR

Rotina:

Rotina	Nome Técnico
AGRA970	Políticas de Programação de Entrega
AGRA950	Regra da Programação de Entrega
AGRA860	Programação de Entrega

Requisito (ISSUE):

AGROG01-500

País(es):

Brasil

Banco(s) de Dados:

Todos

Tabelas Utilizadas:

NJ3, NJ4,NJ5

Sistema(s) Operacional(is):

Windows®/Linux®

Descrição

Realizar a programação de Entrega conforme regras e politicas adotadas pela empresa.

Importante

Cadastrar as Politicas sendo que a criação do parâmetro não exerce qualquer influência sobre a validação do agendamento até que este seja empregado em uma regra de negócio.

Cadastrar as Regras podendo haver varias regras com o mesmo parâmetro que serão executadas conforme sequencia de validação indicada no atributo Ordem. Na Instrução informar formula na forma de texto que pode ser convertida em um codeblock do Protheus.

Um codeblock pode aceitar a passagem de parâmetros para funções, sendo que esses parâmetros serão determinados por um conjunto pré-determinado de variáveis. As variáveis são nomes de campos que estão delimitadas por [] (colchetes) e que durante a execução da regra serão substituídas por valores reconhecidos no programa.

Na programação de Entrega serão listadas todas as Liberações de pedidos que estiverem pendentes de agendamento e os registros de agendamento estiverem com data de agendamento em branco ou com a situação reprovado (R).

No momento da confirmação do agendamento o programa deverá executar as regras de validação para cada linha que foi atualizado o campo de data.

Quando o resultado da regra aplicada for falso (.F.), então será gravado na tabela NK9 (histórico) um LOG indicando a ocorrência. A chave do log deverá ser composta pela chave da tabela NJ5 juntamente com o identificador "VALIDACAO" e o código da regra que está sendo executada. A mensagem do log deverá ser formada com as seguintes informações:

Todas as regras ativas deverão ser executadas. Ao final do processo, caso uma ou mais regras tenha retornado valor falso (.f.), então o agendamento do item específico será gravado, contudo a situação será registrada como Reprovado (R). Para os demais itens, cujo retorno da regra tenha sido verdadeiro (.T.) terão o campo situação alterado para Aprovado (A). As informações da tabela NJ5 somene serão gravadas na SC9 quando houver a aprovação automática ou através da aprovação manual.

Para validação da programação de entrega, clicar sobre o botão “Executar” e este irá processar as regras cadastradas e caso alguma regra retornar o valor .f. o programa irá gravar o log da regra que pode ser consultado na tabela NK9 através da opção Histórico.

Procedimento para Implantação

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

Aplique o patch do chamado e execute uma vez a rotina Programação de Entrega.
No módulo UBS acesse atualizaçoes>expedição e verifique se as rotinas citadas acima foram criadas conforme especificado.

Atualizações do Compatibilizador

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

Tabela NJ3 - Regra Programação de Entrega

Índice	Chave
01	NJ3_FILIAL+NJ3_CODIGO
02	NJ3_FILIAL+STR(NJ3_SEQ)

Campo	CODIGO
Tipo	C
Tamanho	5
Valor Inicial	SEQUENCIAL
Mandatório	Sim (X ) Não ( )
Descrição	Regra
Título	Regra
Picture	@!
Help de Campo	Informar o código identificador da regra

Campo	DESCRICAO
Tipo	C
Tamanho	100
Mandatório	Sim (X ) Não ( )
Descrição	Descrição da Regra
Título	Descrição
Picture	@!
Help de Campo	Informar texto descritivo para a regra

Campo	SIT
Tipo	C
Tamanho	1
Valor Inicial	1-Sim
Mandatório	Sim (X ) Não ( )
Descrição	Ativo (1-SIm, 2-Não)
Título	Ativo
Picture	@!
Help de Campo	Informar se a regra encontra-se ativa

Campo	SEQ
Tipo	N
Tamanho	3
Mandatório	Sim (X ) Não ()
Descrição	Ordem
Título	Ordem
Picture	999
Help de Campo	Ordem da sequencia de execução da regra.

Campo	INSTR
Tipo	C
Tamanho	254
Mandatório	Sim (x) Não ( )
Descrição	Instrução
Título	Instrução
Picture	@!
Help de Campo	Instrução na forma de codeblock que seráexecutado para validar a regra. A instrução deve retornar um valor .T. ou .F. Se retornar NIL será considerado como .F.

Campo	MSG
Tipo	C
Tamanho	254
Mandatório	Sim (X ) Não ( )
Descrição	Mensagem
Título	Mensagem
Picture	@!
Help de Campo	Texto que será gravado no Log da regra para identificar o problema.

Tabela NJ4 - Politica Programação de Entrega

Índice	Chave
01	NJ4_FILIAL+NJ4_CODIGO

Campo	CODIGO
Tipo	C
Tamanho	5
Valor Inicial	SEQUENCIAL
Mandatório	Sim (X ) Não ( )
Descrição	Política
Título	Política
Picture	@!
Help de Campo	Informar o código identificador da Politica

Campo	CHAVE
Tipo	C
Tamanho	50
Mandatório	Sim (X ) Não ( )
Descrição	Parâmetro
Título	Parâmetro
Picture	@!
Help Campo	Identificador da Politica. Fazem referencia a Politica podendo haver varias com mesmo Parâmetro. Exemplo: PERCENTUAL_CARGA_FRETE

Campo	DESCRICAO
Tipo	C
Tamanho	100
Mandatório	Sim (X ) Não ( )
Descrição	Descrição da política
Título	Descrição
Picture	@!
Help de Campo	Descrição da Politica de negocio da programação de entrega

Campo	SIT
Tipo	C
Tamanho	1
Valor Inicial	1-Sim
Mandatório	Sim (X ) Não ( )
Descrição	Ativo (1-SIm, 2-Não)
Título	Ativo
Picture	@!
Help de Campo	Informar se a regra encontra-se ativa

Campo	VALOR
Tipo	C
Tamanho	254
Mandatório	Sim (X ) Não ()
Descrição	Valor
Título	Valor
Picture	@!
Help de Campo	Valor estipulado para atender a Politica

Campo	DTINI
Tipo	D
Tamanho	8
Mandatório	Sim ( ) Não (X)
Descrição	Data Inicio da Vigência
Título	Data Inicio
Help de Campo	Período inicial para vigência da politica. Caso não seja informado ficará compreendido todo o período sem restrição.

Campo	DTFIM
Tipo	D
Tamanho	8
Mandatório	Sim ( ) Não (X)
Descrição	Data Final de vigência
Título	Data Fim
Help de Campo	Período final para vigência da politica. Caso não seja informado ficará compreendido todo o período sem restrição.

Tabela NJ5 - Programação de Entrega

Índice	Chave
01	NJ5_FILIAL+NJ5_NUMPV+NJ5_ITEM+NJ5_SEQUEN+NJ5_PRODUT

Campo	CODCAR
Tipo	C
Tamanho	6
Visual	Visualizar
Mandatório	Sim () Não (x)
Descrição	Código Carregamento
Título	Carregamento
Picture	@!
Help de Campo	Código do carregamento

Campo	NUMPV
Tipo	C
Tamanho	6
Visual	Visualizar
Mandatório	Sim (x) Não ( )
Descrição	Número Pedido de Venda
Título	Num. Ped Venda
Picture	@!
Help de Campo	Número do Pedido Venda

Campo	ITEM
Tipo	C
Tamanho	2
Visual	Visualizar
Mandatório	Sim (x) Não ( )
Descrição	Item
Título	Item
Picture	@!
Help de Campo	Item do pedido de vendas.

Campo	SEQUEN
Tipo	C
Tamanho	2
Visual	Visualizar
Mandatório	Sim (x) Não ( )
Descrição	Seq
Título	Sequência
Picture	@!
Help de Campo	Sequência do Item do pedido de vendas.

Campo	PRODUT
Tipo	C
Tamanho	15
Visual	Visualizar
Mandatório	Sim (x) Não ( )
Descrição	Produto
Título	Produto do Pedido de Vendas
Picture	@!
Help de Campo	Produto do Pedido de Vendas

Campo	DESCR
Tipo	C
Tamanho	30
Visual	Visualizar
Mandatório	Sim () Não (X )
Descrição	Descrição do Produto
Título	Descrição
Picture	@!
Help de Campo	Descrição do Produto do Pedido de Vendas
Valor Inicial	IF(!INCLUI,POSICIONE('SB1',1,XFILIAL('SB1')+NJ5->NJ5_PRODUT,'B1_DESC'),' ')

Campo	QTDE
Tipo	N
Tamanho	9
Visual	Visualizar
Mandatório	Sim () Não (X )
Descrição	Quantidade do Produto
Título	Quantidade
Picture	@E 999,999.99
Help de Campo	Quantidade do Produto do Pedido de Vendas

Campo	UM
Tipo	C
Tamanho	2
Visual	Visualizar
Mandatório	Sim () Não (X )
Descrição	Unidade de Medida
Título	Un.Medida
Picture	@!
Help de Campo	Unidade de Medida do Produto do Pedido de Vendas

Campo	QTDUM2
Tipo	N
Tamanho	9
Visual	Visualizar
Mandatório	Sim () Não (X )
Descrição
Título	Qtd. 2ª. UM
Picture	@E 999,999.99
Help de Campo	Quantidade do Produto do Pedido de Vendas

Campo	UM2
Tipo	C
Tamanho	2
Visual	Visualizar
Mandatório	Sim () Não (X )
Descrição	Unidade de Medida
Título	Un.Medida
Picture	@!
Help de Campo	Unidade de Medida do Produto do Pedido de Vendas

Campo	QTDUM2
Tipo	C
Tamanho	2
Visual	Visualizar
Mandatório	Sim () Não (X )
Descrição	Unidade de Medida
Título	Un.Medida
Picture	@!
Help de Campo	Unidade de Medida do Produto do Pedido

Procedimento para Configuração

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

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

Definir e cadastrar Politicas de Entrega
Definir as regras para cada Politica
Realizar a Programação de entrega informando a data prevista de AGENDAMENTO

Campo	LOCAL
Tipo	C
Tamanho	12
Visual	Visualizar
Mandatório	Sim () Não (X )
Descrição

ELABORAR PROGRAMAÇÃO DE ENTREGA