CM-17 · Eventos corporativos#

En una frase, para cualquiera: de vez en cuando una empresa parte sus acciones en dos, o reparte dividendos. Nadie compró ni vendió nada, pero todas las cuentas de todos los dueños tienen que cambiar a la vez.

Estado real: 🟠 prototype — hay código y escenarios que se ejecutan, sin verificación en un entorno real · Módulo: crates/sandbox-markets/src/cases/corporate_actions.rs

Por qué se realiza este caso#

Los eventos corporativos son la principal fuente de descuadres que no vienen de una operación. El sistema está preparado para «alguien compró, alguien vendió»; un split no encaja en ese molde y hay que aplicarlo a mano sobre todas las posiciones a la vez.

Y hay tres fechas que casi nunca coinciden, lo que genera la mayoría de los errores: quién tenía el instrumento en la fecha de registro, no quién lo tiene cuando se paga.

La idea que enseña, y que ningún otro caso enseña#

Una transformación sobre todas las posiciones a la vez, sin que nadie opere. Es atómica —o se aplica a todos o a ninguno— y tiene que dejar el libro cuadrado. Es el ensayo más exigente del invariante de CM-03, porque toca miles de posiciones simultáneamente.

Casos de uso reales#

• Un custodio que aplica dividendos a las cuentas de sus clientes.
• Ajustar precios históricos tras un split para que las series sean comparables.
• Calcular el costo de adquisición después de un canje.
• Formación: por qué un split no hace más rico a nadie.

Cómo funcionará#

flowchart LR
  E["📢 Evento anunciado"] --> F["📅 Fechas:<br/>anuncio · registro · pago"]
  F --> S["📸 Posiciones en la<br/>FECHA DE REGISTRO"]
  S --> A{"⚙️ Aplicar"}
  A --> P1["📊 Posiciones"]
  A --> P2["💰 Efectivo"]
  A --> P3["🧾 Costo de adquisición"]
  A --> P4["🔢 Unidades"]
  P1 & P2 & P3 & P4 --> C["🔍 Invariante CM-03<br/>sigue cuadrando"]
  C --> H["🗂️ Historial del evento"]

flowchart TB
  A["Split 2:1"] --> B["Unidades × 2"]
  B --> C["Precio ÷ 2"]
  C --> D{"¿El valor total<br/>de cada tenedor<br/>es el mismo?"}
  D -- no --> E["🚨 El evento se aplicó mal"]
  D -- sí --> F{"¿Quedan fracciones?"}
  F -- sí --> G["💰 Compensar en efectivo<br/>con regla publicada"]
  F -- no --> H["✅ Aplicado"]

Las fracciones son el detalle que se olvida: en un split 3:2, quien tenía 5 unidades pasa a tener 7,5. Y media unidad no existe.

Esquemas#

{
  "corporateAction": {
    "id": "ca-2026-05",
    "instrument": "ACME-SIM",
    "kind": "split",
    "ratio": { "from": 1, "to": 2 },
    "announcedAt": "2026-05-01",
    "recordDate": "2026-05-15",
    "paymentDate": "2026-05-20",
    "fractionPolicy": "cash-in-lieu"
  }
}

{
  "applied": {
    "positionsAffected": 1840,
    "unitsBefore": 500000,
    "unitsAfter": 1000000,
    "totalValueChanged": false,
    "cashInLieuPaid": { "minorUnits": 42000, "currency": "CLP" },
    "ledgerBalanced": true,
    "atomic": true
  }
}

el de custodia. Los dos tienen que cumplirse a la vez.

Software necesario#

Sin jaula ni Linux. Se apoya en Money, Ledger y CustodyBook, ya construidos.

Instalación#

cargo build --release

Procesos que se crearán#

sandboxctl markets corporate-action --event ca-2026-05
  │
  └─ un proceso determinista, sin red
      ├─ snapshot de posiciones a la fecha de registro
      ├─ aplicación ATÓMICA (todas o ninguna)
      └─ conciliación CM-03 al terminar

Tiempo de carga estimado#

Qué hace falta para construirlo#

1. Los siete tipos de evento.
2. Las tres fechas, con el snapshot tomado en la fecha de registro.
3. Aplicación atómica con reversa si algo falla a mitad.
4. Política de fracciones explícita y publicada.
5. Actualización de costo de adquisición e historial.
6. Conciliación con CM-03 tras cada

evento.

Si algo falla#

El caso ya tiene código y escenarios que se ejecutan. Lo que sigue son sus fallos con la causa y la salida:

Los fallos que afectan a cualquier caso —la compilación, el catálogo, la evidencia— están resueltos uno a uno en Cuando algo falla.

Esta familia no necesita aislamiento del sistema: no ejecuta código ajeno, sino reglas de negocio deterministas. Por eso casi ningún fallo suyo viene del entorno, y casi todos vienen de los datos.

Cómo se comprueba#

cargo run -p sandboxctl -- markets check --case CM-17

Ejecuta los escenarios de este caso y compara cada uno con lo que declara de antemano que debe salir. Corre en cada commit: si el caso deja de detectar lo que dice detectar, la integración continua se pone roja.

cargo test -p sandbox-markets corporate_actions

Los invariantes del módulo, incluidos los que ningún escenario de arriba cubre.

Sigue en prototype, no en functional. Los escenarios se ejecutan y pasan, pero el caso no emite evidencia firmada por ejecución ni se ha usado contra datos que no sean los suyos. La regla completa está en el ROADMAP.

Ver también: Catálogo completo · CM-03 · custodia · CM-16 · datos de mercado