Árvore de páginas

Versões comparadas

Chave

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

Envio de Tabela de Frete Neolog

Características do Requisito

Linha de Produto:

Microsiga Protheus

Segmento:

Distribuição e Logística

Módulo:

SIGAGFE - Gestão de Frete Embarcador

Rotina:

Rotina

Nome Técnico

Parâmetros módulo

GFEX000

Parâmetros integraçãoGFEX003

GFEX000 - Parâmetros Módulo

GFEX003 - Parâmetros Integração

GFEA045 - Tipos de Veículo

GFEA045

GFEA061 - Tabela de Frete

GFEA061 

GFEA061A

 

GFEXWS

 

GFEXWSCPL

 

GFEXWSFUN

Rotina(s) envolvida(s)

Nome Técnico

 

GFEA061B

 GFEA061C


Rotinas envolvidas

GFEA061B

GFEA061C

 

GFEA061D

 

GFEA061E

 

GFEA061F

 

GFEA061G

 

GFEA061H

 

GFEA061I

  Cadastros Iniciais:

Cadastro de parâmetros do módulo, parâmetros de integração(novo),Emitentes, Regiões, Componentes de Frete, Tipos de Veículo,Tabelas de Frete

Parâmetro(s):

MV_DSINTTV

,

MV_CPLEMB

,

MV_CPLREG

,

MV_CPLINT

,

MV_CPLURL

,

MV_CPLTVF

, MV_UMPESO

Chamados relacionados

Informe o(s) chamado(s) relacionado(s).

Ponto de Entrada:

Informe o ponto de entrada relacionado (link).

GFEXWSCPL1 - Manipulação do XML da tabela de frete enviada ao Cockpit Logístico

Requisito (ISSUE):PCREQ-5528

País(es):

Brasil

Banco(s) de Dados:

Todos

Tabelas utilizadas:

GVA

,

GV1

,

GV2

,

GUV

,

GU7

,

GU9

,

GUC

,

GVB

,

GUY

,

GV9

,

GV8

,

GV7

Sistema(s) operacional(is):

Windows/Linux

Versões/Release:

Protheus 11.80 e Protheus

12.1.7

 

- Dezembro

 

Descrição

Implementado

Implementada a integração entre as tabelas de frete

do SIGAGFE

(GFEA061)

com

 do SIGAGFE  com os grupos de regras de frete

do Neolog

do Neolog -

 Cockpit

 Cockpit Logístico.

Por dependência de informações, foi

implementado

implementada a recepção de tipos de carga (

DATASUL

Datasul) para tipos de

ceículo

veículo (SIGAGFE) além dos transportadores (

DATASUL

Datasul) para emitentes (SIGAGFE, campo GU3_CDTERP) e tipo de carga

(

, quando fechada

)

, do embarque (

DATASUL

Datasul) para o tipo de veículo do romaneio (SIGAGFE, campo GWN_CDTPVC). 

A integração SIGAGFE

-

> Cockpit

se dará através do webservice FreightRuleAcquisitionService

ocorre via webservice FreightRuleAcquisitionService, fornecido pelo Neolog -

 Cockpit

 Cockpit Logístico.

A integração

DATASUL -

Datasul > SIGAGFE

se dará

ocorre pelo webservice padrão do SIGAGFE.

Este envio de tabela de frete dependerá da configuração correta da integração entre o ERP

DATASUL

Datasul e os sistemas SIGAGFE e Cockpit Logístico

, onde já estejam configuradas corretamente

.

 As

 As regras de negócio e a correspondência entre os campos estão detalhadamente descritos no

manual

documento de integração

SIGAGFE x Cockpit Logístico.

 

 

DI_Integracao_GFE_Cockpit_Logistico.

Procedimento para Implantação

O sistema é atualizado logo após a depois da aplicação do pacote de atualizações (Patch) deste chamado.

  1. Aplique o patch do chamado e execute uma vez a rotina UPDDISTR
 
  1. rotina UPDDISTR
    1. Para mais informações sobre o UPDDISTR, acesse: Atualizador de dicionário e base de dados - UPDDISTR

Novos campos e parâmetros

 


1.  Criação de Campos no arquivo SX3 – Campos:

  • Tabela GV9 - Negociação da Tabela de Frete
 

Campo

GV9_CPLTS

Tipo

C

Tamanho

32

30

Decimal

0

Formato

 

Título

T.S. Cockpit

Descrição

Tipo de Servico Cockpit

Nível

0

Usado

Sim

Obrigatório

Não

Browse

Não

Opções

 

When

 

Relação

 

Val. Sistema

When

SuperGetMv("MV_CPLINT",.F.,"") == "1"                       

 

Help

Tipo de Serviço utilizado no envio da tabela de frete ao grupo de regras de frete do Cockpit Logístico                                 

 


  • Tabela GU9 - Regiões

 

Campo

GU9_CPLZT

Tipo

C

Tamanho

60

30

