Integração TMS

x Cockpit Logístico

- Parte 2

Características do Requisito

Descrição

Integra o módulo de Gestão de Transportes (SIGATMS) com a funcionalidade Programação de Transportes do Cockpit Logístico da Neolog por intermédio de arquivos no formato XML utilizando os Web Services já existentes do Cockpit Logístico, sem transformação de mensagens e sem utilização de sistemas intermediários (TOTVS EAI, TOTVS ESB, etc.).

O Cockpit Logístico é um sistema vertical desenvolvido pela Neolog, empresa do ecossistema TOTVS, que dispõe de módulos para Planejamento da Malha de Distribuição, Programação de Transportes e Monitoramento de Cargas.

Para essa integração serão consideradas as alterações necessárias para que o planejamento de viagens do módulo de Gestão de Transportes (SIGATMS) da linha Microsiga Protheus utilize os recursos da Programação de Transportes do Cockpit Logístico. A Programação de Transportes fará a roteirização e o arranjo das cargas com base na demanda de transportes enviada pelo TMS considerando as configurações das restrições logísticas e as funções-objetivos de otimização registradas no Cockpit Logístico. São exemplos de funções-objetivo: máxima ocupação dos veículos, diminuição dos prazos de entrega e redução da quantidade de viagens. 

Importante

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:

• Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão  11).
• Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
• Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
• Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
• O compatibilizador deve ser executado com a Integridade Referencial desativada*.

1. Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o tmsp11r1 no campo Programa Inicial.
2. Clique em OK para continuar.
3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa TMS11R200().
4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
   1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
   2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
   3. Clique em Gravar para salvar o histórico (log) apresentado.
   4. Clique em OK para encerrar o processamento.

Atualizações do Compatibilizador

1.  

Descreva se há algum procedimento necessário após a aplicação do compatibilizador.

Criação de tabela no arquivo SX2– Tabelas:

Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

1.   Criação de tabela no arquivo SX2– Tabelas:

2.  Criação de Campos no arquivo SX3 – Campos:

• Tabela DJV - Histórico Viagem CPL

• Tabela DJW - Registro de Falhas CPL

• Tabela DJX - Viagem CPL X TMS

• Tabela DJY - Pedidos-itens viagem CPL

• Tabela DJZ - Viagem CPL

• Tabela DUD - Movimento de Viagem

• Tabela DUL(Alteração) -  Movimento de Viagem

3.  Criação  Criação ou Alteração de Índices no arquivo SIX – Índices:

7.  Criação 4.  Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

Procedimento para Configuração

CONFIGURAÇÃO DE MENUS

1. No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013).
2. Informe a nova opção de menu do informe SIGATMS, conforme instruções a seguir:

Procedimento para Utilização

1. Para que seja possível receber as viagens do Cockpit Logístico, é necessário configurar um WebService no appserver Protheus.
2. É recomendado criar um

1. WeService com as seguintes configurações (modificando o arquivo appserver.ini):

;Serviço webserver HTTP
[HTTP]
ENABLE=1
PATH=<Caminho_Cache_imagens>;C:\TOTVS 11\Prottheus\Protheus_data\web
PORT=<porta>;8080
INSTANCES=<nInicio>,<nMaximo>;1,10
SESSIONTIMEOUT=60
INSTANCENAME=WS_HTTP

;URL de resposta
 [<ip ou nome>:<porta>/neolog]
ENABLE=1
PATH=<Caminho_Cache_imagens>;C:\TOTVS 11\Prottheus\Protheus_data\web
ENVIRONMENT=<ambiente>
INSTANCENAME=WS_NEOLOG
RESPONSEJOB=JOB_WS_NEOLOG
DEFAULTPAGE=wsindex.apw
 
;JOB de resposta
[JOB_WS_NEOLOG]
TYPE=WEBEX
ENVIRONMENT=<ambiente>
INSTANCES=<nInicio>,<nMaximo>;1,10
INSTANCENAME=JOB_WS_NEOLOG
ONSTART=TMSXStart ;ponto de inicio obrigatório
ONCONNECT=TMSXConnect ;ponto de inicio obrigatório
TMSPREPAREIN=<empresa>,<filial>;obrigatório
 

3. Para testar o serviço, basta iniciar um navegador e digitar : http://<ip ou nome>:<porta>/neolog/PublishReleasedTrip.APW?WSDL

4. Um WSDL (Descrição do serviço em xml) deve exibir no navegador.

5. Para configurar o envio de viagens do cockpit ao webservice protheus, entre no Cockpit Logístico e vá em Adminsitração -> Integração. Clique na aba 'Fontes de Dados' e clique em 'Inserir'

Digite o código, Descrição e Código da base. Sugestão: PROTHEUS

No campo 'URL' da seção 'Cancelamento de viagem liberada', digite: http://<ip ou nome>:<porta>/neolog/CancelService.APW 

No campo 'Tempo Máximo de Espera por Resposta' coloque o timeout do serviço. Recomendado 30000.

No campo 'URL' da seção 'Execução da viagem', digite: na. 

No campo 'Tempo Máximo de Espera por Resposta' coloque o timeout do serviço. Recomendado 1000.

No campo 'URL' da seção 'Solicitação de Liberação de Viagem', digite: http://<ip ou nome>:<porta>/neolog/PublishReleasedTrip.APW

No campo 'Tempo Máximo de Espera por Resposta' coloque o timeout do serviço. Recomendado 30000.

No campo 'URL' da seção 'Solicitação de reprogramação de Viagem', digite: http://<ip ou nome>:<porta>/neolog/ReprogramService.APW

No campo 'Tempo Máximo de Espera por Resposta' coloque o timeout do serviço. Recomendado 30000.

Clique em Salvar.

Ainda no Cockpit Logístico, vá em Programação -> Análise

Selecione uma viagem pendente de liberação na coluna (S) e clique em 'Liberar'

Se o console do appserver estiver configurado, irá apresentar a mensagem de inicialização do ambiente, indicando que o webservice recebeu a requisição.

Para verificar se a Viagem CPL foi criada, acesse o SIGATMS -> Atualizações -> Cockpit Logístico -> Monitor de Viagens CPL(TMSXCPL2)

Para verificar um histórico dos eventos ocorridos em uma viagem, utilize a ação relacionada 'Cons. Histórico'

Antes de gerar as viagens equivalentes no TMS, verifique a necessidade de corrigir as rotas utilizando a ação 'Alterar'. Na aba 'Rotas x Documentos', possui a relação de viagens e itens de documentos relacionados. No momento que é alterado a rota, o sistema irá avaliar todos os documentos relacionados à aquela futura viagem e utilizando legendas irá apresentar qual o documento não será atendido pela rota. Possuir documentos que não possua rota válida relacionada poderá impedir a sua inclusão na viagem planejada do TMS.

Clique em gerar 'Gerar Viagem' para gerar a viagem do tms. Após gerar a viagem no TMS com sucesso, é enviado a mensagem de liberação ao Cockpit logistico. Acesse a tela Programação -> Análise  e verifique se a viagem foi liberada.

Após a liberação, existe duas ações possível para a viagem: cancelamento ou reprogramação. Ao efetuar a ação, será solicitado ao SIGATMS a exclusão da viagem. Somente após a exclusão no SIGATMS será cancelado/reprogramado com sucesso no Cockpit Logístico.

Vídeo

• Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** Canal do youtube e software de vídeoem definição.

Ponto de Entrada

Exemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

    aCab[4][2]:= 'NF' //Validações do usuário

EndIf

Return aCab