Publicado no DOE - RS em 31 jul 2017
Introduz modificações na Portaria DETRAN/RS nº 471/2015 e alterações.
(Revogado pela Portaria DETRAN Nº 477 DE 16/11/2022):
O Diretor-Geral do Departamento Estadual de Trânsito do Estado do Rio Grande do Sul - DETRAN/RS, no uso das atribuições conferidas pelo artigo 6º da Lei Estadual nº 10.847/1996 , combinado com o art. 5º da Lei Estadual nº 14.479/2014 ;
Considerando os termos do artigo 22 da Lei Federal nº 9.503/1997, que instituiu o Código de Trânsito Brasileiro - CTB;
Considerando o disposto nas Resoluções CONTRAN nº 168/2004 e nº 361/2010, e suas alterações;
Considerando o contido na Portaria DENATRAN nº 238/2014 , que regulamenta o sistema eletrônico de anotação, transmissão e recepção dos relatórios de avaliação elaborados pelos Instrutores de Trânsito, relativos às aulas de prática de direção veicular ministradas aos pretendentes à obtenção do documento de habilitação;
Considerando a premência de se estabelecer os mecanismos necessários, em todo o Estado do Rio Grande do Sul, que permitam o controle, supervisão e fiscalização das aulas e os exames de direção veicular atinentes ao processo de habilitação, em todas as categorias;
Considerando o teor das Portarias DETRAN/RS nºs 471/2015, 531/2015, 113/2016 e 181/2016;
Considerando os estudos realizados pelo corpo técnico desta Autarquia, bem como as deliberações concretizadas em reunião de Diretoria;
Considerando o Termo de Acordo nº 01/2017 celebrado com o Sindicato dos Centros de Habilitação de Condutores e Auto e Moto Escolas do Estado do Rio Grande do Sul - SINDICFC;
Considerando, por fim, o contido no SPD nº 8772/2015;
Resolve:
Art. 1º Introduzir na Portaria DETRAN/RS nº 471/2015 e alterações as seguintes modificações, conforme infra:
I - O § 1º do art. 1º passa a vigorar com a seguinte redação:
"§ 1º O sistema previsto no caput deste artigo aplica-se as aulas e os exames práticos de direção veicular das categorias A, B, C, D, e E, bem como para a obtenção da Autorização para Conduzir Ciclomotores - ACC."
II - Acrescentar o § 3º no art. 1º com o seguinte teor:
"§ 3º Nas aulas e nos exames práticos de direção veicular para habilitação na categoria A, bem como para obtenção de Autorização para Conduzir Ciclomotores - ACC - o monitoramento de que trata o caput será realizado através da filmagem panorâmica das Pistas de Motos."
III - Alterar o inciso III do art. 3º que passa a ter a seguinte redação:
"Art. 3º (.....)
III - identificação detalhada do percurso realizado pelo candidato em cada aula, incluindo o(s) horário(s), exceto para a categoria A e ACC;"
IV - Alterar o § 4º do Art. 3º, conforme segue:
"Art. 3º(.....)
§ 4º A solução deverá contemplar a captura de, no mínimo, 05 (cinco) fotografias aleatórias do candidato durante a aula, exceto para a categoria A e ACC onde deverá haver captura de 02 (duas) fotografias do candidato, sem capacete, e 02 (duas) fotografias do instrutor, uma no início e outra no final da aula utilizando o tablet."
V - Alterar o caput e o inciso IV do art. 7º, os quais passam a vigorar com o seguinte texto:
"Art. 7º O sistema de filmagem de aulas práticas e exames práticos de direção veicular, para fins de monitoramento e controle, será composto pelos seguintes equipamentos:
(.....)
IV - no mínimo, 1 (uma) câmera de vídeo interna, na parte superior frontal do veículo, com foco no candidato e instrutor/examinador de trânsito, de forma a permitir o monitoramento do procedimento, exceto para categoria A e para obtenção de ACC que observam o disposto no parágrafo único deste artigo."
VI - Incluir o parágrafo único no art. 7º consoante redação abaixo:
"Parágrafo único. Nas categorias A e para obtenção de ACC o cumprimento do disposto no caput dar-se-á com filmagem panorâmica das Pistas de Motos, nas quais deverão ser instalada(s) a(s) câmera(s) necessária(s) ao monitoramento, de forma a abranger todo o percurso e as manobras realizadas pelo candidato à habilitação."
Art. 2º O monitoramento, através do registro eletrônico no tablet, das aulas e exames práticos de direção veicular para habilitação na categoria A e para obtenção da Autorização para Conduzir Ciclomotores- ACC, deverá ser implantado até 02.10.2017.
Art. 3º O monitoramento, através de filmagem panorâmica das Pistas de Motos, das aulas e exames práticos de direção veicular para habilitação na categoria A e para obtenção da Autorização para Conduzir Ciclomotores - ACC, deverá ser implantado até 30.01.2018. (Redação do artigo dada pela Portaria DETRAN/RS Nº 632 DE 27/12/2017).
Art. 4º Os Anexos da Portaria DETRAN/RS nº 471/2015 e alterações passam a ser os Anexos I, II, III, IV e V da presente normativa.
Art. 5º Fica revogada a Portaria DETRAN/RS nº 414/2016.
Art. 6º Esta Portaria entra em vigor na data de sua publicação.
Ildo Mário Szinvelski.
ANEXO I Serviço de Integração de Aulas Práticas Este documento tem por objetivo a definição de especificações e serviços para as integrações necessárias entre os softwares de aulas práticas utilizados em Centros de Formação de Condutores e os sistemas corporativos do DETRAN/RS.
Característica | Descrição |
Padrão da mensagem | A Integração se dará com serviços WEB HTTP desenvolvidos e hospedados na PROCERGS, utilizando a arquitetura REST (Representational State Transfer). |
REST | Conceitos: http://pt.wikipedia.org/wiki/REST |
HTTP STATUS | http://pt.wikipedia.org/wiki/Anexo:Lista_de_códigos_de_status_HTTP |
URL de acesso | https://mgfc.detran.rs.gov.br/gfc/rest/gfcmobile/aulaPratica |
Meio de comunicação | Internet |
Padrão de troca de mensagens | Troca de mensagens no formato texto através do content-type JSON (Javascript Object Notation). |
Autorização de acesso | DETRAN/RS vai fornecer os dados para acesso para cada empresa que desejar fazer a integração. |
Serviços previstos | Incluir uma aula prática Excluir uma aula prática Listar aulas práticas em inconformidades Consultar a situação de uma aula prática |
Falhas no recebimento |
Somente o retorno do serviço com HTTP.STATUS = 200 é garantia do recebimento da aula prática com sucesso. Outros status ou se não houver retorno do sistema do DETRAN/RS (Ex: devido algum erro de conexão, timeout, etc), deve ser realizada uma nova tentativa de envio dos dados. |
1) Serviço para incluir uma aula prática
1.1) O sistema solicita a inclusão.
1.2) DETRAN/RS: valida a solicitação de inclusão. Aceita ou rejeita a inclusão com base nas validações básicas.
1.3) Exemplo de uso:
Método HTTP:
@POST
Headers HTTP
organizacao: NomeEmpresa matricula: 99999999
senha: x9x9x9x Parâmetros:
"imei":"123456789123456",
"idAulaPratica":"1",
"cfc":"CHC99999",
"cpfAluno":"99999999999",
"cpfInstrutor":"99999999999",
"turno":"D",
"viaAula":"R",
"dthIniAula":"9999-99-99 99:99",
"dthFimAula":"9999-99-99 99:99",
"cargaHoraria":"1",
"categoria":"B",
"placa":"XXX9999",
"kmInicial":"100",
"kmFinal":"120",
"situacao":"1",
"origem":"1",
"indAdaptado":"0",
"justificativaAula":"",
"observacao":"OBS",
"indForaSede":"0",
"linkMapa":"http://empresa.com.br/mapa/id=1",
"linkVideo":"http://empresa.com.br/video/id=1",
"linkImagem":"http://empresa.com.br/imagem/id=1",
"qtdEventos":"2",
"listaEventos":[{"tipoEvento":"01","codEvento":"1001","dthEvento":"2015-06-05 10:31:12","observacao":"eventoteste
1"},{"tipoEvento":"01","codEvento":"1002","dthEvento":"2015-06-05
10:33:55","observacao":"evento teste 2"}]}
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
imei | Alfa | 18 | S | Código do Equipamento | Se não houver imei, enviar identificação única do equipamento |
idAulaPratica | Numérico | 12 | S | Identificação da aula no sistema de origem | Código único de aula na empresa |
cfc | Alfa | 8 | S | Código do credenciado | Ex.: CHC99999 |
cpfAluno | Alfa | 11 | S | CPF do Aluno | |
cpfInstrutor | Alfa | 11 | S | CPF do Instrutor | |
turno | Alfa | 1 | S | Turno da aula | D - Diurno N - Noturno |
viaAula | Alfa | 1 | S | Via da aula | R - Rodovia U - Urbana |
dthIniAula | Alfa | 16 | S | Data/Hora do início da aula | yyyy-MM-dd HH:mm |
dthFimAula | Alfa | 16 | S | Data/Hora do fim da aula | yyyy-MM-dd HH:mm |
cargaHoraria | Numérico | 1 | S | Carga horária da aula, que pode ser 1 hora aula ou 2 horas aula | - 50 minutos - 100 minutos |
categoria | Alfa | 4 | S | Categoria pretendida | A, ACC, B, C, D ou E |
placa | Alfa | 7 | S | Placa do veículo | Ex.: IAM1234 |
kmInicial | Numérico | 9 | S | Quilometragem do veículo no início da aula | |
kmFinal | Numérico | 9 | S | Quilometragem do veículo no fim da aula | |
situacao | Numérico | 1 | S | - realizada - Atendeu todos os requisitos - incompleta - Não atendeu o requisito do tempo | 1 - realizada 2-incompleta |
origem | Numérico | 1 | S |
1 - Aula com registro automático no dispositivo móvel/Camada Cliente 2 - Aula com registro manual no sistema Web/Camada Servidor |
1 - Automático 2 - Manual (contingência) |
indAdaptado | Numérico | 1 | S | Aula realizada para condutores que necessitam de veículos adaptados | 0 - Não 1 - Sim |
.
justificativaAula | Alfa | 500 | N | Motivo da aula ter sido interrompida (situação incompleta) ou motivo do registro | Obrigatório quando situação incompleta ou aulas enviadas em contingência | |
em contingência manual (origem manual) | ||||||
observacao | Alfa | 500 | N | Observações do Instrutor sobre a aula | ||
indForaSede | Numérico | 1 | S | - aula na sede - aula em município fora da sede | ||
linkMapa | Alfa | 100 | S | Link internet do mapa do percurso da aula | Campo opcional para categoria A e ACC. Senha de acesso deve ser fornecido ao DETRAN/RS | |
linkVideo | Alfa | 100 | N | Link internet da filmagem da aula | Senha de acesso deve ser fornecido ao DETRAN/RS | |
linkImagem | Alfa | 100 | S | Link internet das imagens aleatórias da aula | Senha de acesso deve ser fornecido ao DETRAN/RS | |
qtdEventos | Númérico | 4 | S | Quantidade de eventos sendo enviados na lista | ||
listaEventos | S | Tabela com os eventos ocorridos na aula. Devem ser informados infrações e erros. | ||||
dthEvento | Alfa | 19 | S | Data/Hora do evento | yyyy-MM-dd HH:mm:ss | |
tipoEvento | Alfa | 2 | S | Tipo do evento que pode corresponder ao conteúdo pedagógico, infração e outros... | Os tipos de eventos são fornecidos pelo DETRAN/RS | |
codEvento | Alfa | 8 | S | Código do evento que pode corresponder ao conteúdo pedagógico, infração e outros. | Os códigos de eventos são fornecidos pelo DETRAN/RS | |
observacao | Alfa | 500 | N | Observação sobre o evento | Obrigatório quando no evento de comportamento foi informado "Outros" |
Descrição do retorno:
Status HTTP | Descrição | Obs. |
200 | OK | A requisição foi concluída com sucesso. |
400 | Erro de validação | Será retornado os códigos de erro, conforme definido abaixo. Os códigos e as mensagens de erros são fornecidos pelo DETRAN/RS |
401 | Não autorizado | Falha de autenticação |
Requisição com status 400 retorna uma lista de erros conforme descrito abaixo, no formato JSON.
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
codErro | Alfa | 8 | S | Código do erro | |
msgErro | Alfa | 200 | S | Mensagem do erro |
Exemplo ilustrativo:
codErro = F007
msgErro = Placa Inválida
2) Para excluir uma aula prática
2.1) O sistema solicita a exclusão de uma aula prática.
2.2) DETRAN/RS: valida solicitação e aceita ou rejeita a ação, com base nas validações do sistema.
2.3) Exemplo de uso:
Método HTTP:
@DELETE
Headers HTTP:
organizacao: NomeEmpresa matricula: 99999999
senha: x9x9x9x
Parâmetros:
"idAulaPratica": 1,
"cfc": "CHC99999",
"cpfAluno": "99999999999"
"motivo": "Exclusão de aula incompleta devido a problema técnico"
Descrição do envio:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
idAulaPratica | Numérico | 12 | S | Identificação da aula no sistema de origem | |
cfc | Alfa | 8 | S | Código do credenciado | Ex.: CHC99999 |
cpfAluno | Alfa | 11 | S | CPF do Aluno | Ex.: 99999999999 |
motivo | Alfa | 500 | S | Motivo da exclusão da aula |
Descrição do retorno:
Status http | Descrição | Obs. |
200 | OK | A requisição foi concluída com sucesso. |
400 | Erro de validação | Os códigos de erros serão retornados pelo DETRAN/RS, conforme definido abaixo. |
401 | Não autorizado | Falha de autenticação. |
Requisição com status 400 retorna uma lista de erros conforme descrito abaixo, no formato JSON.
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
codErro | Alfa | 8 | S | Código do erro | |
msgErro | Alfa | 200 | S | Mensagem do erro |
Exemplo ilustrativo:
codErro = E001
msgErro = Identificação da aula deve ser informada
3) Serviço para listar as aulas práticas em situação de inconformidade
3.1) O sistema solicita a lista de aulas práticas em inconformidade.
3.2) DETRAN/RS: valida solicitação e aceita ou rejeita a ação, com base nas validações do sistema.
3.3) Exemplo de uso:
Método HTTP:
@GET
Headers HTTP:
organizacao: NomeEmpresa matricula: 99999999
senha: x9x9x9x Parâmetros:
"cfc": "CHC99999",
"dtPeriodoInicio": "2017-01-01",
"dtPeriodoFim": "2017-01-07", }
Descrição do envio:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
cfc | Alfa | 8 | S | Filtro código do credenciado cliente da empresa de filmagem | Ex.: CHC99999 |
dtPeriodoInicio | Alfa | 10 | S | Filtro período inicial | yyyy-MM-dd |
dtPeriodoFim | Alfa | 10 | S | Filtro período final | yyyy-MM-dd |
Descrição do retorno:
Status http | Descrição | Obs. |
200 | OK | A requisição foi concluída com sucesso. |
400 | Erro de validação | Será retornado os códigos de erro, conforme definido abaixo. Os códigos e as mensagens de erros são fornecidos pelo DETRAN/RS |
401 | Não autorizado | Falha de autenticação |
Requisição com status 200 retorna uma lista de inconformidades conforme descrito abaixo, no formato JSON.
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
idAulaPratica | Numérico | 12 | S | Identificação da aula no sistema de origem | Código único de aula na empresa |
cpfAluno | Alfa | 11 | S | CPF do Aluno | |
cpfInstrutor | Alfa | 11 | S | CPF do Instrutor | |
dthIniAula | Alfa | 16 | S | Data/Hora do início da aula | yyyy-MM-dd HH:mm |
dthFimAula | Alfa | 16 | S | Data/Hora do fim da aula | yyyy-MM-dd HH:mm |
Placa | Alfa | 7 | S | Placa do veículo | Ex.: IAM1234 |
txtInconformidade | Alfa | 4000 | S | Texto com a inconformidade da aula prática |
Requisição com status 400 retorna uma lista de erros conforme descrito abaixo, no formato JSON.
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
codErro | Alfa | 8 | S | Código do erro | |
msgErro | Alfa | 200 | S | Mensagem do erro |
Exemplo ilustrativo:
codErro = E001
msgErro = Identificação da aula deve ser informada
4) Serviços para consultar dados de uma aula prática
4.1) O sistema solicita a consulta de dados de uma aula prática.
4.2) DETRAN/RS: valida solicitação e aceita ou rejeita a ação, com base nas validações do sistema.
4.3) Exemplo de uso:
Método HTTP:
@GET
Headers HTTP:
organizacao: NomeEmpresa matricula: 99999999
senha: x9x9x9x
Parâmetros:
"idAulaPratica": 1,
"cfc": "CHC99999",
"cpfAluno": "99999999999"
Descrição do envio:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
idAulaPratica | Numérico | 12 | S | Identificação da aula no sistema de origem | |
CFC | Alfa | 8 | S | Código do credenciado cliente da empresa de filmagem | Ex.: CHC99999 |
cpfAluno | Alfa | 11 | S | CPF do Aluno | Ex.: 99999999999 |
Descrição do retorno:
Status http | Descrição | Obs. |
200 | OK | A requisição foi concluída com sucesso. |
400 | Erro de validação | Será retornado os códigos de erro, conforme definido abaixo. Os códigos e as mensagens de erros são fornecidos pelo DETRAN/RS |
401 | Não autorizado | Falha de autenticação |
Requisição com status 200 retorna uma lista de inconformidades conforme descrito abaixo, no formato JSON.
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
idAulaPratica | Numérico | 12 | S | Identificação da aula no sistema de origem | Código único de aula na empresa |
cpfAluno | Alfa | 11 | S | CPF do Aluno | |
cpfInstrutor | Alfa | 11 | S | CPF do Instrutor | |
dthIniAula | Alfa | 16 | S | Data/Hora do início da aula | yyyy-MM-dd HH:mm |
dthFimAula | Alfa | 16 | S | Data/Hora do fim da aula | yyyy-MM-dd HH:mm |
Turno | Alfa | 1 | S | Turno da aula | D - Diurno N- Noturno |
viaAula | Alfa | 1 | S | Via da aula | R - Rodovia U - Urbana |
cargaHoraria | Numérico | 1 | S | Carga horária da aula, que pode ser 1 hora aula ou 2 horas aula | - 50 minutos - 100 minutos |
Categoria | Alfa | 4 | S | Categoria pretendida | A, ACC, B, C, D ou E |
Placa | Alfa | 7 | S | Placa do veículo | Ex.: IAM1234 |
kmInicial | Numérico | 9 | S | Quilometragem do veículo no início da aula | |
kmFinal | Numérico | 9 | S | Quilometragem do veículo no fim da aula | |
situacaoAula Detran | Numerico | 2 | S | Situação da aula no sistema do Detran |
3 - Aguardando processamento 4 - Inconformidade 6 - Registrada 8 - Aula cancelada 10 - Incompleta - Aguardando homologação - Rejeitada - Excluída - Inutilizada |
txtInconformidade | Alfa | 4000 | N | Texto com a inconformidade da aula prática |
Requisição com status 400 retorna uma lista de erros conforme descrito abaixo, no formato JSON.
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
odErro | Alfa | 8 | S | Código do erro | |
sgErro | Alfa | 200 | S | Mensagem do erro |
Exemplo ilustrativo:
codErro = E001
msgErro = Identificação da aula deve ser informada
ANEXO II Serviço de Consulta Data e Hora Oficial Este documento tem por objetivo a definição de especificação e serviço para a consulta de data e hora oficial do servidor DETRAN/RS.
Característica | Descrição |
Padrão da mensagem | A Integração se dará com serviços WEB HTTP desenvolvidos e hospedados na PROCERGS, utilizando a arquitetura REST (Representational State Transfer). |
REST | Conceitos: http://pt.wikipedia.org/wiki/REST |
HTTP STATUS | http://pt.wikipedia.org/wiki/Anexo:Lista_de_códigos_de_status_HTTP |
URL de acesso | https://mgfc.detran.rs.gov.br/gfc/rest/gfcmobile/dataHoraOficial |
Meio de comunicação | Internet |
Padrão de troca de mensagens | Troca de mensagens no formato texto através do content-type JSON (Javascript Object Notation). |
Autorizaçã o de acesso | DETRAN/RS vai fornecer os dados para acesso para cada empresa que desejar fazer a integração. |
O serviço:
1.1) @POST
Serviço para validação da data e hora local do dispositivo móvel com o horário oficial do DETRAN/RS
2) Validação data e hora
2.1) O equipamento móvel da empresa fornecedora solicita a validação.
2.2) O sistema do DETRAN/RS valida a data e hora enviada pelo dispositivo móvel. Validar o horário ao menos uma vez ao dia. Sugestão de uso do serviço ao sincronizar as aulas com o equipamento.
2.3) Exemplo de uso:
Método HTTP:
@POST
Headers HTTP:
organizacao: NomeEmpresa matricula: 99999999
senha: x9x9x9x Parâmetros:
"cfc": "CHC99999"
"imei":"123456789123456"
"dataHora":9999-99-99 99:99:99
Descrição do envio:
Campo | Tipo | Tamanho | Obrigatór io | Descrição | Obs. |
cfc | Alfa | 8 | S | Código do CFC | |
imei | Alfa | 18 | S | Código do dispositivo móvel | |
dataHora | Alfa | 19 | S | Data e hora do dispositivo móvel | yyyy-MM-dd HH:mm:ss |
Descrição do retorno:
Status HTTP | Descrição | Obs. |
200 | OK | A requisição foi concluída com sucesso. |
400 | Erro de validação | Será retornado os códigos de erro, definidos pelo sistema do DETRAN/RS, conforme definido abaixo. |
401 | Não autorizado | Falha de autenticação |
Requisições com status 400 retorna uma lista de erros conforme descrito abaixo, no formato JSON.
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
codErro | Alfa | 8 | S | Código do erro | |
msgErro | Alfa | 200 | S | Mensagem do erro |
Exemplo ilustrativo:
codErro = DTH001
msgErro = Horário do equipamento móvel dessincronizado. Ajuste o horário.
ANEXO III Integração sistema PPE com solução de Filmagens Este documento tem por objetivo a definição de especificações e serviços para as integrações necessárias entre o sistema de exame prático (sistema PPE) do DETRAN/RS e o software de filmagem contratado pelos Centros de Formação de Condutores.
A empresa fornecedora do software de filmagem deve implementar estes serviços de comunicação e disponibilizar no equipamento gerenciador das câmeras em cada veículo.
Característica | Descrição |
Padrão da mensagem | A Integração se dará com serviços WEB HTTP utilizando a arquitetura REST (Representational State Transfer). |
REST | Conceitos: http://pt.wikipedia.org/wiki/REST |
HTTP STATUS | http://pt.wikipedia.org/wiki/Anexo:Lista_de_códigos_de_status_HTTP |
URL de acesso | O fornecedor da solução deverá informar qual a URL do seu gerenciador de filmagens para cada tablet cadastrado |
Meio de comunicação | A comunicação dos tablets com os equipamentos gerenciadores de filmagens dos carros será feita através de rede WI-FI. Os nomes das redes deverão conter a placa do veículo em seu nome SSID, no formato AAA9999, e deverão estar previamente configuradas na lista de redes WI-FI com segurança avançada (WPA/WAP2) conhecidas (com a chave de segurança já informada e salva) do tablet. Todas as redes dos veículos que irão participar da turma devem estar cadastradas em cada um dos tablets da turma. |
Padrão de troca de mensagens | Troca de mensagens no formato texto através do content-type JSON (Javascript Object Notation). |
Credencial de acesso | A comunicação com as câmeras não utilizará credenciais. |
Método de acesso.
Comunicação através dos métodos:
POST - utilizado nos serviços de inclusão.
GET - utilizado nos serviços de consulta.
Serviços previstos para comunicação.
Abaixo estão descritos os serviços para comunicação do sistema PPE com o software de filmagem contratada pelo CFC.
2.1) Teste da filmagem http:///filmagem/teste
2.2) Início da filmagem http:///filmagem/inicio
2.3) Teste da conexão http:///filmagem/status
2.4) Fim da filmagem http:///filmagem/fim
3. Códigos de retorno previstos.
Status HTTP | Descrição | Obs. |
200 | OK | A requisição foi concluída com sucesso. |
400 | Requisição inválida | A requisição foi concluída com erros. |
O detalhamento dos dados de retorno para os Status HTTP será descrito em cada serviço.
4) Teste da filmagem.
Este serviço, obrigatoriamente, deverá ser utilizado no momento do checklist do veículo.
4.1) O sistema PPE executa chamada deste serviço, enviando por parâmetro a Placa do veículo e legenda.
4.2) A aplicação gerenciadora das câmeras efetua a ativação e gravação da filmagem de todas as câmeras instaladas no veículo.
4.3) Deve gerar 3 segundos de vídeo e finalizar a gravação da filmagem.
4.4) Deve aparecer na filmagem o parâmetro "legendaFilme" enviado.
4.5) A aplicação gerenciadora das câmeras retorna ao sistema PPE a identificação do vídeo, a placa do veículo em que a rede local está conectada e a data e hora do fim da filmagem.
Descrição dos dados de envio:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
placaVeiculo | Alfa | 07 | S | Placa do veículo no PPE | Fomato: XXX9999 |
legendaFilme | Alfa | 50 | S | Texto para constar na filmagem (marca d'água) |
Descrição dos dados de retorno - Status 200:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
IdVideo | Alfa | 255 | S | URL de consulta do vídeo no sistema da empresa fornecedora | |
placaVeiculo | Alfa | 07 | S | Placa do veículo em que o equipamento de filmagem está conectado. | Formato: XXX9999 |
dataHora | Alfa | 19 | S | Data e hora fim da filmagem | YYYY-MM-DD HH:MM:SS |
Descrição dos dados de retorno - Status 400:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
codErro | Alfa | 08 | S | Código do erro | |
msgErro | Alfa | 200 | S | Mensagem de erro |
Exemplo de erros de retorno - Status 400:
codErro | MsgErro |
TF001 | Parâmetro Placa veículo inválido ou não informado |
TF002 | Parâmetro Legenda filme não informado |
TF003 | Problema no equipamento de filmagem |
TF004 | Falta de espaço para armazenamento da filmagem |
TF005 | Aplicativo conectado em rede WI-FI diferente da placa da prova |
Abaixo exemplo de uso do serviço Teste da Filmagem:
Método HTTP:
@POST
Parâmetros de envio:
"placaVeiculo":"ABC1234",
"legendaFilme":"ABC1234 - Teste Filmagem"
Parâmetros de retorno - Status 200:
"idVideo":"https://empresafornecedora.com.br/videosDetran/consulta/?idVideo=xyz"
"placaVeiculo":"ABC1234",
"dataHora":"2015-09-05 08:56:00"
Parâmetros de retorno - Status 400:
"codErro":"TF001",
"msgErro": "Parâmetro Placa veículo inválido ou não informado"
5) Início da filmagem.
Este serviço deverá ser utilizado no momento do início do exame prático. Será chamado pelo sistema PPE no clique do botão "Pronto para início".
5.1) O sistema PPE envia solicitação para início da filmagem, enviando o número do exame, a placa do veículo e a legenda.
5.2) A aplicação gerenciadora das câmeras efetua a ativação e gravação da filmagem de todas as câmeras instaladas no veículo, vinculando o número do exame ao arquivo de vídeo.
5.3) Deve aparecer na filmagem o parâmetro "legendaFilme" enviado.
5.4) A aplicação retorna o número do exame, a placa do veículo em que a rede local está conectada, a identificação do vídeo e a data e hora do início da filmagem.
Descrição dos dados de envio:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
NroExame | Numérico | 10 | S | Identificação do exame prático | |
placaVeiculo | Alfa | 07 | S | Placa do veículo no PPE | Fomato: XXX9999 |
legenda Filme | Alfa | 50 | S | Texto para constar na filmagem (marca dágua) |
Descrição dos dados de retorno - Status 200:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
nroExame | Numérico | 10 | S | Identificação do exame prático | |
placaVeiculo | Alfa | 07 | S | Placa do veículo em que o equipamento de filmagem está conectado. | Fomato: XXX9999 |
idVideo | Alfa | 255 | S | URL de consulta do vídeo do exame no sistema da empresa fornecedora | |
dataHora | Alfa | 19 | S | Data e hora do início da filmagem do gerenciador de filmagem | YYYY-MM- DD HH:MM:SS |
Descrição dos dados de retorno - Status 400:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
codErro | Alfa | 08 | S | Código do erro | |
msgErro | Alfa | 200 | S | Mensagem de erro |
Exemplo de erros de retorno - Status 400:
codErro | MsgErro |
IF001 | Parâmetro Número Exame inválido ou não informado |
IF002 | Parâmetro Legenda filme não informado |
IF003 | Problema no equipamento de filmagem |
IF004 | Falta de espaço para armazenamento da filmagem |
IF005 | Outra gravação em andamento |
IF006 | Aplicativo conectado em rede WI-FI diferente da placa da prova |
Abaixo exemplo de uso deste serviço:
Método HTTP:
@POST
Parâmetros de envio:
"nroExame":0001234567,
"placaVeiculo":"ABC1234",
"legendaFilme":"Nro.Exame 00012345-67"
Parâmetros de retorno - Status 200:
"nroExame": 0001234567,
"placaVeiculo":"ABC1234",
"idVideo":"https://empresafornecedora.com.br/videosDetran/consulta/?idVideo=wxy",
"dataHora":"2015-09-05 10:00:00"
Parâmetros de retorno - Status 400:
"codErro":"TF001",
"msgErro": "Parâmetro Legenda filme não informado"
6) Teste da conexão.
Este serviço será utilizado para verificação da conexão do sistema PPE com a aplicação gerenciadora da filmagem. Este serviço será ativado, em intervalos de tempo, durante a filmagem da aplicação do Exame Prático.
6.1) O sistema PPE, aleatoriamente, envia o número do exame, a placa do veículo e a identificação do vídeo para teste de conexão com a aplicação gerenciadora da filmagem.
6.2) A aplicação retorna o número do exame, a placa do veículo, a identificação do vídeo e a data e hora do teste da filmagem.
Descrição dos dados de envio:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
nroExame | Numérico | 10 | S | Identificação do exame prático | |
placaVeiculo | Alfa | 07 | S | Placa do veículo no PPE | Fomato: XXX9999 |
idVideo | Alfa | 255 | S | URL de consulta do vídeo do exame no sistema da empresa fornecedora |
Descrição dos dados de retorno - Status 200:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
nroExame | Numérico | 10 | S | Identificação do exame prático | |
placaVeiculo | Alfa | 07 | S | Placa do veículo em que o equipamento de filmagem está conectado. | Fomato: XXX9999 |
idVideo | Alfa | 255 | S | URL de consulta do vídeo do exame no sistema da empresa fornecedora | |
dataHora | Alfa | 19 | S | Data e hora do início da filmagem do gerenciador de filmagem | YYYY-MM-DD HH:MM:SS |
Descrição dos dados de retorno - Status 400:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
codErro | Alfa | 08 | S | Código do erro | |
msgErro | Alfa | 200 | S | Mensagem de erro |
Exemplo de erros de retorno - Status 400:
codErro | MsgErro |
TC001 | Parâmetro Número Exame inválido ou não informado |
TC002 | Problema no equipamento de filmagem |
TC004 | Falta de espaço para armazenamento da filmagem |
TC005 | Outra gravação em andamento |
TC005 | Nenhuma gravação em andamento |
TC006 | Aplicativo conectado em rede WI-FI diferente da placa da prova |
Abaixo exemplo de uso deste serviço:
Método HTTP:
@POST
Parâmetros de envio:
"nroExame":0001234567,
"placaVeiculo":"ABC1234",
"idVideo":"https://empresafornecedora.com.br/videosDetran/consulta/?idVideo=wxy"
Parâmetros de retorno - Status 200:
"nroExame":0001234567,
"placaVeiculo":"ABC1234",
"idVideo":"https://empresafornecedora.com.br/videosDetran/consulta/?idVideo=wxy",
"dataHora":"2015-09-05 10:00:00"
Parâmetros de retorno - Status 400:
"codErro":"TC001",
"msgErro": "Parâmetro Número Exame inválido ou não informado"
7) Fim da filmagem.
Este serviço deverá ser utilizado no momento do final da gravação do exame prático. Será chamado pelo aplicativo PPE no clique do botão "STOP" do percurso.
7.1) O sistema PPE envia solicitação para fim da filmagem, enviando o número do exame, a placa do veículo e a identificação do vídeo.
7.2) A aplicação gerenciadora das câmeras efetua a desativação e finalização da gravação da filmagem de todas as câmeras instaladas no veículo.
7.3) A aplicação retorna o número do exame, a placa do veículo e a identificação do vídeo e data e hora do fim da filmagem.
Descrição dos dados de envio:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
nroExame | Numérico | 10 | S | Identificação do exame prático | |
placaVeiculo | Alfa | 07 | S | Placa do veículo no PPE | Fomato: XXX9999 |
idVideo | Alfa | 255 | S | URL de consulta do vídeo do exame no sistema da empresa fornecedora |
Descrição dos dados de retorno - Status 200:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
nroExame | Numérico | 10 | S | Identificação do exame prático | |
placaVeiculo | Alfa | 07 | S | Placa do veículo em que o equipamento de filmagem está conectado. | Fomato: XXX9999 |
idVideo | Alfa | 255 | S | URL de consulta do vídeo do exame no sistema da empresa fornecedora | |
dataHora | Alfa | 21 | S | Data e hora do fim da filmagem | YYYY-MM- DD HH:MM:SS |
Descrição dos dados de retorno - Status 400:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
codErro | Alfa | 08 | S | Código do erro | |
msgErro | Alfa | 200 | S | Mensagem de erro |
Exemplo de erros de retorno - Status 400:
codErro | msgErro |
FF001 | Parâmetro Número Exame inválido ou não informado |
FF002 | Parâmetro Idetificação Vídeo inválido ou não informado |
FF003 | Problema no equipamento de filmagem |
FF004 | Outra gravação em andamento |
FF005 | Nenhuma gravação em andamento |
FF006 | Aplicativo conectado em rede WI-FI diferente da placa da prova |
Abaixo exemplo de uso deste serviço:
Método HTTP:
@POST
Parâmetros de envio:
"nroExame": 0001234567,
"placaVeiculo":"ABC1234",
"idVideo":"https://empresafornecedora.com.br/videosDetran/consulta/?idVideo=wxy", }
Parâmetros de retorno - Status 200:
"nroExame":0001234567,
"placaVeiculo":"ABC1234",
"idVideo":"https://empresafornecedora.com.br/videosDetran/consulta/?idVideo=wxy",
"dataHora":"2015-09-05 10:15:00"
Parâmetros de retorno - Status 400:
"codErro":"FF001",
"msgErro": "Parâmetro Número Exame inválido ou não informado"
ANEXO IV REQUISITOS MÍNIMOS DOS EQUIPAMENTOS
1. TABLET
1.1. Equipamento de computação pessoal tipo TABLET com, no mínimo, "7", com tela sensível ao toque;
1.2. Tela:
1.2.1. Tecnologia capacitiva;
1.2.2. Capacidade de multitoques para 10 pontos simultâneos;
1.2.3. Tecnologia LCD/IPS colorida;
1.2.4. Retro iluminada por LEDs;
1.2.5. Diagonal mínima de 7 polegadas;
1.2.6. Resolução mínima de 1024 x 600 pontos;
1.2.7. Contraste mínimo de 800:1 sob luz solar;
1.3. Processador:
1.3.1. Mínimo de quatro núcleos;
1.4. Memória RAM:
1.4.1. Capacidade mínima de 1 GByte;
1.5. Memória de armazenamento interno:
1.5.1. Capacidade mínima de 8 GBytes;
1.5.2. Tecnologia NAND FLASH;
1.6. Conectividade Wireless:
1.6.1. Wi-Fi IEEE 802.11 b/g/n
1.6.2. Bluetooth 4.0, A2DP;
1.7. Conectividade 3G Quad Band para operação com os protocolos:
1.7.1. HSDPA em 850, 900, 1900 e 2100 MHz;
1.7.2. GSM em 850, 900, 1800 e 1900 MHz;
1.7.3. GPRS;
1.7.4. EDGE;
1.8. Sistema de geolocalização por GPS assistido (A-GPS);
1.9. Câmera Frontal: 2 MegaPixels ou superior, microfone interno para videoconferência;
1.10. Porta USB 2.0 no formato micro USB com suporte a OTG;
1.11. Leitor de cartões de memória tipo microSD (Secure Digital) com capacidades mínima de 8 GigaBytes;
1.12. Cartão de memória tipo microSD (Secure Digital) com capacidades mínima de 8 GigaBytes;
1.13. Alto falantes stereo internos;
1.14. Conector de saída de áudio externo Stereo de 3,5 mm (P2) conjugado com entrada para microfone; sensor de movimento, detectando a orientação do aparelho de forma vertical e horizontal;
1.15. Sistema operacional Android 4.3 (JellyBean) ou superior em Português do Brasil;
1.16. Bateria de Polímero de Lítio com capacidade mínima de 3600 mAh e operação por pelo menos 8 horas em condições de uso normal;
1.17. Peso máximo do equipamento em condição normal de uso de 580 gramas;
1.18. Deve possuir selo de homologação e/ou certificação pela Anatel;
2. CÂMERA DO VEÍCULO (Especificações mínimas do equipamento)
2.1. Resolução óptica mínima de 640 x480 pixels;
2.2. Taxa de pelo menos 30 frames por segundo;
2.3. Resolução Horizontal: 420 linhas
2.4. Controle automático de ganho e balanço de branco;
2.5. Sensibilidade a luz a partir de 1 Lux;
2.6. Compressão de vídeo H.264 e MJPEG;
2.7. Possibilidade de inserir data e hora em posições fixas da imagem reproduzida;
2.8. Microfone embutido;
2.9. Sistema: NTSC
3. Qualidade de Vídeo (resolução mínima do arquivo de vídeo)
3.1 Resolução mínima de 320x240 pixels;
3.2 Taxa de pelo menos 5 frames por segundo.
4. Digital Vídeo Recorder - DVR - ou solução tecnológica equivalente ou superior, desde que seja possível realizar a conexão, integração e comunicação do PPE - Sistema de Prova Prática Eletrônica - com o sistema de filmagem, dentro dos critérios definidos pelo DETRAN/RS, que garanta a segurança e integridade das informações.
ANEXO V Cadastro de equipamentos móveis dos fornecedores da solução de filmagens para uso do PPE
Este documento tem por objetivo a definição dos serviços para o cadastro de equipamentos móveis (tablets) das empresas fornecedoras da solução de filmagens para utilização do sistema de exame prático (PPE) do DETRAN/RS.
Característica | Descrição |
Padrão da mensagem | A Integração se dará com serviços WEB HTTP utilizando a arquitetura REST (Representational State Transfer). |
REST | Conceitos: http://pt.wikipedia.org/wiki/REST |
HTTP STATUS | http://pt.wikipedia.org/wiki/Anexo:Lista_de_códigos_de_status_HTTP |
URL de acesso | https://m.prv.rs.gov.br/provas/rest/internet/equipamento/* |
Meio de comunicação | Rede internet da empresa fornecedora |
Padrão de troca de mensagens | Troca de mensagens no formato texto através do content-type JSON (Javascript Object Notation). |
Credencial de acesso | Usuário de sistema da empresa fornecedora, fornecido pelo DETRAN- RS |
Método de acesso.
Comunicação através dos métodos:
POST - utilizado nos serviços de inclusão/alteração.
Serviços previstos para comunicação.
Abaixo estão descritos os serviços para cadastramento ou desativação de equipamentos móveis para uso do PPE.
2.1) Cadastramento de equipamento https://m.prv.rs.gov.br/provas/rest/internet/equipamento/cadastra
2.2) Desativação de equipamento https://m.prv.rs.gov.br/provas/rest/internet/equipamento/desativa
3. Códigos de retorno previstos.
Status HTTP | Descrição | Obs. |
200 | OK | A requisição foi concluída com sucesso. |
400 | Requisição inválida | A requisição foi concluída com erros. |
O detalhamento dos dados de retorno para os Status HTTP será descrito em cada serviço.
4) Cadastramento de equipamento.
Este serviço deverá ser utilizado sempre que um equipamento móvel do CFC estiver sendo disponibilizado para o DETRAN aplicar exames práticos com o uso do PPE.
O serviço serve para inclusão de um novo equipamento ou atualização de um equipamento já existente. O campo chave do equipamento na base de dados do DETRAN será o nro IMEI. Se o IMEI já existir na base de dados, ele será atualizado. Se não existir, ele será criado.
Método HTTP:
POST
Descrição dos dados de envio (header):
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Organizacao | Alfa | 8 | S | Código de Organização SOE fornecido pelo DETRAN | |
Matricula | Numérico | 10 | S | Código de Usuário SOE fornecido pelo DETRAN | |
Senha | Alfa | 20 | S | Senha do Usuário SOE, definida pela empresa fornecedora |
Descrição dos dados de envio (body):
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Descricao | Alfa | 50 | S | Descrição do equipamento | |
Modelo | Alfa | 30 | S | Marca/Modelo do equipamento | |
tipoEquip | Numérico | 2 | S | 1=smartphone; 2=tablet | |
Imei | Alfa | 18 | S | Nro IMEI do equipamento | |
Cfc | Alfa | 8 | S | Código de Organização no SOE do CFC que irá utilizar o equipamento | CHC99999 |
urlFilmagem | Alfa | 50 | S | Prefixo da URL dos serviços de filmagem que o equipamento irá acessar no DVR da empresa fornecedora | Exemplo: http://filmage m |
Se o retorno for Status HTTP 200, o equipamento foi cadastrado/atualizado com sucesso.
Se o retorno for Status HTTP 400, ocorreu erro no cadastramento/atualização. Nesse caso, os dados de retorno são os seguintes:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
codErro | Alfa | 08 | S | Código do erro | |
msgErro | Alfa | 200 | S | Mensagem de erro |
5) Desativação de equipamento.
Este serviço deverá ser utilizado quando um equipamento estiver sendo descartado/inutilizado pela empresa fornecedora.
Método HTTP:
POST
Descrição dos dados de envio (header):
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Organizacao | Alfa | 8 | S | Código de Organização SOE fornecido pelo DETRAN | |
Matricula | Numérico | 10 | S | Código de Usuário SOE fornecido pelo DETRAN | |
Senha | Alfa | 20 | S | Senha do Usuário SOE, definida pela empresa fornecedora |
Descrição dos dados de envio (body):
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
tipoEquip | Numérico | 2 | S | 1=smartphone; 2=tablet | |
Imei | Alfa | 18 | S | Nro IMEI do | |
equipamento | |||||
Cfc | Alfa | 8 | S | Código de Organização no SOE do CFC que irá utilizar o equipamento | CHC99999 |
Se o retorno for Status HTTP 200, o equipamento foi cadastrado/atualizado com sucesso.
Se o retorno for Status HTTP 400, ocorreu erro no cadastramento/atualização. Nesse caso, os dados de retorno são os seguintes:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
codErro | Alfa | 08 | S | Código do erro | |
msgErro | Alfa | 200 | S | Mensagem de erro |