Documentación de la API
Catálogos SAT expone los catálogos oficiales del SAT mediante una API REST pública. Todas las consultas requieren una API key válida enviada en el encabezado Authorization: Bearer <token>.
Temas
- Autenticación
- Integración entre aplicaciones (aplicaciones, scopes, emisores compartidos y API de gestión)
- Validación de CFDI 4.0
- Generación de CFDI 4.0
- Timbrado de CFDI
- Servidor MCP
- Especificación OpenAPI
- c_ClaveProdServ
- c_FormaPago
- c_Moneda
- c_RegimenFiscal
- c_UsoCFDI
- c_ClaveUnidad
- c_CodigoPostal
- c_Colonia
- c_Estado
- c_Localidad
- c_Municipio
- c_Exportacion
- c_Impuesto
- c_Meses
- c_MetodoPago
- c_ObjetoImp
- c_Pais
- c_Periodicidad
- c_TipoDeComprobante
- c_TipoFactor
- c_TipoRelacion
- matriz_errores
Catálogos disponibles
| Catálogo | Descripción | Descarga local |
|---|---|---|
| c_ClaveProdServ | Consulta el catálogo de productos y servicios del SAT. | No |
| c_FormaPago | Consulta el catálogo de formas de pago del SAT. | Sí |
| c_Moneda | Consulta el catálogo de monedas del SAT. | Sí |
| c_RegimenFiscal | Consulta el catálogo de regímenes fiscales del SAT. | Sí |
| c_UsoCFDI | Consulta el catálogo de usos de comprobantes (CFDI) del SAT. | Sí |
| c_ClaveUnidad | Consulta el catálogo de unidades de medida para los conceptos del CFDI. | Sí |
| c_CodigoPostal | Consulta el catálogo de códigos postales de México con su desglose territorial (estado, municipio y localidad). | No |
| c_Colonia | Consulta el catálogo de colonias (asentamientos) de México, filtrable por código postal. | No |
| c_Estado | Consulta el catálogo de estados. Por defecto filtra por México (pais=MEX); se puede indicar otro país. | Sí |
| c_Localidad | Consulta el catálogo de localidades de México, filtrable por estado. | Sí |
| c_Municipio | Consulta el catálogo de municipios de México, filtrable por estado. | Sí |
| c_Exportacion | Consulta el catálogo de tipos de exportación del SAT. | Sí |
| c_Impuesto | Consulta el catálogo de impuestos del SAT. | Sí |
| c_Meses | Consulta el catálogo de meses del SAT. | Sí |
| c_MetodoPago | Consulta el catálogo de métodos de pago del SAT. | Sí |
| c_ObjetoImp | Consulta el catálogo de objetos de impuesto del SAT. | Sí |
| c_Pais | Consulta el catálogo de países del SAT. | Sí |
| c_Periodicidad | Consulta el catálogo de periodicidades de pago del SAT. | Sí |
| c_TipoDeComprobante | Consulta el catálogo de tipos de comprobante del SAT. | Sí |
| c_TipoFactor | Consulta el catálogo de tipos de factor del SAT. | Sí |
| c_TipoRelacion | Consulta el catálogo de tipos de relación entre CFDI del SAT. | Sí |
| matriz_errores | Matriz de códigos de error de validación del CFDI 4.0 del SAT. No es un catálogo c_*, pero se consulta con el mismo formato. | Sí |
Caché local de catálogos
Los catálogos marcados con Sí en "Descarga local" son pequeños y conviene guardarlos en tu aplicación en lugar de consultarlos en cada operación:
- Descarga el catálogo completo con
GET /api/v1/catalogos/<nombre>/descarga(responde{"data": [...], "total": N}, sin paginación). - Guarda localmente las entradas junto con la
version_instaladaque reportaGET /api/v1/version. - Consulta
GET /api/v1/versionperiódicamente; siversion_instaladacambió, vuelve a descargar los catálogos.
Los catálogos grandes (c_ClaveProdServ, c_CodigoPostal y c_Colonia) no admiten descarga completa: consúltalos por búsqueda paginada en /entradas.