Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

01. DADOS GERAIS

Produto:

TOTVS Varejo Supermercados WMS

Linha de Produto:

Linha Consinco

Segmento:

Varejo

Módulo:Agendamento
Função:Agendamento Web
País:Brasil
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :


02. SITUAÇÃO/REQUISITO

Identificada a necessidade de implementar novo módulo para realizar Agendamento de Entregas, através da plataforma Web, com os seguintes recursos:

  • Possibilidade de Utilizar o Agendamento com integração com o TOTVS Varejo Supermercados WMS e qualquer outro WMS ou ERP
  • Realizar Agendamento de Entregas Centralizado, ou por Filial (Empresa);
  • Realizar Agendamento por Capacidade de Descarga Diária (Peso e Volume);
  • Realizar Agendamento por Tipo de Carga por Box/Doca;
  • Realizar Agendamento por Pedido de Compra, XML / Documento Fiscal ou Avulso;
  • Realizar Agendamentos Emergênciais;
  • Realizar Agendamento verificando Criticas de Advertência ou Bloqueio do Agendamento;
  • Realizar Pré-Agendamento pelo setor Comercial e confirmação da Agenda pelo setor de Logística;
  • Realizar Pré-Agendamento pelo Fornecedor (Site), confirmação da Agenda pelo setor de Logística;
  • Alterações de Agendamento (Antecipação / Prorrogação / Cancelamento);
  • Cancelamento automático de Pré-Agendamentos não confirmados;

03. SOLUÇÃO       

Para ser possível utilizar o novo Agendamento Web, é necessário seguir o passo a passo abaixo:

Configurações e Cadastros

1. Parâmetro TOTVS Varejo Supermercados WMS

Em WMS Parâmetros > Parâmetro > Geral  marque o parâmetro Utiliza Agendamento Web.

Image Added                                               

CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
  3. Tela XXX
    1. Outras Ações / Ações relacionadas
  4. Tela XXX
    1. Principais Campos e Parâmetros
  5. Tabelas utilizadas

01. VISÃO GERAL

Demonstrar o passo a passo de como Parametrizar e Implantar o Agendamento Web.

02. EXEMPLO DE UTILIZAÇÃO

        Pré-requisitos e restrições

        Ter publicado através da ferramenta PublicaWeb o site do Agendamento Web.

        Agendamento Web

Image RemovedImagem 1 - Agendamento Web - Login  

        Passo a Passo

        1. Parametrização                       Agendamento > Configurações > Parâmetro

Image Removed

 

...

        1.1. Implantação         Iremos demonstrar como é realizada a Implantação do Agendamento Web.         Na parte superior da tela  parametrizar as opções: Tamanho da Janela, Utiliza Advertência Personalizada, Envia E-mail Para Fornecedor Após Agendamento, Cancelar Pré-Agendamentos Automaticamente, Dias Antes para Cancelamento, detalhes de cada uma dessas opções efuncionalidades são explicadas na documentação Parâmetro - AGE0002.         

Image RemovedImagem 3 - Parâmetro - Parte Superior da Tela

       

...

Image Removed

   

...

       

...

 

...

       

...

 

...

       Imagem 1 - WMS Parâmetros


2. Parâmetro TOTVS Varejo Supermercados Comercial

...

Em

Parâmetros > Parâmetros > Empresa

...

marque o parâmetro Utiliza Agendamento Web, dessa forma os dados referentes a Fornecedor, Nota Fiscal, Pedido de Compra e Transportadora serão integradas do ERP, ou seja, os fornecedores, notas fiscais, pedidos de compras e transportadoras existentes no ERP serão integrados ao Agendamento Web.

        Mais detalhes das opções acima consultar a documentação Parâmetro - AGE0002.

        O próximo passo será clicar no botão Image RemovedSalvar e depois no botão Image Removed Implantação para que o sistema efetive as integrações conforme opções acima parametrizadas.    

        Nota:  informações não integradas serão exibidas na aplicação Críticas de Integração  

        1.2. Janelas de Entregas

                                           Image Added                                                                                                                                                            

Imagem 2 - Parâmetros


3. Implantação            

Para iniciar a utilização do Agendamento Web será necessário realizar a implantação inicial do processo em Agendamento > Configurações > Parâmetro, clique aqui e consulte o passo a passo da aplicação Parâmetro.