Decimal

0

Formato

Título

 

Título

Cod. Z.T.

ZT Cockpit  

Descrição

Codigo

Zona

Transporte

Transp Cockpit      

Nível

0

Usado

Sim

Obrigatório

Não

Browse

Não

Opções

 

When

 

Relação

 

Val. Sistema

When

SuperGetMv("MV_CPLINT",.F.,"") == "1"                       

 

Help

Código da Zona de Transporte correspondente no cockpit logístico.

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

 

5.  Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:

  • Pesquisa B05PLS:

Alias

(XB_ALIAS)

Tipo

(XB_TIPO)

Sequência

(XB_SEQ)

Coluna

(XB_COLUNA)

Descrição

(XB_DESCRI)

Contém

(XB_CONTEM)

 

6.  Criação ou Alteração de Índices no arquivo SIX – Índices:

Índice

AA1

Ordem

6

Chave

AA1_FILIAL+AA1_CODVEN

Descrição

Cod. Vendedor

Proprietário

S

 


  • Tabela GVA- Tabela de Frete

Campo

GVA_CPLSIT

Tipo

C

Tamanho

1

Decimal

0

Título

Situação CPL

Descrição

Situação Cockpit Logístic

Nível

0

Usado

Sim

Obrigatório

Não

Browse

Não

Opções

0=Não se aplica;1=Não enviada;2=Enviada;3=Erro envio;4=Necessita reenvio;5=Integrada

When

.F.

Relação

"0"

Val. Sistema

  Pertence("012345")

Help

Descreve a situação da integração da tabela de frete

Campo

GVA_CPLDT

Tipo

D

Tamanho

8

Decimal

0

Título

Dt Ult Envio

Descrição

Data Ultimo Envio        

Nível

0

Usado

Sim

Obrigatório

Não

Browse

Não

When

.F.

Help

Indica a data do último envio da tabela de frete ao cockpit logístico  


Importante:
O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.


 2. Criação

7.  Criação ou Alteração

de Parâmetros no arquivo SX6 – Parâmetros:

Nome da Variável

(X6_VAR)

Tipo

(X6_TIPO)

Descrição

(X6_DESCRIC + X6_DESC1 + X6_DESC2)

MV_DSINTTV

Descrição

Integração do cadastro de tipo de carga com o tipo de veículo    

Valor Padrão

(X6_CONTEUD)

 

8.  Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

  • Tabela BD5 – Contas Médicas:

Campo

Informe o conteúdo do (X7_CAMPO)

Sequência

Informe o conteúdo do (X7_SEQUENC)

Campo Domínio

Informe o conteúdo do (X7_CDOMIN)

Tipo

Informe o conteúdo do (X7_TIPO)

Regra

Informe o conteúdo do (X7_REGRA)

Posiciona?

Informe o conteúdo do (X7_SEEK)

Chave

Informe o conteúdo do (X7_CHAVE)

Condição

Informe o conteúdo do (X7_CONDIC)

Proprietário

Informe o conteúdo do (X7_PROPRI)

 

 

2

Nome da Variável

MV_CPLEMB

Tipo

C

Descrição

Embarcador enviado no grupo de regras de frete para o Cockpit Logistico

Nome da Variável

MV_CPLREG

Tipo

C

Descrição

Regional enviada no grupo de regras de frete para o Cockpit Logistico  

Nome da Variável

MV_CPLINT

Tipo

C

Descrição

Habilita integração com o Cockpit Logístico.

Valor Padrão

2

Nome da Variável

MV_CPLURL

Tipo

C

Descrição

Endereço do webservice de regras de frete do Cockpit Logístico

Nome da Variável

MV_CPLTVF

Tipo

C

Descrição

Tipo de Veículo utilizado quando a negociação da tabela de frete for Fracionado

Procedimento para Configuração


Configuração de Menus

1

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).

 

