01. DADOS GERAIS

Linha de Produto:Protheus
Segmento:Logística
Módulo:SIGATMS
Função:

TMSA020 - Tabela de Ocorrências
TMSA025 - Rotina x Bloqueios
TMSA029 - Manutenção de Bloqueios
TMSA200 - Cálculo do Frete
TMSA500 - Manutenção de Documentos
TMSA360 - Registro de Ocorrências
TMSXFUNE - Função Genérica

Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :DLOGTMS03-7936
DLOGTMS03-7937
DLOGTMS03-7939
DLOGTMS03-7940
DLOGTMS03-7943
DLOGTMS03-7944
DLOGTMS03-8015


02. SITUAÇÃO/REQUISITO

Visando melhorar a acuracidade da apuração de Performance de Entrega, disponibilizaremos uma nova opção que, através do registro de ocorrência, permitirá o ajuste do prazo de entrega previsto originalmente. 

Esta opção poderá ser utilizada nos casos em que uma entrega não foi realizada dentro prazo previsto devido a um evento de responsabilidade de terceiros (exemplo: destinatário fechado) e não do transportador. 

Através desta atualização, as Transportadoras poderão reduzir o nível de descontos comerciais  por falta de eficiência nos serviços operacionais, permitindo que o sistema reflita a realidade  da operação sem a necessidade de controle paralelos.

03. SOLUÇÃO

