Generador de direcciones falsas: crea direcciones de prueba válidas (2026)

Cada resultado se compone a partir de una definición de país, uno de los cinco fixtures de ciudad de ese país, una lista de nombres de calles, un número de edificio y un patrón de código postal. El generador elige un país, elige un fixture de ciudad dentro de él, construye una línea de calle en el orden local y rellena el código postal según el patrón. No se toma ninguna muestra de una base de datos de entregas ni se copia nada de un buzón real.

Eso da dos garantías y dos no garantías. Garantizado: el formato sigue las convenciones del país y la misma semilla devuelve la misma dirección. No garantizado: que la calle exista con ese número, o que un código postal no estadounidense corresponda a una zona de entrega real. Para los ZIP de US hay una comprobación de existencia independiente contra un conjunto de datos de 40.979 filas en el verificador de códigos postales. Fuera de Estados Unidos la comprobación es solo estructural, y el sitio lo dice en lugar de insinuar más.

Los formularios de dirección rara vez prueban la dirección. Prueban la capa de validación, el enmascaramiento, los límites de longitud, la dependencia país-región y el serializador que escribe la fila en la base de datos. Un fixture que ya está mal formado oculta todo eso. Si tu fixture canadiense es "123 Main St, Toronto, ON 12345", el formulario acepta un patrón que un código postal canadiense real nunca puede cumplir, y el error llega a producción.

El fallo inverso es igual de común. Los equipos escriben a mano un fixture que parece real pero es incorrecto para el país, y luego añaden una solución provisional en el validador para aceptarlo. Seis meses después, la solución provisional es crítica y nadie recuerda por qué el campo postal alemán permite letras. Los datos generados que siguen los patrones publicados eliminan ambas direcciones de deriva, siempre que el propio generador sea honesto sobre lo que sabe.

Las direcciones sintéticas pertenecen a todas las capas por debajo de producción: pruebas unitarias de analizadores y validadores, pruebas de integración que escriben y leen filas de direcciones, pruebas de extremo a extremo que rellenan un formulario de pago, pruebas de carga que necesitan volumen sin tocar a un cliente real y ejecuciones de capturas de pantalla localizadas para una página de marketing. También son útiles para fuzzing, porque puedes generar deliberadamente valores en el límite de un límite de longitud o de un conjunto de caracteres.

Son la herramienta equivocada para cualquier cosa que dependa de un punto de entrega real. No las uses para comprobaciones de fraude, verificación de identidad, evasión de bloqueos, creación masiva de cuentas, manipulación de reseñas ni para probar una integración de envíos de extremo a extremo. Una dirección sintética no tiene buzón, así que cualquier paso que requiera un escaneo real del transportista fallará, y usar identidades generadas para obtener bienes o servicios es fraude independientemente de cómo se produjeron los datos.

El generador cubre 38 países. Cada país tiene cinco fixtures de ciudad, así que hay 190 definiciones de ciudad en total, y cada ciudad conoce su código de región, su patrón postal y las convenciones locales de calles. La cobertura se concentra en los mercados donde realmente se construyen formularios de dirección: Norteamérica, Europa occidental y septentrional, y los principales mercados de Asia-Pacífico y América Latina.

Dos países del conjunto no tienen código postal: Hong Kong y los Emiratos Árabes Unidos. El generador deja el campo vacío para ambos en lugar de inventar un número. Ese es el comportamiento correcto. Un formulario que marca el código postal como obligatorio en esos países está roto, y un fixture que proporciona un código falso ocultará el defecto hasta que un usuario real lo encuentre.

Un generador vale lo que vale su tabla de países. Los patrones siguientes son los que más a menudo se aplanan en una única plantilla con forma estadounidense. Fíjate en que Japón invierte el orden por completo, que los Países Bajos ponen letras después de los dígitos y que Brasil y Japón usan ambos un guion que es convencional y no estructural.

Los códigos postales deben almacenarse como cadenas. Alemania, Francia, España, Italia y Polonia emiten códigos con ceros iniciales, y una columna entera convierte silenciosamente 01067 en 1067. Lo mismo se aplica a los códigos australianos y brasileños. Si tu esquema tiene una columna postal numérica, el fixture la expondrá en el momento en que siembres una dirección alemana.

Un generador que devuelve una dirección diferente en cada llamada no es un fixture, es ruido. La generación con semilla fija una entrada para que la secuencia de salida sea estable entre máquinas y entre ejecuciones. Pasa la semilla explícitamente en las pruebas, regístrala junto con cualquier conjunto de datos generado y trata un cambio de semilla como un cambio de fixture que requiere revisión.

El patrón práctico es derivar semillas por entidad a partir de una semilla padre, por ejemplo un hash de la semilla y el índice del registro. Eso mantiene estable el conjunto de datos y a la vez produce valores distintos por fila. También hace reproducibles los fallos: cuando CI informa de una dirección incorrecta, la semilla más el índice bastan para regenerar exactamente esa fila. Nunca derives la semilla del reloj ni de una llamada aleatoria, porque así es como una prueba inestable se convierte en un misterio permanente.

Son dos afirmaciones distintas, y confundirlas es la forma más común de que una suite de pruebas mienta a sus responsables. Una comprobación estructural responde a "¿esta cadena coincide con el patrón del país?". Una comprobación de existencia responde a "¿este código aparece en un conjunto de datos de referencia?". El verificador de códigos postales de este sitio hace la primera para todos los países y la segunda solo para los ZIP de US, donde consulta 40.979 filas.

Una comprobación estructural superada te dice que el formulario no rechazará un valor bien formado. No te dice nada sobre si un transportista puede entregar en él, si el número de calle está dentro del rango de esa calle o si la ciudad coincide con el ZIP. Eso requiere datos de referencia postales que este sitio no incluye. Escribe tus aserciones para que coincidan con la comprobación que realmente realizas, o los nombres de las pruebas prometerán de más durante años.

El sitio no genera números de Seguro Social, números de tarjetas de pago, valores IMEI o IMSI, direcciones Bluetooth ni números de serie de dispositivos. Es un límite deliberado, no una función que falte. Esos identificadores llevan sumas de comprobación, registros de asignación o restricciones legales, y un valor generado que parece plausible es mucho más peligroso que uno obviamente falso, porque puede pasar un validador ingenuo y acabar en una captura de pantalla, un ticket o un commit.

El mismo límite se aplica a los datos de contacto. Las direcciones de correo generadas usan siempre el dominio reservado example.test, que nunca puede resolverse a un buzón real. Los números de teléfono generados se limitan al bloque NANP 555-0100 a 555-0199 en US y Canadá, el rango reservado para uso ficticio. Si un flujo de trabajo necesita un número de tarjeta o un identificador fiscal, usa los valores de prueba oficiales publicados por el procesador o la autoridad fiscal, y nunca un valor extraído de un generador.