Integração TMS X Cockpit Logístico parte 1

Características do Requisito

Linha de Produto:

Microsiga Protheus

Segmento:

Distribuição e Logística

Módulo:

SIGATMS/SIGAOMS

Rotina:

Rotina

Nome Técnico

Canal de comunicação com do Protheus com o Webservice do Cockpit Logístico

OMSXCPL 

Parâmetros de integração, disponibiliza para edição dos usuários os parâmetros (SX6) usados na integraçãoOMSXCPL1 
Carga de Dados, possibilita o envio dos cadastros em lote.OMSXCPL2
Envio Documentos, permite selecionar e enviar as demandas de transporte para otimizaçãoTMSXCPL1
Compatibilizador do Dicionário de DadosTMS11R200

Cadastros Iniciais:

Cadastro de empresas/filiais(SM0)

Cadastro de clientes(SA1)

Cadastro de produtos(SB1/SB5)

Cadastro de Tipo de Veículo(DUT)

Documentos de Transporte(DT6/DTC) 


Parâmetro(s):

MV_CPLINT, MV_CPLURL, MV_CPLREG, MV_CPLEMB, MV_CPLINV, MV_CPLIDS, MV_CPLCLI, MV_CPLPRO, MV_CPLTPV, MV_CPLCAT, MV_CPLTP1, MV_CPLTP2, MV_CPLTP3

Ponto de Entrada:

 

Chamados relacionados

 

Requisito (ISSUE):PCREQ-8085

País(es):

Todos

Banco(s) de Dados:

Todos

Tabelas utilizadas:

SM0, SA1, SB1, SB5, DUT, DT6, DTC

Sistema(s) operacional(is):

Todos

Versões/Release:

11.80.20

 

 

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

A integração com o Cockpit Logístico foi liberado em fases. Este documento técnico trata da utilização das funcionalidades liberadas na fase 1. Para detalhes sobre a integração, consulte o documento de referência Manual de Integração TMS X NEOLOG.

 

Importante

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

Antes de executar o 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*.

 

Atenção

O procedimento a seguir deve ser realizado por um profissional   qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

A ativação indevida da Integridade Referencial pode alterar   drasticamente o relacionamento entre tabelas no banco de dados. Portanto,   antes de utilizá-la, observe atentamente os procedimentos a seguir:

  1. No   Configurador (SIGACFG), veja se a empresa utiliza Integridade   Referencial, selecionando a opção Integridade/Verificação   (APCFG60A).
  2. Se não   há Integridade Referencial ativa,   são relacionadas em uma nova janela todas as empresas e filiais cadastradas   para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário   qualquer outro procedimento de ativação   ou desativação de integridade, basta finalizar a verificação e aplicar   normalmente o compatibilizador, conforme instruções.
  3.  Se há Integridade Referencial ativa   em todas as empresas e filiais, é   exibida uma mensagem na janela Verificação   de relacionamento entre tabelas. Confirme a mensagem para que a   verificação seja concluída, ou;
  4.  Se   há Integridade Referencial ativa   em uma ou mais empresas, que não   na sua totalidade, são relacionadas em uma nova janela todas as empresas e   filiais cadastradas para o sistema e, somente, a(s) que possui(em)   integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou   filial(is) possui(em) a integridade ativada e reserve esta anotação para   posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework   para informações quanto a um arquivo que contém essa informação).
  5. Nestes   casos descritos nos itens “iii” ou   “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
  6.  Quando desativada a Integridade Referencial,   execute o compatibilizador, conforme instruções.
  7. Aplicado o compatibilizador, a Integridade   Referencial deve ser reativada, SE E   SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as   informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da   integridade, selecione-a(s) novamente e confirme a ativação.

 

Contate o Help Desk Framework EM CASO DE DÚVIDAS!

 

  1. Em Microsiga Protheus TOTVS Smart Client (se versão 10) ou ByYou Smart Client (se versão 11), digite informe 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.

 

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

Atualizações do Compatibilizador

  1. Criação de Perguntas no arquivo SX1 – Cadastro de Perguntes:

Pergunte

Grupo

OrdemNomeTipo Tamanho

TMSXCPL1

TMSXCPL101Tipo de Transporte ?        C1
  02Serviços de Transporte ?    C5
  03Tipos de documento ?        C60

 

 

04Data Emissão De ?           D8

 

 

