Histórico da Página

CONTEÚDO

1. OBJETIVO

Desenvolver uma documentação complementar do Cadastro de Operando de Faturamento (WMS6401), detalhando principalmente os campos que compõem a aba 2- Customizações.

2. 

...

ABA 2 - CUSTOMIZAÇÕES

2.1. Cálculo Customizado

Neste campo é possível efetuar a customização do cálculo, sendo necessário informar o SQL com o comando SELECT.

O comando do tipo SQL deve retornar obrigatoriamente um único valor, pois o Sistema está preparado para trabalhar apenas com o resultado final a ser retornado por este comando, sendo que atualmente este campo comporta até 255 caracteres.

Image Added

Exemplo

SELECT SUM(minha_tabela.meu_campo)
SELECT COUNT(m.campo_nao_padrao)
SELECT MAX(d.campo_nao_padrao)
SELECT AVG(m.qtd_volumes) #Média de volumes expedição por dia. m -> wms_exp_mestre_?

O campo Cálculo Customizado somente tem utilidade quando na aba 1 - Dados Principais, o campo Tipo Cálculo estiver configurado como Customizado pelo usuário, conforme especificado a seguir:

Image Added

2.2. Comando Customizado

Neste campo é possível cadastrar uma função que pode manipular os comandos SQL (SELECT, FROM e WHERE ) padrões antes da execução na função padrão de apuração, sendo que esta função será executada antes do PREPARE do SQL utilizado para efetuar a leitura do valor calculado do operando no período, atuando como um before_prepare.

Esta função vai receber por SET as variáveis cmd_select , cmd_from e cmd_where que estarão com os valores padrões como, por exemplo:

cmd_select = "SELECT SUM(m.qtd_palete_fisico)"
cmd_from = " FROM wms_armaz_end_08345690901 m" onde 08345690901 é código do depositante.
cmd_where = " WHERE m.empresa = ‘01’ AND m.sit_registro <> 'C' AND m.data_posicao_estoque >= ? AND m.data_posicao_estoque <= ?"

A função de apuração chamará a função cadastrada no campo Comando Customizado, podendo editar e retornar estes comandos que serão recebidos por funções de GET conforme abaixo:

LET l_select_stmt = LOG_getVar("cmd_select") Máximo 255 caracteres
LET l_from_stmt = LOG_getVar("cmd_from") Máximo 1000 caracteres
LET l_where_stmt = LOG_getVar("cmd_where") Máximo 5000 caracteres

Deve obrigatoriamente retornar TRUE ou FALSE. Nesta função é possível, por exemplo, alterar o comando FROM que a função padrão executará, informando uma tabela específica ou adicionar um filtro no comando WHERE.

Image Added

Exemplo básico

FUNCTION wmsyXXXX_customiza_operando()
DEFINE l_cmd_from CHAR(1000)

LET l_cmd_from = LOG_getVar("cmd_from")

# ‘m’ representa o alias da tabela mestre do processo
LET l_cmd_from = l_cmd_from CLIPPED,
" INNER JOIN minha_tabela",
" ON minha_tabela.empresa = m.empresa",
" AND minha_tabela.ctr_ent_sai_veic_docum = m.ctr_ent_sai_veic_docum"

CALL LOG_setVar("cmd_from", l_cmd_from)

RETURN TRUE
END FUNCTION

2.3. Comando Retorno Valor

Neste campo é possível cadastrar uma função que pode utilizar o valor calculado para um determinado operando para, por exemplo, gravar uma tabela auxiliar específica.

Esta função não manipula o valor calculado, recebendo o valor calculado do operando para cada dia do período pela função setVar:

CALL LOG_setVar("valor_operando",l_valor_operando)

Image Added

Exemplo

# Comando para ser executado após o calculo do valor do operando
# e a gravação da tabela padrão wms_geracao_dados_operando
FUNCTION wmsyXXXX_comando_retorno_valor()

DEFINE l_depositante        LIKE wms_geracao_dados_operando.depositante,
l_operando_faturamento   LIKE wms_geracao_dados_operando.operando_faturamento,
l_data_geracao                   LIKE wms_geracao_dados_operando.dat_geracao,
l_val_parametro                 LIKE wms_geracao_dados_operando.val_parametro

LET l_depositante = wmsr48_get_depositante()
LET l_operando_faturamento = wmsr48_get_operando_faturamento()
LET l_data_geracao = wmsr48_get_data_atual_processamento()
LET l_val_parametro = LOG_getVar("valor_operando")

INSERT INTO minha_tabela (depositante, operando, data_geracao, valor_operando)
VALUES (l_depositante, l_operando_faturamento, l_data_geracao, l_val_parametro)

RETURN TRUE
END FUNCTION

2.4. Filtro Customizado

