Configuração das Integrações (TMSAI80 - SIGATMS)

CONTEÚDO

01. VISÃO GERAL

A rotina de Configuração das Integrações trata-se de um centralizador de integrações. Além disso, na rotina é possível validar os token's de cada integração cadastrada.

Neste momento as integrações disponíveis para cadastro são:

• TMS x Coleta Entrega;
• TMS x Meu Checklist;
• OMS x Coleta Entrega;
• Faturamento Protheus x Coleta Entrega;
• TMS x Portal Logístico;
• TMS x YMS;
• TMS x Agendamento;
• TMS x Here.

02. TELAS DA ROTINA

Nesta rotina, apenas um cadastro ativo poderá ser cadastrado, para cada tipo de integração.

*Clique na imagem para ampliar e visualizar corretamente.

A divisão dos cadastros de integrações disponíveis para o Módulo TMS neste momento ocorrerá em abas: 

1. CHECKLIST 

2. COLETA ENTREGA

3. PORTAL LOGÍSTICO

Em cada uma destas abas, poderá haver apenas um item ativo para cada URL de Conexão inserida.

*Clique na imagem para ampliar e visualizar corretamente.

CAMPOS CABEÇALHO 

• Código -  Indica a filial do sistema.   Indica a filial do sistema.  
• Descrição - Indica a descrição da configuração de integração.
• Ativo - Indica a situação do registro. São aceitos 1=Sim e 2=Não. 
• Cód. Módulo - Indica o código do módulo da configuração. 
• Sigla Módulo -  Indica a sigla do módulo da configuração.
  
  

CAMPOS CHECKLIST

• Sequência -  Código Sequencial.
• Client ID   - Indica o identificador utilizado para obtenção do token do CheckList.
• Client Secre - Indica a senha para busca do Token do CheckList.
• Tenant  - Indica o tenant para conexão com o CheckList.
• URL Token - Indica a URL para conexão e busca do Token do CheckList.
• URL CHK  - Indica a URL para conexão com o Check List.
• E-mail  - Informe o e-mail do usuário cadastrado.    
• Senha   -  Informe a senha do usuário cadastrado para realizar a integração com o app Meu CheckList.   
• Bloqueado? -  Campo do Protheus que indica se o registro está bloqueado ou não.
• Token - Token utilizado na integração com Meu CheckList.     
• Data Token - Data do envio do token.
• Hr. Token   - Duração do token em segundos.
• Duração Toke - Duração do token em segundos.
• URL Imagem  - Indica a URL para busca das imagens do CheckList.
• Roteiro Col - Roteiro da Coleta.
• Roteiro Ent - Roteiro da Entrega.
• Cod Config   -  Indica o código da configuração de integração.   
• Cod Fonte  -  Indica o código da fonte de integração.        
• Descr Fonte - Exibe a descrição da fonte de integração. 
  
  

CAMPOS COLETA ENTREGA x TMS

• Filial - Indica a filial do sistema. 
• Cod Config -  Indica o código da configuração.
• Sequência - Indica a sequência da configuração. 
• Client ID -  Indica o ID do Client para conexão.
• Client Secre -  Indica a senha para conexão do client. 
• Tenant -  Indica o tenant para conexão.
• URL Token  - Indica a URL para busca do Token.  
• URL Col/Ent -   Indica a URL para conexão com o Coleta/Entrega.
• Usuário -  Indica o usuário de conexão.   
• Senha -  Indica a senha para conexão do client.
• Token - Indica a chave do token para acesso ao sistema externo.  
• Data Token -  Indica a data de busca do token.  
• Hora Token - Indica a hora de busca do token.   
• Vencto Token - Indica o tempo de expiração do token.
• Bloqueado? - Indica se o registro está bloqueado. Somente será aceito um registro ativo.   
• Envio Reg - Indica o momento de envio dos registros à gestão de entregas. São aceitos 1=Fechamento da Viagem ou 2=Operação de Saída.  

