Catálogos de retenciones y plataformas tecnológicas
GEThttps://api.cfdi.express/v1/catalogs/retenciones/{catalog}API key
Un catálogo del SAT por llamada: tipo de servicio, subtipo, forma de pago del servicio, periodicidad, tipo de pago de la retención y entidad federativa.
Desde la v1.43.0. Sirve las claves de POST /v1/retenciones. Cada llamada pide un catálogo: tipo-servicio (c_TipoDeServ), subtipo-servicio (c_SubTipoServ), forma-pago-servicio (c_FormaPagoServ), periodicidad (c_Periodicidad), tipo-pago-retencion (c_TipoPagoRet) o entidad-federativa (c_EntidadesFederativas).
Autenticación
Authorization: Bearer sk_test_... | sk_live_...El header x-account-id indica la cuenta. Si no eres miembro, la respuesta es 403.
Parámetros
Parámetros de ruta
| Campo | Tipo | Descripción |
|---|---|---|
| catalogreq | string | tipo-servicio, subtipo-servicio, forma-pago-servicio, periodicidad, tipo-pago-retencion o entidad-federativa. |
Ejemplos
cURL
curl https://api.cfdi.express/v1/catalogs/retenciones/tipo-servicio \
-H "Authorization: Bearer sk_test_..."Respuesta
200 OK
{
"object": "list",
"data": [
{ "clave": "05", "nombre": "Comercio de bienes" },
{ "clave": "06", "nombre": "Otro tipo de servicios" }
]
}Errores
| Status | code | Cuándo aparece |
|---|---|---|
| 401 | unauthorized | Falta el header Authorization o la llave es inválida. |
| 429 | rate_limited | Excediste el límite de requests por minuto de tu cuenta (300 por default). La respuesta incluye Retry-After. |
Notas
- Cada entrada trae
claveynombre. El ejemplo muestra dos claves detipo-servicio; la lista completa la devuelve el endpoint. Por MCP,get_catalogpide el mismo catálogo comoretenciones/tipo-servicio(yretenciones/forma-pago-servicio,retenciones/periodicidad,retenciones/subtipo-servicio,retenciones/tipo-pago-retencion,retenciones/entidad-federativa).