Portaria DETRAN/RS nº 378 DE 18/08/2014
Norma Estadual - Rio Grande do Sul - Publicado no DOE em 19 ago 2014
Dispõe sobre o processo de habilitação de condutores de Categoria "B", no que tange à realização de aulas em simulador de prática de direção veicular.
O Diretor-Geral Adjunto do Departamento Estadual de Trânsito - DETRAN/RS, no uso das atribuições legais conferidas pelo art. 6º da Lei Estadual nº 10.847 , de 20 de agosto de 1996, c/c o art. 8º da Lei Estadual nº 14.479 , de 23 de janeiro de 2014, bem como o disposto na Portaria DETRAN/RS nº 135, de 25 de março de 2014, que delega as competências do Diretor-Geral do DETRAN/RS ao Diretor-Geral Adjunto, e;
Considerando o contido no art. 22, inciso II, da Lei Federal nº 9.503, de setembro de 1997, que institui o Código de Trânsito Brasileiro - CTB - que atribui ao Órgão Executivo Estadual de Trânsito a realização, fiscalização e controle do processo de habilitação;
Considerando o disposto nas Resoluções CONTRAN nº 168/2004, nº 358/2010 e nº 493/2014;
Considerando o disposto na Portaria DENATRAN nº 808/2011 ;
Considerando o compromisso do DETRAN/RS com a qualidade do processo de formação de condutores no Estado do RS;
Considerando a necessidade de complementar as normatizações vigentes, em relação à realização das aulas em simulador de direção veicular nos Centros de Formação de Condutores - CFCs do Estado do Rio Grande do Sul;
Considerando o disposto no SPD nº 155175/2012 e SPD nº 84953/2014.
Resolve:
Art. 1º No processo de habilitação de condutores de Categoria "B", para a realização de aulas em simulador de prática de direção veicular, deverá ser observado:
I - em um mesmo dia poderão ser realizadas até 3 (três) aulas no simulador de prática de direção veicular, desde que não sejam consecutivas, e com intervalo mínimo de 30 (minutos) entre uma aula e outra;
II - excetua-se essa etapa para candidatos que necessitam utilizar veículo adaptado em seu processo de habilitação, até a regulamentação pelo Conselho Nacional de Trânsito - CONTRAN.
Art. 2º As aulas em simulador de direção veicular deverão ser ministradas, preferencialmente, por Instrutor de Trânsito Teórico ou Prático, podendo ser ministradas, também, por Diretor-Geral e Diretor de Ensino, todos devidamente credenciados pelo DETRAN/RS e vinculados ao Centro de Formação de Condutores.
§ 1º Simultaneamente poderão ser atendidos até 3 (três) candidatos pelo mesmo profissional, desde que em equipamentos distintos e num único ambiente.
§ 2º Ao final de cada aula deverá ser emitido pelo simulador relatório de eventos, devendo o profissional que ministrou a aula realizar orientação pedagógica ao candidato.
Art. 3º O simulador de direção veicular deverá ser instalado nas dependências do CFC, em sala específica para esse fim, preferencialmente com área mínima de 15 (quinze) metros quadrados (m²), em ambiente que proporcione espaço para instalação do equipamento e circulação dos profissionais e candidatos. Na hipótese de instalação de mais de 1 (um) simulador de direção na mesma sala, a cada equipamento instalado deverá ser acrescido, preferencialmente, espaço mínimo de 8 (oito) metros quadrados (m²).
§ 1º Na impossibilidade de atendimento das medidas citadas no caput desse artigo, poderá ocorrer a instalação do(s) simulador(es) de direção veicular em espaços menores, desde que adequados, permitindo a acomodação e circulação do(s) candidatos(s) e instrutor(es).
§ 2º Em uma mesma sala poderão ser instalados, no máximo, 3 (três) simuladores.
Art. 4º Atendidos os requisitos definidos no artigo anterior, garantida a segurança, comodidade, conectividade de rede e supervisão pelos Diretores do Centro, as salas poderão ser localizadas em outro local, desde que previamente aprovado pelo DETRAN/RS.
§ 1º As instalações físicas deverão dispor de banheiro para os usuários, acessibilidade conforme legislação vigente e identificação visual do DETRAN/RS.
§ 2º O CFC deverá apresentar:
I - requerimento operacional para aprovação das instalações físicas (disponível no sítio www.detran.rs.gov.br);
II - cópia do contrato de locação ou do registro de propriedade;
III - cópia do alvará de licença e funcionamento da atividade de Centro de Formação de Condutores, do ano, comprovando estar devidamente regularizado com o ente municipal;
lV - projeto arquitetônico das instalações físicas pretendidas, assinado por responsável técnico e em escala, para prévia aprovação.
§ 3º A autorização será exclusiva para as aulas em simulador, mediante preenchimento dos requisitos definidos neste artigo e aprovação da vistoria do local.
Art. 5º O uso compartilhado de simuladores, previsto no artigo 4º da Resolução CONTRAN nº 493/2014 , restringir-se-á a CFCs localizados em mesmo município, mediante prévia vinculação do equipamento pelo DETRAN/RS.
Art. 6º Nos casos de Atendimento Especial Fora da Sede, as aulas em simuladores de direção veicular deverão ser realizadas no CFC.
Art. 7º Os equipamentos simuladores de direção veicular deverão dispor de funcionalidades que permitam a conexão com os sistemas informatizados do DETRAN/RS, conforme especificações definidas no Anexo Único.
§ 1º Em situações excepcionais, quando o CFC/Simulador não possuir conexão ou disponibilidade do sistema para a realização da aula online poderá ser realizada a aula em modo offline, conforme especificações da alínea "e" do Anexo Único.
§ 2º considerando o período necessário aos ajustes dos sistemas para operar em modo offline, conforme especificações técnicas contidas na presente normativa, a operacionalização desta alternativa se dará a contar de 29.08.2014.
Art. 8º A exigência de aulas em simulador de direção veicular incide para os serviços de habilitação abertos a partir de 01.01.2014.
Art. 9º O valor da hora/aula em simulador de direção veicular será estabelecido em normativa específica do DETRAN/RS.
Art. 10. A presente Portaria entra em vigor na data de sua publicação, revogando a Portaria DETRAN/RS nº 461/2013.
Registre-se. Publique-se.
Denilson da Silva,
Diretor-Geral Adjunto.
(Redação do anexo dada pela Portaria DETRAN/RS Nº 268 DE 22/05/2018):
ANEXO ÚNICO -
Este documento tem por objetivo a definição de especificações e serviços para as integrações necessárias entre os sistemas corporativos do DETRAN/RS e os softwares dos simuladores de direção veicular, a fim de garantir autorização e registro das aulas virtuais realizadas em simuladores.
A Integração se dará através de serviços da internet (webservices), desenvolvidos e hospedados na PROCERGS.
O endereço do webservice será disponibilizado posteriormente aos CFCs, através do Portal dos Credenciados.
Padrões Técnicos Utilizados
Característica | Descrição |
Padrão da mensagem | Utilizado o XML como formato básico para representar as mensagens a serem trocadas entre as aplicações. A referência adotada é a recomendação W3C para XML 1.0, disponível em www.w3.org/TR/REC-xml. |
Codificação de caracteres | Padrão de codificação UTF-8. |
Meio de comunicação | Meio lógico de comunicação através de Web Services. Meio físico de comunicação através da internet |
Protocolo Internet | SSL versão 3.0 |
Web Services |
Padrão definido pelo WS-I Basic Profile 1.1 (www.ws-i.org/Profiles/BasicProfile-1.1-2004-08-24.html) |
Padrão de troca de mensagens |
Troca de mensagens através do protocolo SOAP versão 1.2. A especificação SOAP (Simple Object Access Protocol) pode ser acessada em w3.org/TR/soap/. |
WSDL | Descrição da interface do Web Service via documento WSDL (Web Services Description Language). A especificação WSDL pode ser acessada em www.w3.org/TR/wsdl. |
Padrões de preenchimento XML | O arquivo XSD que conterá as definições em linguagem Schema XML será disponibilizado posteriormente aos CFCs através do Portal dos Credenciados, meio de comunicação do DETRAN/RS com os credenciados. |
Este webservice não foi desenvolvido e nem disponibilizado para ser acessado por programas automatizados de consulta a cadastro, programas conhecidos como robôs. Se o servidor, que atende ao webservice, identificar que o seu sistema está utilizando robôs, aplicará medidas de controle de disponibilidade que podem ser de retardo da resposta e até a negação do serviço.
Os serviços previstos são:
a) validaInicioAula = > Solicitar Validação Início da Aula
b) confirmaInicioAula = > Confirmar Início da Aula
c) confirmaConclusaoAula = > Confirmar Conclusão da Aula ou
d) cancelaAula = > Informar Cancelamento da Aula
e) registroAulaOffline = > Registrar realização de uma aula que foi feita em modo 'offline'
f) consultaSituacaoTicket = > Consultar Situação da Aula/Ticket
O conteúdo previsto em cada um dos serviços:
a) Solicitar Validação Início da Aula
a.1) Simulador: solicita para o DETRAN/RS se aula pode ser iniciada. Deve passar dados de identificação do simulador, candidato, instrutor, etc.
a.2) DETRAN/RS: valida solicitação. Autoriza ou rejeita o início da aula.
No caso de autorizar, devolverá um ticket de identificação que deverá ser enviado pelo simulador nos serviços seguintes.
Entrada:
Campo | Tipo | Tamanho |
Obrigatório |
Descrição | Obs. |
Credencial | Alfa | 12 | S | Código para acesso aos Serviços do Simulador | Código a ser fornecido pelo DETRAN para a Empresa fornecedora do Simulador. |
Cod_Sala | Numérico | 8 | S | Código Sala onde se localiza o simulador. | Definido pelo DETRAN/RS a ser informado para CFC. |
Cod_Simulador | Numérico | 6 | S | Código do Simulador no DETRAN/RS | Definido pelo DETRAN/RS a ser informado para o CFC |
Cod_CFC | Alfa | 8 | S | Código que identifica o CFC no DETRAN/RS | Ex: 'CHC99999' |
CPF_Instrutor | Numérico | 11 | S | Número do CPF do Instrutor da aula | |
RENACH | Alfa | 11 | S | Número do RENACH do candidato | |
CPF_Candidato | Numérico | 11 | S | Número do CPF do candidato | |
CPF_Interprete | Numérico | 11 | N | Número do CPF do Intérprete LIBRAS | Será exigido para Alunos com Restrição Y. |
Retorno:
Campo | Tipo | Tamanho |
Obrigatório |
Descrição | Obs. |
Ind_Autorizacao | Alfa | 1 | S | Se autoriza (S) ou não (N) a realização da aula. | |
Ticket | Alfa | 12 | N | Ticket vinculado à autorização do início da aula. | Obrigatório quando aula autorizada. Deverá retornar nos próximos serviços. |
Ticket_Bio_Candidato | Numérico | 12 | N | Ticket para uso na verificação biométrica do candidato junto à C.E.D. | Obrigatório quando aula autorizada. |
Bio_C_Max_Tentativas | Numérico | 1 | N | Número máximo de dedos a tentar validar para o candidato | Obrigatório quando aula autorizada. |
Bio_C_Max_Erros | Numérico | 1 | N | Número máximo de vezes a tentar validar o mesmo dedo para o candidato | Obrigatório quando aula autorizada. |
Bio_C_Ordenacao | Numérico | 1 | N | Ordenação pela qualidade de coleta (0) ou pela última validação (1) | Obrigatório quando aula autorizada. |
Ticket_Bio_Instrutor | Numérico | 12 | N | Ticket para uso na verificação biométrica do instrutor junto à C.E.D. | Obrigatório quando aula autorizada. |
Bio_I_Max_Tentativas | Numérico | 1 | N | Número máximo de dedos a tentar validar para o instrutor | Obrigatório quando aula autorizada. |
Bio_I_Max_Erros | Numérico | 1 | N | Número máximo de vezes a tentar validar o mesmo dedo para o instrutor | Obrigatório quando aula autorizada. |
Bio_I_Ordenacao | Numérico | 1 | N | Ordenação pela qualidade de coleta (0) ou pela última validação (1) | Obrigatório quando aula autorizada. |
Ticket_Bio_Interprete | Numérico | 12 | N | Ticket para uso na verificação biométrica do intérprete de LIBRAS junto à C.E.D. | Obrigatório quando aula autorizada e for informado CPF_Interprete na entrada. |
Bio_T_Max_Tentativas | Numérico | 1 | N | Número máximo de dedos a tentar validar para o intérprete de LIBRAS | Obrigatório quando informado o intérprete |
Bio_T_Max_Erros | Numérico | 1 | N | Número máximo de vezes a tentar validar o mesmo dedo para o intérprete de LIBRAS | Obrigatório quando informado o intérprete |
Bio_T_Ordenacao | Numérico | 1 | N | Ordenação pela qualidade de coleta (0) ou pela última validação (1) | Obrigatório quando informado o intérprete |
Mensagem_Erro | Alfa | 400 | N | Mensagem descrevendo motivo da não liberação da aula. | Obrigatório quando aula não autorizada. |
Tratamento de exceção: se não houver retorno do sistema do DETRAN/RS (Ex: devido algum erro de conexão, timeout, etc), a aula não foi autorizada. O simulador deverá prever reenvio da solicitação.
b) Confirmar Início da Aula
b.1) Simulador: informa para o DETRAN/RS o início da aula.
- Reenvia os mesmos dados para validar início da aula mais o ticket fornecido pelo DETRAN/RS no serviço 'Solicitar Validação Início da Aula' e a Hora de Início da Aula.
b.2) DETRAN/RS: valida solicitação. Registra início de aula no sistema do DETRAN/RS.
Entrada:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Cod_Sala | Numérico | 8 | S | Código Sala onde se localiza o simulador. | Definido pelo DETRAN/RS a ser informado para CFC. |
Cod_Simulador | Numérico | 6 | S | Código do Simulador no DETRAN/RS | Definido pelo DETRAN/RS a ser informado para o CFC |
Cod_CFC | Alfa | 8 | S | Código que identifica o CFC no DETRAN/RS | Ex: 'CHC99999' |
CPF_Instrutor | Numérico | 11 | S | Número do CPF do Instrutor da aula | Pode ser outro profissional habilitado a dar a Aula no simulador (ex. Direto de Ensino). |
RENACH | Alfa | 11 | S | Número do RENACH do candidato | |
CPF_Candidato | Numérico | 11 | S | Número do CPF do Candidato | |
CPF_Interprete | Numérico | 11 | N | Número do CPF do Intérprete de LIBRAS | Será exigido para Alunos com Restrição Y. |
Ticket | Alfa | 12 | S | Ticket informado pelo DETRAN/RS na validação Início da Aula | |
Ticket_Bio_Candidato | Numérico | 12 | S | Ticket para uso na verificação biométrica do candidato junto à C.E.D. | Recebido no serviço de validação de início de aula. |
Ticket_Bio_Instrutor | Numérico | 12 | S | Ticket para uso na verificação biométrica do instrutor junto à C.E.D. | Recebido no serviço de validação de início de aula. |
Ticket_Bio_Interprete | Numérico | 12 | N | Ticket para uso na verificação biométrica do intérprete de LIBRAS junto à C.E.D. | Recebido no serviço de validação de início de aula. |
Hora_Inicio_Aula | Alfa | 19 | S | Data/Hora de início da aula. |
YYYY-MM-DD HH:MM:SS |
Retorno:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Ind_Autorizacao | Alfa | 1 | S | Se autoriza (S) ou não (N) a realização da aula. | |
Ticket | Alfa | 12 | N | Ticket vinculado à autorização do início da aula. | Devolve o mesmo Ticket Obrigatório quando aula autorizada. |
Ticket_Bio_Saida_Candidato | Numérico | 12 | N | Ticket para uso na verificação biométrica do candidato no término da aula junto à C.E.D. | Obrigatório quando aula autorizada. |
Bio_C_S_Max_Tentativas | Numérico | 1 | N | Número máximo de dedos a tentar validar no término da aula para o candidato | Obrigatório quando aula autorizada. |
Bio_C_S_Max_Erros | Numérico | 1 | N | Número máximo de vezes a tentar validar o mesmo dedo no término da aula para o candidato | Obrigatório quando aula autorizada. |
Bio_C_S_Ordenacao | Numérico | 1 | N | Ordenação pela qualidade de coleta (0) ou pela última validação (1) | Obrigatório quando aula autorizada. |
Ticket_Bio_Saida_Instrutor | Numérico | 12 | N | Ticket para uso na verificação biométrica do instrutor no término da aula junto à C.E.D. | Obrigatório quando aula autorizada. |
Bio_I_S_Max_Tentativas | Numérico | 1 | N | Número máximo de dedos a tentar validar no término da aula para o instrutor | Obrigatório quando aula autorizada. |
Bio_I_S_Max_Erros | Numérico | 1 | N | Número máximo de vezes a tentar validar o mesmo dedo no término da aula para o instrutor | Obrigatório quando aula autorizada. |
Bio_I_S_Ordenacao | Numérico | 1 | N | Ordenação pela qualidade de coleta (0) ou pela última validação (1) | Obrigatório quando aula autorizada. |
Ticket_Bio_Saida_Interprete | Numérico | 12 | N | Ticket para uso na verificação biométrica do intérprete de LIBRAS no término da aula junto à C.E.D. | Obrigatório quando aula autorizada e for informado CPF_Interprete na entrada. |
Bio_T_S_Max_Tentativas | Numérico | 1 | N | Número máximo de dedos a tentar validar para o intérprete de LIBRAS no término da aula | Obrigatório quando informado o intérprete |
Bio_T_S_Max_Erros | Numérico | 1 | N | Número máximo de vezes a tentar validar o mesmo dedo para o intérprete de LIBRAS no término da aula | Obrigatório quando informado o intérprete |
Bio_T_S_Ordenacao | Numérico | 1 | N | Ordenação pela qualidade de coleta (0) ou pela última validação (1) | Obrigatório quando informado o intérprete |
Mensagem_Erro | Alfa | 400 | N | Mensagem descrevendo motivo da não liberação da aula. | Obrigatório quando aula não autorizada. |
Tratamento de exceção: se não houver retorno do sistema do DETRAN/RS (Ex: devido algum erro de conexão, etc), o simulador deverá prever reenvio da solicitação. O reenvio pode ser em momento posterior, mas deve enviar o ticket e a 'Hora_Inicio_Aula' previstos no envio original.
c) Confirmar Conclusão da Aula (aula finalizada com êxito).
c.1) Simulador: informa para o DETRAN/RS o final da aula (que foi efetivamente realizada).
- Reenvia os mesmos dados para validar início da aula mais o ticket fornecido pelo DETRAN/RS e os dados da aula.
c.2) DETRAN/RS: valida solicitação. Registra conclusão de aula no sistema do DETRAN/RS.
Entrada:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Cod_Sala | Numérico | 8 | S | Código Sala onde se localiza o simulador. | Definido pelo DETRAN/RS a ser informado para CFC. |
Cod_Simulador | Numérico | 6 | S | Código do Simulador no DETRAN/RS | Definido pelo DETRAN/RS a ser informado para o CFC |
Cod_CFC | Alfa | 8 | S | Código que identifica o CFC no DETRAN/RS | Ex: 'CHC99999' |
CPF_Instrutor | Numérico | 11 | S | Número do CPF do Instrutor da aula | Pode ser outro profissional habilitado a ministrar aula no simulador (ex: Diretor de Ensino). |
RENACH | Alfa | 11 | S | Número do RENACH do candidato | |
CPF_Candidato | Numérico | 11 | S | Número do CPF do candidato | |
CPF_Interprete | Numérico | 11 | N | Número do CPF do Intérprete de LIBRAS | Será exigido para candidatos com Restrição Y. |
Ticket | Alfa | 12 | S | Ticket informado pelo DETRAN/RS na validação Início da Aula | |
Ticket_Bio_Candidato | Numérico | 12 | S | Ticket para uso na verificação biométrica do candidato junto à C.E.D. | Recebido no serviço de validação de início de aula. |
Ticket_Bio_Instrutor | Numérico | 12 | S | Ticket para uso na verificação biométrica do instrutor junto à C.E.D. | Recebido no serviço de validação de início de aula. |
Ticket_Bio_Interprete | Numérico | 12 | N | Ticket para uso na verificação biométrica do intérprete de LIBRAS junto à C.E.D. | Recebido no serviço de validação de início de aula. |
Ticket_Bio_Saida_Candidato | Numérico | 12 | N | Ticket para uso na verificação biométrica do candidato no término da aula junto à C.E.D. | Recebido no serviço de confirmação de início de aula. |
Ticket_Bio_Saida_Instrutor | Numérico | 12 | N | Ticket para uso na verificação biométrica do instrutor no término da aula junto à C.E.D. | Recebido no serviço de confirmação de início de aula. |
Ticket_Bio_Saida_Interprete | Numérico | 12 | N | Ticket para uso na verificação biométrica do intérprete de LIBRAS no término da aula junto à C.E.D. | Recebido no serviço de confirmação de início de aula. |
Hora_Inicio_Aula | Alfa | 19 | S | Data/Hora de início da aula. |
YYYY-MM-DD HH:MM:SS |
Hora_Fim_Aula | Alfa | 19 | S | Data/Hora de fim da aula. |
YYYY-MM-DD HH:MM:SS |
Tempo Circulação do Veículo | Numérico | 6 | S | Tempo efetivo que o veículo esteve em funcionamento durante a aula. | HH:MM:SS |
Velocidade Média | Numérico | 3,1 | S | Velocidade Média do veículo durante a aula. Em km/h. | 999V9 |
Velocidade Máxima | Numérico | 3,1 | S | Velocidade Máxima do veículo durante a aula. Em km/h | 999V9 |
Distância Percorrida | Numérico | 6 | S | Distância, em metros, percorrida pelo veículo durante a aula. | |
Lista de eventos - pode ter 0 a n ocorrência | N |
Tabela com os eventos ocorridos na aula. Devem ser informados os conteúdos pedagógicos, infrações e erros. |
O código do evento deverá ser convertido pelo simulador Código do DETRAN/RS usando uma tabela DE/PARA a ser fornecida pelo DETRAN/RS. | ||
Hora_Evento | Alfa | 19 | S | Hora do evento |
YYYY-MM-DD HH:MM:SS |
Cod_Evento | Numérico | 7 | S | Código do evento que pode corresponder ao conteúdo pedagógico, infração ou erro. | Convertido conforme tabela DE/PARA a ser fornecida pelo DETRAN/RS. |
Descr_Evento | Alfa | N | Descrição do evento nos casos em que a tabela do DETRAN/RS considera outros eventos. |
Tratamento de exceção: se não houver retorno do sistema do DETRAN/RS (ex: algum erro de conexão, etc), o simulador deverá prever reenvio da solicitação. O reenvio pode ser em momento posterior, mas deve enviar o Ticket, 'Hora_Inicio_Aula' e a 'Hora_Fim_Aula' previstos no envio original.
d) Informar Cancelamento da Aula (aula não finalizada ok).
d.1) Simulador: informa para o DETRAN/RS o cancelamento/interrupção da aula.
- Reenvia os mesmos dados para validar início da aula, mais o ticket fornecido pelo DETRAN/RS, mais os dados de cancelamento da aula.
d.2) DETRAN/RS: valida solicitação. Registra cancelamento de aula no sistema do DETRAN/RS.
Entrada:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Cod_Sala | Numérico | 8 | S | Código Sala onde se localiza o simulador. | Definido pelo DETRAN/RS a ser informado para CFC. |
Cod_Simulador | Numérico | 6 | S | Código do Simulador no DETRAN/RS | Definido pelo DETRAN/RS a ser informado para o CFC |
Cod_CFC | Alfa | 8 | S | Código que identifica o CFC no DETRAN/RS | Ex: 'CHC99999' |
CPF_Instrutor | Numérico | 11 | S | Número do CPF do instrutor da aula | Pode ser outro profissional habilitado a ministrar aula no simulador (Ex: Diretor de Ensino). |
RENACH | Alfa | 11 | S | Número do RENACH do candidato | |
CPF_Aluno | Numérico | 11 | S | Número do CPF do candidato | |
CPF_Interprete | Numérico | 11 | N | Número do CPF do Intérprete de LIBRAS | Será exigido para candidatos com Restrição Y. |
Ticket | Alfa | 12 | S | Ticket informado pelo DETRAN/RS na validação Início da Aula | |
Ticket_Bio_Candidato | Numérico | 12 | S | Ticket para uso na verificação biométrica do candidato junto à C.E.D. | Recebido no serviço de validação de início de aula. |
Ticket_Bio_Instrutor | Numérico | 12 | S | Ticket para uso na verificação biométrica do instrutor junto à C.E.D. | Recebido no serviço de validação de início de aula. |
Ticket_Bio_Interprete | Numérico | 12 | N | Ticket para uso na verificação biométrica do intérprete de LIBRAS junto à C.E.D. | Recebido no serviço de validação de início de aula. |
Ticket_Bio_Saida_Candidato | Numérico | 12 | N | Ticket para uso na verificação biométrica do candidato no término da aula junto à C.E.D. | Recebido no serviço de confirmação de início de aula. |
Ticket_Bio_Saida_Instrutor | Numérico | 12 | N | Ticket para uso na verificação biométrica do instrutor no término da aula junto à C.E.D. | Recebido no serviço de confirmação de início de aula. |
Ticket_Bio_Saida_Interprete | Numérico | 12 | N | Ticket para uso na verificação biométrica do intérprete de LIBRAS no término da aula junto à C.E.D. | Recebido no serviço de confirmação de início de aula. |
Hora_Inicio_Aula | Alfa | 19 | S | Data/Hora de início da aula. |
YYYY-MM-DD HH:MM:SS |
Hora_Cancelamento_ Aula | Alfa | 19 | N | Data/Hora de cancelamento da aula. |
YYYY-MM-DD HH:MM:SS |
Retorno:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Ind_Autorizacao | Alfa | 1 | S | Se autoriza (S) ou não (N) o cancelamento da aula. | |
Ticket | Alfa | 12 | N | Ticket vinculado a autorização do início da aula. | Devolve o mesmo Ticket Obrigatório quando aula autorizada. |
Mensagem_Erro | Alfa | 400 | N | Mensagem descrevendo motivo não autorização cancelamento da aula. | Obrigatório quando cancelamento da aula não autorizado. |
Tratamento de exceção: se não houver retorno do sistema do DETRAN/RS (Ex: devido algum erro de conexão, etc), o simulador deverá prever reenvio da solicitação. O reenvio pode ser em momento posterior, mas deve enviar o Ticket e a 'Hora_Inicio_Aula' previstos no envio original.
e) Registro Aula Offline (somente para aula finalizada ok).
e.1) Simulador: informa para o DETRAN/RS a realização de uma aula feita em modo offline. Somente aula efetivamente realizada.
- Os dados são similares ao do serviço 'confirmaConclusaoAula', mas sem o ticket de autorização definido previamente.
e.2) DETRAN/RS: valida solicitação por meio sistêmico. Registra realização da aula no sistema do DETRAN/RS.
Entrada: 0
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Credencial | Alfa | 12 | S | Código para acesso aos Serviços do Simulador. | O código será fornecido pelo DETRAN (ou PROCERGS) para a Empresa fornecedora do Simulador. |
Cod_Sala | Numérico | 8 | S | Código Sala onde se localiza o simulador. | Definido pelo DETRAN a ser informado para CFC. |
Cod_Simulador | Numérico | 6 | S | Código do Simulador no DETRAN | Definido pelo DETRAN a ser informado para o CFC |
Cod_CFC | Alfa | 8 | S | Código que identifica o CFC no DETRAN | ex. 'CHC99999' |
CPF_Instrutor | Numérico | 11 | S | Número do CPF do instrutor da aula | Pode ser outro profissional habilitado a dar a Aula no simulador (ex. Diretor de Ensino). |
RENACH | Alfa | 11 | S | Número do RENACH do Candidato aberto no DETRAN | |
CPF_Candidato | Numérico | 11 | S | Número do CPF do Candidato | |
CPF_Interprete | Numérico | 11 | N | Número do CPF do Intérprete LIBRAS | Será exigido para candidatos com Restrição Y. |
Hora_Inicio_Aula | Alfa | 19 | S | Data/Hora de início da aula. |
YYYY-MM-DD HH:MM:SS |
Hora_Fim_Aula | Alfa | 19 | S | Data/Hora de fim da aula. |
YYYY-MM-DD HH:MM:SS |
Tempo Circulação do Veículo | Numérico | 6 | S | Tempo efetivo que o veículo esteve em funcionamento durante a aula. | HH:MM:SS |
Velocidade Média | Numérico | 3,1 | S | Velocidade Média do veículo durante a aula. Em km/h. | 999V9 |
Velocidade Máxima | Numérico | 3,1 | S | Velocidade Máxima do veículo durarnte a aula. Em km/h | 999V9 |
Distância Percorrida | Numérico | 6 | S | Distância, em metros, percorrida pelo veículo durante a aula. | |
Lista de Eventos - pode ter 0 a n ocorrência (máximo 1000) | N |
Tabela com os Eventos ocorridos na Aula. Devem ser informados os Conteúdos pedagógicos, Infrações e erros. |
O Código do Evento deverá ser convertido pelo simulador Código do DETRAN usando uma tabela DE/PARA a ser fornecida pelo DETRAN/RS. | ||
Hora_Evento | Alfa | 19 | S | Hora do Evento |
YYYY-MM-DD HH:MM:SS |
Cod_Evento | Numérico | 7 | S | Código do Evento que pode corresponder ao Conteúdo Pedagógico, Infração ou erro. | Convertido conforme tabela DE/PARA a ser fornecida pelo DETRAN/RS. |
Descr_Evento | Alfa | N | Descrição do Evento nos casos em que a tabela do DETRAN considera outros eventos. |
Retorno:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Ind_Autorizacao | Alfa | 1 | S | Se autoriza (S) ou não (N) a realização da aula. | |
Ticket | Alfa | 12 | N | Ticket de autorização do registro da Aula offline. | Obrigatório quando aula autorizada. |
Ticket_Bio_Candidato | Numérico | 12 | N | Ticket para uso na verificação biométrica do candidato junto à C.E.D. | Obrigatório quando aula autorizada. |
Ticket_Bio_Instrutor | Numérico | 12 | N | Ticket para uso na verificação biométrica do instrutor junto à C.E.D. | Obrigatório quando aula autorizada. |
Ticket_Bio_Interprete | Numérico | 12 | N | Ticket para uso na verificação biométrica do intérprete de LIBRAS junto à C.E.D. | Obrigatório quando aula autorizada e for informado CPF_Interprete na entrada. |
Ticket_Bio_Saida_Candidato | Numérico | 12 | N | Ticket para uso na verificação biométrica do candidato no término da aula junto à C.E.D. | Obrigatório quando aula autorizada. |
Ticket_Bio_Saida_Instrutor | Numérico | 12 | N | Ticket para uso na verificação biométrica do instrutor no término da aula junto à C.E.D. | Obrigatório quando aula autorizada. |
Ticket_Bio_Saida_Interprete | Numérico | 12 | N | Ticket para uso na verificação biométrica do intérprete de LIBRAS no término da aula junto à C.E.D. | Obrigatório quando aula autorizada e for informado CPF_Interprete na entrada. |
Mensagem_Erro | Alfa | 400 | N | Mensagem descrevendo motivo não liberação da aula. | Obrigatório quando aula não autorizada. |
Tratamento de exceção: se não houver retorno do sistema do DETRAN/RS (ex. Devido algum erro de conexão, etc), o simulador deverá prever reenvio da solicitação.
f) Consulta Situação Ticket (verificar situação da Aula)
f.1) Simulador: solicita para o DETRAN/RS a situação da aula vinculada a um Ticket.
f.2) DETRAN/RS: valida solicitação. Retorna Situação da aula no sistema do DETRAN/RS.
Entrada:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Credencial | Alfa | 12 | S | Código para acesso aos Serviços do Simulador. | O código será fornecido pelo DETRAN (ou PROCERGS) para a Empresa fornecedora do Simulador. |
Ticket | Alfa | 12 | S | Ticket de autorização. |
Retorno:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Ind_Autorizacao | Alfa | 1 | S | Se consulta foi realizada com sucesso (S) ou não (N). | |
SituacaoAula | Numérico | 2 | N |
0-Não possui Aula iniciada 1-Aula em Andamento, pendente Conclusão. 2-Aula Concluída pelo Simulador-Pendente Homologação pelo CFC 3-Aula Concluída pelo Simulador-Homologada pelo CFC 97-Aula Concluída pelo Simulador-Rejeitada pelo CFC 98-Aula Cancelada pelo Simulador 99-Aula Cancelada manualmente pelo CFC e/ou DETRAN/RS |
Obrigatório quando Consulta autorizada. |
Observacao | Alfa | 400 | N | Texto com Observação adicional sobre situação do | |
Mensagem_Erro | Alfa | 400 | N | Mensagem descrevendo motivo do erro no caso de processamento com erro da consulta. | Obrigatório quando Consulta não autorizada. |
ANEXO ÚNICO -
Este documento tem por objetivo a definição de especificações e serviços para as integrações necessárias entre os sistemas corporativos do DETRAN/RS e os softwares dos simuladores de direção veicular, a fim de garantir autorização e registro das aulas virtuais realizadas em simuladores.
1. A Integração se dará através de serviços da internet (webservices), desenvolvidos e hospedados na PROCERGS.
a) O endereço do webservice será disponibilizado posteriormente aos CFCs, através do Portal dos Credenciados.
b) Padrões Técnicos Utilizados
Característica | Descrição |
Padrão da mensagem | Utilizado o XML como formato básico para representar as mensagens a serem trocadas entre as aplicações. A referência adotada é a recomendação W3C para XML 1.0, disponível em www.w3.org/TR/ REC-xml. |
Codificação de caracteres | Padrão de codificação UTF-8. |
Meio de comunicação | Meio lógico de comunicação através de Web Services. Meio físico de comunicação através da internet |
Protocolo Internet | SSL versão 3.0 |
Web Services |
Padrão definido pelo WS-I Basic Profile 1.1 (www.ws-i.org/Profiles/BasicProfile-1.1-2004-08-24.html) |
Padrão de troca de mensagens |
Troca de mensagens através do protocolo SOAP versão 1.2. A especificação SOAP (Simple Object Access Protocol) pode ser acessada em w3.org/TR/soap/. |
WSDL | Descrição da interface do Web Service via documento WSDL (Web Services Description Language). A especificação WSDL pode ser acessada em www.w3.org/TR/wsdl. |
Padrões de preenchimento XML | O arquivo XSD que conterá as definições em linguagem Schema XML será disponibilizado posteriormente aos CFCs através do Portal dos Credenciados, meio de comunicação do DETRAN/RS com os credenciados. |
c) Este webservice não foi desenvolvido e nem disponibilizado para ser acessado por programas automatizados de consulta a cadastro, programas conhecidos como robôs. Se o servidor, que atende ao webservice, identificar que o seu sistema está utilizando robôs, aplicará medidas de controle de disponibilidade que podem ser de retardo da resposta e até a negação do serviço.
2. Os serviços previstos são :
a) validaInicioAula = > Solicitar Validação Início da Aula
b) confirmaInicioAula = > Confirmar Início da Aula
c) confirmaConclusaoAula = > Confirmar Conclusão da Aula ou
d) cancelaAula = > Informar Cancelamento da Aula
e) registroAulaOffline = > Registrar realização de uma aula que foi feita em modo 'offline'
f) consultaSituacaoTicket = > Consultar Situação da Aula/Ticket
O conteúdo previsto em cada um dos serviços:
a) Solicitar Validação Início da Aula
a.1) Simulador : solicita para o DETRAN/RS se aula pode ser iniciada. Deve passar dados de identificação do simulador, candidato, instrutor, etc.
a.2) DETRAN/RS : valida solicitação. Autoriza ou rejeita o início da aula.
No caso de autorizar, devolverá um ticket de identificação que deverá ser enviado pelo simulador nos serviços seguintes.
Entrada:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Credencial | Alfa | 12 | S | Código para acesso aos Serviços do Simulador | Código a ser fornecido pelo DETRAN para a Empresa fornecedora do Simulador. |
Cod_Sala | Numérico | 8 | S | Código Sala onde se localiza o simulador. | Definido pelo DETRAN/RS a ser informado para CFC. |
Cod_Simulador | Numérico | 6 | S | Código do Simulador no DETRAN/RS | Definido pelo DETRAN/RS a ser informado para o CFC |
Cod_CFC | Alfa | 8 | S | Código que identifica o CFC no DETRAN/ RS | Ex: 'CHC99999' |
Cod_Operador_ SCA | Numérico | 11 | S | Código de Usuário do Instrutor para acesso aos sistemas do DETRAN/ RS. Vinculado ao Cod_CFC (Código Cliente). | Pode ser outro profissional habilitado a dar a Aula no simulador (ex. Diretor de Ensino). |
RENACH | Alfa | 11 | S | Número do RENACH do candidato | |
CPF_Candidato | Numérico | 11 | S | Número do CPF do candidato | |
Doc _ Ident _ Interprete | Alfa | 15 | N | Documento de Identidade do Intérprete Libras | Será exigido para Alunos com Restrição Y. |
UF_Ident_Interprete | Alfa | 2 | N | UF do Documento de Identidade do Intérprete Libras | Será exigido junto com Documento de Identidade para candidatos com Restrição Y |
Retorno:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Ind_Autorizacao | Alfa | 1 | S | Se autoriza (S) ou não (N) a realização da aula. | |
Ticket | Alfa | 12 | N | Ticket vinculado à autorização do início da aula. | Obrigatório quando aula autorizada. Deverá retornar nos próximos serviços. |
Mensagem_Erro | Alfa | 400 | N | Mensagem descrevendo motivo da não liberação da aula. | Obrigatório quando aula não autorizada. |
Tratamento de exceção: se não houver retorno do sistema do DETRAN/RS (Ex: devido algum erro de conexão, timeout, etc), a aula não foi autorizada. O simulador deverá prever reenvio da solicitação.
b) Confirmar Início da Aula
b.1) Simulador : informa para o DETRAN/RS o início da aula.
- Reenvia os mesmos dados para validar início da aula mais o ticket fornecido pelo
DETRAN/RS no serviço 'Solicitar Validação Início da Aula' e a Hora de Início da Aula.
b.2) DETRAN/RS : valida solicitação. Registra início de aula no sistema do DETRAN/RS.
Entrada :
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Cod_Sala | Numérico | 8 | S | Código Sala onde se localiza o simulador. | Definido pelo DETRAN/RS a ser informado para CFC. |
Cod_Simulador | Numérico | 6 | S | Código do Simulador no DETRAN/RS | Definido pelo DETRAN/RS a ser informado para o CFC |
Cod_CFC | Alfa | 8 | S | Código que identifica o CFC no DETRAN/ RS | Ex: 'CHC99999' |
Cod_Operador_ SCA | Numérico | 11 | S |
Código de Usuário do Instrutor para acesso aos sistemas do DETRAN/RS. Vinculado ao Cod_ CFC (Código Cliente). |
Pode ser outro profissional habilitado a dar a Aula no simulador (ex. Direto de Ensino). |
RENACH | Alfa | 11 | S | Número do RENACH do candidato | |
CPF_Candidato | Numérico | 11 | S | Número do CPF do Candidato | |
Doc_Ident_ Interprete | Alfa | 15 | N | Documento de Identidade do Intérprete Libras | Será exigido para Alunos com Restrição Y. |
UF _ Ident _ Interprete | Alfa | 2 | N | UF do Documento de Identidade do Intérprete Libras | Será exigido junto com Documento de Identidade para candidatos com Restrição Y |
Ticket | Alfa | 12 | S | Ticket informado pelo DETRAN/RS na validação Início da Aula | |
Hora_Inicio_ Aula | Alfa | 19 | S | Data/Hora de início da aula. | YYYY-MM-DD HH:MM:SS |
Retorno:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Ind_Autorizacao | Alfa | 1 | S | Se autoriza (S) ou não (N) a realização da aula. | |
Ticket | Alfa | 12 | N | Ticket vinculado à autorização do início da aula. | Devolve o mesmo Ticket Obrigatório quando aula autorizada. |
Mensagem_Erro | Alfa | 400 | N | Mensagem descrevendo motivo da não liberação da aula. | Obrigatório quando aula não autorizada. |
Tratamento de exceção : se não houver retorno do sistema do DETRAN/RS (Ex: devido algum erro de conexão, etc), o simulador deverá prever reenvio da solicitação. O reenvio pode ser em momento posterior, mas deve enviar o ticket e a 'Hora_Inicio_Aula' previstos no envio original.
c) Confirmar Conclusão da Aula (aula finalizada com êxito).
c.1) Simulador : informa para o DETRAN/RS o final da aula (que foi efetivamente realizada).
- Reenvia os mesmos dados para validar início da aula mais o ticket fornecido pelo DETRAN/RS e os dados da aula.
c.2) DETRAN/RS : valida solicitação. Registra conclusão de aula no sistema do DETRAN/RS.
Entrada :
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Cod_Sala | Numérico | 8 | S | Código Sala onde se localiza o simulador. | Definido pelo DETRAN/RS a ser informado para CFC. |
Cod_Simulador | Numérico | 6 | S | Código do Simulador no DETRAN/RS | Definido pelo DETRAN/RS a ser informado para o CFC |
Cod_CFC | Alfa | 8 | S | Código que identifica o CFC no DETRAN/ RS | Ex: 'CHC99999' |
Cod_Operador_SCA | Numérico | 11 | S | Código de Usuário do Instrutor para acesso aos sistemas do DETRAN/ RS. Vinculado ao Cod_CFC (Código Cliente). | Pode ser outro profissional habilitado a ministrar aula no simulador (ex: Diretor de Ensino). |
RENACH | Alfa | 11 | S | Número do RENACH do candidato | |
CPF_Candidato | Numérico | 11 | S | Número do CPF do candidato | |
Doc_Ident_Interprete | Alfa | 15 | N | Documento de Identidade do Intérprete Libras | Será exigido para candidatos com Restrição Y. |
UF_Ident_Interprete | Alfa | 2 | N | UF do Documento de Identidade do Intérprete Libras | Será exigido junto com Documento de Identidade para candidatos com Restrição Y |
Ticket | Alfa | 12 | S | Ticket informado pelo DETRAN/RS na validação Início da Aula | |
Hora_Inicio_Aula | Alfa | 19 | S | Data/Hora de início da aula. | YYYY-MM-DD HH:MM:SS |
Hora_Fim_Aula | Alfa | 19 | S | Data/Hora de fim da aula. | YYYY-MM-DD HH:MM:SS |
Tempo Circulação do Veículo | Numérico | 6 | S | Tempo efetivo que o veículo esteve em funcionamento durante a aula. | HH:MM:SS |
Velocidade Média | Numérico | 3,1 | S | Velocidade Média do veículo durante a aula. Em km/h. | 999V9 |
Velocidade Máxima | Numérico | 3,1 | S | Velocidade Máxima do veículo durante a aula. Em km/h | 999V9 |
Distância Percorrida | Numérico | 6 | S | Distância, em metros, percorrida pelo veículo durante a aula. | |
Lista de eventos ? pode ter 0 a n ocorrência |
N | Tabela com os eventos ocorridos na aula. Devem ser informados os conteúdos pedagógicos, infrações e erros. | O código do evento deverá ser convertido pelo simulador Código do DETRAN/ RS usando uma tabela DE/PARA a ser fornecida pelo DETRAN/RS. | ||
Hora_Evento | Alfa | 19 | S | Hora do evento | YYYY-MM-DD HH:MM:SS |
Cod_Evento | Numérico | 7 | S | Código do evento que pode corresponder ao conteúdo pedagógico, infração ou erro. | Convertid o conforme tabela DE/PARA a ser fornecida pelo DETRAN/RS. |
Descr_Evento | Alfa | N | Descrição do evento nos casos em que a tabela do DETRAN/ RS considera outros eventos. |
Tratamento de exceção : se não houver retorno do sistema do DETRAN/RS (ex: algum erro de conexão, etc), o simulador deverá prever reenvio da solicitação. O reenvio pode ser em momento posterior, mas deve enviar o Ticket, 'Hora_Inicio_Aula' e a 'Hora_Fim_Aula' previstos no envio original.
d) Informar Cancelamento da Aula (aula não finalizada ok).
d.1) Simulador : informa para o DETRAN/RS o cancelamento/interrupção da aula.
- Reenvia os mesmos dados para validar início da aula, mais o ticket fornecido pelo DETRAN/RS, mais os dados de cancelamento da aula.
d.2) DETRAN/RS : valida solicitação. Registra cancelamento de aula no sistema do DETRAN/RS.
Entrada :
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Cod_Sala | Numérico | 8 | S | Código Sala onde se localiza o simulador. | Definido pelo DETRAN/RS a ser informado para CFC. |
Cod_Simulador | Numérico | 6 | S | Código do Simulador no DETRAN/RS | Definido pelo DETRAN/RS a ser informado para o CFC |
Cod_CFC | Alfa | 8 | S | Código que identifica o CFC no DETRAN/ RS | Ex: 'CHC99999' |
Cod_Operador_ SCA | Numérico | 11 | S | Código de Usuário do Instrutor para acesso aos sistemas do DETRAN/RS. Vinculado ao Cod_ CFC (Código Cliente). | Pode ser outro profissional habilitado a ministrar aula no simulador (Ex: Diretor de Ensino). |
RENACH | Alfa | 11 | S | Número do RENACH do candidato | |
CPF_Aluno | Numérico | 11 | S | Número do CPF do candidato | |
Doc _ Ident _ Interprete | Alfa | 15 | N | Documento de Identidade do Intérprete Libras | Será exigido para candidatos com Restrição Y. |
UF _ Ident _ Interprete | Alfa | 2 | N | UF do Documento de Identidade do Intérprete Libras | Será exigido junto com Documento de Identidade para candidatos com Restrição Y |
Ticket | Alfa | 12 | S | Ticket informado pelo DETRAN/RS na validação Início da Aula | |
Hora_Inicio_ Aula | Alfa | 19 | S | Data/Hora de início da aula. | YYYY-MM-DD HH:MM:SS |
Hora _ Cancelamento_ Aula | Alfa | 19 | N | Data/Hora de cancelamento da aula. | YYYY-MM-DD HH:MM:SS |
Retorno:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Ind_Autorizacao | Alfa | 1 | S | Se autoriza (S) ou não (N) o cancelamento da aula. | |
Ticket | Alfa | 12 | N | Ticket vinculado a autorização do início da aula. | Devolve o mesmo Ticket Obrigatório quando aula autorizada. |
Mensagem_Erro | Alfa | 400 | N | Mensagem descrevendo motivo não autorização cancelamento da aula. | Obrigatório quando cancelamento da aula não autorizado. |
Tratamento de exceção : se não houver retorno do sistema do DETRAN/RS (Ex: devido algum erro de conexão, etc), o simulador deverá prever reenvio da solicitação. O reenvio pode ser em momento posterior, mas deve enviar o Ticket e a 'Hora_Inicio_Aula' previstos no envio original.
e) Registro Aula Offline (somente para aula finalizada ok).
e.1) Simulador : informa para o DETRAN/RS a realização de uma aula feita em modo offline.
Somente aula efetivamente realizada.
- Os dados são similares ao do serviço 'confirmaConclusaoAula', mas sem o ticket de autorização definido previamente.
e.2) DETRAN/RS : valida solicitação por meio sistêmico. Registra realização da aula no sistema do DETRAN/RS.
Entrada :
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Credencial | Alfa | 12 | S | Código para acesso aos Serviços do Simulador. | O código será fornecido pelo DETRAN (ou PROCERGS) para a Empresa fornecedora do Simulador. |
Cod_Sala | Numérico | 8 | S | Código Sala onde se localiza o simulador. | Definido pelo DETRAN a ser informado para CFC. |
Cod_Simulador | Numérico | 6 | S | Código do Simulador no DETRAN | Definido pelo DETRAN a ser informado para o CFC |
Cod_CFC | Alfa | 8 | S | Código que identifica o CFC no DETRAN | ex. 'CHC99999' |
Cod_Operador_SCA | Numérico | 11 | S | Código de Usuário do Instrutor para acesso aos sistemas do DETRAN. Vinculado ao Cod_CFC (Código Cliente). | Pode ser outro profissional habilitado a dar a Aula no simulador (ex. Diretor de Ensino). |
RENACH | Alfa | 11 | S | Número do RENACH do Candidato aberto no DETRAN | |
CPF_Candidato | Numérico | 11 | S | Número do CPF do Candidato | |
Doc _ Ident _Interprete | Alfa | 15 | N | Documento de Identidade do Intérprete Libras | Será exigido para candidatos com Restrição Y. |
UF_Ident_Interprete | Alfa | 2 | N | UF do Documento de Identidade do Intérprete Libras | Será exigido junto com Documento de Identidade para candidatos com Restrição Y |
Hora_Inicio_Aula | Alfa | 19 | S | Data/Hora de início da aula. | YYYY-MM-DD HH:MM:SS |
Hora_Fim_Aula | Alfa | 19 | S | Data/Hora de fim da aula. | YYYY-MM-DD HH:MM:SS |
Tempo Circulação do Veículo | Numérico | 6 | S | Tempo efetivo que o veículo esteve em funcionamento durante a aula. | HH:MM:SS |
Velocidade Média | Numérico | 3,1 | S | Velocidade Média do veículo durante a aula. Em km/h. | 999V9 |
Velocidade Máxima | Numérico | 3,1 | S | Velocidade Máxima do veículo durarnte a aula. Em km/h | 999V9 |
Distância Percorrida | Numérico | 6 | S | Distância, em metros, percorrida pelo veículo durante a aula. | |
Lista de Eventos ? pode ter 0 a n ocorrência (máximo 1000) | N | Tabela com os Eventos ocorridos na Aula. Devem ser informados os Conteúdos pedagógicos, Infrações e erros. | O Código do Evento deverá ser convertido pelo simulador Código do DETRAN usando uma tabela DE/PARA a ser fornecida pelo DETRAN/RS. | ||
Hora_Evento | Alfa | 19 | S | Hora do Evento | YYYY-MM-DD HH:MM:SS |
Cod_Evento | Numérico | 7 | S | Código do Evento que pode corresponder ao Conteúdo Pedagógico, Infração ou erro. | Convertido conforme tabela DE/PARA a ser fornecida pelo DETRAN/RS. |
Descr_Evento | Alfa | N | Descrição do Evento nos casos em que a tabela do DETRAN considera outros eventos. |
Retorno:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Ind_Autorizacao | Alfa | 1 | S | Se autoriza (S) ou não (N) a realização da aula. | |
Ticket | Alfa | 12 | N | Ticket de autorização do registro da Aula offline. | Obrigatório quando aula autorizada. |
Mensagem_Erro | Alfa | 400 | N | Mensagem descrevendo motivo não liberação da aula. | Obrigatório quando aula não autorizada. |
Tratamento de exceção : se não houver retorno do sistema do DETRAN/RS (ex. Devido algum erro de conexão, etc), o simulador deverá prever reenvio da solicitação.
f) Consulta Situação Ticket (verificar situação da Aula)
f.1) Simulador : solicita para o DETRAN/RS a situação da aula vinculada a um Ticket.
f.2) DETRAN/RS : valida solicitação. Retorna Situação da aula no sistema do DETRAN/RS.
Entrada:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Credencial | Alfa | 12 | S | Código para acesso aos Serviços do Simulador. | O código será fornecido pelo DETRAN (ou PROCERGS ) para a Empresa fornecedora do Simulador. |
Ticket | Alfa | 12 | S | Ticket de autorização. |
Retorno:
Campo | Tipo | Tamanho | Obrigatório | Descrição | Obs. |
Ind _ Autorizacao | Alfa | 1 | S | Se consulta foi realizada com sucesso (S) ou não (N) . | |
SituacaoAula | Numérico | 2 | N |
0-Não possui Aula iniciada 1-Aula em Andamento, pendente Conclusão. 2-Aula Concluída pelo Simulador-Pendente Homologação pelo CFC 3-Aula Concluída pelo Simulador-Homologada pelo CFC 97-Aula Concluída pelo Simulador-Rejeitada pelo CFC 98-Aula Cancelada pelo Simulador 99-Aula Cancelada manualmente pelo CFC e/ou DETRAN/RS |
Obrigatório quando Consulta autorizada. |
Observacao | Alfa | 400 | N | Texto com Observação adicional sobre situação do | |
Mensagem_ Erro | Alfa | 400 | N | Mensagem descrevendo motivo do erro no caso de processamento com erro da consulta. | Obrigatório quando Consulta não autorizada. |