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{ "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.
Una colonia que solo está en el SAT
Section titled “Una colonia que solo está en el SAT”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{ "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.
Si alguien la escribe
Section titled “Si alguien la escribe”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{ "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:
{ "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.
¿Está en otro código postal?
Section titled “¿Está en otro código postal?”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{ "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.
Dos colonias con el mismo nombre
Section titled “Dos colonias con el mismo nombre”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{ "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.
Un código postal sin colonias en el SAT
Section titled “Un código postal sin colonias en el SAT”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{ "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.
Un código postal que el SAT no tiene
Section titled “Un código postal que el SAT no tiene”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{ "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.
Lo que solo dice el SAT
Section titled “Lo que solo dice el 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{ "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.
En resumen
Section titled “En resumen”| 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).
© 2026 Silgaru