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:
Atualização de menu com dicionário no banco: Atualização de menus que estão no Banco de Dados
Atualização de menu sem dicionário no banco: Atualizar menus dos módulos
A atualização de menu irá cadastrar os novos programas de menu:
Rotina | Menu |
---|---|
TMSAE81 | Busca Checklist |
TMSAE71 | Monitor 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 | |
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 | Tipo | Descrição | Valor Padrão |
MV_TMAPCKL | L | Habilita Integração Compr. Entrega com aplicação do Checklist. | .F. |
MV_TMINTEV | C | TMS 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 Rotina | Programa | Módulo | Tipo |
Atualizações | Ocorrências | Configurações Checklist | TMSAC10 | SIGATMS | Rotina 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
- Documento de Referência da Integração
- Configurações CheckList (TMSAC10 - SIGATMS)
- Automação do Apontamento de Ocorrências (TMSA360 - SIGATMS)
- Comprovante de Entrega Eletrônico (TMSAE71 - SIGATMS)
- Schedule Vínculo de Imagem
- Parâmetros SIGATMS