ANTT Agncia Nacional de Transportes Terrestres

Manual do Usurio - MUS

MONITRIIP - PORTAL

MONITRIIP - Portal

Manual do Usurio
Verso 1.0

MANUAL DO USURIO MONITRIIP

Histrico de Reviso
Data

Verso

24/06/2016

1.0

Criao do documento

Maiza Barbosa
Dures

07/07/2016

1.1

Reviso e ajustes no Documento

talo Gomes lvares

V 1.0

Descrio

Autor

24/06/16

Pgina 2 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

Sumrio
1. INTRODUO.........................................................................................................................4
2. FLUXOGRAMA........................................................................................................................5
3. ACESSO......................................................................................................................................7
4. MENU: FORNECEDORES...................................................................................................8
4.1

FORNECEDORES PRIMEIRO ACESSO................................................................9

4.2

FORNECEDORES LOGIN...........................................................................................11

4.2.1 Fornecedores LOGIN RECUPERAR A SENHA............................................12

4.3

FORNECEDORES PGINA INICIAL......................................................................13

4.4

FORNECEDOR DADOS CADASTRAIS................................................................13

4.5

FORNECEDORES APLICAO................................................................................14

4.5.1 FORNECEDORES APLICAO NOVO.............................................................15

4.5.2 FORNECEDORES APLICAO EDITAR...........................................................16
4.5.3 FORNECEDORES APLICAO VISUALIZAR SERVIOS
HOMOLOGADOS DA LTIMA VERSO............................................................................17
4.5.4 FORNECEDORES APLICAO GERENCIA VERSES E TOKEN..........18
5. MENU: EMPRESAS DE TRANSPORTE......................................................................21
5.1

EMPRESA DE TRANSPORTE PRIMEIRO ACESSO........................................22

5.2

EMPRESA DE TRANSPORTE > LOGIN.................................................................23

5.2.1 EMPRESAS DE TRANSPORTE LOGIN RECUPERAR A SENHA............24

5.3

EMPRESAS DE TRANSPORTE PGINA INICIAL..........................................26

5.4

EMPRESA DE TRANSPORTE DADOS CADASTRAIS...................................26

5.5

EMPRESA DE TRANSPORTE VINCLAR APLICAO...................................27

5.6 EMPRESA DE TRANSPORTE RELATRIO DE SERVIOS

EXECUTADOS................................................................................................................................28
6. REFERNCIAS.......................................................................................................................29
7. SUPORTE.................................................................................................................................29
8. PERGUNTAS FREQUENTES...........................................................................................29
9. ASSINATURAS......................................................................................................................30

V 1.1

07/07/16

Pgina 3 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

Manual do Usurio
1. INTRODUO
O sistema de Monitoramento do Transporte Rodovirio Interestadual e Internacional Coletivo
de Passageiros, denominado MONITRIIP, foi planejado com a finalidade de receber, armazenar e
disponibilizar diversos dados, tais como a localizao de veculos, a venda de passagens, os
pontos de paradas, e outros. Atravs desses dados ser possvel fazer o acompanhamento em
tempo real das viagens, alm de gerar, dentre outros, os indicadores necessrios para medir a
pontualidade e a regularidade dos servios de transporte semiurbano, rodovirio e fretado.
A transmisso dos dados para o MONITRIIP ser feita via Webservice e utilizando a
tecnologia 3G, que possui uma capacidade de rede maior e permite a transmisso de dados por
longas distncias, tudo em ambiente mvel. Para garantir que os dados sejam enviados nos
formatos e pelas aplicaes aceitas pela ANTT, sero utilizados tokens, que sero fornecidos
pela Agncia aos fabricantes das solues.
O portal MONITRIIP a soluo que permite o cadastro das empresas fornecedoras do
software de envio dos dados e das empresas de transporte, ou seja, as empresas responsveis
pelo transporte rodovirio nacional, rodovirio internacional, semiurbano nacional, semiurbano
internacional e fretado. Atravs dele as empresas fornecedoras podem ter acesso s
informaes necessrias criao e utilizao das aplicaes, como o Documento de Interface
de Software e os tokens para autenticao nos ambientes de homologao e produo. J as
empresas de transporte podem informar qual aplicativo de qual empresa fornecedora utilizaro
para enviar os dados ao Webservice.

V 1.1

07/07/16

Pgina 4 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

2. FLUXOGRAMA

Fluxograma 01: Fluxo portal

V 1.1

07/07/16

Pgina 5 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

Fluxograma 02: Fluxo validao WS

V 1.1

07/07/16

Pgina 6 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

