Ir al contenido

Casos reales del cruce entre el SAT y SEPOMEX

SEPOMEX y el SAT publican dos catálogos de códigos postales que no siempre coinciden. Una colonia puede existir en SEPOMEX y no tener clave en el SAT; un código postal puede estar en uno y faltar en el otro; y el SAT sabe cosas de cada código postal que SEPOMEX no publica. Esta página muestra seis casos reales, con la respuesta de Colonix y qué hacer en cada uno.

Necesitas: plan Básico o superior para /v1/sat/postal-codes/{code} y para include=sat e include=cfdi en la validación. Los casos son del dato 2026.11.05-36a7823b; la API siempre responde con el dato vigente, que puede haber cambiado.

Cuando la diferencia es solo cómo se escribe el nombre de una colonia (“Villa Centroamericana” y “Villa Centro Americana”), Colonix los une o te sugiere la colonia del SAT: eso lo explica la guía del emparejamiento. Aquí están los casos en los que la diferencia es de fondo.

Una colonia nueva que el SAT aún no tiene

Section titled “Una colonia nueva que el SAT aún no tiene”

SEPOMEX agrega colonias casi cada semana; el SAT nunca ha publicado una revisión de su catálogo de colonias (settlements_revised: false, ver por qué hay colonias sin clave). El 05/11/2026, SEPOMEX agregó 28 colonias y ninguna tiene todavía clave del SAT. Una de ellas es “Punto Sur”, en el 21320 (Mexicali, Baja California). El mismo código postal sí tiene en el SAT “Camino Viejo”, con su clave 2571.

curl -H "x-api-key: TU_LLAVE" https://colonix.silgaru.mx/v1/sat/postal-codes/21320
200 OK (fragmento)
{
"postal_code": "21320",
"in_sat": true,
"settlements": [
{
"c_colonia": "2571",
"name": "Camino Viejo",
"settlement_id": "02002-2571",
"match": "exact",
"sepomex_name": "Camino Viejo",
"sepomex_candidate": null
},
{
"c_colonia": "0150",
"name": "Crnl. Esteban Cantú",
"settlement_id": null,
"match": null,
"sepomex_name": null,
"sepomex_candidate": {
"settlement_id": "02002-0150",
"name": "Esteban Cantú",
"similarity": 0.8,
"difference": "extra_words",
"same_key": true
}
},
{
"c_colonia": "0455",
"name": "Felipe Ángeles",
"settlement_id": "02002-0455",
"match": "exact",
"sepomex_name": "Felipe Ángeles",
"sepomex_candidate": null
}
],
"settlements_missing_in_sat": [
{
"id": "02002-0619",
"name": "Punto Sur",
"sat_candidate": null
}
]
}

La colonia nueva aparece en settlements_missing_in_sat, sin sat_candidate: el SAT no tiene ninguna que se le parezca. Cuando el SAT la agregue a su catálogo, pasará sola a settlements con su clave (o traerá una sugerencia, si el SAT la escribe distinto).

Qué hacer: no la ofrezcas donde tu comprobante pida c_Colonia. Si tu cliente vive ahí, pídele que elija otra colonia del código postal que sí tenga clave, o revisa el caso con él.

Al revés también pasa: el SAT tiene colonias que SEPOMEX no tiene en ese código postal. Puede ser que SEPOMEX la haya quitado, que le haya cambiado el código postal o que nunca la haya publicado ahí; los catálogos no dicen cuál. El historial de Colonix tampoco, todavía: empieza el 5 de octubre de 2026 (history_since en /v1/meta), así que de una colonia que SEPOMEX quitó antes no se puede saber cuándo. Si quita una de ahora en adelante, el historial del código postal (/v1/postal-codes/{code}/history) dirá en qué versión. El 09700 (Iztapalapa, Ciudad de México) tiene 4 colonias en SEPOMEX, todas con su clave del SAT, pero el SAT tiene 7: “Cuauhtémoc”, “Matamoros” y “Morelos II” no están en SEPOMEX con ese código postal.

