Árvore de páginas

01. DADOS GERAIS

Linha de Produto:Microsiga Protheus
Segmento:Supply Chain - Logística
Módulo:TOTVS Logística TMS

Função:

OMSA040 - Cadastro de Motoristas

TMSAC10 - Configurações Check-List

TMSAC11 - Classe Conexão Check-List

TMSAE71 - Monitor Comprovante de Entrega

TMSAE81 - Retorno Check-List

TMSA310 - Fechamento de Viagem

TMSA350 - Apontamento de Operações

TMSA360 - Registro de Ocorrências

TMSXFUNH - Biblioteca de Funções

Requisito/Story/Issue (informe o requisito relacionado) :

DLOGTMS02-10444:  Criação de configuração do Meu Check-List.

DLOGTMS02-10445: Classe de Conexão com Meu Check-List.

DLOGTMS02-10446: Função para Busca dos Executores.

DLOGTMS02-10447: Tratar Ocorrência de Transbordo para o CheckList.

DLOGTMS02-10578: Criação de Ponto de Entrada (TME81MNT ) na recepção do CheckList.


02. 
SITUAÇÃO/REQUISITO

Integra o módulo de Gestão de Transportes (SIGATMS) com a funcionalidade Meu Checklist, utilizando Métodos Rest já existentes do Meu Checklist, sem transformação de mensagens e sem utilização de sistemas intermediários (TOTVS EAI, TOTVS ESB, etc.).


Para essa funcionalidade serão consideradas as alterações necessárias para que ocorra corretamente a integração entre o módulo de Gestão de Transportes (SIGATMS) da linha Microsiga Protheus e o aplicativo Meu Checklist, após a configuração acertada a integração ocorrerá entre as rotinas: Ocorrência Automática (TMSA360), Comprovante de Entrega (TMSAE71) e o Aplicativo Meu Checklist.

A integração proporciona:


Otimização: evita a utilização de papel, proporciona a utilização de recursos mobile.
Comprovação: registrar fotos dos comprovantes/canhotos dos CT-es das entregas realizadas, utilizando-se dos recursos da câmera do celular do motorista.
Despreocupação: execute checklists sem preocupações com a interoperabilidade dos recursos de 3G/4G ou wi-fi e sincronize suas tarefas em background.
Previsão: delegue e execute checklists sem a necessidade de interação entre as duas pontas.
Avaliação: controle, confira e execute avaliações sobre itens classificados como não conformes.
Acompanhamento: acompanhe o processo de execução de checklist tendo em mãos indicadores gerenciais.
Certifique-se: tenha rastreabilidade via GPS e garanta a credibilidade da vistoria.

Adequações necessárias:

· Para que o Módulo Gestão de Transportes (SIGATMS) possa atender ao novo requisito será necessário que os processos estejam funcionais (previamente configurados):

a. Rotina de Ocorrência Automática;
b. Rotina de Apontamento do Comprovante de Entrega (processo manual, sem a integração);
c. Acesso e configuração no Portal Meu Checklist;

03. SOLUÇÃO

Implementada a rotina para integração entre Checklist, rotina de Ocorrência de Entrega Automática e Comprovante Entrega, a partir da nova rotina de Configurações CheckList (TMSAC10), onde neste cadastro serão informados dados como filial para integração, URL's responsáveis pela conexão da integração, usuário e senha autorizados a validar e alterar dados no Portal Checklist, entre outras informações. Esses registros serão vinculados a nova tabela criada (DLZ).                   

Implementada a rotina Busca Check List (TMSAE81) que buscará através do Job previamente configurado as atualizações do Meu Checklist para o ambiente módulo de Gestão de Transportes (SIGATMS) da linha Microsiga Protheus.         

04. DEMAIS INFORMAÇÕES

Para uso desta funcionalidade, deve ser utilizado:

1. TSS (Totvs Service Soa), URL's e Schemas atualizados, últimos pacotes disponíveis no Portal do Cliente.

2. Dicionários de dados para atualização das tabelas DLZ e DM0, atualização de menus e parâmetros;
Pacote de atualização 007343;

Atualização do Menu do TMS

Atualize o menu do Protheus TMS baixando somente o arquivo sigatms.xnu conforme o seu ambiente: 

A atualização de menu irá cadastrar os novos programas de menu:

Rotina

Menu

TMSAE81

Busca Checklist

TMSAE71Monitor Comprovante de Entrega
TMSAC10 Configurações Check-List

Criação de Tabelas/Campos no arquivo SX3 – Campos:

  • Tabela DLZ - Configurações Checklist

Campo

DLZ_FILIAL

Tipo

Caractere

Tamanho

8

Decimal

0

Formato


Título

Filial

Descrição

Filial do Sistema

Usado

Não

Obrigatório

Não

Browse

Sim

Opções


When


Relação


Val. Sistema


Help

Informe a filial do sistema.

Campo

DLZ_SEQUEN

Tipo

Caractere

Tamanho

6

Decimal

0

Formato

@!

Título

Cód. Sequen

Descrição

Código Sequencial

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação

GETSXENUM( "DLZ", "DLZ_SEQUEN" )

Val. Sistema

NaoVazio()

Help

Código sequencial de controle do Meu Checklist.

Campo

DLZ_ID

Tipo

Caractere

Tamanho

30

Decimal

0

Formato


Título

Client ID

Descrição

Client ID

Usado

Sim

Obrigatório

Não

Browse

Sim

Opções


When


Relação


Val. Sistema


Help

Indica o identificador utilizado para obtenção do token do Check List.

Campo

DLZ_SECRET

Tipo

Caractere

Tamanho

20

