# 库存查询

**请求方式:**POST(HTTPS

请求地址:https://openapi.waiqin365.com/api/stock_manage/v1/loadEsssStorehouseStock/{ openid }/{ timestamp }/{ digest }/{ msg_id }

请求示例:

{
    "page_number": 1,
    "storehouse_type": "2",
    "goods_location": "1",
    "product_name_list": ["11", "合肥烤鸭", "000055  分格收纳盒 深款", "gyl商品3", "20kg纸箱400g纸塑包装海藻碘盐"],
    "product_code_list": ["11", "1221", "1003040160002", "10006", "2010Y01020302026"],
    "storehouse_name_list": ["苏A1232020", "AE86", "4571151"],
    "storehouse_code_list": ["suA123", "CL0082"]
}

参数说明:

参数 类型 必填 说明
page_number INT 页码。默认1,每页默认1000条。如果缺省、溢出、为负,将会设置为 1
product_code_list List<VARCHAR(255)> 商品编码列表,为空则表示查询所有商品编码的商品库存。商品编码列表和商品名称列表如果都填则取二者交集;如果都为空那么查询所有商品的库存信息
product_name_list List<VARCHAR(255)> 商品名称列表,为空则表示查询所有商品名称的商品库存。商品编码列表和商品名称列表如果都填则取二者交集;如果都为空那么查询所有商品的库存信息
storehouse_name_list VARCHAR(200) 仓库名称列表,为空则表示查询所有仓库名称的商品库存。仓库名称列表和仓库编码列表如果都填则取二者交集;如果都为空则查询所有仓库库存信息
storehouse_code_list VARCHAR(200) 仓库编码列表,为空则表示查询所有仓库编码的商品库存。仓库名称列表和仓库编码列表如果都填则取二者交集;如果都为空则查询所有仓库库存信息
storehouse_type VARCHAR(2) 仓库类型。“1”表示普通仓库,“2”表示车辆仓库。如果为空则查询所有类型仓库的库存信息
goods_location VARCHAR(32) 库位,“1”是正常品库、“2”是处理品库、“3”是报废品库。如果为空则查询所有库位。只有车辆库存有库位属性,如果填写该属性,查询结果中将只包含车辆仓库中指定库位的库存信息。

响应示例:

字段参考库存查询:去掉以下字段(订单占用量、可销库存、基本单位订单占用量、基本单位可销库存、报表单位订单占用量、报表单位可销库存)

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据 DATA 示例:

{
    "total": 2,
    "page_number": 1,
    "data": [
        {
            "product_class_name": "酒水",
            "storehouse_type": "车辆仓库",
            "product_sale_status": "在售",
            "goods_location": "1",
            "product_wholesale_price": "120",
            "product_brand_name": "青岛",
            "stock_in_base_unit": "0",
            "product_code": "2010Y01020302026",
            "product_name": "20kg纸箱400g纸塑包装海藻碘盐",
            "product_base_unit_name": "箱",
            "product_spec": "一箱",
            "product_id": 7496373232578681000,
            "product_report_unit_name": "件",
            "storehouse_enabled": "启用",
            "product_cost_price": "2",
            "storehouse_code": "suA123",
            "source_code": "0001A11000000005GI4I",
            "stock_in_step_unit": "0吨",
            "storehouse_name": "苏A1232020"
        },
        {
            "product_class_name": "顺泰植保",
            "storehouse_type": "车辆仓库",
            "product_sale_status": "在售",
            "goods_location": "1",
            "product_wholesale_price": "11",
            "product_brand_name": "coco王牌",
            "stock_in_base_unit": "1",
            "product_code": "11",
            "product_name": "11",
            "product_base_unit_name": "箱",
            "product_spec": "22",
            "product_id": 5048604989094252000,
            "product_report_unit_name": "箱",
            "storehouse_enabled": "启用",
            "product_cost_price": "3",
            "storehouse_code": "CL0082",
            "source_code": null,
            "stock_in_step_unit": "1箱",
            "storehouse_name": "AE86"
        }
    ]
}

响应说明:

参数 类型 必填 说明
total INT 总计数量
page_number INT 当前页码
data.product_class_name VARCHAR(100) 商品类型名称
data.storehouse_type VARCHAR(2) 仓库类型
data.product_sale_status VARCHAR(10) 商品销售状态
data.goods_location VARCHAR(32) 商品库位
data.product_wholesale_price NUMERIC(20,8) 商品批发价
data.product_brand_name VARCHAR(100) 商品品牌
data.stock_in_base_unit NUMERIC(20,8) 商品基本单位库存
data.product_code VARCHAR(255) 商品编码
data.product_name VARCHAR(255) 商品名称
data.product_base_unit_name VARCHAR(100) 商品基本单位名称
data.product_spec VARCHAR(255) 商品规格属性
data.product_id INT8 勤策商品 ID
data.source_code VARCHAR(100) 三方系统商品 ID 或其他商品标识
data.product_report_unit_name VARCHAR(100) 商品销售常用单位名称
data.storehouse_enabled VARCHAR(2) 仓库启用状态
data.product_cost_price NUMERIC(20,8) 商品基本单位成本价
data.storehouse_code VARCHAR(200) 仓库编码
data.stock_in_step_unit VARCHAR(100) 商品阶梯单位库存
data.storehouse_name VARCHAR(200) 仓库名称