Árvore de páginas

Versões comparadas

Chave

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

...

A fim de otimizar e reduzir custos das operações de transporte, o módulo Gestão de Transportes (SIGATMS) integrará com a solução logística de roteirização de carga fornecida pelo 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, além da obtenção prévia dos valores de pedágio.


03. SOLUÇÃO


Implementado a integração do SIGATMS x Planejamento de Rotas a pr
O módulo SIGATMS passa a utilizar as APIs fornecidas pelo Planejamento de Rotas (TPR) para solucionar os problemas de ordem de entrega/coleta, melhor trajeto a ser realizado considerando o menor tempo ou menor distância, valores das praças de pedágio, plotagem e visualização do trajeto, coordenadas geográficas dos clientes.

...

  • Configurador Planejamento de Rotas (TMSAC20);
    Rotina principal para realizar o cadastro e habilitar a integração Totvs Planejamento de Rotas (TPR). 
    Nessa funcionalidade deverão ser informadas as chaves de acesso disponibilizadas e também os endereços virtuais (IP) referente a integração. 
    A rotina 
     irá armazenar as informações referentes ao Totvs Planejamento de Rotas na tabela DLV - Cadastro Roteirizador

  • Consulta 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).
    Nessa funcionalidade será possível consultar e verificar o status das Roteirizações e também quais os Documentos e/ou Notas Fiscais enviados e que estão pendente, processado, rejeitado ou cancelado.
    As 
    informações serão registradas nas tabelas DMR - Roteirização TPR DMS - Itens Roteirização TPR e para cada roteirização iremos ter um identificador único que ficará registrado no campo Id. Roteiriza - DMR_IDROT.

  • 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 Roterizador. 
    Parametrização:

...



04. DEMAIS INFORMAÇÕES

  • 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.
    • 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 box
        tabsDicionário SX2, Dicionário SX3, Dicionário SIX
        idsSX2,SX3,SIX
        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

        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

        Decimal

        0

        Formato

        @!

        Título

        Roteirizador

        Descrição

        Roteirizador

        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

        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

        Tipo

        Caractere

        Tamanho

        254

        Decimal

        0

        Formato

        @!

        Título

        URL Geocode

        Descrição

        URL da Geolocalização

        Usado

        Sim

        Obrigatório

        Não

        Browse

        Não

        Opções


        When


        Relação


        Val. Sistema


        Help

        Informe a URL da Geolocalização



        Campo

        DLV_URLROT

        Tipo

        Caractere

        Tamanho

        254

        Decimal

        0

        Formato

        @!

        Título

        URL Roteriza

        Descrição

        URL da Roteirização

        Usado

        Sim

        Obrigatório

        Não

        Browse

        Não

        Opções


        When


        Relação


        Val. Sistema


        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


        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

        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

...