05Data Emissão Ate ?          D8

 

 

06Cliente Remente De ?        C6

 

 07

Loja Remente De ?           

C2
  08Cliente Remente Até ?       C6
  09Loja Remente Até ?          C2
  10Cliente Destinatario De ?   C6
  11Loja Destinatario De ?      C2
  12

Cliente Destinatario Até ?  

C6
  13Loja Destinatario Até ?     C2
  14Região Origem De ?          C6
  15Região Origem Até ?         C6
  16Região Destino De ?         C6
  17Região Destino Até ?        C6
  18Filiais Origem ?            C2
  19Filiais Destino ?           C2



2.  Criação de Parâmetros no arquivo SX6 – Parâmetros:

Nome da Variável

TipoDescriçãoValor Padrão

MV_CPLEMB

CEmbarcador enviado para o Cockpit Logistico 
MV_CPLINTCHabilita integração com o Cockpit Logístico.2
MV_CPLIDSCOrigem dos DadosPROTHEUS
MV_CPLINVCCódigo do invólucro dos itens 
MV_CPLCATCCategoria de Produto? 1=Grupo Produto;2=Padrão Cockpit2
MV_CPLREGCRegional enviada para o Cockpit Logístico 
MV_CPLTP1CTipo Pedido Coleta 
MV_CPLTP2CTipo Pedido Transporte 
MV_CPLTP3CTipo Pedido Entrega 
MV_CPLURLCEndereço do webservice do Cockpit Logístico 
MV_CPLENTCConsiderar entregar em vez de transferir? 1=Sim;2=Não2

 

 

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu). 

CONFIGURAÇÃO DE MENUS

 

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

Menu

Submenu

Nome da RotinaProgramaMóduloTipo

Atualizações

Cockpit Logístico

Param IntegraçãoOMSXCPL1SIGAOMSRotina Protheus

Atualizações

Cockpit Logístico

Carga de DadosOMSXCPL2SIGAOMSRotina Protheus

Atualizações

Cockpit Logístico

Envio DocumentosTMSXCPL1SIGATMSRotina Protheus

 

 

Procedimento para Utilização

 

  1. Em SIGATMS/SIGAOMS, acesse Atualizações / Cockpit Logístico / Param Integração (OMSXCPL1).
  2. Preencha os parâmetros conforme instruções do Manual de Integração TMS X NEOLOG
  3. Utilize as ações relacionadas/outras ações para testar o webservice
    1. No caso de aparecer a mensagem "Não foi possível conectar no WebService.", cole a URL em algum navegador de internet e verifique se o webservice está acessível. Talvez seja necessário verificar configurar um Proxy de Internet no Protheus, dependendo das configurações de rede. Para configurar o proxy, acesse o módulo Configurador(SIGACFG) > Ambiente > E-mail / Proxy > Configurar e siga as instruções na tela.
  4. Clique em confirmar para gravar os parâmetros.
  5. Acesse Atualizações / Cockpit Logístico / Carga de Dados (OMSXCPL2).
  6. Marque os cadastros desejados e clique em processar.
    1. Se desejar, posicione na lista de cadastros o item e utilize o botão "Filtro" para aplicar um filtro de seleção de registros na tabela.
    2. O filtro padrão do programa só permite que registros da filial em que o usuário está logado seja enviado ao Cockpit Logístico.
  7. Após o processamento, clique em Sair para finalizar o programa.
  8. Confira no Log do Cockpit Logístico se houve algum problema na integração dos registros.
  9. Acesse Atualizações / Cockpit Logístico / Envio Documentos (TMSXCPL1)
  10. Preencha os campos do pergunte apresentado conforme o desejo do usuário para pré-seleção de documentos.
  11. Após confirmar o pergunte, confira os documentos na lista.
    1. Pode-se utilizar a opção filtrar para aprimorar ainda mais a seleção de registros.
  12. Após isso, marque o(s) documento(s) desejado(s) na opção ao lado esquerdo ou utilize as ações relacionadas/outras ações-> Marcar/Desmarcar Todos para selecionar os documentos que serão enviados.
  13. Por fim, utilize as ações relacionadas/outras ações->Enviar Cockpit Logístico para confirmar o envio dos documentos ao Cockpit Logístico.
  14. Confira no Log do Cockpit Logístico se houve algum problema na integração dos registros.