# Nilo Saúde · Interoperabilidade FHIR

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api-docs.nilo.services/_mcp/server

## Docs

- [Introdução](https://api-docs.nilo.services/guia/comecando/introducao.md): Autenticação, ambientes e o formato das requisições da API de interoperabilidade da Nilo.
- [Escritas](https://api-docs.nilo.services/guia/comecando/escritas.md): Como o POST faz upsert por identificador e o que a API devolve em cada desfecho.
- [Identificadores](https://api-docs.nilo.services/guia/conceitos/identificadores.md): O que a API lê de um identificador, quais ela devolve e como referenciar e buscar recursos por identificador.
- [Extensões](https://api-docs.nilo.services/guia/conceitos/extensoes.md): Como a Nilo reconhece uma extensão pela URL, o catálogo das extensões suportadas e o que acontece com uma URL que ela não reconhece.
- [Profissional](https://api-docs.nilo.services/guia/recursos/practitioner.md): Cadastrar, atualizar e buscar profissionais de saúde no padrão FHIR Practitioner, com registro em conselho, especialidades e acesso ao NiloCare.
- [Paciente](https://api-docs.nilo.services/guia/recursos/patient.md): Cadastrar, atualizar e buscar pacientes no padrão FHIR Patient.
- [Cobertura de saúde](https://api-docs.nilo.services/guia/recursos/coverage.md): Cadastrar, atualizar e buscar coberturas de saúde no padrão FHIR Coverage.
- [Plano de saúde](https://api-docs.nilo.services/guia/recursos/insuranceplan.md): Consultar o catálogo de planos de saúde do seu ambiente e alterar o nome de um plano, no padrão FHIR InsurancePlan.
- [Equipe de cuidado](https://api-docs.nilo.services/guia/recursos/careteam.md): Montar a equipe de profissionais que acompanha um paciente e atribuir essa equipe a ele, no padrão FHIR CareTeam.
- [Grupo de pacientes](https://api-docs.nilo.services/guia/recursos/group.md): Criar, renomear e apagar grupos de pacientes, no padrão FHIR Group.
- [Diretriz](https://api-docs.nilo.services/guia/recursos/plandefinition.md): Cadastrar e consultar as diretrizes de cuidado — linhas de cuidado e protocolos — no padrão FHIR PlanDefinition.
- [Diretriz aplicada](https://api-docs.nilo.services/guia/recursos/careplan.md): Aplicar uma diretriz a um paciente e acompanhar essa diretriz aplicada, uma por paciente e diretriz, no padrão FHIR CarePlan.
- [Atendimentos](https://api-docs.nilo.services/guia/recursos/encounter.md): Registrar, atualizar e buscar atendimentos de teleconsulta e presenciais no padrão FHIR Encounter.
- [Procedimento](https://api-docs.nilo.services/guia/recursos/procedure.md): Registrar e consultar procedimentos cirúrgicos do paciente no padrão FHIR Procedure.
- [Hospitalização](https://api-docs.nilo.services/guia/recursos/encounter-hospitalization.md): Registrar, atualizar e buscar internações no padrão FHIR Encounter, com local e diagnósticos vinculados.
- [Pronto atendimento](https://api-docs.nilo.services/guia/recursos/encounter-emergency.md): Registrar, atualizar e buscar passagens por pronto atendimento no padrão FHIR Encounter, com local e diagnósticos vinculados.
- [Unidade de cuidado](https://api-docs.nilo.services/guia/recursos/organization.md): Cadastrar e consultar as unidades de cuidado do seu ambiente, no padrão FHIR Organization.
- [Local de atendimento](https://api-docs.nilo.services/guia/recursos/location.md): Cadastrar e consultar os estabelecimentos de saúde onde o cuidado acontece, no padrão FHIR Location.
- [Etiqueta](https://api-docs.nilo.services/guia/recursos/flag.md): Aplicar e consultar etiquetas nos pacientes, no padrão FHIR Flag.
- [Catálogo de códigos](https://api-docs.nilo.services/guia/recursos/codesystem.md): Consultar os catálogos de códigos do seu ambiente — etiquetas e categorias de etiqueta — no padrão FHIR CodeSystem.
- [Condição](https://api-docs.nilo.services/guia/recursos/condition.md): Registrar e consultar diagnósticos, condições crônicas e condutas do paciente no padrão FHIR Condition.
- [Gestação](https://api-docs.nilo.services/guia/recursos/observation-pregnancy.md): Registrar, atualizar e encerrar a gestação de uma paciente no padrão FHIR Observation, com DUM, risco, tipo e data do parto.
- [Avaliação clínica](https://api-docs.nilo.services/guia/recursos/clinicalimpression.md): Consultar a entrevista clínica, o exame físico e os pontos de atenção de um atendimento no padrão FHIR ClinicalImpression.
- [Conduta](https://api-docs.nilo.services/guia/recursos/requestgroup.md): Consultar as condutas registradas num atendimento no padrão FHIR RequestGroup.
- [Solicitação de serviço](https://api-docs.nilo.services/guia/recursos/servicerequest.md): Consultar pedidos de exame e encaminhamentos, e registrar condutas, no padrão FHIR ServiceRequest.
- [Medicamento](https://api-docs.nilo.services/guia/recursos/medication.md): Consultar os medicamentos que o paciente toma e os que foram prescritos a ele, no padrão FHIR MedicationStatement, MedicationRequest e Medication.
- [Questionário](https://api-docs.nilo.services/guia/recursos/questionnaire.md): Consultar os questionários do seu ambiente, com as perguntas e as opções de resposta, no padrão FHIR Questionnaire.
- [Questionário respondido](https://api-docs.nilo.services/guia/recursos/questionnaireresponse.md): Consultar as respostas dos questionários aplicados a um paciente no padrão FHIR QuestionnaireResponse.
- [Tarefa](https://api-docs.nilo.services/guia/recursos/task.md): Consultar as tarefas da equipe de cuidado e os questionários atribuídos ao paciente no padrão FHIR Task.
- [Consulta prevista](https://api-docs.nilo.services/guia/recursos/schedule.md): Consultar as consultas que uma diretriz previu para o paciente, no padrão FHIR Schedule.
- [Agendamento](https://api-docs.nilo.services/guia/recursos/appointment.md): Marcar, cancelar e consultar agendamentos entre paciente e profissional, no padrão FHIR Appointment.
- [Mensagem programada](https://api-docs.nilo.services/guia/recursos/communicationrequest.md): Consultar as mensagens que a plataforma vai enviar a um paciente, no padrão FHIR CommunicationRequest.
- [Mensagem enviada](https://api-docs.nilo.services/guia/recursos/communication.md): Consultar as mensagens trocadas com o paciente na conversa da plataforma, no padrão FHIR Communication.
- [Arquivo do paciente](https://api-docs.nilo.services/guia/recursos/media.md): Enviar documentos PDF para a ficha de um paciente e consultar os arquivos dele, no padrão FHIR Media.
- [Carga em lote](https://api-docs.nilo.services/guia/operacoes/carga-em-lote.md): Enviar várias escritas numa requisição só, no padrão FHIR Bundle.
- [Webhooks](https://api-docs.nilo.services/guia/operacoes/webhooks.md): Receber uma chamada da Nilo quando um recurso muda, no padrão FHIR Subscription.
- [Como diagnosticar](https://api-docs.nilo.services/guia/solucao-de-problemas/diagnostico.md): As cinco checagens que resolvem a maior parte dos erros de integração, e o índice das mensagens de erro conhecidas.
- [Identificadores e duplicidade](https://api-docs.nilo.services/guia/solucao-de-problemas/identificadores.md): Erros de casamento de identificador, paciente ou profissional duplicado, e reuso indevido de identificador.
- [Ordem de envio e processamento](https://api-docs.nilo.services/guia/solucao-de-problemas/ordem-de-envio.md): Erros de dependência entre recursos, envio concorrente, formato de payload e o tempo entre o 200 e a tela.
- [Diretrizes](https://api-docs.nilo.services/guia/solucao-de-problemas/diretrizes.md): Por que uma diretriz é recusada, por que ela é aceita e não aparece, e como reinscrever um paciente.
- [Equipe de cuidado e profissionais](https://api-docs.nilo.services/guia/solucao-de-problemas/equipe-e-profissionais.md): Profissional duplicado ou não encontrado, equipe criada e vazia na tela, e como identificar um profissional recebido.
- [Atendimentos e agendamento](https://api-docs.nilo.services/guia/solucao-de-problemas/atendimentos.md): Condição roteada para o fluxo errado, erros de período, identificador de agendamento repetido e etiquetas.
- [Cobertura, grupos e status](https://api-docs.nilo.services/guia/solucao-de-problemas/cobertura-e-grupos.md): Plano de saúde não reconhecido, carteirinha que não aparece, grupos sobrescritos e inativação de paciente.
- [Webhooks](https://api-docs.nilo.services/guia/solucao-de-problemas/webhooks.md): Por que as notificações pararam de chegar, por que uma assinatura não ativa e o que fazer com um evento perdido.
- [Configuração e ambientes](https://api-docs.nilo.services/guia/solucao-de-problemas/configuracao.md): O que precisa ser configurado antes do primeiro envio, o que difere entre ambientes e erros de campanha e mensagem.

## API Docs

- Endpoints > Practitioner [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/practitioner/search-by-params.md)
- Endpoints > Practitioner [Cadastrar ou atualizar](https://api-docs.nilo.services/referencia/endpoints/practitioner/create.md)
- Endpoints > Practitioner [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/practitioner/search-by-id.md)
- Endpoints > Patient [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/patient/search-by-params.md)
- Endpoints > Patient [Cadastrar ou atualizar](https://api-docs.nilo.services/referencia/endpoints/patient/create.md)
- Endpoints > Patient [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/patient/search-by-id.md)
- Endpoints > Coverage [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/coverage/search-by-params.md)
- Endpoints > Coverage [Cadastrar ou atualizar](https://api-docs.nilo.services/referencia/endpoints/coverage/create.md)
- Endpoints > Coverage [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/coverage/search-by-id.md)
- Endpoints > Insurance Plan [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/insurance-plan/insurance-plan-search-by-params.md)
- Endpoints > Insurance Plan [Renomear um plano](https://api-docs.nilo.services/referencia/endpoints/insurance-plan/insurance-plan-update.md)
- Endpoints > Insurance Plan [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/insurance-plan/insurance-plan-search-by-id.md)
- Endpoints > Care Team [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/care-team/care-team-search-by-params.md)
- Endpoints > Care Team [Cadastrar ou atualizar](https://api-docs.nilo.services/referencia/endpoints/care-team/care-team-create-or-update.md)
- Endpoints > Care Team [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/care-team/care-team-search-by-id.md)
- Endpoints > Group [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/group/search-by-params.md)
- Endpoints > Group [Cadastrar, renomear ou apagar](https://api-docs.nilo.services/referencia/endpoints/group/create.md)
- Endpoints > Group [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/group/search-by-id.md)
- Endpoints > Plan Definition [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/plan-definition/plan-definition-search-by-params.md)
- Endpoints > Plan Definition [Cadastrar ou atualizar](https://api-docs.nilo.services/referencia/endpoints/plan-definition/plan-definition-create.md)
- Endpoints > Plan Definition [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/plan-definition/plan-definition-search-by-id.md)
- Endpoints > Care Plan [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/care-plan/care-plan-search-by-params.md)
- Endpoints > Care Plan [Cadastrar ou atualizar](https://api-docs.nilo.services/referencia/endpoints/care-plan/care-plan-create-or-update.md)
- Endpoints > Care Plan [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/care-plan/care-plan-search-by-id.md)
- Endpoints > Encounter [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/encounter/search-by-params.md)
- Endpoints > Encounter [Cadastrar ou atualizar](https://api-docs.nilo.services/referencia/endpoints/encounter/create.md)
- Endpoints > Encounter [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/encounter/search-by-id.md)
- Endpoints > Procedure [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/procedure/search-by-params.md)
- Endpoints > Procedure [Cadastrar ou atualizar](https://api-docs.nilo.services/referencia/endpoints/procedure/create.md)
- Endpoints > Procedure [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/procedure/search-by-id.md)
- Endpoints > Organization [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/organization/search-by-params.md)
- Endpoints > Organization [Cadastrar ou atualizar](https://api-docs.nilo.services/referencia/endpoints/organization/create.md)
- Endpoints > Organization [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/organization/search-by-id.md)
- Endpoints > Location [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/location/search-by-params.md)
- Endpoints > Location [Cadastrar ou atualizar](https://api-docs.nilo.services/referencia/endpoints/location/create.md)
- Endpoints > Location [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/location/search-by-id.md)
- Endpoints > Flag [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/flag/search-by-params.md)
- Endpoints > Flag [Cadastrar ou atualizar](https://api-docs.nilo.services/referencia/endpoints/flag/create.md)
- Endpoints > Flag [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/flag/search-by-id.md)
- Endpoints > Code System [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/code-system/code-system-search-by-params.md)
- Endpoints > Code System [Buscar por nome](https://api-docs.nilo.services/referencia/endpoints/code-system/code-system-search-by-id.md)
- Endpoints > Condition [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/condition/search-by-params.md)
- Endpoints > Condition [Cadastrar ou atualizar](https://api-docs.nilo.services/referencia/endpoints/condition/create-or-update.md)
- Endpoints > Condition [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/condition/search-by-id.md)
- Endpoints > Observation [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/observation/search-by-params.md)
- Endpoints > Observation [Cadastrar ou atualizar](https://api-docs.nilo.services/referencia/endpoints/observation/create-or-update.md)
- Endpoints > Observation [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/observation/search-by-id.md)
- Endpoints > Clinical Impression [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/clinical-impression/clinical-impression-search-by-params.md)
- Endpoints > Clinical Impression [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/clinical-impression/clinical-impression-search-by-id.md)
- Endpoints > Request Group [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/request-group/request-group-search-by-params.md)
- Endpoints > Request Group [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/request-group/request-group-search-by-id.md)
- Endpoints > Service Request [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/service-request/service-request-search-by-params.md)
- Endpoints > Service Request [Registrar uma conduta](https://api-docs.nilo.services/referencia/endpoints/service-request/service-request-create.md)
- Endpoints > Service Request [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/service-request/service-request-search-by-id.md)
- Endpoints > Medication [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/medication/search-by-params.md)
- Endpoints > Medication [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/medication/search-by-id.md)
- Endpoints > Questionnaire [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/questionnaire/search-by-params.md)
- Endpoints > Questionnaire [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/questionnaire/search-by-id.md)
- Endpoints > Questionnaire Response [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/questionnaire-response/questionnaire-response-search-by-params.md)
- Endpoints > Questionnaire Response [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/questionnaire-response/questionnaire-response-search-by-id.md)
- Endpoints > Task [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/task/search-by-params.md)
- Endpoints > Task [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/task/search-by-id.md)
- Endpoints > Schedule [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/schedule/search-by-params.md)
- Endpoints > Schedule [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/schedule/search-by-id.md)
- Endpoints > Appointment [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/appointment/search-by-params.md)
- Endpoints > Appointment [Cadastrar ou atualizar](https://api-docs.nilo.services/referencia/endpoints/appointment/create.md)
- Endpoints > Appointment [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/appointment/search-by-id.md)
- Endpoints > Communication Request [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/communication-request/communication-request-search-by-params.md)
- Endpoints > Communication Request [Matricular numa campanha](https://api-docs.nilo.services/referencia/endpoints/communication-request/communication-request-create.md)
- Endpoints > Communication Request [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/communication-request/communication-request-search-by-id.md)
- Endpoints > Communication [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/communication/search-by-params.md)
- Endpoints > Communication [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/communication/search-by-id.md)
- Endpoints > Media [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/media/search-by-params.md)
- Endpoints > Media [Enviar um arquivo](https://api-docs.nilo.services/referencia/endpoints/media/create.md)
- Endpoints > Media [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/media/search-by-id.md)
- Endpoints > Medication Statement [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/medication-statement/medication-statement-search-by-params.md)
- Endpoints > Medication Statement [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/medication-statement/medication-statement-search-by-id.md)
- Endpoints > Medication Request [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/medication-request/medication-request-search-by-params.md)
- Endpoints > Medication Request [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/medication-request/medication-request-search-by-id.md)
- Endpoints > Bundle [Enviar uma carga em lote](https://api-docs.nilo.services/referencia/endpoints/bundle/create.md)
- Endpoints > Subscription [Buscar por parâmetros](https://api-docs.nilo.services/referencia/endpoints/subscription/search-by-params.md)
- Endpoints > Subscription [Criar ou desligar uma assinatura](https://api-docs.nilo.services/referencia/endpoints/subscription/create.md)
- Endpoints > Subscription [Buscar por ID](https://api-docs.nilo.services/referencia/endpoints/subscription/search-by-id.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://api-docs.nilo.services/openapi.json)
- [OpenAPI YAML](https://api-docs.nilo.services/openapi.yaml)