1. Web Services
1.1 Comunicação
A comunicação entre o Inmetro e o software do simulador de pista será baseada em Web Services no padrão REST (Transferência do Estado Representativo), com troca de mensagens no formato XML, através da Internet, utilizando o protocolo SSL versão 3.0, que deverão ser assinadas digitalmente de maneira a garantir a integridade dos dados e a autoria do emissor.
1.2 Esquemas XML
Para garantir a correta formatação dos arquivos XML e a integridade mínima das informações enviadas, os documentos gerados deverão ser submetido para validação pelos esquemas XML (XSD – XML Schema Definition).
1.3. Assinatura digital
A assinatura digital do documento eletrônico deverá atender aos seguintes padrões:
- Padrão de assinatura: “XML Digital Signature”, utilizando o formato “Enveloped” (http://www.w3.org/TR/xmldsig-core);
- Função criptográfica assimétrica: RSA (1024-bits)
- Função de “message digest”: SHA-1
- Codificação: Base64
Para utilização dos serviços no ambiente de homologação, deverá ser utilizado o certificado digital disponibilizado para assinatura do arquivo XML: certificado
2. Serviços
O Inmetro disponibilizará os seguintes serviços:
- 2.1 Informar ensaio metrológico
- 2.2 Validar GRU
- 2.3 Solicitar emissão de certificado para veiculos novos
2.1. Informar ensaio metrológico
2.1.1. Padrões Técnicos
A codificação dos caracteres do documento XML será UTF-8 e a especificação adotada é a recomendação W3C para XML 1.0, disponível em www.w3.org/TR/REC-xml.
O formato das imagens deverá ser JPEG com resolução VGA (640x480) ou superior, sem exceder o tamanho de 250Kb. Para inclusão no documento XML deverá ser utilizado o método para codificação Base64.
2.1.2. Ambiente de Homologação
Para homologação da comunicação, foi disponibilizado um ambiente onde poderão ser feitos testes utilizandos os parâmetros abaixo:
| Serviço | Método | XSD | URL |
|---|---|---|---|
| Informar Ensaio | POST |
envio.xsd xmldsig-core-schema.xsd retorno.xsd |
https://webservicedesenv.cronotacografo.inmetro.rs.gov.br/informarEnsaio |
Exemplo de arquivo XML não assinado: XML não assinado
Exemplo de arquivo XML assinado: XML assinado
2.1.3. Ambiente de Produção
Para utilização do ambiente de produção, após o software do simulador de pista ser avaliado, deverão ser fornecidas as chaves públicas de cada posto de ensaio para que possam ser utilizadas. A URL para utilizar os serviços no ambiente de produção é https://webservice.cronotacografo.rbmlq.gov.br.
2.1.4. Códigos de retorno
Cada requisição receberá uma mensagem de resposta confirmando o recebimento da solicitação em caso de sucesso ou na ocorrência de qualquer erro na validação dos dados uma mensagem contendo o código e a descrição do erro.
| Código | Status | Mensagem |
|---|---|---|
| 200 | OK | Ensaio metrológico informado com sucesso. |
| 500 | ERRO | Requisição inválida. |
| 600 | ERRO | Requisição não possui um XML válido. |
| 700 | ERRO | A estrutura do XML é inválida. |
| 800 | ERRO | Não foi possível localizar a assinatura da requisição. |
| 801 | ERRO | Referência da assinatura inválida. |
| 802 | ERRO | Não foi possível localizar o elemento com a chave da requisição. |
| 803 | ERRO | Não foi possível localizar a chave da assinatura. |
| 804 | ERRO | Assinatura inválida. |
| 900 | ERRO | Você não possui autorização para acessar este serviço. |
| 1000 | ERRO | Verifique os campos que apresentam problemas e tente novamente. |
| 1100 | ERRO | GRU não encontrada. |
| 1200 | ERRO | GRU possui certificado não emitido pelo sistema. |
| 1300 | ERRO | Selagem não informada para GRU. |
| 1400 | ERRO | Ensaio já informado. |
| 1500 | ERRO | GRU já utilizada. |
| 1600 | ERRO | Aguarde a confirmação do pagamento. |
| 1700 | ERRO | Consta pagamento inferior ao valor da taxa de serviço metrológico. É necessário complementar o pagamento. |
| 1800 | ERRO | Não foi encontrado um contrato em vigência ou a quantidade contratada foi excedida. |
| 1900 | ERRO | A data de validade do certificado não pode exceder 2 anos. |
2.1.5. Histórico de alterações
- 11/02/2014 - Adicionada tabela com códigos de retorno e esquema XML de retorno.
- 07/02/2014 - Atualizações nos esquemas XML, adicionado campos VelMaxTotal, DistanciaTotal ao elemento Ensaio. Gerados novos arquivo XML de exemplos.
2.2 Validar Gru
2.2.1. Ambiente de Homologação
| Serviço | Método | XSD | URL |
|---|---|---|---|
| Validar GRU | GET |
envio.xsd xmldsig-core-schema.xsd retorno.xsd |
https://webservice.cronotacografo.rbmlq.gov.br/validarGru |
Exemplo de arquivo XML não assinado: XML não assinado
Exemplo de arquivo XML assinado: XML assinado
2.2.2. Ambiente de Produção
Para utilização do ambiente de produção, após o software do simulador de pista ser avaliado, deverão ser fornecidas as chaves públicas de cada posto de ensaio para que possam ser utilizadas. A URL para utilizar os serviços no ambiente de produção é https://webservice.cronotacografo.rbmlq.gov.br.
2.3 Solicitar Certificado Veiculos Novos
2.3.1. Ambiente de Homologação
Para homologação da comunicação, foi disponibilizado um ambiente onde poderão ser feitos testes utilizandos os parâmetros abaixo:
| Serviço | Método | XSD | URL |
|---|---|---|---|
| Solicitar Emissão de Certificado Veículo Novo | POST |
envio.xsd xmldsig-core-schema.xsd retorno.xsd |
https://webservicedesenv.cronotacografo.inmetro.rs.gov.br/solicitarEmissaoCertificadoVeiculoNovo |
Exemplo de arquivo XML não assinado: XML não assinado
Exemplo de arquivo XML assinado: XML assinado
2.3.2. Ambiente de Produção
Para utilização do ambiente de produção, após se cadastrar como "Empresa instaladora" conforme edital Inmetro 01/2013 e solicitar senha de acesso ao sítio cronotacografo.inmetro.rs.gov.br, deverá ser informar no site a chave pública que será utilizada para verificar a integridade e autoria das informações enviadas via webservice. A URL para utilizar os serviços no ambiente de produção é https://webservice.cronotacografo.rbmlq.gov.br/