Menú

Formatos de código postal por país: guía y errores

Los formatos de código postal por país cambian de longitud y de alfabeto, y algunos territorios no tienen ninguno. Aprende a reconocerlos y a guardarlos sin perder ceros a la izquierda.

Publicado el

  • código postal
  • datos de prueba

Conocer los formatos de código postal por país es la diferencia entre un formulario que acepta direcciones de medio mundo y otro que rechaza la mitad de ellas sin explicar por qué. El código postal es un dato corto, aparentemente inofensivo, y a la vez una de las fuentes más comunes de errores de validación, de pérdida silenciosa de datos y de quejas de usuarios. Aquí verás qué formas existen, por qué se estropean al guardarlas y qué conviene decidir antes de escribir la primera regla.

Por qué el código postal no es un número

La tentación de tratarlo como una cifra es fuerte, porque en muchos países está formado solo por dígitos. Es una mala idea. En cuanto un código empieza por cero, cualquier sistema que lo interprete como número pierde ese cero inicial y la dirección deja de ser correcta. Lo mismo ocurre con los códigos que llevan letras: si el campo solo admite cifras, el usuario no puede escribir su dirección.

La regla práctica es sencilla: el código postal es texto. Se guarda como texto, se compara como texto y se muestra tal y como lo escribió el usuario, sin añadir separadores ni recortar caracteres.

Los grandes patrones que se repiten

Aunque cada país tiene su propio sistema, en la práctica se ven tres familias bien diferenciadas. Reconocerlas ayuda a diseñar un campo flexible en lugar de una regla por país.

Familia Cómo se reconoce Consecuencia para el diseño
Solo dígitos Una longitud fija de cifras, a menudo entre cuatro y seis Hay que conservar los ceros iniciales
Alfanumérico Mezcla letras y cifras, a veces en grupos separados por un espacio El campo debe admitir letras y espacios
Por zonas Un bloque que identifica la región y otro que identifica el punto de entrega Conviene validar la parte regional por separado

A esta lista hay que añadir una cuarta situación, la de los territorios que simplemente no tienen código postal. No es un formato raro ni un dato que falte: es que no existe el concepto.

¿Se puede validar un código postal con una sola regla?

No, y quien lo intenta acaba con un formulario que funciona en su país y falla en todos los demás. La forma del código cambia de un país a otro y también cambia con el tiempo: los sistemas postales se reforman, se añaden dígitos, se reorganizan zonas. Una regla escrita con la forma actual como si fuera eterna se convierte en un obstáculo.

Lo que sí se puede hacer sin riesgo es comprobar lo básico: que el campo no esté vacío cuando corresponde, que no contenga caracteres imposibles y que su longitud esté dentro de un rango razonable para el país elegido. Todo lo demás conviene tratarlo como una advertencia, no como un rechazo.

Cuando el país no tiene código postal

Hay territorios donde no existe un sistema de códigos postales y la dirección se localiza por la ciudad, la calle y a veces por referencias locales. Rellenar ese campo con ceros o con guiones es una solución de compromiso, no un dato real.

Ese detalle afecta a los formularios internacionales. Si el código postal es obligatorio en todos los países, los usuarios de esos territorios escriben cualquier cosa para poder continuar, y la base de datos se llena de valores que parecen códigos y no lo son. Lo más limpio es que el campo sea obligatorio solo donde tiene sentido, y que la interfaz explique el caso en lugar de dejar al usuario adivinando.

El caso de los ceros a la izquierda

Merece un apartado propio porque es el error más frecuente y el más difícil de detectar después. Si el código se guardó alguna vez como número, el cero inicial desapareció y no hay forma de recuperarlo. El daño se propaga: los informes agrupan mal, las etiquetas de envío salen incompletas y una consulta por zona devuelve resultados de otra.

La comprobación es rápida. Basta con buscar en la base de datos códigos cuya longitud sea menor que la esperada para ese país. Si aparecen, el campo se guardó con el tipo equivocado en algún punto del recorrido y hay que corregir el origen, no los datos.

¿Cómo se prueban direcciones con códigos de varios países?

Lo primero es tener ejemplos de cada familia. Un conjunto de datos que solo contiene códigos numéricos de cinco cifras no prueba nada del resto del mundo. Lo segundo es probar los casos incómodos: códigos con cero inicial, códigos con letras, códigos con espacio en medio y códigos de un territorio que no usa este sistema.

Para eso el generador de direcciones permite elegir el país y obtener una dirección completa con sus campos coherentes, incluido el código postal cuando ese país lo tiene. Como todos los datos que produce sirven solo para pruebas de software, no corresponden a ninguna vivienda ni destinatario y no pueden usarse para enviar nada. Si lo que buscas es repasar combinaciones que se contradicen entre sí, el artículo sobre direcciones de prueba y códigos postales que no cuadran recoge ese caso con detalle.

Notas para quien programa

  • Tipo de dato. Texto, siempre. Da igual que hoy solo contenga cifras; mañana aparecerá un país con letras y el cambio de tipo será una migración dolorosa.
  • Un campo por concepto. No metas el código postal dentro de la línea de calle ni lo concatenes con la ciudad. Hay países donde se escribe en la misma línea y países donde va aparte: eso es presentación, no almacenamiento.
  • Requerido según el país. Marca el campo como obligatorio únicamente donde el sistema postal existe. Si lo dejas obligatorio en todas partes, obtendrás datos inventados.
  • Normaliza solo lo cosmético. Quitar espacios sobrantes y unificar mayúsculas es razonable. Recortar caracteres o completar longitudes, no: cambia el dato.
  • Rango antes que forma. Si vas a validar, empieza por el rango de longitudes por país, que es lo que menos falsos positivos produce, y deja la forma exacta para un aviso.

Antes de publicar cambios, haz una prueba con al menos un país de cada familia y con un territorio sin código postal. Es el conjunto mínimo que revela si el formulario está preparado o solo parece estarlo.

Siguientes pasos

Revisa hoy mismo un formulario propio y comprueba dos cosas: si el campo de código postal admite letras y si conserva los ceros iniciales. Si la respuesta a cualquiera de las dos es no, tienes trabajo útil por delante. Para el resto de la estructura, la guía sobre el formato internacional de direcciones explica cómo cambia el orden de los elementos según el país, y el generador te da ejemplos listos para alimentar tus pruebas.

Seguir leyendo

Artículos sobre Generador de direcciones falsas