1
Elige el departamento
O déjalo al azar. El distrito y la provincia que salgan pertenecerán de verdad a ese departamento: no verás un distrito de Lima colgando de Arequipa.
✓ Sin registro
🔒 Todo en tu navegador
Lotes de 1 a 100 · CSV y JSON
Generador de direcciones peruanas de prueba
Direcciones con vías verosímiles y distrito, provincia y departamento reales, emparejados correctamente. Con referencias de manzana y lote, que es como se vive de verdad en Perú.
100 % privado. No hay servidor: los datos se generan en tu navegador y no se envían ni se guardan en ninguna parte.
Cómo funciona
Tres pasos, cero configuración
2
Decide si quieres referencia
La manzana y el lote son parte esencial de una dirección peruana en zonas de urbanización, y rompen los formularios pensados para «calle y número».
3
Copia o exporta
El CSV separa vía, número, referencia, distrito, provincia y departamento en columnas, que es como debería guardarlas tu base de datos.
Tres niveles, y tienen que cuadrar
Una dirección peruana se ubica con tres niveles administrativos anidados: el país tiene 25 departamentos, que se dividen en 196 provincias, que se dividen en más de 1800 distritos.
Lo que hace útiles a estos datos de prueba es que están emparejados correctamente: si sale el distrito de Miraflores, la provincia será Lima y el departamento Lima. No verás combinaciones imposibles. Y eso es justo lo que necesitas para probar lo que más se rompe en un formulario de dirección: los selectores en cascada.
La prueba concreta: genera veinte direcciones, ve rellenando tu formulario con ellas y comprueba que al elegir el departamento se filtran las provincias correctas, y al elegir la provincia se filtran los distritos. Si tus listas están mal emparejadas, aquí lo vas a ver.
Manzana y lote: lo que rompe los formularios importados
En buena parte del Perú urbano, sobre todo en urbanizaciones y asentamientos, la dirección no es «calle y número». Es manzana y lote:
Av. Túpac Amaru 1661, Mz. X Lt. 27
Urb. Los Rosales, Mz. D Lt. 14, Dpto. 302
Jr. Junín 450, Int. 3
Un formulario copiado de una plantilla estadounidense tiene street_address,
city, state y zip_code. Ahí no cabe una
manzana con lote, y el usuario acaba metiéndolo todo apelotonado en el primer campo, o
peor: la aplicación lo rechaza por «formato inválido». Es una de las causas reales de envíos
que no llegan.
| Abreviatura | Significa |
|---|---|
Av. | Avenida |
Jr. | Jirón, muy típico peruano: una calle de varias cuadras en el centro histórico |
Psje. | Pasaje, una vía peatonal o muy estrecha |
Mz. y Lt. | Manzana y lote |
Urb. | Urbanización |
AA.HH. | Asentamiento humano |
Dpto. e Int. | Departamento e interior, dentro de un edificio |
El código postal que casi nadie usa
Perú tiene códigos postales de cinco dígitos, pero en la práctica la gente no los conoce ni los escribe. Ni las tiendas los piden, ni los repartidores los usan: la entrega se hace con el distrito y la referencia.
Esto choca de frente con las plataformas internacionales, donde el código postal es obligatorio y a menudo es la clave para calcular el envío. Tres decisiones que merece la pena probar antes de decidir:
- Si tu formulario exige código postal, la mayoría de tus usuarios peruanos se van a atascar ahí. Mejor opcional.
- Si calculas el envío por código postal, en Perú tendrás que hacerlo por distrito.
- Y el campo referencia —«frente al parque», «espalda del mercado»— no es un adorno: es lo que de verdad usa el repartidor. Si no existe en tu formulario, el paquete se pierde.
Qué probar con direcciones sintéticas
- Los selectores en cascada. Departamento → provincia → distrito, con datos que sí cuadran.
- Manzana y lote. ¿Cabe en tu formulario? ¿Se guarda de forma que se pueda volver a imprimir bien en una etiqueta?
- La longitud. «Urb. Los Rosales, Mz. D Lt. 14, Dpto. 302» son 41 caracteres solo de vía y referencia. Un campo de 50 se queda corto en cuanto añades el distrito.
- Tildes en los distritos. Áncash, Cañete, Huánuco, Junín. Otro sitio donde el UTF-8 mal configurado se delata.
- Direcciones de provincia. No pruebes solo con Lima: genera de Cusco, Loreto o Puno, donde los nombres son más largos y menos familiares.
- La etiqueta de envío. Coge una dirección generada, imprímela en tu plantilla de etiqueta y mira si cabe entera. Es la prueba que nadie hace y la que más envíos salva.
Vías verosímiles, direcciones inexistentes
Los distritos, provincias y departamentos son reales y están bien emparejados. Los nombres de vía y los números son verosímiles pero inventados: la combinación completa no corresponde a ningún domicilio concreto. Sirven para probar formularios, validaciones, selectores y plantillas de etiqueta, no para enviar nada a ninguna parte.
Preguntas frecuentes
Dudas habituales
¿Los distritos son reales?
Sí, y están emparejados con su provincia y departamento correctos. Es lo que hace útil el generador para probar selectores en cascada: no verás un distrito de Lima colgando de Arequipa.
¿Por qué incluye manzana y lote?
Porque en buena parte del Perú urbano la dirección no es «calle y número» sino manzana y lote. Un formulario copiado de una plantilla estadounidense no tiene sitio para eso, y el usuario acaba apelotonándolo todo en un campo o siendo rechazado.
¿Y el código postal?
Perú tiene códigos postales de cinco dígitos, pero la gente no los conoce ni los usa: la entrega se hace con el distrito y la referencia. Si tu formulario lo exige, la mayoría de tus usuarios peruanos se atascará ahí. Mejor dejarlo opcional.
¿Las direcciones existen?
Los distritos, provincias y departamentos sí. Los nombres de vía y los números son verosímiles pero inventados, así que la dirección completa no corresponde a ningún domicilio. No sirven para enviar nada.
¿Puedo elegir el departamento?
Sí. Y conviene probar con varios: los nombres de Cusco, Loreto o Puno son más largos que los de Lima y revelan mejor los problemas de longitud de campo y de maquetación de etiquetas.
¿Cómo debo guardar la dirección en la base de datos?
Por partes: vía, número, referencia, distrito, provincia y departamento en columnas separadas. Así puedes filtrar por distrito, calcular envíos y volver a componer la etiqueta. El CSV que exporta esta herramienta ya viene así.
Sigue probando