Usada para compartilhar informações atualizadas de uma conta.
A mensagem pode ser utilizada nos seguintes contextos:
Apenas criações / modificações individuais de conta geram envio intradiário deste snapshot. Exemplos:
Criações em lote (ex: tombamento cadastral) NÃO geram envio intradiário do snapshot.
R1: Virá preenchido quando a conta for Por Conta e Ordem (IsTradingOnBehalf = true).
R2: Quando a conta for de titularidade do próprio Participante (IsHeldByParticipant = true), as informações que constarão serão relativas ao CNPJ do próprio Participante.
R3: Quando a conta for de titularidade do próprio Participante (IsHeldByParticipant = true), as informações que constarão serão do próprio Participante.
R4: Código do país no padrão ISO 3166-1 alpha-2. Ex: "BR", "US", "UK".
ROB1: Virá preenchido quando a conta operar por PN aberto (IsOpenTradingOnBehalf = true).
R6, R7, R8, R9, R10: Somente um desses campos será preenchido. Se o tipo de comitente (InvestorType) for "Pessoa física residente", por exemplo, somente os dados de pessoa física residente (ResidentNaturalPerson) serão informados.
| Índice | Campo | Tipo | Obrigatório | Descrição | Regras |
|---|---|---|---|---|---|
| 1 | OwnerCode | string | SIM | Código do Participante dono da conta | |
| 2 | Code | string | SIM | Código da conta | |
| 3 | Type | integer | SIM | Tipo da conta Valores possíveis: PositionAccountType |
|
| 4 | Status | integer | SIM | Status da conta Valores possíveis: RegistrationStatusCode |
|
| 5 | IsHeldByParticipant | bool | SIM | Indicador de se é de titularidade do próprio Participante | |
| 6 | IsCollateralizedByParticipant | bool | SIM | Indicador de se é colateralizada pelo Participante | |
| 7 | IsTradingOnBehalf | bool | SIM | Indicador de se é por conta e ordem | |
| 8 | TradingOnBehalfInformation | object | NÃO | Informações específicas de contas 'por conta e ordem' | R1 |
| 8.1 | CounterpartyParticipantCode | string | SIM | Código do Participante contraparte na relação 'por conta e ordem' | |
| 8.2 | CounterpartyAccountCode | string | SIM | Código da Conta contraparte na relação 'por conta e ordem' | |
| 8.3 | IsOpenTradingOnBehalf | bool | SIM | Indica se a conta é de PN Aberto. | |
| 8.4 | OpenTradingOnBehalfParticipantCode | string | NÃO | Código do PN aberto | ROB1 |
| 9 | IsDeliveryRestriction | bool | SIM | Indicador de se a conta é conta de restrição de entrega | |
| 10 | AllowedMarkets | array | SIM | Mercados habilitados para a conta | |
| 10.1 | Market | integer | SIM | Mercado Valores possíveis: MarketCode |
|
| 11 | MainDocument | object | SIM | Informações do documento principal | R2 |
| 11.1 | Country | string | SIM | País do documento | R4 |
| 11.2 | Type | integer | SIM | Tipo do documento Valores possíveis: DocumentType |
|
| 11.3 | Code | string | SIM | Documento | |
| 12 | Investor | object | SIM | Informações do investidor associado à conta | R3 |
| 12.1 | InvestorType | integer | SIM | Tipo de investidor Valores possíveis: InvestorType |
|
| 12.2 | RegistrationRestriction | integer | NÃO | Restrição cadastral Valores possíveis: RegistrationRestriction |
|
| 12.3 | ResidentNaturalPerson | object | NÃO | Dados de pessoa física residente | R6 |
| 12.3.1 | FullName | string | SIM | Nome completo | |
| 12.3.2 | BirthDate | string | SIM | Data de nascimento | |
| 12.3.3 | Cpf | string | SIM | CPF | |
| 12.3.4 | Address | object | SIM | Endereço | |
| 12.3.4.1 | PostalCode | string | SIM | CEP | |
| 12.3.4.2 | Street | string | SIM | Logradouro (rua, avenida) | |
| 12.3.4.3 | Number | string | NÃO | Número | |
| 12.3.4.4 | Extra | string | NÃO | Complemento (apartamento, bloco, unidade...) | |
| 12.3.4.5 | City | string | SIM | Cidade | |
| 12.3.4.6 | State | string | SIM | UF - Sigla do estado (SP, RJ, DF, etc) | |
| 12.3.5 | Phone | string | SIM | Telefone | |
| 12.3.6 | EmailAddress | string | SIM | Endereço de e-mail | |
| 12.3.7 | AnnualIncome | decimal | SIM | Renda anual | |
| 12.3.8 | AnnualIncomeReferenceDate | string | SIM | Data de referência da renda anual | |
| 12.3.9 | NetWorth | decimal | SIM | Patrimônio líquido | |
| 12.3.10 | NetWorthReferenceDate | string | SIM | Data de referência do patrimônio líquido | |
| 12.3.11 | IsPoliticallyExposed | bool | SIM | Indicador de se o comitente é pessoa politicamente exposta | |
| 12.3.12 | Occupation | integer | SIM | Ocupação | |
| 12.3.13 | PreferredName | string | NÃO | Nome social | |
| 12.4 | NonResidentNaturalPerson | object | NÃO | Dados de pessoa física não-residente | R7 |
| 12.4.1 | FullName | string | SIM | Nome completo | |
| 12.4.2 | Cpf | string | SIM | CPF | |
| 12.4.3 | CountryOfResidence | string | SIM | País de residência | R11 |
| 12.4.4 | CountryOfRegistrationFiscalNumber | string | NÃO | Número fiscal no país de registro | |
| 12.4.5 | RegistrationRestriction | integer | NÃO | Restrição cadastral Valores possíveis: RegistrationRestriction |
|
| 12.5 | NationalInvestmentFund | object | NÃO | Dados de fundo de investimento nacional | R8 |
| 12.5.1 | FullName | string | SIM | Nome completo do fundo | |
| 12.5.2 | Cnpj | string | SIM | CNPJ | |
| 12.5.3 | IsExclusiveFund | bool | SIM | Indicador de se o fundo é exclusivo | |
| 12.5.4 | RegistrationRestriction | integer | NÃO | Restrição cadastral Valores possíveis: RegistrationRestriction |
|
| 12.6 | NationalLegalPerson | object | NÃO | Dados de pessoa jurídica nacional | R9 |
| 12.6.1 | FullName | string | SIM | Razão social | |
| 12.6.2 | Cnpj | string | SIM | CNPJ | |
| 12.6.3 | Address | object | SIM | Endereço | |
| 12.6.3.1 | PostalCode | string | SIM | CEP | |
| 12.6.3.2 | Street | string | SIM | Logradouro (rua, avenida) | |
| 12.6.3.3 | Number | string | NÃO | Número | |
| 12.6.3.4 | Extra | string | NÃO | Complemento (apartamento, bloco, unidade...) | |
| 12.6.3.5 | City | string | SIM | Cidade | |
| 12.6.3.6 | State | string | SIM | UF - Sigla do estado (SP, RJ, DF, etc) | |
| 12.6.4 | Phone | string | SIM | Telefone | |
| 12.6.5 | EmailAddress | string | SIM | Endereço de e-mail | |
| 12.6.6 | PrimaryEconomicActivity | integer | SIM | Atividade econômica principal | |
| 12.6.7 | IsNonProfit | bool | SIM | Indicador de se é sem fins lucrativos | |
| 12.6.8 | RegistrationRestriction | integer | NÃO | Restrição cadastral Valores possíveis: RegistrationRestriction |
|
| 12.7 | ForeignLegalPerson | object | NÃO | Dados de pessoa jurídica estrangeira | R10 |
| 12.7.1 | FullName | string | SIM | Nome ou razão social | |
| 12.7.2 | IsNonProfit | bool | SIM | Indicador de se é sem fins lucrativos | |
| 12.7.3 | IsTrustOrEquivalent | bool | SIM | Indicador de se é trust ou estrutura equivalente | |
| 12.7.4 | CountryOfRegistration | string | SIM | País de registro | R11 |
| 12.7.5 | CodeCvm | string | NÃO | Código CVM | R12 |
| 12.7.6 | Cnpj | string | NÃO | CNPJ | R12 |
| 12.7.7 | Code88 | string | NÃO | Código 88 | R12 |
| 12.7.8 | CountryOfRegistrationFiscalNumber | string | NÃO | Número fiscal no país de registro | |
| 12.7.9 | RepresentativeName | string | NÃO | Nome do representante legal no Brasil | |
| 12.7.10 | RepresentativeCnpj | string | NÃO | CNPJ do representante legal no Brasil | |
| 12.7.11 | RegistrationRestriction | integer | NÃO | Restrição cadastral Valores possíveis: RegistrationRestriction |
|
| 13 | Tracking | object | SIM | Informações de auditoria da conta | |
| 13.1 | UtcCreatedAt | string | SIM | Data e hora UTC de criação da entidade | |
| 13.2 | UtcLastUpdatedAt | string | SIM | Data e hora UTC da última atualização da entidade |
{
"OwnerCode": "713",
"Code": "1001",
"Type": 1,
"Status": 6,
"IsHeldByParticipant": false,
"IsCollateralizedByParticipant": false,
"IsTradingOnBehalf": false,
"IsDeliveryRestriction": false,
"AllowedMarkets": [
{
"Market": 101
},
{
"Market": 902
}
],
"MainDocument": {
"Country": "BR",
"Type": 2,
"Code": "12345678909"
},
"Investor": {
"InvestorType": 1,
"ResidentNaturalPerson": {
"FullName": "Jos\u00E9 da Silva Santos",
"BirthDate": "1985-06-17",
"Cpf": "12345678909",
"Address": {
"PostalCode": "12345678",
"Street": "Rua Exemplo",
"Number": "456",
"Extra": "Apto 101",
"City": "Belo Horizonte",
"State": "MG"
},
"Phone": "31998765432",
"EmailAddress": "jose.silva@example.com",
"AnnualIncome": 180000.00,
"AnnualIncomeReferenceDate": "2026-04-15",
"NetWorth": 950000.00,
"NetWorthReferenceDate": "2026-04-15",
"IsPoliticallyExposed": false,
"Occupation": 213
}
},
"Tracking": {
"UtcCreatedAt": "2026-02-18T13:00:22Z",
"UtcLastUpdatedAt": "2026-04-15T14:11:59Z"
}
}