API开放平台

TIP

# 查询客户库存盘点单

请求方式： 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) 否 基本单位名称

← 客户库存推送 →