SPOTTER API
  1. 可售库存
SPOTTER API
  • 文档说明
    • 简介
    • 版本日志
    • 开发指南
    • API认证
    • 业务说明
      • 运输商编码列表
  • 开放能力
    • 商品
      • 查询报价协议
      • 查询产品信息
    • 订单
      • 可售库存
        • 查询可售库存
          POST
        • 编辑渠道库存
          POST
      • 查询订单
        POST
      • 创建多渠道订单
        POST
      • 取消发货
        POST
    • 物流
      • 查询VC物流
      • 查询承运商
    • 报告
      • 查询VC库存报告
      • 查询VC销售诊断
      • 查询VC销售预测
      • 查询VC实时销量
    • 仓储
      • 仓库配置
        • 查询仓库列表
      • 入库
        • 查询入库单列表
        • 查询入库箱唛列表
        • 创建入库单
        • 创建待发货入库单
        • 分页查询入库单
      • 库存
        • 查询库存
        • 分页查询库龄汇总
        • 分页查询库龄明细
      • 出库
        • 查询出库通知单列表
    • 广告
      • 查询SP推广商品
      • 查询SD推广商品
      • 查询SB广告
    • 促销
      • 查询促销活动-COUPON
  1. 可售库存

查询可售库存

POST
https://openapi.spotterio.com/api/v1/page_sales_invt
接口返回值说明
该接口会查询所有库存。一个ssku可由多种库存组成,包含有且仅有一条可分配库存,大于等于0条渠道库存,亚马逊DF库存就是一种渠道库存。总可用库存 = 可分配库存 + 渠道库存。
可分配库存匹配条件:inventory_type = Shared
AMZ DF渠道库存匹配条件:inventory_type = Platform & order_type = DF & account_type = SvcId
渠道库存不足的情况
通常是可分配库存为负数的时候会出现渠道库存不足情况。

请求参数

Header 参数
X-Site-Tenant
string 
必需
渠道租户(多渠道场景将AMZ替换为SPT,如US_SPT):
US_AMZ:美国亚马逊,时区:America/Los_Angeles
CA_AMZ:加拿大亚马逊,时区:America/Vancouver
DE_AMZ:德国亚马逊,时区:Europe/Berlin
GB_AMZ:英国亚马逊,时区:Europe/London
FR_AMZ:法国亚马逊,时区:Europe/Paris
IT_AMZ: 意大利亚马逊,时区:Europe/Rome
ES_AMZ:西班牙亚马逊,时区:Europe/Madrid
示例值:
US_AMZ
Body 参数application/json
current_page
integer 
当前页数
必需
>= 1
page_size
integer 
展示条数
必需
<= 100
storage_code_list
array[string] | null 
仓库code列表
可选
ssku_list
array[string] | null 
可选
Spotter Sku列表
示例
{
    "current_page": 1,
    "page_size": 20
}

返回响应

🟢200成功
application/json
Body
code
integer 
响应码
必需
msg
string 
异常信息
可选
resp_data
object 
响应数据
可选
current_page
integer 
当前页数
必需
page_size
integer 
展示条数
必需
total_num
integer 
总条数
必需
total_page
integer 
总页数
必需
data
array [object {5}] 
必需
trace_id
string 
必需
示例
{
    "code": 0,
    "msg": "string",
    "resp_data": {
        "current_page": 0,
        "page_size": 0,
        "total_num": 0,
        "total_page": 0,
        "data": [
            {
                "total_num": 0,
                "total_occupy_num": 0,
                "ssku": "string",
                "storage_code": "string",
                "invt_dto_list": [
                    {
                        "si_code": "string",
                        "ssku": "string",
                        "plt_sku": "string",
                        "storage_code": "string",
                        "inventory_type": "string",
                        "order_type": "string",
                        "account_type": "string",
                        "account_code": "string",
                        "available": 0,
                        "freeze_num": 0,
                        "sync_status": "string",
                        "platform": "string",
                        "platform_region": "string"
                    }
                ]
            }
        ]
    },
    "trace_id": "string"
}
修改于 2025-06-04 03:09:38
上一页
查询产品信息
下一页
编辑渠道库存
Built with