3. ACESSO
O
acesso
ao
portal
ser
atravs
do
seguinte
endereo:
https://appweb1.antt.gov.br/monitriipPortal/default.aspx. Ao acess-lo so disponibilizados os
menus de contedo e acesso s reas logadas de fornecedor e empresa de transporte. O menu
de acesso composto pelos seguintes itens:

Apresentao: Neste item so descritos o que o MONITRIIP, como ele composto,

quais as suas finalidades e as vantagens oferecidas s empresas e aos usurios.

Legislao: Ao clicar neste item o usurio direcionado para o endereo:

http://www.antt.gov.br/index.php/content/view/355/Legislacao.html,
onde
pode
ser
encontrada a legislao que define o tipo, a estruturao, a coleta, o armazenamento, a
disponibilizao e o envio dos dados coletados pelo Sistema de Monitoramento do
Transporte Rodovirio Interestadual e Internacional Coletivo de Passageiros.

Fornecedor: Este item voltado para as empresas fornecedoras de software.

Empresas de Transporte: Este item voltado para as empresas que fornecem servios
de transporte rodovirio nacional, semiurbano internacional, rodovirio internacional,
fretamento e semiurbano nacional.

Download: Nesta rea esto os arquivos necessrios ao desenvolvimento e integrao

das aplicaes de monitoramento. XSD e DIS.

Fale conosco: Item que permite que dvidas a respeito do MONITRIIP sejam
esclarecidas. Ao ser acionado a tela redirecionada rea de contato e perguntas mais
frequentes do portal da ANTT.

V 1.1

07/07/16

Pgina 7 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

Figura 01: Pgina inicial do portal

4. MENU: FORNECEDORES
Este menu voltado para as empresas fornecedoras de softwares. Caso seja o primeiro
acesso, o usurio deve selecionar o link Clique aqui, sendo ento direcionado para a tela de
cadastro. O menu fornecedores serve tanto para o primeiro quanto para os acessos posteriores,
aps confirmao via e-mail.

V 1.1

07/07/16

Pgina 8 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

Figura 02: login de fornecedor

V 1.1

07/07/16

Pgina 9 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

4.1

FORNECEDORES PRIMEIRO ACESSO

Ao selecionar a opo clique aqui, o sistema apresentar a tela de cadastro como ilustrado
na imagem a seguir:

Figura 03: Cadastro de fornecedor

A tela de cadastro possui as opes:

V 1.1

: Armazena os dados e direciona para a tela de login.

: Remove os dados informados nos campos e mantm na mesma tela.

: Adicionar telefone informado.

: Excluir telefone inserido.

07/07/16

Pgina 10 de 31

PORTAL MONITRIIP
MANUAL DO USURIO
Para realizar o cadastro, o usurio deve informar os dados de fornecedor e selecionar a
opo
. Todo cadastro realizado deve ser confirmado pelo fornecedor. Aps isso, o
sistema enviar mensagem eletrnica de confirmao para o e-mail informado no cadastro. O
fornecedor deve clicar no link enviado, concluindo o processo de cadastro e ativando o acesso a
rea logada.

Figura 04: Tela de liberao de acesso.

V 1.1

07/07/16

Pgina 11 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

4.2

FORNECEDORESLOGIN

Para acessar a rea de empresas fornecedoras de software, o usurio deve clicar no menu
fornecedores, preencher os campos CPF e senha, e clicar em

Figura 05: login de fornecedor

V 1.1

07/07/16

Pgina 12 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

4.2.1 FornecedoresLOGINRECUPERAR A SENHA

Para recuperar a senha, o usurio deve clicar no boto
, preencher os campos
CPF e e-mail, e clicar em enviar. A senha ser enviada para o e-mail cadastrado.

Figura 06: Esqueci a senha

Observaes:
O sistema valida o CPF e o E-mail com os dados cadastrados, retornando assim a senha
ao e-mail que foi informado no ato do cadastro do usurio.

V 1.1

07/07/16

Pgina 13 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

4.3

FORNECEDORESPGINA INICIAL

Aps Login o sistema exibe a pgina inicial da rea logada de fornecedores, onde possvel
navegar pelos menus: Dados Cadastrais, Aplicao e Documentos.

Figura 07: Pgina inicial da rea logada de fornecedor.

Os menus acima so:

Dados Cadastrais: So os dados que foram preenchidos inicialmente para ter acesso
ao MONITRIIP.
Aplicao: Onde a empresa fornecedora dever cadastrar os dados da aplicao;
Documentos: Documentos relacionados ao desenvolvimento e integrao de dados
para aplicaes de monitoramento (XSD e DIS).

