Índice

Introdução

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.

Atençã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.

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

Aviso

É 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( ), busque pelo código TRX. Selecione a tabela TRX e clique em editar( ), vá na parte de índices e clique em incluir( ) um novo índice.

Campo	Conteúdo
CHAVE	TRX_PLACA+DTOS(TRX_DTINFR)+TRX_RHINFR
NICKNAME
DESCRICAO	Placa Veicu. + Dta Infracao + Hra Infracao
DESCSPA	Placa Vehic. + Fch. Infrac. + Hora Infrac.
DESCENG	Vhc.Plate + Viol. Date + Viol. Time
MOTRA PESQ.	☑️
Virtualizado
IX_VIRCUST	3 - Padrão do Sistema

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

O parâmetro a ser adicionado é o MV_NGBROBO.

Campo	Conteú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

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

Grupo de Perguntas - MNTMWS

Ordem	Pergunta	Tipo	Tamanho	Help	Objeto	Pré Seleção(Combo)	item 1 (Combo/Check/Expression)	item 2 (Combo/Check)
1	De Data?	Data	8	Memo	Edit	-	-	-
2	Até Data?	Data	8	Memo	Edit	-	-	-
3	Criar Órgão Aut. Genérico?	Numérico	1	Memo	Combo	1	Não	Sim

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

Campo	Conteú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

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

Campo	Conteú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 ) TRX_PREFIX TRX_TIPO TRX_NATURE TRX_CONPAG Exemplo: MNT;BOL;FIN2000028;003
Descrição( X6_DESCRIC )	Campos para integração da multa com financeiro

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

Grupo de Perguntas - MNTMWSF

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.

Ordem	Pergunta	Tipo	Tamanho	Validação	Help	Objeto	Consulta Padrão(Edit)	Pré Seleção(Combo)	item 1 (Combo/Check/Expression)	item 2 (Combo/Check)
1	De Data?	Data	8	-	Memo	Edit	-	-	-	-
2	Até Data?	Data	8	-	Memo	Edit	-	-	-	-
3	Criar Órgão Aut. Genérico?	Numérico	1	-	Memo	Combo	-	1	Não	Sim
4	Fornecedor?	Caracter	6	MV_PAR03 == 1 .Or. ( MV_PAR03 == 2 .And. NaoVazio() .And. ExistCpo( 'SA2', MV_PAR04 ) )	Memo	Edit	Fornecedor	-	-	-
5	Loja?	Caracter	2	MV_PAR03 == 1 .Or. ( MV_PAR03 == 2 .And. NaoVazio() .And. ExistCpo( 'SA2', MV_PAR04 + MV_PAR05 ) )	Memo	Edit	-	-	-	-
6	Cond. Pagamento?	Caracter	3	MV_PAR03 == 1 .Or. ( MV_PAR03 == 2 .And. NaoVazio() .And. ExistCpo( 'SE4', MV_PAR06 ) )	Memo	Edit	Cond. de Pagamento	-	-	-

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

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).

https://platform.brobot.com.br/definitions?tab=users

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

Tabela	Índice	Descrição
TRX	9	TRX_PLACA + TRX_DTINFR + TRX_RHINFR

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

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

Exemplo:MNT;BOL;FIN2000028;003

Campo	Descriçã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.

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 .

Nº	Regra
1	Caso o parâmetro MV_NGBROBO não esteja configurado corretamente não será possível realizar o processo de importação de veículos.
2	Somente serão apresentados veículos que possuírem em seu cadastro os campos de Placa, Renavam e UF preenchidos.
3	Veículos que já estão cadastrados na Brobot serão apresentados como "Veículos não importados".

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 25/09/2024 serão importadas automaticamente.

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.

Defina como será processo de execução.

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

Padrão

Campo	Descrição
Empresa	Empresa na qual o Schedule será executado
Filial	Filial na qual o Schedule será executado
Módulo	Informar Módulo Gestão de Frotas( 95 )
Usuário	Em qual usuário será executado o Schedule
Descrição	Uma breve descrição do que se trata o Schedule

Rotina Grupo de Perguntas MNTMWS

Campo

Descriçã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ão	Sim
Não cria órgão genérico	Cria ó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.

Rotina Grupo de Perguntas MNTMSF

Campo

Descriçã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ão	Sim
Não cria órgão genérico	Cria ó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!

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:

Item	Descrição
Usuário	Usuário em que o processo foi executado
Data	Data da ocorrência
Hora	Hora da ocorrência
Mensagem	Mensagem de erro

Regras de Negócio

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

Nº	Regra
1	Não será possível efetuar a importação das multas caso os Parâmetros não estejam devidamente cadastrados.
2	Necessá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

Parâmetro	Descriçã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_NGMNTFI	Integraçã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

Árvore de páginas

Integração Protheus(SIGAGFR/Multas) com Brobot