Busca productos del catalogo con filtros y paginacion

Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

Filtra por fragmento de nombre o SKU (q), SKU exactos, ids internos, categoria y subcategoria. Devuelve id, sku, nombre, categoria, estado, tipo y precio; con sucursal, la disponibilidad en esa sucursal (fila en cp_multi_stock con stock); con incluir_sucursales, la de todas. Un resultado vacio trae una nota con el tamaño del catalogo: vacio no significa que el negocio no tenga productos.


Scope requerido	`catalogo:read`
Método	`GET /ext/v3/catalogo/productos`

Query

Parámetro	Tipo	Requerido	Descripción
`q`	string	no	Fragmento del nombre o del SKU
`skus`	array	no	SKU exactos
`ids`	array	no	Ids internos (mp_productos_ecom.id; en la tienda en linea aparecen como "sku")
`categoria`	string	no	Categoria de Clau exacta (catalogo_categorias)
`subcategoria`	string	no
`sucursal`	string	no	tiendaId
`incluir_sucursales`	boolean	no	Default `false`.
`incluir_variantes`	boolean	no	Incluye variantes (productos con sku_parent) Default `false`.
`estado`	enum: activos \| todos	no	Default `"activos"`.
`page`	integer	no	Default `1`.
`page_size`	integer	no	Default `20`.

Ejemplo

curl -X GET 'https://api3.clau.io/ext/v3/catalogo/productos' \
  -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.