Histórico da Página

Pickup

Image Added 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 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

WebServices existentes no TOL, sem transformação de mensagens e sem

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 Added 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

Cockpit Logístico Neolog

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 Added 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

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 Added 4.

Pré-requisitos Instalação / Implantação / Utilização

Cockpit Logístico

4.1. TOTVS Otimização Logística

• TOL

  Cockpit Logístico

  na versão/release 5.6.1.

• Parâmetros de aquisição ativos (acesso pelo menu em Administração >

  Cockpit Logístico

  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

  Cockpit Logístico

  o TOL configurados (acesso pelo menu em

  Atualizações > Cockpit Logístico > Parâmetros

  Atualizações > TOTVS Otimização Logística > Parâmetros Integração).

• Web Service Server para recebimento de mensagens do

  Cockpit Logístico

  TOL.

Image Added 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)

• 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-se incluir a seguinte configuração no

• Appserver.ini:

[SSLConfigure]
TryProtocols=1
Verbose=1

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

Para configurar o envio de viagens do

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  e clique em Inserir.
2. Digite o Código código, a Descrição descrição e o Código código da base .
   Sugestão(sugestão: PROTHEUS).
3. Seção Cancelamento de Viagem Liberada

• • No campo URL da seção,  digitedigite http: http://<ip ou nome>:<porta>/neolog/CancelService.APW.APW 
  • No campo Tempo Máximo de Espera por Resposta, informe o timeout do serviço.
    Recomendado 30000o 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.o timeout do serviço (recomendado 1000).

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

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

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

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

7. Clique em Salvar.

Parametrização SIGAOMS

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 Cockpit Logístico
[NEOLOG]
DefaultCompany=<empresa>
Debug=1
DebugPath=<caminho relativo> ;logs\neolog

Onde:

• DefaultCompany: Empresa padrão para integração entre o OMS e o Cockpit Logístico. 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.
• Debug: Indicador de que o processo de gravação dos arquivos XML das mensagens trocadas entre o OMS e o Cockpit Logístico está ativo. Caso esteja com o valor 1, será considerado ativo, caso contrário será considerado inativo. Caso não exista esta configuração será assumido que o Debug está ativo por padrão.

• DebugPath: Caminho onde deverão ser gravados os arquivos de log do XML. Este caminho 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".

Integração OMS Protheus x Cockpit Logístico NeologControle 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 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.

Integração OMS Protheus x Cockpit Logístico NeologSuporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim, as equipes de suporte dos 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.

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.
  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 de que o processo de gravação dos arquivos XML das mensagens trocadas entre o TOTVS OMS e o TOL está ativo.
  Caso esteja com o valor 1, será considerado ativo; caso contrário, será considerado inativo.
  Caso esta configuração não exista será assumido, por padrão, que o Debug está ativo.
  
  

• DebugPath
  Caminho onde serão gravados os arquivos de log do XML, 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 Added 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 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 Added 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 estarão aptas a efetuar a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Image Added 8. Mensagens

Image Added 9. Fluxo das Informações

Os cadastros devem ser realizados no TOTVS OMS 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 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 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

Integração OMS Protheus x Cockpit Logístico NeologMensagens

Cadastros

Processos

Pedido de Vendas

SIGAOMS

Cockpit Logístico

OrderAcquisitionService

CancelService

Integração OMS Protheus x Cockpit Logístico NeologFluxo das Informações

Os cadastros devem ser realizados no OMS Protheus e integrados ao Cockpit Logístico.

A ativação da integração, no entanto, não impede a inclusão, alteração e exclusão de registros no Cockpit Logístico, mas esse procedimento não é recomendado, pois as operações realizadas sobre os cadastros no Cockpit Logístico 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 Cockpit Logístico em: Interface - Log.

As filiais assumem o papel de localidade quando são locais de carga ou descarga.

Quando MV_CPLEX == "2" não integrar a filial cuja unidade de federação não faça parte da lista de unidades de federação do Brasil.

LocalityAcquisitionService ou CarrierAcquisitionService

updateLocalities ou updateCarriers

Os fornecedores serão integrados como localidade quando atender os seguintes requisitos:

1. Campo A2_TRANSP (Cód. Transportadora) em branco;
2. Campo A2_RNTRC (Reg. Nac. Tr. Rod. Cargas) em branco;
3. Campo A2_PAGGFE (Pagamento pelo SIGAGFE) igual a '2-Não'.

Caso contrário, o fornecedor será integrado como transportadora.

createOrders

Filiais

Tipo de Fluxo: Protheus > Cockpit Logístico

