Pacotes FHIR explicados: os nove tipos de pacotes e quando usar cada um

Resposta curta: Um Bundle é o recurso FHIR que agrupa outros recursos: resultados de pesquisa, um conjunto de escritas enviadas num pedido, um documento clínico como um resumo do paciente, ou uma mensagem. O seu tipo indica o que o grupo significa e como um servidor deve tratá-lo.

Os nove tipos em FHIR R4

• searchset: os resultados de uma pesquisa, com links de paginação.
• transaction: escritas processadas de forma "tudo ou nada"; se uma falhar, nenhuma é aplicada.
• batch: escritas processadas de forma independente; cada entrada tem sucesso ou falha por si só.
• transaction-response / batch-response: o que o servidor retorna para cada um.
• document: um documento clínico (a primeira entrada é uma Composition), como o Resumo Internacional do Paciente; é assinado ou armazenado como um todo.
• message: uma mensagem, a primeira entrada é um MessageHeader.
• history: as versões dos recursos.
• collection: um conjunto de recursos sem significado adicional.

Transação vs. lote

Use uma transação quando os recursos dependem uns dos outros, por exemplo, um Paciente e as Observações que o referenciam: referências entre entradas podem usar identificadores temporários urn:uuid: que o servidor resolve. Use um lote para operações independentes onde o sucesso parcial é aceitável.

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {"fullUrl": "urn:uuid:61ebe359-bfdc-4613-8bf2-c5e300945f0a",
     "resource": {"resourceType": "Patient", "name": [{"family": "Example"}]},
     "request": {"method": "POST", "url": "Patient"}},
    {"resource": {"resourceType": "Observation", "status": "final",
       "code": {"coding": [{"system": "http://loinc.org", "code": "8867-4"}]},
       "subject": {"reference": "urn:uuid:61ebe359-bfdc-4613-8bf2-c5e300945f0a"},
       "valueQuantity": {"value": 72, "unit": "/min", "system": "http://unitsofmeasure.org", "code": "/min"}},
     "request": {"method": "POST", "url": "Observation"}}
  ]
}

Em Anpheros

A Plataforma Anpheros aceita bundles de transação e lote e retorna bundles de searchset com paginação; o Resumo Internacional do Paciente é retornado como um bundle de documento. Veja a sandbox FHIR para experimentá-los, e o Resumo Internacional do Paciente em FHIR.

Páginas relacionadas

• Pesquisa FHIR explicada
• FHIR R4 vs R5

Fontes

• HL7 FHIR R4: Bundle
• HL7 FHIR R4: Tipos de Bundle

Perguntas frequentes

Qual é a diferença entre uma transação FHIR e um lote?

Uma transação é "tudo ou nada"; um lote processa cada entrada independentemente.

Como referencio um recurso criado no mesmo bundle?

Dê-lhe um fullUrl como urn:uuid:... e use-o como referência; numa transação, o servidor substitui-o pelo ID real.

Que tipo é um resumo do paciente?

Um bundle de documento cuja primeira entrada é uma Composition.

Por que é que a minha pesquisa retorna um Bundle?

Os resultados da pesquisa são sempre um bundle de searchset, com links para a próxima página.

Anpheros Platform

Experimente grátis no sandbox

Sua primeira chamada FHIR em 5 minutos. Uma API HL7 FHIR R4 com o consentimento do paciente integrado: experimente na sandbox e depois conecte a sua própria app ou sistema clínico.

Criar um sandbox grátisLer os guias para programadores →

Grátis · 30 pacientes sintéticos · sem cartão

Escrito por

A equipa Anpheros

A Anpheros desenvolve um registo médico que o doente controla e pode partilhar com qualquer clínica, numa plataforma HL7 FHIR R4, sediada na UE. Estes guias ajudam-no a compreender e organizar a sua saúde; não substituem o seu médico.

Sobre a Anpheros →