• Bsc E Real -  Busca Entrega Realizada. Indica o momento de busca das entregas realizadas. São aceitos 1=Motorista, 2=Supervisor ou 3=Encerramento.
  

  Atualmente, está apto para utilização no campo Bsc E Real  as opções : 2=Supervisor ou 3=Encerramento. 

  A opção 1 = Motorista, ainda está em planejamento para futuro desenvolvimento (ainda indisponível neste momento).

• Ocor Entrega - Ocorrência de Entrega.    
• Desc Oco Rea - Descrição Ocorrência Realizada.
• Oco NEnt Fec - Ocorrência Não Entrega Fechado.

• Desc N Fec - Descrição Não Entrega Fechado.   
  

  Importante:

  O campo abaixo ainda está em planejamento para futuro desenvolvimento (ainda indisponíveis neste momento): 

  • Bus Ent N Re - Busca Entrega Não Realizada.  Indica o momento de busca das entregas não realizadas. São aceitos 1=Motorista, 2=Supervisor ou 3=Encerramento.

  Os campos abaixo ainda estão em planejamento para futuro desenvolvimento (ainda indisponíveis neste momento),  para a integração das ocorrências de tipo: 

  06 - Gera pendência - Tipo = Falta;

  06 - Gera pendência - Tipo = Avaria;

  06 - Gera pendência - Tipo = Retorno Documento Cliente;

  04 - Retorna Documento -  Tipo = Demais tipo de retorno.

  • Oco NEnt Ava - Ocorrência Não Entrega Avaria. 
  • Desc N Ava - Descrição Não Entrega Avaria.    
  • Oco NEnt Fal - Ocorrência Não Entrega Falta.   
  • Desc N Fal - Descrição Não Entrega Falta.     
  • Oco NEnt Rec - Ocorrência Não Entrega Recusa.   
  • Desc N Rec - Ocorrência Não Entrega Recusa.   
  • Oco NEnt Out - Ocorrência Não Entrega Outros.  
  • Desc N Out - Descrição Não Entrega Outros.   
• Cod Fonte - Código da Fontes.         
• Descr Fonte -Descrição da Fonte.       
• Ocor Coleta - Ocorrência de Coleta.
• Desc Col Rea - Descrição de Coleta Realizada. 
• Oco Col NEfe - Ocorrência Coleta Não Efetuada.
• Desc Col NEf - Descrição Coleta Não Entrega.
  

Importante:  O campo abaixo esta na tabela DN1 (Config Integr Coleta/Entrega), porém, é de uso exclusivo do Módulo SIGAOMS. 

Para mais detalhes acesse a documentação de integração deste Módulo.

• Forma Integr - Indica a forma de integração do OMS com o Coleta/Entrega. São aceitos 1=JOB, 2=Manual e 3=Automático. O JOB necessita de configuração do schedule, o manual depende de ação do usuário, e o automático será acionado ao final da geração do histórico.  
  

CAMPOS COLETA ENTREGA x OMS

• Filial do Sistema  - Indica a filial do sistema. 
• Código da Configuração -  Indica o código da configuração.
• Sequência  - Indica a sequência da configuração. 
• Client ID -  Indica o ID do Client para conexão.
• Client Secret -  Indica a senha para conexão do client. 
• Tenant -  Indica o tenant para conexão.
• URL Token  - Indica a URL para busca do Token.  
• URL Col/Ent -   Indica a URL para conexão com o Coleta/Entrega.
• Usuário -  Indica o usuário de conexão.   
• Senha -  Indica a senha para conexão do client.
• Token - Indica a chave do token para acesso ao sistema externo.  
• Data Token -  Indica a data de busca do token.  
• Hora Token - Indica a hora de busca do token.   
• Vencto Token - Indica o tempo de expiração do token.
• Bloqueado? - Indica se o registro está bloqueado. Somente será aceito um registro ativo.   
• Código da Fonte - Código da Fontes.         
• Descrição da Fonte - Descrição da Fonte.
• Forma de Integração - Forma de Integração  (Manual ou Automática).

CAMPOS COLETA ENTREGA x FAT