4.4

FORNECEDORDADOS CADASTRAIS

O sistema exibe tela contendo os dados cadastrais da fornecedora informados durante o

cadastro no portal MONITRIIP. Nesta tela podero ser feitas alteraes nestes dados.
As alteraes podero ser feitas atravs das seguintes aes:

: Armazena os dados e direciona para a tela de login.

: Remove os dados informados nos campos e mantm na mesma tela.
(Adicionar): Permite adicionar telefone informado.
(Excluir): Permite a excluso do telefone inserido.

Aps serem executadas todas as alteraes, clique em salvar para armazenar os dados.

V 1.1

07/07/16

Pgina 14 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

Figura 08: Dados cadastrais de fornecedor

4.5

FORNECEDORESAPLICAO

O menu Aplicao, que est disponvel na rea logada de fornecedor, permite empresa
fornecedora cadastrar os dados da aplicao.
A tela conta com os itens pesquisar e novo, descritos abaixo:
: Executa a pesquisa com base nos argumentos inseridos nos campos
Nome e Linguagem.

: Redireciona para a tela de cadastro da aplicao.

Opes disponibilizadas na listagem de aplicaes cadastradas:

V 1.1

: Editar aplicao;
: Visualizar servios homologados na ltima verso;
: Gerencia Verses e token.

07/07/16

Pgina 15 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

Figura 09: Pesquisa de aplicao

4.5.1 FORNECEDORESAPLICAO NOVO

Na opo
seguintes campos:

, redireciona tela de cadastro de aplicao. Esta tela possui os

Nome: Nome da nova aplicao.

Linguagem: Linguagem que a aplicao foi desenvolvida.
Detalhes da aplicao: Descrio gerais da aplicao.
Verso: Verso atual da aplicao.
Detalhes da Verso: Descrio dos servios ou funcionalidades contidas na verso
especfica.
O Usurio deve preencher todos os campos e clicar em
A opo

V 1.1

, retorna para os dados da consulta.

07/07/16

Pgina 16 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

Figura 10: Cadastro de aplicao

4.5.2 FORNECEDORESAPLICAOEDITAR
Este item est disponvel na listagem de aplicaes cadastradas, disponibilizado na tela de
aplicao[4.5].
Aps o clique em
Editar aplicao, o sistema redirecionar para a tela de edio de
aplicao.
A tela conta com os seguintes campos: Nome, Linguagem e Detalhes da Aplicao que
podero ser editados.
O usurio pode alterar as informaes dos campos, clicar em
A opo

V 1.1

, retorna para os dados da consulta.

07/07/16

Pgina 17 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

Figura 11: Tela de edio de aplicao.

4.5.3 FORNECEDORESAPLICAOVISUALIZAR SERVIOS

HOMOLOGADOS DA LTIMA VERSO
Este item possibilita a visualizao de detalhes e servios da ltima verso da aplicao
homologada. Pode ser acionada pelo cone disponibilizado na tela de aplicao[4.5].
Os servios homologados foram agrupados em subescopo. Para que um aplicativo esteja
apto a ser utilizado necessrio que um subescopo esteja ativo, tendo sido portanto testado e
homologado, de forma que todos os servios desse subescopo sejam executados com sucesso.
Sero disponibilizados para as empresas de transporte somente as aplicaes que possuem
servios ativos e vinculados aos servios selecionados.
Subescopo: Venda de Passagens;
o Servio: Venda de Passagens;
Subescopo: Cartes emitidos e recargas;
o Servio: Cartes Emitidos & Recargas Efetuadas;
Subescopo: Ocorrncias do Transporte Rodovirio;
o Servio: Ocorrncias do Transporte Rodovirio;
Subescopo: Ocorrncias do Transporte Semiurbano;
o Servio: Ocorrncias do Transporte Semiurbano;
Subescopo: Rastreamento do Transporte;

V 1.1

07/07/16

Pgina 18 de 31

PORTAL MONITRIIP
MANUAL DO USURIO
Servio: Velocidade Tempo e Localizao, Jornada de Trabalho do Motorista,
Log do Detector de Parada, Incio/Fim de Viagem Regular, Incio/Fim de Viagem
Fretamento;
Subescopo: Leitor de Bilhete de embarque;
o Servio: Leitor de Bilhete de embarque;
Subescopo: Leitor de Carto de embarque RFID;
o Servio: Leitor de Carto RFID;
o

A opo

, retorna para os dados da consulta.

Figura 12: Lista de servios homologados para a verso selecionada.

4.5.4 FORNECEDORESAPLICAOGERENCIA VERSES E TOKEN

