Usada para instruir a modificação de uma pessoa física residente previamente cadastrada.
A mensagem permite alterar informações cadastrais específicas do comitente.
Dentro de Modifications, há ações específicas:
SetXyz: se não-nulo, altera o valor do campo.UnsetXyz: apenas para dados opcionais. Se true, remove o valor.AddManyXyz: adiciona elementos à coleção. null é interpretado como vazio (não faz nada).RemoveManyXyz: remove elementos da coleção. null é interpretado como vazio (não faz nada).Exemplo de um fluxo de sucesso:
| Índice | Campo | Tipo | Obrigatório | Descrição | Regras |
|---|---|---|---|---|---|
| 1 | ParticipantRequestInfo | object | SIM | Informações sobre a solicitação | |
| 1.1 | RequestId | string | SIM | Identificador único da solicitação atribuído pelo Participante | |
| 1.2 | RequesterParticipantCode | string | SIM | Código do Participante solicitante | |
| 1.3 | OriginalMessageTypeCode | string | NÃO | Tipo da mensagem original no padrão base-m-cad-???-##-### |
|
| 2 | InvestorIdentification | object | SIM | Identificação do comitente a ser modificado | |
| 2.1 | OwnerCode | string | SIM | Código do Participante dono da conta | |
| 2.2 | InvestorDocumentCode | string | SIM | Documento do investidor | |
| 3 | Modifications | object | SIM | Modificações a serem aplicadas ao comitente | |
| 3.1 | SetFullName | string | NÃO | Alterar nome completo | |
| 3.2 | SetAddress | object | NÃO | Alterar endereço | |
| 3.2.1 | PostalCode | string | SIM | CEP | |
| 3.2.2 | Street | string | SIM | Logradouro (rua, avenida) | |
| 3.2.3 | Number | string | NÃO | Número | |
| 3.2.4 | Extra | string | NÃO | Complemento (apartamento, bloco, unidade...) | |
| 3.2.5 | City | string | SIM | Cidade | |
| 3.2.6 | State | string | SIM | UF - Sigla do estado (SP, RJ, DF, etc) | |
| 3.3 | SetPhone | string | NÃO | Alterar telefone | |
| 3.4 | SetEmailAddress | string | NÃO | Alterar endereço de email | |
| 3.5 | SetAnnualIncome | decimal | NÃO | Alterar renda anual | |
| 3.6 | SetAnnualIncomeReferenceDate | string | NÃO | Alterar data de referência da renda anual | |
| 3.7 | SetNetWorth | decimal | NÃO | Alterar patrimônio | |
| 3.8 | SetNetWorthReferenceDate | string | NÃO | Alterar data de referência do patrimônio | |
| 3.9 | SetIsPoliticallyExposed | bool | NÃO | Alterar indicador de pessoa politicamente exposta | |
| 3.10 | SetOccupation | integer | NÃO | Alterar ocupação | |
| 3.11 | SetPreferredName | string | NÃO | Alterar nome social | |
| 3.12 | SetRegistrationRestriction | integer | NÃO | Alterar restrição cadastral Valores possíveis: RegistrationRestriction |
|
| 3.13 | UnsetRegistrationRestriction | bool | NÃO | Remover restrição cadastral |
{
"ParticipantRequestInfo": {
"RequestId": "E22FCABBA8FB41A096F9AF4088FD9B4C",
"RequesterParticipantCode": "33"
},
"InvestorIdentification": {
"OwnerCode": "33",
"InvestorDocumentCode": "12345678909"
},
"Modifications": {
"SetAddress": {
"PostalCode": "30110000",
"Street": "Rua Atualizada",
"Number": "500",
"Extra": "Sala 301",
"City": "Belo Horizonte",
"State": "MG"
},
"SetPhone": "31999998888",
"SetEmailAddress": "novo.email@example.com",
"SetPreferredName": "Maria Oliveira"
}
}