curl -H "x-api-key: TU_LLAVE" https://colonix.silgaru.mx/v1/sat/postal-codes/09700
200 OK (fragmento: 4 de las 7 colonias del SAT)
{
"postal_code": "09700",
"in_sat": true,
"in_sepomex": true,
"settlements": [
{
"c_colonia": "1485",
"name": "Buenavista",
"settlement_id": "09007-1485",
"match": "exact",
"sepomex_name": "Buenavista",
"sepomex_candidate": null
},
{
"c_colonia": "2541",
"name": "Cuauhtémoc",
"settlement_id": null,
"match": null,
"sepomex_name": null,
"sepomex_candidate": null
},
{
"c_colonia": "1489",
"name": "Matamoros",
"settlement_id": null,
"match": null,
"sepomex_name": null,
"sepomex_candidate": null
},
{
"c_colonia": "1490",
"name": "Morelos II",
"settlement_id": null,
"match": null,
"sepomex_name": null,
"sepomex_candidate": null
}
],
"settlements_missing_in_sat": []
}

Una colonia de settlements con settlement_id: null y sin sepomex_candidate es una colonia del SAT sin pareja en SEPOMEX en ese código postal. En todo el país hay 18,036 así, en 7,855 códigos postales que SEPOMEX sí tiene.

Quien elige su colonia de la lista de SEPOMEX (el autocompletado o las colonias del código postal) nunca verá estas colonias, pero un domicilio escrito a mano, un registro viejo o uno copiado de un documento del SAT puede traerla. Con include=cfdi (o include=sat), la validación lo dice en outcome: sat_only, la colonia no está en SEPOMEX con ese código postal, pero el SAT sí la tiene ahí, y te da su clave:

curl -G -H "x-api-key: TU_LLAVE" https://colonix.silgaru.mx/v1/validate/postal-code-settlement \
--data-urlencode "postal_code=09700" --data-urlencode "settlement=Cuauhtémoc" -d include=cfdi
200 OK (fragmento)
{
"postal_code": "09700",
"query": "Cuauhtémoc",
"outcome": "sat_only",
"valid": false,
"match": "none",
"cfdi": {
"ready": true,
"address": {
"Colonia": "2541"
},
"fields": {
"Colonia": {
"status": "key",
"name": "Cuauhtémoc",
"in_sepomex": false
}
}
}
}

valid sigue en false porque SEPOMEX no la tiene, y in_sepomex: false lo repite en el nodo del CFDI; ready: true dice que el nodo cumple las reglas del SAT tal como está. Con include=sat, el bloque sat dice lo mismo con su propio status:

200 OK con include=sat (fragmento)
{
"sat": {
"status": "sat_only",
"settlement_in_sat": true,
"c_colonia": "2541",
"sat_name": "Cuauhtémoc"
}
}

Sin include, la validación solo responde por SEPOMEX: outcome nunca es sat_only.

De esas 18,036 colonias, 5,860 tienen el mismo nombre en SEPOMEX en otro código postal del mismo municipio. Puede ser la misma colonia con otro código postal o solo un nombre que se repite en el municipio, así que Colonix no las une. La validación te los muestra en found_in_other_postal_codes: primero los del mismo municipio, después los del mismo estado, nunca de otros estados. Y cuando además el número al final del settlement_id de SEPOMEX es la clave del SAT (4,824 de las 5,860), es casi seguro la misma colonia: sat.in_sepomex_postal_code dice en qué código postal la tiene SEPOMEX. Por ejemplo, el SAT tiene “Caltongo” en el 16090 (Xochimilco), con la clave 2431, y SEPOMEX la tiene en el 16083:

curl -G -H "x-api-key: TU_LLAVE" https://colonix.silgaru.mx/v1/validate/postal-code-settlement \
--data-urlencode "postal_code=16090" --data-urlencode "settlement=Caltongo" -d include=sat
200 OK (fragmento)
{
"postal_code": "16090",
"query": "Caltongo",
"outcome": "sat_only",
"found_in_other_postal_codes": [
{
"id": "09013-2431",
"postal_code": "16083",
"name": "Caltongo",
"type": "Barrio"
}
],
"sat": {
"status": "sat_only",
"c_colonia": "2431",
"in_sepomex_postal_code": "16083"
}
}

