API de catálogo2026-11Vista previa
Niveles de inventario
Cuántas unidades de una variante puedes vender ahora mismo: el stock del vendedor en China, más lo que guardes en nuestro almacén.
Los niveles cambian cuando volvemos a leer una publicación o se mueve tu estante. Suscríbete a product.out_of_stock en lugar de consultar periódicamente.
El objeto Inventory level
variant, product, skustring- Lo que cuenta.
seller_in_stockboolean- Si el vendedor puede venderlo, a fecha de checked_at.
seller_countinteger|null- La cantidad propia del vendedor, cuando la publicación la muestra.
warehouse_on_handinteger- Unidades tuyas en nuestro estante, revisadas y fotografiadas. Los pedidos salen primero de estas.
availableinteger- Lo que muestra tu tienda: tu estante más la cantidad del vendedor, con un tope de 100, ya que compramos bajo demanda. 0 cuando el vendedor no tiene stock y tu estante está vacío, o el producto está pausado.
checked_atstring- Cuándo leímos por última vez la publicación.
{
"variant": "var_41hz",
"product": "prd_8f2k",
"sku": "5187209554",
"seller_in_stock": true,
"seller_count": 812,
"warehouse_on_hand": 24,
"available": 124,
"checked_at": "2026-11-04T09:12:40Z"
}Listar niveles de inventario
GET/v1/inventory_levels
Cada variante que vendes, o las de un producto.
Alcanceinventory:read
Parámetros de consulta
productstring- Opcional. Un id de producto.
availablestring- Opcional. zero para las variantes que tu tienda muestra como agotadas.
limit, cursor- Pagination
curl "https://www.ninjabuy.com/api/v1/inventory_levels?product=prd_8f2k" \
-H "Authorization: Bearer $NINJABUY_API_KEY" \
-H "NinjaBuy-Version: 2026-11"HTTP/2 200 OK
{
"data": [
{
"variant": "var_41hz",
"product": "prd_8f2k",
"sku": "5187209554",
"seller_in_stock": true,
"seller_count": 812,
"warehouse_on_hand": 24,
"available": 124,
"checked_at": "2026-11-04T09:12:40Z"
},
{
"variant": "var_41j0",
"product": "prd_8f2k",
"sku": "5187209555",
"seller_in_stock": false,
"seller_count": 0,
"warehouse_on_hand": 0,
"available": 0,
"checked_at": "2026-11-04T09:12:40Z"
}
],
"has_more": false,
"cursor": null
}Obtener el nivel de una variante
GET/v1/inventory_levels/{variant}
Una variante, según la última lectura. Leerla no vuelve a leer el marketplace.
Alcanceinventory:read
Parámetros de ruta
variantstringobligatorio- Un id de variante.
Errores
| Estado | Tipo | Cuándo |
|---|---|---|
| 404 | not-found | No existe esa variante en esta cuenta. |
curl "https://www.ninjabuy.com/api/v1/inventory_levels/var_41hz" \
-H "Authorization: Bearer $NINJABUY_API_KEY" \
-H "NinjaBuy-Version: 2026-11"HTTP/2 200 OK
{
"variant": "var_41hz",
"product": "prd_8f2k",
"sku": "5187209554",
"seller_in_stock": true,
"seller_count": 812,
"warehouse_on_hand": 24,
"available": 124,
"checked_at": "2026-11-04T09:12:40Z"
}