Generador de CCI de prueba (Perú)

Qué es el CCI y en qué se diferencia de tu número de cuenta

El Código de Cuenta Interbancario son veinte dígitos que identifican una cuenta bancaria de forma única dentro de todo el sistema financiero peruano. Y esa es justamente la diferencia con el número de cuenta: el número de cuenta solo tiene sentido dentro de su propio banco, mientras que el CCI funciona entre bancos distintos.

En la práctica, en Perú se usan los dos para cosas distintas:

Por eso una pantalla de «agregar cuenta de destino» suele pedir el CCI y no el número de cuenta, y por eso es el dato que más se prueba en cualquier aplicación peruana que mueva dinero.

Cómo está compuesto

Los veinte dígitos no son un bloque uniforme. La estructura general es esta:

• Dígitos 1 a 3: el código de la entidad financiera. Es la parte más útil para probar, porque permite deducir de qué banco es la cuenta con solo mirar el número.
• Dígitos 4 a 6: la oficina o sucursal.
• Dígitos 7 a 18: el número de cuenta dentro de esa entidad, rellenado con ceros por la izquierda cuando hace falta.
• Dígitos 19 y 20: dígitos de control.

Esta herramienta genera CCI con los prefijos reales de las entidades peruanas, así que si tu aplicación identifica el banco a partir de los tres primeros dígitos —para mostrar su logotipo, para aplicar comisiones distintas o para elegir la ruta de la transferencia—, esa lógica funcionará con estos datos.

Veinte dígitos: el problema que casi nadie ve venir

Un CCI tiene veinte dígitos, y eso genera un fallo silencioso muy concreto: no es un número, es una cadena. Si lo guardas en un tipo numérico, pasan dos cosas malas:

// El CCI como número: dos formas de perderlo
const cci = "00212345678901234567";

Number(cci)                    // 212345678901234600  ← perdió los ceros
                               //   y las últimas cifras
Number(cci) > Number.MAX_SAFE_INTEGER   // true: fuera del rango exacto

// Lo correcto:
const cciOk = String(cci).padStart(20, "0");   // cadena, siempre 20

Los ceros por la izquierda desaparecen —y varios bancos peruanos tienen códigos de entidad que empiezan por cero—, y el número supera el entero seguro de JavaScript, así que las últimas cifras cambian sin dar ningún error. En una base de datos ocurre lo equivalente: una columna INT o BIGINT no es el tipo correcto para un CCI; debe ser VARCHAR(20) o CHAR(20).

Esto no es teórico: es uno de los errores más caros en aplicaciones financieras, porque el dato se guarda mal sin que nada falle y solo se descubre cuando una transferencia va a la cuenta equivocada.

Qué probar con CCI sintéticos

• El tipo de dato. Genera un CCI que empiece por cero y comprueba que después de guardarlo y volverlo a leer sigue teniendo veinte dígitos y el cero delante.
• La deducción del banco. Genera CCI de varias entidades y comprueba que tu aplicación identifica correctamente cada una por los tres primeros dígitos.
• La longitud exacta. Diecinueve o veintiún dígitos deben rechazarse. Es la validación mínima de este campo.
• Espacios y guiones. Muchos usuarios pegan el CCI copiado de un correo, con espacios. Normaliza antes de validar, no rechaces.
• Cargas masivas. Exporta 100 en CSV y ábrelo en Excel: verás que Excel convierte el CCI a notación científica si la columna no está marcada como texto. Es el mismo problema del tipo de dato, y descubrirlo aquí es mucho mejor que en un archivo de pago real.

No son cuentas reales

Los CCI que genera esta herramienta tienen la estructura correcta y el prefijo de un banco real, pero no corresponden a ninguna cuenta abierta. No sirven para recibir ni enviar dinero, y ningún banco los reconocerá. Están para probar tu software: formularios, validaciones, deducción de entidad, cargas masivas y pantallas de transferencia.

Si necesitas el equivalente internacional, tienes el generador de IBAN; y para el número de cuenta con la máscara propia de cada banco peruano, el generador de cuenta bancaria.