Esta funcionalidade possibilita o cadastro de uma nova verso da aplicao, alm de listar
todas as verses j cadastradas. Tambm permite a visualizao dos cdigos de autenticao
token gerados.
O portal disponibiliza dois tipos de token, um para validao da comunicao e servios
executados, chamado de token de homologao, e outro para execuo em produo, sendo
registrados os dados reais do servio;
O token de homologao gerado aps o registro da aplicao, sendo vinculado um token
para cada verso cadastrada.
O token de produo gerado aps o vnculo entre empresa de transporte e aplicao. Para
que este vnculo ocorra, a verso precisa conter subescopo de servio ativo.
Opes disponibilizada na listagem:

V 1.1

: Editar verso;
07/07/16

Pgina 19 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

: Visualizar servios homologados;

Figura 13: Cadastrar nova verso/ Gerenciar verses.

Observaes:
Para o consumo do servio do MONITRIIP, o endereo (end point) de homologao :
http://appservices.antt.gov.br:8956/antt/monitriip/rest/[SERVIO ]
Exemplo:
http://appservices.antt.gov.br:8956/antt/monitriip/rest/InserirLogVelocidadeTempoLocalizacao
As operaes disponveis so:
InserirLogVelocidadeTempoLocalizacao
InserirLogCartaoEmitidoRecargaEfetuada
InserirLogRegistroOcorrenciaRodoviario
InserirLogRegistroOcorrenciaSemiUrbano
InserirLogVelocidadeTempoLocalizacao
InserirLogJornadaTrabalhoMotorista
V 1.1

07/07/16

Pgina 20 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

InserirLogDetectorParada
InserirLogInicioFimViagemRegular
InserirLogInicioFimViagemFretado
InserirLogBilheteEmbarque
InserirLogLeitorCartaoRFID

Tanto para XML quanto para JSON a url a mesma. Basta passar no Content-Type da
requisio do tipo do contedo (application/xml ou application/json). Tambm importante
informar no cabealho da mensagem HTTP o token vlido atravs do header Authorization.
O token de homologao fica disponibilizado no menu aplicao cone de ao
Gerenciar verses e tokens a partir do cadastro de nova aplicao de monitoramento.
O Fornecedor s receber o token de produo se contratado e cadastrado por empresa de
transporte autorizada pela ANTT. O endereo (end point) de produo poder ento ser
solicitado por meio do endereo sistemas.suporte@antt.gov.br.

V 1.1

07/07/16

Pgina 21 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

5. MENU: EMPRESAS DE TRANSPORTE

O menu Empresas de Transporte voltado para as empresas que prestam servio de
transporte rodovirio nacional, semiurbano internacional, rodovirio internacional, fretamento e
Semiurbano nacional.
Nesta tela so disponibilizadas as opes de acesso, esqueci a senha e cadastro de empresa
de transporte.

Figura 14: Login de empresa de transporte

V 1.1

07/07/16

Pgina 22 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

5.1

EMPRESA DE TRANSPORTEPRIMEIRO ACESSO

Ao selecionar a opo clique aqui, o sistema apresentar a tela de cadastro como ilustrado
na imagem a seguir:

Figura 15: Cadastro de empresa de transporte

Para efetuar o primeiro acesso necessrio que o usurio faa o cadastro, informando os
dados abaixo:

V 1.1

CNPJ;
Razo Social;
Nome Fantasia;
E-mail da Empresa;
Cnae: ter uma barra de rolagem para escolha da opo adequada para a empesa.
CPF do representante;
Nome do representante;
07/07/16

Pgina 23 de 31

PORTAL MONITRIIP
MANUAL DO USURIO
E-mail do representante;
Todos os itens supracitados so de preenchimento obrigatrio.
Ainda, o usurio dever escolher qual servio ser habilitado, dentre as opes listadas
abaixo:

Rodovirio nacional;
Semiurbano Internacional;
Rodovirio Internacional;
Fretamento;
Semiurbano Nacional.

Por fim, o usurio deve informar a senha que ser utilizada posteriormente para logar. Aps
o preenchimento dos dados do cadastro, o usurio deve clicar em Salvar.
Todo cadastro realizado dever ser confirmado pela empresa atravs de mensagem
eletrnica que ser encaminhada para o e-mail informado no cadastro. A empresa dever ento
clicar no link enviado, concluindo o processo de cadastro e ativando o acesso a rea logada.

Figura 16: Pgina inicial da rea logada da empresa de transporte

5.2

EMPRESA DE TRANSPORTE > LOGIN

