Linha Microsiga Protheus

Árvore de páginas

  • Criado por Usuário desconhecido (luciene.sousa), última alteração em 14 jun, 2021


CONTEÚDO

01. VISÃO GERAL

Essa rotina permite realizar a integração de Pedidos de Venda com o TOTVS Otimização Logística (TOL).

Os Pedidos apresentados em tela são filtrados de acordo com os dados informados nas perguntas da rotina, bem como, no parâmetro MV_CPLPELB - Permite enviar quantidades não liberadas?, o qual define se os Pedidos serão apresentados sem as quantidades liberadas.  Além disso, todos os Pedidos apresentados possuem como premissa a utilização de carga informada no momento da sua geração.

Os Pedidos da integração da tela de Envio de Pedidos de Vendas podem apresentar os seguintes status:

Legenda

Descrição

NÃO INTEGRADO

Apresentado quando o Pedido não possuí quantidades integradas.

INTEGRADO 

Apresentado quando o Pedido possui todas as quantidades integradas, de todos os  itens.

INTEGRADO PARCIAL

Apresentado quando o Pedido possuí alguma quantidade integrada em qualquer um dos itens, mas nem todas as quantidades foram integradas.

FALHA DE INTEGRAÇÃO

Apresentado quando o Pedido possuí algum registro de falha gravado para qualquer um dos itens.


Os status do Pedido da tela de Envio de Pedidos de Vendas são os seguintes:

LegendaDescrição
PEDIDO EM ABERTO

Apresentado quando o Pedido possui quantidades que ainda não estão liberadas.
Expressão: SC5.C5_LIBEROK = ' ' AND SC5.C5_NOTA = ' ' AND SC5.C5_BLQ = ' '

PEDIDO ENCERRADO

Apresentado quando o Pedido encontra-se faturado.
Expressão: SC5.C5_NOTA <> ' ' OR (SC5.C5_LIBEROK = 'E' AND SC5.C5_BLQ = ' ')

PEDIDO LIBERADO

Apresentado quando o Pedido possuí quantidades liberadas. 
Expressão: SC5.C5_LIBEROK <> ' ' AND SC5.C5_NOTA = ' ' AND SC5.C5_BLQ = ' '

PEDIDO BLOQUEADO POR REGRA

Apresentado quando o Pedido encontra-se bloqueado por regra.
Expressão: SC5.C5_BLQ = '1'.

PEDIDO BLOQUEADO POR VERBA 

Apresentado quando o Pedido está bloqueado por verba.
Expressão: SC5.C5_BLQ = '2'

02. EXEMPLO DE UTILIZAÇÃO

Efetuar a Integração de Pedidos

  1.  No SIGAOMS, acesse Atualizações > Cockpit Logístico > Envio de Pedidos de Venda.

  2.  Na tela Envio de Pedidos de Venda, selecione os Pedidos que serão integrados.

  3.  Para não enviar toda a quantidade disponível do Pedido é possível alterar a quantidade a enviar pela opção Alterar Quantidade de Integração (F10).

  4.  Confira os Pedidos selecionados e clique em Enviar Pedidos (CPL) (F3).

  5.  No final do processamento será apresentado um resumo do envio de pedidos para o TOTVS Otimização Logística.

  6.  Este resumo alertará se ocorrer alguma inconsistência durante o envio.

  7.  As inconsistências também serão gravadas na tabela DJW, sendo possível consultá-las pela opção Consultar Registro de Falha (F7).

Cancelar a Integração de Pedidos em Lote

  1.  Na tela Envio de Pedidos de Venda, selecione os Pedidos cuja integração será cancelada.

  2.  Confira os Pedidos selecionados e clique em Desatualizar Pedidos Selecionados (CPL) (F2).

  3.  No final do processamento será apresentado um resumo do cancelamento de Pedidos do TOTVS Otimização Logística.

  4.  Este resumo alertará se ocorrer alguma inconsistência no cancelamento, sendo que estas também serão gravadas na tabela DJW.

Cancelar ou Alterar a Integração do Pedido ou Quantidade Específica

  1.  Na tela Envio de Pedidos de Venda, posicione o cursor sobre o Pedido que será alterado ou cancelado.
  2.  Selecione os itens cuja integração será cancelada.
  3.  Também é possível editar o campo Qtd. Cancelamento, caso seja necessário cancelar apenas uma parte do item.
  4.  Observe que, por padrão, a opção para assinalar todos os itens da sequência selecionada (no canto inferior esquerdo da tela) encontra-se ativa, contudo é possível editá-la de acordo com a necessidade.
  5.  Confira os itens e as quantidades selecionadas e confirme o cancelamento.
  6.  No final do processamento será apresentado um resumo do cancelamento do Pedido do TOTVS Otimização Logística.
  7.  Este resumo alertará se ocorrer alguma inconsistência no cancelamento, sendo que esta também será gravada na tabela DJW.
  8.  Para consultar as inconsistências ocorridas, clique em Consultar Registro de Falha (F7).

