文档中心 > API类目 > 本地生活到店交易API

qimen.taobao.life.items.inventory.batchquery (本地生活-到店-商品库存批量查询)

1. 发起场景：1. C端透商品当前库存；2. 下单前校验库存 2. 预期结果：返回批量商品的的时段库存 3. 异常兜底：异常默认没有库存。 4. 超时时间：2s以内 5. 注意：本接口不会重试，超时或者fail认为无库存，反馈用户库存不足

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	更多限制	描述
shop_option	ShopOption	必须		门店信息
└ store_id String 可选 123456 门店id └ partner_shop_id String 可选 2114312 合作方门店id
time_option	TimeOption	必须		时间信息
└ start String 必须 2022-05-20 库存开始时间，格式与时间类型有关，DAY：yyyy-MM-dd； DAY_TIME：yyyy-MM-dd HH:mm └ end String 可选 2022-05-26 库存结束时间 └ type String 必须 DAY_INTERVAL 时间类型，DAY（天） DAY_TIME（时刻） DAY_INTERVAL(日期区间) DAY_TIME_INTERVAL（时刻区间），区间情况需要关注start 和 end，其他情况只需要关注 start
item_list	ItemList []	必须	最大列表长度：999999	商品列表
└ alsc_item_id String 必须 123456 商品id └ partner_item_id String 可选 654321 合作方商品id

响应参数

名称	类型	示例值	描述
biz_result	String	success	业务结果，查询成功返回success，查询失败返回fail
biz_error_msg	String	错误信息	业务错误描述
success	Boolean	true	合作方是否收到本次请求，默认传true
date_inventory_result	DateInventoryResult []		库存结果
└ alsc_item_id String 123456 商品id └ partner_item_id String 654321 合作方商品id date_inventory DateInventory [] 日期库存 └ date String 2022-05-20 日期，格式为 yyyy-MM-dd time_units TimeUnits [] 时间单元 └ start_time String 10:00 开始时间，格式为 HH:mm └ end_time String 11:00 结束时间，格式为 HH:mm └ count Number 1 库存数量，整数 └ status String OPEN 状态。FULL：满；OPEN：可订；CLOSE：未开放/休息
biz_error_code	String	SYSTEM_ERROR	业务错误码

请求示例

{"shop_option":{"store_id":"123456","partner_shop_id":"2114312"},"time_option":{"start":"2022-05-20","end":"2022-05-26","type":"DAY_INTERVAL"},"item_list":[{"alsc_item_id":"123456","partner_item_id":"654321"}]}

响应示例

{
    "biz_result":"success",
    "biz_error_msg":"错误信息",
    "success":true,
    "date_inventory_result":[
        {
                "alsc_item_id":"123456",
                "partner_item_id":"654321",
                "date_inventory":[
                    {
                            "date":"2022-05-20",
                            "time_units":[
                                {
                                        "start_time":"10:00",
                                        "end_time":"11:00",
                                        "count":1,
                                        "status":"OPEN"
                                }
                            ]
                    }
                ]
        }
    ],
    "biz_error_code":"SYSTEM_ERROR"
}

验签示例

{"biz_error_msg":"Illegal request","success":"不等于true","biz_error_code":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案
isp.http-read-timeout

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

本地生活到店交易API

qimen.taobao.life.items.inventory.batchquery (本地生活-到店-商品库存批量查询)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