Árvore de páginas

Versões comparadas

Chave

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

...

Produto:

Solucoes_totvs
SolucaoTOTVS Logística TMS


Linha de Produto:

Linhas_totvs
SegmentoDistribuição
RegionConstrução Projetos
LinhaLinha Protheus

Segmento:

Segmentos_totvs
SegmentoLogística

Módulo:TOTVS Logística TMS
Função:

TMSA050.PRW    - Entrada Dc. Cliente 
TMSA141.PRW    - Viagem
TMSA144.PRW    - Viagem Modelo 2
TMSA146.PRW    - Programação de Carregamento
TMSA146A.PRW  - Programação de Carregamento x Planejamento de Rotas (Envio)
TMSA146B.PRW  - Programação de Carregamento x Planejamento de Rotas (Retorno)
TMSA146C.PRW  - Programação de Carregamento x Planejamento de Rotas (Alteração Veiculo)
TMSA153H.PRW - Função genérica
TMSA210.PRW    - Carregamento de Transporte
TMSA310.PRW    - Fechamento da Viagem
TMSA440.PRW    - Cadastro de Solicitante
TMSA450.PRW    - Endereço Solicitante e Cliente
TMSAC18.PRW    - Métodos de Envio - Integração Planejamento de Rotas 
TMSAC19.PRW    - Consulta Planejamento de Rotas 
TMSAC20.PRW    - Configuração Planejamento de Rotas
TMSAC21.PRW   -  Métodos de Retorno - Integração Planejamento de Rotas 
TMSAC23.PRW   - Controle de Integração Planejamento de Rotas 
TMSAC24.PRW   - Montagem e visualização do Mapa
TMSAC25.PRW   - Montagem e visualização do Mapa
TMSAF60.PRW    - Viagem Modelo 3
TMSAF62.PRW    - Validação Viagem Modelo 3
TMSAF68.PRW    - Menu Viagem Modelo 3
TMSAO15.PRW   - Cadastro Referencia Geográfica
TMSAO48.PRW     - Integração Rota Inteligente
TMSAO52.PRW   - Cadastro Roteirizador Rota Inteligente
TMSO46API.PRW - Métodos CallBack Planejamento de Rotas
TMSXFUND.PRW - Função genérica 

index.html - Mapa TPR
tprchannel.js - Mapa TPR

 Ticket:Não se aplica.
Requisito/Story/Issue (informe o requisito relacionado) :


DLOGTMS02-17080 (Epic)
DLOGTMS02-18527 (Epic)


...

A fim de otimizar e reduzir custos das operações de transporte, o módulo Totvs Logística TMS (SIGATMS) integrará com a solução logística de roteirização de carga fornecida pelo Totvs Planejamento de Rotas (TPR), agregando inteligência e otimizando o processo de entregas e coletas dentro do SIGATMS, fazendo com que as coletas/entregas tenham uma melhor disposição e ordem, e dessa maneira além de reduzir o tempo de operação também se reduz custos dentro da operação de transporte.


03. SOLUÇÃO

Foram criadas novas funcionalidades no SIGATMS:

Para atender a solução, foram necessárias novas rotinas para controlar a configuração e gestão das informações entre os sistemas. 
No Totvs Logística TMS (SIGATMS) foram necessárias as ações abaixo:

Criado novo Submenu
- 'Atualizações -> Planejamento de Rotas', onde estarão as novas rotinas:

  • Config. Planejamento de Rotas (TMSAC20);
    Rotina principal para realizar o cadastro e habilitar Configurador Planejamento de Rotas (TMSAC20);
    Rotina principal para realizar o cadastro e habilitar a integração Totvs Planejamento de Rotas (TPR). 
    Painel Planejamento de Rotas (TMSAC19);
    Rotina que armazenará as informações referentes ao envio de informações para a integração Totvs Planejamento de Rotas (TPR). 

  • Controle de Integração Planejamento de Rotas (TMSAC23);
    Rotina que armazenará as informações enviadas e recebidas. Toda a integração é enviado um arquivo no formato JSON e esse arquivo é armazenado na tabela DLU - Controle Integração Roteirizador. 


  • Painel Planejamento de Rotas (TMSAC19);
    Rotina que armazenará as informações referentes ao envio de informações para a integração Totvs Planejamento de Rotas (TPR).

