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: |
Rotina
Nome Técnico
Parâmetros módulo
GFEX000
GFEX000 - Parâmetros Módulo GFEX003 - Parâmetros Integração GFEA045 - Tipos de Veículo |
GFEA061 - Tabela de Frete |
GFEA061A |
GFEXWS |
GFEXWSCPL |
GFEXWSFUN |
Rotina(s) envolvida(s)
Nome Técnico
GFEA061B
Rotinas envolvidas GFEA061B GFEA061C |
GFEA061D |
GFEA061E |
GFEA061F |
GFEA061G |
GFEA061H |
GFEA061I |
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 |
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: |
12.1.7 |
- Dezembro |
Descrição
ImplementadoImplementada a integração entre as tabelas de frete
do SIGAGFE(GFEA061)
comdo SIGAGFE com os grupos de regras de frete
do Neologdo Neolog -
CockpitCockpit Logístico.
Por dependência de informações, foi
implementadoimplementada a recepção de tipos de carga (
DATASULDatasul) para tipos de
ceículoveículo (SIGAGFE) além dos transportadores (
DATASULDatasul) para emitentes (SIGAGFE, campo GU3_CDTERP) e tipo de carga
(, quando fechada
), do embarque (
DATASULDatasul) para o tipo de veículo do romaneio (SIGAGFE, campo GWN_CDTPVC).
A integração SIGAGFE
-> Cockpit
se dará através do webservice FreightRuleAcquisitionServiceocorre via webservice FreightRuleAcquisitionService, fornecido pelo Neolog -
CockpitCockpit 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
DATASULDatasul e os sistemas SIGAGFE e Cockpit Logístico
, onde já estejam configuradas corretamente.
AsAs regras de negócio e a correspondência entre os campos estão detalhadamente descritos no
manualdocumento de integração
SIGAGFE x Cockpit Logístico.
Procedimento para Implantação
O sistema é atualizado logo após a depois da aplicação do pacote de atualizações (Patch) deste chamado.
- Aplique o patch do chamado e execute uma vez a rotina UPDDISTR
- 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 |
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 |
30 | |
Decimal | 0 |
Título |
Título
ZT Cockpit |
Descrição |
Zona |
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çãode Parâmetros no arquivo SX6 – Parâmetros:
Nome da Variável |
(X6_VAR)
Tipo
(X6_TIPO)
Descrição
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
- 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 |
Atualizações - Integrações |
Submenu |
Cockpit Logístico |
Nome da Rotina |
Parâmetros Integração |
Programa |
GFEX003 |
Módulo |
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:
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)
- 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.
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: |
|
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