Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 4

changes.mady.by.user Siegklenes Rolland Beulke

Gravado em

comparado com

Nova versão 5

changes.mady.by.user Siegklenes Rolland Beulke

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Integração TMS X Cockpit Logístico Iteração 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 DadosTMS11R197

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): 

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.14 e , 12.1.8 e superiores

 

 

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 TMS11R197 é 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 nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
  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 xxxx().
  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

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

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

Pergunte

Grupo

OrdemNomeTipo Tamanho

TMSXCPL1

TMSXCPL101Data Previsão Entrega De Dias da emissão ?DN83
  02Data Previsão Entrega Até Dias para entrega  ?DN83
  03Data Emissão De Previsão não informada ?DN81

 

 

04Data Emissão Até Previsão com atraso ?DN81

 

 

05Coleta ?N1

 

 

06Transporte ?N1

 

 07

Entrega ?

N1
  08 Entrega Agendada ? N 1 



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

Nome da Variável

TipoDescriçãoValor Padrão

MV_CPLCLI

C

Integrar Clientes On Line? 1=Sim;2=Não2

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_CPLPROCIntegrar Produtos On Line? 1=Sim;2=Não2
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_CPLTPVCIntegrar Tipos de Veículo On Line? 1=Sim;2=Não2
MV_CPLURLCEndereço do webservice do Cockpit Logístico 

 

 

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.