O papel de cada fonte#
- ANVISA: dados abertos de medicamentos registrados e fatos regulatórios presentes no recurso adotado.
- CMED: dados públicos de apresentações e campos publicados nos recursos de preços adotados; a API V1 não anuncia um endpoint de preços.
- DCB: número e denominação pública de princípios ativos na lista adotada.
A IaBula estrutura os recursos adotados; não é uma API oficial desses órgãos e não representa a totalidade dos seus sistemas. Fontes publicam em ritmos distintos. Não existe promessa de atualização em tempo real, cobertura integral ou SLA de atualização nesta documentação.
Leia a evidência junto ao fato#
Registros importantes carregam evidence. A classe distingue fatos oficiais, derivados e inferidos quando aplicável. OFFICIAL exige fonte oficial rastreável; DERIVED descreve transformação; INFERRED descreve inferência. Essas classes não são probabilidades de precisão clínica.
O schema de evidência inclui class e pode incluir source, dataset, retrieved_at, source_record_id, source_run_id, attribute e rule_version. O feed de alterações acrescenta source_version e source_url. Campos ausentes não devem ser preenchidos por suposição no cliente.
Ausência, nulos e identidade#
Uma lista vazia descreve o que o catálogo possui, não todo o mercado. Um campo nulo representa informação não disponível no contrato. Um texto de princípio ativo não implica vínculo canônico, e semelhança entre nomes não é relação regulatória. Preserve esses limites na interface do seu produto.