CNV — Composición de Cartera de FCI

Composición semanal de cartera de los Fondos Comunes de Inversión argentinos (artículo 34, Capítulo XI de las Normas CNV): por fondo y semana, los instrumentos que tiene (especie) con su porcentaje del patrimonio neto, agrupados por clase de activo, moneda y país, más el patrimonio neto total del fondo.

Mercado de capitalesFondos (FCI)

Columna

Tipo

Descripción

Unidad

fecha_cartera

Date

Fecha 'Cartera al' publicada por el fondo (cierre semanal del dato: habitualmente viernes, los feriados la corren al último día hábil). Es la fecha del DATO publicado por CNV, no la fecha de scrape. CNV publica con ~2 semanas de lag.

ISO 8601 YYYY-MM-DD

codigo_fondo

String

ID interno del fondo en el sitio CNV (valor del <option> del select Lfc, usado en la URL DetallesFCI/{id}). NO es el número de registro oficial CNV ni el código CAFCI, y NO joinea con cnv.fci.cuotapartes-diarias.codigo_cnv (espacios de ID distintos). El puente entre ambos datasets es por denominación de fondo — ver gotcha.

—

denominacion

String

Nombre del fondo (nivel fondo, sin sufijo de clase) tal como lo publica CNV en DetallesFCI. Es el puente práctico hacia cnv.fci.cuotapartes-diarias (que reporta a nivel fondo+clase, ej. '... - Clase A').

—

sociedad_gerente

String

Nombre de la sociedad gerente del fondo.

—

sociedad_depositaria

String

Nombre de la sociedad depositaria del fondo.

—

clasificacion

String

Clasificación del FONDO entero (Money Market, Renta Fija, Renta Variable, Mixto, etc.). No confundir con clase_activo, que es la clase de cada tenencia DENTRO del fondo.

—

moneda_fondo

String

Moneda base en que opera el FONDO (Pesos, Dólares, etc.). De las tres columnas de moneda: moneda_fondo = base del fondo; moneda_seccion = la de cada bloque de la cartera (puede diferir en multi-moneda); moneda_pn = en la que se informa el P.N. (≈ moneda_fondo).

—

region

String

Región de inversión declarada del fondo.

—

horizonte

String

Horizonte de inversión declarado del fondo (Corto / Mediano / Largo plazo).

—

tipo_fila

String

Discriminador de fila: 'instrumento' para tenencias individuales, 'categoria' para encabezados de clase de activo. SIEMPRE filtrar por este campo antes de agregar.

—

orden

Int32

Orden secuencial de la fila dentro de la cartera del fondo, para reproducir el orden original del HTML.

—

clase_activo

String

Clase de activo de la TENENCIA (ej. 'Plazo Fijo', 'Letras y Bonos del Tesoro', 'Disponibilidades'). Es a nivel holding dentro del fondo — distinto de clasificacion (que es el tipo del fondo entero). Para filas 'instrumento' se hereda del encabezado de clase previo.

—

moneda_seccion

String

Moneda de la sección de cartera (puede diferir de moneda_fondo en carteras multi-moneda).

—

pais

String

País del instrumento o sección, según clasifica CNV.

—

detalle

String

Especie cruda tal como la publica CNV (ej. 'ON YPF C 17', 'Plazo Fijo Banco Nación'). NO parseado: usar ILIKE para buscar por emisor.

—

pct_pn

Float64

Porcentaje del Patrimonio Neto para filas 'instrumento' (columna CNV '% del P.N.'). Decimal-fraction: 0.05 = 5%. NULL para filas 'categoria'.

decimal-fraction (0.05 = 5%)

pct_pn_reexp

Float64

Porcentaje del P.N. reexpresado para filas 'categoria' (columna CNV '% del P.N.(2)', montos reexpresados en moneda del fondo). Decimal-fraction. NULL para filas 'instrumento'.

decimal-fraction (0.05 = 5%)

pct_desde_monto

Boolean

TRUE si el % fue derivado normalizando montos absolutos (fondos cerrados/estructurados, ~2%) en vez de leerse directo como porcentaje. Provenance de calidad — ver gotcha. FALSE para la mayoría de los fondos.

—

pn_total

Float64

Patrimonio Neto total del fondo reexpresado en moneda_pn. Permite derivar monto absoluto: pn_total * pct_pn.

moneda_pn (ARS o USD según fondo)

moneda_pn

String

Moneda en que está expresado pn_total (la moneda del fondo).

—

valor_en_cartera

Float64

Valor absoluto de la fila en cartera, en moneda_pn. Columna DERIVADA = (% del P.N. de la fila) × pn_total. Para filas instrumento es el valor de esa tenencia; para categoria, el total de la clase de activo. Evita que el analista multiplique a mano.

moneda_pn (ARS o USD según fondo)

Pueden invalidar un análisis ingenuo. Documentadas como parte del control de calidad.

fecha_cartera es la fecha del DATO (campo 'Cartera al'), no la fecha de scrape

