01 / Guía
Los datos de una dirección completa
Para una guía de paquetería conviene separar la información en campos. Así puedes revisar cada componente, reutilizar la dirección y enviarla a una API sin depender de abreviaturas o del orden escrito por una persona.
El teléfono ayuda a contactar al destinatario, pero no sustituye ningún dato postal. Las referencias también son complementarias: sirven para ubicar la entrada, no para corregir una calle, colonia o código postal incompletos.
| Dato | Ejemplo | Qué revisar |
|---|---|---|
| Destinatario | Andrea López | Nombre de la persona que puede recibir. |
| Teléfono | 55 0000 0000 | Un número de contacto vigente. |
| Calle | Av. Insurgentes Sur | Nombre completo de la vía. |
| Números | Ext. 1235 · Int. 4B | Exterior o S/N; interior cuando aplique. |
| Colonia | Insurgentes Mixcoac | Que corresponda al código postal. |
| Código postal | 03920 | Cinco dígitos, incluido cualquier cero inicial. |
| Municipio o alcaldía | Benito Juárez | No confundirlo con colonia o ciudad. |
| Ciudad y estado | Ciudad de México · CDMX | Que coincidan con el código postal. |
| País | México · MX | Usa MX cuando el sistema solicite el código ISO. |
| Referencias | Entrada junto al parque | Solo como ayuda adicional para localizar. |
02 / Guía
Cómo se ve la dirección ya ordenada
La ficha de México de la Unión Postal Universal muestra el destinatario primero, seguido por calle y número, colonia y una línea con código postal, localidad y estado. Una guía generada por un sistema puede reorganizar esos campos, pero los datos de origen deben seguir completos.
Este ejemplo es ilustrativo. En tu ecommerce o integración conserva los campos por separado, aunque después la guía los presente en varias líneas.
Andrea López
Av. Insurgentes Sur 1235, Int. 4B
Col. Insurgentes Mixcoac
03920 Ciudad de México, CDMX
MÉXICO03 / Guía
Confirma juntos el código postal y la colonia
El Catálogo Nacional de Códigos Postales es elaborado por el Servicio Postal Mexicano. Una consulta por código postal devuelve los asentamientos que le corresponden; por eso un código de cinco dígitos no basta si la colonia capturada pertenece a otra zona.
En un formulario de ecommerce, pedir primero el código postal permite presentar colonias compatibles y completar municipio, ciudad y estado. La persona todavía debe confirmar la opción correcta: una coincidencia de catálogo no identifica por sí sola la calle o el domicilio exacto.
- 01
Captura el código postal
Conserva los cinco dígitos, incluso cuando comienza con cero.
- 02
Consulta sus colonias
Usa el catálogo oficial o una fuente basada en SEPOMEX.
- 03
Elige el asentamiento correcto
No selecciones una colonia cercana solo porque comparte ciudad.
- 04
Confirma el resto
Revisa municipio o alcaldía, ciudad y estado antes de cotizar.
04 / Guía
La revisión antes de cotizar
Haz esta revisión cuando la persona termina de capturar la dirección y antes de solicitar opciones de envío. Corregir aquí evita que una cotización, una guía y un pedido conserven versiones distintas del mismo destino.
05 / Guía
Cómo verifica una dirección la API de SendIt
SendIt incluye POST /v1/address-verifications para revisar direcciones mexicanas. Con el proveedor SEPOMEX, verifica que el código postal exista, compara la colonia cuando se proporciona y devuelve datos normalizados o sugerencias para que tu flujo decida qué corregir.
El resultado es consultivo: no modifica en silencio la dirección ni bloquea por sí solo la creación de un envío. La verificación no garantiza que una calle exista, que una persona viva ahí o que una paquetería cubra el domicilio; esa distinción mantiene la validación dentro de lo que realmente puede comprobar.
POST /v1/address-verifications
X-API-Key: sk_test_...
Content-Type: application/json
{
"address": {
"street": "Av. Insurgentes Sur",
"exteriorNumber": "1235",
"neighborhood": "Insurgentes Mixcoac",
"postalCode": "03920",
"city": "Ciudad de México",
"state": "CDMX",
"country": "MX"
},
"provider": "SEPOMEX"
}06 / Guía
Un formulario que pide menos esfuerzo y produce mejores datos
No necesitas mostrar todos los campos al mismo tiempo. Un flujo progresivo puede comenzar con el código postal, ofrecer las colonias asociadas y después pedir calle, números, destinatario y teléfono.
Antes de guardar, muestra un resumen editable. Si la verificación encuentra una diferencia, explica qué campo necesita atención y conserva la decisión de la persona; una corrección comprensible es mejor que reemplazar datos sin aviso.
- 01
Pide el código postal
Activa la consulta cuando estén completos sus cinco dígitos.
- 02
Muestra opciones compatibles
Permite elegir colonia y completa los datos territoriales relacionados.
- 03
Captura el punto de entrega
Solicita calle, números, destinatario, teléfono y referencias útiles.
- 04
Resume y verifica
Presenta la dirección completa para confirmar o corregir antes de cotizar.
Siguiente paso
Completa la tarea.
Preguntas frecuentes
Respuestas rápidas.
¿Cuántos dígitos tiene un código postal de México?
Cinco. Conserva los ceros iniciales: 03920 es distinto de 3920 y debe almacenarse como texto, no como un número que elimine el primer cero.
¿La colonia debe coincidir con el código postal?
Sí. Un mismo código postal puede incluir varios asentamientos, pero la colonia elegida debe aparecer entre los que corresponden a ese código.
¿Las referencias sustituyen una dirección incompleta?
No. Una referencia ayuda a reconocer la entrada o el entorno, pero no sustituye calle, número, colonia, código postal, municipio o estado.
¿Validar una dirección garantiza la entrega?
No. La validación puede comprobar estructura y coincidencias de datos, pero la cobertura, las restricciones del servicio y la posibilidad de entregar se confirman por separado.
¿Qué verifica SendIt con SEPOMEX?
Verifica que el código postal exista y compara la colonia cuando se proporciona. Puede devolver una dirección normalizada y sugerencias; no afirma existencia a nivel de calle ni cobertura de una paquetería.