Réplica -

Agendamento de Entrega

Características do Requisito

Descrição

Escreva aqui a descrição da nova implementação ou melhoria.

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

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

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

Atualizações do Compatibilizador

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

1. Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

2.    Criação ou Alteração de tabela no arquivo SX2– Tabelas:

3.  Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

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:

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:

6.  Criação ou Alteração de Índices no arquivo SIX – Índices:

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

8.  Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

• Tabela BD5 – Contas Médicas:

Objetivo 

Permitir a utilização do Agendamento de Entregas, agilizando o processo de distribuição de carga e fornecer ao usuário uma visão detalhada do trabalho a ser executado, dentro de cada prioridade de distribuição definida pelo transportador.

Definição da Regra de Negócio 

Definir na tabela de “Componentes de Frete por Destinatário” o cliente (quando destinatário), se é participante de agendamentos de entregas (Sim, Não, Obrigatório).

A partir do lançamento da Nota Fiscal do cliente, o usuário terá a opção para definir a Data/Hora das entregas a serem efetuadas pelo transportador.

Haverá uma interface para monitoramento dos agendamentos, com o devido posicionamento de cada agendamento (status) definidos nos parâmetros, para que cada decisão seja o mais breve possível e ágil para definição das situações adversas.

Nesse monitor de agendamento o usuário terá acesso a inclusão, cancelamento, monitoramento e reagendamento dos documentos trazidos pelo filtro, onde serão informados, responsabilidade pela ocorrência (prioridade cliente, prioridade transportador, cliente, transportador).

Implementação Realizada - Monitor de Agendamentos (TMSA018)

Por intermédio do Monitor do Agendamentos será possível monitorar os agendamentos disponíveis para entrega.

• Incluir Agendamento do tipo Operacional:

A inclusão do agendamento de entrega operacional ou a manutenção poderá ser realizada em qualquer filial.

Foi realizado tratamento para verificar se já existe agendamento para o documento:
Sim: não é possível realizar a inclusão, sendo necessário realizar a manutenção do agendamento do documento.
Não existe: permite realizar a inclusão manual, desde que o destinatário seja participante do agendamento de entrega.

No processo de inclusão do agendamento operacional deverá ser gravada as informações do agendamento de entrega tanto no documento de transporte (DT6), quanto no documento do cliente (DTC) vinculado ao documento de transporte.

• Realizar Reagendamento de Entregas:

Disponibilizada a opção “Reagendamento", a qual permite reagendar o agendamento posicionado no browse.

Por intermédio dessa opção é possível alterar a data / hora, período e tipo do agendamento.

O histórico do agendamento anterior será controlado a partir da tabela DYJ – Histórico de Agendamentos, que possibilitará saber quantas vezes aquele agendamento sofreu reagendamentos e quem foi o responsável pelo reagendamento. 

• Acompanhar Status de Entregas.

• Cancelar um Agendamento de Entrega:

Em Ações Relacionadas será disponibilizada a opção “Cancelar”.

Ao clicar nessa opção será aberta uma tela com o agendamento posicionado, na qual deverá ser informado o motivo do cancelamento. 

Alterações Realizadas Nas Rotinas

• Componente de Frete por Destinatário (TMSA013):

O Componente do tipo por destinatário pode ser configurado com a nomenclatura desejada, podendo ser, por exemplo: TAG, Carro dedicado, TDE entre outros.

Isto ocorre desde que a opção Calcula Sobre, da configuração do componente, seja igual a 15 = Cliente Destinatário.

Nessa rotina podem ser definidos quem são os clientes destinatários participantes do agendamento de entrega, podendo ser:

• 1. Sim:será possível incluir agendamentos de entregas para este destinatário.

  2. Não:destinatário não é participante do agendamento de entrega.

  3. Obrigatório:sempre deverá ser gerado um agendamento de entrega para este destinatário.
     Caso não seja informado, nos dados do agendamento na rotina de entrada de documento do cliente será gerado automaticamente, após o cálculo do documento, um agendamento de entrega com o status“Aguardando agendamento”.