Image Added

Com esse campo é possível gerar filtros adicionais nas tabelas padrão de dados base como, por exemplo:

• Cobrar recebimento de um veículo de determinada placa de forma diferenciada:
  
  

Image Added

• Cobrar a armazenagem de forma diferenciada de endereços com determinada função de endereço:
  
  

Image Added

Existem algumas funções padrões que retornam valores que podem ser usadas para configurar parâmetros customizados para aplicar filtros em um operando de faturamento:

Exemplo de filtro utilizando parametrização customizada

AND minha_tabela.meu_depositante = ?
AND minha_tabela.meu_campo_data_hora >= ?
AND minha_tabela.meu_campo_data_hora <= ?
AND minha_tabela.meu_campo_customizado = ?

2.5. Comando Carga Parâmetros

Image Added

É especificada uma função customizada, que será executa antes do EXECUTE do SQL usado para fazer a leitura do valor calculado do operando no período, atuando como um before_execute do operando.

• Não possui parâmetros que podem ser recuperados pela função LOG_getVar().
• Pode ser utilizada para carregar os valores retornados pelas funções dos parâmetros customizados
• Deve obrigatoriamente retornar TRUE ou FALSE.

a. Esta função não recebe nenhum retorno específico via LOG_setVar().

b. Pode ser utilizada para fazer a carga de variáveis customizadas para o operando que serão utilizadas de forma dinâmica, de acordo com o cadastro de parâmetros customizados.

A função especificada customizada, fará o processamento e tratamento de datas de período início e fim, de forma que possam ser recuperadas por variáveis modulares ou tabelas temporárias, através de outra função que deverá ser informada na grade Parâmetros.

2.6. Grade Parâmetros

Image Added

3. INFORMAÇÕES ADICIONAIS SOBRE OS COMANDOS CUSTOMIZADOS

Gerar funções customizadas que podem ser utilizadas para o Comando customizado, Comando retorno valor ou Comando carga parâmetro requer alguns padrões a serem seguidos, para que a execução da função ocorra da forma desejada e apresente o resultado esperado. 

Desta forma, segue um detalhamento sobre o modo trabalho e comportamento de cada tipo de função para cada comando.

3.1. Campo Customizado

Campo para informar o nome da função na qual deverá ser efetuada a manipulação do SQL que deverá determinar o valor do operando.

Esta função será executada antes do PREPARE do SQL utilizado para efetuar a leitura do valor calculado do operando no período, atuando como um “before_prepare”.

• Possui parâmetros que podem ser recuperados pela função LOG_getVar().
  

• Recebe como parâmetros que podem ser setados pela função LOG_setVar().

• Deve obrigatoriamente retornar TRUE ou FALSE

3.2. Gerando uma Função Customizada

Para gerar uma função customizada que poderá ser utilizada no Comando Customizado devem ser observados alguns padrões, pois dentro da rotina o comando SQL deve ser quebrado em três partes: SELECT, FROM e WHERE, conforme descrito a seguir:

• Definir as variáveis l_select_stmt, l_from_stmt ,l_where_stmt com os respectivos tamanhos a seguir:

DEFINE l_select_stmt          VARCHAR(255)
             l_from_stmt            VARCHAR(1000)
             l_where_stmt         VARCHAR(5000)

• Definir Record para receber as informações do operando:

DEFINE lr_operand_fatur       RECORD
                             tip_processo                CHAR(20)                                ,tip_operando_faturamento SMALLINT
                            ,dat_base_operando     SMALLINT
                            ,filtro_customizado       LIKE wms_operando_faturamento.filtro_customizado
                            ,forma_cobranca           LIKE wms_operando_faturamento.forma_cobranca
                           END RECORD

DEFINE l_depositante CHAR(15)
LET l_depositante = wmsr48_get_depositante()

• Utilizar o código do depositante para montar os nomes das tabelas no SELECT, pois as informações estão divididas em tabelas com prefixo padrão, porém, com código do depositante compondo o nome. Mais detalhes podem ser obtidos a seguir, em Tabelas e Alias.
  
  
• Utilizar a função abaixo para obter as informações do operando de faturamento:

LET l_operando_faturamento = wmsr48_get_operando_faturamento()

• Utilizar a função LOG_getVar(“ “) para carregar os comandos de SELECT, FROM e WHERE:

LET l_select_stmt = LOG_getVar("cmd_select")
LET l_from_stmt = LOG_getVar("cmd_from")
LET l_where_stmt = LOG_getVar("cmd_where")

• Inicializar as variáveis l_select_stmt, l_from_stmt ,l_where_stmt:

INITIALIZE l_select_stmt
,l_from_stmt
,l_where_stmt TO NULL

