Autocompletado que entiende errores de dedo.
Sugiere colonias mientras tu cliente escribe, aunque escriba «Monterey».
Guía: autocompletar la colonia en un formularioGET /v1/autocomplete?q=monterey cen&fuzzy=true
Para facturas, envíos y formularios: los datos de SEPOMEX, el SAT, el INEGI y CONAPO, cruzados, validados, servidos en milisegundos.
Validación con el catálogo del SAT
Valida el código postal y la colonia que escribe tu cliente, sugiere la correcta sin corregir en silencio y entrega las claves del SAT para el CFDI 4.0.
Desde que tu cliente escribe hasta que facturas o envías: búsqueda, consulta, claves fiscales, ubicación e historial, sobre los catálogos oficiales cruzados.
Sugiere colonias mientras tu cliente escribe, aunque escriba «Monterey».
Guía: autocompletar la colonia en un formularioGET /v1/autocomplete?q=monterey cen&fuzzy=true
Manda una coordenada y recibe su CP, o los CPs a la redonda, con los polígonos oficiales de SEPOMEX.
Guía: el código postal desde unas coordenadasGET /v1/reverse?lat=19.4195&lon=-99.162
→ "postal_code": "06700"
Pasa el cursor por un CP para verlo en el mapa.
Polígonos de CP: Servicio Postal Mexicano (SEPOMEX), datos.gob.mx, CC-BY-4.0, corte del 05/01/2026; simplificados por Colonix para esta ilustración.
Estado, municipio y colonias, en todos los planes. Desde Básico, la ubicación y la zona metropolitana, solo si las pides.
GET /v1/postal-codes/64000
{ "postal_code": "64000", "state": { "id": "19", "name": "Nuevo León" }, "municipality": { "id": "039", "name": "Monterrey" }, "settlements": [ "La Finca", "Monterrey Centro" ], "location": { "lat": 25.675964, "lon": -100.316726 }, "metro_area": { "name": "Monterrey", "type": "Zona metropolitana" }, "data_version": "2026.11.05-36a7823b"}Del catálogo del SAT, con el estímulo de la región fronteriza y hasta cuándo está vigente, y la hora local real del código postal.
Guía: validar una dirección para CFDI 4.0GET /v1/sat/postal-codes/22000
Estos cinco CPs de demostración responden con datos del SAT en cualquier plan, también en el gratuito.
Cada lunes lo revisamos y, si algo cambió, lo registramos: qué CPs y colonias se dieron de alta, de baja o cambiaron. El historial de cada CP está en todos los planes.
Guía: mantener tu catálogo al díaGET /v1/changes?since=2026.10.29-0384b36e
Actualización del 05/11/2026
También: consulta en lote de hasta 100 CPs por petición (desde Negocio), catálogos de estados, municipios y tipos de asentamiento, y la validación de CP y colonia que viste arriba.
Tu llave va en un encabezado. Recibes el CP con sus colonias y las claves del SAT, y si algo falla, un error que tu código puede leer.
colonix.silgaru.mx/v1/postal-codes/?include=sat
Sin llave responden los CPs de demostración:y uno que no existe:
curl -sS --fail-with-body \
-H "x-api-key: $COLONIX_API_KEY" \
"https://colonix.silgaru.mx/v1/postal-codes/06700?include=sat"const res = await fetch(
"https://colonix.silgaru.mx/v1/postal-codes/06700?include=sat",
{
headers: { "x-api-key": process.env.COLONIX_API_KEY },
signal: AbortSignal.timeout(5000),
},
);
const data = await res.json();
if (!res.ok) throw new Error(`${data.type}: ${data.detail}`);
console.log(data.settlements.map((s) => s.name));import os
import requests
res = requests.get(
"https://colonix.silgaru.mx/v1/postal-codes/06700",
params={"include": "sat"},
headers={"x-api-key": os.environ["COLONIX_API_KEY"]},
timeout=5,
)
data = res.json()
if not res.ok:
raise RuntimeError(f"{data['type']}: {data['detail']}")
print([s["name"] for s in data["settlements"]])$ch = curl_init(
"https://colonix.silgaru.mx/v1/postal-codes/06700?include=sat"
);
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => ["x-api-key: " . getenv("COLONIX_API_KEY")],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 5,
]);
$data = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) !== 200) {
throw new RuntimeException("{$data['type']}: {$data['detail']}");
}
print_r(array_column($data["settlements"], "name"));HTTP/1.1 200 OK
{ "postal_code": "06700", "state": {"id": "09", "name": "Ciudad de México"}, "municipality": {"id": "015", "name": "Cuauhtémoc"}, "office": "06401", "settlement_count": 1, "settlements": [ { "id": "09015-0947", "name": "Roma Norte", "type": "Colonia", "zone": "Urbano", "city": "Ciudad de México" } ], "sat": { "in_sat": true, "in_sepomex": true, "state": {"sat_code": "CMX", "id": "09", "name": "Ciudad de México"}, "municipality": {"sat_code": "015", "name": "Cuauhtémoc"}, "locality": {"sat_code": "06", "name": "Ciudad de México"}, "border_stimulus": null, "border_stimulus_decree": null, "time_zone": { "description": "Tiempo del Centro", "utc_offset_summer": -6, "utc_offset_winter": -6, "dst_start": null, "dst_end": null, "iana": "America/Mexico_City", "utc_offset_standard": -6, "utc_offset_dst": null, "matches_sat": true }, "settlements": [ { "c_colonia": "0947", "name": "Roma Norte", "settlement_id": "09015-0947", "match": "exact", "sepomex_name": "Roma Norte", "sepomex_candidate": null } ], "settlements_missing_in_sat": [], "sat_revision": { "file": "catCFDI_V_4_20261029.xls", "postal_codes": "8", "settlements": "0", "settlements_revised": false, "published": "2026-01-22" } }, "data_version": "2026.11.05-36a7823b"}HTTP/1.1 200 OK
{ "postal_code": "06700", "state": {"id": "09", "name": "Ciudad de México"}, "municipality": {"id": "015", "name": "Cuauhtémoc"}, "office": "06401", "settlement_count": 1, "settlements": [ { "id": "09015-0947", "name": "Roma Norte", "type": "Colonia", "zone": "Urbano", "city": "Ciudad de México" } ], "sat": { "in_sat": true, "in_sepomex": true, "state": {"sat_code": "CMX", "id": "09", "name": "Ciudad de México"}, "municipality": {"sat_code": "015", "name": "Cuauhtémoc"}, "locality": {"sat_code": "06", "name": "Ciudad de México"}, "border_stimulus": null, "border_stimulus_decree": null, "time_zone": { "description": "Tiempo del Centro", "utc_offset_summer": -6, "utc_offset_winter": -6, "dst_start": null, "dst_end": null, "iana": "America/Mexico_City", "utc_offset_standard": -6, "utc_offset_dst": null, "matches_sat": true }, "settlements": [ { "c_colonia": "0947", "name": "Roma Norte", "settlement_id": "09015-0947", "match": "exact", "sepomex_name": "Roma Norte", "sepomex_candidate": null } ], "settlements_missing_in_sat": [], "sat_revision": { "file": "catCFDI_V_4_20261029.xls", "postal_codes": "8", "settlements": "0", "settlements_revised": false, "published": "2026-01-22" } }, "data_version": "2026.11.05-36a7823b"}HTTP/1.1 200 OK
{ "postal_code": "44100", "state": {"id": "14", "name": "Jalisco"}, "municipality": {"id": "039", "name": "Guadalajara"}, "office": "44101", "settlement_count": 1, "settlements": [ { "id": "14039-0003", "name": "Guadalajara Centro", "type": "Colonia", "zone": "Urbano", "city": "Guadalajara" } ], "sat": { "in_sat": true, "in_sepomex": true, "state": {"sat_code": "JAL", "id": "14", "name": "Jalisco"}, "municipality": {"sat_code": "039", "name": "Guadalajara"}, "locality": {"sat_code": "03", "name": "Guadalajara"}, "border_stimulus": null, "border_stimulus_decree": null, "time_zone": { "description": "Tiempo del Centro", "utc_offset_summer": -6, "utc_offset_winter": -6, "dst_start": null, "dst_end": null, "iana": "America/Mexico_City", "utc_offset_standard": -6, "utc_offset_dst": null, "matches_sat": true }, "settlements": [ { "c_colonia": "0003", "name": "Guadalajara Centro", "settlement_id": "14039-0003", "match": "exact", "sepomex_name": "Guadalajara Centro", "sepomex_candidate": null } ], "settlements_missing_in_sat": [], "sat_revision": { "file": "catCFDI_V_4_20261029.xls", "postal_codes": "8", "settlements": "0", "settlements_revised": false, "published": "2026-01-22" } }, "data_version": "2026.11.05-36a7823b"}HTTP/1.1 200 OK
{ "postal_code": "64000", "state": {"id": "19", "name": "Nuevo León"}, "municipality": {"id": "039", "name": "Monterrey"}, "office": "64008", "settlement_count": 2, "settlements": [ { "id": "19039-3429", "name": "La Finca", "type": "Condominio", "zone": "Urbano", "city": "Monterrey" }, { "id": "19039-0001", "name": "Monterrey Centro", "type": "Colonia", "zone": "Urbano", "city": "Monterrey" } ], "sat": { "in_sat": true, "in_sepomex": true, "state": {"sat_code": "NLE", "id": "19", "name": "Nuevo León"}, "municipality": {"sat_code": "039", "name": "Monterrey"}, "locality": {"sat_code": "07", "name": "Monterrey"}, "border_stimulus": null, "border_stimulus_decree": null, "time_zone": { "description": "Tiempo del Centro", "utc_offset_summer": -6, "utc_offset_winter": -6, "dst_start": null, "dst_end": null, "iana": "America/Monterrey", "utc_offset_standard": -6, "utc_offset_dst": null, "matches_sat": true }, "settlements": [ { "c_colonia": "3429", "name": "La Finca", "settlement_id": "19039-3429", "match": "exact", "sepomex_name": "La Finca", "sepomex_candidate": null }, { "c_colonia": "0001", "name": "Monterrey Centro", "settlement_id": "19039-0001", "match": "exact", "sepomex_name": "Monterrey Centro", "sepomex_candidate": null } ], "settlements_missing_in_sat": [], "sat_revision": { "file": "catCFDI_V_4_20261029.xls", "postal_codes": "8", "settlements": "0", "settlements_revised": false, "published": "2026-01-22" } }, "data_version": "2026.11.05-36a7823b"}HTTP/1.1 200 OK
{ "postal_code": "22000", "state": {"id": "02", "name": "Baja California"}, "municipality": {"id": "004", "name": "Tijuana"}, "office": "22001", "settlement_count": 3, "settlements": [ { "id": "02004-0528", "name": "Zona Centro", "type": "Colonia", "zone": "Urbano", "city": "Tijuana" }, { "id": "02004-0530", "name": "Zona Este", "type": "Colonia", "zone": "Urbano", "city": "Tijuana" }, { "id": "02004-1824", "name": "Zona Norte", "type": "Colonia", "zone": "Urbano", "city": "Tijuana" } ], "sat": { "in_sat": true, "in_sepomex": true, "state": {"sat_code": "BCN", "id": "02", "name": "Baja California"}, "municipality": {"sat_code": "004", "name": "Tijuana"}, "locality": {"sat_code": "04", "name": "Tijuana"}, "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 Noroeste", "utc_offset_summer": -7, "utc_offset_winter": -8, "dst_start": "Marzo, Segundo domingo, 02:00", "dst_end": "Noviembre, Primer domingo, 02:00", "iana": "America/Tijuana", "utc_offset_standard": -8, "utc_offset_dst": -7, "matches_sat": true }, "settlements": [ { "c_colonia": "0528", "name": "Zona Centro", "settlement_id": "02004-0528", "match": "exact", "sepomex_name": "Zona Centro", "sepomex_candidate": null }, { "c_colonia": "0530", "name": "Zona Este", "settlement_id": "02004-0530", "match": "exact", "sepomex_name": "Zona Este", "sepomex_candidate": null }, { "c_colonia": "1824", "name": "Zona Norte", "settlement_id": "02004-1824", "match": "exact", "sepomex_name": "Zona Norte", "sepomex_candidate": null } ], "settlements_missing_in_sat": [], "sat_revision": { "file": "catCFDI_V_4_20261029.xls", "postal_codes": "8", "settlements": "0", "settlements_revised": false, "published": "2026-01-22" } }, "data_version": "2026.11.05-36a7823b"}HTTP/1.1 200 OK
{ "postal_code": "77500", "state": {"id": "23", "name": "Quintana Roo"}, "municipality": {"id": "005", "name": "Benito Juárez"}, "office": "77511", "settlement_count": 16, "settlements": [ { "id": "23005-0168", "name": "Cancún Centro", "type": "Colonia", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-1220", "name": "Juárez", "type": "Puerto", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-0648", "name": "Residencial La Cascada", "type": "Condominio", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-0480", "name": "Supermanzana 1 Centro", "type": "Colonia", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-0481", "name": "Supermanzana 2 Centro", "type": "Colonia", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-0479", "name": "Supermanzana 20 Centro", "type": "Colonia", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-0486", "name": "Supermanzana 22 Centro", "type": "Colonia", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-0487", "name": "Supermanzana 23 Centro", "type": "Colonia", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-0482", "name": "Supermanzana 2a Centro", "type": "Colonia", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-0483", "name": "Supermanzana 3 Centro", "type": "Colonia", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-0703", "name": "Supermanzana 4 A", "type": "Colonia", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-0484", "name": "Supermanzana 4 Centro", "type": "Colonia", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-0485", "name": "Supermanzana 5 Centro", "type": "Colonia", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-0673", "name": "Supermanzana 52", "type": "Colonia", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-0017", "name": "Villas Tropicales", "type": "Fraccionamiento", "zone": "Urbano", "city": "Cancún" }, { "id": "23005-0488", "name": "Zona Hotelera", "type": "Zona comercial", "zone": "Urbano", "city": "Cancún" } ], "sat": { "in_sat": true, "in_sepomex": true, "state": {"sat_code": "ROO", "id": "23", "name": "Quintana Roo"}, "municipality": {"sat_code": "005", "name": "Benito Juárez"}, "locality": {"sat_code": "01", "name": "Cancún"}, "border_stimulus": null, "border_stimulus_decree": null, "time_zone": { "description": "Tiempo del Sureste", "utc_offset_summer": -5, "utc_offset_winter": -5, "dst_start": null, "dst_end": null, "iana": "America/Cancun", "utc_offset_standard": -5, "utc_offset_dst": null, "matches_sat": true }, "settlements": [ { "c_colonia": "0168", "name": "Cancún Centro", "settlement_id": "23005-0168", "match": "exact", "sepomex_name": "Cancún Centro", "sepomex_candidate": null }, { "c_colonia": "1220", "name": "Juárez", "settlement_id": "23005-1220", "match": "exact", "sepomex_name": "Juárez", "sepomex_candidate": null }, { "c_colonia": "0480", "name": "Supermanzana 1 Centro", "settlement_id": "23005-0480", "match": "exact", "sepomex_name": "Supermanzana 1 Centro", "sepomex_candidate": null }, { "c_colonia": "0481", "name": "Supermanzana 2 Centro", "settlement_id": "23005-0481", "match": "exact", "sepomex_name": "Supermanzana 2 Centro", "sepomex_candidate": null }, { "c_colonia": "0479", "name": "Supermanzana 20 Centro", "settlement_id": "23005-0479", "match": "exact", "sepomex_name": "Supermanzana 20 Centro", "sepomex_candidate": null }, { "c_colonia": "0486", "name": "Supermanzana 22 Centro", "settlement_id": "23005-0486", "match": "exact", "sepomex_name": "Supermanzana 22 Centro", "sepomex_candidate": null }, { "c_colonia": "0487", "name": "Supermanzana 23 Centro", "settlement_id": "23005-0487", "match": "exact", "sepomex_name": "Supermanzana 23 Centro", "sepomex_candidate": null }, { "c_colonia": "0482", "name": "Supermanzana 2a Centro", "settlement_id": "23005-0482", "match": "exact", "sepomex_name": "Supermanzana 2a Centro", "sepomex_candidate": null }, { "c_colonia": "0483", "name": "Supermanzana 3 Centro", "settlement_id": "23005-0483", "match": "exact", "sepomex_name": "Supermanzana 3 Centro", "sepomex_candidate": null }, { "c_colonia": "0703", "name": "Supermanzana 4 A", "settlement_id": "23005-0703", "match": "exact", "sepomex_name": "Supermanzana 4 A", "sepomex_candidate": null }, { "c_colonia": "0484", "name": "Supermanzana 4 Centro", "settlement_id": "23005-0484", "match": "exact", "sepomex_name": "Supermanzana 4 Centro", "sepomex_candidate": null }, { "c_colonia": "0485", "name": "Supermanzana 5 Centro", "settlement_id": "23005-0485", "match": "exact", "sepomex_name": "Supermanzana 5 Centro", "sepomex_candidate": null }, { "c_colonia": "0673", "name": "Supermanzana 52", "settlement_id": "23005-0673", "match": "exact", "sepomex_name": "Supermanzana 52", "sepomex_candidate": null }, { "c_colonia": "0017", "name": "Villas Tropicales", "settlement_id": "23005-0017", "match": "exact", "sepomex_name": "Villas Tropicales", "sepomex_candidate": null }, { "c_colonia": "0488", "name": "Zona Hotelera", "settlement_id": "23005-0488", "match": "exact", "sepomex_name": "Zona Hotelera", "sepomex_candidate": null } ], "settlements_missing_in_sat": [ {"id": "23005-0648", "name": "Residencial La Cascada", "sat_candidate": null} ], "sat_revision": { "file": "catCFDI_V_4_20261029.xls", "postal_codes": "8", "settlements": "0", "settlements_revised": false, "published": "2026-01-22" } }, "data_version": "2026.11.05-36a7823b"}HTTP/1.1 404 Not Found
{ "type": "/errors/postal-code-not-found", "title": "Postal code not found", "status": 404, "detail": "Postal code 00000 does not exist in the current catalog."}HTTP/1.1 400 Bad Request
{ "type": "/errors/invalid-parameter", "title": "Invalid parameter", "status": 400, "detail": "The postal code must have 5 digits."}Necesita tu llave
Aquí, sin llave, solo responden los CPs de demostración. Con tu llave, el y cualquier otro CP del catálogo.
Crear cuentaETag · X-Data-Version
La versión del dato. Solo cambia cuando cambia el catálogo o la forma en que unimos SEPOMEX y el SAT, así tu caché sabe cuándo renovarse.
Cache-Control
Un día en caché, y hasta una semana más con la copia anterior mientras se renueva o si algo falla.
sat.settlements
La clave c_Colonia de cada colonia para el CFDI 4.0, y en settlements_missing_in_sat las que el SAT no tiene.
type · detail
Si algo falla, un error RFC 9457 con un type fijo que tu código puede leer.
El contrato OpenAPI 3.1, la colección de Postman y el servidor MCP para tu asistente de IA vienen en la documentación. Ver documentación
Elige tu caso: en qué momento de tu flujo entra Colonix y qué plan necesitas.
En el CFDI 4.0, el CP del receptor debe coincidir con su domicilio fiscal, y complementos como Carta Porte piden las claves del catálogo del SAT.
Valida el CP y la colonia contra el catálogo antes de guardarlos, con su clave c_Colonia.
GET /v1/validate/postal-code-settlement?postal_code=44100&settlement=Guadalajara Centro&include=sat
→ "outcome": "valid", "c_colonia": "0003"
Las claves de estado, municipio y localidad salen del mismo catálogo que usa el SAT.
GET /v1/sat/postal-codes/44100
→ c_Estado "JAL", c_Municipio "039", c_Localidad "03"
Cada lunes revisamos el catálogo de SEPOMEX. Pregunta qué cambió desde tu versión.
GET /v1/changes?since=2026.10.29-0384b36e
→ 32 altas, 5 bajas y 45 modificaciones (05/11/2026)
Lo que necesitas: Plan Básico (cambios del catálogo, desde Negocio)
Una colonia mal escrita es un paquete que regresa. Mejor que tu cliente la elija a que la escriba.
El estado y el municipio se llenan solos, y le ofreces sus colonias.
GET /v1/postal-codes/77500
→ Quintana Roo, Benito Juárez, 16 colonias
Sugerencias mientras escribe, aunque se equivoque de letra.
GET /v1/autocomplete?q=supermansana 23 c&fuzzy=true
→ "Supermanzana 23 Centro", 77500
Si la escribió a mano, la validación sugiere la correcta y tu cliente decide.
GET /v1/validate/postal-code-settlement?postal_code=77500&settlement=Sm 23
→ "valid": false, ¿Supermanzana 23 Centro?
Lo que necesitas: Plan Gratis, 10,000 consultas al mes
Para saber si llegas, a qué ruta va un envío y qué claves lleva el traslado, el CP tiene que salir de un punto en el mapa.
Los CPs a la redonda de tu almacén, del más cercano al más lejano.
GET /v1/nearby?lat=25.7756&lon=-100.1937&radius_km=3
→ 7 CPs: 66600 a 0.19 km, 66604 a 1.13 km…
El CP del punto que reporta el GPS del repartidor o el mapa de tu app.
GET /v1/reverse?lat=25.6866&lon=-100.3161
→ "postal_code": "64490", Monterrey
Las claves del SAT del origen y del destino, del catálogo vigente.
GET /v1/sat/postal-codes/64490
→ "NLE", "039", "07", c_Colonia "0275"
Lo que necesitas: Plan Básico
Un domicilio que no existe, o que no corresponde con donde está tu cliente, merece una segunda revisión.
Confirma que el CP y la colonia declarados existen y se corresponden.
GET /v1/validate/postal-code-settlement?postal_code=03100&settlement=Del Valle Centro
→ "outcome": "valid", "match": "exact"
Con permiso de tu cliente, el CP de donde está: una señal para revisar, no una prueba.
GET /v1/reverse?lat=19.3832&lon=-99.1670
→ "postal_code": "03100", el mismo que declaró
Hasta 100 CPs por petición, con found en cada uno para separar los que ya no existen.
GET /v1/postal-codes/batch?codes=03100,06700,…
→ "found": true o false por cada CP
Lo que necesitas: Plan Básico (lote, desde Negocio)
Colonix no inventa datos: limpia y cruza los catálogos públicos, revisa SEPOMEX y el SAT cada lunes, y te dice dónde no coinciden.
SEPOMEX
Servicio Postal Mexicano
Los códigos postales y sus colonias, con tipo, zona y municipio, y el área de cada CP.
Catálogo: 05/11/2026 Polígonos: 05/01/2026
SAT
Servicio de Administración Tributaria
Las claves del CFDI 4.0 por CP y colonia, el estímulo de la región fronteriza y el huso horario.
Catálogo: 22/01/2026
INEGI
Instituto Nacional de Estadística y Geografía
Las localidades con las que se ubican los CPs que no tienen polígono.
Catálogo oficial
CONAPO
Consejo Nacional de Población
Las 92 metrópolis del país y sus 421 municipios, para include=metro.
Delimitación oficial
La versión del dato viaja en cada respuesta
colonias de SEPOMEX sin clave c_Colonia en el catálogo del SAT, ni con su nombre ni escrito de otra forma. Te enteras antes de timbrar.
settlements_missing_in_sat
de esas probablemente son una colonia del SAT con el nombre escrito distinto, como «Dolores Tlalli» y «Dolores Tlali». Te la sugerimos para que la confirmes; nunca la damos como la clave. Cómo decidimos.
sat_candidate
colonias que el SAT escribe de otra forma, como «Buena Vista» y «Buenavista» o «Ojo de Agua» y «El Ojo de Agua». Son la misma, y te damos su clave.
match: equivalent
códigos postales que el SAT acepta y que no están en el catálogo de SEPOMEX.
in_sat · in_sepomex
CPs sin polígono, ubicados por su localidad del INEGI (461) o por su municipio (76). La respuesta dice cuál, y nunca los presenta como exactos.
location.precision
áreas de CP en los polígonos de SEPOMEX que no tienen colonias en su catálogo.
in_sepomex_catalog
Cada versión pasa por revisiones de calidad antes de publicarse: si una fuente llega incompleta, no se publica y la API sigue con la versión anterior. Fuentes y licencias
Con el dato del 05/11/2026. SEPOMEX dice qué colonias tiene cada código postal; el SAT, qué claves lleva tu factura. Aquí no coinciden.
El SAT de un código postal viene desde el plan Básico
¿Y cuando el SAT escribe distinto el nombre de una colonia? Eso tiene su propia guía. Cómo unimos los nombres.
21320 Mexicali, Baja California
Para tu factura: sabes que la colonia de tu cliente todavía no tiene clave antes de llenar un complemento con ella.
Ninguna de las 28 colonias que SEPOMEX agregó el 05/11/2026 tiene clave del SAT todavía.
85772 Álamos, Sonora
Para tu factura: no hay clave de colonia que buscar, y te lo decimos para que no la busques.
Como este, 1,566 códigos postales: 3,581 colonias de SEPOMEX sin ninguna en el SAT.
91312 Banderilla, Veracruz
Para tu factura: una factura con este código postal se rechaza. Te enteras antes de timbrar.
Es el único código postal de SEPOMEX que falta en el catálogo del SAT.
26200 Acuña, Coahuila
Para tu factura: sabes si el código postal está en la región del estímulo fiscal fronterizo y en qué huso horario, sin otra fuente.
1,920 códigos postales están en la región del estímulo (1,555 en la frontera norte y 365 en la sur). Y cada código postal trae su huso horario: hay 5 en el país.
Todos los planes usan los mismos datos y la misma velocidad. Cambia lo que puedes pedir y cuánto.
Para empezar y para formularios con poco tráfico
$0
Sin costo
10,000 consultas al mes
Sin tarjeta
Incluye:
Para empresas que facturan y envían
$199
MXN al mes, IVA incluido
100,000 consultas al mes
14 días de prueba
Todo lo de Gratis, más:
Para plataformas, ERPs e integradores
$599
MXN al mes, IVA incluido
1,000,000 consultas al mes
14 días de prueba
Todo lo de Básico, más:
Para volumen alto y condiciones propias
desde$1,999
MXN al mes, IVA incluido
5,000,000 consultas al mes
14 días de prueba
Todo lo de Negocio, más:
Los planes de pago se solicitan. Te respondemos en máximo 3 días hábiles y, si la aprobamos, empiezas con 14 días de prueba, con todo lo que habilita el plan.
Sin cargos sorpresa. Al llegar a tu cuota, la API responde 429 hasta el mes siguiente o hasta que cambies de plan. Nunca te cobramos de más.
Lo que suelen preguntar antes de integrar Colonix. El detalle técnico está en la documentación.
Ver documentación¿Tu duda es sobre los códigos postales, el SAT o Carta Porte? Lee las guías de Aprende.
De cuatro instituciones públicas: el Servicio Postal Mexicano (SEPOMEX), el SAT, el INEGI y CONAPO. En Fuentes y licencias te contamos qué aporta cada una.
Cada lunes revisamos los catálogos de SEPOMEX y del SAT. Si algo cambió, lo revisamos antes de publicarlo y queda registrado, para que sepas qué códigos postales y colonias son nuevos, cuáles desaparecieron y cuáles cambiaron.
Los limpia, los cruza y los mantiene al día. Une cada código postal con sus claves del SAT, lo ubica en el mapa, le asigna su zona metropolitana, entiende cuando alguien escribe una colonia con errores y guarda el historial de cambios. Tú haces una sola consulta y recibes todo junto.
Cada código postal tiene un punto de referencia, no una dirección exacta: sirve para ubicar la zona, no una casa. Casi siempre es el centro del área oficial del código postal; en los pocos que no tienen área usamos su localidad o su municipio, y la respuesta te dice cuál fue, para que sepas qué tan preciso es. Las coordenadas vienen desde el plan Básico.
Cada respuesta correcta cuenta como una consulta, y si pides varios códigos postales a la vez, cuenta uno por cada uno. Los errores no cuentan: si buscas un código postal que no existe, no se descuenta de tu cuota.
Te avisamos por correo al llegar al 80 % y al 100 %. Al llegar a tu cuota dejamos de responder hasta que empiece el mes siguiente o hasta que cambies de plan. Nunca te cobramos de más por pasarte.
No. Colonix es un servicio de consulta, no una copia del catálogo. Si necesitas tener al día tus propios códigos postales, puedes consultarlos en grupos de hasta 100 y preguntar qué cambió desde la última vez.
Por ahora, desde tu servidor, para que tu llave no quede a la vista en tu página: tu formulario le pregunta a tu sistema y tu sistema a Colonix.
Sí. Con el servidor MCP de Colonix, que corre en tu computadora con tu llave, Claude, Cursor u otro asistente consulta códigos postales, colonias y, según tu plan, las claves del SAT, solo para leer. Cada consulta cuenta en tu plan igual que una llamada a la API; cuando el asistente lee la documentación de Colonix que trae el servidor, no cuenta. Cómo instalarlo: Colonix en tu asistente de IA.
En silgaru.mx/colonix/docs. Ahí está cómo hacer tu primera consulta en un par de minutos, cómo funcionan las llaves y los planes, qué significa cada error y cómo resolverlo, y guías para casos comunes: validar una dirección para facturar, autocompletar la colonia en un formulario o encontrar el código postal de un punto en el mapa. También hay una colección de Postman para probarla sin escribir código.
Porque Silgaru es la empresa que hace Colonix. Tu cuenta es de Silgaru: con ella entras en cuenta.silgaru.mx, creas tus llaves de Colonix y, cuando lancemos otros productos, los usarás con la misma cuenta. Los correos de tu cuenta llegan de cuenta@silgaru.mx.
Con el botón «Solicitar» del plan que te interesa. Te respondemos y, si la aprobamos, empiezas con 14 días de prueba, con todo lo que incluye el plan.
Desde tu cuenta, en «Escríbenos»: lo lee una persona y te responde a tu correo. También puedes escribir a contacto@silgaru.mx. Lo de tu cuenta (tus llaves, tu plan o tus datos) solo lo atendemos desde tu panel o desde el correo de tu cuenta, y nunca te pedimos tu código para entrar ni tus llaves.
Sí. Los precios y el cobro son en pesos mexicanos; tu banco hace la conversión al tipo de cambio del día.
Solo lo necesario para contar tu uso y revisar, de forma automática, que nadie lo use para copiar el catálogo: qué consulta hiciste (por ejemplo, qué código postal pediste) y si salió bien, sin lo que mandas aparte, como el nombre de una colonia o unas coordenadas. Esos registros se borran a los 30 días; después solo queda cuántas consultas hiciste en el mes. Tu dirección IP la usamos para proteger el servicio y la guardamos poco tiempo, solo por seguridad. El detalle está en el aviso de privacidad.
10,000 consultas al mes sin costo. Sin tarjeta. Haz tu primera consulta hoy.