Para acessar a rea de Empresas de Transporte, o usurio deve clicar no menu Empresa de
Transporte, preencher os campos CPF e senha , e clicar em
a seguir:

V 1.1

, como ilustrado

07/07/16

Pgina 24 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

Figura 17: Login de empresa de transporte

5.2.1 EMPRESAS DE TRANSPORTELOGINRECUPERAR A SENHA

Para recuperar a senha, o usurio deve clicar no boto
, preencher os campos
CPF e e-mail, e clicar em enviar. A senha ser enviada para o e-mail cadastrado.

V 1.1

07/07/16

Pgina 25 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

Figura 18: Esqueci a senha

Observaes:
O sistema valida o CPF e o E-mail com os dados cadastrados, retornando assim a senha
ao e-mail que foi informado no ato do cadastro do usurio.

V 1.1

07/07/16

Pgina 26 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

5.3

EMPRESAS DE TRANSPORTE PGINA INICIAL

Aps Login, o sistema exibe a pgina inicial da rea logada de Empresa Transportadora,
onde possvel navegar pelos menus: Dados Cadastrais, Vincular Aplicao e Relatrio servio
Executados.

Figura 19: Esqueci a senha

Os menus acima so:
Dados Cadastrais - neste item podero ser feitas alteraes nos dados que foram
preenchidos para liberao de acesso, como por exemplo o endereo;
Vincular Aplicao - este item para vincular a aplicao empresa de transporte;
Relatrio de servios executados - este item um detalhamento de todos os
servios ativos por aplicao vinculada empresa de transporte;

5.4

EMPRESA DE TRANSPORTEDADOS CADASTRAIS

O sistema exibe tela contendo os dados cadastrais da Empresa de Transporte informados

durante o cadastro no portal MONITRIIP. Nesta tela podero ser feitas alteraes nestes dados.
As alteraes podero ser feitas atravs das seguintes aes:

: Armazena os dados e direciona para a Pagina Inicial de Empresa de

Transportes[5.3].

: Retorna para a tela inicial da rea logada de empresa de transporte.

Aps serem executadas todas as alteraes, o usurio deve clicar em salvar para
armazenar os dados.

V 1.1

07/07/16

Pgina 27 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

Figura 18: Dados cadastrais de empresa de transporte

5.5

EMPRESA DE TRANSPORTEVINCULAR APLICAO

Atravs do menu Vincular Aplicao, a empresa de transporte pode fazer o vnculo dos
seus servios s aplicaes disponibilizadas pelos fornecedores.
Para realizar vnculo necessrio que existam aplicaes cadastradas e homologadas.

V 1.1

: Armazena os dados selecionados e realiza o vnculo entre a empresa de

transporte e a aplicao.
07/07/16

Pgina 28 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

: Retorna para a tela inicial da rea logada de Empresa de Transporte[5.3].

: Disponibilizado na lista de aplicaes vinculadas. Ao ser acionado remove o
vnculo cadastrado.

Figura 19: Vincular aplicao

5.6

EMPRESA DE TRANSPORTERELATRIO DE SERVIOS

EXECUTADOS

Este relatrio apresenta os servios ativos por aplicao vinculada, permitindo uma anlise
de utilizao de servio por aplicao. Lista todos os servios possveis de execuo e todas as
aplicaes vinculadas.
So consideradas ativas aquelas aplicaes cujos servios de um determinado subescopo
foram executados com sucesso no ambiente de homologao. Sero marcados com o cone
aqueles servios no executados pela aplicao e marcados pelo cone
com sucesso.

V 1.1

aqueles executados

07/07/16

Pgina 29 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

Figura 20: Relatrio de servios executados.

6. REFERNCIAS
Documentos de caso de uso
Documento de regra de negcio
Documento de viso.

7. SUPORTE
Em caso de problemas identificados no portal deve ser realizado contato atravs do e-mail
sistemas.suporte@antt.gov.br.

8. PERGUNTAS FREQUENTES
No se aplica.

V 1.1

07/07/16

Pgina 30 de 31

PORTAL MONITRIIP
MANUAL DO USURIO

9. ASSINATURAS
Os abaixo assinados esto de acordo com o contedo deste documento.
Data: ___/___/_____

Aloisio Caixeta

Jamil Buzar

Especialista em Regulao

Analista

SUPAS ANTT

SUPAS - ANTT

Data: ___/___/_____

V 1.1

Data: ___/___/_____

Data: ___/___/_____

Andr Botin

Fabio de Castro

Analista GETIN

Gerente de projeto

GETIN - ANTT

Squadra

07/07/16

Pgina 31 de 31