• Filial do Sistema  - Indica a filial do sistema. 
• Código da Configuração -  Indica o código da configuração.
• Sequência  - Indica a sequência da configuração. 
• Client ID -  Indica o ID do Client para conexão.
• Client Secret -  Indica a senha para conexão do client. 
• Tenant -  Indica o tenant para conexão.
• URL Token  - Indica a URL para busca do Token.  
• URL Col/Ent -   Indica a URL para conexão com o Coleta/Entrega.
• Usuário -  Indica o usuário de conexão.   
• Senha -  Indica a senha para conexão do client.
• Token - Indica a chave do token para acesso ao sistema externo.  
• Data Token -  Indica a data de busca do token.  
• Hora Token - Indica a hora de busca do token.   
• Vencto Token - Indica o tempo de expiração do token.
• Bloqueado? - Indica se o registro está bloqueado. Somente será aceito um registro ativo.   
• Código da Fonte - Código da Fontes.         
• Descrição da Fonte - Descrição da Fonte. 
• Envio NFs Veículo - Indica se serão enviadas as notas fiscais sem veículo. 
• Grava Histórico - Indica se serão enviadas as notas fiscais sem veículo.
• Envia Portal - Indica se serão enviadas as notas fiscais sem veículo. 
  
  

CAMPOS PORTAL LOGISTICO

• Filial do Sistema  - Indica a filial do sistema. 
• Código da Configuração -  Indica o código da configuração.
• Sequência  - Indica a sequência da configuração. 
• Client ID -  Indica o ID do Client para conexão.
• Client Secret -  Indica a senha para conexão do client. 
• Tenant -  Indica o tenant para conexão.
• URL Token  - Indica a URL para busca do Token.  
• URL Portal Logístico -   Indica a URL para conexão com o Portal Logístico.
• Usuário -  Indica o usuário de conexão.   
• Senha -  Indica a senha para conexão do client.
• Token - Indica a chave do token para acesso ao sistema externo.  
• Data Token -  Indica a data de busca do token.  
• Hora Token - Indica a hora de busca do token.   
• Vencto Token - Indica o tempo de expiração do token.
• Bloqueado? - Indica se o registro está bloqueado. Somente será aceito um registro ativo.   
• Código da Fonte - Código da Fontes.         
• Descrição da Fonte - Descrição da Fonte. 

03. TESTAR INTEGRAÇÕES / TOKEN

Ao término do cadastro dos dados/informações na rotina Configuração das Integrações (TMSAI80 - SIGATMS), ou na alteração de dados, utilizando a opção/botão Outras Ações é disponibilizado a opção de Teste Token.

O processo é similar ao processo de teste token da integração predecessora TMS x Meu Checklist.

*Clique na imagem para ampliar e visualizar corretamente.

No caso de retorno positivo uma mensagem com hash do token será apresentada (exemplo imagem abaixo).

No caso de divergência, inconsistência, ou erro no retorno, um help/alerta será apresentado.

*Clique na imagem para ampliar e visualizar corretamente.

4. TABELAS UTILIZADAS

• DLZ - Configurações do Check List; 
• DN0 - Configuração das Integrações;
• DN1 - Config Integr Coleta/Entrega.
• DND -  Config. Integração Portal Logístico
• DNM - Conf Integr TMS x Here
• DNS - Config. Integr. YMS SAAS
• DNT - Config. Integr. Agendamento SAAS

05. ASSUNTOS RELACIONADOS

• Integração Coleta Entrega (SIGATMS)

• Fontes de Integração (TMSAI81 - SIGATMS)
• Filiais de Integração (TMSAI85 - SIGATMS)

• Layouts de Integrações (TMSAI82 - SIGATMS)

• Chaves Protheus e Portal (TMSAI83 - SIGATMS)

• Histórico de Integrações (TMSAI84 - SIGATMS)

• Exporta e Importa Layout (TMSAI88A / TMSAI88B - SIGATMS)

• JOBS: Envio e Retorno (TMSAI86 / TMSAI87 - SIGATMS)
• Cadastros de Motoristas - Integração SIGATMS x Coleta Entrega (OMSA040 - SIGATMS)
• Exemplos de Utilização - Viagens Integradas SIGATMS x Coleta Entrega (SIGATMS)
• Pontos de Entrada da Integração (SIGATMS)
• Melhorias na Integração TMS x Coleta Entrega (SIGATMS)