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'.

—

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.

MEcon — Canjes y conversiones del Tesoro

Qué incluye