Enviar Endereço do Investidor

---

Introdução

Este recurso tem como objetivo enviar o endereço que compõe a análise cadastral de um investidor.

Investidor fund_class

Para fundos de investimento, o endereço é herdado automaticamente do administrador vinculado ao fundo durante o envio para análise. O envio desta etapa é opcional nesse cenário.

Input / Output

Como input envie os dados de endereço.

Como output será retornada a representação atualizada da análise cadastral.

Request

ENDPOINT

/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/address

MÉTODO

PUT

STATUS

202

Exemplo

Request Body

{
    "street": "Avenida Paulista",
    "number": "1000",
    "neighborhood": "Bela Vista",
    "city": "São Paulo",
    "postal_code": "01310-100",
    "uf": "SP",
    "country": "BRA",
    "complement": "Sala 1010"
}

Body params

Campo	Tipo	Descrição	Caracteres	Obrigatório
street	string	Logradouro	1 - 255	Sim
number	string	Número (somente dígitos)	1 - 10	Sim
neighborhood	string	Bairro	1 - 255	Sim
city	string	Cidade	1 - 255	Sim
postal_code	string	Código postal. No Brasil, CEP no formato XXXXX-XXX. No exterior, o formato local do país	1 - 20	Sim
uf	string	Unidade Federativa — ex.: SP, CE, MG. No exterior, use EX	1 - 20	Sim
country	string	Código ISO do país, 3 letras — ex.: BRA, PRT	3	Sim
complement	string	Complemento	1 - 255	Não

Endereço no exterior

postal_code e uf não possuem validação de formato — aceitam o padrão de qualquer país (até 20 caracteres cada). Um CEP português 1000-001 ou um ZIP norte-americano 10001 são aceitos como estão.

A única coerência exigida é entre a residência da análise e o country:

resident da análise	country exigido	Erro se divergir
true (default)	obrigatoriamente BRA	IVR000227
false	qualquer um, exceto BRA	IVR000226

Residência é definida na criação do investidor

resident não é um campo desta etapa e não pode ser alterado depois. Se você receber IVR000227 ao enviar um endereço no exterior, a análise nasceu residente — é preciso criar o investidor com resident: false e non_resident_type, conforme a seção Investidor não residente da página Criar Investidor.

Response

A análise cadastral atualizada é retornada no corpo da resposta. Para o formato completo, consulte Busca informações de uma análise cadastral do investidor.

---