• Manutenção de Agendamento de Entrega - Rotina Descontinuada (TMSA014):

Rotina de Manutenção de agendamentos será descontinuada e será substituída pelo Monitor de Agendamentos (TMSA018).

• Cadastro de Prioridades - Agendamento de Entrega (TMSA015):

Definir as Prioridades de Entregas que serão tratadas no sistema, como:

1. 1. Perda de Agendamento
      1. De x Dias
      2.  Até x Dias
   2. Data Atual
   3. Data Futura
      1. De x Dias
      2. Até x Dias
   4. Sem Agendamento 

• Notas Fiscais do Cliente (TMSA050):               

Definição de Tipo do Agendamento, Data, Período (Hora) e motivo do lançamento.

Os dados também poderão ser importados pelo EDI (NOTFIS). Para isto, foram desenvolvidos novos campos na tabela DE5 – EDI Notas Fiscais.

Validação da data de agendamento:

• 1. Na inclusão do agendamento, tanto pela entrada do documento do cliente quanto pela inclusão manual do agendamento, será validado se a data e hora informada para o agendamento é superior a data base do sistema.
  2. Se o cliente destinatário estiver configurado com a opção Agd. Entrega = Obrigatório e na entrada do documento do cliente não for informada a data e a hora, será criado automaticamente para o documento um agendamento de entrega com o status “Aguardando Agendamento”.

No momento da digitação da Nota Fiscal do cliente, o sistema efetuará as seguintes análises:

• 1. Se “não for” informada uma sequência de endereço para o destinatário, o sistema procura se o próprio código do cliente destinatário (DTC_CLIDES+DTC_LOJDES) existe nos códigos de clientes relacionados no componente por destinatário.
  2. Se “for” informada uma sequência de endereço para o destinatário, o sistema deverá identificar se existe um código de cliente gravado na respectiva sequência de endereço (DUL_CODRED+DUL_LOJRED).
  3. Se estiver preenchido, o sistema procura se o código de cliente preenchido na sequência de endereço (DUL_CODRED+DUL_LOJRED) existe nos códigos de clientes relacionados no componente por destinatário.
  4. Se “não” estiver preenchido, o sistema irá procurar apenas pelo código do cliente destinatário.
     No momento do cálculo, as notas serão divididas em CTRC’s diferentes, perante a data de Agendamento.

• EDI - Notas Fiscais Importadas (TMSAE55):

Pelo EDI Nota Fiscal será possível informar os dados do agendamento de entrega.

Para isto, foram criados novos campos na tabela DE5.

• 1. Tipo Agd.
  2. Data Agd.
  3. Período Agd.
  4. Hora Ini. Agd.
  5. Hora Fim. Agd.
  6. Motivo Agendamento.
• Viagem de Coleta / Entrega – Modelo 1 (TMSA141) e Viagem de Coleta / Entrega – Modelo 2 (TMSA144)

Trará os documentos que atendam as condições estabelecidas para execução dos documentos agendados.

Na inclusão de aviso na viagem de entrega foi criada uma validação para verificar se o documento que está sendo colocado em viagem possui agendamento de entrega e se o prazo da viagem está de acordo com a data do agendamento.

Caso esteja com a data correta do agendamento, permite a inclusão normalmente.

Caso a data da viagem seja diferente da data do agendamento, será apresentada uma mensagem de aviso em tela.

• 1. Sim: Permite a inclusão do documento na viagem.
  2. Não: Cancela a inclusão do documento na viagem.

Foi criada também uma validação para verificar se o documento que está sendo incluso na viagem o destinatário ou o cliente informado na sequência de endereço (DUL_CODRED+DUL_LOJRED) é participante do agendamento de entrega como "obrigatório” e se existe um agendamento para este documento.

