# 查询客户库存盘点单

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/dmsinventory/v1/queryDmsInventory/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:


{
    "page_number": 1,
    "page_length": 100,
    "start_date": "2016-12-09",
    "end_date": "2016-12-09"
}
    
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
page_number INT 当前页数,不传默认为1
page_length int 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
after_create_date TIMESTAMP 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date TIMESTAMP 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
start_create_date TIMESTAMP 创建时间开始。格式:yyyy-MM-dd
end_create_date TIMESTAMP 创建时间结束。格式:yyyy-MM-dd
start_modify_date TIMESTAMP 修改时间开始。格式:yyyy-MM-dd
end_modify_date TIMESTAMP 修改时间结束。格式:yyyy-MM-dd

响应示例:

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

数据DATA示例:

[
    {
        "confirm_emp_code": null, 
        "inventory_type": "PDLX_BFPD", 
        "confirm_emp_source_code": null, 
        "confirm_emp_name": null, 
        "prods": [
            {
                "remark": null, 
                "actual_stock": 2137.145, 
                "current_stock": 2137.145, 
                "prod_source_code": null, 
                "prod_id": "6692513571119135747", 
                "id": "5183969319998512131", 
                "master_id": "5183969319998512131", 
                "sequ": 0, 
                "difference_stock": 0, 
                "prod_code": "1HBSKLSD", 
                "prod_name": "测试商品1"
            }
        ], 
        "cm_id": "5012103144063463929", 
        "inventory_status": "PDZT_YSH", 
        "remarks": "", 
        "storehouse_target_name": "南京雨花二级经销商", 
        "emp": "8724832689904775768", 
        "date": "2017-08-21", 
        "storehouse": "8878885617773144765", 
        "cm_code": "0008106267", 
        "id": "5183969319998512131", 
        "cm_source_code": null, 
        "storehouse_target_code": "0008106267", 
        "storehouse_name": "1ed", 
        "storehouse_code": "CK0076", 
        "storehouse_target_id": "5012103144063463929", 
        "storehouse_target_source_code": null, 
        "cm_name": "南京雨花二级经销商", 
        "emp_code": "wangwei", 
        "status": "1", 
        "code": "PD201708210001", 
        "emp_source_code": "wangwei", 
        "confirm_emp_id": null, 
        "emp_name": "员工1", 
        "confirm_time": null
    }
]

参数说明:

参数 类型 必填 说明
id INT8 盘点单ID
status VARCHAR(32) 0:已删除,1:正常
inventory_status VARCHAR(32) 盘点状态。PDZT_DSH:待审核,PDZT_YSH:已审核
inventory_type VARCHAR(32) 盘点类型 PDLX_QBPD:全部盘点,PDLX_BFPD:部分盘点
code VARCHAR(100) 单据编号
date VARCHAR(100) 盘点日期。格式:yyyy-mm-dd
emp INT8 经办人ID
emp_code VARCHAR(100) 经办人编码
emp_source_code VARCHAR(100) emp_source_code
emp_name VARCHAR(100) 经办人名称
cm_id INT8 客户ID
cm_code VARCHAR(100) 客户编码
cm_source_code VARCHAR(100) 客户源编码
cm_name VARCHAR(100) 客户名称
storehouse INT8 仓库ID
storehouse_code VARCHAR(100) 仓库编码
storehouse_name VARCHAR(100) 仓库名称
storehouse_target_id INT8 仓库分配对象客户id
storehouse_target_code VARCHAR(100) 仓库分配对象客户编码
storehouse_target_source_code VARCHAR(100) 仓库分配对象客户源编码
storehouse_target_name VARCHAR(100) 仓库分配对象客户名称
remarks text 备注
confirm_emp_id INT8 确认人ID
confirm_emp_code VARCHAR(100) 确认人编码
confirm_emp_source_code VARCHAR(100) 确认人源编码
confirm_emp_name VARCHAR(100) 确认人名称
confirm_time VARCHAR(100) 确认时间。格式:yyyy-mm-dd HH:mm:ss
visit_implement_id VARCHAR(100) 关联的高级拜访id
prods INT8
prods.id INT8 盘点子表ID
prods.master_id INT8 盘点单ID
prods.prod_id VARCHAR(32) 商品ID
prods.prod_code VARCHAR(100) 商品编码
prods.prod_source_code VARCHAR(100) 商品源编码
prods.prod_name VARCHAR(100) 商品名称
prods.current_stock numeric(10,8) 当前库存,基本单位
prods.actual_stock numeric(10,8) 实物库存,基本单位
prods.difference_stock numeric(10,8) 差异数量,基本单位
prods.remark text 备注
prods.sequ numeric(20) 排序号

# 查询客户实时库存

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/dmsstock/v1/queryStock/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "page_number": 1
}
说明: 本示例仅供参考,具体以参数说明为准。

请求信信息

参数 类型 必填 说明
page_number INT 当前页数,不传默认为1
start_create_date TIMESTAMP 创建时间开始。格式:yyyy-MM-dd(包含当前日期:>=)
end_create_date TIMESTAMP 创建时间结束。格式:yyyy-MM-dd(不包含当前时间:<)
start_modify_date TIMESTAMP 修改时间开始。格式:yyyy-MM-dd(包含当前日期:>=)
end_modify_date TIMESTAMP 修改时间结束。格式:yyyy-MM-dd(不包含当前时间:<)

响应示例:

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

数据DATA示例:

