Á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
Tipos de VeículoGFEA045
Tabela de FreteGFEA061
 GFEA061A
 

GFEXWS

 GFEXWSCPL
 GFEXWSFUN

Rotina(s) envolvida(s)

Nome Técnico

 

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

Ponto de Entrada:

Informe o ponto de entrada relacionado (link).GFEXWSCPL1 - Manipulação do XML da tabela de frete enviada ao Cockpit Logístico

Chamados relacionados

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

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

 

 

Descrição

Implementado a integração entre as tabelas de frete do SIGAGFE(GFEA061) com os grupos de regras de frete do Neolog - Cockpit Logístico. Por dependência de informações, foi implementado a recepção de tipos de carga(DATASUL) para tipos de ceículo(SIGAGFE) além dos transportadores(DATASUL) para emitentes(SIGAGFE, campo GU3_CDTERP) e tipo de carga(quando fechada) do embarque(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, fornecido pelo Neolog - Cockpit Logístico. A integração DATASUL -> SIGAGFE se dará pelo webservice padrão do SIGAGFE.

Este envio de tabela de frete dependerá da integração entre o ERP DATASUL e os sistemas SIGAGFE e Cockpit Logístico, onde já estejam configuradas corretamente.

 As regras de negócio e a correspondência entre os campos estão detalhadamente descritos no manual de integração SIGAGFE x Cockpit Logístico.

 

 

Procedimento para Implantação

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

  1. Aplique o patch do chamado e execute uma vez a rotina UPDDISTR
    1. Para mais informações sobre o UPDDISTR, visite : 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

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

 

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

Decimal

0

Formato

 

Título

Cod. Z.T.

Descrição

Codigo Zona Transporte

Nível

0

Usado

Sim

Obrigatório

Não

Browse

Não

Opções

 

When

 

Relação

 

Val. Sistema

 

Help

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

 

  • Tabela GVA- Tabela de Frete

 

Campo

GVA_CPLSIT

Tipo

C

Tamanho

1

Decimal

0

Formato

 

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

 

Relação

 

Val. Sistema

  Pertence("012345")

Help

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

 

  • Tabela GV7- Faixa/Tp Veic Tab Frete

 

Campo

GV7_CPLTVF

Tipo

C

Tamanho

10

Decimal

0

Formato

 

Título

Tp Veic Frac

Descrição

Tipo Veiculo Fracionado

Nível

0

Usado

Sim

Obrigatório

Não

Browse

Não

Opções

 

When

 M->GV7_TPLOTA == '1'                                        

Relação

 

Val. Sistema

  Vazio() .OR. GFEExistC("GV3",1,M->GV7_CDTPVC,"GV3->GV3_SIT=='1'")                                                   

Help

Tipo de Veículo utilizado quando a negociação fracionada for integrada com o cockpit logístico.

 

Importante:

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

 2. Criação de Parâmetros no arquivo SX6 – Parâmetros:

Nome da Variável

MV_DSINTTV

Tipo

 

Descrição

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

Valor Padrão

2

Nome da Variável

MV_CPLEMB

Tipo

C

Descrição

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

Valor Padrão


Nome da Variável

MV_CPLREG

Tipo

C

Descrição

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

Valor Padrão


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_CPLUR

Tipo

C

Descrição

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

Valor Padrão


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

Valor Padrão


 

 

Procedimento para Configuração


CONFIGURAÇÃO DE MENUS

 

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do SIGAGFE - Gestão de Frete Embarcador, conforme instruções a seguir:

Menu

Atualizações - Integrações

Submenu

Cockpit Logístico

Nome da Rotina

Parâmetros Integração

Programa

GFEX003

Módulo

SIGAGFE

Tipo

Função Protheus

 

 

Procedimento para Utilização

    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 Módulo (GFEX000)

       2.            Localize a aba Integrações Datasul e clique nela.

       3.            No agrupador Geral, localize o campo 'Integração Tipo de Veículo?'

       4.           Altere o conteúdo para 1-Sim

       5.            Confira e clique em Salvar.

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

       1.           Acesse Logística/Gestão de Frete Embarcador

       2.           Localize a aba Cadastro, selecione Parâmetros de Integração GFE (cd0089) e clique em executar.

       3.            Localize a aba Integrações Datasul e clique nela.

       4.            Marque a opção Integrar Tipo de carga (tipo de veículo)

       5.            Confira e clique em Salvar.

    Enviando o tipo de carga do TOTVS 12/DATASUL para o tipo de veículo do SIGAGFE

       1.           Acesse Logística/xxx

       2.           Localize a aba Cadastro, selecione Parâmetros de Integração GFE (cd0089) e clique em executar.

       3.           Altere ou inclua um novo tipo de carga.

       4.           Selecione o tipo de carga como carga Fechada.

       5.            Confira e salve o cadastro.

       6.            Em Gestão de Frete Embarcador, acesse  Atualizações/Cadastros/ Tabelas de Frete / Tipos de Veículo (GFEA045)

       7.            Verifique se o tipo de carga  foi integrado corretamente.

       8.            Opcionalmente, poderá ser feita a carga de dados de todos os tipos de carga Fechada através do zzz

    Código do Transportador no Emitente do SIGAGFE

       1.           Acesse Logística/xxx

       2.           Localize a aba Cadastro, selecione GFE (cd0089) e clique em executar.

       3.           Localize um Fornecedor que também é um transportador e anote o CGC(CNPJ) do fornecedor.

       4.           Acesse o cadastro de Transportadores.

       5.           Inclua ou altere um cadastro, informando o CGC(CNPJ) anotado.

       6.           Confira e salve o cadastro.

       7.           Em Gestão de Frete Embarcador, acesse  Atualizações/Cadastros/ Gerais / Emitentes (GFEA015).

       8.           Localize o cadastro integrado.

       9.           Clique em visualizar.

       10.         Na aba Transportador, verifique se o conteúdo do campo Cod Tran Erp é o mesmo código do cadastro de Transportador.

       11.         Opcionalmente, poderá ser feita a carga de dados de todos os fornecedores/transportadores através do zzz

    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.          Altere 'Integração Cockpit Logístico?' para 1-Sim

       3.          Informe o endereço do webservice que recepcionará os dados da tabela de frete.

                         a. Exemplo : http://servidor:8081/Integration/services/FreightRuleAcquisitionService 

                         b. Você pode 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. Você pode 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 possui um tipo de lotação fracionada e não possui tipo de veículo fracionado informado.

                         a. Você pode consultar os tipos disponíveis acessando o Cockpit Logístico / Cadastro / Veículos

       7.          Confirme/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.          Deverá ser exibida a mensagem 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,

                   é 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'.

       4.          Para consultar a tabela de frete vá em Cockpit Logístico / Administração / Grupo de Regras de Frete.

       5.          Se desejar, digite o número da tabela de frete e clique em pesquisar. O código equivalente é formado pelo código do transportador erp do emitente da tabela mais o seu número.

       6.          Ao localizar a tabela, clique no ícone referente a edição para verificar os dados enviados pelo SIGAGFE.


 

 

 

      

 

 

Ponto de Entrada GFEXWSCPL1

Descrição:

Ponto de entrada para alterar o xml enviado da tabela de frete ao Cockpit Logístico

Localização:

 GFEXWSCPL.PRW

Eventos:

 

Programa Fonte:

GFEXWSCPL1.PRW

Função:

User Function GFEXWSCPL1()

Retorno:

Nome

Tipo

Descrição

Obrigatório

 cSoapPE

Char

O retorno será o xml que será enviado ao Cockpit logístico

Sim

 

 

 

 

 

 

 

 

 

Exemplo:

#Include 'Protheus.ch'

User Function GFEXWSCPL1()

Local cXml:= PARAMIXB[1]

cXml := StrTran(cXml,"<carrierSourceId>10000</carrierSourceId>","<carrierSourceId>20000</carrierSourceId>")

Return cXml