Nota: Informações não integradas serão exibidas na aplicação Críticas de Integração,clique aqui e consulte o passo a passo da aplicação Críticas de Integração.


4. Parâmetros Gerais

Realizar a parâmetrização para as integrações em Agendamento > Configurações > Parâmetros Gerais, clique aqui e consulte o passo a passo da aplicação Parâmetros Gerais.


5. Cadastros

Utilizando a integração TOTVS, as aplicações abaixo serão utilizadas apenas para consulta. Caso utilize a integração diferente de TOTVS, então será necessário realizar os cadastros das mesmas:

Image Added

Imagem 3 - Configurações

Para acessar as documentações das aplicações de configurações, clique no link corrrespondente:

Notas: 

6. Janelas de Entregas

        Após ter realizado a Implantação será necessário, na própria aplicação Parâmetros  , na parte inferior da tela, gerar para os boxes os Intervalos de Janelas de Entregas (Horários de entrega) para os boxes.

Imagem 5 4 - Parâmetro - Janelas de Entregas

        Será exibido abaixo o passo a passo  de como criar um Intervalo de Janelas para os boxes e dias da semana:

    • Tipo de Carga: Ao selecionar um tipo de carga será exibido no grupo Box os boxes existentes;
    • Box: Ao selecionar um box será exibido os dias da semana no Grupo Dia da Semana; 
    • Grupo Dia da Semana: Ao selecionar um dia da semana será habilitado as opções Adicionar Período, Replicar Períodos, Adicionar Restrição e Replicar Restrição;
    • Adicionar Período: Ao clicar no mesmo será habilitado os campo Início, Fim e Emergência;
    • Início: Informar o primeiro horário de entrega do box, em tal dia e para tal tipo de carga (no exemplo estamos informando que o primeiro horário de entrega para o box1 nas segundas-feiras para o tipo de carga paletizada será as 06:00h);
    • Fim: Informar um horário acima do último horário de entrega do box, em tal dia e para tal tipo de carga (no exemplo estamos informando que o último horário de entrega para o box1 nas segundas-feiras para o tipo de carga paletizada será na última janela próxima às 18:00h);
    • Emergência: Informar se as janelas (horários ) de entregas serão do tipo Emergência ou não, se selecionar a opção ‘Sim' as janelas serão geradas com tipo Emergência e
      para realizar algum agendamento nessas janelas será necessária liberação através de usuário e senha devidamente parametrizado com permissão especial AUTORIZACAOAGENDEMERGENCIAL (clique aqui e consulte o passo a passo da aplicação Permissões Especiais - AGE0014).       
    •  Image Modified Inserir: Após realizar as parametrizações acima clicar no botão Image Modified Inserir em seguida clicar no botão Image ModifiedSalvar, digamos digamos que a opção Tamanho da Janela esteja parametrizada com a opção 60, após procedimento acima será criado para todas as segundas-feiras para o box 01 e tipo de carga paletizada, intervalos de janelas da seguinte maneira: primeira janela 06:00h, segunda janela as 07:00h, terceira as 08:00h e assim sucessivamente e nesse exemplo a última janela seria as 17:00h.

        Mais detalhes consultar Parâmetro - AGE0002.

       

        1.3. 7. Replicar Períodos

 Imagem 6 5 - Parâmetro - Replicar Períodos 

        Após ter criado um intervalo de entrega, se clicar novamente no Tipo de Carga Paletizada (seguindo o exemplo criado no ponto 1.2), no Box 01 e no dia Segunda-Feira (Imagem 5 4 - Parâmetro - Janelas de Entregas) será exibido o intervalo salvo e se clicar na opção Replicar Períodos será possível replicar esse intervalo salvo para outros dias da semana, para outros boxes e para outros tipos de carga. No exemplo abaixo estamos replicando a janela que fora criado anteriormente para outros dias da semana e box 01.

        É possível para um mesmo intervalo parametrizar mais de um tipo de carga, por exemplo: para box 01, segunda-feira e intervalo entre 06:00 e 18:00 parametrizar os tipos de carga paletizada, batida, e outras que existirem na empresa, dessa forma para esses intervalos será possível agendar entregas de qualquer um dos tipos de carga, mas será possível agendar somente uma entrega por janela, ou seja, ao salvar um agendamento para um intervalo não será mais possível para esse mesmo intervalo agendar outro tipo de carga, digamos que foi realizado um agendamento com tipo de carga paletizada para o box 01, janela 07:00h da segunda-feira, para essa janela dia e box não será possível realizar outro agendamento para outro tipo de carga, pois só é possível um agendamento por janela.

        Mais detalhes consultar Parâmetro - AGE0002.


        1.4. 8. Adicionar Restrição

   Imagem 7 6 - Parâmetro - Adicionar Restrição 

            Ainda na aplicação Parâmetro (Imagem 5 - Parâmetro - Janelas de Entregas) se clicar na opção  Adicionar  Adicionar Restrição será possível restringir os intervalos das janelas.

    • Medida de Restrição: por Peso, Volume ou Palete, ou seja, será possível determinar qual peso máximo, qual volume máximo e quantidade de paletes máximas um box ou janela (horário) do box pode receber. 
    • Tipo de Restrição: Dia (a restrição será realizada ao atingir o peso, volume ou paletes máximo do box) ou Janela (a restrição será realizada ao atingir o peso, volume ou paletes máximo da janela selecionada);
    • Quantidade: quantidade máxima permitida da opção selecionada em Medida de Restrição;

        Se parametrizar uma restrição com Medida de Restrição por Volume e Tipo de Restrição igual a Janela com Quantidade 10, o sistema observará o Volume por Janela do box, na janela 06:00, por exemplo, não poderá realizar um Agendamento com um Pedido de Compra ou Nota Fiscal que ultrapasse 10 volumes. 

        Caso parametrizar Caso parametrizar uma restrição com Medida de Restrição por Volume e Tipo de Restrição igual a Dia com Quantidade 10, o sistema observará o Volume por Box do Dia, será realizado cálculos somando os volumes das janelas do dia para esse box e dia, digamos que para o dia 10/10/25 e box 01 já exista um agendamento salvo na janela 07:00 e cujo volume desse agendamento tenha sido 7, para esse dia e box só será possível agendar mais 3 volumes. 

        Essas parametrizações são opcionais e caso utilize algum desses tipos de restrições (poderá usar mais de uma medida de restrição, ou seja, poderá restringir uma janela ou box por peso, volume e palete e nesse caso se alguma dessas medidas for ultrapassada será necessário liberação mediante usuario e senha) e no momento de realizar um agendamento ultrapassar uma das parametrizações realizadas só será possível realizar o agendamento com liberação de um usuário e senha devidamente parametrizado com permissão especial DESBLOQUEIORESTRICAO(, clique aqui e consulte o passo a passo da aplicação Permissões Especiais - AGE0014). 

        Mais detalhes consultar Parâmetro - AGE0002.


        1.5. 9. Replicar Restrição

        Na aplicação Parâmetro (Imagem 5 4 - Parâmetro - Janelas de Entregas) se clicar na opção opção  Replicar Restrição será possível replicar restrições existentes para intervalos de outros tipos de carga, box e dia existentes, mais detalhes consultar Parâmetro - AGE0002.

