@veriko-mx/sdk 0.4.12 → 0.4.14

package/dist/cjs/generated/openapi.d.ts

@@ -69,7 +69,7 @@ export interface paths {
          *
          *     La cuenta beneficiaria (`cuenta_beneficiaria`) es obligatoria en esta operación, salvo que se envíe `cuentas_candidatas`. Si faltan las dos, la petición se rechaza con `422 preflight_failed` y el error de campo `cuenta_required`: el servicio no la busca entre los beneficiarios guardados.
          *
-         *     Cuando no se sabe a cuál de varias cuentas se hizo el pago, `cuentas_candidatas` sustituye a `cuenta_beneficiaria`: de 2 a 3 cuentas en una sola validación y con una sola unidad de cuota. La consulta recorre las candidatas en el orden enviado y adopta la primera que coincide con la transferencia; esa cuenta vuelve completa en `normalized_data.cuenta_beneficiaria` y su posición en `candidate_match`. Si ninguna coincide, la respuesta es un estado HTTP `422` con el motivo en `code`. Las dos formas no pueden enviarse juntas (`422 cuenta_y_candidatas_excluyentes`) y una lista que no cumple se rechaza con `422 cuentas_candidatas_invalidas`, las dos antes de consumir cuota.
+         *     Cuando no se sabe a cuál de varias cuentas se hizo el pago, `cuentas_candidatas` sustituye a `cuenta_beneficiaria`: de 2 cuentas al máximo que admite el servicio (3 de forma predeterminada) en una sola validación y con una sola unidad de cuota. La consulta recorre las candidatas en el orden enviado y adopta la primera que coincide con la transferencia; esa cuenta vuelve completa en `normalized_data.cuenta_beneficiaria` y su posición en `candidate_match`. Si ninguna coincide, la respuesta es un estado HTTP `422` con el motivo en `code`. Las dos formas no pueden enviarse juntas (`422 cuenta_y_candidatas_excluyentes`) y una lista que no cumple se rechaza con `422 cuentas_candidatas_invalidas`, las dos antes de consumir cuota.
          *
          *     El veredicto final (estado terminal) de una validación puede ser alguno de estos:
          *
@@ -139,7 +139,7 @@ export interface paths {
          *     El campo `cuenta_beneficiaria` permite enviar explícitamente la cuenta receptora de la transferencia, enviarlo es especialmente útil cuando la imagen no lleva este dato o lo lleva incompleto.\
          *     Un beneficiario guardado (con `POST /v1/beneficiaries`) no sustituye a este campo: solo sirve para completar los dígitos de la cuenta que la imagen sí muestra. Si la imagen no trae dígitos suficientes, la validación se rechaza con `cuenta_unresolvable`, porque las cuentas guardadas no se prueban una por una.\
          *     \
-         *     Cuando no se sabe cuál de varias cuentas recibió el pago, `cuentas_candidatas` las prueba en una sola validación (de 2 a 3 cuentas, una sola unidad de cuota, también con `?async=1`) y sustituye a `cuenta_beneficiaria`: enviar las dos se rechaza con `422 cuenta_y_candidatas_excluyentes`, y una lista que no cumple, con `422 cuentas_candidatas_invalidas`, las dos antes de consumir cuota. La lista tiene prioridad sobre la cuenta que se lea en la imagen; la ganadora vuelve completa en `normalized_data.cuenta_beneficiaria` y su posición en `candidate_match`. Si ninguna coincide, la respuesta es un estado HTTP `422` con el motivo en `code`.
+         *     Cuando no se sabe cuál de varias cuentas recibió el pago, `cuentas_candidatas` las prueba en una sola validación (de 2 cuentas al máximo que admite el servicio, 3 de forma predeterminada; una sola unidad de cuota, también con `?async=1`) y sustituye a `cuenta_beneficiaria`: enviar las dos se rechaza con `422 cuenta_y_candidatas_excluyentes`, y una lista que no cumple, con `422 cuentas_candidatas_invalidas`, las dos antes de consumir cuota. La lista tiene prioridad sobre la cuenta que se lea en la imagen; la ganadora vuelve completa en `normalized_data.cuenta_beneficiaria` y su posición en `candidate_match`. Si ninguna coincide, la respuesta es un estado HTTP `422` con el motivo en `code`.
          *
          *     {% /callout %}
          *
@@ -326,7 +326,7 @@ export interface paths {
         };
         /**
          * Descargar el CEP oficial
-         * @description Descarga el {% concept slug="cep-concept" %}Comprobante Electrónico de Pago (CEP){% /concept %} emitido por Banxico de una validación con veredicto `valid`.
+         * @description Descarga el {% concept slug="cep-concept" %}Comprobante Electrónico de Pago (CEP){% /concept %} emitido por Banxico de una validación con veredicto `valid`, o `returned` cuando el CEP se descargó antes de conocerse la devolución.
          *
          *     El formato predeterminado es `xml`; con `format=pdf` se solicita el documento en PDF.
          *
@@ -438,13 +438,13 @@ export interface paths {
          *     **No se admite en tres casos:**\
          *     — Validaciones que llegaron por importación masiva.\
          *     — Validaciones ya resueltas.\
-         *     — Validaciones fuera de la antigüedad que permite el plan.
+         *     — Validaciones con más de siete días de antigüedad.
          *
          *     {% /callout %}
          *
          *     Un ciclo de reintentos puede devolver `terminal_state="exhausted"` cuando se alcanzan el máximo de reintentos configurado. También puede devolver `terminal_state="cancelled"` cuando el usuario cancela manualmente los reintentos de la validación.
          *
-         *     En ambos casos, el ciclo puede reactivarse mientras conserve reintentos disponibles.
+         *     En ambos casos, el ciclo puede reactivarse hasta tres veces; pasado ese tope, la petición se rechaza con `422 reactivation_cap_exceeded`.
          *
          *     El estado completo de una validación se obtiene con `GET /v1/validations/{id}`, y los límites están descritos en {% concept slug="retry-policy" %}la política de reintentos{% /concept %}.
          */
@@ -668,6 +668,41 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/public/spei-calendar/{year}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Obtener el calendario de días inhábiles SPEI de un año
+         * @description Devuelve el calendario de días inhábiles SPEI de un año, con la disposición oficial de la que sale.
+         *
+         *     La respuesta incluye:
+         *
+         *     - `non_business_days`: Los días inhábiles que caen de lunes a viernes, en orden y con formato `YYYY-MM-DD`.
+         *     - `source`: La disposición de la **Comisión Nacional Bancaria y de Valores (CNBV)** publicada en el **Diario Oficial de la Federación (DOF)**, con su título y su fecha de publicación.
+         *
+         *     Los sábados y los domingos también son inhábiles, siempre, y no se repiten en `non_business_days`.
+         *
+         *     El calendario determina el día de operación de una transferencia. El SPEI opera todos los días, pero el día hábil cambia a las 18:00 (hora del centro de México): lo enviado a partir de esa hora, en sábado, en domingo o en un día inhábil opera el siguiente día hábil. Ese día es el `operationDate` de `banxico_result`, y puede diferir de la fecha de envío.
+         *
+         *     La consulta no consume cuota de validaciones. Un año sin calendario responde un estado HTTP `404` (con `spei_calendar_year_not_covered` en el cuerpo), y `meta.covered_years` lista los años disponibles. El calendario de cada año se añade cuando la CNBV publica su disposición, normalmente en diciembre del año anterior.
+         *
+         *     La respuesta es cacheable: incluye la cabecera `ETag`, que puede enviarse en otra petición como `If-None-Match`; si el calendario no ha cambiado, responde con un estado HTTP `304` (sin cuerpo).
+         *
+         *     La diferencia entre la fecha de envío y la de operación está en {% concept slug="timezone-handling" %}fechas y zona horaria{% /concept %}.
+         */
+        get: operations["getSpeiCalendar"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/beneficiaries/export": {
         parameters: {
             query?: never;
@@ -677,7 +712,7 @@ export interface paths {
         };
         /**
          * Exportar los beneficiarios de la cuenta de usuario
-         * @description Descarga las cuentas beneficiarias del usuario autenticado como archivo, usa el mismo filtro `with_archived` que `GET /v1/beneficiaries/list-beneficiaries`.
+         * @description Descarga las cuentas beneficiarias del usuario autenticado como archivo, usa el mismo filtro `with_archived` que `GET /v1/beneficiaries`.
          *
          *     El formato de descarga se elige con `?format` (`csv` por defecto, `xlsx` como alternativa). El tope de filas es de 100 000, y `?limit` sirve para pedir menos, nunca más.
          *
@@ -719,11 +754,11 @@ export interface paths {
          *     - Tarjeta (16 dígitos): `bank_code` es opcional, se deriva del BIN.
          *     - Celular/DiMo (10 dígitos): `bank_code` es **obligatorio** en el cuerpo, ya que el número por sí solo no identifica a la institución bancaria.
          *
-         *     Si la cuenta a registrar no existe previamente, se registra y responde con un estado HTTP `200`.
+         *     Si la cuenta a registrar no existe previamente, se registra y responde con un estado HTTP `201`.
          *
          *     Si se intenta registrar una cuenta activa, responde con un estado HTTP `422` (con `beneficiary_already_registered` en el cuerpo).
          *
-         *     Si existe pero está archivada, el alta la **reactiva** y responde con un estado HTTP `200` (con `meta.reactivated=true` en el cuerpo).
+         *     Si existe pero está archivada, el alta la **reactiva** y responde con un estado HTTP `200` (con `meta.reactivated=true` en el cuerpo). Si la petición no trae `label`, la reactivación conserva el alias que la cuenta ya tenía; si lo trae, lo reemplaza.
          */
         post: operations["createBeneficiary"];
         delete?: never;
@@ -745,10 +780,12 @@ export interface paths {
          * @description Actualiza un beneficiario ya registrado. El cuerpo admite la envoltura JSON:API o un objeto plano, y lo que se envíe determina el alcance del cambio:
          *
          *     - Solo `label`: Se guarda, sin tocar la cuenta.
-         *     - Un `account_number` nuevo, o el alias antiguo: vuelven a derivarse `account_type`, `bank_code` y `bank_name`. Si el nuevo número es un celular (phone), el cuerpo debe llevar `bank_code`.
-         *     - Solo `bank_code`: se aplica únicamente sobre un beneficiario de tipo celular. En una CLABE o una tarjeta el banco se deriva del número, así que el valor enviado se descarta sin error.
+         *     - Un `account_number` nuevo: vuelven a derivarse `account_type`, `bank_code` y `bank_name`. Si el nuevo número es un celular (phone), el cuerpo debe llevar `bank_code`.
+         *     - Solo `bank_code`: se aplica únicamente sobre un beneficiario de tipo celular. En una CLABE o una tarjeta el banco se deriva del número, así que el valor enviado se descarta sin error; si era el único campo, responde con `no_valid_fields`.
          *
          *     Un cuerpo sin ningún campo editable responde con un estado HTTP `422` (con `no_valid_fields` en el cuerpo).
+         *
+         *     Si el `account_number` nuevo ya está registrado para la misma cuenta de usuario, activo o archivado, responde con un estado HTTP `422` (con `beneficiary_already_registered` en el cuerpo) y el beneficiario no cambia.
          */
         put: operations["updateBeneficiary"];
         post?: never;
@@ -797,9 +834,9 @@ export interface paths {
         };
         /**
          * Descargar la plantilla de importación de beneficiarios
-         * @description Devuelve un **archivo plantilla para la importación de beneficiarios** en el formato solicitado, con encabezados en español o inglés y filas de ejemplo para CLABE, tarjeta y celular/DiMo. Sirve de punto de partida para {% concept slug="bulk-imports" %}la importación masiva{% /concept %}.
+         * @description Devuelve un **archivo plantilla para la importación de beneficiarios** en el formato solicitado, con los encabezados fijos `alias`, `cuenta` y `banco` y filas de ejemplo para CLABE, tarjeta y celular/DiMo. Sirve de punto de partida para {% concept slug="bulk-imports" %}la importación masiva{% /concept %}.
          *
-         *     El idioma de los encabezados se negocia con la cabecera `Accept-Language`; de forma predeterminada se entregan en español, acepta después encabezados en ambos idiomas de forma insensible a acentos.
+         *     Los encabezados no cambian con el idioma: la cabecera `Accept-Language` sólo elige el idioma de las filas de ejemplo y del nombre de la hoja; de forma predeterminada se entregan en español. La importación acepta después encabezados en ambos idiomas de forma insensible a acentos.
          */
         get: operations["downloadBeneficiaryImportTemplate"];
         put?: never;
@@ -821,7 +858,7 @@ export interface paths {
         put?: never;
         /**
          * Iniciar importación masiva de beneficiarios
-         * @description Sube un archivo (CSV, XLS, XLSX, TXT o PDF) de hasta 20 MB y abre con él un trabajo de importación.
+         * @description Sube un archivo (CSV, XLS, XLSX, TXT, JSON o PDF) de hasta 20 MB y abre con él un trabajo de importación.
          *     Las hojas XLSX/XLS admiten hasta 10 000 filas y 64 columnas. Las fórmulas XLSX se leen como texto, sin ejecutarlas. Los PDF admiten hasta 50 páginas y limitan a 8 MiB la descompresión de cada flujo.
          *
          *     El modo de lectura decide cuánto trabajo hace el archivo y cuánto el servidor:
@@ -891,7 +928,7 @@ export interface paths {
          * Previsualizar las filas extraídas de la importación
          * @description Devuelve las filas extraídas del archivo en un trabajo de importación (paginadas y filtrables por grupo).
          *
-         *     Disponible solo cuando la importación está en `preview_ready` o estados posteriores con `total_rows>0`.
+         *     Responde en cualquier estado del trabajo; antes de `preview_ready` la lista sale vacía.
          *
          *     {% callout type="warning" %}
          *     En este endpoint los datos de CLABEs, tarjetas o celulares NO son enmascarados. Se presume que el usuario solicitante de la importación ya tiene en su poder dichos datos, por lo que no hay motivos para tratarlos bajo nuestra política de {% concept slug="pii-masking" %}enmascarado de datos{% /concept %}
@@ -972,8 +1009,8 @@ export interface paths {
          *
          *     Reglas de la confirmación:
          *
-         *     - Filas `valid` y `correctable`: Se persisten (con sufijo de alias si hubo colisión de alias).
-         *     - Filas `fatal` y `duplicate_account`: Se omiten.
+         *     - Filas `valid` y `correctable`: Se persisten (con sufijo de alias si hubo colisión de alias). La excepción es un celular sin banco válido (`bank_code_required_for_phone` o `invalid_bank_code`): se corrige eligiendo el banco en la vista previa, y si al confirmar sigue sin banco no se guarda, queda como `fatal` con ese mismo código y cuenta en `skipped_count`.
+         *     - Filas `fatal` y `duplicate_account`: Se omiten, salvo una `duplicate_account` cuya cuenta está archivada, que se reactiva.
          *     - Cuentas previamente archivadas con el mismo número: Se reactivan en lugar de duplicarse.
          */
         post: operations["commitBeneficiaryImport"];
@@ -1022,9 +1059,9 @@ export interface paths {
          * Obtener métricas de uso de la API
          * @description Devuelve las métricas de uso de la API del usuario autenticado:
          *
-         *     - Peticiones a la API hoy y en el mes.
+         *     - Peticiones con clave de API hoy y en el mes.
          *     - Cuota del plan vigente.
-         *     - Últimas peticiones a la API.
+         *     - Últimas 15 peticiones con clave de API.
          *     - Validaciones consumidas por mes.
          *     - Estado actual del servicio Banxico CEP.
          */
@@ -1048,7 +1085,7 @@ export interface paths {
          * Obtener el resumen del panel
          * @description Devuelve los contadores agregados del usuario: el total histórico, el total
          *     del mes UTC en curso, las validaciones con veredicto `valid`, el contador
-         *     mensual de los estados `pending` y `processing`, el monto promedio y la
+         *     mensual de los estados `queued` y `processing`, el monto promedio y la
          *     tasa de éxito. Incluye también la cantidad de beneficiarios activos.
          *
          *     `relationships.recent_validations` contiene las validaciones no retiradas
@@ -1136,7 +1173,10 @@ export interface paths {
          *     - `degraded`: Problemas parciales — latencia elevada o errores
          *       intermitentes.
          *     - `down`: El servicio es por el momento inaccesible.
-         *     - `unknown`: Aún no hay datos de chequeos de salud disponibles.
+         *     - `unknown`: No hay datos de salud vigentes: aún no se ha ejecutado ningún
+         *       chequeo, o el último es más viejo que tres veces `check_interval_seconds`
+         *       porque el chequeo automático dejó de correr. En ese caso `last_verified_at`
+         *       conserva la fecha de ese último chequeo.
          *
          *     La respuesta se cachea 60 segundos en el cliente con `Cache-Control`, y ese
          *     plazo se configura en el despliegue. Cualquier usuario autenticado puede
@@ -1229,7 +1269,7 @@ export interface paths {
          *
          *     Cada endpoint puede suscribirse a diferentes eventos, entre ellos:
          *
-         *     - Eventos `validation.*`: Esperan cualquier estado terminal de una validación para notificar ese estado mediante el webhook (p. ej: `validation.completed`, `validation.error`, etc).
+         *     - Eventos `validation.*`: Avisan de cada veredicto de una validación y de cada paso de sus reintentos automáticos (p. ej: `validation.completed`, `validation.error`, etc).
          *     - Evento `validation.returned`: avisa cuando una validación que ya había salido `valid` pasa después a `returned` porque Banxico reportó la devolución; no se emite al crear la validación, donde el evento es `validation.completed`. Para recibirlo hay que suscribirse a él además de a `validation.completed`.
          *     - Eventos `billing.*`: No producen entregas hasta que haya algún movimiento en la suscripción del usuario (p. ej: `billing.subscription_canceled`, `billing.payment_succeeded`, cuotas de uso, etc).
          *
@@ -1403,7 +1443,7 @@ export interface paths {
          * Listar entregas de todos los endpoints webhook
          * @description Devuelve una vista consolidada de las entregas hechas a los endpoints webhook del usuario autenticado.
          *
-         *     Se puede filtrar por endpoint, estado y tipo de evento.
+         *     Se puede buscar por texto con `q` y filtrar por endpoint, estado, tipo de evento, validación, código HTTP, rango de fechas, número de intento y tiempo de respuesta.
          */
         get: operations["listAllDeliveries"];
         put?: never;
@@ -1424,8 +1464,7 @@ export interface paths {
         /**
          * Exportar todas las entregas webhook como CSV o XLSX
          * @description Descarga el historial de entregas de **todos** los endpoints de la cuenta de usuario en
-         *     un archivo, con los mismos filtros que el listado: endpoint, estado y tipo de
-         *     evento.
+         *     un archivo, con los mismos filtros y la misma búsqueda (`q`) que el listado.
          *
          *     {% concept slug="exports-and-formats" %}El formato se elige{% /concept %} con `?format` —`csv` por defecto, `xlsx` como
          *     alternativa— y el tope es de 100 000 filas, que `?limit` puede bajar.
@@ -1556,8 +1595,9 @@ export interface paths {
         };
         /**
          * Consultar índices de consumo mes a mes
-         * @description Devuelve el consumo mensual de validaciones del usuario autenticado en los
-         *     últimos `months` meses, de más reciente a más antiguo.
+         * @description Devuelve el consumo mensual de validaciones del usuario autenticado en hasta
+         *     `months` meses con consumo, de más reciente a más antiguo. Los meses sin
+         *     consumo no aparecen.
          *
          *     {% callout type="warning" %}
          *     El límite que acompaña a cada fila es el de hoy, no el que regía aquel mes:
@@ -1582,7 +1622,7 @@ export interface paths {
         };
         /**
          * Desglosar consumo por operación
-         * @description Desglosa el consumo del periodo indicado por tipo de operación contabilizada (`validation`, `validation_ocr`, etc.).
+         * @description Desglosa el consumo del periodo indicado por tipo de operación contabilizada (`validation` y `sms_2fa`).
          *
          *     El parámetro `period` acepta `current` para el mes en curso o una cadena `YYYY-MM` para un mes específico.
          */
@@ -2090,7 +2130,7 @@ export interface components {
                 api_version?: string;
                 /**
                  * @description Identificador único de la petición (hex).
-                 * @example a1b2c3d4e5f6
+                 * @example a1b2c3d4e5f66f5e4d3c2b1a
                  */
                 request_id?: string;
                 datetime?: components["schemas"]["DatetimeMeta"];
@@ -2114,8 +2154,8 @@ export interface components {
                  */
                 version?: string;
                 /**
-                 * @description Identificador único de la petición (UUID hex).
-                 * @example a1b2c3d4e5f6
+                 * @description Identificador único de la petición (24 caracteres hex).
+                 * @example a1b2c3d4e5f66f5e4d3c2b1a
                  */
                 request_id?: string;
             };
@@ -2138,7 +2178,7 @@ export interface components {
                 api_version?: string;
                 /**
                  * @description Identificador único de la petición (hex).
-                 * @example a1b2c3d4e5f6
+                 * @example a1b2c3d4e5f66f5e4d3c2b1a
                  */
                 request_id?: string;
                 datetime?: components["schemas"]["DatetimeMeta"];
@@ -2186,17 +2226,17 @@ export interface components {
              */
             name?: string;
             /**
-             * @description Rol de la cuenta de usuario en la organización. Decide qué permisos tienen sus sesiones — `owner`: Es la titular; `admin`: La administra; `user`: La usa; `viewer`: Solo lee.
+             * @description Rol de la cuenta de usuario en la organización. Decide qué permisos tienen sus sesiones — `owner`: Es la titular; `admin`: La administra; `user`: La usa.
              * @example user
              * @enum {string}
              */
-            role?: "owner" | "admin" | "user" | "viewer";
+            role?: "owner" | "admin" | "user";
             /**
-             * @description Estado de la cuenta de usuario — `active`: Permite operar con normalidad; `suspended`: Cuenta suspendida; `pending_verification`: Falta verificación de correo electrónico.
+             * @description Estado de la cuenta de usuario — `active`: Permite operar con normalidad; `suspended`: Cuenta suspendida; `revoked`: Eliminada por el usuario.
              * @example active
              * @enum {string}
              */
-            status?: "active" | "suspended" | "pending_verification";
+            status?: "active" | "suspended" | "revoked";
             /**
              * @description Zona horaria IANA con la que se presentan las fechas al usuario.
              * @example America/Mexico_City
@@ -2224,7 +2264,7 @@ export interface components {
             api_key?: {
                 /**
                  * @description Primeros 8 caracteres de la clave de API.
-                 * @example veriko_a1b2
+                 * @example veriko_
                  */
                 prefix?: string;
                 /**
@@ -2278,7 +2318,7 @@ export interface components {
                  */
                 enabled?: boolean;
                 /**
-                 * @description Canal por el que se entrega el código de autenticación (OTP) — `sms`: Por mensaje de texto; `email`: Por correo electrónico; `null`: La autenticación de 2 factores (2FA) está desactivada.
+                 * @description Canal por el que se entrega el código de autenticación (OTP) — `sms`: Por mensaje de texto; `email`: Por correo electrónico; `null`: La cuenta de usuario nunca lo ha configurado. Al desactivar la 2FA se conserva el último canal usado.
                  * @example sms
                  * @enum {string|null}
                  */
@@ -2311,7 +2351,7 @@ export interface components {
                 telegram_linked?: boolean;
             };
             /**
-             * @description `true` cuando hay una aceptación vigente de los Términos de Servicio y el Aviso de Privacidad (ambos documentos). `false` cuando falta cualquiera de los dos, o cuando quedó antes de `LEGAL_REACCEPT_SINCE` (vacía por defecto). Gatea el modal de consentimiento post-login.
+             * @description `true` cuando no queda pendiente la aceptación de ningún documento: ni los Términos de Servicio ni el Aviso de Privacidad. `false` cuando falta la aceptación de cualquiera de los dos, o cuando el equipo exigió aceptar una versión que la cuenta todavía no ha aceptado. Gatea el modal de consentimiento post-login, que lista lo pendiente en `GET /users/me/legal/pending`.
              * @example true
              */
             legal_accepted?: boolean;
@@ -2354,7 +2394,7 @@ export interface components {
         ValidationRequest: ({
             /**
              * Format: date
-             * @description Fecha de la transferencia en formato ISO 8601 (YYYY-MM-DD).
+             * @description Fecha de envío de la transferencia en formato ISO 8601 (YYYY-MM-DD). Con ella Banxico localiza el CEP, y puede diferir del día de operación que el CEP imprime (`banxico_result.operationDate`).
              * @example 2025-03-15
              */
             fecha: string;
@@ -2365,12 +2405,12 @@ export interface components {
              */
             monto: number;
             /**
-             * @description Clave de rastreo de la transferencia (entre 1 a 30 caracteres). Acepta letras, números, guiones, diagonales y espacios. Se recorta y se le quitan caracteres invisibles de ancho cero antes de validarse, para que la misma clave copiada y pegada compare igual en toda la plataforma. Requerida si `referencia_numerica` no es enviada; ambas pueden incluirse simultáneamente para mayor precisión de búsqueda.
+             * @description Clave de rastreo de la transferencia (entre 1 a 30 caracteres). Acepta letras, números, espacios y los signos de puntuación que admite Banxico (como guiones, diagonales, puntos, comas, `#`, `@` o `_`), pero no `<`, `>` ni la barra invertida. Se recorta y se le quitan caracteres invisibles de ancho cero antes de validarse, para que la misma clave copiada y pegada compare igual en toda la plataforma. Requerida si `referencia_numerica` no es enviada. Si vienen las dos, la consulta a Banxico se hace sólo por la clave.
              * @example MXBA20250315001234
              */
             clave_rastreo?: string;
             /**
-             * @description Referencia numérica de la transferencia (entre 1 y 7 dígitos). Acepta solo números y espacios. Requerida si `clave_rastreo` no es enviada; ambas pueden incluirse simultáneamente para mayor precisión de búsqueda.
+             * @description Referencia numérica de la transferencia (entre 1 y 7 dígitos). Acepta solo números y espacios. Requerida si `clave_rastreo` no es enviada. Si viene `clave_rastreo`, la consulta se hace sólo por la clave, y una referencia mal formada no se rechaza: se ignora y se deja un aviso.
              * @example 1234567
              */
             referencia_numerica?: string;
@@ -2416,15 +2456,12 @@ export interface components {
              */
             client_ref?: string;
         } & (unknown | unknown)) | unknown | unknown;
-        /**
-         * @description Código estable del fallo de una validación.
-         * @enum {string}
-         */
-        ValidationErrorCode: "network" | "captcha" | "max_retries_exceeded" | "ttl_expired" | "preflight_failed" | "rate_limit_exhausted" | "dispatch_failed" | "bank_code_unresolvable_for_phone" | "intra_bank_no_cep" | "not_found_identity" | "not_found_account" | "not_found_amount" | "not_found_account_and_amount" | "not_found_account_or_amount";
+        /** @description Código estable del fallo de una validación. La lista no es cerrada: un fallo inesperado trae `internal_error` y otros fallos pueden traer el código de su causa, así que trata un valor desconocido como un fallo genérico. */
+        ValidationErrorCode: string | ("network" | "captcha" | "max_retries_exceeded" | "ttl_expired" | "preflight_failed" | "rate_limit_exhausted" | "dispatch_failed" | "bank_code_unresolvable_for_phone" | "intra_bank_no_cep" | "not_found_identity" | "not_found_account" | "not_found_amount" | "not_found_account_and_amount" | "not_found_account_or_amount" | "internal_error");
         /** @description Estado completo del ciclo de reintentos, con configuración, avance y situación actual. */
         RetryStateFull: {
             /**
-             * @description `true` cuando existe un ciclo de reintentos activo.
+             * @description `true` cuando la validación tiene reintentos configurados, aunque su ciclo ya haya terminado (`terminal_state`).
              * @example true
              */
             enabled?: boolean;
@@ -2510,7 +2547,7 @@ export interface components {
                  * @example 1320
                  */
                 processing_time_ms?: number | null;
-                /** @description Copia de los campos de la petición original. */
+                /** @description Copia de los campos de la petición original. `fecha` conserva la fecha de envío tal como se envió, aunque Banxico haya encontrado el pago con otra (`banxico_result._fecha`). */
                 request_data?: {
                     [key: string]: unknown;
                 };
@@ -2545,7 +2582,7 @@ export interface components {
                 processing_started_at?: string | null;
                 /**
                  * Format: date-time
-                 * @description Fecha y hora, en ISO 8601 UTC, de expiración para validaciones en cola. Tras esta marca, la validación pasa a `failed`.
+                 * @description Fecha y hora, en ISO 8601 UTC, de expiración para validaciones en cola. Tras esta marca, la validación pasa a `error` con `error_code` `ttl_expired`.
                  * @example 2026-04-30T10:15:00Z
                  */
                 expires_at?: string | null;
@@ -2556,7 +2593,7 @@ export interface components {
                 etag_version?: number | null;
                 /**
                  * @description Referencia relativa del comprobante, imagen o PDF (solo si `validation_type` es del tipo `ocr`). No se publica cuando el archivo no se conserva: ver `image_retained`.
-                 * @example ocr/2026/04/a1b2c3d4.jpg
+                 * @example comprobantes/3fa85f64-5717-4562-b3fc-2c963f66afa6.jpg
                  */
                 image_path?: string | null;
                 /**
@@ -2589,7 +2626,7 @@ export interface components {
                  * @example 0.94
                  */
                 ocr_confidence?: number | null;
-                /** @description Campos normalizados después de la extracción OCR (solo si `validation_type` es del tipo `ocr`). */
+                /** @description Campos normalizados después de la extracción OCR (si `validation_type` es del tipo `ocr`), o la cuenta ganadora en `cuenta_beneficiaria` cuando una validación directa envió `cuentas_candidatas`. Una lápida conserva aquí solo el monto. */
                 normalized_data?: {
                     [key: string]: unknown;
                 } | null;
@@ -2615,9 +2652,9 @@ export interface components {
                     created_at: string;
                 };
                 /**
-                 * @description Conflicto entre la cuenta enviada y la que muestra la imagen. Solo aparece en validaciones de tipo `ocr`, cuando se envió `cuenta_beneficiaria` y la imagen muestra otra cuenta completa de la misma longitud, válida y con confianza suficiente.
+                 * @description Conflicto entre la cuenta enviada y la que muestra la imagen. Solo aparece en validaciones de tipo `ocr`, cuando se envió `cuenta_beneficiaria` y la imagen muestra otra cuenta completa de la misma longitud, válida y con confianza suficiente, o una cuenta enmascarada cuyos dígitos finales visibles (3 o más) no son el final de la cuenta enviada.
                  *
-                 *     Prevalece la cuenta enviada, que es la que se consulta en Banxico: el campo no cambia el veredicto. Si el pago fue a la cuenta de la imagen, lo esperable es un `not_found`. Solo trae los últimos 4 dígitos de cada cuenta, y el conflicto también se añade a `normalization_warnings`.
+                 *     Prevalece la cuenta enviada, que es la que se consulta en Banxico: el campo no cambia el veredicto. Si el pago fue a la cuenta de la imagen, lo esperable es un `not_found`. Solo trae los últimos 4 dígitos de cada cuenta, y el conflicto también se añade a `normalization_warnings`. Con una cuenta enmascarada, `read_last4` trae los dígitos finales que el propio comprobante muestra (3 o 4), nunca más.
                  */
                 account_conflict?: {
                     /**
@@ -2626,7 +2663,7 @@ export interface components {
                      */
                     sent_last4: string;
                     /**
-                     * @description Últimos 4 dígitos de la cuenta completa que muestra la imagen.
+                     * @description Últimos 4 dígitos de la cuenta que muestra la imagen (los visibles, 3 o 4, si está enmascarada).
                      * @example 9012
                      */
                     read_last4: string;
@@ -2665,15 +2702,26 @@ export interface components {
                  *     `label`, `settled`, `reversed` y `checked_at` (ISO 8601 UTC).
                  *     Su ausencia significa que no se pudo saber, nunca que el pago esté liquidado.
                  *     Se actualiza en cada revisión posterior, y con `devuelto` o `en_proceso_devolucion` la validación pasa a `returned`.
+                 *
+                 *     `_fecha` aparece cuando Banxico no encontró el pago con la fecha enviada y sí con otra.
+                 *     `used` es la fecha con la que se encontró, `requested` es la fecha con la que se consultó primero
+                 *     y `reason` es el motivo por el que se probó `used`.
+                 *     Valores de `reason`:
+                 *     `clave_embedded_date`: La clave de rastreo incrusta otra fecha, a un día hábil SPEI o menos de la enviada;
+                 *     `cutoff_18h`: La clave no incrusta fecha y el comprobante indica una hora cercana al corte de las 18:00,
+                 *     así que se probó el día siguiente;
+                 *     `dia_operacion`: La clave incrusta la fecha enviada, porque el comprobante trae la de operación,
+                 *     y se probó un día anterior hasta el día hábil previo.
+                 *     El veredicto sigue siendo el de Banxico, y `request_data.fecha` conserva la fecha enviada.
                  */
                 banxico_result?: ({
                     /**
-                     * @description Fecha de la operación tal como la reporta el CEP de Banxico (`AAAA-MM-DD`).
+                     * @description Día hábil SPEI que Banxico asignó a la operación, tal como lo reporta el CEP (`YYYY-MM-DD`), en hora del centro de México. Puede diferir de la fecha de envío: lo enviado a partir de las 18:00, en sábado, en domingo o en un día inhábil opera el siguiente día hábil.
                      * @example 2025-03-15
                      */
                     operationDate?: string;
                     /**
-                     * @description Hora de la operación tal como la reporta el CEP de Banxico (`HH:MM:SS`).
+                     * @description Hora de la operación tal como la reporta el CEP (`HH:MM:SS`), en hora del centro de México y no en UTC.
                      * @example 14:22:10
                      */
                     processingTime?: string;
@@ -2764,13 +2812,13 @@ export interface components {
                  */
                 self?: string;
                 /**
-                 * @description URL del CEP en formato XML. `null` cuando `status` no es `valid`, o es `returned` sin comprobante (la operación se devolvió antes de emitirse un CEP).
-                 * @example /v1/validations/a1b2c3d4-e5f6-7890-abcd-ef0123456789/cep.xml
+                 * @description URL del CEP en formato XML. Solo aparece cuando `banxico_status` es `valid`, o es `returned` con comprobante, y la validación no se purgó; si no, se omite el objeto `links`.
+                 * @example /v1/validations/a1b2c3d4-e5f6-4890-abcd-ef0123456789/cep?format=xml
                  */
                 cep_xml?: string | null;
                 /**
-                 * @description URL del CEP en formato PDF. `null` cuando `status` no es `valid`, o es `returned` sin comprobante (la operación se devolvió antes de emitirse un CEP).
-                 * @example /v1/validations/a1b2c3d4-e5f6-7890-abcd-ef0123456789/cep.pdf
+                 * @description URL del CEP en formato PDF. Solo aparece cuando `banxico_status` es `valid`, o es `returned` con comprobante, y la validación no se purgó; si no, se omite el objeto `links`.
+                 * @example /v1/validations/a1b2c3d4-e5f6-4890-abcd-ef0123456789/cep?format=pdf
                  */
                 cep_pdf?: string | null;
             };
@@ -2839,13 +2887,13 @@ export interface components {
         OcrValidationRequest: {
             /**
              * Format: byte
-             * @description Comprobante codificado en base64, en imagen o en PDF. Si también se proporciona `image_url`, solo se considera `image`. Formatos aceptados: JPEG, PNG, WebP o PDF de 1 a 3 páginas. Tamaño máximo: `12 MB`. Dimensiones máximas de una imagen: `12000px` por lado. Admite el prefijo `data:image/...;base64,` o `data:application/pdf;base64,`.
+             * @description Comprobante codificado en base64, en imagen o en PDF. Si también se proporciona `image_url`, solo se considera `image_url`. Formatos aceptados: JPEG, PNG, WebP o PDF de 1 a 3 páginas. Tamaño máximo: `12 MB`. Dimensiones máximas de una imagen: `12000px` por lado. Admite el prefijo `data:image/...;base64,` o `data:application/pdf;base64,`.
              * @example iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==
              */
             image?: string;
             /**
              * Format: uri
-             * @description URL pública (HTTPS) del comprobante. Sigue los mismos límites de formato y tamaño que `image`: JPEG, PNG, WebP o PDF de 1 a 3 páginas, con un máximo de `12 MB`.
+             * @description URL pública (HTTPS) del comprobante. Sigue los mismos límites de formato y tamaño que `image`: JPEG, PNG, WebP o PDF de 1 a 3 páginas, con un máximo de `12 MB`. Una URL `http` responde un estado HTTP `422` (con `invalid_url_scheme` en el cuerpo), y una redirección hacia `http` no se sigue.
              * @example https://storage.example.com/receipts/comprobante-2025-03.jpg
              */
             image_url?: string;
@@ -2866,6 +2914,16 @@ export interface components {
              *     ]
              */
             cuentas_candidatas?: string[];
+            /**
+             * @description **Código SPEI** del banco emisor (4 o 5 dígitos, p. ej. `40012`), para corregir el que se leyó del comprobante. Sustituye al leído antes de consultar Banxico. Un valor que no son 4 o 5 dígitos (un nombre, por ejemplo) se ignora y se conserva el leído.
+             * @example 40012
+             */
+            banco_emisor?: string;
+            /**
+             * @description **Código SPEI** del banco receptor (4 o 5 dígitos, p. ej. `40002`), para corregir el que se leyó del comprobante. Sustituye al leído antes de consultar Banxico. Un valor que no son 4 o 5 dígitos (un nombre, por ejemplo) se ignora y se conserva el leído.
+             * @example 40002
+             */
+            banco_receptor?: string;
             /** @description Política de reintentos automáticos para esta validación. Si se omite, se aplica la política general del usuario, configurada en `PUT /v1/users/me/retry-policy`. **Los reintentos no consumen cuota de validaciones**. */
             retry_policy?: components["schemas"]["RetryPolicy"];
             /**
@@ -2887,7 +2945,7 @@ export interface components {
         /** @description Estado resumido del ciclo de reintentos, con la configuración representada como `null`. */
         RetryStateCompact: {
             /**
-             * @description `true` cuando existe un ciclo de reintentos activo.
+             * @description `true` cuando la validación tiene reintentos configurados, aunque su ciclo ya haya terminado (`terminal_state`).
              * @example true
              */
             enabled?: boolean;
@@ -2934,7 +2992,7 @@ export interface components {
             id: string;
             /** @description Datos mostrados en el historial de validaciones. */
             attributes: {
-                /** @description Nombre del banco de la contraparte. Prioriza `receptor_name` o `emisor_name` guardado; si falta, intenta resolver el código de receptor o emisor. Si tampoco puede resolverlo, devuelve ese código o `Banco no identificado`. */
+                /** @description Nombre del banco de la contraparte. Prioriza `receptor_name` o `emisor_name` guardado; si falta, intenta resolver el código de receptor o emisor. Si tampoco puede resolverlo, devuelve el valor guardado cuando no es una clave numérica, o `Banco no identificado` (en inglés, `Unidentified bank`). */
                 bank_name?: string;
                 /** @description Clave Banxico canónica (3-5 dígitos) del banco de la contraparte, resuelta por la autoridad del dominio. `null` cuando el banco no pudo resolverse. Es aditiva respecto de `bank_name`: sirve para resolver recursos/avatares por clave, nunca por el nombre visible. */
                 bank_code?: string | null;
@@ -3425,7 +3483,7 @@ export interface components {
                  */
                 bin: string;
                 /**
-                 * @description Nombre oficial del banco, resuelto a partir de su `bank_code`.
+                 * @description Nombre del banco registrado para ese BIN.
                  * @example BBVA MEXICO
                  */
                 bank_name: string;
@@ -3460,6 +3518,84 @@ export interface components {
         BinLookupResponse: components["schemas"]["SuccessEnvelope"] & {
             data: components["schemas"]["BinResource"];
         };
+        /** @description Calendario de días inhábiles SPEI de un año, en formato JSON:API. `id` y `attributes.year` son siempre iguales: el año del calendario. */
+        SpeiCalendarResource: components["schemas"]["JsonApiResourceBase"] & {
+            /**
+             * @description Tipo de recurso JSON:API. Siempre `spei_calendar`.
+             * @example spei_calendar
+             * @enum {string}
+             */
+            type: "spei_calendar";
+            /**
+             * @description Año del calendario (cuatro dígitos).
+             * @example 2026
+             */
+            id: string;
+            /** @description Datos del calendario del año. */
+            attributes: {
+                /**
+                 * @description Año del calendario (cuatro dígitos). Mismo valor que `id`.
+                 * @example 2026
+                 */
+                year: number;
+                /**
+                 * @description Días inhábiles que caen de lunes a viernes (`YYYY-MM-DD`), de menor a mayor. Los sábados y los domingos también son inhábiles y no se repiten aquí.
+                 * @example [
+                 *       "2026-01-01",
+                 *       "2026-02-02",
+                 *       "2026-03-16",
+                 *       "2026-04-02",
+                 *       "2026-04-03",
+                 *       "2026-05-01",
+                 *       "2026-09-16",
+                 *       "2026-11-02",
+                 *       "2026-11-16",
+                 *       "2026-12-25"
+                 *     ]
+                 */
+                non_business_days: string[];
+                /** @description Disposición oficial de la que sale el calendario. */
+                source: {
+                    /**
+                     * @description Siglas de la autoridad que emite la disposición, por ejemplo `CNBV`.
+                     * @example CNBV
+                     */
+                    issuer: string;
+                    /**
+                     * @description Siglas del medio oficial en el que se publicó la disposición, por ejemplo `DOF`.
+                     * @example DOF
+                     */
+                    published_in: string;
+                    /**
+                     * Format: date
+                     * @description Fecha de publicación de la disposición (`YYYY-MM-DD`).
+                     * @example 2025-12-10
+                     */
+                    published_on: string;
+                    /**
+                     * @description Título oficial de la disposición, en español.
+                     * @example Disposiciones de carácter general que señalan los días del año 2026 en que las entidades financieras sujetas a la supervisión de la Comisión Nacional Bancaria y de Valores deberán cerrar sus puertas y suspender operaciones
+                     */
+                    title: string;
+                };
+            };
+        };
+        /** @description Respuesta de `GET /v1/public/spei-calendar/{year}`. Un único recurso con los días inhábiles SPEI del año y su fuente, y en `meta.covered_years` los años que tienen calendario. Un año sin calendario responde `404`, no este cuerpo. */
+        SpeiCalendarResponse: components["schemas"]["SuccessEnvelope"] & {
+            data: components["schemas"]["SpeiCalendarResource"];
+            /** @description Metadatos de la respuesta. */
+            meta?: {
+                /**
+                 * @description Años con calendario publicado, de menor a mayor.
+                 * @example [
+                 *       2024,
+                 *       2025,
+                 *       2026
+                 *     ]
+                 */
+                covered_years?: number[];
+            };
+        };
         /** @description Cupo de beneficiarios activos del plan y ocupación actual de la cuenta autenticada. */
         BeneficiaryCapacity: {
             /** @description Tope de beneficiarios activos. `-1` significa sin tope. */
@@ -3498,12 +3634,12 @@ export interface components {
                  */
                 account_type: "clabe" | "card" | "phone";
                 /**
-                 * @description Código SPEI (5 dígitos) del banco resuelto.
+                 * @description Código SPEI (5 dígitos) del banco resuelto. Es la cadena vacía (`""`) cuando la cuenta no tiene un banco conocido: una tarjeta cuyo BIN no está en el directorio. En ese caso `bank_name` trae un texto de relleno en el idioma de la petición.
                  * @example 40012
                  */
                 bank_code: string;
                 /**
-                 * @description Nombre oficial del banco, resuelto a partir de su `bank_code`.
+                 * @description Nombre oficial del banco, resuelto a partir de su `bank_code`. Con un `bank_code` vacío es un texto de relleno («BIN no reconocido (411111)»), que se traduce al idioma de la petición.
                  * @example BBVA MEXICO
                  */
                 bank_name: string;
@@ -3556,6 +3692,14 @@ export interface components {
         /** @description Respuesta de `POST /v1/beneficiaries` con el beneficiario en `data`. Devuelve `201` al crear un registro nuevo, y `200` cuando reactiva una cuenta archivada con el mismo `account_number`: Ahí `meta.reactivated` viene en `true`. */
         CreateBeneficiaryResponse: components["schemas"]["SuccessEnvelope"] & {
             data: components["schemas"]["Beneficiary"];
+            /** @description Metadatos del alta. */
+            meta?: {
+                /**
+                 * @description `true` cuando el alta reactivó una cuenta archivada con el mismo `account_number` y la respuesta es `200`. Un alta nueva (`201`) no lo incluye.
+                 * @example true
+                 */
+                reactivated?: boolean;
+            };
         };
         /** @description Cuerpo de `PUT /v1/beneficiaries/{id}`. Acepta envoltorio JSON:API `{ data: { attributes: {...} } }` o un objeto plano. Todos los campos son opcionales — solo se actualizan los presentes. Si el cuerpo no contiene ningún campo editable, el servidor responde `422 no_valid_fields`. Hay tres rutas de actualización. Con solo `label`, se sanea y se guarda. Con un `account_number` nuevo, se vuelven a derivar `account_type`, `bank_code` y `bank_name` con las mismas reglas que `POST /v1/beneficiaries`. Con solo `bank_code`, el cambio vale únicamente si el beneficiario es de tipo `phone`: En CLABE y tarjeta se ignora sin avisar—, y deja el evento de auditoría `beneficiary.phone_bank_updated` cuando el código cambia. */
         UpdateBeneficiaryRequest: {
@@ -3601,7 +3745,7 @@ export interface components {
                  */
                 account_type: "clabe" | "card" | "phone";
                 /**
-                 * @description Código SPEI (5 dígitos) del banco resuelto.
+                 * @description Código SPEI (5 dígitos) del banco resuelto. Es la cadena vacía (`""`) para una tarjeta cuyo BIN no está en el directorio.
                  * @example 40012
                  */
                 bank_code: string;
@@ -3625,12 +3769,13 @@ export interface components {
         CreateBeneficiaryImportRequest: {
             /**
              * Format: binary
-             * @description Archivo a importar. Formatos aceptados: CSV, XLS, XLSX, TXT o PDF. Tamaño máximo: 20 MB.
+             * @description Archivo a importar. Formatos aceptados: CSV, XLS, XLSX, TXT, JSON o PDF. Tamaño máximo: 20 MB.
              * @example beneficiarios-marzo.csv
              */
             file: string;
             /**
              * @description Modo de lectura del archivo — `template`: Respeta los encabezados canónicos; `free`: Formato libre, el sistema deduce la estructura.
+             * @default template
              * @example template
              * @enum {string}
              */
@@ -3686,11 +3831,11 @@ export interface components {
                  */
                 status?: "pending" | "parsing" | "preview_ready" | "committing" | "completed" | "failed" | "cancelled";
                 /**
-                 * @description Formato del archivo subido. Aceptados: `csv`, `xls`, `xlsx`, `txt` o `pdf`.
+                 * @description Formato del archivo subido. Aceptados: `csv`, `xls`, `xlsx`, `txt`, `json` o `pdf`.
                  * @example csv
                  * @enum {string}
                  */
-                file_format?: "csv" | "xls" | "xlsx" | "txt" | "pdf";
+                file_format?: "csv" | "xls" | "xlsx" | "txt" | "json" | "pdf";
                 /**
                  * @description Modo de lectura del archivo — `template`: Respeta los encabezados canónicos; `free`: Formato libre, el sistema deduce la estructura.
                  * @example template
@@ -3738,7 +3883,7 @@ export interface components {
                  */
                 llm_invoked?: boolean;
                 /**
-                 * @description Código estable del fallo del trabajo. `null` cuando no terminó en `failed`. Por ejemplo, `file_corrupt` o `plan_cap_exceeded`.
+                 * @description Código estable del fallo del trabajo. `null` cuando no terminó en `failed`. Por ejemplo, `file_corrupt` o `empty_file`.
                  * @example null
                  */
                 error_code?: string | null;
@@ -3844,7 +3989,7 @@ export interface components {
                     [key: string]: unknown;
                 };
                 /**
-                 * @description Fragmento del archivo original para diagnóstico. Los dígitos de 6 o más caracteres consecutivos aparecen enmascarados (`••••`) para evitar exposición de números de tarjeta en los cuerpos de depuración.
+                 * @description Fragmento del archivo original para diagnóstico. Las series de 13 a 19 dígitos que no son una CLABE (18 dígitos) aparecen enmascaradas (`••••` y los últimos cuatro), igual que un número de celular de 10 dígitos cuando lo precede una etiqueta como «cuenta» o «celular», para evitar exposición de números de tarjeta en los cuerpos de depuración.
                  * @example {}
                  */
                 raw_preview?: {
@@ -3981,17 +4126,17 @@ export interface components {
         /** @description Estadísticas de uso de la API, cuota de validaciones y estado de Banxico para la cuenta. */
         ApiUsage: {
             /**
-             * @description Cantidad de peticiones a la API del usuario en el día calendario actual (UTC).
+             * @description Cantidad de peticiones del usuario con clave de API en el día calendario actual (UTC).
              * @example 42
              */
             requests_today?: number;
             /**
-             * @description Cantidad de peticiones a la API del usuario en el mes calendario actual (UTC).
+             * @description Cantidad de peticiones del usuario con clave de API en el mes calendario actual (UTC).
              * @example 580
              */
             requests_month?: number;
             quota?: components["schemas"]["PlanQuotaState"];
-            /** @description Últimas peticiones a la API del usuario, de la más reciente a la más antigua. */
+            /** @description Últimas 15 peticiones del usuario con clave de API, de la más reciente a la más antigua. */
             recent_requests?: {
                 /**
                  * @description Verbo HTTP de la petición. Uno de `GET`, `POST`, `PUT`, `PATCH` o `DELETE`.
@@ -4062,7 +4207,7 @@ export interface components {
                  */
                 monthly_validations?: number;
                 /**
-                 * @description Cantidad de validaciones no retiradas del mes UTC en curso cuyo estado almacenado es `pending` o `processing`.
+                 * @description Cantidad de validaciones no retiradas del mes UTC en curso cuyo estado almacenado es `queued` o `processing`.
                  * @example 3
                  */
                 pending_month?: number;
@@ -4078,7 +4223,7 @@ export interface components {
                 avg_ticket?: number;
                 /**
                  * @description Tasa de éxito, expresada de `0` a `100`: `valid_validations` entre `total_validations`, redondeada a un decimal. La población histórica es la misma e incluye las validaciones retiradas y las del banco de pruebas (Playground); devuelve `0` cuando el total es `0`.
-                 * @example 0
+                 * @example 90.3
                  */
                 success_rate_percent?: number;
                 /**
@@ -4107,11 +4252,16 @@ export interface components {
                         /**
                          * Format: uuid
                          * @description Identificador único de la validación (UUID v4).
-                         * @example a1b2c3d4-e5f6-7890-abcd-ef0123456789
+                         * @example a1b2c3d4-e5f6-4890-abcd-ef0123456789
                          */
                         id?: string;
                         /** @description Datos resumidos de la validación reciente mostrados en el panel. */
                         attributes?: {
+                            /**
+                             * @description Clave Banxico canónica del banco, si se puede resolver.
+                             * @example 40012
+                             */
+                            bank_code?: string | null;
                             /**
                              * @description Nombre del banco de la contraparte. Prioriza `receptor_name` o `emisor_name` guardado; si falta, intenta resolver el código de receptor o emisor. Si tampoco puede resolverlo, devuelve ese código o `Banco no identificado`.
                              * @example BBVA MEXICO
@@ -4185,6 +4335,33 @@ export interface components {
             /** @description Veredictos que admiten reintentos automáticos. */
             eligible_outcomes?: string[];
         };
+        /** @description Política de reintentos guardada de la cuenta: activación, límite, intervalo y resultados elegibles. Desactivada o sin configurar, trae `enabled=false`, `max_retries=0`, `interval_seconds=0` y `outcomes` vacío. */
+        SavedRetryPolicy: {
+            /**
+             * @description `true` cuando el ciclo de reintentos está activo. Si es `false`, los demás campos pueden ser ignorados.
+             * @example true
+             */
+            enabled?: boolean;
+            /**
+             * @description Número máximo de reintentos automáticos. Una vez alcanzado, el ciclo pasa al estado terminal `exhausted`.
+             * @example 3
+             */
+            max_retries?: number;
+            /**
+             * @description Segundos de espera entre cada reintento. Valores válidos: 300–86400 (5 min a 24h).
+             * @example 600
+             */
+            interval_seconds?: number;
+            /**
+             * @description Resultados que originan un reintento. De forma predeterminada son `not_found`, `cep_unavailable` y `error`; la combinación `["not_found", "cep_unavailable"]` excluye `error`.
+             * @example [
+             *       "not_found",
+             *       "cep_unavailable",
+             *       "error"
+             *     ]
+             */
+            outcomes?: ("not_found" | "cep_unavailable" | "error")[];
+        };
         UserRetryPolicyResponse: components["schemas"]["SuccessEnvelope"] & {
             /** @description Metadatos de la respuesta y límites efectivos de reintentos. */
             meta?: {
@@ -4194,7 +4371,7 @@ export interface components {
             data?: {
                 /** @enum {string} */
                 type?: "retry_policy";
-                attributes?: components["schemas"]["RetryPolicy"];
+                attributes?: components["schemas"]["SavedRetryPolicy"];
             };
         };
         /** @description Cuerpo de la petición para actualizar la política de reintentos por defecto del usuario (aplica a futuras validaciones). */
@@ -4204,7 +4381,7 @@ export interface components {
         /** @description Estado público del servicio de verificación de Banxico, tal como lo devuelve `GET /v1/status/banxico`. Muestra el estado operativo actual y una explicación legible. */
         BanxicoPublicStatus: {
             /**
-             * @description Estado agregado del servicio de verificación de Banxico — `operational`: Todas las pruebas pasan y la latencia es normal; `degraded`: Problemas parciales (latencia elevada o errores intermitentes); `down`: Servicio inaccesible; `unknown`: Aún no hay datos de salud disponibles.
+             * @description Estado agregado del servicio de verificación de Banxico — `operational`: Todas las pruebas pasan y la latencia es normal; `degraded`: Problemas parciales (latencia elevada o errores intermitentes); `down`: Servicio inaccesible; `unknown`: no hay datos de salud vigentes, porque aún no se ha ejecutado ningún chequeo o porque el último tiene más de tres veces `check_interval_seconds` de antigüedad (el chequeo automático dejó de correr).
              * @example operational
              * @enum {string}
              */
@@ -4220,7 +4397,7 @@ export interface components {
              */
             message: string;
             /**
-             * @description Timestamp del último chequeo de salud ejecutado. `null` cuando aún no se ha ejecutado ningún chequeo.
+             * @description Timestamp del último chequeo de salud ejecutado. `null` cuando aún no se ha ejecutado ningún chequeo. Cuando `status` es `unknown` por un chequeo demasiado viejo, conserva la fecha de ese chequeo: dice desde cuándo no hay dato.
              * @example 2026-04-11T15:30:00Z
              */
             last_verified_at: components["schemas"]["TimestampUTC"] | null;
@@ -4368,7 +4545,7 @@ export interface components {
         CreateWebhookRequest: {
             /**
              * Format: uri
-             * @description URL receptora del webhook. En producción se rechaza si no usa HTTPS, si resuelve a una dirección privada o si pasa de 2048 caracteres.
+             * @description URL receptora del webhook. Se rechaza si resuelve a una dirección privada o si pasa de 2048 caracteres y, en producción, también si no usa HTTPS.
              * @example https://example.com/webhooks/entregas
              */
             url: string;
@@ -4384,7 +4561,7 @@ export interface components {
         UpdateWebhookRequest: {
             /**
              * Format: uri
-             * @description Nueva URL receptora del webhook. En producción se rechaza si no usa HTTPS, si no resuelve a una dirección pública o si supera 2048 caracteres.
+             * @description Nueva URL receptora del webhook. Se rechaza si no resuelve a una dirección pública o si supera 2048 caracteres y, en producción, también si no usa HTTPS.
              * @example https://example.com/webhooks/entregas
              */
             url?: string;
@@ -4721,13 +4898,13 @@ export interface components {
              */
             remaining: number;
             /**
-             * @description Porcentaje del límite consumido en el ciclo actual, redondeado a 2 decimales.
+             * @description Porcentaje del límite consumido en el ciclo actual, redondeado a 2 decimales. Puede pasar de 100 si hay excedente.
              * @example 70.5
              */
             used_percent: number;
             /**
              * @description Nivel de alerta según el consumo: `ok` (<70 %), `warn` (70–89 %), `danger` (≥90 % o cuota agotada).
-             * @example ok
+             * @example warn
              * @enum {string}
              */
             tone: "ok" | "warn" | "danger";
@@ -4901,12 +5078,12 @@ export interface components {
                 /** @description Lista de celdas del mapa; cada entrada es una combinación de `day_of_week` y `hour_of_day` con su conteo. */
                 buckets?: {
                     /**
-                     * @description Día de la semana (0 = domingo … 6 = sábado).
+                     * @description Día de la semana en UTC (0 = domingo … 6 = sábado).
                      * @example 0
                      */
                     day_of_week?: number;
                     /**
-                     * @description Hora del día (0–23), hora del servidor.
+                     * @description Hora del día (0–23), en UTC.
                      * @example 0
                      */
                     hour_of_day?: number;
@@ -5101,22 +5278,20 @@ export interface components {
                  */
                 month?: string;
                 /**
-                 * Format: date-time
-                 * @description Inicio del mes en UTC (ISO 8601).
-                 * @example 2026-04-01T06:00:00Z
+                 * @description Inicio del mes en UTC, con formato `YYYY-MM-DD HH:MM:SS`.
+                 * @example 2026-04-01 06:00:00
                  */
                 from_utc?: string;
                 /**
-                 * Format: date-time
-                 * @description Fin del mes en UTC (ISO 8601, exclusivo).
-                 * @example 2026-05-01T06:00:00Z
+                 * @description Fin del mes en UTC (exclusivo), con formato `YYYY-MM-DD HH:MM:SS`.
+                 * @example 2026-05-01 06:00:00
                  */
                 to_utc?: string;
             };
             /** @description Conteos de validaciones por veredicto, más retiros mediante borrado lógico del periodo (informativo). */
             counts?: {
                 /**
-                 * @description Cantidad de validaciones completadas en el periodo (excluyendo las validaciones con estado `pending`).
+                 * @description Cantidad de validaciones del periodo, incluidas las que tienen estado `pending`.
                  * @example 287
                  */
                 total?: number;
@@ -5205,7 +5380,7 @@ export interface components {
                 verified_share_pct?: number;
             };
             /**
-             * @description Tasa de éxito: porcentaje de validaciones con resultado `valid` sobre el total completado, expresado de 0 a 100.
+             * @description Tasa de éxito: porcentaje de validaciones con resultado `valid` sobre `counts.total`, expresado de 0 a 100.
              * @example 79.4
              */
             success_rate?: number;
@@ -5360,9 +5535,20 @@ export interface components {
                  * @description Nombres de las columnas para formato CSV (en el mismo orden que las filas en `rows`).
                  * @example [
                  *       "Fecha",
-                 *       "Monto",
+                 *       "Folio plataforma",
+                 *       "Tipo",
                  *       "Clave de rastreo",
-                 *       "Estado"
+                 *       "Fecha operación",
+                 *       "Monto",
+                 *       "Banco emisor",
+                 *       "CLABE emisora",
+                 *       "Banco receptor",
+                 *       "CLABE receptora",
+                 *       "Beneficiario",
+                 *       "Veredicto Banxico",
+                 *       "CEP disponible",
+                 *       "Folio CEP",
+                 *       "Tiempo (ms)"
                  *     ]
                  */
                 headers?: string[];
@@ -5370,10 +5556,21 @@ export interface components {
                  * @description Primeras 20 filas (máximo) de datos del reporte.
                  * @example [
                  *       [
+                 *         "2026-04-15 10:32:00",
+                 *         "c3d4e5f6-a7b8-9012-cdef-123456789012",
+                 *         "direct",
+                 *         "MXBA20260415001234",
                  *         "2026-04-15",
                  *         "15000.50",
-                 *         "MXBA20260415001234",
-                 *         "valid"
+                 *         "BBVA MEXICO",
+                 *         "012180001234567891",
+                 *         "BANORTE",
+                 *         "072180009876543210",
+                 *         "Comercializadora Ejemplo SA de CV",
+                 *         "valid",
+                 *         "Sí",
+                 *         "",
+                 *         "412"
                  *       ]
                  *     ]
                  */
@@ -5393,7 +5590,7 @@ export interface components {
             plan_slug?: string;
             /**
              * @description Nombre del plan que muestran las interfaces.
-             * @example Pro
+             * @example Personal
              */
             plan_name?: string;
             /**
@@ -5520,17 +5717,59 @@ export interface components {
         BillingSubscriptionQuotaMeta: {
             /**
              * @description Identificador único y legible del plan. Coincide con `data.attributes.plan_slug`.
-             * @example pro
+             * @example personal
+             */
+            plan_slug?: string;
+            /**
+             * @description Nombre del plan que muestran las interfaces.
+             * @example Personal
+             */
+            plan_name?: string;
+            /**
+             * @description Modelo de facturación del plan — `free`: Sin cobro; `tiered`: Cuota fija; `metered`: Cobro por consumo; `hybrid`: Cuota fija más consumo.
+             * @example hybrid
+             * @enum {string}
+             */
+            billing_model?: "free" | "tiered" | "metered" | "hybrid";
+            /**
+             * @description Origen de la suscripción — `stripe`: Pago mediante Stripe; `admin_granted`: Concesión administrativa; `system_default`: Plan asignado por el sistema.
+             * @example stripe
+             * @enum {string}
+             */
+            source?: "stripe" | "admin_granted" | "system_default";
+            /**
+             * @description `true` cuando el usuario aceptó cobro por excedente en un plan `hybrid`. En ese caso, `effective_limit` salta de `included_validations` a `monthly_validation_limit`.
+             * @example false
+             */
+            overage_enabled?: boolean;
+            /**
+             * @description `true` cuando el plan es `hybrid` y el cobro por excedente todavía no está activo: el usuario puede activarlo.
+             * @example false
+             */
+            overage_available?: boolean;
+            /**
+             * @description Límite del ciclo fijado por un administrador para esta suscripción. Cuando existe, manda sobre el del plan. `null` sin ajuste.
+             * @example null
+             */
+            monthly_limit_override?: number | null;
+            /**
+             * @description Validaciones incluidas en la cuota base antes del cobro por excedentes. `null` cuando el plan no tiene cuota base.
+             * @example 500
+             */
+            included_validations?: number | null;
+            /**
+             * @description Tope de validaciones por ciclo de la suscripción. `0` no permite validaciones. En planes `hybrid`, es el tope duro cuando `overage_enabled` es `true`; cuando es `false`, `effective_limit` usa `included_validations`. En los demás modelos, es el límite efectivo salvo que exista un ajuste administrativo.
+             * @example 10000
              */
-            plan?: string;
+            monthly_validation_limit?: number;
             /**
              * @description Validaciones consumidas en el ciclo actual.
-             * @example 420
+             * @example 220
              */
             used?: number;
             /**
-             * @description Límite efectivo de validaciones para el ciclo actual. Tiene el mismo valor que `data.attributes.effective_limit`.
-             * @example 500
+             * @description Límite efectivo de validaciones para el ciclo actual. Tiene el mismo valor que `data.attributes.effective_limit`, salvo con `quota_kind=trial`: entonces es la asignación de prueba.
+             * @example 300
              */
             limit?: number;
             /**
@@ -5588,7 +5827,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "1a2b3c4d5e6f"
+                 *         "request_id": "1a2b3c4d5e6ff6e5d4c3b2a1"
                  *       }
                  *     }
                  */
@@ -5612,7 +5851,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "2b3c4d5e6f7a"
+                 *         "request_id": "2b3c4d5e6f7aa7f6e5d4c3b2"
                  *       }
                  *     }
                  */
@@ -5636,7 +5875,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "c4d5e6f7a8b9"
+                 *         "request_id": "c4d5e6f7a8b99b8a7f6e5d4c"
                  *       }
                  *     }
                  */
@@ -5668,7 +5907,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "f7a8b9c0d1e2",
+                 *         "request_id": "f7a8b9c0d1e22e1d0c9b8a7f",
                  *         "retry_after": 45
                  *       }
                  *     }
@@ -5714,7 +5953,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "3c4d5e6f7a8b"
+                 *         "request_id": "3c4d5e6f7a8bb8a7f6e5d4c3"
                  *       }
                  *     }
                  */
@@ -5740,7 +5979,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "2b3c4d5e6f7a"
+                 *         "request_id": "2b3c4d5e6f7aa7f6e5d4c3b2"
                  *       }
                  *     }
                  */
@@ -5767,13 +6006,13 @@ export interface components {
                  *       "errors": [
                  *         {
                  *           "status": "403",
-                 *           "code": "forbidden",
+                 *           "code": "permission_denied",
                  *           "detail": "No tienes permiso para acceder a este recurso."
                  *         }
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "d5e6f7a8b9c0"
+                 *         "request_id": "d5e6f7a8b9c00c9b8a7f6e5d"
                  *       }
                  *     }
                  */
@@ -5797,7 +6036,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.61.0",
-                 *         "request_id": "1a2b3c4d5e6f"
+                 *         "request_id": "1a2b3c4d5e6ff6e5d4c3b2a1"
                  *       }
                  *     }
                  */
@@ -5833,7 +6072,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "e6f7a8b9c0d1"
+                 *         "request_id": "e6f7a8b9c0d11d0c9b8a7f6e"
                  *       }
                  *     }
                  */
@@ -5857,7 +6096,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "d5e6f7a8b9c1"
+                 *         "request_id": "d5e6f7a8b9c11c9b8a7f6e5d"
                  *       }
                  *     }
                  */
@@ -5872,7 +6111,7 @@ export interface components {
         AsyncQueryParam: "0" | "1" | "true" | "false" | "yes";
         /** @description Identificador (UUID) de la validación */
         ValidationId: string;
-        /** @description **ETag** recibido en peticiones anteriores. Si los datos no han cambiado y el `etag_version` sigue igual, el server responde `304 Not Modified` (sin cuerpo) — evita recibir los datos de nuevo cuando el estado del recurso NO ha cambiado. */
+        /** @description **ETag** recibido en una respuesta anterior, tal cual (débil `W/"…"` en una validación, fuerte en los catálogos públicos). Si el recurso no ha cambiado, el server responde `304 Not Modified` (sin cuerpo) y evita mandar los datos de nuevo. */
         IfNoneMatchHeader: string;
     };
     requestBodies: never;
@@ -6089,6 +6328,11 @@ export interface operations {
                  * @example 012
                  */
                 bank?: string;
+                /**
+                 * @description Filtro — Varias claves SPEI separadas por coma (hasta 50); devuelve las validaciones cuyo banco emisor o receptor sea cualquiera de ellas. Si un elemento no tiene de 1 a 5 dígitos, responde con estado HTTP `422` e `invalid_filter`. Se combina con `bank`: si mandas los dos, se cumplen ambos.
+                 * @example 40012,40014,40072
+                 */
+                banks?: string;
                 /**
                  * @description Filtro — Importe mínimo inclusivo, como número. El servidor también tolera enviarlo como texto con separador de miles o símbolo de moneda ("1,000.50", "$500") y lo normaliza con el mismo algoritmo que el resto de la plataforma, pero el contrato es un número: un cliente tipado debe mandarlo así. Un valor no vacío que no se reconozca como número devuelve un estado HTTP `422` con `invalid_filter`, en vez de ignorarse en silencio. Se aplica de forma independiente de `amount_max`.
                  * @example 1000.5
@@ -6194,6 +6438,11 @@ export interface operations {
                  * @example 012
                  */
                 bank?: string;
+                /**
+                 * @description Filtro — Varias claves SPEI separadas por coma (hasta 50); devuelve las validaciones cuyo banco emisor o receptor sea cualquiera de ellas. Si un elemento no tiene de 1 a 5 dígitos, responde con estado HTTP `422` e `invalid_filter`. Se combina con `bank`: si mandas los dos, se cumplen ambos.
+                 * @example 40012,40014,40072
+                 */
+                banks?: string;
                 /**
                  * @description Filtro — Importe mínimo inclusivo de las validaciones contadas.
                  * @example 1000.5
@@ -6307,6 +6556,11 @@ export interface operations {
                  * @example 012
                  */
                 bank?: string;
+                /**
+                 * @description Filtro — Varias claves SPEI separadas por coma (hasta 50); devuelve las validaciones cuyo banco emisor o receptor sea cualquiera de ellas. Si un elemento no tiene de 1 a 5 dígitos, responde con estado HTTP `422` e `invalid_filter`. Se combina con `bank`: si mandas los dos, se cumplen ambos.
+                 * @example 40012,40014,40072
+                 */
+                banks?: string;
                 /**
                  * @description Filtro — Importe mínimo inclusivo. Se aplica de forma independiente de `amount_max`.
                  * @example 1000.5
@@ -6357,7 +6611,7 @@ export interface operations {
         parameters: {
             query?: never;
             header?: {
-                /** @description **ETag** recibido en peticiones anteriores. Si los datos no han cambiado y el `etag_version` sigue igual, el server responde `304 Not Modified` (sin cuerpo) — evita recibir los datos de nuevo cuando el estado del recurso NO ha cambiado. */
+                /** @description **ETag** recibido en una respuesta anterior, tal cual (débil `W/"…"` en una validación, fuerte en los catálogos públicos). Si el recurso no ha cambiado, el server responde `304 Not Modified` (sin cuerpo) y evita mandar los datos de nuevo. */
                 "If-None-Match"?: components["parameters"]["IfNoneMatchHeader"];
             };
             path: {
@@ -6488,7 +6742,7 @@ export interface operations {
             };
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
-            /** @description Validación no encontrada (`not_found`) o el CEP no está disponible para esta validación (`cep_not_available`). Este último código se devuelve cuando `banxico_status` no es `valid` o falta el archivo solicitado. */
+            /** @description Validación no encontrada (`not_found`) o el CEP no está disponible para esta validación (`cep_not_available`). Este último código se devuelve cuando `banxico_status` no es `valid` ni `returned` o falta el archivo solicitado. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -7023,7 +7277,7 @@ export interface operations {
         parameters: {
             query?: never;
             header?: {
-                /** @description **ETag** recibido en peticiones anteriores. Si los datos no han cambiado y el `etag_version` sigue igual, el server responde `304 Not Modified` (sin cuerpo) — evita recibir los datos de nuevo cuando el estado del recurso NO ha cambiado. */
+                /** @description **ETag** recibido en una respuesta anterior, tal cual (débil `W/"…"` en una validación, fuerte en los catálogos públicos). Si el recurso no ha cambiado, el server responde `304 Not Modified` (sin cuerpo) y evita mandar los datos de nuevo. */
                 "If-None-Match"?: components["parameters"]["IfNoneMatchHeader"];
             };
             path?: never;
@@ -7086,6 +7340,109 @@ export interface operations {
             429: components["responses"]["RateLimited"];
         };
     };
+    getSpeiCalendar: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description **ETag** recibido en una respuesta anterior, tal cual (débil `W/"…"` en una validación, fuerte en los catálogos públicos). Si el recurso no ha cambiado, el server responde `304 Not Modified` (sin cuerpo) y evita mandar los datos de nuevo. */
+                "If-None-Match"?: components["parameters"]["IfNoneMatchHeader"];
+            };
+            path: {
+                /**
+                 * @description Año del calendario, de cuatro dígitos.
+                 * @example 2026
+                 */
+                year: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Calendario de días inhábiles SPEI del año, con su fuente. */
+            200: {
+                headers: {
+                    /** @description Firma del calendario actual. Pasar como `If-None-Match` en peticiones posteriores. */
+                    ETag?: string;
+                    /** @description TTL de caché en el cliente (1 h). */
+                    "Cache-Control"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SpeiCalendarResponse"];
+                };
+            };
+            /** @description No modificado: el calendario no ha cambiado según el ETag enviado. */
+            304: {
+                headers: {
+                    /** @description ETag actual del calendario. */
+                    ETag?: string;
+                    /** @description TTL de caché en el cliente (1 h). */
+                    "Cache-Control"?: string;
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description El año no tiene calendario (código `spei_calendar_year_not_covered`). `meta.covered_years` lista los años disponibles. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "errors": [
+                     *         {
+                     *           "status": "404",
+                     *           "code": "spei_calendar_year_not_covered",
+                     *           "detail": "No tenemos el calendario de 2030. Los años disponibles van de 2024 a 2026."
+                     *         }
+                     *       ],
+                     *       "meta": {
+                     *         "version": "1.63.0",
+                     *         "request_id": "c1d2e3f4a5b66b5a4f3e2d1c",
+                     *         "covered_years": [
+                     *           2024,
+                     *           2025,
+                     *           2026
+                     *         ]
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorResponse"] & {
+                        meta?: {
+                            /** @description Años con calendario publicado, de menor a mayor. */
+                            covered_years?: number[];
+                        };
+                    };
+                };
+            };
+            /** @description El año no tiene cuatro dígitos (código `spei_calendar_year_invalid`). */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "errors": [
+                     *         {
+                     *           "status": "422",
+                     *           "code": "spei_calendar_year_invalid",
+                     *           "detail": "El año debe tener cuatro dígitos, por ejemplo 2026."
+                     *         }
+                     *       ],
+                     *       "meta": {
+                     *         "version": "1.63.0",
+                     *         "request_id": "d2e3f4a5b6c77c6b5a4f3e2d"
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            429: components["responses"]["RateLimited"];
+        };
+    };
     exportBeneficiaries: {
         parameters: {
             query?: {
@@ -7184,7 +7541,6 @@ export interface operations {
                      *         "attributes": {
                      *           "account_number": "012180004412345678",
                      *           "account_type": "clabe",
-                     *           "clabe": "012180004412345678",
                      *           "bank_code": "40012",
                      *           "bank_name": "BBVA MEXICO",
                      *           "label": "Proveedor ABC",
@@ -7224,7 +7580,7 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
             413: components["responses"]["PayloadTooLarge"];
-            /** @description La cuenta no pasó la validación, o el alta chocó con un tope. Los códigos posibles son `account_number_required`, `account_number_invalid_type`, `label_invalid_type`, `invalid_account_length`, `clabe_prefix_not_recognized`, `bank_code_required_for_phone`, `beneficiary_already_registered` y `plan_cap_exceeded`. `account_number_invalid_type` y `label_invalid_type` aparecen cuando el campo llega con un tipo distinto de cadena de texto. Todo error de campo trae `source.pointer`. */
+            /** @description La cuenta no pasó la validación, o el alta chocó con un tope. Los códigos posibles son `account_number_required`, `account_number_invalid_type`, `label_invalid_type`, `invalid_account_format`, `invalid_account_length`, `invalid_clabe_checksum`, `invalid_card_luhn`, `clabe_prefix_not_recognized`, `bank_code_required_for_phone`, `invalid_bank_code`, `max_length_exceeded`, `beneficiary_already_registered` y `plan_cap_exceeded`. `account_number_invalid_type` y `label_invalid_type` aparecen cuando el campo llega con un tipo distinto de cadena de texto. Todo error de campo trae `source.pointer`. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -7268,7 +7624,6 @@ export interface operations {
                      *         "attributes": {
                      *           "account_number": "5512345678",
                      *           "account_type": "phone",
-                     *           "clabe": "5512345678",
                      *           "bank_code": "40021",
                      *           "bank_name": "HSBC",
                      *           "label": "Cuenta DiMo HSBC",
@@ -7299,7 +7654,7 @@ export interface operations {
             403: components["responses"]["Forbidden"];
             404: components["responses"]["NotFound"];
             413: components["responses"]["PayloadTooLarge"];
-            /** @description El cuerpo no pasó la validación. Los códigos posibles son `no_valid_fields`, `invalid_account_length`, `clabe_prefix_not_recognized`, `bank_code_required_for_phone`, `account_number_invalid_type` y `label_invalid_type`. Las dos últimas aparecen cuando `account_number` o `label` llegan con un tipo distinto de cadena de texto (por ejemplo, un número o un arreglo). Todo error de campo trae `source.pointer`. */
+            /** @description El cuerpo no pasó la validación. Los códigos posibles son `no_valid_fields`, `invalid_account_format`, `invalid_account_length`, `invalid_clabe_checksum`, `invalid_card_luhn`, `clabe_prefix_not_recognized`, `bank_code_required_for_phone`, `invalid_bank_code`, `max_length_exceeded`, `beneficiary_already_registered`, `account_number_invalid_type` y `label_invalid_type`. Las dos últimas aparecen cuando `account_number` o `label` llegan con un tipo distinto de cadena de texto (por ejemplo, un número o un arreglo). Todo error de campo trae `source.pointer`. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -7390,7 +7745,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "b2c3d4e5f6a7"
+                     *         "request_id": "b2c3d4e5f6a77a6f5e4d3c2b"
                      *       }
                      *     }
                      */
@@ -7447,7 +7802,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "c5d6e7f8a9b0"
+                     *         "request_id": "c5d6e7f8a9b00b9a8f7e6d5c"
                      *       }
                      *     }
                      */
@@ -7487,7 +7842,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "e1f2a3b4c5d6"
+                     *         "request_id": "e1f2a3b4c5d66d5c4b3a2f1e"
                      *       }
                      *     }
                      */
@@ -7496,7 +7851,7 @@ export interface operations {
             };
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
-            /** @description Falló la validación o la pre-condición. Códigos posibles: `file_required`, `file_too_large`, `unsupported_format` e `import_already_in_flight`. */
+            /** @description Falló la validación o la pre-condición. Códigos posibles: `file_required`, `upload_error`, `file_too_large`, `invalid_parse_mode`, `unsupported_format`, `import_already_in_flight` y `persist_failed`. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -7514,7 +7869,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "f2a3b4c5d6e7"
+                     *         "request_id": "f2a3b4c5d6e77e6d5c4b3a2f"
                      *       }
                      *     }
                      */
@@ -7594,7 +7949,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "f8a9b0c1d2e3"
+                     *         "request_id": "f8a9b0c1d2e33e2d1c0b9a8f"
                      *       }
                      *     }
                      */
@@ -7734,10 +8089,10 @@ export interface operations {
                      *           "parsed_account_type": "phone",
                      *           "parsed_bank_code": "40012",
                      *           "parsed_bank_name": "BBVA MEXICO",
-                     *           "parsed_label": null,
+                     *           "parsed_label": "Cuenta",
                      *           "error_codes": [],
                      *           "corrections_applied": {
-                     *             "alias_auto_assigned": "Beneficiario 002"
+                     *             "alias_auto_assigned": "Cuenta"
                      *           },
                      *           "user_overrides": {
                      *             "parsed_account_type": "phone",
@@ -7754,7 +8109,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "c1d2e3f4a5b6"
+                     *         "request_id": "c1d2e3f4a5b66b5a4f3e2d1c"
                      *       }
                      *     }
                      */
@@ -7818,7 +8173,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "f4a5b6c7d8e9"
+                     *         "request_id": "f4a5b6c7d8e99e8d7c6b5a4f"
                      *       }
                      *     }
                      */
@@ -7846,7 +8201,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "a5b6c7d8e9f0"
+                     *         "request_id": "a5b6c7d8e9f00f9e8d7c6b5a"
                      *       }
                      *     }
                      */
@@ -8473,21 +8828,65 @@ export interface operations {
                  */
                 per_page?: number;
                 /**
-                 * @description Filtro — Identificador único del endpoint webhook (UUID v4).
-                 * @example 7c9e6679-7425-40de-944b-e07fc1f90ae7
+                 * @description Filtro — Identificador único del endpoint webhook (UUID v4). Hasta 20, separados por comas.
+                 * @example [
+                 *       "7c9e6679-7425-40de-944b-e07fc1f90ae7"
+                 *     ]
+                 */
+                endpoint_id?: string[];
+                /**
+                 * @description Filtro — Estado de la entrega. `success` llegó. `failed` es el resultado del último intento; Messenger puede programar otro si el fallo es recuperable. `retrying` se pospuso por el límite de salida y Messenger la reintentará. `pending` todavía no se ha intentado. Varios estados, separados por comas.
+                 * @example [
+                 *       "failed"
+                 *     ]
                  */
-                endpoint_id?: string;
+                status?: ("success" | "failed" | "retrying" | "pending")[];
                 /**
-                 * @description Filtro — Estado de la entrega. `success` llegó. `failed` es el resultado del último intento; Messenger puede programar otro si el fallo es recuperable. `retrying` se pospuso por el límite de salida y Messenger la reintentará. `pending` todavía no se ha intentado.
-                 * @example failed
+                 * @description Filtro — Tipo de evento que originó la entrega. **De validaciones**: `validation.completed` cuando hay veredicto de Banxico, sea cual sea (también inválida o no encontrada, y aunque se abran reintentos), `validation.failed` cuando la entrada se rechaza y `validation.error` ante cualquier otro fallo. **De los reintentos automáticos:** `validation.retry.scheduled` al programar un reintento automático, `validation.retry.resolved` cuando un reintento automático encuentra el CEP, y `validation.retry.exhausted` cuando los reintentos se agotan sin encontrar el CEP. **De la revisión posterior de un `valid`:** `validation.returned` cuando una validación que había salido `valid` pasa a `returned` porque Banxico reportó la devolución.\
+                 *     **De la suscripción:** `billing.payment_succeeded` y `billing.payment_failed` por cada cobro, `billing.invoice_upcoming` antes de la siguiente factura, `billing.trial_will_end` antes de que acabe la prueba gratuita, y `billing.subscription_canceled` al cancelar la suscripción. Las entregas sintéticas (envío de prueba) se marcan como `test`. Varios tipos, separados por comas.
+                 * @example [
+                 *       "validation.completed"
+                 *     ]
                  */
-                status?: "success" | "failed" | "retrying" | "pending";
+                event_type?: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "validation.returned" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming" | "test")[];
                 /**
-                 * @description Filtro — Tipo de evento que originó la entrega. **De validaciones**: `validation.completed` cuando termina bien, `validation.failed` cuando termina mal y `validation.error` cuando hay un error del servicio. **De los reintentos automáticos:** `validation.retry.scheduled` al programar un reintento automático, `validation.retry.resolved` cuando un reintento automático encuentra el CEP, y `validation.retry.exhausted` cuando los reintentos se agotan sin encontrar el CEP. **De la revisión posterior de un `valid`:** `validation.returned` cuando una validación que había salido `valid` pasa a `returned` porque Banxico reportó la devolución.\
-                 *     **De la suscripción:** `billing.payment_succeeded` y `billing.payment_failed` por cada cobro, `billing.invoice_upcoming` antes de la siguiente factura, `billing.trial_will_end` antes de que acabe la prueba gratuita, y `billing.subscription_canceled` al cancelar la suscripción. Las entregas sintéticas (envío de prueba) se marcan como `test`.
-                 * @example validation.completed
+                 * @description Filtro — Busca en el identificador de la entrega, el identificador, la URL y la descripción del endpoint, el tipo de evento, el identificador de la validación y el código HTTP de la respuesta. No distingue mayúsculas; `%` y `_` se buscan tal cual. Más de 100 caracteres se recortan.
+                 * @example webhook.example.com
+                 */
+                q?: string;
+                /**
+                 * @description Filtro — Sólo las entregas de esta validación (UUID v4).
+                 * @example 3fa85f64-5717-4562-b3fc-2c963f66afa6
                  */
-                event_type?: "validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "validation.returned" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming" | "test";
+                validation_id?: string;
+                /**
+                 * @description Filtro — Código HTTP con que respondió el receptor, separados por comas. Vale un código exacto (`404`), una familia (`2xx`, `4xx`, `5xx`) o `none` para las que no tuvieron respuesta (tiempo agotado, conexión rechazada o todavía sin intentar). Varios valores suman resultados.
+                 * @example [
+                 *       "5xx",
+                 *       "none"
+                 *     ]
+                 */
+                response_status?: string[];
+                /**
+                 * @description Filtro — Entregas creadas desde este momento, incluido. Acepta fecha (`2026-10-01`, medianoche UTC) o fecha y hora ISO 8601 con zona.
+                 * @example 2026-10-01T00:00:00Z
+                 */
+                from?: string;
+                /**
+                 * @description Filtro — Entregas creadas hasta este momento, incluido. Una fecha sola llega al final de ese día en UTC.
+                 * @example 2026-10-15T23:59:59Z
+                 */
+                to?: string;
+                /**
+                 * @description Filtro — Sólo las entregas cuyo número de intento es al menos este. Con `2` quedan las que se reintentaron.
+                 * @example 2
+                 */
+                min_attempt?: number;
+                /**
+                 * @description Filtro — Sólo las entregas cuyo receptor tardó al menos estos milisegundos en responder.
+                 * @example 3000
+                 */
+                min_response_time_ms?: number;
             };
             header?: never;
             path?: never;
@@ -8527,22 +8926,66 @@ export interface operations {
         parameters: {
             query?: {
                 /**
-                 * @description Filtro — Identificador único del endpoint webhook (UUID v4).
-                 * @example 7c9e6679-7425-40de-944b-e07fc1f90ae7
+                 * @description Filtro — Identificador único del endpoint webhook (UUID v4). Hasta 20, separados por comas.
+                 * @example [
+                 *       "7c9e6679-7425-40de-944b-e07fc1f90ae7"
+                 *     ]
                  */
-                endpoint_id?: string;
+                endpoint_id?: string[];
                 /**
                  * @description \
-                 *     Filtro — Estado de la entrega. `success` llegó. `failed` es el resultado del último intento; Messenger puede programar otro si el fallo es recuperable. `retrying` se pospuso por el límite de salida y Messenger la reintentará. `pending` todavía no se ha intentado.
-                 * @example failed
+                 *     Filtro — Estado de la entrega. `success` llegó. `failed` es el resultado del último intento; Messenger puede programar otro si el fallo es recuperable. `retrying` se pospuso por el límite de salida y Messenger la reintentará. `pending` todavía no se ha intentado. Varios estados, separados por comas.
+                 * @example [
+                 *       "failed"
+                 *     ]
                  */
-                status?: "success" | "failed" | "retrying" | "pending";
+                status?: ("success" | "failed" | "retrying" | "pending")[];
                 /**
-                 * @description Filtro — Tipo de evento que originó la entrega. **De validaciones**: `validation.completed` cuando termina bien, `validation.failed` cuando termina mal y `validation.error` cuando hay un error del servicio. **De los reintentos automáticos:** `validation.retry.scheduled` al programar un reintento automático, `validation.retry.resolved` cuando un reintento automático encuentra el CEP, y `validation.retry.exhausted` cuando los reintentos se agotan sin encontrar el CEP. **De la revisión posterior de un `valid`:** `validation.returned` cuando una validación que había salido `valid` pasa a `returned` porque Banxico reportó la devolución.\
-                 *     **De la suscripción:** `billing.payment_succeeded` y `billing.payment_failed` por cada cobro, `billing.invoice_upcoming` antes de la siguiente factura, `billing.trial_will_end` antes de que acabe la prueba gratuita, y `billing.subscription_canceled` al cancelar la suscripción. Las entregas sintéticas (envío de prueba) se marcan como `test`.
-                 * @example validation.completed
+                 * @description Filtro — Tipo de evento que originó la entrega. **De validaciones**: `validation.completed` cuando hay veredicto de Banxico, sea cual sea (también inválida o no encontrada, y aunque se abran reintentos), `validation.failed` cuando la entrada se rechaza y `validation.error` ante cualquier otro fallo. **De los reintentos automáticos:** `validation.retry.scheduled` al programar un reintento automático, `validation.retry.resolved` cuando un reintento automático encuentra el CEP, y `validation.retry.exhausted` cuando los reintentos se agotan sin encontrar el CEP. **De la revisión posterior de un `valid`:** `validation.returned` cuando una validación que había salido `valid` pasa a `returned` porque Banxico reportó la devolución.\
+                 *     **De la suscripción:** `billing.payment_succeeded` y `billing.payment_failed` por cada cobro, `billing.invoice_upcoming` antes de la siguiente factura, `billing.trial_will_end` antes de que acabe la prueba gratuita, y `billing.subscription_canceled` al cancelar la suscripción. Las entregas sintéticas (envío de prueba) se marcan como `test`. Varios tipos, separados por comas.
+                 * @example [
+                 *       "validation.completed"
+                 *     ]
+                 */
+                event_type?: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "validation.returned" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming" | "test")[];
+                /**
+                 * @description Filtro — Busca en el identificador de la entrega, el identificador, la URL y la descripción del endpoint, el tipo de evento, el identificador de la validación y el código HTTP de la respuesta. No distingue mayúsculas; `%` y `_` se buscan tal cual. Más de 100 caracteres se recortan.
+                 * @example webhook.example.com
+                 */
+                q?: string;
+                /**
+                 * @description Filtro — Sólo las entregas de esta validación (UUID v4).
+                 * @example 3fa85f64-5717-4562-b3fc-2c963f66afa6
+                 */
+                validation_id?: string;
+                /**
+                 * @description Filtro — Código HTTP con que respondió el receptor, separados por comas. Vale un código exacto (`404`), una familia (`2xx`, `4xx`, `5xx`) o `none` para las que no tuvieron respuesta (tiempo agotado, conexión rechazada o todavía sin intentar). Varios valores suman resultados.
+                 * @example [
+                 *       "5xx",
+                 *       "none"
+                 *     ]
+                 */
+                response_status?: string[];
+                /**
+                 * @description Filtro — Entregas creadas desde este momento, incluido. Acepta fecha (`2026-10-01`, medianoche UTC) o fecha y hora ISO 8601 con zona.
+                 * @example 2026-10-01T00:00:00Z
+                 */
+                from?: string;
+                /**
+                 * @description Filtro — Entregas creadas hasta este momento, incluido. Una fecha sola llega al final de ese día en UTC.
+                 * @example 2026-10-15T23:59:59Z
+                 */
+                to?: string;
+                /**
+                 * @description Filtro — Sólo las entregas cuyo número de intento es al menos este. Con `2` quedan las que se reintentaron.
+                 * @example 2
+                 */
+                min_attempt?: number;
+                /**
+                 * @description Filtro — Sólo las entregas cuyo receptor tardó al menos estos milisegundos en responder.
+                 * @example 3000
                  */
-                event_type?: "validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "validation.returned" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming" | "test";
+                min_response_time_ms?: number;
                 /**
                  * @description Formato del archivo a descargar. Valores aceptados: `csv` y `xlsx`. Cualquier otro valor se sirve como `csv`.
                  * @example csv