Consultar status de movimentações
/v1/movimentacoes*Tracking* passivo do status e histórico das movimentações cadastrais (inclusões, alterações, exclusões) enviadas previamente. O Orquestrador consulta a operadora e traduz o retorno para um formato unificado. Recomenda-se executar movimentações e buscas de forma **intercalada**, respeitando o tempo de processamento da operadora.
Query Parameters
apolicestring
Número da apólice/contrato.
empresastring
CNPJ/identificador da empresa estipulante.
cpfstring
CPF do titular.
cpfDependentestring
CPF de um dependente específico.
dataMovimentacaostring
Data (ou início do período) da movimentação (YYYY-MM-DD).
statusstring
Filtra por status da movimentação.
paginainteger
Página (paginação). Inicia em 1.
quantidadePorPaginainteger
Quantidade de itens por página.
Headers
X-Cnpj-Provedorstringrequired
CNPJ da operadora de destino — atua como **chave de roteamento** (padrão Mediator). Ex.: SulAmérica `01685053000156`.
Responses
Lista paginada de movimentações com status.
items
Status/histórico de uma movimentação cadastral.
Protocolo/ID de rastreio gerado pela operadora.
Inclusão, Alteração, Exclusão, Troca de Plano, Reativação.
Status traduzido (ex. "Processado com Sucesso", "Rejeitado").
items
Crítica/erro de validação devolvido pela operadora.
Ver schema bruto / exemplo JSON
{
"data": [
{
"id": "mov-1",
"protocolo": "888999900001111",
"nome": "João da Silva",
"cpf": "12345678900",
"tipoMovimento": "Inclusão",
"dataMovimentacao": "2026-04-01T10:30:00Z",
"statusMovimentacao": "Processado com Sucesso",
"numeroCarteirinha": "888999900001111",
"criticas": []
},
{
"id": "mov-2",
"protocolo": null,
"nome": "Maria da Silva (Dependente)",
"cpf": "09876543211",
"tipoMovimento": "Inclusão",
"dataMovimentacao": "2026-04-01T10:30:00Z",
"statusMovimentacao": "Rejeitado",
"numeroCarteirinha": null,
"criticas": [
{
"codigo": "VAL-031",
"campo": "dataNascimento",
"mensagem": "Data de nascimento incompatível com o grau de parentesco informado."
}
]
}
],
"paginacao": {
"pagina": 1,
"quantidadePorPagina": 50,
"total": 2,
"totalPaginas": 1
}
}Requisição malformada (campos obrigatórios ausentes/ inválidos).
Estrutura padronizada de erro.
Código HTTP do erro.
Código interno do erro.
Descrição legível do erro.
items
Crítica/erro de validação devolvido pela operadora.
Token ausente, expirado ou inválido.
Estrutura padronizada de erro.
Código HTTP do erro.
Código interno do erro.
Descrição legível do erro.
items
Crítica/erro de validação devolvido pela operadora.
Consultar status de movimentações
/v1/movimentacoes*Tracking* passivo do status e histórico das movimentações cadastrais (inclusões, alterações, exclusões) enviadas previamente. O Orquestrador consulta a operadora e traduz o retorno para um formato unificado. Recomenda-se executar movimentações e buscas de forma **intercalada**, respeitando o tempo de processamento da operadora.
Query Parameters
apolicestring
Número da apólice/contrato.
empresastring
CNPJ/identificador da empresa estipulante.
cpfstring
CPF do titular.
cpfDependentestring
CPF de um dependente específico.
dataMovimentacaostring
Data (ou início do período) da movimentação (YYYY-MM-DD).
statusstring
Filtra por status da movimentação.
paginainteger
Página (paginação). Inicia em 1.
quantidadePorPaginainteger
Quantidade de itens por página.
Headers
X-Cnpj-Provedorstringrequired
CNPJ da operadora de destino — atua como **chave de roteamento** (padrão Mediator). Ex.: SulAmérica `01685053000156`.
Responses
Lista paginada de movimentações com status.
items
Status/histórico de uma movimentação cadastral.
Protocolo/ID de rastreio gerado pela operadora.
Inclusão, Alteração, Exclusão, Troca de Plano, Reativação.
Status traduzido (ex. "Processado com Sucesso", "Rejeitado").
items
Crítica/erro de validação devolvido pela operadora.
Ver schema bruto / exemplo JSON
{
"data": [
{
"id": "mov-1",
"protocolo": "888999900001111",
"nome": "João da Silva",
"cpf": "12345678900",
"tipoMovimento": "Inclusão",
"dataMovimentacao": "2026-04-01T10:30:00Z",
"statusMovimentacao": "Processado com Sucesso",
"numeroCarteirinha": "888999900001111",
"criticas": []
},
{
"id": "mov-2",
"protocolo": null,
"nome": "Maria da Silva (Dependente)",
"cpf": "09876543211",
"tipoMovimento": "Inclusão",
"dataMovimentacao": "2026-04-01T10:30:00Z",
"statusMovimentacao": "Rejeitado",
"numeroCarteirinha": null,
"criticas": [
{
"codigo": "VAL-031",
"campo": "dataNascimento",
"mensagem": "Data de nascimento incompatível com o grau de parentesco informado."
}
]
}
],
"paginacao": {
"pagina": 1,
"quantidadePorPagina": 50,
"total": 2,
"totalPaginas": 1
}
}Requisição malformada (campos obrigatórios ausentes/ inválidos).
Estrutura padronizada de erro.
Código HTTP do erro.
Código interno do erro.
Descrição legível do erro.
items
Crítica/erro de validação devolvido pela operadora.
Token ausente, expirado ou inválido.
Estrutura padronizada de erro.
Código HTTP do erro.
Código interno do erro.
Descrição legível do erro.
items
Crítica/erro de validação devolvido pela operadora.