Buscar claves de producto y servicio
GEThttps://api.cfdi.express/v1/catalogs/productsAPI key
Búsqueda por palabra clave sobre las más de 52 000 claves del catálogo c_ClaveProdServ, incluidos los sinónimos del SAT.
Es la forma correcta de resolver el productCode de tus conceptos antes de timbrar. Si no encuentras una clave específica, 01010101 (no existe en el catálogo) es el comodín permitido.
Autenticación
Authorization: Bearer sk_test_... | sk_live_...Parámetros
Query string
| Campo | Tipo | Descripción |
|---|---|---|
| keyword | string | Texto a buscar, de 1 a 120 caracteres. Sin él devuelve las primeras claves. |
| limit | integer | Resultados a devolver. Entre 1 y 100. Default 20. |
Ejemplos
cURL
curl -G https://api.cfdi.express/v1/catalogs/products \
-H "Authorization: Bearer sk_test_..." \
--data-urlencode "keyword=teclado" \
--data-urlencode "limit=3"Respuesta
200 OK
{
"object": "list",
"data": [
{ "clave": "43201808", "nombre": "Teclados" },
{ "clave": "43211706", "nombre": "Teclados de computadora" },
{ "clave": "56101804", "nombre": "Teclados musicales" }
]
}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. |