Histórico da Página

Pickup

Image Modified 1. Contexto de Negócio (Introdução)

Com a crescente demanda por otimização nos processos logísticos de distribuição na busca por um melhor aproveitamento dos veículos, tanto na questão de carregamento quanto na roteirização das entregas, tornou-se necessário proporcionar aos cliente do OMS Protheus uma do TOTVS OMS uma solução para atender essas necessidades.

Visando esta solução foi realizada a integração entre o TOTVS OMS da linha Protheus  com a funcionalidade TOTVS Otimização Logística por intermédio de arquivos no formato XML, utilizando os Web Services WebServices existentes no TOL, sem transformação de mensagens e sem a utilização a utilização de Sistemas intermediários (TOTVS EAI, TOTVS ESB, entre outros).

Com esta integração, o TOTVS OMS  passou a utilizar os recursos do TOTVS Otimização Logística, o qual efetuará a roteirização e o arranjo das cargas com base na demanda de transportes enviados pelo TOTVS OMS, devolvendo para este as cargas montadas e roteirizadas.

Para a montagem de carga serão consideradas as configurações das restrições logísticas e as funções-objetivos de otimização registradas no TOTVS Otimização Logística.

São exemplos de funções-objetivo:

• Máxima ocupação dos veículos.
• Diminuição dos prazos de entrega.
• Redução da quantidade de viagens.

Image Modified 2. Sistemas Envolvidos

2.1. TOTVS OMS

A sigla OMS significa Order Management System, ou seja, gerenciamento de Pedidos e serviços que compreende as fases de captação, validação, avaliação, formação de carga e geração de mapa de separação ou, como é também conhecido, lista de separação.

Para obter informações detalhadas, acesse a página TOTVS OMS. no TDN.

2.2. TOTVS OTIMIZAÇÃO LOGÍSTICA

É 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 obter informações detalhadas, acesse o link http://www.neolog.com.br/neolog-site/index.php/cockpit-logistico/.

Image Modified 3. Escopo

O escopo desta integração permitirá o envio dos pedidos de venda liberados (crédito / estoque) no TOTVS OMS para a formação das viagens no TOL e o recebimento dessas destas viagens geradas no TOTVS Otimização Logística, por meio de um XML no TOTVS OMS, para a geração das cargas.

Para complementar o escopo do envio dos pedidos será necessário enviar os cadastros envolvidos com as informações dos pedidos, como produtos, clientes, fornecedores, filiais, transportadoras e tipos de veículos.

Faz parte do processo de integração o recebimento das mensagens de publicação de viagens, reprogramação e cancelamento de viagens.

Image Modified 4. Pré-requisitos Instalação / Implantação / Utilização

4.1. TOTVS Otimização Logística

• TOTVS Otimização Logística na

  TOL na versão/release 5.6.1.

• Parâmetros de aquisição ativos (acesso pelo menu em Administração > TOTVS Otimização Logística).

• Web Services ativos.

4.2. Protheus

• Protheus versão  12.1.17 ou superior.

• Parâmetros de integração com

  o TOTVS Otimização Logística

  o TOL configurados (acesso pelo menu em Atualizações > TOTVS Otimização Logística > Parâmetros Integração).

• Web Service Server para recebimento de mensagens

  do TOTVS Otimização Logística

  do TOL.

Image Modified 5. Instalação / Configuração

5.1. Configuração Web Service AppServer Protheus

• Para que seja possível receber as viagens do TOTVS Otimização Logística é necessário configurar um Web Service no servidor de aplicação Protheus.

• É recomendado criar um Web Service com as seguintes configurações (modificando o arquivo Appserver.ini):

;Serviço webserver HTTP
[HTTP]
ENABLE=1
PATH=<Caminho_Cache_imagens>;C:\TOTVS\Prottheus\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\Prottheus\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=OMSXStart
ONCONNECT=OMSXConnect

• Para testar o serviço, inicie um navegador e digite: http://<ip ou nome>:<porta>/neolog/PublishReleasedTrip.APW?WSDL.

• Um WSDL (descrição do serviço em XML)

  deve ser

  será exibido no navegador..

• Para que seja possível reprogramar/cancelar as viagens do TOTVS Otimização Logística é necessário configurar as informações de conexão com o DBAccess diretamente na seção [Environment] (modificando o arquivo Appserver.ini), conforme exemplo abaixo:

;Nome do Ambiente acessado pelo Web Service
[Environment]
SourcePath=C:\Totvs\Protheus\Apo
RootPath=C:\Totvs\Protheus\Data
StartPath=\system\
. . . ; outras chaves
DBDatabase=MSSQL
DBAlias=PLS101
DBServer=192.168.1.20
DBPort=7890

