XML ANBIMA (tipos 5 e 401)

Visão Geral

A QI CTVM gera os arquivos de posição de carteira no padrão ANBIMA a partir da composição de carteira do fundo. São dois modelos, entregues como arquivos independentes:

Modelo	Padrão	Descrição
xml_5_by_composition	Arquivo de Posição ANBIMA 5.0 (ISO 20022, semt.003.001.04)	Posição da carteira em estrutura ISO 20022, com identificação de administrador, gestor e custodiante, posição por ativo, valores a pagar e a receber.
xml_401_by_composition	Arquivo de Posição ANBIMA 4.01	Posição da carteira no layout 4.01, com cabeçalho do fundo e blocos por classe de ativo.

Qual é o "XML da ANBIMA"

Quando se fala do XML da ANBIMA no dia a dia, o arquivo em questão é o xml_5_by_composition — a versão 5.0 do arquivo de posição. O xml_401_by_composition é a versão anterior do mesmo padrão, ainda exigida por alguns consumidores.

O que você precisa informar

Variável	Obrigatória	Descrição
fund_class_key	sim	Identificador da classe de fundo sobre a qual o arquivo é gerado.
reference_date	sim	Data de referência da posição, no formato AAAA-MM-DD.
type_fund_code_anbima	não	Código do tipo de fundo na tabela da ANBIMA. Quando omitido, é derivado do cadastro do fundo. Um código fora da lista de válidos faz a geração falhar.
issuance_serie_key	não (só XML 401)	Restringe o arquivo a uma única série de emissão. Sem ele, todas as séries da classe entram no arquivo.

Estrutura do Arquivo

Atributo	Valor
Formato	XML
Encoding	UTF-8
Nomenclatura	{nome_resumido_fundo}_xml_5_by_composition_{AAAA-MM-DD}.xml e {nome_resumido_fundo}_xml_401_by_composition_{AAAA-MM-DD}.xml

Ambos os arquivos são gerados a partir de uma composição de carteira já fechada na data de referência — confirmada ou aguardando confirmação. Antes de montar o arquivo, o serviço reconcilia a posição: a soma dos ativos, mais os valores a receber, menos os valores a pagar, tem que fechar com o patrimônio líquido informado pelas séries de emissão. Quando não fecha, o arquivo não é gerado.

Como receber

Há duas formas, que podem ser usadas em conjunto:

1. Na rotina diária do SFTP, junto com os demais relatórios. Basta solicitar ao time de integração a inclusão dos modelos xml_5_by_composition e/ou xml_401_by_composition na configuração da entrega.
2. Sob demanda, pela API, com a rota de download de relatório da composição:

ENDPOINT

/composition/fund_class/{fund_class_key}/report

MÉTODO

POST

Request Body

{
    "composition_type": "final_quota",
    "report_type": "xml_5_by_composition",
    "reference_date": "2026-07-29"
}

A resposta devolve o arquivo em base64, no campo document_b64. A carteira precisa estar no status confirmed para o download ser possível. Detalhes em Carteira - Baixar a Carteira.

Conteúdo do arquivo tipo 5

O arquivo tem o elemento raiz PosicaoAtivosCarteira e é dividido em duas partes:

• AppHdr — cabeçalho da mensagem: administrador remetente (nome e CNPJ), fundo destinatário, identificador da mensagem, versão do layout (semt.003.001.04), serviço (Arquivo de Posicao 5.0) e data/hora de geração.
• Document / SctiesBalAcctgRpt — corpo da posição:

Elemento	Conteúdo
Pgntn	Paginação do arquivo.
StmtGnlDtls	Dados gerais do extrato: data da composição, frequência e tipo de atualização.
AcctOwnr	CNPJ do administrador (titular da conta).
AcctSvcr	CNPJ da gestora.
SfkpgAcct	CNPJ e nome do custodiante.
BalForAcct	Classe de fundo e séries de emissão, com ISIN, quantidade de cotas, valor da cota, valor total dos ativos, e o detalhamento de valores a pagar (PAYA) e a receber (RECE).
SubAcctDtls	Uma entrada por ativo da carteira: títulos públicos, títulos privados, debêntures, cotas de fundo, direitos creditórios, swaps, imóveis e contas caixa.
AcctBaseCcyTtlAmts	Patrimônio líquido total do fundo.

Os valores a pagar são classificados com os códigos ISO correspondentes à natureza da despesa — ADMF (taxa de administração), MANF (gestão), PERF (performance), CETI (CETIP), REGF (CVM), ANBI (ANBIMA), AUDT (auditoria), SELC (SELIC), CUST (custódia), LEGA (serviços) — ou OTHR para os demais.

Conteúdo do arquivo tipo 401

O arquivo tem o elemento raiz arquivoposicao_4_01, com um elemento fundo que reúne:

Bloco	Conteúdo
header	ISIN, CNPJ e nome do fundo, data da posição, administrador, gestor e custodiante, valor e quantidade de cotas, patrimônio líquido, valor dos ativos, valores a receber e a pagar, tipo de fundo ANBIMA.
titpublico	Um bloco por título público, com código SELIC, datas, quantidades, PUs, indexador e valor financeiro.
titprivado	Um bloco por título privado que não seja debênture.
debenture	Um bloco por debênture.
swap	Um bloco por contrato de swap, com valores de ativo e passivo.
cotas	Um bloco por cota de fundo investida, com ISIN, CNPJ do fundo, quantidade e PU.
caixa	Saldo das contas caixa.
despesas	Taxas de administração e performance do fundo.
outrasdespesas	Demais despesas provisionadas.
provisao	Provisões constituídas, com data e valor.
fidc	Valor financeiro total dos direitos creditórios da carteira.

Blocos sem posição na data não são incluídos no arquivo.