ForHosting KIT · Utilidades de desarrollo

Dígito de control ISIN

Para el cuerpo US037833100 el dígito de control es 5, así que el ISIN completo es US0378331005. Complete el identificador de un valor antes de guardarlo o imprimirlo, o revise un ISIN de 12 caracteres recibido en el archivo de un socio. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto
Si escribe
Código
US037833100
Obtiene
Convertido
3028037833100
Modo de cálculo
Compute
Entrada
US037833100
Código de país
US

Un International Securities Identification Number (ISIN) es el código de doce caracteres que identifica de forma única un valor mobiliario entre mercados según ISO 6166. Los dos primeros caracteres son el código de país, los nueve siguientes el número nacional de identificación de valores (NSIN) y el duodécimo es un dígito de control numérico que se obtiene convirtiendo letras en números y aplicando el algoritmo de Luhn. Esta capacidad implementa solo esa regla oficial: el modo compute acepta exactamente once caracteres alfanuméricos y devuelve el dígito de control más el ISIN completo de doce; el modo validate acepta un ISIN completo de doce caracteres e indica si el dígito final coincide con el valor esperado recalculado.

Cómo se calcula el dígito de control Luhn del ISIN

Según ISO 6166 un ISIN tiene siempre doce caracteres: dos letras mayúsculas para el país o región de emisión, nueve caracteres alfanuméricos para el NSIN (a menudo un número nacional rellenado con ceros, como un CUSIP o SEDOL) y un dígito final que es el carácter de control. Para calcularlo, tome el cuerpo de once caracteres y expanda cada letra en dos dígitos decimales con el mapeo fijo A igual a diez hasta Z igual a treinta y cinco, mientras los dígitos decimales permanecen de un solo dígito.

El resultado es una cadena solo de dígitos cuya longitud depende de cuántas letras haya en el cuerpo: los códigos de país aportan siempre cuatro dígitos porque ambos caracteres son letras. Aplique el algoritmo clásico de Luhn desde la derecha de esa cadena expandida: duplique cada segundo dígito empezando por el dígito del cuerpo más a la derecha, porque una vez añadido el de control ese dígito del cuerpo queda en la posición dos desde la derecha del número completo.

Cuando el doble de un dígito es mayor que nueve, reste nueve (de forma equivalente, sume las decenas y las unidades del producto). Sume todos los valores ponderados; el dígito de control es diez menos esa suma módulo diez, módulo diez de nuevo, de modo que la secuencia completa de dígitos incluida la de control tenga un total Luhn divisible por diez.

La validación recalcula el dígito esperado a partir de los once primeros caracteres y lo compara con el duodécimo, que debe ser siempre un dígito decimal del cero al nueve. El algoritmo es determinista y local: sin llamada a un registro de emisores, sin reloj y sin aleatoriedad. Esta herramienta no resuelve ISIN a nombres, no maneja FIGI u otros identificadores alternativos y no demuestra que un código esté activo en un mercado: solo prueba que la cadena está bien formada según la regla Luhn de ISO 6166.

Frente a herramientas Luhn de tarjetas o IMEI, la intención de búsqueda aquí es estrecha: quien necesita una calculadora de dígito de control ISIN para un cuerpo de once caracteres o un comprobador de ISIN de valores de doce, no una herramienta de pagos ni de dispositivos.

Contrato de entrada, modos y comportamiento de error

Envíe un campo code que, tras recortar espacios y pasar a mayúsculas, contenga solo letras de la A a la Z y dígitos del cero al nueve. Una longitud incorrecta es un error explícito que nombra el modo y la longitud enviada —once para compute, doce para validate— de modo que los formularios cliente puedan mostrar «se necesitan once caracteres» sin adivinar.

Las cadenas vacías, el code ausente, los valores de mode inválidos, un duodécimo carácter no dígito en validate y un cuerpo que no cumple la forma de dos letras más nueve alfanuméricos fallan antes de cualquier suma Luhn y no se facturan. Prefiera compute cuando cree o complete ISIN para datos maestros y etiquetas; prefiera validate cuando condicione una operación, importación o consulta a un ISIN completo de un usuario, archivo de socio o feed de mercado.

Las tareas de validación que rechazan forma incorrecta no se cobran; una cadena bien formada de doce caracteres que simplemente tiene el dígito de control incorrecto devuelve valid false sin lanzar error.

Dónde encajan los dígitos de control ISIN en flujos reales

Emisores, agentes y agencias de numeración reciben códigos nacionales y deben añadir el dígito de control Luhn oficial antes de imprimir un ISIN en folletos, eventos corporativos o presentaciones regulatorias. Los formularios de alta de brókers y custodios validan ISIN de doce caracteres a la entrada para que una sola transposición no abra una posición fantasma ni una instrucción de liquidación fallida.

Los trabajos ETL que cargan maestros de instrumentos recorren cada columna ISIN de un CSV o de una definición FIX, llaman al modo validate y ponen en cuarentena las filas donde valid es false, capturando tanto ediciones humanas como errores de generadores en uno.

