Na consulta de internações da API de Exportação dos Dados Assistenciais, os filtros por data permitem buscar as internações de um determinado período, como as altas de um mês ou as internações cadastradas em uma semana. Esses filtros seguem regras próprias de formato, combinação e tamanho máximo do período.
Se essas regras não forem respeitadas, a exportação não é executada. Por isso, vale conferir os pontos abaixo antes de configurar as consultas no sistema da sua instituição.
Opções de filtro por data
A consulta aceita uma data única ou quatro tipos de período:
| Opção | Parâmetros | O que considera |
|---|---|---|
| Data da última alteração | dataUltimaAlteracao |
Data da última alteração feita na internação. |
| Período de alta |
dataAltaInicial e dataAltaFinal
|
Data da alta do paciente. |
| Período de internação |
dataInternacaoInicial e dataInternacaoFinal
|
Data de internação do paciente. |
| Período de cadastro |
dataCadastroInicial e dataCadastroFinal
|
Data em que a internação foi cadastrada na Plataforma. |
| Período de cadastro da alta |
dataCadastroAltaInicial e dataCadastroAltaFinal
|
Data em que a alta foi cadastrada na Plataforma. |
Regras para usar os filtros por data
-
Formato: informe todas as datas no formato
aaaa-mm-dd, por exemplo2026-01-31. - Data inicial e final: ao informar a data inicial de um período, a data final do mesmo período é obrigatória, e vice-versa.
- Uma opção por consulta: escolha apenas uma das opções da tabela. Não é possível, por exemplo, enviar um período de alta e um período de internação na mesma consulta.
- Até 31 dias: cada período pode abranger no máximo 31 dias. Para períodos maiores, divida a busca em mais de uma consulta.
-
Exceção: o limite de 31 dias não se aplica ao período de internação quando a consulta usa o filtro
situacaoigual a "1" (Admissional).
Atenção: se a consulta tiver mais de uma opção de data, um período sem data inicial ou final, ou um período acima de 31 dias fora da exceção, a exportação não será executada.
Exemplo: consulta das internações com alta em janeiro de 2026, usando um único período, com data inicial e final:
{
"dataAltaInicial": "2026-01-01",
"dataAltaFinal": "2026-01-31"
}Observação: os filtros complementares, como CID, procedimento e situação, podem ser enviados junto com o filtro por data para refinar o resultado. Veja os filtros disponíveis no artigo sobre os filtros da consulta de internações.
Artigos Populares
- Filtros da consulta de internações na API de Exportação dos Dados Assistenciais
- API de Exportação dos Dados Assistenciais: o que é e para que serve
- Como autenticar na API de Exportação dos Dados Assistenciais
Perguntas Frequentes
Não. Divida a busca em consultas de até 31 dias cada. A única exceção é o período de internação em consultas com situação igual a "1" (Admissional).
Não. Cada consulta aceita apenas uma opção de data. Se precisar dos dois recortes, faça consultas separadas.
No formato aaaa-mm-dd, com ano, mês e dia separados por hífen, como 2026-01-31.
Não. Sempre que informar a data inicial de um período, informe também a data final do mesmo período.
Este documento e seus anexos são restritos ao(s) destinatário(s) e poderão ser divulgados apenas para pessoas que necessitem dessas informações para a realização de suas atividades.
Se você o recebeu por engano, entre em contato com o remetente imediatamente e apague-o de seus arquivos.
Qualquer uso não autorizado, replicação ou disseminação deste documento, ou parte dele, é proibido. Antes de imprimir, pense no meio ambiente.
Comentários
0 comentário
Por favor, entre para comentar.