Catálogo SEPOMEX: el archivo oficial frente a una API

Qué es el catálogo

Un solo catálogo nacional, elaborado por el Servicio Postal Mexicano, que cubre los 32 estados: códigos postales, asentamientos con su tipo, municipios y ciudades. Es la fuente sobre la que está construido todo producto de códigos postales en México, incluido este. Si alguna de esas palabras te suena nueva, el glosario de direcciones define cada una contra este mismo catálogo.

Se publica desde esta dirección:

correosdemexico.gob.mx/SSLServicios/ConsultaCP/CodigoPostal_Exportar.aspx

Qué te entrega la exportación oficial

• Un formulario, no un endpoint.

  Eliges un estado o «Todos» y descargas. No hay una URL estable a la que apuntar, así que no hay nada que consultar de forma programada.

• Tres formatos.

  Excel con una hoja por estado, texto plano delimitado por el carácter de barra vertical, o XML.

• Una fecha de última actualización.

  Ahí termina la información de versión: no hay historial ni una diferencia publicada entre una versión y la siguiente.

Qué te deja por resolver

Nada de esto es una crítica al catálogo. Es un archivo de referencia nacional publicado de forma gratuita, no un producto, y estos son simplemente los trabajos que no hace por ti.

• Una codificación de texto heredada.

  La exportación de texto viene en Latin-1, no en UTF-8, así que cada nombre de colonia con acento llega mal hasta que se convierte.

• Filas planas, no un modelo relacional.

  Cada fila repite su estado, su municipio y su ciudad como texto. Convertir eso en tablas que puedas relacionar —y mantener los identificadores firmes mientras lo haces— te toca a ti.

• Detectar qué cambió.

  Sin un historial publicado, la única forma de saber qué se movió entre dos versiones es conservar ambas y compararlas por tu cuenta.

• Volver a hacerlo.

  Cada actualización es otro paso por el formulario, y después la misma conversión y la misma reconciliación que la primera vez.