No trate un ISIN que pasa la comprobación como prueba de que el valor cotiza, es líquido o está libre de eventos corporativos; solo demuestra que el dígito Luhn es coherente con el país y el NSIN expandidos bajo los pesos estándar de ISO 6166 para la identificación internacional de valores.

Auditar columnas ISIN en inventarios de valores

Valide por lotes cada ISIN de doce caracteres en un CSV de middle-office, custodio o datos de mercado y ponga en cuarentena las filas cuyo dígito de control ya no coincida con el valor esperado recalculado.

¿Qué es un dígito de control ISIN?

Es el duodécimo carácter de un ISIN, un dígito del cero al nueve calculado con el algoritmo de Luhn tras expandir las letras A–Z a 10–35 sobre los once primeros caracteres, de modo que los errores de tecleo y escaneo suelen detectarse antes de almacenar o negociar el código.

¿Qué ocurre con longitud incorrecta, guiones o un dígito de control letra?

Las tareas de validación fallidas no se facturan.

¿Es gratuita la herramienta de dígito de control ISIN?

La herramienta del navegador es gratuita y se ejecuta en local.

¿Cómo se calcula el dígito de control del ISIN?

Cada letra se sustituye por dos cifras, de la A como diez a la Z como treinta y cinco, y los dígitos quedan igual. Después se aplica Luhn desde la derecha: se duplica una cifra de cada dos empezando por la última, se resta nueve a lo que pase de nueve, se suma y se toma diez menos el resto.

¿Un ISIN válido significa que el valor cotiza?

No. Un dígito de control correcto solo indica que los 12 caracteres son coherentes entre sí. No se consulta ningún registro de emisores, así que no dice si el valor cotiza o se ha liquidado.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/enc/isin

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/enc/isin \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"US037833100"}'
{
  "code": "US037833100"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.isin",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

La entrada no alfanumérica, las longitudes incorrectas y las formas mal formadas de país o NSIN fallan con invalid_input en lugar de un recorte silencioso, de modo que usted nunca persista un identificador a medias. La misma aritmética pura se ejecuta gratis en el navegador y al precio publicado de la API, sin consulta de red a bases de emisores y sin afirmar que un checksum válido signifique que el valor cotiza, se liquida o está libre de eventos corporativos.

Contrato de entrada, modos y comportamiento de error

Espacios, guiones, símbolos y puntuación se rechazan como entrada no alfanumérica con invalid_input para que un valor recortado en silencio no llegue al almacenamiento. El modo compute es el predeterminado: el motor exige exactamente once caracteres con un código de país de dos letras seguido de un NSIN alfanumérico de nueve, devuelve check_digit como cadena de un carácter, devuelve with_check como el ISIN de doce caracteres que usted puede imprimir o persistir, y también devuelve converted (la cadena de dígitos expandida), country_code y nsin para auditorías. El modo validate exige exactamente doce caracteres cuyo último sea un dígito; la respuesta indica valid true cuando el dígito final coincide con el expected_check_digit recalculado, e incluye siempre payload (los once primeros caracteres), converted, check_digit, expected_check_digit y length doce. Se aceptan alias como isin, number y text para el mismo campo de carga, de forma que las integraciones que ya hablan de «isin» no necesiten renombrar. Como la ruta es parse puro sin reloj, fuente aleatoria ni red, el mismo cuerpo JSON produce siempre el mismo resultado JSON en la herramienta gratuita del navegador y en la API a $0.002 por solicitud correcta.

Dónde encajan los dígitos de control ISIN en flujos reales

Los equipos de middle-office y datos estáticos recalculan expected_check_digit cuando una contraparte lee un código por teléfono o lo pega desde un PDF, capturando errores de escritura antes de registrar la operación contra el valor equivocado. En todo flujo el contrato es el mismo: solo alfanumérico, longitud fija por modo, JSON estructurado que usted puede probar con goldens, comportamiento idéntico en navegador gratuito y API prepago, e invalid_input honesto cuando la cadena no es una secuencia alfanumérica pura de la forma correcta.

Completar un cuerpo de 11 caracteres para datos maestros

Llame al modo compute con el cuerpo país+NSIN de once caracteres, almacene with_check y publique el ISIN de doce en el maestro de instrumentos, folletos o avisos de eventos corporativos.

Validar ISIN tecleados o importados a la entrada

Cuando un formulario, feed FIX o archivo de socio envíe doce caracteres, llame al modo validate y bloquee el registro si valid es false, mostrando expected_check_digit para corregir un error de un solo carácter.

¿Cómo calculo un dígito de control ISIN con esta API?

Haga POST con code igual a exactamente once caracteres alfanuméricos (código de país de dos letras más NSIN de nueve) y mode compute (u omita mode). La respuesta incluye check_digit y with_check (el ISIN completo de doce caracteres).

¿Cómo valido un ISIN completo de doce caracteres?

Haga POST con la cadena de doce caracteres y mode validate. La respuesta incluye valid, check_digit, expected_check_digit, payload (caracteres sin el último) y converted (la cadena de dígitos expandida).

Ver la documentación completa del KIT →