Mensagem: LocalityAcquisitionService

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

Os dados serão enviados ao Cockpit Logístico 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.

Clientes

Tipo de Fluxo: Protheus > Cockpit Logístico

Mensagem: LocalityAcquisitionService

Ao cadastrar um cliente no Protheus, quando a integração estiver ativa os dados serão enviados ao Cockpit Logístico 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.

Fornecedores

Tipo de Fluxo: Protheus > Cockpit Logístico

Mensagem: LocalityAcquisitionService ou CarrierAcquisitionService

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

• 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 OMS foi disponibilizado um programa (OMSXCPL6) que permite selecionar uma lista com os pedidos de venda para envio ao Cockpit Logístico, sendo que estes pedidos são filtrados conforme as seguintes premissas:

• O pedido deve montar carga (C5_TPCARGA);
• O pedido não deve encontrar-se faturado (C9_NFISCAL);
• O pedido deve respeitar o range de dados dos filtros da rotina;
• Se o sistema estiver parametrizado para não permitir o envio de pedidos sem liberação (MV_CPLPELB = '2'), os pedidos retornados não devem possuir bloqueios de estoque (C9_BLEST) e crédito (C9_BLCRED). 
• Se o sistema estiver parametrizado para permitir o envio de pedido sem liberação (MV_CPLPELB = '1'), será permitido o envio de toda a quantidade do pedido (C6_QTDVEN), mesmo existam bloqueios.

Após os pedidos filtrados, a rotina de envio de pedido de venda ainda permite que sejam alteradas as quantidades para a integração, através do botão "Alterar Quantidade da Integração - F10". Onde o usuário pode informar quais as quantidades do pedido deseja-se integrar. Cada integração do pedido gera um sequência de integração diferente, exemplo:

Ao efetivar o envio, as seguintes tabelas sofrem alterações/inclusões:

DK3 - Tabela de sequência de integração do pedido: irá gravar a quantidade enviada ao Cockpit, incluindo as informações de pedido e sequência de integração. As sequências de integração que encontram-se efetivamente integradas com o Cockpit possuem o status (DK3_STATUS) "1-Integrado".

SC6 - Itens do pedido de venda: irá gravar o status (C6_INTROT) igual à "2-Integrado" para pedidos totalmente integrados e "4-Integrado Parcial" para pedidos que ainda possuem quantidades à serem integradas.

Cancelamento de pedidos:

O cancelamento de pedidos apenas ocorre através da rotina de Envio de Pedidos (OMSXCPL6), onde o usuário possuí as seguintes opções:

1) Desatualizar pedido posicionado:

• • Permite a seleção de qual sequência de integração deseja-se cancelar a integração, também permite o cancelamento parcial de uma sequência de integração através da digitação da "Qtd. Cancelamento".

2) Desatualizar pedido(s) selecionado(s):

• Realiza o estorno de todas as sequências de integração de todos os pedidos selecionados no browse.

Importante: caso o parâmetro MV_CPLATVG (Atualiza viagem no Cockpit ao cancelar a integração do pedido?) encontrar-se ativo, em conjunto com as devidas parametrizações do sistema Neolog,  todas as viagens das sequências de integração selecionadas serão canceladas automaticamente. Por este motivo, recomenda-se cautela ao utilizar a opção de cancelamento de todos os pedidos selecionados.

Ao efetivar o cancelamento, as seguintes tabelas sofrem alterações/inclusões:

DK3 - Tabela de sequência de integração do pedido: alterará o status da sequência de integração (DK3_STATUS) para "3-Cancelado Parcial" quando apenas parte da sequência é estornada, ou então para '2-Cancelado', quando toda a quantidade da sequência é cancelada do CPL.

SC6 - Itens do pedido de venda: gravará o status (C6_INTROT) igual à "1-Não Integrado", quando apenas parte do item teve a integração cancelada, ou então,  gravará o status igual à "4-Integrado Parcial", quando parte da quantidade do item permanecerá integrada.

Viagens

Tipo de Fluxo: Cockpit Logístico > Protheus

Mensagem: ReleaseTripPublishRequestService

O Cockpit Logístico envia as viagens geradas para o OMS para a formação das cargas, sendo que o envio é realizado pela chamada do Web Service ReleaseTripPublishRequestService. Para isso foi disponibilizado um programa monitor para receber estas viagens (OMSXCPL7).

• 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

9.6.1. Envio de Pedidos

Ao cadastrar um Pedido de venda no Protheus, quando a integração estiver ativa os dados são enviados ao TOTVS Otimização Logística por meio do método OrderAcquisitionService.

