Ir al contenido

Diferencias entre los catálogos del SAT y de SEPOMEX

GET/v1/sat/discrepanciesNegocio y Enterprise

¿Qué hace?

Dónde no coinciden los catálogos del SAT y de SEPOMEX: códigos postales o asentamientos que existen en uno y no en el otro. Sirve para encontrar las direcciones que darán problemas al facturar.

Ordenados por código postal. Un asentamiento coincide cuando el código postal es el mismo y el nombre es el mismo o equivalente (las reglas de la validación: mayúsculas, acentos, abreviaturas comunes, el tipo de asentamiento al inicio, espacios y artículos); esos no son diferencias. Cuando los nombres no coinciden pero probablemente son el mismo lugar, possible_match sugiere la pareja en el otro catálogo; sigue en la lista hasta que la confirmes. Paginada: sigue next_cursor.

Para facturar, lo que importa es missing_in=sat: un código postal que SEPOMEX tiene y el SAT no se rechaza en un CFDI, y un asentamiento sin pareja en el SAT no tiene clave c_Colonia para Carta Porte ni Comercio Exterior. Casi todas las diferencias de códigos postales van al revés (missing_in=sepomex): códigos que solo están en el SAT, y esos son válidos en un CFDI.

La petición

ParámetroTipoValores aceptadosDescripción
entityen la consultaobligatoriotexto
postal_codesettlement
Qué comparar.
missing_inen la consultatexto
satsepomex
Solo lo que falta en este catálogo (por omisión, ambos).
stateen la consultatexto
2 dígitos
Clave INEGI del estado, 2 dígitos (ver /v1/states).
limiten la consultaentero
de 1 a 500
por omisión: 50
Tamaño de página (1–500, 50 por omisión). No existe un valor "sin límite": para obtener todos los resultados, sigue next_cursor hasta que sea null.
cursoren la consultatexto—Valor opaco de next_cursor de la página anterior, enviado tal cual. Solo vale para la versión del dato que lo emitió (si no, 400 /errors/cursor-expired).

Ejemplo

curl -H "x-api-key: TU_LLAVE" "https://colonix.silgaru.mx/v1/sat/discrepancies?entity=settlement&limit=2"

Cambia TU_LLAVE por tu llave; en los lenguajes, se lee de la variable de entorno COLONIX_API_KEY. Esta petición es la que produjo la respuesta de abajo.

La respuesta

Respuesta real a la petición del ejemplo. Viene con los encabezados ETag, X-Data-Version, Cache-Control.

200 OK
{
"data": [
{
"entity": "settlement",
"postal_code": "01048",
"missing_in": "sepomex",
"state": {
"id": "09",
"name": "Ciudad de México"
},
"sepomex": null,
"sat": {
"c_colonia": "0013",
"name": "Las Águilas"
},
"possible_match": null
},
{
"entity": "settlement",
"postal_code": "01100",
"missing_in": "sepomex",
"state": {
"id": "09",
"name": "Ciudad de México"
},
"sepomex": null,
"sat": {
"c_colonia": "0029",
"name": "Lomas de Santo Domingo"
},
"possible_match": null
}
],
"next_cursor": "MjAyNi4xMS4wNS0zNmE3ODIzYnwx",
"data_version": "2026.11.05-36a7823b"
}

Campos

CampoTipoDescripción
datalista de objetos
data[].entitytextoQué difiere
postal_codesettlement
data[].postal_codetextoCódigo postal de 5 dígitos (conserva los ceros iniciales). Con 4 dígitos, si existe el código con un cero adelante, el detail del 400 lo sugiere (las hojas de cálculo convierten 09700 en 9700).
data[].missing_intextoCatálogo en el que falta
satsepomex
data[].stateobjeto o nullEstado (clave INEGI), o null si no se conoce
data[].sepomexobjeto o nullRegistro en SEPOMEX (un PostalCodeRecord o un Settlement), o null si falta en SEPOMEX
data[].satobjeto o nullRegistro en el SAT (el código postal con sus claves del SAT, o la colonia con su c_Colonia), o null si falta en el SAT
data[].possible_matchobjeto o nullSolo en asentamientos: la pareja probable en el otro catálogo (SatCandidate si falta en el SAT, SepomexCandidate si falta en SEPOMEX), o null
next_cursortexto o nullCursor opaco de la página siguiente; null si no hay más resultados.
data_versiontextoVersión del dato

Errores

Todos en formato application/problem+json; ninguno cuenta para tu cuota. Qué hacer con cada uno: Errores.

EstadoCuándo
400Parámetro inválido o repetido (/errors/invalid-parameter), un parámetro que el endpoint no tiene (/errors/unknown-parameter), cursor vencido (/errors/cursor-expired), versión del dato desconocida (/errors/unknown-version) o as_of fuera del historial registrado (/errors/as-of-out-of-range).
401Credenciales faltantes (/errors/missing-api-key) o inválidas (/errors/invalid-api-key).
403Llave suspendida (/errors/api-key-suspended) o endpoint fuera de tu plan (/errors/plan-not-allowed).
429Se alcanzó la cuota mensual (/errors/quota-exceeded) o el límite por minuto (/errors/rate-limited). La respuesta del límite por minuto trae el mismo cuerpo, pero con Content-Type: application/json.
5XXError inesperado (/errors/internal-error) o servicio no disponible por un momento (503, que puede llegar sin cuerpo). Reintenta unas cuantas veces, esperando cada vez más.