Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice

Índice
maxLevel5
outlinetrue
exclude.*ndice
stylenone

Introdução

Essa configuração permite importar as multas de trânsito relacionadas aos veículos cadastrados no sistema Brobot. Caso os dados da multa estejam devidamente cadastrados a mesma será importada ao Protheus. 

Página Inicial

...

Agora é possível integrar o Módulo Gestão de Frotas( SIGAGFR ) Protheus ao sistema de Caça Multas da Brobot. Para garantir o correto funcionamento dessa integração, será necessário realizar algumas configurações em seu ambiente Protheus.

Com essa integração, as buscas por multas serão feitas de forma automática, otimizando o processo e garantindo mais eficiência na gestão de multas.

Página Inicial

Aqui estão algumas informações referente ao processo de integração do SIGAGFR com Brobot.

Nota
iconfalse
titleAtenção
  • É possível adicionar essa funcionalidade ao release 12.1.2310. Para isso basta acessar o folder Configurando 12.1.2310;
  • No release 12.1.2410 esta funcionalidade será nativa no ambiente.
Deck of Cards
effectDuration0.5
historyfalse
idSchedule
effectTypefade
Card
id1
labelConfigurando 12.1.2310

Para acessar essa funcionalidade serão necessários seguir os passos abaixo para incluir os itens necessários para seu funcionamento.

Nota
titleAviso

É imprescindível que o fonte MNTMWS esteja em seu RPO para o correto funcionamento.

Primeiro acesse o Configurador( SIGACFG ), Base de Dados > Dicionário > Base de dados. No canto esquerdo da tela, selecione a empresa, clique na opção dicionário de dados e então clique no ícone de busca( Image Added ), busque pelo código TRX. Selecione a tabela TRX e clique em editar( Image Added ), vá na parte de índices e clique em incluir( Image Added) um novo índice.

CampoConteúdo
CHAVETRX_PLACA+DTOS(TRX_DTINFR)+TRX_RHINFR
NICKNAME
DESCRICAOPlaca Veicu. + Dta Infracao + Hra Infracao
DESCSPAPlaca Vehic. + Fch. Infrac. + Hora Infrac.
DESCENGVhc.Plate + Viol. Date + Viol. Time
MOTRA PESQ.☑️
Virtualizado
IX_VIRCUST3 - Padrão do Sistema

Image Added

Clique em salvar, depois sair( Image Added ). Vá na opção pastas( Image Added ), selecione a opção parâmetros.

Deck of Cards
idConfiguração
Card
id2
labelNão Integrado ao Financeiro

O parâmetro a ser adicionado é o MV_NGBROBO

CampoConteúdo
Filial( X6_FIL )Este conteúdo irá de acordo com a configuração do seu ambiente.
Nome de Var.( X6_VAR )MV_NGBROBO
Tipo( X6_TIPO )1 - Caractere
Cont. Por.( X6_CONTEUD )Aqui você irá adicionar o token gerado pela Brobot.
Descrição( X6_DESCRIC )Token para autenticar a integração de multas


Image Added

Image Added

Ao terminar o cadastro do parâmetro MV_NGBROBO conforme exemplo acima, vá na opção pastas( Image Added ), selecione a opção Perguntas, clique em incluir ( Image Added), adicione o grupo de perguntas conforme o exemplo abaixo, após finalizar o cadastro de perguntas clique em salvar( Image Added ).

Grupo de Perguntas - MNTMWS
OrdemPerguntaTipoTamanhoHelpObjetoPré Seleção(Combo)item 1 (Combo/Check/Expression)item 2 (Combo/Check)
1De Data?Data8MemoEdit---
2Até Data?Data8MemoEdit---
3Criar Órgão Aut. Genérico?

Numérico

1

Memo

Combo

1

Não

Sim

Image Added

Image Added

Card
id2
labelIntegrado ao Financeiro

No caso do ambiente integrado ao financeiro, serão necessários o cadastro de dois parâmetros, o primeiro é o parâmetro MV_NGBROBO

CampoConteúdo
Filial( X6_FIL )Este conteúdo irá de acordo com a configuração do seu ambiente.
Nome de Var.( X6_VAR )MV_NGBROBO
Tipo( X6_TIPO )1 - Caractere
Cont. Por.( X6_CONTEUD )Aqui você irá adicionar o token gerado pela Brobot.
Descrição( X6_DESCRIC )Token para autenticar a integração de multas


Image Added

Image Added

O segundo parâmetro a ser cadastrado é o parâmetro MV_NGBROFI.

CampoConteúdo
Filial( X6_FIL )Este conteúdo irá de acordo com a configuração do seu ambiente.
Nome de Var.( X6_VAR )MV_NGBROFI
Tipo( X6_TIPO )1 - Caractere
Cont. Por.( X6_CONTEUD )

