Este Guia de Orientações aos Desenvolvedores dispõe sobre as instruções técnicas necessárias para um correto funcionamento do portal VALIDAR, apresentando os requisitos que devem ser corretamente seguidos pelos profissionais de desenvolvimento interessados em integrar o serviço a suas respectivas plataformas ou mesmo gerar QR Codes.
Informamos que o ITI não dá suporte de como gerar um arquivo assinado. Para isso, há uma série de assinadores digitais no mercado, principalmente ofertados pelas Autoridades Certificadoras e outras entidades credenciadas pela ICP-Brasil.
Nesse documento, os desenvolvedores poderão encontrar orientações sobre:
problemas poderão ser relatados através do Fale Conosco do serviço, disponível no link: https://validar.iti.gov.br/fale-conosco.html.
Os seguintes parâmetros (query parameters) deverão ser adicionados na URL encontrada no QR Code do documento:
Nome | Conteúdo | Descrição | Obrigatório |
_format | application/validador-iti+json | Reservado para o uso do Portal Validar do ITI: https://validar.iti.gov.br/ | Sim |
_secretCode | Conjunto de caracteres alfanuméricos. Variável de 0 a 64 caracteres. | Código informado pelo paciente para permitir o acesso a prescrição. | Sim |
Fluxo operacional esperado:
URL esperada no QR Code: https://[URL]
GET https://[URL]/?_format=application/validador-iti+json&_secretCode=XIU8789Y
GET https://[URL]/?type=prescricao&_parametroqualquer&_format=application/validador-iti+json&_secretCode= XIU8789Y
A resposta será um JSON, contendo a URL para o arquivo PDF assinado.
Resultado esperado conforme resultado a seguir:
{
 "version":"1.0.0",
 "prescription":{
   "signatureFiles":[
     {
       "url":"url/nomedoarquivo.pdf"
     }
   ]
 }
}
Códigos de status HTTP retornados:
Código | Nome | Descrição |
401 | Not Authorized | Quando o código secreto está incorreto. |
404 | Not Found | Quando a prescrição não existe. |
OID para profissionais (médicos e farmacêuticos)
2.16.76.1.4.2.2 | Conselho Federal de Medicina |
2.16.76.1.4.2.2.1 | Número de registro do profissional |
2.16.76.1.4.2.2.2 | UF de registro profissional |
2.16.76.1.4.2.2.3 | Especialidade |
2.16.76.1.4.2.3 | Conselho Federal de Farmácia |
2.16.76.1.4.2.3.1 | Número de registro do farmacêutico |
2.16.76.1.4.2.3.2 | UF de registro do farmacêutico |
2.16.76.1.4.2.3.3 | Especialidade |
2.16.76.1.4.2.12 | Conselho Federal de Odontologia |
2.16.76.1.4.2.12.1 | Número de registro do dentista |
2.16.76.1.4.2.12.2 | UF de registro do dentista |
2.16.76.1.4.2.12.3 | Especialidade |
OID para documentos digitais em saúde
2.16.76.1.12.1 | Documentos Digitais da Saúde |
2.16.76.1.12.1.1 | Prescrição de medicamento |
2.16.76.1.12.1.2 | Atestado médico |
2.16.76.1.12.1.3 | Solicitação de exame |
2.16.76.1.12.1.4 | Laudo laboratorial |
2.16.76.1.12.1.5 | Sumária de alta |
2.16.76.1.12.1.6 | Registro de atendimento clínico |
2.16.76.1.12.1.7 | Dispensação de medicamento |
2.16.76.1.12.1.8 | Vacinação |
2.16.76.1.12.1.11 | Relatório Médico |