> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Midaz: guía de extracto de cuenta > Una nueva guía de Midaz explica cómo transformar operaciones de cuenta en extractos orientados al cliente, con cálculo de saldos y formato para UI. 19 de mayo de 2026 Actualización de documentación Sin migración requerida ## Afecta *** Equipos que construyen experiencias de extracto con operaciones de cuenta de Midaz, incluyendo integradores, arquitectos de soluciones, ingenieros de backend y equipos de producto que definen vistas de actividad de cuenta. Esta actualización se aplica al portal de documentación pública. No cambia el comportamiento del API en tiempo de ejecución de Midaz. ## Qué cambió *** ### Nueva guía para construir extractos Midaz ahora cuenta con una guía dedicada para construir extractos de cuenta a partir de las operaciones del ledger. La guía explica cómo: * Recuperar las operaciones de cuenta de un período específico * Aplicar filtros de consulta y paginación * Transformar cada operación en una fila del extracto * Usar `direction` para mostrar valores entrantes y salientes * Tratar `ON_HOLD` y `RELEASE` como eventos de bloqueo y liberación de saldo * Mantener las vistas de extracto liquidado enfocadas en operaciones con `balanceAffected=true` * Añadir contexto de negocio mediante metadata de la transacción ### Encuadre orientado al cliente más claro La página explicita el modelo central: Midaz devuelve eventos del ledger. El sistema integrador transforma esos eventos en la experiencia de extracto que los usuarios finales ven. Esto evita tratar el endpoint de operaciones como una pantalla de extracto lista para usar. Son los datos de origen para un extracto. ### Ejemplos prácticos La guía incluye una vista de flujo, mapeo de campos, reglas de visualización, orientación sobre paginación, ejemplos de metadata y una salida de ejemplo del extracto. **Antes** Los equipos contaban con la referencia API para listar operaciones de cuenta, pero no había una única guía que conectara esas operaciones con un extracto orientado al usuario. **Después** Los equipos pueden seguir una sola página para pasar de las operaciones de cuenta a una vista de extracto renderizada. ## Impacto *** Esta es una actualización exclusivamente de documentación. No se requiere migración. Las integraciones existentes de Midaz siguen funcionando como hasta ahora. Usa la nueva guía al diseñar, implementar o revisar experiencias de extracto de cuenta que utilicen operaciones de cuenta de Midaz. ## Qué necesitas hacer *** Revisa la nueva guía de extracto de cuenta si tu producto muestra actividad de cuenta, saldos o historial de transacciones a usuarios finales. Usa `direction`, no `type`, para decidir si un valor aparece como entrante o saliente en el extracto. Añade metadata de negocio al crear las transacciones si tu extracto necesita descripciones amigables al usuario, contrapartes, canales, categorías o referencias de pago. Mantén las vistas de extracto liquidado enfocadas en operaciones donde `balanceAffected=true`. ### Plazo Ninguno. ### Por qué Los extractos de cuenta necesitan tanto precisión contable como contexto para el usuario. La nueva guía muestra cómo preservar el modelo de ledger mientras se presenta la actividad de la cuenta de una manera que los clientes pueden leer. ## Recursos *** * [Construir un extracto de cuenta](/es/midaz/building-account-statements) * [List Operations by Account](/es/reference/midaz/list-operations-by-account)