MECON

MEcon — Canjes y conversiones del Tesoro (operaciones de gestión de pasivos)

Operaciones de canje y conversión de deuda del Tesoro, por instrumento.

Sector público y fiscalDeuda pública

Qué incluye

19 columnas documentadas
Formato Parquet y CSV
Cobertura 2020-01 a presente (7 archivos por año, snapshot reemplaza)
Actualización mensual
Acceso por descarga, API y MCP
Schema versionado y trazable a la fuente

Casos de uso

¿Cuál fue la operación de canje o conversión más grande de los últimos 12 meses?
¿Qué porcentaje del rollover de deuda del Tesoro se hizo via canjes vs colocaciones primarias en 2024-2025?
¿Cuántos canjes con incumplimiento parcial hubo y por qué montos?
¿Cuál es la vida promedio de los instrumentos nuevos recibidos vs los entregados, en operaciones del Layout B (2022+)?
¿Qué cantidad de operaciones se hicieron en USD/DLK vs ARP/UCP en el último año?
Para una resolución específica (ej. RESOL Nº16/2024), ¿cuál fue el detalle de los legs?
¿Cómo evolucionó el tamaño promedio de las operaciones de canje desde 2021?
¿Qué tipos de instrumento aparecen como entregados con mayor frecuencia en las conversiones de 2024-2025?

Columnas19

Columna	Tipo	Descripción	Unidad
fecha_liquidacion	Date	Fecha de liquidación del leg. Para reconstruir la operación completa agrupar por (fecha_liquidacion, numero_resolucion).	ISO 8601 YYYY-MM-DD
instrumento_recibido	String	Nombre limpio (sin sufijos) del instrumento NUEVO entregado por el Tesoro al mercado.	—
numero_resolucion	String	Número de la resolución MECON que autoriza la operación.	—
operacion_tipo	String	Tipo de operación: 'canje' (rotación de stock con mismo perfil) o 'conversion' (rotación con cambio de perfil/moneda).	—
instrumento_entregado	String	Nombre limpio del instrumento VIEJO entregado al Tesoro por el inversor. NULL en Layout A (pre-2022).	—
tipo_instrumento_recibido	String	Tipo del instrumento nuevo (16 valores enum). Reusa enum de mecon.tesoro.colocaciones-primarias.	—
tipo_instrumento_entregado	String	Tipo del instrumento entregado al Tesoro (16 valores enum). NULL en Layout A.	—
fecha_emision_recibido	Date	Fecha de emisión del instrumento nuevo.	ISO 8601 YYYY-MM-DD
fecha_vencimiento_recibido	Date	Fecha de vencimiento del instrumento nuevo.	ISO 8601 YYYY-MM-DD
valor_nominal_recibido_millones	Float64	Valor nominal del instrumento nuevo, en MILLONES de la `moneda` de la fila.	—
valor_nominal_entregado_millones	Float64	Valor nominal del instrumento entregado al Tesoro, en MILLONES de la `moneda`. NULL en Layout A.	—
moneda	String	Moneda ISO 4217 en que viene INFORMADO el monto (derivada de 'Tipo Moneda': MN→ARS, ME→USD, no del código): ARS o USD. Para sumar montos, filtrar/agrupar por moneda (no mezclar).	—
moneda_nativa	String	Código MECON crudo del instrumento: ARP / USD / UCP / DLK. Preservado para re-derivar la moneda si una fuente informa en otra moneda.	—
clausula_ajuste	String	Indexación/cláusula (NO es moneda): 'CER' (UCP, peso CER-linked) o 'USD-linked' (DLK, o USD liquidado en pesos = dollar-linked). NULL si moneda directa (ARP, o USD pagado en USD).	—
tipo_moneda_pago	String	Tipo de moneda de pago: 'MN' (moneda nacional) o 'ME' (moneda extranjera).	—
cupon_raw	String	Descripción del cupón tal cual viene del XLSX. Texto libre.	—
vida_promedio_anios	Float64	Vida promedio del instrumento nuevo en años (cuando aplica).	—
incumplimiento	Boolean	TRUE si el sufijo `(****)` apareció en el nombre del instrumento entregado (operación no se cumplió en su totalidad).	—
fuente	String	Origen técnico: 'xlsx_colocaciones' (default), 'comunicado_html' (fast-lane), 'revision_manual'.	—