Aqui você irá adicionar os códigos separados por ; ( ponto e virgula ) 

  1. TRX_PREFIX
  2. TRX_TIPO
  3. TRX_NATURE
  4. TRX_CONPAG

Exemplo: MNT;BOL;FIN2000028;003

Descrição( X6_DESCRIC )Campos para integração da multa com financeiro

Image Added

Image Added

Ao terminar o cadastro do parâmetro MV_NGBROFI conforme exemplo acima, vá na opção pastas( Image Added ), selecione a opção Perguntas, clique em incluir ( Image Added), adicione o grupo de perguntas conforme o exemplo abaixo, após finalizar o cadastro de perguntas clique em salvar( Image Added ).

Grupo de Perguntas - MNTMWSF
Nota

Os tamanhos definido no grupo de perguntas deverão ser condizentes com o tamanho dos campos em sua base. No exemplo abaixo foram utilizados os tamanhos de 6 para Fornecedor e 2 para Loja, pois no ambiente de exemplo os campos de A2_FORNEC e A2_LOJA possuem esses tamanhos.

OrdemPerguntaTipoTamanhoValidaçãoHelpObjetoConsulta Padrão(Edit)Pré Seleção(Combo)item 1 (Combo/Check/Expression)item 2 (Combo/Check)
1De Data?Data8-MemoEdit----
2Até Data?Data8-MemoEdit----
3Criar Órgão Aut. Genérico?

Numérico

1

-

Memo

Combo

-

1

Não

Sim

4Fornecedor?

Caracter

6

MV_PAR03 == 1 .Or. ( MV_PAR03 == 2 .And. NaoVazio() .And. ExistCpo( 'SA2', MV_PAR04 ) )

Memo

Edit

Fornecedor

-

-

-

5Loja?

Caracter

2

MV_PAR03 == 1 .Or. ( MV_PAR03 == 2 .And. NaoVazio() .And. ExistCpo( 'SA2', MV_PAR04 + MV_PAR05 ) )

Memo

Edit

-

-

-

-

6Cond. Pagamento?

Caracter

3

MV_PAR03 == 1 .Or. ( MV_PAR03 == 2 .And. NaoVazio() .And. ExistCpo( 'SE4', MV_PAR06 ) )

Memo

Edit

Cond. de Pagamento

-

-

-


Image Added

Agora seu ambiente está pronto para utilizar desta melhoria! Siga os processos de Configuração Inicial e Agendamento para usufruir por completo!

Card
id1
labelConfiguração Inicial

Neste primeiro momento será necessário configurar o parâmetro MV_NGBROBO com o token disponibilizado pela Brobot. Esse token você pode encontrar na plataforma da Brobot em: definições > usuários > Selecione o usuário e procure pelo campo Token (API).

Image Added


Após a inserção do Token, deverá ser validado se o ambiente possui o índice 9 da tabela TRX.

TabelaÍndiceDescrição
TRX9TRX_PLACA + TRX_DTINFR + TRX_RHINFR


Caso seu ambiente não possua o parâmetro MV_NGMNTFI habilitado, a integração já estará funcional.

Card
id1
labelConfiguração com Financeiro

Com parâmetro MV_NGMNTFI habilitado, será necessário configurar o parâmetro MV_NGBROFI.

  • Exemplo:MNT;BOL;FIN2000028;003
CampoDescrição
TRX_PREFIX Campo de identificação do conjunto de títulos
TRX_TIPO Código do tipo do título
TRX_NATURE Código da natureza
TRX_CONPAG Código da condição de pagamento


Ao finalizar essa configuração, a integração já estará funcional.

Card
id1
labelCarga Inicial de Veiculos

Para inserir de forma automática os veículos já cadastrados no Protheus para o sistema da Brobot, vá em: Miscelânea > Gera Bens > Carga Inicial Brobot, selecione os veículos que deseja importar para Brobot e clique em Image Added.

Regra
1Caso o parâmetro MV_NGBROBO não esteja configurado corretamente não será possível realizar o
cadastro do agendamento através
processo de importação de veículos.
2Somente serão apresentados veículos que possuírem em seu cadastro os campos de Placa, Renavam e UF preenchidos.
Veículos que já estão cadastrados na Brobot serão apresentados como "Veículos não importados".
Card
id1
labelCarga Inicial de Infrações

Agora o cadastro de infrações possui uma opção de "Carga Inicial" para infrações, isso tudo foi feito pensando na praticidade e agilidade, tornando assim o processo de inserção de multas mais simples. A opção de carga inicial de infrações está presente em outras ações da rotina de Infrações de Trânsito( MNTA770 ). Após executa-la, todas as multas contidas no Código de Transito Brasileiro até a data de serão importadas automaticamente. 

