企迈云-开放平台

API 2.0

API 2.0 > 3.1 商品 > 3.1.8 获取单个商品库存

3.1.8 获取单个商品库存

开启令牌和权限后可调用。签名方式请查看开发指南

场景描述：查询某商品的商品库存信息

零售

请求地址

请求方式	版本信息	请求地址
POST	V2	http://openapi.zvcms.com/api/v2

公共参数

参数	参数类型	是否必填	默认值	描述
OpenId	string	是		密钥Id
GrantCode	string	是		授权code
Token	string	是		签名，参考《数字签名sign》
Timestamp	string	是		当前时间戳
Nonce	string	是		随机正整数
Action	string	是	goods.stock-search	接口方法
Params	array	是		业务参数

请求参数

参数	参数类型	是否必填	描述
store_type	int	是	店铺类型 1.店铺 2.门店
barcode	array	是	商品标识数组 ['123','FA2222'] 等同于响应参数中的tag_name
multi_store_id	string	是	入库店铺或则门店 id

响应参数

参数	参数类型	描述
stockList	array
├11C2C633DEFC111112	array
├barcode	string	商品条码
├stock	int	库存
├cost_price	Money(分)	成本价
├occupying_stock	string	占用库存
├type	int	商品类型：1 - 普通商品
├unit	string	库存单位
├o_unit	string	展示单位
├in_stock	通过入库操作累计的库存	通过入库操作累计的库存
├tag_name	string	商品标识

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "goods.stock-search",
    "Params": {
        "store_type": "",
        "barcode": "",
        "multi_store_id": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "stockList": {
            "11C2C633DEFC111112": {
                "barcode": "",
                "stock": "",
                "cost_price": "",
                "occupying_stock": "",
                "type": "",
                "unit": "",
                "o_unit": "",
                "in_stock": "",
                "tag_name": ""
            }
        }
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}