Para montar a estrutura da sua função, a variável l_select_stmt deve conter um comando SQL que retorne um valor único. Neste caso, podem ser utilizadas as funções SUM(), MAX() e AVG(), por exemplo.

Também pode ser efetuada a leitura do campo Forma Cobrança, para que seja realizado um tratamento pelo Cadastro do Operando, sendo que para isso deve utilizado  como por exemplo:

IF lr_operand_fatur.tip_processo = "ARMAZENAGEM" THEN
    IF lr_operand_fatur.tip_operando_faturamento = 99 THEN #Customizado pelo Usuário
        CASE lr_operand_fatur.forma_cobranca
            WHEN "S"
                LET l_select_stmt = "SELECT SUM(palete.qtd_saldo)"
            WHEN "P"
                 LET l_select_stmt = "SELECT MAX(palete.qtd_saldo)"
            WHEN "M"
                 LET l_select_stmt = "SELECT AVG(palete.qtd_saldo)"
         END CASE

• Montar cada estrutura separadamente, em sua respectiva variável:

Select – l_select_stmt

        LET l_select_stmt = "SELECT SUM(b.qtd_saldo/palete.qtd_saldo)"

From – l_from_stmt

        LET l_from_stmt =    " FROM wms_armaz_pal_", l_depositante CLIPPED, " b",
                                         "           ,(SELECT DISTINCT a.empresa ",
                                         "                                         ,a.data_posicao_estoque ",
                                         "                                         ,a.palete ",
                                         "                                         ,SUM(a.qtd_saldo) qtd_saldo ",
                                         "               FROM wms_armaz_pal_", l_depositante CLIPPED, " a",
                                         "             WHERE a.empresa = '",l_empresa ,"'",
                                         "                  AND a.data_posicao_estoque >= ? ",
                                         "                  AND a.data_posicao_estoque <= ? ",
                                         "             GROUP BY a.empresa ",
                                         "                              ,a.data_posicao_estoque ",
                                         "                              ,a.palete) palete "

Where = l_where_stmt

        LET l_where_stmt =  " WHERE b.empresa = palete.empresa ",
                                         " AND b.data_posicao_estoque = palete.data_posicao_estoque ",
                                         " AND b.palete = palete.palete ",
                                         " AND EXISTS(SELECT DISTINCT 1 ",
                                         "                         FROM wms_armaz_item_", l_depositante CLIPPED, " c",
                                         "                       WHERE c.empresa = b.empresa ",
                                         "                            AND c.data_posicao_estoque = b.data_posicao_estoque ",
                                         "                            AND c.item = b.item ",
                                         "                            AND c.sit_registro <> 'C' "

• E chamar a função Log_setVar(), passando os parâmetros, como cmd_select, cmd_from e cmd_where, respectivamente com suas variáveis, para que seja efetuado devido carregamento, e então o Return True indicará para a aplicação que esta poderá seguir com o prepare execute do comando SQL.

CALL LOG_setVar("cmd_select",l_select_stmt)
CALL LOG_setVar("cmd_from", l_from_stmt)
CALL LOG_setVar("cmd_where", l_where_stmt)

RETURN TRUE

END FUNCTION

3.3. Tabelas e Alias Padrões

Para facilitar o entendimento do SQL foi assumido por padrão que o ALIAS "m" indica a tabela mestre e "d" a tabela detalhe. Este padrão deverá ser seguido.

Montagem do SELECT

• Processo: RECEBIMENTO
  LET l_from_stmt = " FROM wms_rec_mestre_", l_depositante CLIPPED, " m"
  
  
• Processo: EXPEDICAO
  LET l_from_stmt = " FROM wms_exp_mestre_", l_depositante CLIPPED, " m"
  
  
• Processo: ARMAZENAGEM
  LET l_from_stmt = " FROM wms_armaz_end_", l_depositante CLIPPED, " m"
  
  
• Processo: SEGURO
  LET l_from_stmt = " FROM wms_seg_detail_", l_depositante CLIPPED, " d"
  
  
• Processo: ATRIBUTO
  LET l_from_stmt = " FROM wms_atr_mestre_", l_depositante CLIPPED, " m"

4. ASSUNTOS RELACIONADOS

Documento de Referência

• Operando - WMS6401

5. ANEXO

• Customização de operandos de faturamento de serviço.pdf

...

Como a troca de padrão de paletização pode variar por depositante, por destinatários e até por cargas específicas (exemplo, uma carga para exportação), é possível configurar a atividade de paletização de três formas diferentes.

2.1. Contrato - Paletização

2.2. Por depositante

Quando configurado por depositante, todas os processos de expedição deste depositante irão ter a atividade de paletização. Para que isso ocorra, a atividade correspondente ao tipo de processo 317 - Paletização deve ser adicionado a estrutura de serviços da classe de expedição. A paletização pode ser adicionada após a separação, ou após a conferência.