1
Card
id1
labelAgendamentos

Para que o processo de multas seja feito de forma totalmente automática, poderá ser configurado um Schedule para que execute o processo de busca de multa conforme a configuração desejada. Abaixo terá um breve exemplo de como configurar o Schedule de multas.

Através do Configurador (SIGACFG), busque pelo Schedule através do seguinte diretório:

Ambiente > Schedule > Schedule, selecione a opção "Novo"

Informe a rotina que irá executar o processo de busca de Multas.

Image Added

Defina como será processo de execução.

Image Added

Aqui você irá configurar de acordo com seu ambiente.

Padrão
CampoDescrição
EmpresaEmpresa na qual o Schedule será executado
FilialFilial na qual o Schedule será executado
MóduloInformar Módulo Gestão de Frotas( 95 )
UsuárioEm qual usuário será executado o Schedule
DescriçãoUma breve descrição do que se trata o Schedule
Deck of Cards
idConfiguração
Card
id
2
label
Não Integrado ao Financeiro

Image Added

Rotina Grupo de Perguntas MNTMWS
CampoDescrição
De Data?Data inicial que serão realizadas as buscas das multas
Até Data?Data final que serão realizadas as buscas das multas
Criar Órgão Aut. Genérico?
NãoSim
Não cria órgão genéricoCria órgão genérico com código 000000 e descrição "Uso exclusivo Brobot"

Este parâmetro é utilizado em cenários onde o código do órgão autuador não é identificado automaticamente pela integração. Ele permite que o usuário registre as multas no sistema e, posteriormente, ajuste manualmente o órgão autuador.

Card
id2
labelIntegrado ao Financeiro

Image Added


Rotina Grupo de Perguntas MNTMSF
CampoDescrição
De Data?Data inicial que serão realizadas as buscas das multas
Até Data?Data final que serão realizadas as buscas das multas
Criar Órgão Aut. Genérico?
NãoSim
Não cria órgão genéricoCria órgão genérico com código 000000 e descrição "Uso exclusivo Brobot"

Este parâmetro é utilizado em cenários onde o código do órgão autuador não é identificado automaticamente pela integração. Ele permite que o usuário registre as multas no sistema e, posteriormente, ajuste manualmente o órgão autuador.

Fornecedor?Código do fornecedor
Loja?Código da Loja
Condição de Pagamento?Código da condição de pagamento

Pronto! Agora seu Schedule já está configurado!

Card
id1
labelIdentificando Problemas

Se houver alguma configuração incorreta, ao tentar executar qualquer processo relacionado à integração de Multas e Brobot, será gerado um arquivo no diretório especificado pelo RootPath configurado no seu appserver.ini. O arquivo será nomeado como MNTMWS + DATA + HORA.txt. A estrutura desse arquivo de texto seguirá o seguinte formato:

ItemDescrição
UsuárioUsuário em que o processo foi executado
DataData da ocorrência
HoraHora da ocorrência
MensagemMensagem de erro
Agendamentos

Dentro da aba Agendamentos, abra o item Cadastro e informe os dados do agendamento de acordo com ambiente.
Image Removed

Ainda na aba de Cadastro acesse a opção RecorrênciaImage Removed para configurar o período de execução do agendamento.

Image Removed

Regras de Negócio

Deck of Cards
effectDuration0.5
historyfalse
idSchedule
effectTypefade

Regras de negócio relacionados a integração de Multas Brobot. 

Regra

1Não será possível efetuar a importação das multas caso os Parâmetros  Parâmetros não estejam devidamente cadastrados.
2Necessário possuir Infrações da multa cadastrada.
3

Necessário possuir Órgão Autuador da multa cadastrado.

4

Necessário possuir veículo da multa cadastrado.

5

Multa será importada caso existe no sistema Brobot e as demais regras estejam de acordo.

Parâmetros

Deck of Cards
effectDuration0.5
historyfalse
idSchedule
effectTypefade
ParâmetroDescrição
MV_NGBROBO

Token para autenticar a integração de multas.

MV_NGBROFI

Campos para integração da multa com financeiro. Para preenchimento deste parâmetro informe os seguintes campos:

  • TRX_PREFIX (Campo de identificação do conjunto de títulos)
  • TRX_TIPO (Código do tipo do título)
  • TRX_NATURE (Código da natureza)
  • TRX_CONPAG (Código da condição de pagamento)

Exemplo: MNT;BOL;FIN2000028;003

MV_NGMNTFIIntegração Manutenção (MNT) com Financeiro (FIN).  Informar S=Sim, P=Pedido ou N=Não. 

Palavras-chave

  • Infração de Trânsito;
  • Multas;
  • Veículos;

Conteúdos Relacionados