TIP
# 库存查询
**请求方式:**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) | 是 | 仓库名称 |