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.
- 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
/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/related_party/{external_related_party_key}/statusPUT202Request 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 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.