A partir de v0.4.0 la columna fecha_cartera contiene la fecha "Cartera al" publicada por CNV — el cierre semanal del portfolio. Es la fecha del DATO, no la fecha en que corrió el scraper. La fecha de proceso la gestiona la plataforma de forma separada (campo data_period_end en la tabla snapshots). El parquet is_latest contiene TODA la historia acumulada de semanas capturadas. Para la última semana disponible usar fecha_cartera = (SELECT MAX(fecha_cartera) FROM data_cnv_fci_carteras). Para series históricas filtrar por rango de fecha_cartera. No se necesita all_snapshots=true ni UNION — la historia ya está en el parquet vigente. Si un período fue re-publicado por CNV con correcciones, el dato del scrape más reciente sobre ese período prevalece.

Dos columnas de porcentaje: pct_pn vs pct_pn_reexp

Las filas instrumento traen pct_pn (columna CNV % del P.N., calculado en la moneda de la sección). Las filas categoria traen pct_pn_reexp (columna CNV % del P.N.(2), calculado sobre montos reexpresados en la moneda del fondo). Ambas en decimal-fraction (0.05 = 5%). La columna que no aplica al tipo de fila es NULL.

Filtrar siempre por tipo_fila

instrumento para analizar tenencias; categoria para el breakdown por clase de activo. Mezclar ambas en una suma produce doble conteo: las categorías ya agregan los instrumentos que las componen.

pct_desde_monto: fondos cerrados/estructurados normalizados

Para ~2% de los fondos (cerrados/FCIC, estructurados) CNV publica la cartera en MONTOS ABSOLUTOS en pesos en vez de porcentajes (mismo header "% del P.N."). Almanac lo detecta y normaliza por el total para recuperar el % real, así que pct_pn/pct_pn_reexp son decimales válidos (suman a 1.0) en TODOS los fondos. pct_desde_monto = TRUE marca estos casos para provenance: el % es derivado (no publicado directo) y pn_total se reconstruyó del total de la cartera (CNV mostraba un factor 1, no el PN).

Lag de publicación ~2 semanas — el último snapshot NO es de esta semana

CNV publica la cartera con ~2 semanas de retraso. El MAX(fecha_cartera) disponible suele estar 2-3 semanas atrás de hoy — es lo esperado, no un dato faltante. Para "la cartera más reciente" usá siempre MAX(fecha_cartera), nunca la fecha de hoy ni el último viernes.

fecha_cartera es el cierre semanal real, no siempre un viernes

fecha_cartera proviene del campo "Cartera al" publicado por el fondo: habitualmente un viernes, pero los feriados lo corren al último día hábil (ej. 2026-04-30, jueves, por el 1° de mayo). No asumir que toda fecha es viernes. Es idempotente: re-correr sobre una semana ya guardada no emite filas nuevas.

Fondos sin cartera

Algunos fondos no publican la pestaña de composición del art. 34 (fondos cerrados, en liquidación, o que aún no la habilitaron). Estos fondos quedan fuera del snapshot — su ausencia no implica cartera vacía, sino dato no disponible.

Multi-moneda: pn_total en moneda_pn, no siempre pesos

pn_total está reexpresado a moneda_pn (la moneda del fondo: ARS, USD, etc.). moneda_seccion indica la moneda de cada sección de la cartera. Para consolidar AUM en pesos de fondos en USD se requiere el tipo de cambio del día — no está en este dataset.

Emisor no parseado — detalle es especie cruda

detalle contiene la descripción de la especie tal como la publica CNV (ej. "ON YPF C 17", "Letra del Tesoro 14/06"). Almanac no parsea emisor, ISIN, ni país fino: esa derivación es una capa gold futura. Para buscar por emisor usar detalle ILIKE '%EMISOR%' como aproximación — puede incluir falsos positivos.

Texto con acentos: ILIKE es accent-sensitive

Los valores de texto traen acentos (ej. "Dólares", "Información"). Un ILIKE '%dolar%' NO matchea "Dólares" (ó≠o). Para encontrar el valor exacto a filtrar usá data_distinct_values (busca accent-insensitive) en vez de adivinar el ILIKE, o respetá los acentos en el patrón.

país suele venir NULL

CNV no puebla país para muchos fondos (queda NULL en todas sus filas). Cuando país IS NULL no se puede separar emisor local vs cross-border desde el dato — es ausencia en la fuente, no un filtro que devuelve vacío.

El join con cuotapartes-diarias es por NOMBRE, no por código

codigo_fondo es el ID interno del sitio CNV (Lfc, ej. 82276), un espacio de identificadores DISTINTO al codigo_cnv que reporta CAFCI en cnv.fci.cuotapartes-diarias (ej. el mismo fondo es Lfc 82276 acá y codigo_cnv 1152 allá). Joinear codigo_fondo = codigo_cnv da CERO matches. El puente práctico es por denominacion de fondo: carteras es nivel fondo ("Balanz Capital Money Market"); cuotapartes es nivel fondo+clase ("Balanz Capital Money Market - Clase A") — cortar el sufijo " - Clase ..." antes de comparar. Para ponderar por patrimonio NO hace falta el join: pn_total ya viene en este dataset.

Qué incluye