receitapdf

Biblioteca Rust, CLI e extensão Python que recebem uma prescrição estruturada e devolvem os bytes do PDF. Os oito modelos usam os layouts ajustados e aprovados em examples/: A, B, B2, A/B veterinários, retinoides, talidomida e Receita de Controle Especial (RCE).

Layouts usados na geração

A CLI e as APIs Rust/Python usam o mesmo renderizador Rust. Os cabeçalhos aprovados estão incorporados em assets/modelos/; os boxes, rótulos, dados, rodapé e QR são desenhados na geração. Não é necessário instalar PyMuPDF, executar scripts Python ou acessar a rede para gerar uma receita.

Os PDFs originais continuam como referência. Os layouts ajustados são derivados desses arquivos; não são os arquivos oficiais intactos. A consulta feita durante os ajustes está em endereço e modelo oficial.

Padrões compartilhados:

• Página de 595,5 × 842,25 pt; espaçamento de 10 pt entre os boxes.
• Caixa de numeração com as mesmas dimensões nos oito modelos.
• Rótulos de 7,5 pt acima dos valores de 10 pt; entrelinha de 14 pt.
• Nomes com até duas linhas; endereços de emitente/paciente com até três.
• Emitente e paciente com a mesma altura, calculada pelos dados.
• Prescrição com quebra automática e limite definido pelo espaço disponível.
• Rodapé alinhado pela base, com entrelinha de 20 pt. Plataforma e assinatura aceitam até duas linhas cada, sem reservar uma linha vazia.
• Últimas três instruções em itálico, URLs em negrito itálico ao lado dos rótulos.
• Token e código acima do QR, alinhados ao seu lado esquerdo; base visível do QR alinhada à última linha do rodapé.
• Na talidomida, nome/CPF/telefone do responsável ficam lado a lado, com endereço abaixo e espaço para duas linhas. Dose e tempo de tratamento ficam lado a lado.

A prescrição utiliza o espaço restante acima do rodapé: textos adicionais no rodapé reduzem sua altura quando necessário. Conteúdo que excede a capacidade retorna erro; não é truncado nem sobreposto.

CLI

Rust está declarado em mise.toml:

mise install
mise exec rust -- cargo run --release -- examples/notificacao-a.json saida.pdf

O executável recebe <entrada.json> <saida.pdf>. Para entrada padrão:

cat examples/notificacao-a.json | mise exec rust -- cargo run --release -- - saida.pdf

API Rust

use receitapdf::{gerar_pdf, Receita};

fn gerar(receita: &Receita) -> Result<Vec<u8>, receitapdf::Erro> {
    gerar_pdf(receita)
}

gerar_pdf valida os campos obrigatórios, número, telefones e capacidade do layout. Retorna os bytes do PDF ou Erro. A assinatura criptográfica, a obtenção do número SNCR e as decisões clínicas são responsabilidades da integração chamadora.

API Python

CPython 3.13 ou superior. A extensão usa PyO3 com ABI estável abi3; Rust/Cargo são necessários para compilar a partir do código-fonte:

python3.13 -m pip install .

import json
from pathlib import Path
from receitapdf import gerar_pdf, url_qr

receita = json.loads(Path("examples/notificacao-a.json").read_text(encoding="utf-8"))
Path("saida.pdf").write_bytes(gerar_pdf(receita))
print(url_qr(receita))

gerar_pdf retorna bytes. Entrada ausente, inválida ou que exceda o espaço disponível gera ValueError; falhas internas de geração geram RuntimeError. Para construir o wheel: maturin build --release.

JSON: campos e formatos

CLI e APIs aceitam a mesma estrutura. Todos os exemplos declaram todos os campos da API; opcionais não usados recebem null. Os arquivos dados-curtos.json e dados-longos.json em cada pasta de modelo também são entradas válidas da CLI. Dados são totalmente fictícios.

Campos da receita

