Linha Microsiga Protheus

Árvore de páginas

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ção

OMSXCPL1 

Carga de Dados, possibilita o envio dos cadastros em lote.

OMSXCPL2

Envio Documentos, permite selecionar e enviar as demandas de transporte para otimização

TMSXCPL1

Compatibilizador do Dicionário de Dados

TMS11R200

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

Requisito (ISSUE):

LOGTMS01-66

País(es):

Brasil

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

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.


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

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. 

    2. Talvez seja necessário verificar e configurar um Proxy de Internet no Protheus, dependendo das configurações de rede. 

    3. 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. Selecione 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 da rotina permite apenas que os registros da filial em que o usuário está logado sejam enviados ao Cockpit Logístico.

  7. Após o processamento, clique em Sair para finalizar a rotina.

  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, assinale o(s) documento(s) desejado(s) na opção ao lado esquerdo ou utilize as Ações Relacionadas/Outas 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.