Para viabilizar esta melhoria, seguem as alterações que foram efetuadas nas rotinas:


  1. Tabela de Ocorrências (TMSA020)

    Disponibilizado novo campo Prazo de Entrega (DT2_PRZENT) que indica se a Ocorrência permite a alteração do prazo de entrega
    Somente poderá ser preenchido se a “Responsabilidade" (DT2_RESOCO) estiver preenchida com “2-Cliente” e se o “Tipo da Ocorrência” (DT2_TIPOCO) estiver preenchido com  “04-Retorna documento” ou “05-Informativa”. O campo 'Libera Automatico' (DT2_LIBAUT) será habilitado para digitação quando o campo Prazo de Entrega (DT6_PRZENT) estiver configurado para SIM. 

  2. Rotina x Bloqueios (TMSA025)

    Foi criado um novo código de Bloqueio chamado  "PR - Prazo de Entrega" para rotina "TMSA360-Registro de Ocorrência" .  Este tipo de bloqueio ocorrerá sempre que for apontada uma ocorrência que efetuou uma alteração na data de previsão de entrega. Esta nova opção será habilitada somente se o campo "Prazo entrega (DT2_PRZENT)" existir no dicionário de dados. 

  3. Aprovadores (TMSA026)

    Não houve alteração nesta rotina mas é importante ressaltar que, para todo tipo de bloqueio, deve existir no mínimo um Aprovador para que seja possível efetuar a liberação portanto é imprescindível definir o usuário que terá o direito de efetuar a liberação para o tipo de bloqueio "PR-Prazo Entrega".

  4. Cálculo do Frete (TMSA200) 

    Foi criado o novo campo Prazo de Entrega Original (DT6_PRZORI), visando ter a referência da primeira Data de Previsão de Entrega do Documento,
    Neste novo campo será gravada a data de previsão de entrega inicial do documento, ou seja, será a mesma do campo Prazo de Entrega (DT6_PRZENT) preenchido automaticamente pelo sistema durante a geração do Documento de Transporte.  O novo campo Prazo de Entrega Original (DT6_PRZORI) servirá para que o usuário possa identificar rapidamente se houve alguma alteração na data de Previsão de Entrega durante a tentativa de entregar a mercadoria. 
    Atenção: os documentos de transporte gerados antes da criação desta nova funcionalidade estarão com o campo "Prz.Ent.Ori (DT6_PRZORI)" sem preenchimento. Para estes documentos, ao apontar uma Ocorrência que esteja configurada para efetuar alteração da data de previsão de entrega, o sistema preencherá o campo "Prz.Ent.Ori (DT6_PRZORI)" com o conteúdo do campo "Prz.Entrega (DT6_PRZENT)" anterior ao apontamento da referida ocorrência.

  5. Registro de Ocorrências (TMSA360)

    Foi criado um novo campo "Prz.Entrega (DUA_PRZENT)"  na tabela "Registro de Ocorrência (DUA)" para que seja possível que o usuário lance uma nova data de previsão de entrega para um documento de transporte. Este novo campo será habilitado para digitação somente se a ocorrência estiver configurada para alteração do prazo de entrega. Seguem detalhes sobre o funcionamento deste novo campo:


    Ao apontar uma Ocorrência
    que esteja configurada para efetuar alteração da data de previsão de entrega, será permitido informar a nova data no campo Prazo de Entrega (DUA_PRZENT). O sistema efetuará as seguintes validações no campo "Prz.Entrega (DUA_PRZENT)":

    1. Assim sejam informados os campos que identificam o documento de transporte (fildoc/doc/série), o sistema preencherá o campo Prazo de Entrega (DUA_PRZENT) com a data atual de previsão de entrega do documento e esta informação é obtida através do campo "Prz.Entrega (DT6_PRZENT)".

    2. Se o conteúdo apresentado pelo sistema  não for alterado pelo usuário, o sistema permitirá salvar o registro sem gerar o  bloqueio de Prazo e, consequentemente, sem efetuar alterações no campo relativo à data de previsão de entrega do documento de transporte (DT6_PRZENT). 
    3. Se o conteúdo apresentado pelo sistema  for alterado com uma data diferente da data de previsão atual do documento de transporte, ao confirmar o Registro de Ocorrência, o sistema irá bloquear o Documento de Transporte e o mesmo não poderá ser vinculado a uma nova viagem até que seja liberado pela rotina Manutenção de Bloqueios.(TMSA029).  Caso a Ocorrência tenha sido configurada para Liberação Automática, o sistema gerará o bloqueio contudo poderá efetuar a liberação automática deste bloqueio caso o usuário logado tenha o direito de liberar este tipo de bloqueio.
    4. Se o conteúdo apresentado pelo sistema for alterado com uma data menor que a data de emissão do documento de transporte (DT6_DATEMI), o sistema apresentará a seguinte mensagem: "TMSA360F8 – A data do prazo de entrega informada não pode ser menor que a data de emissão do documento de transporte".
    5. Se o conteúdo apresentado pelo sistema for alterado para uma data 'em branco', o sistema permitirá salvar o registro sem efetuar alterações no campo relativo à data de previsão de entrega do documento de transporte (DT6_PRZENT) e não irá bloquear o documento.
    6. Se o documento de transporte for uma Solicitação de coleta, o campo "Prz.Entrega  (DUA_PRZENT)" não será habilitado para digitação 
    7. Se o documento de transporte já estiver com status 7=Entregue, o campo "Prz.Entrega (DUA_PRZENT)" não será habilitado para digitação.

      Atenção: os documentos de transporte gerados antes da criação desta nova funcionalidade estarão com o campo "Prz.Ent.Ori (DT6_PRZORI)" sem preenchimento. Para estes documentos, ao apontar uma Ocorrência que esteja configurada para efetuar alteração da data de previsão de entrega, o sistema preencherá o campo "Prz.Ent.Ori (DT6_PRZORI)" com o conteúdo do campo "Prz.Entrega (DT6_PRZENT)" anterior ao apontamento da referida ocorrência.


    Ao estornar uma ocorrência que esteja configurada para efetuar alteração da data de previsão de entrega, o sistema buscará o conteúdo anterior ao apontamento da ocorrência e atualizará o campo "Prz.Entrega (DUA_PRZENT)". Supondo que um determinado documento de transporte tenha recebido diversas ocorrências que alteraram o prazo, o sistema só permitirá estornar a ocorrência seguindo a ordem “da mais atual” para a “mais antiga”. Veja o exemplo:


     



  6. Manutenção de Bloqueios (TMSA029)
    O sistema apresentará a possibilidade de Liberar ou Rejeitar os bloqueios relativos a alteração da data de previsão de entrega (PR).
    1. Ao clicar na opção "Liberar" o usuário poderá visualizar a data de previsão de entrega atual do documento de transporte (DT6_PRZENT) e a nova data de previsão de entrega digitada no apontamento da ocorrência (DUA_PRZENT). O sistema disponibilizará um novo campo chamado "Nova Data (DDU_DATA)" que virá com o conteúdo digitado durante o apontamento da ocorrência contudo este campo poderá ser alterado pelo usuário que estará liberando o referido bloqueio. Após digitar um conteúdo no campo relativo ao "Motivo", ao confirmar a liberação, o sistema desbloqueará o documento de transporte (DT6_BLQDOC=2) e atualizará o campo relativo à data de previsão de entrega (DT6_PRZENT) a partir do conteúdo do campo "Nova Data (DDU_DATA)".
    2. Ao clicar na opção "Rejeitar", usuário poderá visualizar a data de previsão de entrega atual do documento de transporte (DT6_PRZENT) e a nova data de previsão de entrega digitada no apontamento da ocorrência (DUA_PRZENT). O sistema disponibilizará um novo campo chamado "Nova Data (DDU_DATA)" que virá com o conteúdo digitado durante o apontamento da ocorrência contudo este campo não poderá ser alterado pelo usuário que estará rejeitando o referido bloqueio. Ao confirmar a rejeição, o sistema desbloqueará o documento de transporte (DT6_BLQDOC=2) e não atualizará o campo relativo à data de previsão de entrega (DT6_PRZENT) a partir do conteúdo do campo "Nova Data (DDU_DATA)".


  7. Manutenção de Transportes - Geração do documento do tipo "Reentrega" (TMSA500)

    Na geração de documentos de Reentrega considerados "operacionais", o Documento Original não estando bloqueado , o sistema inicialmente verificará se existem ocorrências de Prazo de Entrega liberadas para o documento original

    Caso não existam, o sistema assumirá para o novo documento (reentrega) a regra já existente no sistema para o preenchimento do campo "Prz.Entrega".
    Caso existam, o sistema  assumirá a Data de Previsão de Entrega do Documento Original para o documento de Reentrega que está sendo gerado. Se porventura, a data de emissão do documento de Reentrega for maior que a Data de Previsão de entrega do documento Original,  o sistema preencherá Data de Prazo de Entrega  do novo documento conforme a regra já existente ou seja, desconsiderará a data de previsão de entrega do documento original. 