Esses dados, por sua vez, geram no TOTVS Otimização Logística o pedidos de transporte e poderão ser visualizados em: Programação > Análise; deve-se filtrar os dados da cesta geral.

No TOTVS OMS foi disponibilizada a rotina OMSXCPL6 (Envio de Pedido de Venda), que permite selecionar uma lista com os pedidos de venda para envio ao TOTVS Otimização Logística, sendo que estes pedidos são filtrados conforme as seguintes premissas:

• O pedido deve montar carga (C5_TPCARGA).
• O pedido não deve estar faturado (C9_NFISCAL).
• O pedido deve respeitar o range de dados dos filtros da rotina.
• Se o sistema estiver parametrizado para não permitir o envio de pedidos sem liberação (MV_CPLPELB = '2'), os pedidos retornados não devem possuir bloqueios de estoque (C9_BLEST) e crédito (C9_BLCRED). 
• Se o sistema estiver parametrizado para permitir o envio de pedido sem liberação (MV_CPLPELB = '1'), será permitido o envio de toda a quantidade do pedido (C6_QTDVEN), mesmo que existam bloqueios.

Após os pedidos serem filtrados, a rotina OMSXCPL6 (Envio de Pedido de Venda) ainda permite alterar as quantidades para a integração pelo botão Alterar Quantidade da Integração - F10, sendo que, por seu intermédio é possível informar quais quantidades do pedido serão integradas, onde cada integração do pedido gera um sequência de integração diferente.

Exemplo

Sendo assim, a identificação do pedido será sempre a combinação da empresa+filial+sequência de integração+pedido.
Exemplo: 0301000001000096

Caso os dados da filial protheus seja do tipo Gestão de Empresas, será enviada a concatenação empresa+unidade de negócio+filial+sequência de integração+pedido.
Exemplo:MSP01000001000096

Ao efetivar o envio, as seguintes tabelas sofrem alterações/inclusões:

• DK3 - Tabela de Sequência de Integração do Pedido
  Gravará a quantidade enviada ao TOL, incluindo as informações de pedido e a sequência de integração.
  As sequências de integração que encontram-se efetivamente integradas com o TOL possuem o status (DK3_STATUS) 1 - Integrado.
  
  
• SC6 - Itens do Pedido de Venda
  Gravará o status (C6_INTROT) 2 - Integrado, para pedidos totalmente integrados e 4 - Integrado Parcial, para pedidos que ainda possuem quantidades a serem integradas.

9.6.2. Cancelamento de Pedidos

O cancelamento de pedidos ocorre apenas pela rotina OMSXCPL6 (Envio de Pedidos de Venda), na qual estão disponíveis as seguintes opções:

• Desatualizar Pedido Posicionado
  Permite selecionar a sequência que terá a integração cancelada.
  Também permite  efetuar o cancelamento parcial de uma sequência de integração pela digitação da Qtd. Cancelamento.
  
  

• Desatualizar Pedido(s) Selecionado(s):
  Permite efetuar o estorno de todas as sequências de integração, de todos os pedidos selecionados no browse.
  

  Informações
  title IMPORTANTE!
  Caso o parâmetro MV_CPLATVG (Atualiza viagem no TOL ao cancelar a integração do pedido?) estiver ativo em conjunto com as devidas parametrizações do TOTVS Otimização Logística, todas as viagens das sequências de integração selecionadas serão canceladas automaticamente. Por este motivo, recomenda-se cautela ao utilizar a opção de cancelamento de todos os pedidos selecionados.

  
  Ao efetivar o cancelamento, as seguintes tabelas sofrerão alterações/inclusões:

• DK3 - Tabela de Sequência de Integração do Pedido
  Alterará o status da sequência de integração (DK3_STATUS) para 3 - Cancelado Parcial, quando apenas parte da sequência é estornada, ou então para 2 - Cancelado, quando toda a quantidade da sequência é cancelada do TOL.
  
  
• SC6 - Itens do Pedido de Venda
  Gravará o status (C6_INTROT) igual a 1 - Não Integrado, quando apenas parte do item teve a integração cancelada, ou então,  gravará o status igual a 4 - Integrado Parcial, quando parte da quantidade do item permanecerá integrada.

9.7. Viagens

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

• Mensagem: ReleaseTripPublishRequestService

• O TOL envia as viagens geradas para o TOTVS OMS, para a formação das cargas, sendo que o envio é realizado pela chamada do Web Service ReleaseTripPublishRequestService. 
  Para isso, foi disponibilizada a rotina OMSXCPL7 (Monitor de Cargas), que será responsável pelo gerenciamento das cargas em questão.

