Fallas en la creación de Banco Digital

Requisitos previos de acceso

• Permiso (módulo): digitalAccountErrors
• Licencia/Feature: DIGITAL_BANKING habilitada en la licencia del tenant
• Contenedor del menú: GENERAL → grupo Auditoría

Qué es / cuándo usar

La pantalla Fallas en la creación de Banco Digital (/digital-account-errors) lista los intentos de apertura de cuenta digital (banco digital vía BaaS) que quedaron pendientes o fallaron en el proveedor. Cada registro guarda el userId, el proveedor, el código de error, el payload de apertura enviado y el payload de error devuelto.

Use esta pantalla para diagnosticar por qué la cuenta de un usuario no fue abierta en el banco digital, reprocesar/derivar la corrección y marcar el caso como resuelto. Es la capa de auditoría que sobrevive a un crash del proveedor: el payload de apertura se persiste independientemente de la respuesta.

Requisitos previos

• Permiso: módulo digitalAccountErrors. El permiso es doble — enum CPM en el backend + módulo dinámico en la base de datos.
• Licencia/Feature: DIGITAL_BANKING habilitada (Vault). Si está deshabilitada, el ítem no aparece en el menú.
• Dependencias de otras pantallas: el registro proviene de la cadena de auditoría de apertura de cuenta (payload en digital_account_creation.body en el BSM + middleware banking-audit en el BLS). El checkOnboarding en el BaaS-Gateway siempre responde desde el BLS — las cuentas que existen solo en el proveedor, sin registro en el BLS, pueden aparecer como inconsistencias.

Paso a paso

1. Acceda al menú GENERAL → Auditoría → Fallas en la creación de Banco Digital.
2. La tabla carga los registros paginados (10/25/50/100 por página).
3. (Opcional) Filtre por ID de usuario y/o Estado (PENDING, SUCCESS, ERROR) y haga clic en Aplicar.
4. Haga clic en una fila (o en Ver detalles) para abrir el modal con los payloads completos.
5. Si el registro está en estado ERROR, use Marcar como resuelto después de tratar el caso.

Filtros y columnas

Filtro / Columna	Qué muestra	Origen del dato
ID de usuario (filtro)	Filtra la lista por el usuario objetivo	Parámetro userId enviado al backend
Estado (filtro)	PENDING, SUCCESS o ERROR	Parámetro status
ID de usuario (columna)	Usuario cuya apertura falló	userId
Proveedor	Proveedor BaaS de destino	provider
Código de error	Código devuelto por el proveedor/integración	errorCode
Creado en	Momento del intento	createdAt
Acciones	Abre los detalles	—

Campos (modal de detalles)

Campo	Qué es	Origen
Estado	Estado actual del registro	status
Body (payload de apertura)	JSON enviado al proveedor al crear la cuenta	body
Error payload	JSON de error devuelto	errorPayload

Acciones y modales

• Aplicar / Limpiar filtros: rehace la consulta (reiniciando la paginación) o limpia los filtros.
• Actualizar: recarga la lista.
• Ver detalles: abre el DigitalAccountErrorDetailsModal con los payloads formateados (JSON).
• Marcar como resuelto: disponible solo cuando status === 'ERROR'. Solicita confirmación (confirm) y llama al backend para dar de baja el registro. Al concluir, cierra el modal y recarga la lista.

Reglas de negocio / consideraciones

Atención

• "Marcar como resuelto" es una acción de trazabilidad de auditoría: registra que el caso fue tratado. No recrea la cuenta por sí sola — la corrección efectiva (nuevo onboarding, ajuste de datos, backfill en el BLS) debe realizarse en el flujo correspondiente.
• Para cuentas legacy que existen en el proveedor pero no en el BLS, checkOnboarding devuelve 404 — estos casos requieren un backfill en el BLS, no solo "marcar como resuelto".
• El payload de apertura contiene PII (documentos, datos del titular). Trátelo conforme a la LGPD.

• Step-up: las acciones sensibles de banco digital pueden requerir re-autenticación (contraseña+MFA, header X-Step-Up-Token) según la configuración del tenant.

Pantallas relacionadas

• Fallas en la creación de usuario
• Webhooks recibidos
• Auditoría (visión general)