Imagem 8 7 - Parâmetro - Replicar RestriçãoRestrição       

        2. Tipo de Agendamento

        Agendamento > Configurações > Parâmetros Gerais 

...

Agendamento Web

 Tendo

Image Removed

Imagem 9 - Parâmetros Gerais 

        3. Agendamento

        Tendo realizado os procedimentos acima, a aplicação Agendamento estará pronta para ser usada, sendo possível realizar agendamentos de três formas, sendo:

  • Pedido de Compra: ao selecionar essa opção, será listado pelo sistema os pedidos de compras integrados para que dessa forma possa ser possível gerar uma entrega com um ou mais pedidos;
  • Nota Fiscal: quando o XML de uma Nota Fiscal for integrado com o sistema, já será possível realizar uma entrega dessa nota fiscal;
  • Avulsa: com essa opção será possível gerar uma entrega para determinado Fornecedor sem precisar informar um Pedido de Compra ou Nota Fiscal.

        Na aplicação Agendamento serão exibidos os pré-agendamentos gerados, e dessa forma um responsável do setor de Logística irá confirmar, alterar ou excluir os mesmos.

        Aplicação Agendamento explicada com detalhes na documentação Agendamento - AGE0001.

Image Removed

        Imagem 10 - Agendamento

,clique aqui e consulte o passo a passo da aplicação Agendamento.