[
    {
        "quantity": 2137.145, 
        "prod_source_code": null, 
        "prod_id": "6692513571119135747", 
        "base_unit_name": "瓶", 
        "base_unit_id": "5183969319998512131", 
        "prod_code": "1HBSKLSD", 
        "prod_name": "测试商品1",
        "cm_id": "5012103144063463929", 
        "cm_name": "南京雨花二级经销商", 
        "storehouse": "8878885617773144765", 
        "cm_code": "0008106267", 
        "cm_source_code": null, 
        "storehouse_name": "1ed", 
        "storehouse_code": "CK0076"
    }
]

参数说明:

参数 类型 必填 说明
cm_id VARCHAR(32) 仓库分配对象客户ID
cm_code VARCHAR(32) 仓库分配对象客户编码
cm_source_code VARCHAR(32) 仓库分配对象客户源编码
cm_name VARCHAR(100) 仓库分配对象客户名称
storehouse VARCHAR(32) 仓库ID
storehouse_code VARCHAR(200) 仓库编码
storehouse_name VARCHAR(200) 仓库名称
prod_id VARCHAR(32) 商品ID
prod_code VARCHAR(100) 商品编码
prod_source_code VARCHAR(100) 商品源编码
prod_name VARCHAR(100) 商品名称
quantity numeric(28,8) 当前库存,基本单位
base_unit_id VARCHAR(32) 基本单位id
base_unit_name VARCHAR(32) 基本单位名称

# 查询商品库存变动

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/dmsstock/v1/queryPdStockChange/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "page_number": "1",
    "page_length":"1000",
    "startDate":"2023-01-01",
    "endDate":"2023-03-15"
}
说明: 本示例仅供参考,具体以参数说明为准。

请求信信息

参数 类型 必填 说明
page_number VARCHAR(32) 当前页数,不传默认为1
page_length VARCHAR(32) 每页显示数量,默认1000条
startDate VARCHAR(32) 出入库开始时间。格式:yyyy-MM-dd
endDate VARCHAR(32) 出入库结束时间。格式:yyyy-MM-dd

响应示例:

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

数据DATA示例:

[
    {
        "tag_values": "新品,重点,赠品,促销",
        "current_report_quantity": "1.00000",
        "storehouse_id": "7676758909029990791",
        "prod_code": "sq01",
        "current_quantity_out": "0部",
        "prod_id": "7644757289557140605",
        "cm_code": "CUS000003",
        "prod_source_code": "",
        "base_unit_name": "部",
        "cm_type": "1212",
        "prod_class_id": "1",
        "cm_source_code": "",
        "current_base_quantity_in": "0.00000",
        "storehouse_code": "CK0001",
        "current_base_quantity": "1.00000",
        "sale_status": "1",
        "report_unit_name": "部",
        "current_report_quantity_in": "0.00000",
        "current_base_quantity_out": "0.00000",
        "current_quantity": "1部",
        "prod_name": "sq01",
        "current_quantity_in": "0部",
        "last_quantity": "1部",
        "last_base_quantity": "1.00000",
        "cm_id": "7813218532143146951",
        "cm_name": "100",
        "sale_status_name": "在售",
        "prod_spec": "",
        "prod_brand": "品牌1",
        "current_report_quantity_out": "0.00000",
        "storehouse_name": "100",
        "prod_class": "测试1",
        "last_report_quantity": "1.00000"
    }
]

参数说明:

参数 类型 必填 说明
cm_id VARCHAR(32) 仓库分配对象客户ID
cm_code VARCHAR(32) 仓库分配对象客户编码
cm_source_code VARCHAR(32) 仓库分配对象客户第三方编码
cm_name VARCHAR(100) 仓库分配对象客户名称
cm_type VARCHAR(100) 仓库分配对象客户类型
storehouse_id VARCHAR(32) 仓库ID
storehouse_code VARCHAR(200) 仓库编码
storehouse_name VARCHAR(200) 仓库名称
prod_id VARCHAR(32) 商品ID
prod_code VARCHAR(100) 商品编码
prod_source_code VARCHAR(100) 商品第三方编码
prod_name VARCHAR(100) 商品名称
prod_spec VARCHAR(100) 规格属性
prod_class VARCHAR(100) 商品类型
sale_status VARCHAR(32) 商品状态,0为停售,1为在售
sale_status_name VARCHAR(100) 商品状态名称
prod_brand VARCHAR(100) 品牌名称
tag_values VARCHAR(100) 标签
base_unit_name VARCHAR(100) 基本单位名称
report_unit_name VARCHAR(100) 报表单位名称
last_quantity VARCHAR(100) 上期结存数量
last_base_quantity VARCHAR(100) 上期结存数量(基本单位)
last_report_quantity VARCHAR(100) 上期结存数量(报表单位)
current_quantity_in VARCHAR(100) 本期入库数量
current_base_quantity_in VARCHAR(100) 本期入库数量(基本单位)
current_report_quantity_in VARCHAR(100) 本期入库数量(报表单位)
current_quantity_out VARCHAR(100) 本期出库数量
current_base_quantity_out VARCHAR(100) 本期出库数量(基本单位)
current_report_quantity_out VARCHAR(100) 本期出库数量(报表单位)
current_quantity VARCHAR(100) 本期结存数量
current_base_quantity VARCHAR(100) 本期结算数量(基本单位)
current_report_quantity VARCHAR(100) 本期结算数量(报表单位)

# 客户库存更新(不存在时新增)

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/dmsstock/v1/updateDmsCmStock/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "storehouse_id": "",
    "product_id": "",
    "quantity": "20"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
storehouse_id VARCHAR(32) 仓库id,必传
product_id VARCHAR(32) 商品id,必传
quantity VARCHAR(32) 基本单位商品数量,必须为整数

响应示例:

{
	"msg_id": "X000001",
	"return_code": 1,
	"return_msg": "",
	"response_data": null
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data String 响应数据