Decimal

0

Formato


Título

Client Secre

Descrição

Client Secre

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Indica a senha para busca do Token do Check List.

Campo

DLZ_TENANT

Tipo

Caractere

Tamanho

50

Decimal

0

Formato


Título

Tenant

Descrição

Tenant

Usado

Sim

Obrigatório

Não

Browse

Sim

Opções


When


Relação


Val. Sistema


Help

Indica o tenant para conexão com o Check List.

Campo

DLZ_URLTOK

Tipo

Caractere

Tamanho

80

Decimal

0

Formato


Título

URL Token

Descrição

URL Conexão Token

Usado

Sim

Obrigatório

Não

Browse

Sim

Opções


When


Relação


Val. Sistema


Help

Indica a URL para conexão e busca do Token do Check List.

Campo

DLZ_URLCHK

Tipo

Caractere

Tamanho

80

Decimal

0

Formato


Título

URL CHK

Descrição

URL Conexão Check List

Usado

Sim

Obrigatório

Não

Browse

Sim

Opções


When


Relação


Val. Sistema


Help

Indica a URL para conexão com o Check List.

Campo

DLZ_USER

Tipo

Caractere

Tamanho

30

Decimal

0

Formato


Título

E-mail

Descrição

E-mail do usuário

Usado

Sim

Obrigatório

Não

Browse

Sim

Opções


When


Relação


Val. Sistema

IsEmail(M->DLZ_USER)

Help

Informe o e-mail do usuário cadastrado.

Campo

DLZ_PASSW

Tipo

Caractere

Tamanho

30

Decimal

0

Formato


Título

Senha

Descrição

Senha Usuário

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Informe a senha do usuário cadastrado para realizar a integração com o app Meu Check-list.

Campo

DLZ_MSBLQL

Tipo

Caractere

Tamanho

1

Decimal

0

Formato

@!

Título

Bloqueado?

Descrição

Bloqueado?

Usado

Sim

Obrigatório

Não

Browse

Sim

Opções


When


Relação

"2"

Val. Sistema

Pertence("12")

Help

Campo do Protheus que indica se o registro está bloqueado ou não.

Campo

DLZ_TOKEN

Tipo

Memo

Tamanho

50

Decimal

0

Formato


Título

Token

Descrição

Token de Acesso

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Token utilizado na integração com Meu CheckList

Campo

DLZ_DTTOKE

Tipo

Data

Tamanho

8

Decimal

0

Formato


Título

Data Token

Descrição

Data Token

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Data do envio do token.

Campo

DLZ_HRTOKE

Tipo

Caracter

Tamanho

8

Decimal

0

Formato

99:99:99

Título

Hr. Token

Descrição

Hr. Token

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Hora de envio do token.

Campo

DLZ_EXPIRE

Tipo

Numérico

Tamanho

6

Decimal

0

Formato

@E 999,999

Título

Duração Toke

Descrição

Duração Token - segundos

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Duração do token em segundos.

Campo

DLZ_URLIMG

Tipo

Caracter

Tamanho

80

Decimal

0

Formato


Título

URL Imagem

Descrição

URL Imagem

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Indica a URL para busca das imagens do check list.
  • Criação de Parâmetros no arquivo SX6 – Parâmetros:

Nome da Variável

TipoDescriçãoValor Padrão
MV_TMAPCKLLHabilita Integração Compr. Entrega com aplicação do Checklist.  .F.
MV_TMINTEV CTMS evento de integraçao. Define o momento em que é realizada a integração com APP´s Externos.  


CONFIGURAÇÃO DE MENUS

Ambientes/Cadastro/Menu (CFGX013):

Menu

Submenu

Nome da RotinaProgramaMóduloTipo

Atualizações

Ocorrências

Configurações ChecklistTMSAC10SIGATMSRotina Protheus


3. Dicionários de dados complementar para atualização das tabelas DLY e DA4;
Pacote de atualização 006673;

Neste pacote foram criados campos adicionais na tabela DLY, listados abaixo:

Campo

DLY_STATUS

Tipo

Caracter

Tamanho

1

Decimal

0

Formato

@!

Título

Status

Descrição

Status

Usado

Sim

Obrigatório

Não

Browse

Não

Opções

0=Integrado;1=Não Apto;2=Apto;3=Transmitido;4=Autorizado;5=Rejeitado

When


Relação

"1"

Val. Sistema

Pertence("012345")

Help

Status 

Campo

DLY_IDINTG

Tipo

Caracter

Tamanho

80

Decimal

0

Formato

@!

Título

IDintegracao

Descrição

IDintegracao

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

ID da Integração

Campo

DLY_FIMINT

Tipo

Caracter

Tamanho

30

Decimal

0

Formato


Título

Dat Fim Int

Descrição

Dat Fim Integração

Usado

Não

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Data fim da Integração

Campo

DLY_FILDOC

Tipo

Caracter

Tamanho

8

Decimal

0

Formato


Título

Fil Docto

Descrição

Filial do Documento

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Filial do Documento

Campo

DLY_DOC

Tipo

Caracter

Tamanho

9

Decimal

0

Formato

@!

Título

Num Docto

Descrição

Numero do Documento

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Numero do Documento

Campo

DLY_SERIE

Tipo

Caracter

Tamanho

3

Decimal

0

Formato


Título

Ser Docto

Descrição

Serie do Documento

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Serie do Documento


4. Pacote de atualização das rotinas - TMSAE71 - Monitor/Editor Comprovante de Entrega, TMSXFUNH - Funções Genéricas e TMSA360 - Registro de Ocorrências de acordo com release;

05. ASSUNTOS RELACIONADOS