Qué hacer: si el domicilio es para un comprobante que pide c_Colonia, la clave del SAT sirve para ese código postal. Si es para entregar algo o para guardarlo como el domicilio de alguien, confírmalo con la persona: si la colonia aparece en otro código postal del municipio, pregúntale cuál es el suyo.

Un código postal puede tener dos colonias de SEPOMEX con el mismo nombre y distinto tipo, cada una con su clave del SAT. El 02240 (Azcapotzalco, Ciudad de México) tiene dos “San Andrés”, de tipo “Barrio” y “Pueblo”. Con solo el nombre no se sabe cuál es, así que la validación no elige: lo dice en outcome y te da las dos en same_name_settlements. Con include=cfdi, la colonia del nodo queda en null y choose trae cada una con su clave:

curl -G -H "x-api-key: TU_LLAVE" https://colonix.silgaru.mx/v1/validate/postal-code-settlement \
--data-urlencode "postal_code=02240" --data-urlencode "settlement=San Andrés" -d include=cfdi
200 OK (fragmento)
{
"postal_code": "02240",
"query": "San Andrés",
"outcome": "ambiguous",
"valid": true,
"settlement": null,
"same_name_settlements": [
{
"id": "09002-0398",
"name": "San Andrés",
"type": "Barrio"
},
{
"id": "09002-0399",
"name": "San Andrés",
"type": "Pueblo"
}
],
"cfdi": {
"ready": false,
"address": {
"Colonia": null
},
"fields": {
"Colonia": {
"status": "choose",
"options": [
{
"settlement_id": "09002-0398",
"name": "San Andrés",
"type": "Barrio",
"c_colonia": "0398"
},
{
"settlement_id": "09002-0399",
"name": "San Andrés",
"type": "Pueblo",
"c_colonia": "0399"
}
]
}
}
}
}

valid es true (el nombre sí es del código postal) y settlement es null. En todo el país, 951 veces un código postal tiene dos o más colonias con el mismo nombre (1,984 colonias); en 891 de esos casos sus claves del SAT son distintas. Con include=sat, sat.status es ambiguous y sat.options trae las mismas opciones.

Si la persona escribe el tipo al inicio (“Pueblo San Andrés”), la validación sí elige: el de ese tipo, con outcome: valid.

Qué hacer: pregúntale a la persona cuál es la suya mostrándole el tipo de cada una (en el ejemplo, barrio o pueblo) y usa el c_colonia de la que elija. Si guardas el domicilio, guarda también su settlement_id: así no tendrás que volver a preguntar.

Hay códigos postales que el SAT tiene en su catálogo, pero sin ninguna colonia. El 85772 (Álamos, Sonora) tiene 37 colonias en SEPOMEX y ninguna en el SAT, que además no le asigna municipio. Como este hay 1,566 códigos postales, con 3,581 colonias de SEPOMEX; y 1,247 códigos postales no tienen municipio en el SAT.

curl -H "x-api-key: TU_LLAVE" https://colonix.silgaru.mx/v1/sat/postal-codes/85772
200 OK (fragmento: 3 de las 37 colonias)
{
"postal_code": "85772",
"in_sat": true,
"municipality": null,
"settlements": [],
"settlements_missing_in_sat": [
{
"id": "26003-8744",
"name": "Agua Blanca",
"sat_candidate": null
},
{
"id": "26003-8753",
"name": "Aquinavo",
"sat_candidate": null
},
{
"id": "26003-8763",
"name": "Bavícora",
"sat_candidate": null
}
]
}

settlements viene vacío y municipality es null: no es un error de Colonix, es lo que publica el SAT.

Qué hacer: si tu comprobante necesita c_Colonia o c_Municipio para ese código postal, no hay una clave que buscar. No inventes una ni tomes la de un código postal vecino.

El 91312 (Banderilla, Veracruz) existe en SEPOMEX, con la colonia “La Haciendita”, pero no está en el catálogo de códigos postales del SAT. Es el único código postal de SEPOMEX en esta situación. La validación lo dice así:

curl -G -H "x-api-key: TU_LLAVE" https://colonix.silgaru.mx/v1/validate/postal-code-settlement \
--data-urlencode "postal_code=91312" --data-urlencode "settlement=La Haciendita" -d include=sat
200 OK (fragmento)
{
"postal_code": "91312",
"valid": true,
"match": "exact",
"sat": {
"postal_code_in_sat": false,
"settlement_in_sat": false,
"c_colonia": null
}
}

