Atualizar Status da Parte Relacionada

---

Introdução

Este recurso ativa ou desativa uma parte relacionada dentro de uma análise cadastral.

Para uma parte enviada por engano, ou que deixou de compor o quadro societário, é desativada por aqui. Partes com status inactive são ignoradas em todas as validações do envio para análise — não contam para a exigência de quantidade mínima, não contam para o requisito de representante legal, não somam participação societária e não têm documentos cobrados.

Casos de uso

• Sócio enviado por engano → desative com inactive
• Quadro societário mudou → desative quem saiu e crie quem entrou
• Participação somada acima de 100% (IVR000169) → desative a parte duplicada, ou corrija o percentual com Atualizar Parte Relacionada

Input / Output:

Como input deve ser enviado o novo status.

Como output será retornada a confirmação da alteração.

Request

ENDPOINT

/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/related_party/{external_related_party_key}/status

MÉTODO

PUT

STATUS

202

Request body

Request Body

{
    "status": "inactive"
}

Body params

Campo	Tipo	Descrição	Obrigatório
status	string	Enumerador de Related Party Status	Sim

Related Party Status

Enumerador	Descrição
active	Parte considerada em todas as validações do envio para análise
inactive	Parte desconsiderada em todas as validações. É o equivalente a remover a parte do cadastro

A análise não pode estar em estado terminal

A alteração é recusada com IVR000185 quando a análise cadastral já está em um dos status finais: automatically_approved, automatically_reproved, manually_approved, manually_reproved, analysis_complete ou expired.

Uma external_related_party_key desconhecida na análise informada é recusada com IVR000183.