Catálogo de códigos

Este recurso é somente leitura. Não existe POST /fhir/resources/CodeSystem — os catálogos são montados pela equipe no Nilo Care, nas configurações do ambiente.

concept[].code é o valor que vai em Flag.code.coding[].code (ou em Flag.category.coding[].code), e concept[].display é o nome que a equipe vê. São os dois únicos dados de cada código: não há descrição, hierarquia, sinônimo nem propriedade.

Só os códigos vigentes aparecem. Uma etiqueta encerrada no Nilo Care some do catálogo — e some sem deixar rastro, porque não há campo de situação por código.

Consequência: uma etiqueta aplicada a um paciente pode referenciar um código que não está mais no catálogo. Ao ler uma etiqueta, não conte com encontrar o código dela aqui — o display da própria etiqueta já traz o nome.

Este é o único caminho do projeto em que o segmento final não é o id do recurso. Em todos os outros recursos, /{id} é o identificador Nilo FHIR; aqui é o nome do catálogo.

Passar o id do recurso neste caminho não funciona — e é justamente o que o fullUrl do envelope traz. Ignore o fullUrl deste recurso: para reler o catálogo, monte o caminho com o nome.

Esta leitura não devolve um Bundle — mas também não devolve o recurso nu. A resposta é um envelope com fullUrl, search e resource, e o catálogo está em resource. Ler concept na raiz da resposta não encontra nada.

Os demais parâmetros canônicos do CodeSystem existem e não encontram nada, porque a plataforma não preenche o campo correspondente: name, title, version, identifier, context, jurisdiction, description, language e supplements.

Qualquer alteração numa etiqueta republica o catálogo inteiro. O recurso é sempre a lista completa: acrescentar, renomear ou encerrar uma etiqueta reescreve o CodeSystem inteiro, com um meta.versionId novo.

Isso vale inclusive para a remoção: encerrar uma etiqueta não apaga o catálogo — ele é republicado sem ela. Não trate uma mudança de versão do catálogo como sinal de que algo específico mudou; compare as listas.

Encerrar uma categoria encerra, junto, todas as etiquetas dela — então uma única ação faz os dois catálogos mudarem de versão ao mesmo tempo.

Como o catálogo é pequeno e muda pouco, o padrão de uso recomendado é lê-lo uma vez, guardar o mapa código → nome do seu lado, e reler quando uma etiqueta trouxer um código que você não conhece.

Um POST /fhir/resources/CodeSystem não é uma operação suportada e não devolve um erro de validação tratável: a chamada falha com erro inesperado do servidor (500). Não escreva tratamento em cima desse comportamento — ele não é contrato, e nada é gravado.