--- title: "XML ANBIMA de fundos: erros comuns e como validar" description: "XML ANBIMA de fundos (Arquivo de Posição 5.0): estrutura, XSDs, tabelas nível, PL por classe e subclasse, erros mais comuns e validação em quatro camadas." url: "https://fundsys.com.br/blog/xml-anbima-arquivo-de-posicao-erros-validacao" site: "Fundsys, plataforma de controle, inteligência e automação para a operação de fundos" category: "Operação de fundos" tags: "XML ANBIMA, Arquivo de Posição 5.0, controladoria, CVM 175" authors: "Bruno Haas e Pablo Brenner" published: "2026-08-29" language: "pt-BR" reading_minutes: 13 --- **Operação de fundos (Guia técnico)** # Processamento de XML ANBIMA: erros comuns e como validar O XML ANBIMA é o idioma em que administradores e gestoras falam de carteira. Desde 1º de julho de 2025, esse idioma é o Arquivo de Posição 5.0, baseado na ISO 20022 e adaptado às classes e subclasses da Resolução CVM 175. Um arquivo mal gerado ou mal lido produz carteira errada, limite errado e risco errado sem que ninguém perceba. Este guia mostra a estrutura do arquivo, as fórmulas de PL que a ANBIMA adotou, os erros que mais aparecem e um pipeline de validação em quatro camadas. Por Bruno Haas e Pablo Brenner · 29 de agosto de 2026 · 13 min de leitura **Neste guia** 1. [O que é o Arquivo de Posição 5.0 e o que aconteceu com o 4.01](https://fundsys.com.br/blog/xml-anbima-arquivo-de-posicao-erros-validacao#o-que-e) 2. [Anatomia do arquivo](https://fundsys.com.br/blog/xml-anbima-arquivo-de-posicao-erros-validacao#anatomia) 3. [Classes e subclasses: o que muda no arquivo e nas contas](https://fundsys.com.br/blog/xml-anbima-arquivo-de-posicao-erros-validacao#classes-subclasses) 4. [Os erros mais comuns](https://fundsys.com.br/blog/xml-anbima-arquivo-de-posicao-erros-validacao#erros) 5. [Pipeline de validação em quatro camadas](https://fundsys.com.br/blog/xml-anbima-arquivo-de-posicao-erros-validacao#pipeline) 6. [Para que mais o arquivo serve](https://fundsys.com.br/blog/xml-anbima-arquivo-de-posicao-erros-validacao#usos) 7. [O acordo operacional com o administrador](https://fundsys.com.br/blog/xml-anbima-arquivo-de-posicao-erros-validacao#acordo) 8. [Checklist de processamento do XML ANBIMA](https://fundsys.com.br/blog/xml-anbima-arquivo-de-posicao-erros-validacao#checklist) 9. [Perguntas frequentes sobre o XML ANBIMA de fundos](https://fundsys.com.br/blog/xml-anbima-arquivo-de-posicao-erros-validacao#faq) ## O que é o Arquivo de Posição 5.0 e o que aconteceu com o 4.01 O Arquivo de Posição é o layout padronizado pela ANBIMA para a troca de informações sobre posições de fundos e carteiras administradas entre prestadores de serviço. Existem duas gerações. O **4.01**, com tags próprias e estrutura simples, foi o padrão dominante por anos. O **5.0**, baseado na mensagem ISO 20022 semt.003.001.04, existe há mais de dez anos, é usado pela Previc desde 2016 para receber informações de fundos estruturados e foi reformulado em 2024 para acomodar as classes e subclasses da [Resolução CVM 175](https://fundsys.com.br/blog/resolucao-cvm-175-guia-completo). Desde **1º de julho de 2025**, gestores e administradores devem usar exclusivamente o 5.0 para posições de fundos; o 4.01 foi descontinuado para fundos e seguiu válido, temporariamente, apenas para carteiras administradas. Dois pontos que confundem: a ANBIMA **não recebe** o arquivo, ela padroniza o layout e mantém o validador; o arquivo circula diretamente entre administrador, gestora, distribuidores, consultores e investidores institucionais. E o Arquivo de Posição não é o informe diário da CVM: este é enviado pelo administrador à CVM em padrão próprio, cuja versão 4.0 passou a referenciar classes e subclasses para os fundos adaptados à 175. __Ficha técnica__ | Padrão | Arquivo de Posição 5.0, ISO 20022, mensagem MX semt.003.001.04 | | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Vigência | Exclusivo para posições de fundos desde 1º/07/2025; 4.01 descontinuado para fundos | | Validação | Três XSDs: head.001.001.01 (namespace p:, envio e tamanho), semt.003.001.04 (ns3:, fundo e ativos) e SchemaBalanceForSubAccountBrazil (posatbr:, informações adicionais do mercado brasileiro) | | Identificação de ativos | Tabelas nível ANBIMA: nível 1 identifica o produto, nível 2 o lastro (ativo-objeto), nível 3 o tipo de negociação; ISIN por ativo | | Formato numérico | Valores financeiros com no máximo 18 dígitos: 13 inteiros e 5 decimais | | Quem valida | Boletador/validador Galgo/ANBIMA: estrutura, tamanho de campos, estrutura do ISIN e coerência do PL contra ativos, receitas e despesas | | Materiais | Manual de preenchimento (mais de 200 páginas), perguntas e respostas e validador, no site da ANBIMA | > O arquivo de posição é uma tradução simultânea entre dois sistemas contábeis. Se o intérprete troca uma palavra, os dois lados acham que se entenderam, e a reunião termina com decisões tomadas sobre a frase errada. ## Anatomia do arquivo O 5.0 é organizado em blocos de dados agregados, cada um com campos específicos e regras próprias de obrigatoriedade e repetição. - **Paginação e detalhes gerais:** número da página da mensagem, indicador de continuidade (se há continuação ou se é a última página), data, atividade, frequência de envio e base das informações. - **Prestadores:** administrador, gestor e custodiante. - **Veículo:** detalhes da classe, da subclasse ou da carteira administrada. - **Ativos:** um bloco por tipo, com quantidade, preço, valor financeiro, ISIN, tabelas nível e campos específicos. Os tipos já formalizados incluem caixa, títulos públicos, títulos privados, debêntures, compromissadas, termo de renda fixa, ações e ativos negociados na B3, opções de ação, termo e empréstimo de ações, futuros, swaps, opções de derivativos e de moedas, forwards de moedas, imóveis e cotas de fundos, no Brasil e no exterior. - **Patrimônio:** PL na moeda base do fundo ou carteira, receitas, despesas, cotas a emitir e a resgatar. Ativos ainda não formalizados passam pelo comitê técnico do Arquivo de Posição antes de ganhar campos próprios, e o mercado recebe prazo para implementar. Até lá, a forma de preenchimento precisa ser combinada entre as partes e documentada, porque o validador não vai apontar um ativo novo preenchido em bloco errado. ## Classes e subclasses: o que muda no arquivo e nas contas A adaptação à 175 mexeu no cabeçalho e na lógica do PL. O arquivo de uma **classe sem subclasses** traz a identificação e o cadastro da classe, os ativos e as despesas. O arquivo de uma **classe com subclasses** traz, além disso, o cadastro e as despesas de cada subclasse. O arquivo da **subclasse** traz o cadastro da classe (opcional), o cadastro da subclasse, suas despesas e a quantidade de **cotas gerenciais**. As regras de nome de arquivo também foram revistas para identificar classe e subclasse. As fórmulas de PL que a ANBIMA publicou no guia de perguntas e respostas são a referência para qualquer conciliação: | Estrutura | PL pela composição | PL pelas cotas | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Classe com subclasses | Ativos da classe + receitas (classe e subclasses) − despesas (classe e subclasses) − cotas a emitir (subclasses) − cotas a resgatar (subclasses) | Soma, por subclasse, de valor da cota × quantidade de cotas. A cota da classe é gerencial e não entra no PL, porque ignora receitas e despesas das subclasses | | Classe sem subclasses | Ativos + receitas − despesas − cotas a emitir − cotas a resgatar, tudo da classe | Valor da cota da classe × quantidade de cotas da classe | As duas fórmulas precisam dar o mesmo número. Quando não dão, a diferença está em cotas a emitir ou resgatar lançadas no nível errado, em despesa de subclasse contabilizada na classe ou em cota gerencial usada como se fosse real. Esse é o cruzamento que o validador faz e que o sistema da gestora deve refazer. ## Os erros mais comuns 1. **Versão errada.** Arquivo 4.01 recebido para um fundo depois de julho de 2025. Além de descontinuado, ele não representa classes e subclasses. 2. **CNPJ do fundo no lugar do CNPJ da classe.** Na estrutura da 175, a classe é a entidade que tem carteira; os informes e o cadastro referenciam a classe, e o arquivo precisa seguir a mesma chave. 3. **Subclasse sem cabeçalho próprio.** Despesas e cotas da subclasse lançadas na classe, o que quebra a fórmula de PL e a cota por subclasse. 4. **Cota gerencial tratada como cota real.** Em classes com subclasses, a cota da classe é apenas gerencial; usá-la para PL ou para conciliar com o administrador gera divergência permanente. 5. **PL que não fecha com a composição.** O somatório de ativos, receitas e despesas não bate com o PL informado. O validador aponta; muitos sistemas ignoram o aviso. 6. **ISIN estruturalmente válido, ativo errado.** O validador checa a estrutura do ISIN, não a sua existência nem se ele representa o ativo. Um ISIN de outra série da mesma debênture passa na validação e erra o preço. 7. **Tabelas nível incoerentes.** Produto, lastro e tipo de negociação que não combinam entre si (um futuro classificado com lastro de renda fixa e negociação de balcão, por exemplo) desviam o ativo para o bloco errado do controle de limites. 8. **Precisão numérica.** Valores com mais de cinco casas decimais ou mais de treze inteiros são truncados ou rejeitados, e o truncamento silencioso gera diferenças de centavos que se acumulam. 9. **Sinais e convenções.** Despesas, cotas a resgatar e posições vendidas com sinal invertido em relação ao manual. 10. **Datas.** Data-base diferente da data de fechamento, ou arquivo de D-1 carregado como D0 em dia de feriado local. 11. **Paginação.** Arquivo com continuação em que a segunda página não é lida, ou indicador de última página ausente. 12. **Ativos novos em blocos improvisados.** Criptoativos, créditos de carbono ou estruturas no exterior preenchidos em bloco de outro tipo sem acordo documentado entre as partes. ## Pipeline de validação em quatro camadas Validar o XML é mais do que passar pelo XSD. Um pipeline que protege o controle da gestora tem quatro camadas, e o arquivo só é carregado na base de posições depois da última. | Camada | O que verifica | Ferramenta | Resultado | | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | ---------------------------------------------------------------- | | 1\. Estrutural | Aderência aos três XSDs, namespaces, tamanho de campos, paginação, versão do layout | Validador Galgo/ANBIMA ou validação XSD no sistema | Arquivo aceito ou rejeitado com o erro de esquema | | 2\. Semântica | ISIN existente e coerente com o ativo, tabelas nível compatíveis entre si, data-base, moeda, prestadores iguais ao cadastro, classe e subclasse iguais ao HUB ANBIMA | Cadastros de ativos e de veículos da gestora | Lista de ativos não reconhecidos e de classificações incoerentes | | 3\. Contábil | PL pela composição igual ao PL pelas cotas; cotas a emitir e resgatar no nível certo; despesas por subclasse; sinais | Recomputação das fórmulas da ANBIMA | Diferença zero ou quebra apontada por componente | | 4\. De negócio | Posições contra a carteira própria e a custódia; preços contra a cota sombra; variação de PL e cota contra o dia anterior | Batimento diário | Carteira liberada para limites e risco, com quebras documentadas | A quarta camada é o batimento propriamente dito, descrito em [batimento de carteira: como conciliar ativos, PL e posições](https://fundsys.com.br/blog/batimento-de-carteira-conciliacao-fundos). A regra prática: um arquivo que passa nas três primeiras camadas e falha na quarta indica erro de conteúdo no administrador ou na gestora; um arquivo que falha na primeira ou na segunda não deveria nem chegar à quarta. > O XML certo, lido certo, por classe e subclasse, antes de virar limite e risco. > > [Conhecer o Fundsys](https://fundsys.com.br/#demo) ## Para que mais o arquivo serve Depois de validado, o mesmo arquivo alimenta o controle de enquadramento por classe, o cálculo de risco e liquidez, a cota sombra, os relatórios a investidores institucionais e, para fundos estruturados detidos por planos de previdência, o reporte à Previc. Por isso, o custo de um erro de leitura não fica na controladoria: ele se propaga para o limite apurado errado, o VaR calculado sobre a posição errada e a lâmina com composição errada. A automação dessa cadeia está em [como automatizar o controle de enquadramento de carteira](https://fundsys.com.br/blog/automatizar-controle-de-enquadramento-carteira). ## O acordo operacional com o administrador Boa parte dos erros não é técnica; é de combinação. Um acordo escrito com cada administrador evita a maior parte deles: - Horário de envio e canal, com política para reenvio e para arquivos corrigidos (nome, versão, data). - Um arquivo por classe ou por subclasse, conforme a estrutura de cada fundo, com regra de nome documentada. - Tratamento combinado para ativos ainda não formalizados no layout. - Fonte de preço e critério de câmbio usados, para que a gestora saiba o que está comparando na camada de negócio. - Contato responsável por corrigir o arquivo no mesmo dia, com prazo. ## Checklist de processamento do XML ANBIMA ### Antes de carregar a carteira #### Recepção - Arquivo na versão 5.0, com nome no padrão e data-base igual ao fechamento esperado. - Um arquivo por classe ou subclasse, conforme a estrutura cadastrada no HUB ANBIMA. - Paginação completa e indicador de última página presente. #### Validação - Aprovado nos três XSDs e no validador Galgo/ANBIMA. - ISINs reconhecidos no cadastro de ativos; tabelas nível coerentes entre si. - PL pela composição igual ao PL pelas cotas; cota gerencial da classe fora do PL. - Despesas, cotas a emitir e a resgatar no nível certo e com sinal correto. - Valores dentro de 13 inteiros e 5 decimais, sem truncamento silencioso. #### Carga e registro - Posições, preços e provisões conciliados com carteira própria e custódia. - Arquivo original, erros apontados, correções e reenvios guardados com data. - Acordo operacional com o administrador revisado a cada mudança de layout. ## Perguntas frequentes sobre o XML ANBIMA de fundos ### O que é o Arquivo de Posição 5.0 da ANBIMA? É o layout padronizado pela ANBIMA para a troca de informações sobre posições de fundos e carteiras administradas entre administradores, gestores e demais prestadores, baseado na mensagem ISO 20022 semt.003.001.04. Ele traz prestadores, cadastro da classe ou subclasse, ativos, receitas, despesas e PL, e foi adaptado em 2024 às classes e subclasses da Resolução CVM 175. ### O Arquivo de Posição 4.01 ainda pode ser usado? Para posições de fundos, não: desde 1º de julho de 2025, gestores e administradores devem usar exclusivamente o Arquivo de Posição 5.0, e o 4.01 foi descontinuado por não representar a estrutura de classes e subclasses. O 4.01 seguiu válido apenas para carteiras administradas, até ser substituído. ### A ANBIMA recebe o XML de posição dos fundos? Não. A ANBIMA padroniza o layout, mantém o manual de preenchimento e o boletador/validador, mas o arquivo circula diretamente entre administrador, gestora, distribuidores, consultores e investidores institucionais. A Previc utiliza o padrão para receber informações de fundos estruturados detidos por planos de previdência. ### O que o validador da ANBIMA verifica no arquivo? A estrutura do arquivo contra os XSDs, o tamanho dos campos, a estrutura do ISIN informado e a coerência do somatório de ativos, receitas e despesas em relação ao PL do fundo ou carteira. Ele não acessa fontes externas, portanto não confirma se o ISIN existe nem se representa corretamente o ativo. Essas verificações são da gestora. ### Como se calcula o PL de uma classe com subclasses no Arquivo de Posição 5.0? Pela composição: ativos da classe mais receitas da classe e das subclasses, menos despesas da classe e das subclasses, menos cotas a emitir e a resgatar das subclasses. Pelas cotas: a soma, por subclasse, do valor da cota multiplicado pela quantidade de cotas. A cota da classe é apenas gerencial e não entra no cálculo, porque não considera receitas e despesas das subclasses. ### Quais são os três XSDs do Arquivo de Posição 5.0? O head.001.001.01, identificado pelo namespace p:, com os campos de envio e tamanho do arquivo; o semt.003.001.04, identificado por ns3:, com as informações do fundo e seus ativos; e o SchemaBalanceForSubAccountBrazil, identificado por posatbr:, com as informações adicionais do fundo e dos ativos para o mercado brasileiro. ### Qual é o limite de casas decimais no XML ANBIMA? Os valores financeiros devem ter no máximo 18 dígitos, sendo 13 para a parte inteira e 5 para a parte decimal. Arquivos gerados com mais precisão sofrem truncamento ou rejeição, e o truncamento silencioso é uma causa frequente de diferenças de centavos entre a carteira do administrador e a da gestora. > Quatro camadas de validação entre o XML do administrador e o limite apurado. > > Traga um Arquivo de Posição 5.0 real. Em uma demonstração, mostramos a validação estrutural, semântica, contábil e de negócio, as fórmulas de PL refeitas por classe e subclasse e a carteira liberada para limites e risco com a trilha de cada correção. > > [Conhecer o Fundsys](https://fundsys.com.br/#demo) ## Leia também - Controles: [Batimento de carteira: como conciliar ativos, PL e posições](https://fundsys.com.br/blog/batimento-de-carteira-conciliacao-fundos) - Controles: [Fechamento de cota e cálculo de PL: passo a passo da controladoria](https://fundsys.com.br/blog/calculo-de-cota-fundo-fechamento-pl) - Enquadramento: [Como automatizar o controle de enquadramento de carteira](https://fundsys.com.br/blog/automatizar-controle-de-enquadramento-carteira) - CVM 175: [Resolução CVM 175: guia completo para gestoras](https://fundsys.com.br/blog/resolucao-cvm-175-guia-completo) - Conformidade: [Calendário de obrigações CVM e ANBIMA da gestora](https://fundsys.com.br/blog/calendario-obrigacoes-cvm-anbima-gestora) - Tecnologia: [Software de controle de risco e compliance para gestoras: como escolher](https://fundsys.com.br/blog/software-controle-risco-compliance-gestoras) _Este conteúdo tem finalidade informativa e não substitui a leitura das normas citadas nem a assessoria jurídica da sua instituição. Prazos, números de artigos e entendimentos das áreas técnicas foram verificados em agosto de 2026 e são revisados trimestralmente; alterações posteriores podem não estar refletidas._