Á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

 

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

GFEXWSFUN

Rotina(s) envolvida(s)

Nome Técnico

 

GFEA061B

 GFEA061C
 GFEA061D
 GFEA061E
 GFEA061F

 

GFEA061G
 GFEA061H
 GFEA061I
  


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

, 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 com

(GFEA061) 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 de integração SIGAGFE x Cockpit Logístico

 

Importante

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Antes de executar o compatibilizador U_GFE11ICP é imprescindível:

  • Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão  11).
  • Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
  • Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
  • Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
  • O compatibilizador deve ser executado com a Integridade Referencial desativada*.

 

Atenção

O procedimento a seguir deve ser realizado por um profissional   qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

A ativação indevida da Integridade Referencial pode alterar   drasticamente o relacionamento entre tabelas no banco de dados. Portanto,   antes de utilizá-la, observe atentamente os procedimentos a seguir:

  1. No   Configurador (SIGACFG), veja se a empresa utiliza Integridade   Referencial, selecionando a opção Integridade/Verificação   (APCFG60A).
  2. Se não   há Integridade Referencial ativa,   são relacionadas em uma nova janela todas as empresas e filiais cadastradas   para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário   qualquer outro procedimento de ativação   ou desativação de integridade, basta finalizar a verificação e aplicar   normalmente o compatibilizador, conforme instruções.
  3.  Se há Integridade Referencial ativa   em todas as empresas e filiais, é   exibida uma mensagem na janela Verificação   de relacionamento entre tabelas. Confirme a mensagem para que a   verificação seja concluída, ou;
  4.  Se   há Integridade Referencial ativa   em uma ou mais empresas, que não   na sua totalidade, são relacionadas em uma nova janela todas as empresas e   filiais cadastradas para o sistema e, somente, a(s) que possui(em)   integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou   filial(is) possui(em) a integridade ativada e reserve esta anotação para   posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework   para informações quanto a um arquivo que contém essa informação).
  5. Nestes   casos descritos nos itens “iii” ou   “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
  6.  Quando desativada a Integridade Referencial,   execute o compatibilizador, conforme instruções.
  7. Aplicado o compatibilizador, a Integridade   Referencial deve ser reativada, SE E   SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as   informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da   integridade, selecione-a(s) novamente e confirme a ativação.

 

Contate o Help Desk Framework EM CASO DE DÚVIDAS!

 

  1. Em Microsiga Protheus TOTVS Smart Client (se versão 10) ou ByYou Smart Client (se versão 11), digite informe o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
  2. Clique em OK para continuar.
  3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
  4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
    1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
    2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
    3. Clique em Gravar para salvar o histórico (log) apresentado.
    4. Clique em OK para encerrar o processamento.

 

Descreva se há algum procedimento necessário após a aplicação do compatibilizadordocumento de integração - 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 U_GFE11ICP
  2. No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:

Nome da Variável:

Informe o Nome da Variável

Tipo:

Informe o Tipo

Descrição:

Informe a Descrição

Valor Padrão:

Informe o Valor Padrão

Nome da Variável:

Informe o Nome da Variável

Tipo:

Informe o Tipo

Descrição:

Informe a Descrição

Valor Padrão:

Informe o Valor Padrão

Nome da Variável:

Informe o Nome da Variável

Tipo:

Informe o Tipo

Descrição:

Informe a Descrição

Valor Padrão:

Informe o Valor Padrão

Nome da Variável:

Informe o Nome da Variável

Tipo:

Informe o Tipo

Descrição:

Informe a Descrição

Valor Padrão:

Informe o Valor Padrão

Nome da Variável:

Informe o Nome da Variável

Tipo:

Informe o Tipo

Descrição:

Informe a Descrição

Valor Padrão:

Informe o Valor Padrão

  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

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

Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

  1. Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

Pergunte

(X1_PERGUNT)

Nome

 

Grupo

(X1_GRUPO)

Ordem

(X1_ORDEM)

Tipo

(X1_TIPO)

Tamanho

(X1_TAMANHO)

 

2.    Criação ou Alteração de tabela no arquivo SX2– Tabelas:

Chave

Nome

Modo

PYME

B04

(X2_CHAVE)

Dente/Região

(X2_NOME)

C

(X2_MODO)

N

(X2_PYME)

 

3.  Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

Chave

Ex.: AR

Descrição

Ex.: Tabela de IR de Aplicações Financeiras

 

4.  Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

  • Tabela BGD - Prod x Cob x Proc x Co-Part:

 

Campo

(X3_CAMPO)

Tipo

(X3_TIPO)

Tamanho

(X3_TAMANHO)

Decimal

(X3_DECIMAL)

Formato

(X3_PICTURE)

Título

(X3_TITULO)

Descrição

(X3_DESCRIC)

Nível

(X3_NÍVEL)

Usado

(X3_USADO) Informe Sim ou Não

Obrigatório

(X3_OBRIGAT) Informe Sim ou Não

Browse

(X3_BROWSE) Informe Sim ou Não

Opções

(X3_CBOX)

When

(X3_WHEN)

Relação

(X3_RELACAO)

Val. Sistema

(X3_VALID)

Help

Descreva o conteúdo informado para Help de Campo no ATUSX

 

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

 

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