...

Pré-agendamento

        

        Assim que um Pedido de Compra for integrado será possível pelo setor Comercial realizar um pré-agendamento desse pedido de compra para uma data específica, esse pré-agendamento será visualizado na aplicação Agendamento pelo setor de Logística onde um responsável irá confirmar, alterar ou excluir esse pré-agendamento. 

Os pré-agendamentos podem ser realizados de duas formas:        

  • Interno: realizado pelo Comercial do cliente pela aplicação Pré-agendamento,

...

...

  • .

...

  • Externo: realizado pelo fornecedor do cliente através de um site externo (corp) disponibilizado pelo cliente ao

...

  • fornecedor, onde nesse site o fornecedor terá acesso a uma aplicação de Pré-agendamento para que dessa forma possa realizar um pré-agendamento, esse pré-agendamento será visualizado na aplicação

...

  • Agendamento

...

  • pelo setor de Logística cabendo a um responsável confirmar, alterar ou excluir esse pré-agendamento

...

  • .

           Nota: Para utilizar o site externo é necessário implantação da estrutura de Web Corp.
   

Após confirmação o Fornecedor conseguirá visualizar a data e horário agendado pelo setor de Logística. 

        Pela aplicação Pré-Agendamento será possível realizar um pré-agendamento somente por Pedido de Compra.

       

03. TELA Parâmetros

        Outras Ações / Ações relacionadas

        Não há.

04. TELA Parâmetros

   

10. Permissões Especiais e Validação de Senha

O Agendamento Web possui operações que, por envolverem exceções às regras parametrizadas, exigem autorização especial por meio de senha.
Essas autorizações são utilizadas para permitir, de forma controlada, agendamentos que ultrapassam limites ou condições previamente estabelecidas nas parametrizações.

Para utilização dessas permissões é necessário realizar as configurações adequadas na aplicação Permissões Especiais, além de manter o cadastro de usuários atualizado.

...

10.1. Requisitos para Validação

Para que um usuário possa autorizar operações especiais, é necessário:

  • Usuário cadastrado com senha ativa.

  • Permissão especial configurada na aplicação Agendamento > Configurações > Permissões Especiais.

  • Vínculo entre usuário, empresa e tipo de permissão.

Sem esses requisitos, o sistema não permitirá a autorização, mesmo que a senha informada esteja correta.

...

10.2. Situações que Exigem Validação de Senha

O sistema realiza validação de senha em três situações distintas, descritas a seguir.

...

10.2.1. Desbloqueio de Restrição

Conforme descrito no item 8 – Adicionar Restrição, é possível parametrizar limites de capacidade para os boxes, tanto por dia quanto por janela de entrega, utilizando:

  • Peso máximo (por dia ou por janela)

  • Volume máximo (por dia ou por janela)

  • Quantidade de paletes máxima (por dia ou por janela)

Comportamento do Sistema

Ao tentar realizar um agendamento, o sistema verifica automaticamente:

  1. A soma dos agendamentos já existentes para o box, dia e/ou janela.

  2. O limite parametrizado.

  3. A quantidade informada no novo agendamento.

Se o total ultrapassar o limite, o sistema exibirá uma tela solicitando autorização com senha.

Exemplo Prático

  • Limite configurado: 50 paletes por dia

  • Agendamentos existentes: 30 paletes

  • Novo agendamento: 25 paletes

  • Total: 55 paletes, ultrapassando o limite configurado

→ O sistema solicitará usuário e senha com permissão DESBLOQUEIORESTRICAO.

Permissão Necessária

  • DESBLOQUEIORESTRICAO

Configuração Necessária

Na aplicação Permissões Especiais, selecione a permissão DESBLOQUEIORESTRICAO e vincule os usuários autorizados por empresa.

...

10.2.2. Autorização de Agendamento Emergencial

Conforme descrito no item 6 – Janelas de Entregas, ao criar intervalos de janelas é possível marcar o campo Emergência = Sim.
Janelas emergenciais somente podem ser utilizadas mediante autorização especial.

Comportamento do Sistema

