Unidade de cuidado

A referência declara name como obrigatório porque é o único dado que a plataforma guarda desta unidade. O Organization do FHIR R4, em si, não exige o nome — quem recusa o payload sem nome é a plataforma, e por isso essa recusa tem uma forma diferente das outras: vem como code: exception, sem expression. Veja Erros.

A referência lista só os campos suportados e por isso rejeita os demais no seu validador, mas a API em si não recusa quem os manda. O que acontece com eles é que ficam guardados no recurso e voltam nas leituras seguintes — sem nunca terem significado nada para a plataforma, e sem aparecer em lugar nenhum do Nilo Care. Um address enviado assim parece o endereço da unidade, e não é. Omita-os.

Não há como desativar nem excluir uma unidade por esta API. O active da resposta é sempre true, e enviá-lo como false não muda nada. Encerrar uma unidade é assunto do Suporte.

Renomear é seguro: nenhum vínculo de paciente, profissional ou equipe é afetado. O que muda é o rótulo, em todos os lugares onde a unidade aparece.

Busca sem resultados não é erro: volta 200 com um Bundle cujo entry é uma lista vazia. Trate a ausência de resultados pela lista vazia, não esperando um 404.

Os demais parâmetros canônicos do Organization existem e não encontram nada aqui, porque a Nilo não preenche o campo correspondente: address e as suas variações, type, partof e endpoint. A exceção é o campo que você mesmo tenha enviado: ele fica no recurso e passa a ser encontrável — mais um motivo para omitir o que a plataforma não usa.

A consulta não devolve só as unidades que você criou: as criadas ou alteradas dentro do Nilo Care também aparecem. Elas trazem apenas o identificador Nilo, no system …/NamingSystem/sorting-hat-api--care-unit; só as que vieram por integração trazem também a sua chave. É por essa diferença que você separa umas das outras.

Uma unidade antiga, que ninguém tenha tocado desde que a sua integração começou, pode não aparecer na lista. Se você espera uma unidade e ela não vem, peça ao Suporte — a busca não é um inventário garantido do ambiente.

Diferente da busca, 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 a unidade está em resource. Ler name na raiz da resposta não encontra nada.

telecom é o telefone da sua operação, não o desta unidade. Todas as unidades do ambiente devolvem o mesmo número — o cadastrado para o seu ambiente. Ele é omitido quando não há telefone cadastrado. Não trate esse valor como contato da unidade.

E ao contrário dos campos não suportados, um telecom que você envie não sobrevive: ele é substituído pelo telefone do ambiente na gravação. Não há como registrar um telefone próprio da unidade por esta API.

alias repete o name. É sempre uma lista de um item, com o mesmo texto do nome, e nunca traz um nome alternativo de verdade. Existe para quem lê o alias do Organization canônico e não encontraria nada.

Qual identificador vale muda conforme o recurso. Paciente e Profissional aceitam qualquer identificador da unidade, inclusive a sua chave — no Paciente, a referência precisa vir com "type": "Organization" para a chave própria ser resolvida. A Equipe de cuidado é a exceção: ela lê só o identificador Nilo da unidade, e um identificador do seu sistema é ignorado em silêncio, caindo na unidade padrão.

Alguns desses campos caem numa unidade padrão da implantação quando você os omite. Isso é configuração do seu ambiente, não do recurso: se não houver unidade padrão configurada, a escrita do outro recurso é recusada. Veja a página de cada um.

Criar uma unidade não move ninguém para ela. A unidade nasce vazia; pacientes, profissionais e equipes só passam a pertencer a ela quando os recursos deles a referenciam.

Este endpoint nunca responde 204: não há remoção de unidade por integração.

A última linha não é uma validação desta API — é a recusa da própria plataforma, repassada como está. Ela sai com code: exception, sem expression, e com uma mensagem de erro de linguagem em vez de uma explicação do campo. Não tente interpretar o texto: trate code: exception como “payload recusado, motivo não classificado” e confira o name.