API开放平台

TIP

查询客户库存盘点单
查询客户实时库存
查询商品库存变动
客户库存更新(不存在时新增)

# 查询客户库存盘点单

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

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
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
ext_columns	List	否	头自定义字段集合
ext_columns.ext_key	VARCHAR(100)	否	头自定义字段名称
ext_columns.ext_value	TEXT	否	头自定义字段数据值
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.qince.com/api/dmsstock/v1/queryStock/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

说明：本示例仅供参考，具体以参数说明为准。

请求信信息

参数	类型	必填	说明
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.qince.com/api/dmsstock/v1/queryPdStockChange/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

说明：本示例仅供参考，具体以参数说明为准。

请求信信息

参数	类型	必填	说明
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.qince.com/api/dmsstock/v1/updateDmsCmStock/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
storehouse_id	VARCHAR(32)	否	仓库id。仓库id、仓库编码和仓库名称必须传一个，如果同时存在，优先级依次递减
storehouse_code	VARCHAR(100)	否	仓库编码。仓库id、仓库编码和仓库名称必须传一个，如果同时存在，优先级依次递减
storehouse_name	VARCHAR(100)	否	仓库名称。仓库id、仓库编码和仓库名称必须传一个，如果同时存在，优先级依次递减
product_id	VARCHAR(100)	否	商品id。商品ID、第三方商品编码、商品编码和商品名称必须传一个，如果同时存在，优先级依次递减
product_source_code	VARCHAR(100)	否	第三方商品编码。商品ID、第三方商品编码、商品编码和商品名称必须传一个，如果同时存在，优先级依次递减
product_code	VARCHAR(100)	否	商品编码商品ID、第三方商品编码、商品编码和商品名称必须传一个，如果同时存在，优先级依次递减
product_name	VARCHAR(100)	否	商品名称。商品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	响应数据

← 企业库存接口客户库存推送 →