Compreender as Falhas Ocorridas

  1. No processo de integração podem ocorrer falhas por motivo de rejeição do TOTVS Otimização Logística, ou então, por motivo de falha na comunicação com o WebService e na validação do token.

    1. Para rejeições do TOTVS Otimização Logística é recomendável consultar o próprio log de integração no sistema Neolog, pois o motivo estará mais detalhado. 

    2. Já para as inconsistências de comunicação, a inconsistência CPLERR01 está mapeada, sendo que esta refere-se a impossibilidade do Protheus se comunicar com o TOTVS Otimização Logística.
      Para essa situação é necessário realizar as seguintes verificações:

      1. Verifique se o endereço do WebService informado (MV_CPLURL) é válido e está disponível.

      2. Verifique se o endereço do WebService de autenticação informado (MV_CPLUAUT) é válido e está disponível.

      3. Verifique se o usuário (MV_USRCPL) e a senha (MV_PSWCPL) de autenticação são válidos.

      4. Verifique se o token armazenado no parâmetro MV_TOKCPL é válido. Para tanto, limpe o parâmetro e tente realizar a integração novamente para forçar a gravação do token atualizado.

      5. Verifique se a seção [SSLConfigure] está parametrizada em seu Appserver.ini. Esta configuração obriga a requisição a tentar a combinação com todos os protocolos disponíveis, até obter sucesso na conexão:
        [SSLConfigure]
        TryProtocols=1Verbose=1

  2.  Informações adicionais podem ser obtidas no documento: Integração TOTVS OMS x TOTVS Otimização Logística (Planejamento)

03. TELA ENVIO DE PEDIDOS DE VENDA

Outras Ações / Ações Relacionadas

AçãoDescrição
Enviar Pedidos (CPL) - F3Permite enviar o XML de integração com o TOL.
Desatualizar Pedido Posicionado (CPL) - F4

Permite realizar o cancelamento de um Pedido enviado ao TOL, em função de não ser mais efetuada a roteirização.

Assim, será realizado o cancelamento do Pedido apenas no TOL, permanecendo no SIGAOMS como um Pedido liberado.

Outras Ações > Desatualizar Pedidos Selecionados - F2

Permite realizar a desatualização de todas as sequências de integração dos Pedidos selecionados na rotina. 

Esta opção cancela todas as sequências de integração de todos os Pedidos selecionados.

Para desatualizar sequências específicas utilize a opção Desatualizar Pedido Posicionado (CPL) – F4.

Outras Ações > Consultar Pedido - F8Permite visualizar as informações detalhadas do Pedido posicionado no Browser.
Outras Ações > Consultar Cliente - F9Permite visualizar as informações detalhadas do Cliente posicionado no Browser.
Outras Ações > Consultar Registro de Falha - F7Permite visualizar os registros de falhas apresentados na execução do processo de envio dos dados.
Alterar Quantidade da Integração - F10Permite acessar a tela Alteração da Quantidade para Integração, na qual é possível alterar a quantidade de integração dos itens do Pedido posicionado no Browser.

04. TELA ALTERAÇÃO DA QUANTIDADE PARA INTEGRAÇÃO

Principais Campos e Parâmetros

CampoDescrição
Saldo Pedido

Este campo é calculado conforme o parâmetro MV_CPLPELB, que indica se é permitido o envio de quantidades não liberadas do Pedido.

Se o parâmetro informado estiver igual a 2-Não , ou seja, envia apenas quantidades liberadas, o saldo do Pedido será calculado da seguinte forma:

  • Soma da quantidade liberada do pedido (C9_QTDLIB) do produto/item menos a quantidade já integrada (DK3_QTDINT) do produto/item.

Caso contrário, o saldo do Pedido será calculado por meio da seguinte forma:

  • Soma da quantidade de venda do pedido (C6_QTDVEN) do produto/item menos a quantidade já integrada (DK3_QTDINT) do produto/item.

05. PARÂMETROS

  • MV_CPLESCG

  • MV_CPLATVG

06. TABELAS UTILIZADAS

  • DK3 - Sequência de Integração CPL

  • SC6 - Itens do Pedido de Venda

07. ASSUNTOS RELACIONADOS