Como integrar a API de assinatura médica
Passos para conectar seu sistema à API de assinatura digital ICP-Brasil da Prescri.
- 1
Solicite a chave de teste
Cadastre seu sistema e receba uma API key válida por 10 dias.
- 2
Cadastre o médico
Envie CRM, UF e CPF; a validação no CFM é automática.
- 3
Crie o documento
POST com o tipo de documento, dados do paciente e conteúdo.
- 4
Receba o assinado
O webhook entrega o PDF ICP-Brasil, o QR Code e o link de validação.
O que é uma API de assinatura médica
É uma interface REST que permite ao seu software gerar documentos médicos e obter a assinatura digital do profissional com validade jurídica ICP-Brasil, sem que o médico precise usar outra plataforma.
Diferente de assinadores genéricos, uma API de assinatura médica trata das exigências específicas da saúde: identificação do CRM/UF, tipo de receituário, exigências da Portaria 344/98 para controlados, QR Code de conferência para a farmácia e guarda do documento por 20 anos.
API pura ou SDK embarcado: qual escolher
| Critério | API REST | SDK em iframe |
|---|---|---|
| Esforço de integração | Médio | Baixo (poucas linhas) |
| Controle da interface | Total (você monta) | Pronta e responsiva |
| Fluxo de assinatura | Você orquestra | Já incluso |
| Cadastro de pacientes e modelos | Sua base | Telas prontas |
| Melhor para | PEP e sistemas maduros | Telemedicina e MVPs |
Recursos da API
- Criação de documentos assinados com tipo opcional (receituário, atestado, laudo, relatório, encaminhamento, pedido de exame).
- Endpoint de consulta dos tipos de documento disponíveis e seus identificadores.
- Envio automático ao paciente por WhatsApp com o link de validação.
- Consulta de status: emitido, assinado, enviado, dispensado ou dispensado parcialmente.
- Webhooks assinados com HMAC SHA-256 e painel de auditoria de entregas.
- Portal público do documento com QR Code para conferência por farmácias.
Segurança e conformidade
- Assinatura PAdES com certificado ICP-Brasil do próprio médico — a Prescri não assina no lugar dele.
- Validação do CRM diretamente na base do CFM antes da primeira assinatura.
- Origens permitidas por parceiro, chaves rotacionáveis e logs por requisição.
- Tratamento de dados conforme a LGPD e guarda de documentos por 20 anos (exigência do CFM).
Quem usa a API de assinatura médica
- Prontuários eletrônicos (PEP) que precisam entregar receita assinada ao fim da consulta.
- Plataformas de telemedicina que atendem em escala nacional.
- Clínicas e redes com sistema próprio de agendamento e atendimento.
- Healthtechs de emagrecimento, saúde mental e cuidado contínuo com prescrição recorrente.
- Farmácias e marketplaces que precisam validar e registrar dispensações.
Quanto custa e como testar
A integração começa com uma chave de teste gratuita válida por 10 dias, com acesso a todos os endpoints e ao SDK. Depois do período de teste, o plano é definido pelo número de médicos assinantes e pelo volume mensal de assinaturas.
O certificado digital ICP-Brasil continua sendo do médico e é adquirido junto à Autoridade Certificadora (VidaaS ou BirdID).