Extrato das Informações sobre o Fundo — V3¶

Envio (→ CVM) do padrão Extrato das Informações sobre a Classe de Cotas do Fundo V3 (PadraoXMLInfExtratoV3.asp).

Veja também: Referência da API para cada símbolo público · Uso para instalação e o conceito geral.

Descrição¶

Monte um ExtratoDocument (um ExtratoHeader + de 1 a 1000 ExtratoRow, uma por classe de cotas) e serialize com Extrato().export(...). O arquivo não pode passar de 1 MB.

Modelo	Tag XML	Papel
`ExtratoDocument`	`DOC_ARQ` / `EXTRATO_FUNDO`	Documento: `header` + `rows`.
`ExtratoHeader`	`CAB_INFORM`	`COD_DOC` = 41 e `VERSAO` = 3.0 (fixos), `DT_GERAC_ARQ` `DD/MM/AAAA`.
`ExtratoRow`	`ROW_EXTRATO`	O extrato de uma classe de cotas.

Os blocos internos (FormaCondominio, Prazo, FundoAnbima, FundoInvertCotas, ValorCota, ResgCotas, PrazoPagamResg, TxPerfm/CalcTxPerfm, TxIngresso, TxSaida, OperDeriv, OperPatrimLiq, AtivExter, FundoAtivos, RegulamentoTipoEmissor, RegulamentoModalidadeAtivo) têm como campos o nome da tag em minúsculas, na ordem do arquivo de exemplo da CVM; o serializador omite o que é None. Os modelos são imutáveis e recusam campos desconhecidos. O CNPJ da classe (cnpj_fdo) é validado por dígito verificador e gravado sem máscara.

Tipagem¶

Decimais¶

A página fixa 2 casas nos limites mínimo e máximo, na aplicação mínima e no teto de crédito privado, e até 6 na taxa máxima de custódia. Nos demais percentuais não informa escala: foram aplicadas 4 casas (política do repositório, não número da CVM). Sempre truncamento em direção a zero; entram Decimal, int e str, e float, bool, NaN e infinito são recusados. A vírgula é o separador decimal na saída. Percentuais ficam entre 0 e 100.

Regras por resposta (blocos condicionais)¶

Cada bloco aplica o que a página diz: FECHADO exige ABERTA_NEG_MER_ORGAN; mercado organizado S é o único que admite LISTA_MERC_BLOQUEIO; DETERMINADO exige o detalhamento; ANBIMA S exige o código (1 a 68) e N o proíbe; análogo para fundo de fundos, valor da cota, carência, taxas de performance/ingresso/saída, derivativos, operações acima do PL, ativos no exterior e crédito privado. Taxa em R$ (2) aceita só 2 casas. Em cada par *_MIN/*_MAX o mínimo não ultrapassa o máximo. A taxa de performance de público não qualificado exige taxa, índice (tabela D: 1 a 35 ou 99) e percentual do índice, e proíbe INFO_ADICIONAL.

Texto e datas ¶

Textos são não vazios, no teto da página (DETALHAMENTO_PRAZO 200; INFO_ADICIONAL 5 a 400), sem caracteres de controle e codificáveis em windows-1252. Datas são lidas de fato (31/02/2026 é recusada).

Política de retry¶

Não se aplica: o writer não faz rede. O texto é codificado e checado como XML bem formado e dentro de 1 MB antes de abrir o destino; uma falha levanta ValueError e não trunca um arquivo já existente.

Divergências da página (escolhas documentadas)¶

O arquivo de exemplo e a lista de tags descrevem duas gerações do formulário. Seguiu-se o exemplo para a estrutura; blocos que só existem na lista de tags (COTA_MERC_SECUND, COTISTA_EXCV, SERV_ATEND_COTISTA, LIM_*, ...) não são modelados.
Namespace: exemplo urn:extr, lista urn:perf. Usado urn:extr.
Tag do CNPJ: exemplo CNPJ_FDO, lista CNPJ_FUNDO. Usado CNPJ_FDO.
Taxa de saída: o exemplo reutiliza a tag TP_VL_FIXO_TX_INGRESSO dentro de TX_SAIDA; é emitida como está.
Política de investimento: a tabela C lista 1 a 3, o questionário acrescenta 4 (Enhanced); aceito 1 a 4.
Taxa de performance: o exemplo marca tudo obrigatório; a lista de tags o torna dependente do público-alvo. Seguiu-se a lista.
Valores sem número na página: dias 0 a 9999; PRAZO_ATUALIZACAO 1 a 200 caracteres.

Exemplos¶

from layouts_cvm import Extrato

doc = dict(
    header=dict(dt_gerac_arq="31/10/2026"),
    rows=[dict(...)],  # uma linha por classe: ver os campos acima
)
xml = Extrato().export(doc)                       # retorna str
Extrato().export(doc, output_path="extrato.xml")  # grava windows-1252, retorna None

Nenhum validador da CVM foi executado contra a saída.