Cobertura de Saúde
Introdução
O recurso "Cobertura de saúde" destina-se a gerenciar informações sobre um plano de saúde (seguro), um benefício de saúde, um produto que pode ser usadas para pagar, em parte ou no todo, o fornecimento de produtos de saúde e serviços.
Principais informações:
- Nome do benefício
- Identificadores do beneficiário
Contexto NiloCare
Os endpoints desse recurso permitem aos clientes Nilo Saúde manipular o cadastro de benefício de um paciente na plataforma NiloCare, é uma alternativa a interface de usuário para integração e automatização.
Mapeamento de Campos
| # | Campo | Expressão de caminho no payload | ||||
|---|---|---|---|---|---|---|
| 1 | Paciente (beneficiário) | beneficiary | ||||
| 2 | Plano de saúde | class.where(type.text='plan').first().value | ||||
| 3 | Relação com titular | relationship.coding.first().code = 'self' ? subscriberId : dependent | ||||
| 4 | Situação | status | ||||
| 5 | Estipulante | policyHolder.display | ||||
| 6 | Início de vigência | period.start | ||||
| 7 | Fim de vigência | period.end | ||||
| 8 | Ordem / prioridade da cobertura | order | ||||
* Demais atributos nos payloads são armazenados, mas não afetados pelo sistema.
Especificações extras de comportamento FHIR - NiloCare
Campos de data
As datas no sistema seguem o padrão ano-mês-dia (YYYY-MM-DD), garantindo consistência no registro e exibição das informações. Caso um horário seja enviado junto (ex.: 2022-05-23T19:00:00+00:00), apenas a parte da data é considerada.
Plano de saúde (class)
O plano é identificado pelo value do primeiro item de class cujo type.text seja plan — esse value corresponde ao identificador do plano (InsurancePlan) na Nilo. O atributo class.name é apenas informativo e não é usado para localizar o plano.
Alternativamente, o plano pode ser informado por meio da extension InsurancePlan, enviando o identifier do plano em valueIdentifier.
Ordem da cobertura (order)
O campo order é 1-based no payload FHIR (o menor valor válido é 1) e é convertido para a representação interna 0-based da Nilo. Ou seja, order: 1 corresponde à primeira cobertura (ordem 0 internamente).
Situação (status) automática
Ao consultar uma cobertura, se o status não estiver definido internamente, ele é derivado automaticamente:
cancelled— quandoperiod.end(fim de vigência) já passou;active— nos demais casos.
Operadora (payor)
O campo payor não é persistido a partir do payload de cadastro e, na consulta, é sempre retornado como [{ "display": "Operadora" }].