API de catálogo2026-11Prévia
Níveis de estoque
Quantas unidades de uma variante você pode vender agora: o estoque do vendedor na China, mais o que você guarda no nosso armazém.
Os níveis mudam quando lemos um anúncio de novo ou a sua prateleira se movimenta. Assine product.out_of_stock em vez de fazer consultas periódicas.
O objeto Inventory level
variant, product, skustring- O que ele conta.
seller_in_stockboolean- Se o vendedor pode vender, na data de checked_at.
seller_countinteger|null- A contagem do próprio vendedor, quando o anúncio mostra uma.
warehouse_on_handinteger- Unidades suas na nossa prateleira, verificadas e fotografadas. Os pedidos saem primeiro delas.
availableinteger- O que a sua loja mostra: a sua prateleira mais a contagem do vendedor, limitada a 100, já que compramos sob demanda. 0 quando o vendedor está sem estoque e a sua prateleira está vazia, ou o produto está pausado.
checked_atstring- Quando lemos o anúncio pela última vez.
{
"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 níveis de estoque
GET/v1/inventory_levels
Cada variante que você vende, ou as de um produto.
Escopoinventory:read
Parâmetros de consulta
productstring- Opcional. Um id de produto.
availablestring- Opcional. zero para as variantes que a sua loja mostra como esgotadas.
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
}Obter o nível de uma variante
GET/v1/inventory_levels/{variant}
Uma variante, conforme a última leitura. Lê-la não lê o marketplace de novo.
Escopoinventory:read
Parâmetros de caminho
variantstringobrigatório- Um id de variante.
Erros
| Status | Tipo | Quando |
|---|---|---|
| 404 | not-found | Essa variante não existe nesta conta. |
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"
}