• 1. Sim: Permite a inclusão na viagem.
  2. Não: Apresenta uma mensagem de Help informando que o destinatário ou o cliente informado na sequência de endereço (DUL_CODRED+DUL_LOJRED) é participante do agendamento de entrega e é necessário realizar o agendamento para o documento. 
• Cálculo do Frete (TMSA200):

Foi disponibilizado no Cálculo do Frete através da tecla F12, o parâmetro se o cliente deseja gerar o agendamento de entrega automático ou manual. Se informada a opção “Sim”, ao gerar o documento de frete será gerado o agendamento de entrega, um para cada data de agendamento, informado nas Notas de Cliente. Caso seja informada a opção “Não”, não será gerado o agendamento de entrega para o documento e a inclusão deverá ocorrer de forma manual, através da rotina de Monitor de Agendamento.

Por intermédio da pasta “Agendamento de Entrega”, no documento de frete, será possível consultar as informações do agendamento de entrega diretamente pelo documento de frete.

• Registro de Ocorrências (TMSA360)

Realiza a atualização automática dos status do Agendamento, ao realizar o apontamento de Ocorrências de Entrega Realizada.

• Demonstrativo de Agendamento (TMSR630):

Foi disponibilizado um relatório com o mapeamento dos agendamentos a serem executados no período selecionado nos parâmetros.

Para verificar a regra utilizada para a posição do agendamento, o sistema verifica o status do movimento da viagem a qual o documento se encontra.

O cálculo do tempo é realizado da seguinte maneira:

(Data Agd.) – (Data Entrega) = Tempo em dias dentro ou fora do prazo.

Caso exista reagendamento o sistema irá verificar o motivo, se for “Cliente” o calculo deverá considerar a data atual do agendamento menos a data de entrega, se for “Transportador” será considerada a data inicial do agendamento menos a data de entrega. 

• Carregamento do Módulo SIGATMS

Serão atualizados, no primeiro acesso do dia ao sistema, todos os agendamentos que não foram atendidos.

• Impressão da DACTE (RTMSR27)

A rotina foi alterada para apresentar as informações do campo Motivo do Agendamento na impressão da DACTE.

No campo Observação do DACTE serão apresentadas as informações referentes ao Agendamento de Entrega, desde que o agendamento tenha sido gerado pela entrada de documentos do cliente.

• Programação de Carregamento (TMSA146)

Trará os documentos que atendam as condições estabelecidas para execução dos documentos agendados.

Na efetivação da programação o sistema verifica se os documentos que o destinatário ou o cliente informado na sequência de endereço (DUL_CODRED+DUL_LOJRED) é participante do agendamento de entrega como “obrigatório” estão agendados.

1. Sim: permite a efetivação da programação.
2. Não: apresenta uma mensagem de Help informando que o destinatário ou o cliente informado na sequência de endereço (DUL_CODRED+DUL_LOJRED) é participante do agendamento de entrega e é necessário realizar o agendamento para o documento. 

Procedimento para Configuração

CONFIGURAÇÃO DE MENUS

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

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

CONFIGURAÇÃO DE MENUS

1. No 

1. Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013).
2. Informe a nova opção de menu

1. do módulo Gestão de Transportes (SIGATMS), conforme instruções a seguir:

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.            No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

O sistema apresenta a janela de produtos cadastrados.

       2.            Posicione o cursor em um produto e clique em Alterar.

       3.            Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

       4.            Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

       5.            Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

                      Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

       6.            Confira os dados e confirme.

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.

Procedimento para Utilização

Componentes de Frete Por Destinatário

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Comercial / Componentes de Frete Por Destinatário (TMSA013).
2. Clique em Incluir.
3. Inclua um Componente de Frete do tipo “TAG” para os clientes e escolha umas das opções de Agendamento de Entrega.
4. Informe um cliente que será participante do agendamento de entrega, determine a vigência do cliente para o componente, determine se o agendamento de entrega deverá ser “Sim”, “Não” ou “Obrigatório”.
5. Confira os dados e confirme.