• Ao receber uma viagem com o campo Placa (DK0_PLACA) preenchido é realizada uma busca pela placa no cadastro de veículos (DA3).
  Se encontrado algum registro, o veículo será associado a carga. Para que isso ocorra é essencial que a placa recebida do TOL seja idênticaa placa cadastrada no Protheus.

• Ao receber a viagem no TOTVS OMS serão gravadas as tabelas DK0 (Viagem CPL) e DK1(Itens da Viagem CPL) com suas respectivas quantidades recebidas do TOL. Além disso, é registrado o código da viagem na tabela auxiliar de Sequência de Integração TOL  (DK3), quando esta existir, mais especificamente no campo DK3_VIAGID.

• Já no processo de geração da carga, que pode ocorrer de forma automática no momento da geração da viagem ou posteriormente via rotina OMSXCPL7 (Monitor de Cargas) serão avaliadas as quantidades liberadas do Pedido (C9_QTDLIB) para a gravação do código da carga, visto que a rotina de OMSXCPL6 (Envio de Pedidos de Venda), permite a integração de quantidades não liberadas e a montagem da carga necessita, obrigatoriamente, de quantidades liberadas do Pedido

Ao receber a viagem no OMS são gravadas as tabelas DK0 (Viagem CPL) e DK1(Itens da Viagem CPL) com suas respectivas quantidades recebidas do Cockpit Logístico e, além disso, é registrado o código da viagem na tabela auxiliar de Sequência de Integração CPL (DK3), quando esta existir, mais especificamente no campo DK3_VIAGID.

Já no processo de geração da carga, que pode ocorrer de forma automática no momento da geração da viagem ou posteriormente via rotina de Monitor de Carga (OMSXCPL7), serão avaliadas as quantidades liberadas do Pedido (C9_QTDLIB) para a gravação do código da carga, visto que a rotina de Envio de Pedidos (OMSXCPL6) permite a integração de quantidades não liberadas e a montagem da carga necessita, obrigatoriamente, de quantidades liberadas do Pedido.

Image Added 10. Detalhamento das Mensagens

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

Integração OMS Protheus x Cockpit Logístico NeologDetalhamento das Mensagens

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

Integração OMS Protheus x Cockpit Logístico NeologConfigurações Complementares

Configuração Para Envio Automático de Pedidos de Venda (Schedule)

Os pedidos de venda gerados no módulo SIGAOMS podem ser enviados automaticamente ao Cockpit Logístico. Para isso, deve ser configurada a execução automática (Schedule) da rotina Envio de Pedidos de Venda (OMSXCPL6). Esta configuração pode ser executada conforme descrito no link: http://tdn.totvs.com/display/framework/Schedule+Protheus.

No arquivo appserver.ini é necessário inserir a configuração abaixo:

[OnStart]
jobs=FWSCHDMANAG,FWSCHDQUEUE
RefreshRate=60

[FWSCHDMANAG]
Main=FWSCHDMANAG
Environment=<ambiente>

[FWSCHDQUEUE]
Main=FWSCHDQUEUE
Environment=<ambiente>

Cadastro de Fator de Conversão Para KG (OMSA140)

O Cockpit Logístico possuí como característica o tratamento de peso apenas em KG, portanto, para que o SIGAOMS envie o valor convertido é necessário cadastrar as unidades de medidas utilizadas e associar seu valor em KG.

Para realizar esse cadastro acesse SIGAOMS > Atualizações > Cockpit Logístico > Fator de Conversão, sendo necessário realizar esse cadastro para todas as unidades de medidas dos produtos que serão utilizadas na integração, cuja relação de peso não seja em KG.

Exemplo de cadastro:

Unidade de Medida (DK2_CODUM) → TL (tonelada), Peso em KG (DK2_PESOKG) → 1000. Isso significa que a cada uma tonelada são 1000 kg.

Modo de Compartilhamento Tabelas Viagem x Carga

Para ambientes que utilizam diversas filiais e/ou empresas é necessário garantir que as tabelas de viagem DK0 e DK1 possuam a mesma configuração de modo de acesso das tabelas de carga DAK e DAI. Exemplo: se as tabelas de carga estiverem configuradas com os modos de acesso Ac. Filial = 2-Exclusivo, Ac. Unidade = 2-Exclusivo, Ac. Empresa = 2-Exclusivo, logo, as tabelas de viagem deverão possuir configuração idêntica. Esse detalhe é imprescindível para garantir a adequada ligação entre a viagem do Cockpit Logístico e a carga gerada pelo OMS.

