Como integrar assinatura digital ao prontuário eletrônico
Etapas de uma integração de receita digital assinada em um PEP existente.
- 1
Mapeie os documentos
Liste os tipos emitidos hoje: receita simples, controle especial, atestado, laudo, pedido de exame.
- 2
Padronize os dados
Garanta CPF do paciente, CRM/UF e CPF do médico e o conteúdo estruturado do documento.
- 3
Conecte a API
Crie o documento pela API e registre o identificador no atendimento.
- 4
Trate os eventos
Atualize o prontuário quando o webhook confirmar assinatura, envio e dispensação.
- 5
Homologue
Valide os PDFs no validador do ITI e rode um piloto com um grupo de médicos.
Arquitetura recomendada
O PEP continua sendo a fonte da verdade do atendimento. A plataforma de assinatura é responsável apenas por gerar o documento assinado e devolver o resultado. A ligação entre os dois mundos é o identificador do documento, guardado no registro do atendimento.
- Backend do PEP chama a API — nunca o navegador, para não expor a chave.
- Uma tabela de vínculo entre atendimento, paciente e documento assinado.
- Endpoint de webhook idempotente, com verificação de HMAC.
- Job de reconciliação diário consultando status de documentos pendentes.
Dados mínimos por tipo de documento
| Documento | Dados essenciais | Observação |
|---|---|---|
| Receituário médico | Paciente, medicamentos, posologia, quantidade | Validade usual de 30 dias |
| Controle especial | Paciente com endereço, medicamento, quantidade por extenso | Sujeito à Portaria 344/98 |
| Atestado | Paciente, período de afastamento, CID opcional | CID só com autorização do paciente |
| Laudo / relatório | Paciente, achados, conclusão | Texto livre estruturado |
| Pedido de exame | Paciente, exames solicitados, indicação clínica | Aceita múltiplos itens |
O que muda para o médico
- Assina pelo celular com PIN ou biometria, sem token físico.
- Uma autorização vale para várias assinaturas dentro da sessão.
- O paciente recebe o documento por WhatsApp em segundos.
- O histórico fica pesquisável dentro do próprio prontuário.
O que muda para a clínica ou hospital
- Fim do custo de papel, impressão e digitalização de receituários.
- Redução de retrabalho por receita recusada na farmácia.
- Indicadores de adesão por profissional e por unidade.
- Trilha de auditoria pronta para exigências de conformidade e LGPD.
Checklist de homologação
- PDF assinado aprovado no validador oficial do ITI.
- QR Code e link público abrindo o portal do documento.
- Status de dispensação refletido no prontuário para receitas controladas.
- Comportamento correto quando a sessão do certificado expira.
- Teste de reentrega de webhook e de evento duplicado.
- Piloto com pelo menos cinco médicos antes do rollout geral.
Prazos e esforço típicos
Uma integração de receita e atestado costuma consumir de dois a cinco dias de desenvolvimento em um PEP com backend organizado, considerando criação do documento, webhook e telas de acompanhamento. Times que optam pelo SDK em iframe reduzem esse prazo para algumas horas, abrindo mão da interface própria.