1. Use quando for necessário descrever um passo a passo.

2. Use quando for necessário descrever um passo a passo.


04. DEMAIS INFORMAÇÕES


Criação eu Alteração  de Campos no arquivo SX3 – Campos:


Campo

DT2_PRZENT

Tipo

Caractere

Tamanho

1

Decimal

0

Formato

@!

Título

Prazo Entreg

Descrição

Altera o Prazo de Entrega

Usado

Sim

Obrigatório

Não

Browse

Não

Opções

1=Sim;2=Nao

When

TmsA020Whe()

Relação

"2"

Val. Sistema

Vazio() .Or. Pertence("12")

Help

Indica se permite a alteração do Prazo de Entrega do Documento de Transporte (CTe).




Campo

DT2_RESOCO

Val. Sistema

Pertence("0123") .And. TmsA020Vld()



Campo

DT6_PRZORI

Tipo

Data

Tamanho

8

Decimal

0

Formato


Título

Prz.Ent.Ori

Descrição

Prazo de Entrega Original

Usado

Sim

Obrigatório

Não

Browse

Não

Help

Como o campo Prazo de Entrega (DT6_PRZENT), poderá ser atualizado de acordo com o Apontamento da Ocorrência, este campo DT6_PRZORI armazenará o Prazo de Entrega Original do Documento e indicará se houve alteração no Prazo de Entrega.



Campo

DUA_PRZENT

Tipo

Data

Tamanho

8

Decimal

0

Formato


Título

Prazo Entrega

Descrição

Prazo de Entrega 

Usado

Sim

Obrigatório

Não

Browse

Não

Help

Data do Prazo de Entrega da Mercadoria, com base nos prazos de regiões e prazos de cliente.

Caso houver alteração nesta data, será gerado um bloqueio para o documento e o mesmo não poderá ser vinculado à viagem até que o bloqueio seja liberado.



Campo

DDU_DATA

Tipo

Data

Tamanho

8

Decimal

0

Formato


Título

Data

Descrição

Data

WhenTmsa029Whe()

Usado

Sim

Obrigatório

Não

Browse

Não

Help

Este campo será utilizado para informar a Nova Data que substituirá o conteúdo anterior.



Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.



05. ASSUNTOS RELACIONADOS




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