Esse ajuste deve ser realizado por meio do configurador do Protheus (sigacfg).

Integração OMS Protheus x Cockpit Logístico NeologFuncionalidades Não Contempladas

¹ É possível que uma viagem no Cockpit Logísitico contenha pedidos de diferentes empresas/filiais, para que este processo seja refletido no lado Protheus, é necessário que o Protheus esteja configurado para ser utilizado no modelo de Gestão de Empresas, parametrizando o OMS para trabalhar no conceito de operador logístico, onde uma empresa/filial fica como centralizadora das informações. Caso contrário poderá ocorrer de uma viagem que possuir pedidos de diferentes empresas/filiais seja quebrada em várias no Protheus, gravando cada parte da respectiva viagem, na empresa/filial dos pedidos, ou seja, uma viagem do Cockpit Logístico poderá gerar uma ou mais cargas no OMS, não havendo nenhuma interface que permita ao usuário consultar este relacionamento.

² Para o combinação da filial para os cadastros serão aplicadas as seguintes regras:

• Utilizando a configuração de gestão de empresas e esta possua em sua máscara a empresa:

  • Será enviado apenas o retorno da função xFilial( <TAB> ), onde TAB representa a tabela do Protheus.

• Utilizando a  configuração de gestão de empresas, sem possuir a empresa na máscara, ou não utilizando a configuração de gestão de empresas:

  • Caso exista uma empresa padrão (DefaultCompany) configurada na seção [NEOLOG] do INI do servidor de aplicação será enviado apenas o retorno da função xFilial( <TAB> ), onde TAB representa a tabela do Protheus.

  • Não existindo a empresa padrão será enviada a concatenação da função FWGrpCompany() + xFilial( <TAB> ), onde TAB representa a tabela do Protheus.

• Sempre que o retorno não for branco, este será precedido por um "-" (hífen), caso a função não receba o valor .F. no segundo parâmetro. 

* Poderá ocorrer deste valor permanecer em branco, em função de algumas parametrizações e configuração da tabela ser compartilhada.

Image Added 11. Configurações Complementares

11.1. Configuração Para Envio Automático de Pedidos de Venda (Schedule)

• Os pedidos de venda gerados no módulo TOTVS OMS podem ser enviados automaticamente ao TOTVS Otimização Logística.

• Para isso, deve ser configurada a execução automática (Schedule) da rotina OMSXCPL6 (Envio de Pedidos de Venda).

• Esta configuração pode ser executada conforme descrito em Schedule Protheus.

• No arquivo Appserver.ini é necessário inserir a seguinte configuração:

[OnStart]
jobs=FWSCHDMANAG,FWSCHDQUEUE
RefreshRate=60

[FWSCHDMANAG]
Main=FWSCHDMANAG
Environment=<ambiente>

[FWSCHDQUEUE]
Main=FWSCHDQUEUE
Environment=<ambiente>

11.2. Cadastro de Fator de Conversão Para KG

• O TOL possuí como característica o tratamento de peso apenas em KG, portanto, para que o TOTVS OMS envie o valor convertido é necessário cadastrar as unidades de medidas utilizadas e associar seu valor em KG.

• Para realizar esse cadastro acesse SIGAOMS > Atualizações > TOTVS Otimização Logística > Fator de Conversão (OMSA140), sendo necessário realizar esse cadastro para todas as unidades de medidas dos produtos que serão utilizadas na integração, cuja relação de peso não seja em KG.

• Exemplo de cadastro:

  Unidade de Medida (DK2_CODUM) → TL (tonelada), Peso em KG (DK2_PESOKG) → 1000. Isso significa que a cada uma tonelada são 1000 kg.

11.3. Modo de Compartilhamento Tabelas Viagem x Carga

• Para ambientes que utilizam diversas filiais e/ou empresas é necessário garantir que as tabelas de viagem DK0 e DK1 possuam a mesma  configuração de modo de acesso das tabelas de carga DAK e DAI.

• Exemplo:
  Se as tabelas de carga estiverem configuradas com os modos de acesso Ac. Filial = 2-Exclusivo, Ac. Unidade = 2-Exclusivo, Ac. Empresa = 2-Exclusivo, logo, as tabelas de viagem deverão possuir configuração idêntica. Esse detalhe é imprescindível para garantir a adequada ligação entre a viagem do TOL e a carga gerada pelo TOTVS OMS.

• Este ajuste deve ser realizado por meio do configurador do Protheus (SIGACFG).

Image Added 12. Funcionalidades Não Contempladas