Pular para o conteúdo principal

Usando as extensões

Vamos ilustrar como as extensões podem ser utilizadas em recursos FHIR, utilizando exemplos genéricos com nomes fictícios e URLs customizadas.

Exemplo 1: Indicando se o Paciente é um Doador de Órgãos​

O atributo cadavericDonor indica se o paciente é um doador de órgãos.
Ele é utilizado para identificar pacientes que são doadores, o que pode ser relevante em contextos de transplantes e cuidados de saúde relacionados.

Neste exemplo, a paciente é "Joana Santos", com CPF 99988877766.
Ela é uma doadora de órgãos, e isso é representado por uma extensão com valueBoolean.

{
  "resourceType": "Patient",
  "id": "joana-santos",
  "identifier": [
    {
      "system": "https://servicos.receita.fazenda.gov.br/servicos/cpf/",
      "use": "official",
      "value": "99988877766"
    }
  ],
  "name": [
    {
      "use": "official",
      "text": "Joana Santos",
      "family": "Santos",
      "given": ["Joana"]
    }
  ],
  "gender": "female",
  "birthDate": "1985-02-14",
  "extension": [
    {
      "url": "https://landing-zone-api.nilo.services/fhir/StructureDefinition/cadaveric-donor",
      "valueBoolean": true
    }
  ],
  "active": true
}

Explicação:

  • A extensão é adicionada dentro do recurso Patient com a url cadaveric-donor.
  • O valor da extensão é um valueBoolean, que indica se o paciente é doador (true) ou não (false).
  • Este campo é útil em contextos como transplantes de órgãos ou registros de banco de doadores.

Exemplo 2: Indicando se o Paciente é um Lead​

O atributo patient-isLead define se o paciente está em fase de pré-cadastro e ainda não completou o processo com aceite de termos.

Neste exemplo, o paciente ainda é um lead, ou seja, não aceitou os termos para se tornar um paciente.

{
  "resourceType": "Patient",
  "extension": [
    {
      "url": "https://landing-zone-api.nilo.services/fhir/StructureDefinition/patient-isLead",
      "valueBoolean": true
    }
  ]
}

Explicação​

A extensão patient-isLead indica que o paciente ainda está em fase inicial do processo.

Quando o valor é true, a plataforma entende que ele ainda precisa aceitar os termos e concluir o cadastro.

Exemplo 3: Definindo se o Paciente Receberá uma Mensagem de Boas-vindas​

A extensão patient-sendWelcomingMessage serve para automatizar o envio de uma mensagem de boas-vindas após o cadastro.

Neste exemplo, a mensagem será enviada automaticamente.

{
  "resourceType": "Patient",
  "extension": [
    {
      "url": "https://landing-zone-api.nilo.services/fhir/resources/StructureDefinition/patient-sendWelcomingMessage",
      "valueBoolean": true
    }
  ]
}

Explicação​

Ao definir valueBoolean como true, a plataforma enviará automaticamente uma mensagem de boas-vindas para o paciente.

Pode ser útil em contextos de ativação automática.

Exemplo 4: Liberação para Primeiro Agendamento​

A extensão patient-createOnboardingScheduling indica se o paciente poderá realizar o primeiro agendamento logo após o cadastro.

Neste exemplo, o agendamento inicial está liberado.

{
  "resourceType": "Patient",
  "id": "example-patient-onboarding-scheduling",
  "extension": [
    {
      "url": "https://landing-zone-api.nilo.services/fhir/resources/StructureDefinition/patient-createOnboardingScheduling",
      "valueBoolean": true
    }
  ]
}

Explicação​

Se a extensão estiver presente com valueBoolean: true, o sistema libera o paciente para agendar imediatamente após o cadastro.

Útil em fluxos rápidos de triagem, teleorientação ou onboarding automatizado.