Boas Práticas

As extensões FHIR fornecidas pela Nilo foram criadas para representar informações específicas que não estão disponíveis diretamente no padrão base do FHIR. Para garantir que a troca de dados funcione corretamente entre os sistemas, é importante seguir as boas práticas abaixo ao utilizar essas extensões:

Use exatamente a URL da extensão fornecida
Cada extensão tem uma URL única que identifica seu significado e uso. É essencial usar essa URL exatamente como fornecida na documentação da Nilo, sem alterações.
Aplique a extensão no local correto do recurso
As extensões devem ser incluídas apenas nos pontos do recurso onde foram projetadas para funcionar (por exemplo, em Patient, Encounter, etc.). A documentação da Nilo sempre informa onde cada extensão deve ser aplicada.
Respeite o tipo de valor esperado
Cada extensão espera um tipo de dado específico (como texto, número, código, referência, etc.). Usar o tipo incorreto pode causar erros de validação ou dificultar o processamento pelos sistemas integrados.
Não altere a estrutura da extensão
As extensões já estão definidas com sua estrutura ideal. Evite modificar a chave, o nome do campo, ou adicionar elementos que não fazem parte da definição original.
Inclua apenas quando fizer sentido
Não é necessário preencher todas as extensões em todos os recursos. Use a extensão somente quando ela for relevante para o contexto daquele recurso.

Seguindo essas práticas, você garante que os dados enviados estarão compatíveis com a especificação da Nilo e poderão ser processados corretamente por todos os sistemas envolvidos.