Limitaciones conocidas

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

Layout A pre-2022 NO trae instrumento entregado

En 2021 (y archivos pre-2020 si se backfileara), el XLSX solo describe el instrumento NUEVO recibido. Las columnas instrumento_entregado y valor_nominal_entregado son NULL en esas filas. Cualquier query que asuma par swap completo va a perder ~100 filas del año 2021. Para reconstruir el par swap completo en esos años habría que parsear el texto libre de la resolución (out of scope v0.1, planeado para v0.3).

NO sumar valor_nominal_*_millones a través de monedas distintas

Sumar valor_nominal_recibido_millones sin filtrar moneda mezcla millones de pesos (ARS) con millones de dólares (USD) — no son comparables ni convertibles sin TC oficial. Para totales en pesos filtrar moneda = 'ARS'; en dólares moneda = 'USD'. Almanac no convierte USD↔ARS. Los ajustes (UCP, dollar-linked) viven en clausula_ajuste, separados de la moneda.

Sufijo (****) marca incumplimiento parcial

En el XLSX, un nombre como LETRA/$/30-04-2025 (****) marca que la operación tuvo incumplimiento parcial (no se cumplió 100%). El parser strip-ea el sufijo de instrumento_entregado y eleva el flag a la columna incumplimiento (BOOL). Para auditoría de cumplimiento, filtrar incumplimiento = TRUE. El nombre limpio facilita JOINs con colocaciones-primarias.

1->N y N->1: cada fila es un leg, NO una operación

Operaciones grandes consolidan varios instrumentos en una sola resolución. Ejemplo observado: LETES/$/28-04-2023 recibido contra 6 instrumentos entregados en una RESOL Nº1 del 2023-01-06 aparece como 6 filas (todas con la misma numero_resolucion y fecha_liquidacion, distinto instrumento_entregado). Para análisis por OPERACIÓN agrupar por (numero_resolucion, fecha_liquidacion). Para análisis por LEG usar las filas tal cual.

Sheet name varía: con/sin espacio antes del guión

El nombre de la hoja en el XLSX no es estable: aparece como Canjes - Conversiones (con espacio) en algunos años y Canjes- Conversiones (sin espacio) en otros. El parser detecta por substring case-insensitive contains "canje" AND contains "conversi", robusto a estas variantes. Si Sec. Finanzas introduce una nueva variante (mayúsculas, tildes), el match sigue funcionando — pero conviene auditar al ingerir un año nuevo.

Snapshot reemplaza al anterior (cumulativo, no incremental)

Cada XLSX anual contiene TODAS las operaciones del año. Sec. Finanzas re-publica el archivo del año en curso con "información preliminar" actualizada (nuevas operaciones, fixes a operaciones previas). Almanac NO sobrescribe snapshots viejos (Object Lock 90d en silver/), así que un dato del mismo mes puede diferir según el snapshot. Para análisis crítico, usar siempre el último snapshot disponible — es la versión oficial vigente.

vida_promedio_anios siempre en años, sin variante días

A diferencia de colocaciones-primarias (donde Vida Promedio viene en años en Bonos y en días en Letras / Letras ISP), en este sheet la columna viene siempre en años (decimal). El schema usa vida_promedio_anios exclusivamente. Si futuras versiones del XLSX introducen variantes de unidad, replicar el patrón de colocaciones-primarias con dos columnas separadas.

PK puede requerir un 4to campo si hay duplicados legítimos

La PK actual es (fecha_liquidacion, instrumento_recibido, numero_resolucion). El spec contempla agregar instrumento_entregado como 4to campo si la implementación detecta duplicados legítimos (el mismo instrumento recibido el mismo día bajo la misma resolución, contra dos instrumentos entregados distintos en Layout B). Verificar durante backfill.