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

  • É 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.

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

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

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

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


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

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


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

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.

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

MNTMWSVLD(1)

Memo

Edit

SA2 - Fornecedor

-

-

-

5Loja?

Caracter

2

MNTMWSVLD(2)

Memo

Edit

-

-

-

-

6Cond. Pagamento?

Caracter

3

MNTMWSVLD(3)

Memo

Edit

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


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


Para outra configuração necessária, 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 TRZ. Selecione a tabela TRZ e clique em editar( ). Vá na parte de campos e selecione TRZ_NOMOR e clique em editar , na aba de campo altere o valor de 'Tamanho' para 75.


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

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 .

Regra
1Caso o parâmetro MV_NGBROBO não esteja configurado corretamente não será possível realizar o 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".

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. 

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

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.


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!

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

Regras de Negócio

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

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

Conteúdos Relacionados