Ao tentar realizar um agendamento dentro de um horário marcado como emergencial, o sistema exibirá a tela de autorização, mesmo que:

  • O box tenha capacidade disponível

  • Não existam outras restrições configuradas

A autorização é obrigatória sempre que o horário pertencer a uma janela emergencial.

Exemplo Prático

  • Janela emergencial configurada: 18:00 às 20:00

  • Usuário tenta agendar entrega às 19:00

→ O sistema solicitará usuário e senha com permissão AUTORIZACAOAGENDEMERGENCIAL.

Permissão Necessária

  • AUTORIZACAOAGENDEMERGENCIAL

Configuração Necessária

Na aplicação Permissões Especiais, selecione a permissão AUTORIZACAOAGENDEMERGENCIAL e vincule os usuários autorizados por empresa.

...

10.2.3. Desbloqueio de Crítica Personalizada

O Agendamento Web permite configurar críticas personalizadas, baseadas em regras de negócio específicas de cada empresa.
Essas críticas podem gerar advertência ou bloqueio, dependendo da configuração.

A utilização dessas críticas depende da habilitação da opção Utiliza Advertência Personalizada em:

  • Agendamento > Configurações > Parâmetro

Comportamento do Sistema

Ao salvar um agendamento, o sistema verifica as regras personalizadas definidas. Essas regras podem estar relacionadas, por exemplo, a:

  • Limite máximo de paletes por entrega

  • Peso total excedente

  • Falta de transportadora

  • Regras específicas por fornecedor, horário ou tipo de carga

Cada regra retorna:

  • Advertência (A) → apenas exibe aviso

  • Bloqueio (B) → exige autorização com senha

Exemplo Prático

  • Regra configurada: Bloquear entregas acima de 100 paletes

  • Usuário tenta agendar entrega com 150 paletes

→ O sistema exibirá a mensagem de bloqueio e solicitará usuário e senha com permissão DESBLOQUEIOCRITICAPERSONAL.

Permissão Necessária

  • DESBLOQUEIOCRITICAPERSONAL

Configuração Necessária

  1. Em Parâmetro, habilitar Utiliza Advertência Personalizada = Sim

  2. Em Permissões Especiais, vincular usuários à permissão DESBLOQUEIOCRITICAPERSONAL

Observação: As regras de advertência personalizada são configuradas pela área técnica da empresa no banco de dados Oracle (AGEV_ADVERTENCIAPERSONALIZADA), conforme necessidade do cliente.

...

10.3. Funcionamento da Validação

Quando uma das situações acima ocorre no momento do agendamento, o sistema executa o seguinte fluxo:

  1. Detecta a necessidade de autorização especial

  2. Exibe tela solicitando:

    • Código do usuário autorizador

    • Senha do usuário autorizador

  3. Valida:

    • Se o usuário possui a permissão necessária

    • Se a senha está correta

  4. Resultado:

    • Autorizado → o sistema salva o agendamento

    • Não autorizado → o sistema exibe mensagem e bloqueia a operação

...

10.4. Mensagens do Sistema

Durante o processo de autorização, podem ser exibidas as seguintes mensagens:

  • "Senha incorreta"
    Quando a senha informada não confere com a senha cadastrada do usuário.

  • "O usuário não possui permissão"
    Quando o usuário informado não possui a permissão especial para a empresa.

  • "Senha não informada"
    Quando o campo senha é deixado em branco.

...

10.5. Permissões Simultâneas

É possível que mais de uma validação seja acionada no mesmo agendamento.
Por exemplo:

  • Agendamento em janela emergencial

  • Que ultrapassa restrição de paletes por dia

  • E ainda viola crítica personalizada

Nesses casos, o sistema solicitará validações separadas para cada situação identificada, podendo exigir usuários diferentes conforme configuração.

...

10.6. Auditoria e Rastreabilidade

Todas as autorizações realizadas são registradas no sistema, permitindo:

  • Identificar qual usuário autorizou

  • Data e hora

  • Tipo da permissão utilizada

  • Empresa relacionada

Essa rastreabilidade é fundamental para auditoria e controle operacional.

04. DEMAIS INFORMAÇÕES

...

Não há.

05. 

...

ASSUNTOS RELACIONADOS

Não há.

06. DOCUMENTAÇÃO DE VERSÕES E ATUALIZAÇÕES

Clique para expandir

Expandir
titleInovação

...