Consultar status de movimentações
/v1/movimentacoes*Tracking* passivo do status das movimentações cadastrais enviadas previamente. > **USE A CONSULTA POR PROTOCOLO.** Verificado em 16/07/2026 (inclusive > direto no Orquestrador, sem a fachada): o backend só aplica o filtro > por **código da movimentação** (protocolo). O filtro `cpf` é > **ignorado** e a consulta sem filtro retorna um registro default > antigo. Fluxo correto: guarde o `protocolo` retornado na > inclusão/exclusão e consulte `GET /v1/movimentacoes/{protocolo}`. > Os demais filtros abaixo constam do contrato mas **não são aplicados > pelo upstream** hoje.
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.
Headers
X-Cnpj-Provedorstringrequired
CNPJ da operadora de destino, atua como **chave de roteamento** (padrão Mediator). Ex.: SulAmérica `01685053000156`.
ex: 01685053000156Responses
Resposta traduzida do Orquestrador no shape `MovimentacaoResultado` (**não há paginação**). Como o upstream não aplica os filtros desta rota, o conteúdo pode não corresponder ao CPF consultado; use a consulta por protocolo.
Retorno padronizado de uma operação de escrita (`ResponseBaseSuccess`). Consolida o resultado, validações de negócio e dados de auditoria.
Código HTTP resultante do processamento na operadora.
Protocolo de rastreio gerado pela operadora.
Resumo do beneficiário afetado. Campos conforme respostas reais capturadas em 16/07/2026; cada operação popula um subconjunto.
Igual ao `protocolo`.
INCLUSAO, EXCLUSAO, ...
Emitida quando a movimentação é liberada pela operadora.
Matrícula na operadora. GUARDE (exigida na exclusão como `matriculaEmpresa`).
Validações/avisos retornados pela operadora.
items
Erros críticos de regra de negócio.
items
Crítica/erro de validação devolvido pela operadora.
URI exata da operadora chamada (auditoria).
Payload exato enviado à operadora (auditoria/troubleshooting).
Retorno cru (raw) devolvido pela API da operadora.
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 das movimentações cadastrais enviadas previamente. > **USE A CONSULTA POR PROTOCOLO.** Verificado em 16/07/2026 (inclusive > direto no Orquestrador, sem a fachada): o backend só aplica o filtro > por **código da movimentação** (protocolo). O filtro `cpf` é > **ignorado** e a consulta sem filtro retorna um registro default > antigo. Fluxo correto: guarde o `protocolo` retornado na > inclusão/exclusão e consulte `GET /v1/movimentacoes/{protocolo}`. > Os demais filtros abaixo constam do contrato mas **não são aplicados > pelo upstream** hoje.
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.
Headers
X-Cnpj-Provedorstringrequired
CNPJ da operadora de destino, atua como **chave de roteamento** (padrão Mediator). Ex.: SulAmérica `01685053000156`.
ex: 01685053000156Responses
Resposta traduzida do Orquestrador no shape `MovimentacaoResultado` (**não há paginação**). Como o upstream não aplica os filtros desta rota, o conteúdo pode não corresponder ao CPF consultado; use a consulta por protocolo.
Retorno padronizado de uma operação de escrita (`ResponseBaseSuccess`). Consolida o resultado, validações de negócio e dados de auditoria.
Código HTTP resultante do processamento na operadora.
Protocolo de rastreio gerado pela operadora.
Resumo do beneficiário afetado. Campos conforme respostas reais capturadas em 16/07/2026; cada operação popula um subconjunto.
Igual ao `protocolo`.
INCLUSAO, EXCLUSAO, ...
Emitida quando a movimentação é liberada pela operadora.
Matrícula na operadora. GUARDE (exigida na exclusão como `matriculaEmpresa`).
Validações/avisos retornados pela operadora.
items
Erros críticos de regra de negócio.
items
Crítica/erro de validação devolvido pela operadora.
URI exata da operadora chamada (auditoria).
Payload exato enviado à operadora (auditoria/troubleshooting).
Retorno cru (raw) devolvido pela API da operadora.
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.