CONFIGURAÇÃO DE PARÂMETROS

 

  1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
    (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

Itens/Pastas

Descrição

Nome:

 

Tipo:

Informe o Tipo do parâmetro

Cont. Por.:

Informe o Conteúdo padrão

Descrição:

 

 

CONFIGURAÇÃO DE MENUS

 

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do móduloSIGAGFE, conforme instruções a seguir:

Menu

Informe o Menu em que estará localizada a rotina

Atualizações - Integrações

Submenu

Informe o Submenu em que estará localizada a rotina

Cockpit Logístico

Nome da Rotina

Informe o Título da rotina

Parâmetros Integração

Programa

Informe o Fonte da rotina

GFEX003

Módulo

Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”

SIGAGFE

Tipo

Informe a Função

 

 

Função Protheus

Procedimento para Utilização

Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:

  • Localização da rotina no menu;
  • Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
  • Caso seja necessário ter algum cadastro feito previamente, faça uma observação.
  •    

    Exemplo:

           1.            No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

    O sistema apresenta a janela de produtos cadastrados.

           2.            Posicione o cursor em um produto e clique em Alterar.

           3.            Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

           4.            Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

    O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

           5.            Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

                          Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

           6.            Confira os dados e confirme.

     

     

    Vídeo

    • Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

    ** Canal do youtube e software de vídeoem definição.

     

    Título do Vídeo:

    Disponibilizado pelo Marketing.

    Introdução:

    Disponibilizado pelo Marketing.

    Passo a Passo:

    Capturar diretamente do sistema.

    Finalização:

    Disponibilizado pelo Marketing.

     

     

    Habilitando a integração do tipo de veículo (SIGAGFE)

    1. Em Gestão de Frete Embarcador, acesse Atualizações > Cadastros > Parâmetros > Parâmetros do Módulo (GFEX000) > aba Integrações Datasul.
    2. No agrupador "Geral" no campo Integração Tipo de Veículo? selecione a opção  "1" (Sim).
    3. Confira e acione Salvar.


    Habilitando a integração do tipo de carga (TOTVS 12/DATASUL)

    1. Acesse Logística > Gestão de Frete Embarcador > aba Cadastro Parâmetros de Integração GFE (CD0089).
    2. Acione Executar.
    3. Na aba Integrações Datasul assinale a opção Integrar Tipo de carga  (tipo de veículo).
    4. Confira e acione Salvar.


    Configuração da Integração do SIGAGFE com o Cockpit Logístico

    1. Em Gestão de Frete Embarcador, acesse Atualizações > Integrações > Cockpit Logístico > Parâmetros Integração (GFEX003).
    2. No campo Integração Cockpit Logístico? selecione a opção "1" (Sim).
    3. Informe o endereço do webservice que receberá os dados da tabela de frete.
         a. Exemplo : http://servidor:8081/Integration/services/
         b. É possível testar a validade do endereço clicando em Outras Ações > Testar Webservice.
    4. Informe a regional dos cadastros do Cockpit Logístico.
    5. Informe o código do embarcador do Cockpit Logístico.
         a. É possível consultar os embarcadores disponíveis acessando o Cockpit Logístico > Cadastro > Embarcadores.
    6. Informe o código do tipo de veículo fracionado do Cockpit Logístico, utilizado quando a negociação enviada possuir um tipo de lotação fracionada.
         a. É possível consultar os tipos disponíveis acessando o Cockpit Logístico > Cadastro > Veículos.
    7. Confirme e salve o cadastro.


    Integração da tabela de frete do SIGAGFE com o Grupo de Regras de Frete do Cockpit Logístico
    1. Em Gestão de Frete Embarcador, acesse Atualizações > Movimentação > Cockpit Logístico > Tabelas de Frete > Tabelas de Frete (GFEA061).
    2. Com o parâmetro Integração Cockpit Logístico habilitado, em Outras Ações da lista de tabelas de frete selecione Envio Cockpit.
    3. Será exibida uma mensagem informando que a tabela foi enviada com sucesso.
         a. Caso ocorra algum erro durante o envio, será exibido o erro da transmissão da tabela.
         b. Caso seja necessário acompanhar o xml enviado ou mesmo o erro que ocorreu durante a transmissão dos dados.
    4. É possível habilitar a gravação do arquivo de log através do parâmetro Tipo de Geração de Log (MV_GFEEDIL), e ficará junto com os outros logs do sistema, com o nome de 'Tabela_' + Número + '_EnvioCPL'.
         c. Caso a tabela enviada possua tabelas vinculadas, estas serão enviada em seguida.
         d. O pacote da mensagem enviada com as informações da tabela estará agrupada pela vigência inicial e final das negociações válidas encontradas.
    5. Para consultar a tabela de frete acesse o Cockpit Logístico > Administração > Grupo de Regras de Frete.
    6. Se necessário, digite o número da tabela de frete e clique em pesquisar. O código equivalente é formado pelo código do emitente da tabela, concatenado do caracter "|" e o seu número.
    7. Ao localizar a tabela, clique no ícone referente a edição para verificar os dados enviados pelo SIGAGFE.
    8. Depois de confirmar que os dados estão corretos, utilize a Ação Relacionada  > Confirmar Integração Cockpit apenas como informativo que a integração ocorreu com sucesso.

    Ponto de Entrada

    Descrição:

    Informe o Menu em que estará localizada a rotina

    Localização:

    Informe o Submenu em que estará localizada a rotina

    Eventos:

    Informe o Título da rotina

    Programa Fonte:

    Informe o Fonte da rotina

    Função:

    Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”

    Retorno:

    Nome

    Tipo

    Descrição

    Obrigatório

     

     

     

     

     

     

     

     

     

     

     

     

     

    Exemplo:

    #Include 'Protheus.ch'

    User Function CN120ALT()

    Local aCab:= PARAMIXB[1]

    Local cTipo:= PARAMIXB[2]

    If cTipo == '1'

        aCab[4][2]:= 'NF' //Validações do usuário

    EndIf

    Return aCab