Referencia de códigos de país

¿Qué es una referencia de códigos de país?#

Todo sistema internacional (una pasarela de pago, un analizador de números de teléfono, una etiqueta de envío, un panel de analítica) tarde o temprano necesita convertir «Alemania» en DE, 840 en «Estados Unidos» o +81 en «Japón». Esos códigos cortos no son abreviaturas al azar; provienen de tres estándares coordinados, mantenidos para que las máquinas de distintos países se pongan de acuerdo sobre la misma entidad:

• ISO 3166-1 define los identificadores de dos letras (alpha-2, p. ej. JP), de tres letras (alpha-3, p. ej. JPN) y de tres dígitos (numeric, p. ej. 392) para cada país y territorio principal.
• ITU-T E.164 define el prefijo internacional de marcación que pones tras + (Japón es +81, Nigeria +234).
• ISO 4217 define el código de moneda (JPY, NGN).

Esta página pone los cinco en una única tabla buscable, más la capital y un emoji de bandera calculado directamente desde el código alpha-2. Los nombres localizados de país y moneda los produce el propio Intl.DisplayNames de tu navegador, así que se leen de forma natural en tu idioma en vez de a partir de una lista traducida a mano que se queda desfasada.

Cómo se usa#

1. Empieza a escribir en la caja de búsqueda de arriba. Una sola caja coincide con todo: nombre de país (en tu idioma o en inglés), alpha-2, alpha-3, el código numérico, el prefijo telefónico, la capital o el código de moneda. Escribe DE, Germany, 276, 49, Berlin o EUR: todos aterrizan en la misma fila.
2. Las consultas de solo dígitos hacen doble función. 840 coincide con el numérico UN M49 de Estados Unidos; 1 o +1 coincide con todos los países del North American Numbering Plan (EE. UU., Canadá, Jamaica, Puerto Rico, …) por prefijo de marcación.
3. El contador junto a la caja de búsqueda muestra cuántas filas sobrevivieron al filtro.
4. Haz clic en cualquier fila (o toca una celda) para copiar ese valor exacto al portapapeles: útil cuando necesitas pegar un alpha-2 en un formulario.
5. La columna de bandera muestra el emoji de indicador regional. Unos pocos territorios (Antártida AQ) son Unicode válido que algunas plataformas renderizan como letras sueltas AQ en vez de una bandera; el código en sí sigue siendo correcto.

Características clave#

• 249 entradas, una tabla: cada país ISO 3166-1 más territorios y dependencias principales (Groenlandia, Puerto Rico, Hong Kong, Åland, …), cada uno con los cinco códigos.
• Localizado por el navegador. Los nombres para mostrar de país y moneda provienen de Intl.DisplayNames, así que un espectador en francés ve Allemagne y euro sin ninguna tabla de traducción empaquetada.
• Coincidencia de dígitos inteligente. Una consulta numérica golpea tanto el número UN M49 (exacto o por prefijo) como el prefijo telefónico (prefijo de dígitos), así que 1 saca de forma fiable el bloque NANP.
• Incluye códigos asignados a usuarios. Kosovo (XK / XKX / 983) está presente aunque aún no es una entrada oficial de ISO 3166-1; muchos sistemas reales lo usan.
• 100 % del lado del cliente. El conjunto de datos se sirve en la página; nada se envía a ninguna parte.

Ejemplo práctico#

Supongamos que estás integrando un checkout y un cliente introduce el número de llamada con prefijo +234. Quieres saber de quién es ese número y a qué moneda poner por defecto en el formulario.

Escribe 234 en la caja de búsqueda. Exactamente una fila sobrevive:

Así que +234 → Nigeria, moneda NGN (el naira nigeriano), capital Abuja. Ahora compáralo con un miembro del NANP. Limpia la caja y escribe 1-787: Puerto Rico (PR / PRI / 630), capital San Juan, moneda USD, porque comparte el plan de marcación de EE. UU. a través del área 787. El sufijo -xxx es cómo este conjunto de datos distingue los códigos de área del NANP que de lo contrario colisionarían bajo un 1 simple.

Preguntas frecuentes#

¿Cuál es la diferencia entre alpha-2 y alpha-3?#

Alpha-2 (US, DE, JP) es la forma compacta usada en cualquier sitio donde un humano pueda leerla: dominios de nivel superior (example.de), formularios de dirección, etiquetas de locale (zh-CN). Alpha-3 (USA, DEU, JPN) es más legible y menos ambigua, así que aparece en pasaportes, campos SWIFT/IBAN y documentos aduaneros. Usa alpha-2 cuando el almacenamiento o el espacio en pantalla importen; alpha-3 cuando importe la claridad.

¿Por qué 840 significa Estados Unidos?#

Ese es el código numérico UN M49 / ISO 3166-1: un número de tres dígitos rellenado con ceros asignado independientemente de los códigos alfabéticos. Es valioso cuando los caracteres fuera de ASCII son un problema y cuando ordenas o comparas códigos de sistemas que no se ponen de acuerdo en la ortografía. El código numérico es el identificador más estable: rara vez cambia incluso cuando se renombra un país.

¿Los prefijos telefónicos son únicos por país?#

No. El North American Numbering Plan (+1) cubre unos 20 países y territorios; +7 lo comparten Rusia y Kazajistán. Por eso este conjunto de datos registra códigos de área como 1-787 para Puerto Rico, de modo que una búsqueda de la cadena completa de dígitos siga desambiguando.

¿Es Kosovo un código de país real?#

Kosovo usa el código asignado a usuarios XK (transitorio, aún no en ISO 3166-1). Muchos sistemas de pago y telecomunicaciones lo aceptan hoy; esta tabla lo incluye justamente por eso, y lo marca claramente para que no lo confundas con un código oficialmente asignado.