get
https://example.com
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Para cada termino devuelve estado: unico (SKU exacto, o nombre exacto de un solo producto: se puede usar sin preguntar), ambiguo (varios candidatos con nombre, SKU, categoria y disponibilidad: pregunte al usuario), sugerido (un solo parecido: confirme) o no_encontrado. El SKU es el que comparan las reglas de promociones (mp_productos_ecom.sku = pSku del POS); el id interno no se usa en reglas. Con sucursal agrega si el producto esta cargado y con stock en esa sucursal. Maximo 25 terminos.
| Scope requerido | catalogo:read |
| Método | GET /ext/v3/catalogo/productos/resolver |
Query
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
terminos | array | sí | Nombres o SKU tal como los dijo el usuario |
sucursal | string | no | tiendaId de la sucursal para ver disponibilidad (capacidades.sucursales) |
estado | enum: activos | todos | no | todos incluye productos inactivos (el POS puede seguir vendiendolos) Default "activos". |
Ejemplo
curl -X GET 'https://api3.clau.io/ext/v3/catalogo/productos/resolver' \
-H 'apikey: ck_1_...'Respuesta 200
{
"codigoRespuesta": 0,
"msj": "Exito",
"data": "…",
"meta": {
"requestId": "5f1c…",
"appId": 1,
"scope": "catalogo:read"
}
}Errores: 401 key inválida (9501), 403 sin scope (9503, meta.requiredScope), 400 parámetros (details), 429 límite de tasa. Agregue ?help=true para la ayuda en texto plano.
