Histórico da Página
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: |
| ||||||||||||||||||||||||||||||||||||||
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: | 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 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 veí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á que a integração entre o ERP DATASUL e os sistemas SIGAGFE e Cockpit Logístico já esteja configurado 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.
- Aplique o patch do chamado e execute uma vez a rotina UPDDISTR
- 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.
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: |
|
Exemplo:
#Include 'Protheus.ch'
User Function GFEXWSCPL1()
Local cXml:= PARAMIXB[1]
cXml := StrTran(cXml,"<carrierSourceId>10000</carrierSourceId>","<carrierSourceId>20000</carrierSourceId>")
Return cXml