Histórico da Página
Elaborar Programação de Entrega
Características do Requisito
Linha de Produto: | Microsiga Protheus | ||||||||
Segmento: | AgroindustriaAgroindústria | ||||||||
Módulo: | SIGAGRSIGAAGR | ||||||||
Rotina: |
| ||||||||
| Requisito (ISSUE): | AGROG01-500 | ||||||||
País(es): | BrasilTodos | ||||||||
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 as regras e politicas políticas adotadas pela empresa.
Importante
Cadastrar as Politicas Políticas, 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 , podem haver varias várias regras com o mesmo parâmetro, que serão executadas conforme sequencia sequência de validação indicada no atributo Ordem. Na Instrução, informar formula fórmula 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)Programação de Entrega será exibida uma lista com informações sobre a situação do pedido, da liberação e/ou da carga montada.
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 (.fF.), então o agendamento do item específico será gravado, contudo a situação será registrada como Reprovado (R)Agd. Aprovação. Para os demais itens, cujo retorno da regra tenha sido verdadeiro (.T.), terão o campo situação "Situação" alterado para Aprovado (A). As informações da tabela NJ5 somene somente serão gravadas na SC9 quando houver a aprovação automática, ou através por meio da aprovação manual.
Para validação da programação de entrega, clicar sobre o botão “Executar” e este ele irá processar as regras cadastradas, e caso alguma regra retornar o valor .fF., o programa irá gravar o log da regra, que pode ser consultado na tabela NK9 através por meio 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 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 Atualizações > 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 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 regra. |
Campo | SIT |
Tipo | C |
Tamanho | 1 |
Valor Inicial | 1-Sim |
Mandatório | Sim (X ) Não ( ) |
Descrição | Ativo (1-SImSim, 2-Não) |
Título | Ativo |
Picture | @! |
Help de Campo | Informar se a regra encontra-se ativa 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 sequenciasequência de execução da regra. |
Campo | INSTR |
Tipo | C |
Tamanho | 254 |
Mandatório | Sim (xX) Não ( ) |
Descrição | Instrução |
Título | Instrução |
Picture | @! |
Help de Campo | Instrução na forma de codeblock, queseráexecutado 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 -
PoliticaPolítica 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 da Política |
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 referenciareferência a Politicaà Política, podendo haver varias comvárias com o 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 PoliticaPolítica de negocionegócio da programaçãoProgramação de entregaEntrega. |
Campo | SIT |
Tipo | C |
Tamanho | 1 |
Valor Inicial | 1-Sim |
Mandatório | Sim (X ) Não ( ) |
Descrição | Ativo (1-SImSim, 2-Não) |
Título | Ativo |
Picture | @! |
Help de Campo | Informar se a regra encontra-se ativa 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 aatender à Politica Política. |
Campo | DTINI |
Tipo | D |
Tamanho | 8 |
Mandatório | Sim ( ) Não (X) |
Descrição | Data InicioInício da Vigência |
Título | Data InicioInício |
Help de Campo | Período inicial para vigência da politicapolítica. 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 politicapolítica. 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 (xX) |
Descrição | Código Carregamento |
Título | Carregamento |
Picture | @! |
Help de Campo | Código do carregamentoCarregamento. |
Campo | NUMPV |
Tipo | C |
Tamanho | 6 |
Visual | Visualizar |
Mandatório | Sim (xX) 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 (xX) Não ( ) |
Descrição | Item |
Título | Item |
Picture | @! |
Help de Campo | Item do pedidoPedido de vendasVenda. |
Campo | SEQUEN |
Tipo | C |
Tamanho | 2 |
Visual | Visualizar |
Mandatório | Sim (xX) Não ( ) |
Descrição | Seq |
Título | Sequência |
Picture | @! |
Help de Campo | Sequência do Item do pedidoPedido de vendasVenda. |
Campo | PRODUT |
Tipo | C |
Tamanho | 15 |
Visual | Visualizar |
Mandatório | Sim (xX) Não ( ) |
Descrição | Produto |
Título | Produto do Pedido de VendasVenda |
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 VendasVenda. |
| 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 VendasVenda. |
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 VendasVenda. |
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 VendasVenda. |
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 VendasVenda. |
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 |
Campo | LOCAL |
Tipo | C |
Tamanho | 12 |
Visual | Visualizar |
Mandatório | Sim ( ) Não (X ) |
Descrição | local de Estoque |
Título | Local |
Picture | @! |
Help de Campo | Local de Estoque. |
Campo | CULTRA |
Tipo | C |
Tamanho | 10 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Cultura |
Título | Cultura |
Picture | @! |
Help de Campo | Código identificador da cultura no sistema. |
Campo | CTVAR |
Tipo | C |
Tamanho | 10 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Cultivar |
Título | Cultivar |
Picture | @! |
Help de Campo | Código identificador da cultivar no sistema. |
Campo | CATEG |
Tipo | C |
Tamanho | 2 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Categoria |
Título | Categoria |
Picture | @! |
Help de Campo | Código identificador da categoria no sistema. |
Campo | PENE |
Tipo | C |
Tamanho | 4 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Peneira |
Título | Peneira |
Picture | @! |
Help de Campo | Código identificador da peneira no sistema. |
Campo | TPFRET |
Tipo | C |
Tamanho | 1 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Tipo de Frete |
Título | Tipo de Frete utilizado. |
Picture | @! |
Help de Campo | Tipo do Frete: C=CIF; F=FOB; T=Por conta terceiros; S=Sem frete |
Campo | STATUS |
Tipo | C |
Tamanho | 1 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Status |
Título | Status |
Picture | @! |
Help de Campo | Status: 1=Agd. AprovacaoAprovação; 2=Aprovado; 3=Aprovado manualmente. |
Campo | CODSAF |
Tipo | C |
Tamanho | 15 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Codido da Safra |
Título | Cod.Safra |
Picture | @! |
Help de Campo | Informar a Safra. |
Campo | DTPROG
|
Tipo | D |
Tamanho | 8 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Data emissao programação |
Título | Dt Prog |
Picture | @! |
Help de Campo | Data de Emissão da Programação. |
Campo | DTPREV |
Tipo | D |
Tamanho | 8 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Data Prevista Programação |
Título | Dt Prev |
Picture | @! |
Help de Campo | Data Prevista da Programação de Entrega |
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:
. |
Campo | HRPREV |
Tipo | C |
Tamanho | 5 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Hora Prevista Programação |
Título | Hr Prev |
Picture | @r 99:99 |
Help de Campo | Hora Prevista da Programação de Entrega. |
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 Políticas de Entrega;
- Definir as regras para cada PoliticaPolítica;
- Realizar a Programação de entrega Entrega, informando a data prevista de AGENDAMENTO
- Agendamento.