0404DEMAIS INFORMAÇÕES

Informações

Prezado cliente, esta Integração fica disponível de forma nativa somente no Release 12.1.2210 do Protheus conforme Ciclo de Vida de Software - TOTVS Linha Protheus
Caso tenha interesse em adquirir esta solução nas Release 12.1.27 ou 12.1.33 do Protheus, por gentileza entre em contato com nosso suporte solicitando as informações a seguir


  • Para uso desta funcionalidade, se faz necessária atualização do Protheus, de acordo com as informações abaixo:

            UPDDISTR

    • Pacote: 009506  - Para atualização de dicionário de dados, criação/alteração  de campos e índices do módulo SIGATMS;
    • Pacote: 009880 - Para atualização de dicionário de dados, criação/alteração  de campos e índices do módulo SIGATMS;
    • Pacote: 009560 - Para atualização de dicionário de dados, criação/alteração  de campos e índices do módulo SIGAOMS;
    • Pacote: 010930 - Atualização das características do campo DLV_TOKEN  do módulo SIGATMS;

      MENU
    • Atualização do menu sigatms.xnu.

    • PROGRAMAS
      Atualizar o Repositório de objetos do Protheus (RPO) de acordo com a relação de programas relacionados nesta documentação. 

      PARÂMETRO
    • Habilite o parâmetro MV_ROTAINT;

    • CONFIGURAÇÕES REST E WEB SERVICE
      Necessário o ambiente possuir configurações Rest e WebService, de modo a definir os endereços de recebimento dos dados entre os sistemas na nova rotina  Config. Planejamento de Rotas (TMSAC20 - SIGATMS)

    • ARQUIVOS PARA PLOTAGEM DO MAPA
      Instalar os arquivos index.html tprchanenl.js na pasta Web/Ws do Protheus, disponível no link.