La dirección es válida para SEPOMEX ("valid": true), pero postal_code_in_sat es false.

Qué hacer: no timbres con ese código postal. Una factura se rechaza si el código postal del lugar de expedición o del domicilio fiscal del receptor no está en el catálogo del SAT.

SEPOMEX publica la dirección: las colonias, el municipio y el estado de cada código postal. El catálogo del SAT agrega dos datos más: si el código postal está en la región del estímulo fiscal fronterizo y su huso horario. El 26200 (Acuña, Coahuila) está en la región fronteriza norte, con “Tiempo del Centro en Frontera”:

curl -H "x-api-key: TU_LLAVE" https://colonix.silgaru.mx/v1/sat/postal-codes/26200
200 OK (fragmento)
{
"postal_code": "26200",
"border_stimulus": "north",
"border_stimulus_decree": {
"published": "2025-12-31",
"valid_until": "2026-12-31",
"requires_sat_notice": true,
"source": "https://dof.gob.mx/nota_detalle.php?codigo=5777697&fecha=31/12/2025"
},
"time_zone": {
"description": "Tiempo del Centro en Frontera",
"utc_offset_summer": -5,
"utc_offset_winter": -6,
"dst_start": "Marzo, Segundo domingo, 02:00",
"dst_end": "Noviembre, Primer domingo, 02:00",
"iana": "America/Matamoros",
"utc_offset_standard": -6,
"utc_offset_dst": -5,
"matches_sat": true
}
}

1,920 códigos postales de SEPOMEX están en la región del estímulo: 1,555 en la frontera norte (north) y 365 en la sur (south). Y el catálogo reparte los códigos postales en 5 husos horarios, con sus fechas de cambio al horario de verano donde aplica.

Qué hacer: usa border_stimulus para saber si el código postal está en la región, según el catálogo del SAT; si el estímulo te aplica depende de tu situación fiscal (el aviso ante el SAT) y de que el decreto siga vigente (border_stimulus_decree.valid_until). Usa time_zone.iana cuando necesites la hora local de un código postal, por ejemplo la del lugar de expedición; en dos franjas de la frontera de Chihuahua el catálogo del SAT no da la hora que se usa (matches_sat: false). Los detalles están en Validar una dirección para CFDI 4.0.

Lo que ves en la respuesta Qué significa Qué hacer
La colonia en settlements_missing_in_sat, sin sat_candidate El SAT no tiene clave para esa colonia (a veces, porque es nueva: el SAT nunca ha revisado su catálogo de colonias, settlements_revised: false) No la uses donde se pida c_Colonia
Una colonia en settlements con settlement_id: null y sin sepomex_candidate, o outcome: sat_only en la validación El SAT tiene esa colonia en el código postal y SEPOMEX no Para el CFDI, su clave sirve; para el domicilio, confírmalo con la persona (found_in_other_postal_codes y sat.in_sepomex_postal_code)
outcome: ambiguous y choose en la colonia del CFDI Dos colonias del código postal tienen ese nombre Que la persona elija por el tipo; usa su c_colonia y guarda su settlement_id
settlements: [] y municipality: null El SAT tiene el código postal, pero sin colonias ni municipio No hay clave que buscar: no la tomes de otro código postal
postal_code_in_sat: false (o in_sat: false) El código postal no está en el catálogo del SAT No timbres con él
border_stimulus y time_zone Lo que el SAT dice del código postal y SEPOMEX no El estímulo, según tu aviso ante el SAT y la vigencia del decreto; la hora local, con time_zone.iana

Para saber cuándo cambia cualquiera de estos casos (por ejemplo, cuando el SAT agrega una colonia), revisa la versión del dato en cada respuesta (data_version). Con el plan Negocio, /v1/sat/discrepancies lista los códigos postales y las colonias que están en un catálogo y no en el otro, también por estado. Para un solo código postal usa /v1/sat/postal-codes/{code}: /v1/sat/discrepancies no filtra por código postal (con postal_code responde 400 unknown-parameter).