Reativar beneficiário (movimento R)
/v1/beneficiarios/{id}/reativacao**Reativação** de um beneficiário previamente excluído. Equivale ao movimento `R`. Modelado como uma *ação* sobre o recurso, pois não há verbo HTTP semântico para "reativar".
Path Parameters
idstringrequired
Identificador do beneficiário. Aceita o `guidProdutoBeneficiario`, o CPF ou a matrícula, conforme suportado pela operadora.
Headers
X-Cnpj-Provedorstringrequired
CNPJ da operadora de destino — atua como **chave de roteamento** (padrão Mediator). Ex.: SulAmérica `01685053000156`.
Request Body
application/jsonrequired
Dados para reativação de um beneficiário excluído.
Dados do plano/produto contratado.
Ver schema bruto / exemplo JSON
{
"cpf": "35999999960",
"dataReativacao": "2026-06-10",
"produto": {
"contrato": "1234",
"codigo": "PLAN-001"
}
}Responses
Reativação processada.
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.
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.
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.
Recurso não encontrado.
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.
A operadora rejeitou a movimentação por uma regra de negócio (ex. "CPF inválido", "Beneficiário inativo", "Fora da vigência"). Os detalhes vêm em `criticas` / `validacoes`.
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.
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.
Reativar beneficiário (movimento R)
/v1/beneficiarios/{id}/reativacao**Reativação** de um beneficiário previamente excluído. Equivale ao movimento `R`. Modelado como uma *ação* sobre o recurso, pois não há verbo HTTP semântico para "reativar".
Path Parameters
idstringrequired
Identificador do beneficiário. Aceita o `guidProdutoBeneficiario`, o CPF ou a matrícula, conforme suportado pela operadora.
Headers
X-Cnpj-Provedorstringrequired
CNPJ da operadora de destino — atua como **chave de roteamento** (padrão Mediator). Ex.: SulAmérica `01685053000156`.
Request Body
application/jsonrequired
Dados para reativação de um beneficiário excluído.
Dados do plano/produto contratado.
Ver schema bruto / exemplo JSON
{
"cpf": "35999999960",
"dataReativacao": "2026-06-10",
"produto": {
"contrato": "1234",
"codigo": "PLAN-001"
}
}Responses
Reativação processada.
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.
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.
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.
Recurso não encontrado.
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.
A operadora rejeitou a movimentação por uma regra de negócio (ex. "CPF inválido", "Beneficiário inativo", "Fora da vigência"). Os detalhes vêm em `criticas` / `validacoes`.
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.
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.