Informações
titleDados fornecidos pelo Totvs Planejamento de Rotas



  • DETALHAMENTO DA ATUALIZAÇÃO DE DICIONÁRIO CONFORME ABAS


    Totvs custom tabs box
    tabsDicionário SX2, Dicionário SX3, Dicionário SIX, Dicionário SX1
    idsSX2,SX3,SIX,SX1
    Totvs custom tabs box items
    defaultno
    referenciaSX1

    Grupo- TMSA146TPR

    Pergunta

    TipoTamanhoModoDefinição1Definição2

    Definição3

    Criterio da Capacidade

    Caracter1ComboPesoVolume

    Ambos

    Planejamento paraCaracter1ComboAgoraD+1
    Horario de CarregamentoCaracter5Get


    Considera Retorno p/ FilialCaracter1ComboSimNão
    Qtd Maxima CarregamentosNumerico3Get


    Qtd Maxima DescarregamentosNumerico3Get


    KM Maxima CarregamentosNumerico4Get


    KM Maxima DescarregamentosNumerico4Get


    Tempo Mínimo ServiçoCaracter5Get


    Tempo Máximo ServiçoCaracter5Get

    Para uso desta funcionalidade, deve ser utilizado:

  • Pacote: 009506 - Para atualização de dicionário de dados, criação/alteração  de campos e índices do módulo SIGATMS
  • Pacote: 009560 - Para atualização de dicionário de dados, criação/alteração  de campos e índices do módulo SIGAOMS.
  • Atualize o menu sigatms.xnu.
  • Habilite o parâmetro MV_ROTAINT
  • Documentação Planejamento de Rotas (TPR)
    Token -
     Instalação, configuração e geração do token de acesso no Google Cloud Platform, que é necessário enviar no header para ter acesso aos serviços no Google Cloud Platform - TDN:  https://tdn.totvs.com/x/_1zOJQ

    Integração Planejamento de Rotas - Integrações Planejamento de Rotas
    Geolocalização - Integração de Geolocalização
    Roteirização - Integração de roteirização

    DETALHAMENTO DA ATUALIZAÇÃO DE DICIONÁRIO CONFORME ABAS

    Totvs custom tabs boxtabsDicionário SX2, Dicionário SX3, Dicionário SIX, Dicionário SX1idsSX2,SX3,SIX,SX1



    Totvs custom tabs box items
    default
    no
    yes
    referencia
    SX1
    SX2
    Grupo- TMSA146TPR

    Tabela

    Pergunta

    Descrição

    Tipo

    DMR

    Tamanho

    Roteirização - TPR

    ModoDefinição1Definição2

    Definição3

    Criterio da Capacidade

    Caracter1ComboPesoVolume

    Ambos

    Planejamento paraCaracter1ComboAgoraD+1Horario de CarregamentoCaracter5GetConsidera Retorno p/ FilialCaracter1ComboSimNãoQtd Maxima CarregamentosNumerico3GetQtd Maxima DescarregamentosNumerico3GetKM Maxima CarregamentosNumerico4GetKM Maxima DescarregamentosNumerico4GetTempo Mínimo ServiçoCaracter5GetTempo Máximo ServiçoCaracter5Get Totvs custom tabs box items
    defaultyes
    referenciaSX2

    Tabela

    Descrição

    DMR

    Roteirização - TPR

    DMS

    Itens Roteirização - TPR

    Totvs custom tabs box items
    defaultno
    referenciaSX3
    Tabela DLU - Controle Integração Roteirização

    Campo

    DLU_RETENV

    Tipo

    Memo

    DMS

    Itens Roteirização - TPR

    Totvs custom tabs box items
    defaultno
    referenciaSX3


    Tabela DLU - Controle Integração Roteirização

    Campo

    DLU_RETENV

    Tipo

    Memo

    Tamanho

    50

    Decimal

    0

    Formato


    Título

    Retorno Post

    Descrição

    Retorno do Envio do Post

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Opções


    When


    Relação


    Val. Sistema


    Help

    Nesse campo deve ser armazenado o JSON que retorna referente ao primeiro envio e/ou requisição.



    DLV- Cadastro Roteirizador

    Campo

    DLV_AUTH

    Tipo

    Caractere

    Tamanho

    50

    Decimal

    0

    Formato


    Título

    Authorizatio

    Descrição

    Chave de Autorização

    Usado

    Sim

    Obrigatório

    Sim

    Browse

    Não

    Opções


    When


    Relação


    Val. Sistema


    Help

    Nesse campo deve ser informado a chave do Planejamento de Rotas (TPR)



    Campo

    DLV_ROTERI

    Tipo

    Caractere

    Tamanho

    18

    Tamanho

    50

    Decimal

    0

    Formato

    @!

    Título

    Retorno Post

    Roteirizador

    Descrição

    Retorno do Envio do Post

    Roteirizador

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Opções

    1=Maplink;2=Planejamento Rotas (TPR)

    Não

    Opções

    When


    Relação


    Val. Sistema

    Pertence('12')

    Help

    Nesse campo deve ser armazenado o JSON que retorna referente ao primeiro envio e/ou requisição.

    Define o tipo de integração:

    1=Maplink;

    2=Planejamento Rotas (TPR)



    Campo

    DLV_TOKEN

    Tipo

    Caractere

    Tamanho

    254



    Campo

    DLV_URLCAL

    Tipo

    Caractere

    Tamanho

    80

    DLV- Cadastro Roteirizador



    Campo

    DLV_

    AUTH

    URLGEO

    Tipo

    Caractere

    Tamanho

    50

    254

    Decimal

    0

    Formato

    @!

    Título

    Authorizatio

    URL Geocode

    Descrição

    Chave de Autorização

    URL da Geolocalização

    Usado

    Sim

    Obrigatório

    Sim

    Não

    Browse

    Não

    Opções


    When


    Relação


    Val. Sistema


    Help

    Nesse campo deve ser informado a chave do Planejamento de Rotas (TPR)

    Informe a URL da Geolocalização



    Campo

    DLV_

    ROTERI

    URLROT

    Tipo

    Caractere

    Tamanho

    18

    254

    Decimal

    0

    Formato

    @!

    Título

    Roteirizador

    URL Roteriza

    Descrição

    Roteirizador

    URL da Roteirização

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Opções

    1=Maplink;2=Planejamento Rotas (TPR)


    When


    Relação


    Val. Sistema

    Pertence('12')


    Help

    Informe a URL da Geolocalização



    Campo

    DLV_URLTK

    Tipo

    Caractere

    Tamanho

    254

    Decimal

    0

    Formato

    @!

    Título

    URL Token

    Descrição

    URL Token

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Opções


    When


    Relação


    Val. Sistema


    Help

    Informe a URL da Geolocalização

    Help

    Define o tipo de integração:

    1=Maplink;

    2=Planejamento Rotas (TPR)

    Campo

    DLV_TOKEN

    Tipo

    Caractere

    Tamanho

    254

    Campo

    DLV_URLCAL

    Tipo

    Caractere

    Tamanho

    80



    Campo

    DLV_

    URLGEO

    TMPEXP

    Tipo

    Caractere

    Tamanho

    254

    5

    Decimal

    0

    Formato

    @!
    @R 999:99

    Título

    URL Geocode

    Tempo Exp.

    Descrição

    URL da Geolocalização

    Tempo de Expiração

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Opções


    When

    TMSAC20Whe()

    Relação


    Val. Sistema

    TMSAC20Vld()

    Help

    Informe a URL da Geolocalização

    Tempo de expiração para o cancelamento automático das Roteirizações Pendentes.                      O cancelamento será efetuado considerando a Data de Envio da Roteirização (DLU_DATENV e DLU_HORENV

    Campo

    DLV_

    URLROT

    ROTA

    Tipo

    Caractere

    Tamanho

    254

    6

    Decimal

    0

    Formato

    @!

    Título

    URL Roteriza

    Rota

    Descrição

    URL da Roteirização

    Rota de Entrega

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Opções


    When

    TMSAC20Whe()

    Relação


    Val. Sistema

    Vazio() .Or. TMSAC20Vld()

    Help

    Informe

    a URL da Geolocalização

    uma Rota do Tipo de Transporte Rodoviário e Serviço de Transporte de Entrega, que será utilizado na geração da Programação de Carregamento.

    Campo

    DLV_

    URLTK

    DESROT

    Tipo

    Caractere

    Tamanho

    254

    30

    Decimal

    0

    Formato

    @!

    Título

    URL Token

    Praça Princ.

    Descrição

    URL Token

    Praça Principal

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Opções


    When


    Relação

    IF(!INCLUI,POSICIONE("DA8",1,XFILIAL("DA8")+DLV->DLV_ROTA,"DA8_DESC"),"")

    Val. Sistema


    Help

    Informe

    Indica a

    URL

    Praça Principal da

    Geolocalização

    Rota


    DMR - Roteirização TPR

    Campo

    DMR_FILIAL

    Tipo

    Caractere

    Tamanho

    2

    Decimal

    0

    Formato

    @!

    Título

    Filial

    Descrição

    Filial do Sistema

    Usado

    Não

    Obrigatório


    Browse

    Sim

    Opções


    When


    Relação


    Val. Sistema


    Help

    Indica a Filial do Sistema



    Campo

    DMR_FILROT

    Tipo

    Caractere

    Tamanho

    2

    Decimal

    0

    Formato

    @!

    Título

    Fil. Roteir.

    Descrição

    Filial Roteirização

    Usado

    Sim

    Obrigatório

    Sim

    Browse

    Sim

    Opções


    When


    Relação


    Val. Sistema


    Help

    Filial do Identificador da Roteirização



    Campo

    DMR_IDROT

    Tipo

    Caractere

    Tamanho

    9

    Decimal

    0

    Formato

    @!

    Título

    Id.Roteir.

    Descrição

    Id. Roteirização

    Usado

    Sim

    Obrigatório

    Sim

    Browse

    Sim

    Opções


    When


    Relação

    GetSx8Num("DMR","DMR_IDROT")

    Val. Sistema


    Help

    Identificador da Roteirização da Integração com o Planejamento de Rotas (TPR)



    Campo

    DMR_STATUS

    Tipo

    Caractere

    Tamanho

    1

    Decimal

    0

    Formato


    Título

    Status

    Descrição

    Status

    Usado

    Sim

    Obrigatório

    Sim

    Browse

    Não

    Opções

    1=Pendente;2=Processado;3=Cancelado

    When


    Relação

    '1'

    Val. Sistema

    Pertence('123')

    Help

    Status da Roteirização da Integração com o Planejamento de Rotas (TPR)



    DMS - Itens Roteirização TPR

    Campo

    DMS_FILIAL

    Tipo

    Caractere

    Tamanho

    2

    Decimal

    0

    Formato

    @!

    Título

    Filial

    Descrição

    Filial do Sistema

    Usado

    Não

    Obrigatório


    Browse

    Sim

    Opções


    When


    Relação


    Val. Sistema


    Help

    Indica a Filial do Sistema



    Campo

    DMS_FILROT

    Tipo

    Caractere

    Tamanho

    2

    Decimal

    0

    Formato

    @!

    Título

    Fil.Roteir.

    Descrição

    Filial Roteirização

    Usado

    Não

    Obrigatório


    Browse

    Sim

    Opções


    When


    Relação


    Val. Sistema


    Help

    Filial do Identificador da Roteirização



    Campo

    DMS_IDROT

    Tipo

    Caractere

    Tamanho

    9

    Decimal

    0

    Formato

    @!

    Título

    Id.Roteir.

    Descrição

    Id. Roteirização

    Usado

    Não

    Obrigatório


    Browse


    Opções


    When


    Relação


    Val. Sistema


    Help

    Identificador da Roteirização da Integração com o Planejamento de Rotas (TPR)



    Campo

    DMS_ITEM

    Tipo

    Caractere

    Tamanho

    6

    Decimal

    0

    Formato

    @!

    Título

    Item

    Descrição

    Item

    Usado

    Sim

    Obrigatório

    Sim

    Browse

    Sim

    Opções


    When


    Relação


    Val. Sistema


    Help

    Identifica o item da roteirização



    Campo

    DMS_ENTIDA

    Tipo

    Caractere

    Tamanho

    3

    Decimal

    0

    Formato

    @!

    Título

    Entidade

    Descrição

    Entidade

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Sim

    Opções


    When


    Relação


    Val. Sistema


    Help

    Indica a Entidade do Documento.



    Campo

    DMS_INDENT

    Tipo

    Caractere

    Tamanho

    1

    Decimal

    0

    Formato

    @!

    Título

    Indice Entid.

    Descrição

    Indice Entidade

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Sim

    Opções


    When


    Relação


    Val. Sistema


    Help

    Indica o Indice da Entidade a ser utilizado para a pesquisa da Chave da Entidade 



    Campo

    DMS_CHVENT

    Tipo

    Caractere

    Tamanho

    200

    Decimal

    0

    Formato

    @!

    Título

    Chave Entid.

    Descrição

    Chave Entidade

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Sim

    Opções


    When


    Relação


    Val. Sistema


    Help

    Chave que contem os dados do Documento integrados ao Planejamento de Rotas (TPR)



    Campo

    DMS_INDEXT

    Tipo

    Caractere

    Tamanho

    1

    Decimal

    0

    Formato

    @!

    Título

    Ind.Chv.Ext

    Descrição

    Indice Chave Externa

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Sim

    Opções


    When


    Relação


    Val. Sistema


    Help

    Indica o Indice da Entidade a ser utilizado para a pesquisa da Chave Externa



    Campo

    DMS_ENTEXT

    Tipo

    Caractere

    Tamanho

    3

    Decimal

    0

    Formato

    @!

    Título

    Ent.Chv.Ext

    Descrição

    Entidade Chave Externa

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Sim

    Opções


    When


    Relação


    Val. Sistema


    Help

    Indica a Entidade da Chave Externa



    Campo

    DMS_CHVEXT

    Tipo

    Caractere

    Tamanho

    30

    Decimal

    0

    Formato

    @!

    Título

    Chv. Externa

    Descrição

    Chave Externa

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Sim

    Opções


    When


    Relação


    Val. Sistema


    Help

    Identifica o registro gerado na Integração Protheus x Planejamento de Rotas (TPR)

    Exemplo: Módulo SIGATMS, caso a integração tenha sido realizada pela rotina de Programação de Carregamento, neste campo irá constar o Nro da Programação que o Documento foi vinculado.

    (Filial + Fil.Prog + Nro Prog + Seq.Prog)



    Campo

    DMS_STATUS

    Tipo

    Caractere

    Tamanho

    1

    Decimal

    0

    Formato

    @!

    Título

    Status

    Descrição

    Status

    Usado

    Sim

    Obrigatório

    Sim

    Browse

    Não

    Opções

    1=Pendente;2=Rejeitado;3=Processado;4=Falha no Processamento

    When


    Relação

    '1'

    Val. Sistema

    Pertence("12345")

    Help

    Identifica o status do Documento para Roteirização

    1-Pendente - Enviado para o TPR e aguardando retorno.

    2-Rejeitado - Documento rejeitado pelo TPR.

    3-Processado - Documento processado no TPR com sucesso.

    4- Falha no Processamento - Ocorreu uma falha de processamento do Documento no Protheus.

    5- Cancelado



    Campo

    DMS_MSGERR

    Tipo

    Memo

    Tamanho

    50

    Decimal

    0

    Formato


    Título

    Msg. Erro

    Descrição

    Mensagem Erro

    Usado

    Sim

    Obrigatório


    Browse

    Não

    Opções


    When


    Relação


    Val. Sistema


    Help

    Mensagem de erro recebida pelo Roteirizador do referido documento



    Tabela DA3 - Veículos 
    ** O campo abaixo consta no pacote de dicionários 009560 - SIGAOMS

    Campo

    DA3_VELOC

    Tipo

    Numérico

    Tamanho

    6

    Decimal

    0

    Formato

    @E 999,999

    Título

    Veloc Máxima

    Descrição

    Velocidade Máxima

    Usado

    Sim

    Obrigatório

    Não

    Browse

    Não

    Opções


    When


    Relação


    Val. Sistema


    Help

    Informar a velocidade máxima que o veículo pode percorrer

    Totvs custom tabs box items
    defaultno
    referenciaSIX

    Criação de índices:

    DMR

    Índice

    Ordem

    ChaveDescrição
    DMR1DMR_FILIAL+DMR_FILROT+DMR_IDROTFil.Roteir. + Id.Roteir.


    DMS

    Índice

    Ordem

    ChaveDescrição
    DMS1DMS_FILIAL+DMS_FILROT+DMS_IDROT+DMS_ITEMFil.Roteir. + Id.Roteir. + Item
    DMS2DMS_FILIAL+DMS_ENTIDA+DMS_CHVENT+DMS_STATUS+DMS_FILROT+DMS_IDROTEntidade + Chave Entid + Status + Fil.Roteir. + Id.Roteir.
    DMS3DMS_FILIAL+DMS_ENTEXT+DMS_CHVEXTEnt.Chv.Ext + Chave Externa
    DMS4DMS_FILIAL+DMS_FILROT+DMS_IDROT+DMS_CHVENT+DMS_ENTIDAFil.Roteir. + Id.Roteir. + Chave Entid + Entidade

05. ASSUNTOS RELACIONADOS


Templatedocumentos


HTML
<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;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>