Image Removed

2.3. Por destinatário

Quando a paletização é necessária para destinatários específicos, a paletização pode ser configurada como um serviço independente e assim configurada nas formas de expedição por destinatário.

Image Removed

Image Removed

2.4. Por solicitação de carga

Quando a necessidade de paletização ocorre de forma aleatória para um depositante, dependendo de cada solicitação de carga, a atividade de paletização pode ser configurada como uma atividade extra relacionada a um atributo de solicitação de carga, e assim, ser indicado em cada solicitação de carga se a atividade vai ser executada ou não.

• Primeiramente deve ser cadastrado um atributo na rotina WMS6910 informando o gatilho, que é o valor para o atributo na solicitação de carga que irá gerar a atividade de paletização no processo e o momento que a atividade deve ser executa. No exemplo abaixo ela ocorrerá antes do embarque, ou seja, após a separação, conferência e pesagem, conforme configurado o processo.

Image Removed

• Na solicitação de carga será possível indicar se o processo terá ou não paletização.

Image Removed

3. EXECUÇÃO DA PALETIZAÇÃO

No exemplo a seguir foi utilizada a configuração por solicitação de carga.

• Nos atributos da solicitação foi informado o valor gatilho para a atividade extra de paletização.

Image Removed

• Foram gerados plano, onda na rotina de Preparação da Separação - WMS60001.
• Foi realizada a separação dos itens via rotina Separação Coletor - WMS6214 e efetuado o descarregamento de todos os itens.
• Também foi realizada a conferência da expedição, pois a configuração da atividade extra indica que a paletização ocorre antes do embarque.
• Após isso, a ordem de serviço de paletização ficou disponível para execução na lista pública do coletor WMS6070.

Image Removed Image Removed 

• Para iniciar o processo deve ser informado o endereço de trabalho, normalmente o endereço onde os itens foram descarregados na separação.

Image Removed 

• Em seguida, devem ser informados os códigos de barras dos volumes resultantes da paletização relacionados ao documento ou plano exibido em tela.

Image Removed Image Removed Image Removed 

• Na tecla de atalho F10/Ctrl + S, podem ser visualizadas ações que podem ser realizadas durante a operação.

Image Removed 

• F3/CTRL+I: Interrompe o processo de paletização, solicitando um motivo.

Image Removed

• F6/CTRL+P: Exibe os volumes que já foram registrados para o documento.

Image Removed Image Removed 

• F7/CTRL+A: Permite efetuar a armazenagem dos volumes já montados, para o documento. Esta ação não finaliza a atividade, permitindo que sejam incluídos novos volumes. A armazenagem pode ser direcionada para um endereço de 1 - Stage ou para 2 - Doca.

Image Removed  Image Removed

• F4/CTRL+F: Finaliza a atividade de paletização. Ao finalizar a atividade é solicitada a confirmação e sem seguida é questionado se deve ser efetuada a movimentação dos volumes informados. A movimentação pode ser feita para um endereço de 1- Stage ou para a 2- Doca, se for selecionada opção 3 - Não gerar movimentações, os volumes são mantidos no endereço sugerido de trabalho.

Image Removed Image Removed Image Removed

3.1. Movimentação de volumes paletizados

Se ao finalizar a paletização for indicado que os volumes devem ser armazenados em endereço tipo Stage ou Doca, os movimentos de armazenagem ficarão pendentes de execução na lista pública do coletor WMS6070.

Quando indicado para não movimentar os volumes gerados, estes ainda poderão ser armazenados via rotina de Armazenagem WMS6237. Nesta rotina, ao efetuar a efetivação do movimento (F6/CTRL+L), quando se tratar de um volume de paletização, deverá ser informado se o mesmo deve ser armazenado em Doca, Stage ou Não sugerir, nesta última opção poderá ser informado qualquer endereço compatível e disponível para armazenagem.

Image RemovedImage RemovedImage Removed Image Removed

4. CONSULTAS

Os volumes de embarque gerados neste processo podem ser consultados na rastreabilidade de processo da solicitação de carga, rotina WMS6325.

Selecionar opção Rastrear processo > Volumes Embarque

Image Removed

Para visualizar os detalhes do volume, selecionar Detalhes.

Image Removed

5. ASSUNTOS RELACIONADOS

Documentos de Referência

• WMS60013 - Contratos
• WMS60014 - Proposta
• WMS6345 - Formas de Expedição
• WMS6910 - Cadastro de Atributos da Solicitação de Carga
• WMS6007 - Atividades
• WMS6325 - Digitação de Solicitação de Carga
• WMS6750 - Paletização
• WMS6237 - Movimentação de Palete

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>