• Para evitar inconsistências do tipo Failed Handshake

  SSL recomenda

  SSL recomenda-se incluir a seguinte configuração no

  appserver

  Appserver.ini:

[SSLConfigure]
TryProtocols=1
Verbose=1

5.2. Parametrização TOTVS Otimização Logística

Para configurar o envio de viagens do TOTVS Otimização Logística TOL para o Web Service Protheus, acesse o TOL e execute os seguintes passos:

1. Administração > Integração, selecione a pasta Fontes de Dados e clique em Inserir.
2. Digite o código, a descrição e o código da base (Sugestãosugestão: PROTHEUS).
3. Seção Cancelamento de Viagem Liberada

• • No campo URL,  digite digite http://<ip ou nome>:<porta>/neolog/CancelService.APW.
  • No campo Tempo Máximo de Espera por Resposta, informe o timeout do serviço (recomendado 30000).

4. Seção Execução da Viagem

• • No campo URL, digite: NA (Não Atribuído).
  • No campo Tempo Máximo de Espera por Resposta, informe o timeout do serviço (recomendado 1000).

5. Seção Solicitação de liberação de Viagem

• • No campo URL, digite http://<ip ou nome>:<porta>/neolog/PublishReleasedTrip.APW.
  • No campo Tempo Máximo de Espera por Resposta, informe o  timeout do timeout do serviço (recomendado 30000).

6. Seção Solicitação de Reprogramação de Viagem

• • No campo URL, digite: http://<ip ou nome>:<porta>/neolog/ReprogramService.APW.
  • No campo Tempo Máximo de Espera por Resposta, informe o timeout do o timeout do serviço (recomendado 30000).

7. Clique em Salvar.

5.3. Parametrização TOTVS OMS

• Acesse o menu Atualizações > TOTVS Otimização Logística > Parâmetros Integração (OMSXCPL1).

• Para o correto funcionamento da integração, parametrize o Protheus da seguinte forma:

Parametrização Adicional Integração

• Algumas parametrizações da integração devem ser realizadas no arquivo de configuração do do servidor Protheus (Appserver.ini), pois são utilizadas antes de iniciar qualquer processo de conexão com o SGDB.
• As configurações abaixo devem ser incluídas no arquivo na seção [NEOLOG]:

;Configuração integração com o TOTVS Otimização Logística:
[NEOLOG]
DefaultCompany=<empresa>
Debug=1
DebugPath=<caminho relativo> ;logs\neolog

5.4. Parametrização Adicional Integração

• Algumas parametrizações da integração devem ser realizadas no arquivo de configuração do servidor Protheus (Appserver.ini), pois são utilizadas antes de iniciar qualquer processo de conexão com o SGDB.

• As configurações abaixo devem ser incluídas no arquivo na seção [NEOLOG]:

Configuração integração com o TOTVS Otimização Logística:
[NEOLOG]
DefaultCompany=<empresa>
Debug=1
DebugPath=<caminho relativo> ;logs\neolog

Onde:

• DefaultCompany
  Empresa padrão para integração entre o TOTVS OMS e o TOTVS Otimização Logística.
  

Onde:

• DefaultCompany: 
  Empresa padrão para integração entre o OMS Protheus e o TOTVS Otimização Logística.

  Se não for informado não será considerado, sendo sempre enviada nas mensagens nos campos que identificam os códigos, além do próprio código, a concatenação da empresa e do campo Filial do respectivo cadastro/processo.
  Caso esteja parametrizada

  ,

  será enviada apenas a concatenação do código com campo Filial do respectivo cadastro/processo. Clique aqui para obter mais detalhes.
  
  

  Informações
  title Dados da Filial Protheus
  Será verificado no cadastro de Filiais Protheus se utiliza o conceito de Gestão de Empresas, será enviado ao invés de Empresa/Filial o modelo Empresa/Unidade/Filial. Exemplo: M SP 01

• Debug
  Indicador Debug:
  Indicador de que o processo de gravação dos arquivos XML das mensagens trocadas entre o TOTVS OMS Protheus e o TOL está ativo.
  Caso esteja com o valor 1, será considerado ativo; caso contrário, caso contrário será considerado inativo.
  Caso esta configuração não exista esta configuração será assumido, por padrão, que o Debug está ativo por padrão.
  
  

• DebugPath:
  Caminho onde deverão ser serão gravados os arquivos de log do XML. Este caminho , o qual deve ser sempre relativo a pasta RootPath, pois o processo de integração pode rodar em modo JOB e, desta forma, não tem acesso a diretórios locais da máquina.
  Caso não esteja parametrizado , será considerado o caminho padrão system/neolog.
  
  

Image Modified 6. Controle de Versão

