Buscar claves de unidad
GEThttps://api.cfdi.express/v1/catalogs/unitsAPI key
Búsqueda por palabra clave sobre el catálogo c_ClaveUnidad. Devuelve clave, nombre y símbolo.
Las más usadas en comercio: H87 (pieza), E48 (unidad de servicio), ACT (actividad), KGM (kilogramo).
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. |
| limit | integer | Resultados a devolver. Entre 1 y 100. Default 20. |
Ejemplos
cURL
curl -G https://api.cfdi.express/v1/catalogs/units \
-H "Authorization: Bearer sk_test_..." \
--data-urlencode "keyword=pieza"Respuesta
200 OK
{
"object": "list",
"data": [
{ "clave": "H87", "nombre": "Pieza", "simbolo": null },
{ "clave": "EA", "nombre": "Elemento", "simbolo": null }
]
}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. |