Tabela de Frete por Destinatário

Para os agendamentos de entrega que serão cobrados uma taxa de entrega do cliente, sera necessário realizar o cadastro de uma tabela de frete por destinatário com o componente de frete por destinatário e o valor.

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Comercial / Tabelas de Frete Por Destinatário (TMSA012).
2. Clique em Incluir.
3. Inclua uma tabela para o componente de frete por destinatário.
4. Informe um cliente e defina o valor de cobrança do componente.

Cadastro de Prioridades de Entrega

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Cadastros / Prioridades de Entrega (TMSA015).

2. Clique em Incluir:

3. Defina uma descrição.

4. Escolha o Tipo de prioridade.

5. Defina os dias.

6. Selecione uma Cor para a prioridade.

7. Confirme a inclusão.

Entrada Documento Cliente

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Recebimento / Entrada Documento do Cliente (TMSA050).
2. Clique em Incluir.
3. Preencha os dados do cabeçalho e informe um destinatário que seja participante do agendamento de entrega, assim os campos pertinentes aos dados do agendamento de entrega serão habilitados para edição.
4. Após preencher os dados do cabeçalho do documento, preencha os dados dos itens da Nota Fiscal, informando os dados do agendamento de entrega pelos campos: Tipo Agend.,Data Agend.,Período,Hr. Ini. Agend.,Hr. Fim. e Agend.Motivo.
5. Ao término do preenchimento dos campos confirme a inclusão da Nota Fiscal do cliente.

Cálculo do Frete

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Recebimento / Cálculo de Frete (TMSA200).
2. Pressione a tecla F12.
3. Clique na opção “Gera Agendamento” e selecione a opção “Sim”. Selecionando esta opção, ao realizar o cálculo do frete será gerado o agendamento de entrega para o documento do cliente, de acordo com os dados informados anteriormente na rotina de Entrada de Documento do Cliente (TMSA050).

Monitor de Agendamento

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Transporte / Monitor Agendamento (TMSA018).
2. Por intermédio desta rotina será possível realizar acompanhamento dos agendamentos de entrega com atualização de Status, inclusão, reagendamento, cancelamento.
3. Clique em Incluir.
4. Preencha os dados do agendamento de entrega.
5. Selecione o documento que será agendado pela opção de pesquisa F3 e confirme.
6. Preencha os demais campos e confirme a inclusão do agendamento de entrega.
7. Após realizar a entrega do documento, ao apontar uma ocorrência do tipo “Encerra Processo”, o status do agendamento de entrega do documento será atualizado para “Realizado” ou “Realizado com Atraso”.
8. A opção “Reagendamento” deverá ser utilizada quando por algum motivo foi determinado que este documento deverá ser entregue em uma nova data, assim o transportador poderá realizar o reagendamento da entrega e o sistema irá gravar um histórico de todos os reagendamentos que foram realizados.
9. A opção “Cancelar, permite realizar um cancelamento de um agendamento de entrega, deixando o documento livre para ser colocado em um novo agendamento.

Viagens Mod.1 / Mod.2 e Programação de Carregamento

1. Por meio das viagens de entrega modelo 1 e modelo 2, serão apresentados os dados de agendamento de entrega para os documentos que possuírem agendamentos.
2. Também serão apresentados alertas ao tentar colocar um documento com agendamento de entrega com data diferente do agendamento.

Demonstrativo de Agendamento

Para gerar um demonstrativo do agendamentos de entrega:

1. Em Gestão de Transportes (SIGATMS) acesse Relatórios / Agendamento de Entrega / Agendamento de Entrega (TMSR630).
2. Preencha os parâmetros.
3. Confirme a geração do relatório. 

Ponto de Entrada

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