O Grupo TOTVS, representado por suas marcas, administrará as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão devem ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Image Modified 7. Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim, as equipes de suporte dos produtos BackOffice Protheus produtos BackOffice Protheus estarão aptas a efetuar a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Image Modified 8. Mensagens

Image Modified 9. Fluxo das Informações

Os cadastros devem ser realizados no no TOTVS OMS Protheus e integrados ao TOTVS Otimização Logística.

A ativação da integração, no entanto, não impede a inclusão, alteração e exclusão de registros no TOL, mas esse procedimento não é recomendado, pois as operações realizadas sobre os cadastros no TOL ,  não são replicadas para os respectivos cadastros no Protheus.

Apenas as operações de inclusão e alteração são consideradas na integração e são efetuadas sempre que ocorrerem, desde que parametrizadas para serem on-line.

A operação de eliminação sobre os registros de cadastros não é integrada, pois não é possível verificar a integridade referencial no sistema de destino para considerá-la como restrição de eliminação dos registros no Protheus.

O sucesso das operações de inclusão e alteração de registros pode ser verificado acessando o programa de consulta no menu do TOL em: Interface - Log.

O sistema de origem dos dados não recebe o status do processamento dos registros enviados, por isso, considera integrado com base apenas na confirmação de recepção da mensagem de integração.

9.1. Filiais

• Tipo de Fluxo: Protheus > TOTVS Otimização Logística.

• Mensagem: LocalityAcquisitionService

• O envio de empresas/filiais não O envio de empresas/filiais ou empresas/unidade/filiais não é automático, ou seja, ao cadastrar no Protheus uma nova empresa/filial, para que essas informações sejam replicadas para o TOTVS o TOTVS Otimização Logística é necessário executar a carga de dados disponível em:   SIGAOMS > Atualizações > TOTVS Otimização Logística > Carga de dados, assinalando a opção SM0 - Cadastro de Filiais.

• Os dados serão enviados ao TOTVS Otimização Logística por meio do método updateLocalities.

• Esses dados, por sua vez, serão salvos como localidade e poderão ser visualizados no CPL em: Cadastro > Localidades.
  
  

9.2. Clientes

• Tipo de Fluxo: Protheus > TOTVS Otimização Logística.

• Mensagem: LocalityAcquisitionService

• Ao cadastrar um cliente no Protheus, quando a integração estiver ativa os dados serão enviados ao TOTVS Otimização Logística por meio do método updateLocalities.

• Esses dados, por sua vez, serão salvos como localidade e poderão ser visualizados no TOL em: Cadastro > Localidades.

• Fornecedores

• Tipo de Fluxo: Protheus > TOTVS Otimização Logística.

• Mensagem: LocalityAcquisitionService ou CarrierAcquisitionService

• Ao cadastrar um fornecedor no Protheus, quando a integração estiver ativa os dados serão enviados ao TOTVS Otimização Logística por meio do método updateLocalities (conforme parametrização do cadastro SA2, de acordo com o comentado acima).

• Esses dados, por sua vez, serão salvos como localidade e poderão ser visualizados no TOL em: Cadastro > Localidades.

9.3. Transportadores

• Tipo de Fluxo: Protheus > TOTVS Otimização Logística.

• Mensagem: CarrierAcquisitionService

• Ao cadastrar um transportador no Protheus, quando a integração estiver ativa os dados serão enviados ao TOTVS Otimização Logística por meio do método CarrierAcquisitionService.

• Esses dados, por sua vez, serão salvos como transportadoras e poderão ser visualizados no TOL em: Cadastro > Transportadoras.

9.4. Produtos

• Tipo de Fluxo: Protheus > TOTVS Otimização Logística.
• Mensagem: ProductAcquisitionService
• Ao cadastrar um produto no Protheus, quando a integração estiver ativa os dados serão enviados ao TOTVS Otimização Logística por meio do método ProductAcquisitionService.
• Esses dados, por sua vez, serão salvos como produtos simples e poderão ser visualizados no TOL em: Cadastro > Produtos Simples.

9.5. Tipos de Veículo

• Tipo de Fluxo: TOTVS Otimização Logística

• Mensagem: VehicleAcquisitionService

• Ao cadastrar um tipo de veículono Protheus, quando a integração estiver ativa os dados serão enviados ao TOTVS Otimização Logística por meio do método VehicleAcquisitionService.

• Esses dados, por sua vez, serão salvos como veículos e poderão ser visualizados no TOL em: Cadastro > Veículos.

9.6. Pedidos de Venda

• Tipo de Fluxo: Protheus > TOTVS Otimização Logística
• Mensagem: OrderAcquisitionService

Image Modified 10. Detalhamento das Mensagens

10.1. Mensagem de Integração dos Registros do Cadastro de Filiais