文档中心 > API类目 > 阿里健康-消费医疗-商品门店服务

qimen.alibaba.alihealth.medical.inventory.query (库存查询接口)

查询服务商商品门店等库存

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
isvItemSkuIds String 必须 sku1,sku2,sku3 多个服务商商品SKU ID,使用,拼接
isvStoreId String 必须 HL001 服务商门店ID
scheduleDateRangeFrom String 必须 2022-01-01 库存日期区间开始,需包含开始日期
scheduleDateRangeTo String 必须 2022-02-28 库存日期区间结束,需包含结束日期

响应参数

名称 类型 示例值 描述
resultStatus String SUCCESS SUCCESS 成功;UNKNOWN 未知或系统异常;FAIL 失败
resultCode String SUCCESS 结果码:SUCCESS 成功,SKU_NOT_FOUND 商品SKU不存在,STORE_NOT_FOUND 门店不存在,SKU_NOT_ONSALE_ON_STORE 商品SKU不在当前门店售卖,SYSTEM_ERROR 系统内部错误,FAIL 查询失败
resultMsg String 成功 结果描述
data InventoryInfo 库存信息
  • └ totalInventory
  • String
  • 100
  • 总库存
  • └ consumedInventory
  • String
  • 80
  • 已消耗库存
  • └ accurateToTimePeriod
  • Boolean
  • true
  • 库存精确到时间段,如果传true需要实现时间段库存接口
  • inventoryCalendarInfo
  • InventoryCalendarInfo []
  • 库存日历信息
  • └ reservationDeadline
  • String
  • 2022-02-22 15:00:00
  • 预约截止时间,到了这个时间以后就不可以预约当前日期,需要小于当前时间24点
  • └ consumedInventory
  • String
  • 8
  • 当前日期已消耗库存
  • └ totalInventory
  • String
  • 10
  • 当前日期的总库存
  • └ scheduleDate
  • String
  • 2022-02-23
  • 日期

请求示例

{"isvStoreId":"HL001","scheduleDateRangeTo":"2022-02-28","isvItemSkuIds":"sku1,sku2,sku3","scheduleDateRangeFrom":"2022-01-01"}

响应示例

{
    "resultStatus":"SUCCESS",
    "resultCode":"SUCCESS",
    "resultMsg":"成功",
    "data":{
        "totalInventory":"100",
        "consumedInventory":"80",
        "accurateToTimePeriod":true,
        "inventoryCalendarInfo":[
            {
                    "reservationDeadline":"2022-02-22 15:00:00",
                    "consumedInventory":"8",
                    "totalInventory":"10",
                    "scheduleDate":"2022-02-23"
            }
        ]
    }
}

验签示例

{"resultStatus":"UNKNOWN","resultCode":"sign-check-failure","resultMsg":"Illegal request"}

错误码解释

错误码 错误描述 解决方案
isp.http-read-timeout
response-body-parse-error
isp.http-connection-timeout

API工具

FAQ

返回
顶部