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: | GFEX000 - Parâmetros Módulo GFEX003 - Parâmetros Integração GFEA045 - Tipos de Veículo GFEA061 - Tabela de Frete GFEA061A GFEXWS GFEXWSCPL GFEXWSFUN Rotinas envolvidas GFEA061B GFEA061C GFEA061D GFEA061E GFEA061F GFEA061G GFEA061H GFEA061I |
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 |
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: | 12.1.7 - Dezembro |
Descrição
Implementada a integração entre as tabelas de frete (GFEA061) do SIGAGFE com os grupos de regras de frete do Neolog - Cockpit Logístico.
Por dependência de informações, foi implementada 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 ocorre via webservice FreightRuleAcquisitionService, fornecido pelo Neolog - Cockpit Logístico.
A integração Datasul > SIGAGFE 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 e os sistemas SIGAGFE e Cockpit Logístico.
As regras de negócio e a correspondência entre os campos estão detalhadamente descritos no documento de integração - DI_Integracao_GFE_Cockpit_Logistico.
Procedimento para Implantação
O sistema é atualizado logo depois da 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, 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 | 30 |
Decimal | 0 |
Título | T.S. Cockpit |
Descrição | Tipo de Servico Cockpit |
Nível | 0 |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
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 | 30 |
Decimal | 0 |
Título | ZT Cockpit |
Descrição | Zona Transp Cockpit |
Nível | 0 |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
When | SuperGetMv("MV_CPLINT",.F.,"") == "1" |
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 |
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 de Parâmetros no arquivo SX6 – Parâmetros:
Nome da Variável | MV_DSINTTV |
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 |
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. No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do SIGAGFE, 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)
- Em Gestão de Frete Embarcador, acesse Atualizações > Cadastros > Parâmetros > Parâmetros do Módulo (GFEX000) > aba Integrações Datasul.
- No agrupador "Geral" no campo Integração Tipo de Veículo? selecione a opção "1" (Sim).
- Confira e acione Salvar.
Habilitando a integração do tipo de carga (TOTVS 12/DATASUL)
- Acesse Logística > Gestão de Frete Embarcador > aba Cadastro > Parâmetros de Integração GFE (CD0089).
- Acione Executar.
- Na aba Integrações Datasul assinale a opção Integrar Tipo de carga (tipo de veículo).
- Confira e acione Salvar.
Configuração da Integração do SIGAGFE com o Cockpit Logístico
- Em Gestão de Frete Embarcador, acesse Atualizações > Integrações > Cockpit Logístico > Parâmetros Integração (GFEX003).
- No campo Integração Cockpit Logístico? selecione a opção "1" (Sim).
- 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. - Informe a regional dos cadastros do Cockpit Logístico.
- 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. - 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. - Confirme e salve o cadastro.
- Em Gestão de Frete Embarcador, acesse Atualizações > Movimentação > Cockpit Logístico > Tabelas de Frete > Tabelas de Frete (GFEA061).
- Com o parâmetro Integração Cockpit Logístico habilitado, em Outras Ações da lista de tabelas de frete selecione Envio Cockpit.
- 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. - É 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. - Para consultar a tabela de frete acesse o Cockpit Logístico > Administração > Grupo de Regras de Frete.
- 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.
- Ao localizar a tabela, clique no ícone referente a edição para verificar os dados enviados pelo SIGAGFE.
- 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.