Campos obrigatórios não aceitam texto em branco. Os limites de linhas são medidos pela fonte e largura efetivas do PDF; uma palavra que não caiba na largura é rejeitada. \n cria uma quebra explícita. Datas, CPF/passaporte, CID e valores clínicos são textos fornecidos pela integração; o componente não valida sua semântica.

Emitente (prescritor)

Paciente / proprietário (paciente)

Campos específicos de um modelo são impressos somente nele. Telefones preenchidos são validados mesmo quando o campo não é impresso.

Prescrição (medicamento)

Na talidomida, o box usa quantidade, dose, tempo de tratamento, posologia e outras orientações. Nome, concentração e forma farmacêutica continuam obrigatórios na entrada estruturada, embora não sejam impressos nesse modelo.

Dados específicos e responsável

Sem responsável, o box permanece vazio. O endereço dele reserva duas linhas conforme o layout aprovado.

Telefones e endereços

Telefones devem usar E.164 sem espaços ou pontuação: +5571930000000. Outros formatos, como (71) 93000-0000, são rejeitados. No PDF, números brasileiros aparecem como (71) 93000-0000 ou (71) 3000-0000; telefones de outros países mantêm E.164.

Endereços são strings completas. Padrão usado nos exemplos: logradouro, número, complemento, bairro, cidade/UF, CEP 00000-000. A ordem é uma convenção dos exemplos, não uma validação normativa implementada. Veja a consulta sobre endereço.

Modelos, exemplos e QR

Nas Notificações, o QR usa a consulta SNCR:

https://sncr.anvisa.gov.br/receita/consultar?numero={numero}

Na RCE, o QR usa exatamente link_verificacao, conforme o layout aprovado neste projeto. O número da RCE segue o mesmo padrão textual do A, mas seu QR é da plataforma. url_qr retorna a URL correspondente nos oito modelos.

Gerar todos os exemplos

python -m pip install pymupdf pillow
python examples/gerar_exemplos.py

O script compila a CLI Rust e gera:

• Os oito PDFs principais em examples/.
• Dezesseis PDFs e PNGs, com dados curtos e longos, em modelos-gerados.
• Prévias de 144 dpi e contato visual.
• Os quatro exemplos de rodapé com plataforma/assinatura em uma ou duas linhas, em examples/rodape-plataforma-*.pdf.

PyMuPDF e Pillow são usados apenas nas prévias. Os PDFs são produzidos pela mesma CLI que o consumidor usa.

Os scripts examples/recriar_*.py mantêm as referências de ajuste visual e usam os mesmos JSONs da API. Após alterar os cabeçalhos nesses estudos, execute python examples/preparar_modelos.py para atualizar assets/modelos/ e recompile a biblioteca. As fontes Open Sans e os avisos vetoriais vêm dos originais; a composição Rust usa printpdf e lopdf. DejaVu Sans é incorporada nos dados e DejaVu Sans Bold Oblique nas URLs.

Compilação e testes

mise exec rust -- cargo check --locked --all-targets --features python
mise exec rust -- cargo test --locked
mise exec rust -- cargo test --locked --features python
maturin build --release

O código é MIT (LICENSE); fontes e modelos de origem mantêm seus próprios termos.

Publicar no PyPI

O workflow publish-pypi.yml cria o sdist e o wheel Linux x86_64, executa os testes e publica via Trusted Publishing. Para habilitar a publicação, cadastre um publisher pendente nas configurações do PyPI com estes valores:

• Projeto PyPI: receitapdf
• Owner do GitHub: ramon
• Repositório: receitapdf
• Workflow: .github/workflows/publish-pypi.yml
• Environment do GitHub: pypi

Depois desse cadastro, a publicação pode ser iniciada manualmente em master ou ao publicar uma release do GitHub com tag vX.Y.Z igual à versão em pyproject.toml. O job usa OIDC; não é necessário guardar token do PyPI como secret.