API开放平台

# 新增直营订单发货单

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmssent/v1/addSent/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体：

{
    "sent_no": "FH201612100000001",
    "sent_date": "2020-12-10",
    "order_no": "DD201612090000001",
    "purchase_no": "CK20161209000001",
    "cm_id": "6389893435290873348",
    "cm_code": "CM0001",
    "date": "2016-12-09",
    "emp_id": "9090338090192516225",
    "emp_code": "EMP0001",
    "consignment_date": "2016-12-10",
    "supply_id": "4778886974871755755",
    "supply_code": "SU00001",
    "sent_storehouse_id": "6210170610020953209",
    "sent_storehouse_code": "CK0001",
    "receive_name": "张三",
    "receive_phone": "18569854561",
    "receive_tel": "02578946932",
    "receive_addr": "江苏省南京市康缘智汇港",
    "receive_addr_id": "",
    "remark": "加急订单抓紧送货",
    "distribution_method": "配送方式",
    "exts": [
        {
            "cm_ext_key": "级别",
            "cm_ext_value": "四星"
        },
        {
            "cm_ext_key": "主营商品",
            "cm_ext_value": "食品,电器,日化用品"
        }
    ],
    "prods": [
        {
            "product_id": "7755038711664976249",
            "product_code": "PD001",
            "order_price": "20.000000",
            "order_count": "10.00000000",
            "order_input_unit": "6782340125265424027",
            "order_input_unit_name": "箱",
            "order_amount": "200.00",
            "order_discount_amount": "0.00",
            "sent_num": "5.00000000",
            "sent_input_unit": "6782340125265424027",
            "sent_input_unit_name": "箱",
            "is_gift": "N",
            "posnr": "10",
            "remark": "易损件",
            "exts": [
                {
                    "cm_ext_key": "级别",
                    "cm_ext_value": "四星"
                },
                {
                    "cm_ext_key": "主营商品",
                    "cm_ext_value": "食品,电器,日化用品"
                }
            ]
        }
    ]
}

请求信息

参数	类型	必填	说明
sent_no	VARCHAR(100)	否	发货单号不传自动生成
sent_date	VARCHAR(32)	否	发货日期yyyy-mm-dd
order_no	VARCHAR(100)	是	销售订单号，销售订单号和采购单号必须传一个
purchase_no	VARCHAR(100)	是	采购单号，销售订单号和采购单号必须传一个
cm_id	VARCHAR(32)	是	客户id，客户id和客户编码必须传一个
cm_code	VARCHAR(100)	是	客户编码，客户id和客户编码必须传一个
date	VARCHAR(32)	否	业务日期yyyy-mm-dd
emp_id	VARCHAR(32)	否	业务员Id，业务员id和业务员编码都不传，默认取其中一个客户经理的
emp_code	VARCHAR(100)	否	业务员编码，业务员id和业务员编码都不传默认取其中一个客户经理的
consignment_date	VARCHAR(32)	否	要求交货日期yyyy-mm-dd
supply_id	VARCHAR(32)	否	供应商id，-1表示厂家供货，供应商编码（经销商的编码），如果两个都不传将根据客户的上级经销商来查询
supply_code	VARCHAR(100)	否	供应商编码（经销商的编码），供应商id，-1表示厂家供货，如果两个都不传将根据客户的上级经销商来查询
sent_storehouse_id	VARCHAR(32)	否	供应商发货仓库id，供应商发货仓库编码，两个都不传根据供应商去查询默认仓库
sent_storehouse_code	VARCHAR(100)	否	供应商发货仓库编码，供应商发货仓库id，两个都不传根据供应商去查询默认仓库
receive_name	VARCHAR(100)	否	收货人名称
receive_phone	VARCHAR(32)	否	收货人手机
receive_tel	VARCHAR(32)	否	收货人电话
receive_addr	VARCHAR(1000)	否	收货地址
receive_addr_id	VARCHAR(32)	否	收货地址id
remark	text	否	订单表体备注
distribution_method	text	否	配送方式
prods[].product_id	VARCHAR(32)	是	商品id和商品编码必须传一个
prods[].product_code	VARCHAR(100)	是	商品id和商品编码必须传一个
prods[].order_price	NUMERIC(18,8)	否	订货价不传就取客户价格，赠品价格为0
prods[].order_count	NUMERIC(18,8)	是	订货数量
prods[].order_input_unit	VARCHAR(32)	否	订货单位id和订货单位名称传一个即可，不传使用基本单位
prods[].order_input_unit_name	VARCHAR(32)	否	订货单位id和订货单位名称传一个即可，不传使用基本单位
prods[].order_amount	NUMERIC(18,2)	否	订货金额
prods[].order_discount_amount	NUMERIC(18,2)	否	订货优惠金额
prods[].sent_num	NUMERIC(18,8)	是	发货数量
prods[].sent_input_unit	VARCHAR(32)	否	发货单位和发货单位名称传一个即可，不传使用基本单位
prods[].sent_input_unit_name	VARCHAR(32)	否	发货单位和发货单位名称传一个即可，不传使用基本单位
prods[].is_gift	VARCHAR(10)	否	是否是赠品Y:是 N：否，不传就是非赠品
prods[].posnr	NUMERIC(10)	是	项目号
prods[].remark	text	否	订单子表的备注
prods[].sent_remark	text	否	发货单行备注
costpooldetails[].account	VARCHAR(32)	否	客户账户名称
costpooldetails[].amount	NUMERIC(18,8)	否	核销金额

返回结果：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

响应信息

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码，0-成功, 1-失败, 其他参照附件错误码
return_msg	String	响应说明

# 新增直营订单

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmspurchase/v1/addPurchase/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体：



					{
					    "operate_type": "1",
					    "order_no": "DD201612090000001",
					    "cm_id": "6389893435290873348",
					    "cm_code": "CM0001",
					    "date": "2016-12-09 12:12",
					    "emp_id": "9090338090192516225",
					    "emp_code": "EMP0001",
					    "consignment_date": "2016-12-10",
					    "receive_name": "张三",
					    "receive_phone": "18569854561",
					    "receive_tel": "02578946932",
					    "receive_addr": "江苏省南京市康缘智汇港",
                          "receive_addr_id": "",
					    "remark": "加急订单抓紧送货",
					    "order_amount":"1212.00",
					    "order_discount_amount":"38.00",
                          "distribution_method": "配送方式",
					    "exts": [
					        {
					            "ext_key": "级别",
					            "ext_value": "四星"
					        },
					        {
					            "ext_key": "主营商品",
					            "ext_value": "食品,电器,日化用品"
					        }
					    ],
					    "products": [
					        {
					            "id": "7755038711664976249",
					            "code": "PD001",
					            "price": "20.000000",
					            "num": "10.00000000",
					            "unit": "6782340125265424027",
					            "unit_name": "箱",
					            "amount": "200.00",
					            "is_gift": "0",
					            "posnr": "10",
					            "remark": "易损件",
					            "exts": [
					                {
					                    "ext_key": "级别",
					                    "ext_value": "四星"
					                },
					                {
					                    "ext_key": "主营商品",
					                    "ext_value": "食品,电器,日化用品"
					                }
					            ]
					        }
					    ]
					}

请求信息

参数	类型	必填	说明
operate_type	VARCHAR(32)	是	1：新增直营订单，2：编辑直营订单
order_no	VARCHAR(100)	是	新增的时候传递作为新订单的单号（不传系统自动生成），编辑的时候传递作为参数进行编辑订单
cm_code	VARCHAR(100)	是	客户编码，客户id和客户编码必须传一个
cm_id	VARCHAR(32)	是	客户id，客户id和客户编码必须传一个
date	VARCHAR(32)	否	业务日期yyyy-MM-dd HH:mm
emp_id	VARCHAR(32)	否	业务员Id，业务员id和业务员编码都不传，默认取其中一个客户经理的
emp_code	VARCHAR(100)	否	业务员编码，业务员id和业务员编码都不传，默认取其中一个客户经理的
consignment_date	VARCHAR(32)	否	要求交货日期yyyy-mm-dd
receive_name	VARCHAR(100)	否	收货人名称
receive_phone	VARCHAR(32)	否	收货人手机
receive_tel	VARCHAR(32)	否	收货人电话
receive_addr	VARCHAR(1000)	否	收货地址
receive_addr_id	VARCHAR(32)	否	收货地址id
remark	text	否	订单表体备注
order_amount	VARCHAR(32)	否	订单金额，精度最高两位小数
order_discount_amount	VARCHAR(32)	否	订单优惠金额，精度最高两位小数
distribution_method	text	否	配送方式
order_class	VARCHAR(100)	否	单据类型，ZC:销售订单，HC:换出订单
exts[].ext_key	varchar(4000)	否	采购单主信息扩展字段key值扩展字段需先在我方系统中创建。
exts[].ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接。
products[].id	VARCHAR(32)	是	商品id和商品编码必须传一个
products[].code	VARCHAR(100)	是	商品id和商品编码必须传一个
products[].price	NUMERIC(18,8)	否	订货价不传就取客户价格，赠品价格为0
products[].num	NUMERIC(18,8)	是	订货数量
products[].unit	VARCHAR(32)	否	订货单位id和订货单位名称传一个即可，不传使用基本单位
products[].unit_name	VARCHAR(32)	否	订货单位id和订货单位名称传一个即可，不传使用基本单位
products[].amount	NUMERIC(18,2)	否	订货金额
products[].is_gift	VARCHAR(10)	否	是否是赠品1:是 0：否，不传就是非赠品
products[].posnr	NUMERIC(10)	是	项目号
products[].remark	text	否	订单子表的备注
products[].exts[].ext_key	varchar(4000)	否	采购单详情信息扩展字段key值扩展字段需先在我方系统中创建。
products[].exts[].ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接。

返回结果：

{
					    "msg_id": "X000001",
					    "return_code": 0,
					    "return_msg": "外请365直营订单详情数据"
}

响应信息

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码，0-成功, 1-失败, 其他参照附件错误码
return_msg	String	id
cm_id	String	客户id
cm_name	String	客户名称
consignment_date_str	String	要求发货日期，格式：yyyy-MM-dd
create_name	String	提交人名称
create_time	String	提交时间，格式：yyyy-MM-dd hh:mi
create_time_str	String	创建时间，带毫秒级别的，格式“yyyy-MM-dd HH:mm:ss.SSS”
date	String	业务日期，(格式：yyyy-MM-dd)
emp_id	String	业务员id
emp_name	String	业务员名称
extColumnValues[].code	String	自定义字段码
extColumnValues[].compid	String	组件id
extColumnValues[].items	String	单选，多选下拉框可选项，＃分割
extColumnValues[].name	String	自定义字段名称
extColumnValues[].type	String	组件类型
extColumnValues[].value	String	自定义字段值
modify_time_str	String	修改时间，带毫秒级别的，格式“yyyy-MM-dd HH:mm:ss.SSS”
order_amount	String	订单金额
order_cost_amount	String	成本金额
order_discount_amount	String	优惠金额
order_tax_amount	String	税额
pictures	String	图片
products[].barcode	String	条形码
products[].base_unit	String	基本单位id
products[].base_unit_name	String	基本单位名称
products[].brand	String	品牌
products[].code	String	商品编码
products[].detail_id	String	订单详情ID
products[].extColumnValues[].code	String	自定义字段编码
products[].extColumnValues[].compid	String	组件id
products[].extColumnValues[].items	String	单选，多选下拉框可选项，＃分割
products[].extColumnValues[].name	String	自定义字段名称
products[].extColumnValues[].type	String	自定义字段类型
products[].fomat_order_count	String	根据商品是否阶梯单位格式化数量（带单位）
products[].id	String	商品ID
products[].is_gift	String	是否赠品
products[].name	String	商品名称
products[].order_amount	String	采购金额
products[].order_base_unit_count	String	采购数量转换成基本单位数量
products[].order_count	String	采购数量
products[].order_input_unit	String	录入单位ID
products[].order_input_unit_name	String	录入单位名称
products[].order_price	String	采购单价
products[].remark	String	备注
products[].spec	String	规格属性
purchase_business_status	String	采购单业务状态码
purchase_business_status_name	String	采购单业务状态中英文名称
purchase_no	String	采购单号
purchase_status	String	采购单系统状态码
purchase_status_name	String	采购单系统状态中英文名称
receive_addr	String	收货人地址
receive_name	String	收货人姓名
receive_phone	String	收货人手机
receive_tel	String	收货人电话
remark	String	单据备注
supply_id	String	供货商ID
supply_name	String	供货商名称

# 关闭直营订单

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmssalesorder/v1/stopPurchaseSentOrder/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体：

{
    "order_id": "6037741540892319799",
    "order_no": "DD201612090000001"
}

请求信息

参数	类型	必填	说明
order_id	VARCHAR(32)	是	订单id，订单id和订单号必须传一个
order_no	VARCHAR(100)	是	订单号，订单id和订单号必须传一个

返回结果：

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

响应信息

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码，0-成功, 1-失败, 其他参照附件错误码
return_msg	String	响应说明

# DMS外部客户余额同步接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsreceivebalance/v1/receiveCustomerWithBalance/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体：

{
    "data":[
        {
            "dealerCode": "CUS001",
            "balance": "1.00"
        },
        {
            "dealerCode": "CUS002",
            "balance": "2.00"
        }
      ........
    ]
}

请求信息

参数	类型	必填	说明
data	jsonArray	是	jsonArray格式数据
data[].dealerCode	VARCHAR(32)	是	客户编码
data[].balance	VARCHAR(20,2)	是	客户余额

返回结果：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

响应信息

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码，0-成功, 1-失败, 其他参照附件错误码
return_msg	String	响应说明

# 查询直营采购订单

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsdatasearch/v1/getDmsPurchaseOrderInfos/{openid}/{timestamp}/{digest}/{msg_id} 在线调试 (opens new window)
请求包体：


{
    "page_number": 1,
    "s_status": 1,
    "purchase_no": "CG20150819",
    "s_cmCode": "CUS0001",
    "s_cmName": "客户1",
    "emp_code": "EMP0001",
    "emp_name": "员工1",
    "after_create_date": "2017-05-01 00:00:00",
    "after_modify_date": "2017-05-31 00:00:00"
}

请求信息

参数	类型	必填	说明
page_number	INT	是	页码默认1，每页默认1000条
page_length	int	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整
id	INT8	否	外勤365id
s_status	CHAR(1)	否	记录状态：0 已删除 1 正常
purchase_no	VARCHAR(32)	否	采购单编码，有效字符详见附录：有效字符说明 (opens new window)
s_cmCode	VARCHAR(32)	否	客户编码，有效字符详见附录：有效字符说明 (opens new window)
s_cmName	VARCHAR(32)	否	客户名称，唯一，有效字符详见名称类型参照表
emp_code	VARCHAR(32)	否	业务员编码，有效字符详见附录：有效字符说明 (opens new window)
emp_name	VARCHAR(32)	否	业务员名称，唯一，有效字符详见名称类型参照表
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”

返回结果：

{
	"msg_id": "X000001",
	"return_code": "0",
	"return_msg": "",
	"response_data": [{
		"id": "7226306356013346628",
		"status": "1",
		"purchase_no": "CK201612010001",
		"date": "2016-12-01",
		"emp_dept_id": "6173157522867102283",
		"emp_dept_name": "市场部",
		"emp_dept_code": "DP00001",
		"emp_dept_source_code": "000001",
		"emp_id": "6360879952207158181",
		"emp_code": "EMP0001",
		"emp_name": "张明",
		"emp_source_code": "000001",
		"cm_id": "4786443529856258791",
		"cm_code": "CUS00001",
		"cm_name": "南京苏果超市",
		"cm_source_code": "0001",
		"cm_dept_id": "5479044577173277483",
		"cm_dept_name": "南京市场部",
		"cm_dept_code": "DP0001",
		"cm_dept_source_code": "00001",
		"purchase_status": "CG_DFH",
		"purchase_business_status": "CG_DFH",
		"consignment_date": "2016-12-01",
		"order_amount": "35.10",
		"order_discount_amount": "11.10",
		"pictures": "http://imag.jpg",
		"creator_id": "5479044577173277483",
		"create_name": "张三",
		"create_time_str": "2016-12-01 00:00:00.999",
		"modify_time_str": "2016-12-01 00:00:00.999",
		"confirm_emp_id": "5479044577173277483",
		"confirm_emp_name": "李四",
		"confirm_time_str": "2016-12-01 00:00:00",
		"confirm_reason": "错误！",
		"reconfirm_emp_id": "5479044577173277483",
		"reconfirm_emp_name": "李四",
		"reconfirm_time_str": "2016-12-01 00:00:00",
		"reconfirm_reason": "测试！",
		"order_type": "ZY",
		"receive_name": "李四",
		"receive_phone": "18254623212",
		"receive_tel": "02589652314",
		"receive_addr": "江苏省南京建邺区云龙山路66号",
		"receive_addr_id": "",
		"remark": "请尽快送货",
		"distribution_method_name": "配送方式名称",
		"gift_card_usedamount": "10.00",
        "amount_pool_usedamount":"10.00",
		"usedGiftCards": [{
			"rebate_account_amount": "10.00",
			"rebate_account_id": "8215768532653672550"
        	},...
        ],
        "usedAmountPools": [{
			"rebate_account_amount": "10.00",
			"rebate_account_id": "8215768532653672550"
        	},...
        ],
		"exts": [{
				"ext_key": "级别",
				"ext_value": "四星"
			},
			{
			"id": "7226306356013346628",
			"status": "1",
			"purchase_no": "CK201612010001",
			"date": "2016-12-01",
			"emp_dept_id": "6173157522867102283",
			"emp_dept_name": "市场部",
			"emp_dept_code": "DP00001",
			"emp_dept_source_code": "000001",
			"emp_id": "6360879952207158181",
			"emp_code": "EMP0001",
			"emp_name": "张明",
			"emp_source_code": "000001",
			"cm_id": "4786443529856258791",
			"cm_code": "CUS00001",
			"cm_name": "南京苏果超市",
			"cm_source_code": "0001",
			"cm_dept_id": "5479044577173277483",
			"cm_dept_name": "南京市场部",
			"cm_dept_code": "DP0001",
			"cm_dept_source_code": "00001",
			"purchase_status": "CG_DFH",
			"purchase_business_status": "CG_DFH",
			"consignment_date": "2016-12-01",
			"order_amount": "35.10",
			"order_discount_amount": "11.10",
			"pictures": "http://imag.jpg",
			"creator_id": "5479044577173277483",
			"create_name": "张三",
			"create_time_str": "2016-12-01 00:00:00.999",
			"modify_time_str": "2016-12-01 00:00:00.999",
			"confirm_emp_id": "5479044577173277483",
			"confirm_emp_name": "李四",
			"confirm_time_str": "2016-12-01 00:00:00",
			"confirm_reason": "错误！",
			"reconfirm_emp_id": "5479044577173277483",
			"reconfirm_emp_name": "李四",
			"reconfirm_time_str": "2016-12-01 00:00:00",
			"reconfirm_reason": "测试！",
			"order_type": "ZY",
			"receive_name": "李四",
			"receive_phone": "18254623212",
			"receive_tel": "02589652314",
			"receive_addr": "江苏省南京建邺区云龙山路66号",
             "receive_addr_id": "",
			"remark": "请尽快送货",
              "distribution_method_name": "配送方式名称",
                 "gift_card_usedamount":"10.00",
                "amount_pool_usedamount":"10.00",
            "usedGiftCards":[
                    {
                    "reduce_amount":"10.00",
                    "card_id":"8215768532653672550",
                    "card_no":"20201120160540000025"
                    },
                    ....
                ],
                "usedAmountPools":[{
                    "rebate_account_amount":"10.00",
                    "rebate_account_id":"8215768532653672550"
                }]
			"exts": [
			        {
			            "ext_key": "级别",
			            "ext_value": "四星"
			        },
			        {
			            "ext_key": "主营商品",
			            "ext_value": "食品,电器,日化用品"
			        },......
			    ],
			"prods": 
			[
			      {
			            "detail_id": "4843786111936788462",
			            "product_id": "4843786111936788462",
			            "product_name": "商品1",
			            "product_code": "P0001",
			            "purchase_price": "10.00000000",
			            "purchase_count": "20.00000000",
			            "purchase_input_unit": "8215768532653672550",
			            "purchase_input_unit_name": "箱",
			            "base_unit": "6930792320160995628",
			            "base_unit_name": "瓶",
			            "purchase_base_unit_count": "120.00000000",
			            "purchase_amount": "200.00",
			            "purchase_discount_amount": "10.00",
			            "remark": "易损件",
			            "is_gift": "N",
			            "promotion_code": "CUX0052",
			            "promotion_name": "促销1",
			            "promotion_type": "OVERLAP",
			            "promotion_tag": "TAG_TJ",
			            "promotion_calc_mode": "MODE_MZ",
			            "promotion_calc_type": "TYPE_NUM",
			            "posnr": "10",
        				"addpd_pool_id":"8215768532653672550"
			        "exts": [
			        {
			            "ext_key": "级别",
			            "ext_value": "四星"
			        },
			        {
			            "ext_key": "主营商品",
			            "ext_value": "食品,电器,日化用品"
			        },......
			    ]
			},
			……………………
			]
		}]
	}]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	否	响应说明
response_data	VARCHAR(32)	否	响应数据体[{......}]
id	VARCHAR(32)	是	采购单ID
status	VARCHAR(1)	否	0：已删除，1：正常
purchase_no	VARCHAR(100)	否	采购单编号
date	TIMESTAMP	否	业务日期，yyyy-mm-dd格式
emp_dept_id	VARCHAR(32)	否	业务员下单时候所在的部门id
emp_dept_source_code	VARCHAR(32)	否	业务员下单时候所在的部门对应外部数据id
emp_id	VARCHAR(32)	否	单据业务员id
emp_code	VARCHAR(100)	否	员工编码
emp_name	VARCHAR(100)	否	单据业务员名称
emp_source_code	VARCHAR(32)	否	单据业务员对应外部数据id
trade_type	VARCHAR(32)	否	客户类型2:经销商,3:终端门店
cm_id	VARCHAR(32)	否	客户id
cm_code	VARCHAR(32)	否	客户编码
cm_name	VARCHAR(100)	否	客户名称
cm_source_code	VARCHAR(32)	否	客户对应外部数据id
cm_dept_id	VARCHAR(32)	否	下单时候客户所在的部门id
cm_dept_name	VARCHAR(100)	否	下单时候客户所在部门的名称
cm_dept_code	VARCHAR(100)	否	下单时候客户所在部门的编码
cm_dept_source_code	VARCHAR(32)	否	下单时候客户所在的部门对应外部数据id
purchase_status	varchar(32)	否	采购订单状态：CG_DFH、待发货，CG_DRK:待入库，CG_YWC:已完成，CG_DQR：待确认，CG_YQX：已取消，CG_FHZ：发货中
purchase_business_status	VARCHAR(100)	否	采购单自定义业务状态
consignment_date	TIMESTAMP	否	要求送货日期yyyy-mm-dd
order_amount	numeric(20,2)	否	采购单据总金额
order_discount_amount	numeric(20,2)	否	销售单据优惠金额
pictures	VARCHAR(4000)	否	照片，多张使用逗号分隔
creator_id	VARCHAR(32)	否	单据创建人
create_name	VARCHAR(100)	否	单据创建人名称
create_time_str	TIMESTAMP	否	单据提交时间 yyyy-mm-dd hh24:mi:ss.us
modify_time_str	TIMESTAMP	否	单据最近一次变更时间 yyyy-mm-dd hh24:mi:ss.us
confirm_emp_id	VARCHAR(32)	否	确认人id
confirm_emp_name	VARCHAR(100)	否	确认人名称
confirm_time_str	TIMESTAMP	否	确
confirm_reason	VARCHAR(100)	否	确认意见
reconfirm_emp_id	VARCHAR(32)	否	反确认人id
reconfirm_emp_name	varchar(100)	否	反确认人名称
reconfirm_time_str	TIMESTAMP	否	反确认时间yyyy-mm-dd hh24:mi:ss
reconfirm_reason	varchar(4000)	否	反确认意见
receive_name	varchar(1000)	否	收货人名称
receive_phone	varchar(100)	否	收货人手机号码
receive_tel	varchar(100)	否	收货人电话
receive_addr	varchar(4000)	否	收货地址
receive_addr_id	VARCHAR(32)	否	收货地址id
remark	text	否	备注
distribution_method_name	text	否	配送方式名称
visit_implement_id	varchar(100)	否	关联的高级拜访id
order_source	varchar(100)	否	订单来源，NBZHSJ:内部账号手机(业代手机)，NBZHWB:内部账号web（业代web），WBZHSJ:外部账号手机（客户手机），WBZHWB:外部账号web（客户web），MDWXXD:客户微信下单，JK:接口 DINGHUO365:客户订货365（客户手机），GJBF：高级拜访；
pay_status	varchar(100)	否	0：未支付 1：已支付 3：线下支付
order_class	varchar(100)	否	ZC:销售订单，HC:换出订单
gift_card_usedamount	VARCHAR(32)	否	折扣券使用金额
amount_pool_usedamount	VARCHAR(32)	否	费用池使用金额
usedGiftCards[].reduce_amount	VARCHAR(32)	否	折扣券使用金额
usedGiftCards[].card_id	VARCHAR(32)	否	折扣券
usedGiftCards[].card_no	VARCHAR(32)	否	折扣券号
usedAmountPools[].rebate_account_amount	VARCHAR(32)	否	费用池使用金额
usedAmountPools[].rebate_account_id	VARCHAR(32)	否	费用池账户
exts[].ext_key	varchar(4000)	否	采购单主信息扩展字段key值扩展字段需先在我方系统中创建。
exts[].ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接。
prods[].detail_id	VARCHAR(32)	是	子表id
prods[].product_id	varchar(32)	否	商品id
prods[].product_name	varchar(100)	否	商品名称
prods[].product_code	varchar(100)	否	商品编码
prods[].product_source_code	varchar(100)	否	商品对应外部数据id
prods[].purchase_price	numeric(28,8)	否	采购价格
prods[].purchase_count	numeric(28,8)	否	采购数量
prods[].purchase_input_unit	VARCHAR(32)	否	采购时候录入单位id
prods[].purchase_input_unit_name	VARCHAR(100)	否	采购时候录入单位名称
prods[].base_unit	VARCHAR(32)	否	采购时候商品基本单位id
prods[].base_unit_name	VARCHAR(100)	否	采购时候商品基本单位名称
prods[].purchase_base_unit_count	numeric(28,8)	否	采购数量转化成基本单位以后的数量
prods[].purchase_amount	numeric(20,2)	否	采购金额
prods[].purchase_discount_amount	numeric(20,2)	否	采购优惠金额
prods[].remark	text	否	备注
prods[].is_gift	varchar(2)	否	是否是赠品Y:是 N：否
prods[].promotion_code	varchar(200)	否	促销编码
prods[].promotion_name	varchar(200)	否	促销名称
prods[].promotion_type	varchar(200)	否	促销类型：BASE:基本策略，OVERLAP:叠加策略。默认BASE
prods[].promotion_tag	varchar(200)	否	促销力度：TAG_CHG:常规，TAG_TJ:特别推荐。默认TAG_CHG
prods[].promotion_calc_mode	varchar(200)	否	促销模式:MODE_MZ:满赠，MODE_JT:阶梯
prods[].promotion_calc_type	varchar(200)	否	搭赠方式:TYPE_NUM:按订购量，TYPE_MONEY：按订购额
prods[].superposition_promotion_code	varchar(200)	否	叠加促销编码
prods[].superposition_promotion_name	varchar(200)	否	叠加促销名称
prods[].amount_promotion_code	varchar(200)	否	金额促销编码
prods[].amount_promotion_name	varchar(200)	否	金额促销名称
prods[].suggest_num	varchar(200)	否	建议订单数量（基本单位）
prods[].onway_inventory	varchar(200)	否	在途库存数量（基本单位）
prods[].real_inventory	varchar(200)	否	实物库存数量（基本单位）
prods[].safe_inventory	varchar(200)	否	安全库存数量（基本单位）
prods[].addpd_pool_id	varchar(200)	否	赠品池ID
prods[].exts[].ext_key	varchar(200)	否	采购单主信息扩展字段key值，扩展字段需先在我方系统中创建
prods[].exts[].ext_value	varchar(200)	否	扩展字段value值对多个选项值，以“,”分隔拼接。
prods[].posnr	numeric(15)	否	序号

# 查询分销销售订单

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsdatasearch/v1/getDmsSalesOrderInfos/{openid}/{timestamp}/{digest}/{msg_id}
请求包体：


{
    "page_number": 1,
    "s_status": 1,
    "purchase_no": "CG20150819",
    "s_cmCode": "CUS0001",
    "s_cmName": "客户1",
    "s_supplyCode": "CUS0001",
    "s_supplyName": "客户1",
    "emp_code": "EMP0001",
    "emp_name": "员工1",
    "create_time_begin": "2017-05-01 00:00:00",
    "create_time_end": "2017-05-31 00:00:00"
}

请求信息

参数	类型	必填	说明
page_number	INT	是	页码默认1，每页默认1000条
page_length	int	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整
s_status	CHAR(1)	否	记录状态：0 已删除 1 正常
order_no	VARCHAR(32)	否	销售订单编码，有效字符详见附录：有效字符说明 (opens new window)
s_cmCode	VARCHAR(32)	否	客户编码，有效字符详见附录：有效字符说明 (opens new window)
s_cmName	VARCHAR(32)	否	客户名称，唯一，有效字符详见名称类型参照表
s_supplyCode	VARCHAR(32)	否	供应商编码，有效字符详见附录：有效字符说明 (opens new window)
s_supplyName	VARCHAR(32)	否	供应商名称，唯一，有效字符详见名称类型参照表
emp_code	VARCHAR(32)	否	业务员编码，有效字符详见附录：有效字符说明 (opens new window)
emp_name	VARCHAR(32)	否	业务员名称，唯一，有效字符详见名称类型参照表
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”
s_orderClass	VARCHAR(32)	否	单据类型，ZC:正常订单,HC:换出订单

返回结果：

{
	"msg_id": "X000001",
	"return_code": "0",
	"return_msg": "",
	"response_data": [{
			"id": "7226306356013346628",
			"status": "1",
			"purchase_no": "CK201612010001",
			"date": "2016-12-01",
			"emp_dept_id": "6173157522867102283",
			"emp_dept_name": "市场部",
			"emp_dept_code": "DP00001",
			"emp_dept_source_code": "000001",
			"emp_id": "6360879952207158181",
			"emp_code": "EMP0001",
			"emp_name": "张明",
			"emp_source_code": "000001",
			"cm_id": "4786443529856258791",
			"cm_code": "CUS00001",
			"trade_type": "2",
			"cm_name": "南京苏果超市",
			"cm_source_code": "0001",
			"cm_dept_id": "5479044577173277483",
			"cm_dept_name": "南京市场部",
			"cm_dept_code": "DP0001",
			"cm_dept_source_code": "00001",
			"purchase_status": "CG_DFH",
			"purchase_business_status": "CG_DFH",
			"consignment_date": "2016-12-01",
			"order_amount": "35.10",
			"order_discount_amount": "11.10",
			"pictures": "http://imag.jpg",
			"creator_id": "5479044577173277483",
			"create_name": "张三",
			"create_time_str": "2016-12-01 00:00:00.999",
			"modify_time_str": "2016-12-01 00:00:00.999",
			"confirm_emp_id": "5479044577173277483",
			"confirm_emp_name": "李四",
			"confirm_time_str": "2016-12-01 00:00:00",
			"confirm_reason": "错误！",
			"reconfirm_emp_id": "5479044577173277483",
			"reconfirm_emp_name": "李四",
			"reconfirm_time_str": "2016-12-01 00:00:00",
			"reconfirm_reason": "测试！",
			"order_type": "ZY",
			"receive_name": "李四",
			"receive_phone": "18254623212",
			"receive_tel": "02589652314",
			"receive_addr": "江苏省南京建邺区云龙山路66号",
			"remark": "请尽快送货",
            "gift_card_usedamount":"10.00",
            "amount_pool_usedamount":"10.00",
            "usedGiftCards":[
                    {
                    "reduce_amount":"10.00",
                    "card_id":"8215768532653672550",
                    "card_no":"20201120160540000025"
                    },
                    ....
                ],
                "usedAmountPools":[{
                    "rebate_account_amount":"10.00",
                    "rebate_account_id":"8215768532653672550"
                }]
			"exts": [
			        {
			            "ext_key": "级别",
			            "ext_value": "四星"
			        },
			        {
			            "ext_key": "主营商品",
			            "ext_value": "食品,电器,日化用品"
			        },......
			    ],
			"prods": 
			[
			      {
			            "detail_id": "4843786111936788462",
			            "product_id": "4843786111936788462",
			            "product_name": "商品1",
			            "product_code": "P0001",
			            "purchase_price": "10.00000000",
			            "purchase_count": "20.00000000",
			            "purchase_input_unit": "8215768532653672550",
			            "purchase_input_unit_name": "箱",
			            "base_unit": "6930792320160995628",
			            "base_unit_name": "瓶",
			            "purchase_base_unit_count": "120.00000000",
			            "purchase_amount": "200.00",
			            "purchase_discount_amount": "10.00",
			            "remark": "易损件",
			            "is_gift": "N",
			            "promotion_code": "CUX0052",
			            "promotion_name": "促销1",
			            "promotion_type": "OVERLAP",
			            "promotion_tag": "TAG_TJ",
			            "promotion_calc_mode": "MODE_MZ",
			            "promotion_calc_type": "TYPE_NUM",
			            "posnr": "10",
        				"addpd_pool_id":"8215768532653672550"
			},
			……………………
			]
	        },
	        .......
	    ]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	否	响应说明
response_data	VARCHAR(32)	否	响应数据体[{......}]
id	VARCHAR(32)	是	采购单ID
status	VARCHAR(1)	否	0：已删除，1：正常
order_no	VARCHAR(100)	否	销售订单编号
date	TIMESTAMP	否	业务日期，yyyy-mm-dd格式
emp_dept_id	VARCHAR(32)	否	业务员下单时候所在的部门id
emp_dept_name	VARCHAR(100)	否	业务员下单时候所在的部门名称
emp_dept_code	VARCHAR(100)	否	业务员下单时候所在的部门编码
emp_dept_source_code	VARCHAR(32)	否	业务员下单时候所在的部门对应外部数据id
emp_id	VARCHAR(32)	否	单据业务员id
emp_code	VARCHAR(100)	否	员工编码
emp_name	VARCHAR(100)	否	单据业务员名称
emp_source_code	VARCHAR(32)	否	单据业务员对应外部数据id
trade_type	VARCHAR(32)	否	客户类型2:经销商,3:终端门店
cm_id	VARCHAR(32)	否	客户id
cm_code	VARCHAR(32)	否	客户编码
cm_name	VARCHAR(100)	否	客户名称
cm_source_code	VARCHAR(32)	否	客户对应外部数据id
cm_dept_id	VARCHAR(32)	否	下单时候客户所在的部门id
cm_dept_name	VARCHAR(100)	否	下单时候客户所在部门的名称
cm_dept_code	VARCHAR(100)	否	下单时候客户所在部门的编码
cm_dept_source_code	VARCHAR(32)	否	下单时候客户所在的部门对应外部数据id
order_status	varchar(32)	否	销售订单状态：XS_DFH、待发货，XS_DQS:待签收，XS_YWC：已完成，XS_DQR：待确认，XS_YQX：已取消，XS_FHZ：发货中
supply_id	VARCHAR(32)	否	供货商id
supply_name	VARCHAR(100)	否	供货商名称
supply_code	VARCHAR(100)	否	供货商编码
supply_source_code	VARCHAR(100)	否	供货商第三方id
consignment_date	TIMESTAMP	否	要求送货日期yyyy-mm-dd
order_amount	numeric(20,2)	否	采购单据总金额
order_discount_amount	numeric(20,2)	否	销售单据优惠金额
pictures	VARCHAR(4000)	否	照片，多张使用逗号分隔
creator_id	VARCHAR(32)	否	单据创建人
create_name	VARCHAR(100)	否	单据创建人名称
create_time_str	TIMESTAMP	否	单据提交时间 yyyy-mm-dd hh24:mi:ss.us
modify_time_str	TIMESTAMP	否	单据最近一次变更时间 yyyy-mm-dd hh24:mi:ss.us
confirm_emp_id	VARCHAR(32)	否	确认人id
confirm_emp_name	VARCHAR(100)	否	确认人名称
confirm_time_str	TIMESTAMP	否	确认时间yyyy-mm-dd hh24:mi:ss
confirm_reason	VARCHAR(100)	否	确认意见
reconfirm_emp_id	VARCHAR(32)	否	反确认人id
reconfirm_emp_name	varchar(100)	否	反确认人名称
reconfirm_time_str	TIMESTAMP	否	反确认时间yyyy-mm-dd hh24:mi:ss
reconfirm_reason	varchar(4000)	否	反确认意见
receive_name	varchar(1000)	否	收货人名称
receive_phone	varchar(100)	否	收货人手机号码
receive_tel	varchar(100)	否	收货人电话
receive_addr	varchar(4000)	否	收货地址
remark	text	否	备注
visit_implement_id	varchar(100)	否	关联的高级拜访id
order_source	varchar(100)	否	NBZHSJ:内部账号手机(业代手机)，NBZHWB:内部账号web（业代web），WBZHSJ:外部账号手机（客户手机），WBZHWB:外部账号web（客户web），MDWXXD:客户微信下单，JK:接口,DINGHUO365:(客户手机端)，GJBF：高级拜访(业代高级拜访)；
order_class	varchar(32)	否	ZC:正常订单；HC:换出订单；
gift_card_usedamount	VARCHAR(32)	否	折扣券使用金额
amount_pool_usedamount	VARCHAR(32)	否	费用池使用金额
usedGiftCards[].reduce_amount	VARCHAR(32)	否	折扣券使用金额
usedGiftCards[].card_id	VARCHAR(32)	否	折扣券id
usedGiftCards[].card_no	VARCHAR(32)	否	折扣券号
usedAmountPools[].rebate_account_amount	VARCHAR(32)	否	费用池使用金额
usedAmountPools[].rebate_account_id	VARCHAR(32)	否	费用池账户
prods[].detail_id	VARCHAR(32)	是	子表id
prods[].product_id	varchar(32)	否	商品id
prods[].product_name	varchar(100)	否	商品名称
prods[].product_code	varchar(100)	否	商品编码
prods[].product_source_code	varchar(100)	否	商品对应外部数据id
prods[].order_price	numeric(28,8)	否	价格
prods[].order_count	numeric(28,8)	否	数量
prods[].order_input_unit	VARCHAR(32)	否	下单时候录入单位id
prods[].order_input_unit_name	VARCHAR(100)	否	下单时候录入单位名称
prods[].base_unit	VARCHAR(32)	否	下单时候商品基本单位id
prods[].base_unit_name	VARCHAR(100)	否	下单时候商品基本单位名称
prods[].order_base_unit_count	numeric(28,8)	否	数量转化成基本单位以后的数量
prods[].order_amount	numeric(20,2)	否	金额
prods[].order_discount_amount	numeric(20,2)	否	优惠金额
prods[].remark	text	否	备注
prods[].is_gift	varchar(2)	否	是否是赠品Y:是 N：否
prods[].promotion_code	varchar(200)	否	促销编码
prods[].promotion_name	varchar(200)	否	促销名称
prods[].promotion_type	varchar(200)	否	促销类型：BASE:基本策略，OVERLAP:叠加策略。默认BASE
prods[].promotion_tag	varchar(200)	否	促销力度：TAG_CHG:常规，TAG_TJ:特别推荐。默认TAG_CHG
prods[].promotion_calc_mode	varchar(200)	否	促销模式:MODE_MZ:满赠，MODE_JT:阶梯
prods[].promotion_calc_type	varchar(200)	否	搭赠方式:TYPE_NUM:按订购量，TYPE_MONEY：按订购额
prods[].suggest_num	varchar(200)	否	建议订单数量（基本单位）
prods[].onway_inventory	varchar(200)	否	在途库存数量（基本单位）
prods[].real_inventory	varchar(200)	否	实物库存数量（基本单位）
prods[].safe_inventory	varchar(200)	否	安全库存数量（基本单位）
prods[].posnr	numeric(15)	否	序号
prods[].addpd_pool_id	varchar(200)	否	赠品池ID

# 查询分销或者直营发货单

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsdatasearch/v1/getDmsOrderSentInfos/{openid}/{timestamp}/{digest}/{msg_id}
请求包体：


{
    "page_number": 1,
    "s_status": 1,
    "send_no": "FH20150819",
    "send_date_begin": "2017-05-01 00:00:00",
    "send_date_end": "2017-05-31 00:00:00"
}

请求信息

参数	类型	必填	说明
page_number	INT	是	页码默认1，每页默认1000条
page_length	int	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整
s_status	CHAR(1)	否	记录状态：0 已删除 1 正常
send_no	VARCHAR(32)	否	发货单编码，有效字符详见附录：有效字符说明 (opens new window)
order_type	VARCHAR(32)	否	单据类型，ZY:直营，FX:分销
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”

返回结果：

{
	"msg_id":"X000001",
	"return_code":"0",
	"return_msg":"", 
	"response_data": [
			{
			"id": "7226306356013346628",
			"status": "1",
			"sent_no": "FH201612010001",
			"purchase_no": "CK201612010001",
			"order_no": "FX201612010001",
			"order_id": "7226306356013346628",
			"date": "2016-12-01",
			"order_amount": "10.00",
			"order_discount_amount": "2.00",
			"emp_dept_id": "6173157522867102283",
			"emp_dept_name": "市场部",
			"emp_dept_code": "DP00001",
			"emp_dept_source_code": "000001",
			"emp_id": "6360879952207158181",
			"emp_code": "EMP0001",
			"emp_name": "张明",
			"emp_source_code": "000001",
			"send_time_str": "2016-12-01 00:00:00",
			"send_id": "4786443529856258791",
			"send_name": "张三",
			"send_code": "EMP0001",
			"send_source_code": "EMP0001",
			"cm_id": "4786443529856258791",
			"cm_code": "CUS00001",
			"cm_name": "南京苏果超市",
			"cm_source_code": "0001",
			"cm_dept_id": "5479044577173277483",
			"cm_dept_name": "南京市场部",
			"cm_dept_code": "DP0001",
			"cm_dept_source_code": "00001",
			"sign_status": "CG_DFH",
			"order_status": "CG_DFH",
			"purchase_status": "CG_DFH",
			"consignment_date": "2016-12-01",
			"supply_id": "4786443529856258791",
			"supply_name": "CUS00001",
			"supply_code": "南京苏果超市",
			"supply_source_code": "0001",
			"receive_name": "李四",
			"receive_phone": "18254623212",
			"receive_tel": "02589652314",
			"receive_addr": "江苏省南京建邺区云龙山路66号",
			"remark": "请尽快送货",
			"from_storehouse": "4786443529856258791",
			"from_storehouse_name": "仓库1",
			"from_storehouse_code": "ck001",
			"order_type": "ZY",
			"prods": 
			[
			      {
			            "detail_id": "4843786111936788462",
			            "order_detail_id": "4843786111936788462",
			            "product_id": "4843786111936788462",
			            "product_name": "商品1",
			            "product_code": "P0001",
			            "product_source_code": "P0001",
			            "order_price": "10.00000000",
			            "order_count": "20.00000000",
			            "order_input_unit": "8215768532653672550",
			            "order_input_unit_name": "箱",
			            "base_unit": "6930792320160995628",
			            "base_unit_name": "瓶",
			            "order_base_unit_count": "120.00000000",
			            "order_amount": "200.00",
			            "order_discount_amount": "10.00",
			            "is_gift": "N",
			            "sent_input_unit": "8215768532653672550"
			            "sent_input_unit_name": "箱"
			            "sent_base_unit_num": "20.0000"
			},
			……………………
			]
	        },
	        .......
	    ]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	否	响应说明
response_data	VARCHAR(32)	否	响应数据体[{......}]
id	VARCHAR(32)	是	单据ID
status	VARCHAR(1)	否	0：已删除，1：正常
sent_no	VARCHAR(100)	否	发货单编号
purchase_no	VARCHAR(100)	否	直营订单号
order_no	VARCHAR(100)	否	分销订单号
order_id	VARCHAR(32)	否	对应的分销或者直营单id
date	TIMESTAMP	否	单据业务日期，yyyy-mm-dd格式
order_amount	NUMERIC(20,2)	否	单据金额
order_discount_amount	NUMERIC(20,2)	否	单据优惠金额
emp_dept_id	VARCHAR(32)	否	业务员下单时候所在的部门id
emp_dept_name	VARCHAR(100)	否	业务员下单时候所在的部门名称
emp_dept_code	VARCHAR(100)	否	业务员下单时候所在的部门编码
emp_dept_source_code	VARCHAR(32)	否	业务员下单时候所在的部门对应外部数据id
emp_id	VARCHAR(32)	否	单据业务员id
emp_code	VARCHAR(100)	否	员工编码
emp_name	VARCHAR(100)	否	单据业务员名称
emp_source_code	VARCHAR(32)	否	单据业务员对应外部数据id
send_time_str	TIMESTAMP	否	发货单发货时间，yyyy-mm-dd hh24:mi:ss格式
send_id	VARCHAR(32)	否	发货人id
send_name	VRACHAR(100)	否	发货人名称
send_code	VRACHAR(100)	否	发货人编码
send_source_code	VRACHAR(32)	否	发货人对应外部数据id
cm_id	VARCHAR(32)	否	客户id
cm_code	VARCHAR(32)	否	客户编码
cm_name	VARCHAR(100)	否	客户名称
cm_source_code	VARCHAR(32)	否	客户对应外部数据id
cm_dept_id	VARCHAR(32)	否	下单时候客户所在的部门id
cm_dept_name	VARCHAR(100)	否	下单时候客户所在部门的名称
cm_dept_code	VARCHAR(100)	否	下单时候客户所在部门的编码
cm_dept_source_code	VARCHAR(32)	否	下单时候客户所在的部门对应外部数据id
sign_status	varchar(32)	否	发货单状态：FH_CLZ：发货处理中，FH_DQS：待签收，FH_YQS:已签收
order_status	varchar(32)	否	销售订单状态：XS_DFH、待发货，XS_DQS:待签收，XS_YWC：已完成，XS_DQR：待确认，XS_YQX：已取消，XS_FHZ：发货中
purchase_status	varchar(32)	否	直营订单状态： CG_DFH、待发货，CG_DRK:待入库，CG_YWC:已完成，CG_DQR：待确认，CG_YQX：已取消，CG_FHZ：发货中
consignment_date	TIMESTAMP	否	要求送货日期yyyy-mm-dd
supply_id	VARCHAR(32)	否	供货商id,-1就是没有供货商
supply_name	VARCHAR(200)	否	供货商名称
supply_code	VARCHAR(200)	否	供货商编码
supply_source_code	VARCHAR(32)	否	供货商第三方id
receive_name	varchar(100)	否	收货人名称
receive_phone	varchar(100)	否	收货人手机号码
receive_tel	varchar(100)	否	收货人电话
receive_addr	varchar(1000)	否	收货地址
remark	varchar(4000)	否	备注
from_storehouse	VARCHAR(32)	否	发货仓库id
from_storehouse_name	VARCHAR(200)	否	发货仓库名称
from_storehouse_code	VARCHAR(200)	否	发货仓库编码
order_type	varchar(20)	否	单据类型，ZY:直营，FX:分销
prods[].detail_id	VARCHAR(32)	是	发货子表id
prods[].order_detail_id	VARCHAR(32)	否	分销单或直营单的子表id
prods[].product_id	varchar(32)	否	商品id
prods[].product_name	varchar(100)	否	商品名称
prods[].product_code	varchar(100)	否	商品编码
prods[].product_source_code	varchar(32)	否	商品对应外部数据id
prods[].order_price	numeric(28,8)	否	价格
prods[].order_count	numeric(28,8)	否	数量
prods[].order_input_unit	VARCHAR(32)	否	下单时候录入单位id
prods[].order_input_unit_name	VARCHAR(100)	否	下单时候录入单位名称
prods[].base_unit	VARCHAR(32)	否	下单时候商品基本单位id
prods[].base_unit_name	VARCHAR(100)	否	下单时候商品基本单位名称
prods[].order_base_unit_count	numeric(28,8)	否	数量转化成基本单位以后的数量
prods[].order_amount	numeric(20,2)	否	金额
prods[].order_discount_amount	numeric(20,2)	否	优惠金额
prods[].is_gift	varchar(2)	否	是否是赠品Y:是 N：否
prods[].sent_num	numeric(28,8)	否	发货数量
prods[].sent_input_unit	VARCHAR(32)	否	发货单位
prods[].sent_input_unit_name	VARCHAR(100)	否	发货单位名称
prods[].sent_base_unit_num	numeric(28,8)	否	发货数量转化成基本单位的数量
waybilllogs[].bill_code	VARCHAR(100)	否	运单号
waybilllogs[].driver_name	VARCHAR(32)	否	司机姓名
waybilllogs[].driver_phone	VARCHAR(32)	否	司机联系电话
waybilllogs[].car_no	VARCHAR(32)	否	车牌号码
waybilllogs[].delivery_date	TIMESTAMP	否	预计送达时间
waybilllogs[].remark	TEXT	否	备注

# 查询分销或者直营签收单

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsdatasearch/v1/getDmsOrderSignInfos/{openid}/{timestamp}/{digest}/{msg_id}
请求包体：


{
    "page_number": 1,
    "s_status": 1,
    "send_no": "FH20150819",
    "send_date_begin": "2017-05-01 00:00:00",
    "send_date_end": "2017-05-31 00:00:00"
}

请求信息

参数	类型	必填	说明
page_number	INT	是	页码默认1，每页默认1000条
page_length	int	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整
s_status	CHAR(1)	否	记录状态：0 已删除 1 正常
sign_no	VARCHAR(32)	否	签收编码，有效字符详见附录：有效字符说明 (opens new window)
order_type	VARCHAR(32)	否	单据类型，ZY:直营，FX:分销
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”

返回结果：

{
	"msg_id":"X000001",
	"return_code":"0",
	"return_msg":"", 
	"response_data": [
			{
			"id": "7226306356013346628",
			"status": "1",
			"sign_no": "QS201612010001",
			"sent_no": "FH201612010001",
			"purchase_no": "CK201612010001",
			"order_no": "FX201612010001",
			"order_id": "7226306356013346628",
			"date": "2016-12-01",
			"order_amount": "10.00",
			"order_discount_amount": "2.00",
			"emp_dept_id": "6173157522867102283",
			"emp_dept_name": "市场部",
			"emp_dept_code": "DP00001",
			"emp_dept_source_code": "000001",
			"emp_id": "6360879952207158181",
			"emp_code": "EMP0001",
			"emp_name": "张明",
			"emp_source_code": "000001",
			"sign_time_str": "2016-12-01 00:00:00",
			"sign_object_id": "4786443529856258791",
			"sign_object_name": "张三",
			"cm_id": "4786443529856258791",
			"cm_code": "CUS00001",
			"cm_name": "南京苏果超市",
			"cm_source_code": "0001",
			"cm_dept_id": "5479044577173277483",
			"cm_dept_name": "南京市场部",
			"cm_dept_code": "DP0001",
			"cm_dept_source_code": "00001",
			"order_status": "CG_DFH",
			"purchase_status": "CG_DFH",
			"consignment_date": "2016-12-01",
			"supply_id": "4786443529856258791",
			"supply_name": "CUS00001",
			"supply_code": "南京苏果超市",
			"supply_source_code": "0001",
			"receive_name": "李四",
			"receive_phone": "18254623212",
			"receive_tel": "02589652314",
			"receive_addr": "江苏省南京建邺区云龙山路66号",
			"remark": "请尽快送货",
			"to_storehouse": "4786443529856258791",
			"to_storehouse_name": "仓库1",
			"to_storehouse_code": "ck001",
			"order_type": "ZY",
             "verification_code_sign": "1",
			"prods": 
			[
			      {
			            "detail_id": "4843786111936788462",
			            "order_detail_id": "4843786111936788462",
			            "sent_detail_id": "4843786111936788462",
			            "product_id": "4843786111936788462",
			            "product_name": "商品1",
			            "product_code": "P0001",
			            "product_source_code": "P0001",
			            "order_price": "10.00000000",
			            "order_count": "20.00000000",
			            "order_input_unit": "8215768532653672550",
			            "order_input_unit_name": "箱",
			            "base_unit": "6930792320160995628",
			            "base_unit_name": "瓶",
			            "order_base_unit_count": "120.00000000",
			            "order_amount": "200.00",
			            "order_discount_amount": "10.00",
			            "is_gift": "N",
			            "sent_num": "发货数量"
			            "sent_input_unit": "8215768532653672550"
			            "sent_input_unit_name": "箱"
			            "sent_base_unit_num": "20.0000"
			            "sign_num": "发货数量"
			            "sign_input_unit": "8215768532653672550"
			            "sign_input_unit_name": "箱"
			            "sign_base_unit_num": "20.0000",
                         "third_sign_num": ""
			},
			……………………
			]
	        },
	        .......
	    ]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	否	响应说明
response_data	VARCHAR(32)	否	响应数据体[{......}]
id	VARCHAR(32)	是	单据ID
sent_id	VARCHAR(32)	否	发货单据ID
status	VARCHAR(1)	否	0：已删除，1：正常
sent_no	VARCHAR(100)	否	发货单编号
sign_no	VARCHAR(100)	否	签收单编号
purchase_no	VARCHAR(100)	否	直营订单号
order_no	VARCHAR(100)	否	分销订单号
order_id	VARCHAR(32)	否	对应的分销或者直营单id
date	TIMESTAMP	否	单据业务日期，yyyy-mm-dd格式
order_amount	NUMERIC(20,2)	否	单据金额
order_discount_amount	NUMERIC(20,2)	否	单据优惠金额
emp_dept_id	VARCHAR(32)	否	业务员下单时候所在的部门id
emp_dept_name	VARCHAR(100)	否	业务员下单时候所在的部门名称
emp_dept_code	VARCHAR(100)	否	业务员下单时候所在的部门编码
emp_dept_source_code	VARCHAR(32)	否	业务员下单时候所在的部门对应外部数据id
emp_id	VARCHAR(32)	否	单据业务员id
emp_code	VARCHAR(100)	否	员工编码
emp_name	VARCHAR(100)	否	单据业务员名称
emp_source_code	VARCHAR(32)	否	单据业务员对应外部数据id
sign_time_str	TIMESTAMP	否	签收时间，yyyy-mm-dd hh24:mi:ss格式
sign_object_id	VARCHAR(32)	否	签收人id
sign_object_name	VRACHAR(100)	否	签收人名称
cm_id	VARCHAR(32)	否	客户id
cm_code	VARCHAR(32)	否	客户编码
cm_name	VARCHAR(100)	否	客户名称
cm_source_code	VARCHAR(32)	否	客户对应外部数据id
cm_dept_id	VARCHAR(32)	否	下单时候客户所在的部门id
cm_dept_name	VARCHAR(100)	否	下单时候客户所在部门的名称
cm_dept_code	VARCHAR(100)	否	下单时候客户所在部门的编码
cm_dept_source_code	VARCHAR(32)	否	下单时候客户所在的部门对应外部数据id
order_status	varchar(32)	否	销售订单状态：XS_DFH、待发货，XS_DQS:待签收，XS_YWC：已完成，XS_DQR：待确认，XS_YQX：已取消，XS_FHZ：发货中
purchase_status	varchar(32)	否	直营订单状态：CG_DFH、待发货，CG_DRK:待入库，CG_YWC:已完成，CG_DQR：待确认，CG_YQX：已取消，CG_FHZ：发货中
consignment_date	TIMESTAMP	否	要求送货日期yyyy-mm-dd
supply_id	VARCHAR(32)	否	供货商id,-1就是没有供货商
supply_name	VARCHAR(200)	否	供货商名称
supply_code	VARCHAR(200)	否	供货商编码
supply_source_code	VARCHAR(32)	否	供货商第三方id
receive_name	varchar(100)	否	收货人名称
receive_phone	varchar(100)	否	收货人手机号码
receive_tel	varchar(100)	否	收货人电话
receive_addr	varchar(1000)	否	收货地址
remark	varchar(4000)	否	备注
to_storehouse	VARCHAR(32)	否	签收仓库id
to_storehouse_name	VARCHAR(200)	否	签收仓库名称
to_storehouse_code	VARCHAR(200)	否	签收仓库编码
order_type	varchar(20)	否	单据类型，ZY:直营，FX:分销
verification_code_sign	varchar(20)	否	验证码回单确认，1：是，0：否
cm_location_a	VARCHAR(100)	否	客户位置
sign_location_a	VARCHAR(100)	否	签收位置
sign_deviation	VARCHAR(100)	否	偏差距离(米)
sign_deviation_remark	VARCHAR(200)	否	偏差备注
sign_pictures	VARCHAR(200)	否	签收照片，多张使用逗号分隔
prods[].detail_id	VARCHAR(32)	是	签收子表id
prods[].sent_detail_id	VARCHAR(32)	否	发货子表id
prods[].order_detail_id	VARCHAR(32)	否	分销单或直营单的子表id
prods[].product_id	varchar(32)	否	商品id
prods[].product_name	varchar(100)	否	商品名称
prods[].product_code	varchar(100)	否	商品编码
prods[].product_source_code	varchar(32)	否	商品对应外部数据id
prods[].order_price	numeric(28,8)	否	价格
prods[].order_count	numeric(28,8)	否	数量
prods[].order_input_unit	VARCHAR(32)	否	下单时候录入单位id
prods[].order_input_unit_name	VARCHAR(100)	否	下单时候录入单位名称
prods[].base_unit	VARCHAR(32)	否	下单时候商品基本单位id
prods[].base_unit_name	VARCHAR(100)	否	下单时候商品基本单位名称
prods[].order_base_unit_count	numeric(28,8)	否	数量转化成基本单位以后的数量
prods[].order_amount	numeric(20,2)	否	金额
prods[].order_discount_amount	numeric(20,2)	否	优惠金额
prods[].is_gift	varchar(2)	否	是否是赠品Y:是 N：否
prods[].sent_num	numeric(28,8)	否	发货数量
prods[].sent_input_unit	VARCHAR(32)	否	发货单位
prods[].sent_input_unit_name	VARCHAR(100)	否	发货单位名称
prods[].sent_base_unit_num	numeric(28,8)	否	发货数量转化成基本单位的数量
prods[].sign_num	numeric(28,8)	否	签收数量
prods[].sign_input_unit	VARCHAR(32)	否	发货单位
prods[].sign_input_unit_name	VARCHAR(100)	否	签收单位名称
prods[].sign_base_unit_num	numeric(28,8)	否	签收数量转化成基本单位的数量
prods[].third_sign_num	numeric(28,8)	否	第三方签收数量

# 查询盘点单

请求方式： 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": true, 
    "response_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
        },
        .......
    ]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	否	响应说明
response_data	VARCHAR(32)	否	响应数据
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[].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/dmscardistributeorder/v1/queryCarDistributeOrder/{ 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": true, 
    "response_data": [
        {
            "emp_dept_id": "10", 
            "supply_id": "4770912364031621073", 
            "from_storehouse_code": "CK1", 
            "prods": [
                {
                    "order_input_unit_name": "盒", 
                    "is_gift": "N", 
                    "order_discount_amount": 0, 
                    "product_id": "6692513571119135747", 
                    "order_base_unit_count": 1, 
                    "remark": "", 
                    "order_input_unit": "1", 
                    "product_name": "测试商品1", 
                    "order_id": "5387924606115660563", 
                    "order_price": 1200, 
                    "posnr": 10, 
                    "order_cost_price": 5, 
                    "base_unit": "1", 
                    "product_source_code": null, 
                    "order_amount": 1200, 
                    "order_tax": 0.17, 
                    "product_code": "1HBSKLSD", 
                    "order_tax_amount": 174.36, 
                    "order_base_unit_name": "盒", 
                    "order_cost_amount": 5, 
                    "order_count": 1
                },
                ......
            ], 
            "cm_id": "7581300961993665224", 
            "receive_phone": "", 
            "receive_name": "", 
            "supply_name": "南京雨花一级经销商", 
            "emp_dept_code": "dms", 
            "pictures": null, 
            "remarks": "", 
            "cm_dept_code": "dms", 
            "from_storehouse_target_name": "南京雨花一级经销商", 
            "from_storehouse": "1", 
            "date": "2017-03-28", 
            "order_no": "CP20170328000001", 
            "id": "5387924606115660563", 
            "cm_code": "CUS000066", 
            "cm_source_code": null, 
            "order_amount": 1200, 
            "cm_dept_id": "10", 
            "order_tax_amount": 174.36, 
            "order_source": "NBZHSJ", 
            "order_cost_amount": 5, 
            "receive_addr": "", 
            "receive_tel": "", 
            "cm_name": "newmendian1", 
            "emp_dept_name": "dms", 
            "emp_code": "xyd", 
            "emp_dept_source_code": "dms", 
            "order_discount_amount": 0, 
            "supply_code": "0008099346", 
            "status": "1", 
            "from_storehouse_name": "11", 
            "emp_id": "5623756076322438484", 
            "from_storehouse_target_code": "0008099346", 
            "from_storehouse_target_source_code": null, 
            "cm_dept_name": "dms", 
            "emp_source_code": "xyd", 
            "supply_source_code": null, 
            "from_storehouse_target_id": "4770912364031621073", 
            "emp_name": "翔业代", 
            "cm_dept_source_code": "dms", 
            "order_type": "FX"
        }
    ]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	否	响应说明
response_data	VARCHAR(32)	否	响应数据
id	INT8	是	车铺单ID
status	VARCHAR(32)	否	车铺单状态0：已删除，1：正常
order_no	VARCHAR(100)	否	车铺单编号
date	VARCHAR(100)	否	业务日期，yyyy-mm-dd格式
emp_dept_id	INT8	否	业务员当时下单所在的部门id
emp_dept_code	VARCHAR(100)	否	业务员当时下单所在的部门编码
emp_dept_name	VARCHAR(100)	否	业务员当时下单所在的部门名
emp_id	INT8	否	经办人ID
emp_code	VARCHAR(100)	否	经办人编码
emp_source_code	VARCHAR(100)	否	员工关联的第三方id
emp_name	VARCHAR(100)	否	经办人名称
cm_dept_id	INT8	否	客户部门id
cm_dept_code	VARCHAR(100)	否	客户部门编码
cm_dept_source_code	VARCHAR(100)	否	客户部门源编码
cm_dept_name	VARCHAR(100)	否	客户部门名
cm_id	INT8	否	客户ID
cm_code	VARCHAR(100)	否	客户编码
cm_source_code	VARCHAR(100)	否	客户源编码
cm_name	VARCHAR(100)	否	客户名称
pictures	VARCHAR(100)	否	订单图片，全路径（多张逗号分隔）
supply_id	INT8	否	供货商id 默认值是-1,-1就是厂家
supply_code	VARCHAR(100)	否	供货商编码
supply_source_code	VARCHAR(100)	否	供货商源编码
supply_name	VARCHAR(100)	否	供货商名
order_type	VARCHAR(100)	否	订单类型 ZY:直营，FX:分销
order_source	varchar(100)	否	NBZHSJ:内部账号手机(业代手机)，NBZHWB:内部账号web（业代web），WBZHSJ:外部账号手机（客户手机），WBZHWB:外部账号web（客户web），MDWXXD:客户微信下单，JK:接口,DINGHUO365:(客户手机端)，GJBF：高级拜访(业代高级拜访)；
receive_name	VARCHAR(100)	否	收货人名称
receive_phone	VARCHAR(100)	否	收货人手机号码
receive_tel	VARCHAR(100)	否	收货人电话
receive_addr	VARCHAR(100)	否	收货地址
remarks	text	否	备注
order_amount	VARCHAR(100)	否	订货金额
order_discount_amount	VARCHAR(100)	否	订货优惠金额
order_tax_amount	VARCHAR(100)	否	订货税额
order_cost_amount	VARCHAR(100)	否	订货成本金额
from_storehouse	INT8	否	发货仓库id
from_storehouse_code	VARCHAR(100)	否	发货仓库编码
from_storehouse_name	VARCHAR(100)	否	仓库名称
from_storehouse_target_id	INT8	否	发货仓库分配对象客户id
from_storehouse_target_code	VARCHAR(100)	否	发货仓库分配对象客户编码
from_storehouse_target_source_code	VARCHAR(100)	否	发货仓库分配对象客户源编码
from_storehouse_target_name	VARCHAR(100)	否	发货仓库分配对象客户名称
visit_implement_id	VARCHAR(100)	否	关联的高级拜访id
prods[].id	INT8	是	子表id
prods[].product_id	varchar(32)	否	商品ID
prods[].product_code	VARCHAR(100)	否	商品编码
prods[].product_source_code	VARCHAR(100)	否	商品源编码
prods[].product_name	VARCHAR(100)	否	商品名称
prods[].order_price	numeric(20,8)	否	订货价格
prods[].order_count	numeric(10,8)	否	订货数量
prods[].order_input_unit	INT8	否	订货单位id
prods[].order_input_unit_name	VARCHAR(100)	否	订货单位名
prods[].base_unit	INT8	否	商品的基本单位id
prods[].order_base_unit_name	VARCHAR(100)	否	商品的基本单位名
prods[].order_base_unit_count	numeric(10,8)	否	订货数量转化成基本单位的数量
prods[].order_amount	numeric(20,2)	否	订货的金额
prods[].order_cost_amount	numeric(20,2)	否	订货成本金额
prods[].order_cost_price	numeric(20,8)	否	订货商品成本价
prods[].order_discount_amount	numeric(20,2)	否	订货优惠金额
prods[].order_tax	numeric(20,2)	否	订货商品税率
prods[].order_tax_amount	numeric(20,2)	否	订货税额
prods[].remark	text	否	备注
prods[].order_id	INT8	否	车铺单主表id
prods[].posnr	NUMERIC(20)	否	项目号 '10,20,查询排序时候也可使用
prods[].is_gift	VARCHAR(32)	否	是否是商品促销策略里面的赠品 Y:是 N：否

# 查询实时库存

请求方式： 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": true, 
    "response_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"
        },
        .......
    ]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	否	响应说明
response_data	VARCHAR(32)	否	响应数据
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/dmsdatasearch/v1/getDmsBackOrderInfos/{openid}/{timestamp}/{digest}/{msg_id}
请求包体：


{
    "page_number": 1,
    "page_length": 100,
    "s_status": "1",
    "order_type": "FXHRHH",
    "after_create_date": "2018-11-06 10:29:11"
}

请求信息

参数	类型	必填	说明
page_number	INT	是	页码默认1，每页默认1000条
page_length	int	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整
s_status	CHAR(1)	否	记录状态：0 已删除 1 正常
order_no	VARCHAR(32)	否	退货单编码，有效字符详见附录：有效字符说明 (opens new window)
order_type	VARCHAR(32)	否	订单类型，FXGLTH:分销关联退货，FXSPTH:分销商品退货，FXHRHH:分销换入换货，ZYGLTH:直营关联退货，ZYSPTH:直营商品退货，ZYHRHH:直营换入换货
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”

返回结果：

{
	"msg_id":"X000001",
	"return_code":"0",
	"return_msg":"", 
	"response_data": [{
	"confirm_emp_code": "",
	"supply_id": 6975322184779002302,
	"remark": "",
	"confirm_emp_name": "",
	"prods": [{
		"ruzhang_input_unit": -1,
		"product_id": 6692513571119135747,
		"remark": "",
		"ruzhang_input_unit_name": "",
		"product_name": "海之蓝1L",
		"shenqing_amount": "1200.00",
		"confirm_input_unit_name": "",
		"posnr": 1,
		"promotion_id": -1,
		"shenqing_count": "1.0",
		"outstock_input_unit_name": "",
		"shouhuo_base_unit_count": "0.0",
		"promotion_name": "",
		"outstock_input_unit": -1,
		"confirm_base_unit_count": "0.0",
		"shenqing_input_unit_name": "盒",
		"shouhuo_amount": "0.00",
		"shouhuo_input_unit_name": "",
		"is_gift": "N",
		"detail_id": "5019132889885603614",
		"confirm_amount": "0.00",
		"shenqing_price": "1200.00",
		"product_type": "",
		"outstock_count": "0.0",
		"superposition_promotion_id": -1,
		"ruzhang_count": "0.0",
		"base_unit": 1,
		"shouhuo_count": "0.0",
		"superposition_promotion_name": "",
		"base_unit_name": "盒",
		"outstock_base_unit_count": "0.0",
		"confirm_count": "0.0",
		"confirm_input_unit": -1,
		"ruzhang_base_unit_count": "0.0",
		"shenqing_input_unit": 1,
		"product_code": "1010000097",
		"shenqing_base_unit_count": "1.0",
		"shouhuo_input_unit": -1,
		"sent_detail_id": "",
        "return_order_detail_type": ""
	}],
    "exts": [{
        "ext_key": "级别",
        "ext_value": "四星"
    }],
	"under_out_time": "",
	"receive_phone": "15005192711",
	"order_no": "TH20181106000002",
	"cm_tenant_id": -1,
	"cm_source_code": "",
	"change_back_reason_id": 1,
	"modify_source_code": "",
	"order_source": "GJBF",
	"modify_time": "",
	"cm_name": "南京雨花二级门店",
	"status": "1",
	"modifyier_id": "",
	"creator_id": 7087551921713004433,
	"order_status": "DD_DQR",
	"confirm_emp_id": "",
	"under_ruzhang_time": "",
	"sent_no": "",
	"emp_name": "老板",
	"order_business_status": "DD_DQR",
	"create_time": "2018-11-06 10:29",
	"creator_name": "老板",
	"change_back_reason_name": "王伟",
	"cm_linkman_name": "",
	"creator_code": "cclb",
	"confirm_time": "",
	"upper_shouhuo_emp_id": "",
	"modify_code": "",
	"confirm_emp_source_code": "",
	"consignment_date": "2018-11-07 00:00",
	"supply_tenant_id": -1,
	"cm_id": 7532586660376575775,
	"supply_name": "A青岛慧鑫酒水批发部",
	"receive_name": "苏善著",
	"creator_source_code": "cclb",
	"date": "2018-11-06",
	"cm_linkman_id": "",
	"cm_code": "CUS000006",
	"id": "6397039557757017362",
	"sent_id": -1,
	"product_count": 1,
	"under_ruzhang_emp_name": "",
	"receive_tel": "",
	"receive_addr": "江苏南京市浦口区kangyuan",
	"emp_code": "cclb",
	"change_order_id": 9210493545854071060,
	"supply_code": "0008113689",
	"emp_id": 7087551921713004433,
	"confirm_reason": "",
	"upper_shouhuo_emp_name": "",
	"emp_source_code": "cclb",
	"under_out_emp_name": "",
	"modify_name": "",
	"under_ruzhang_emp_id": "",
	"upper_shouhuo_time": "",
	"under_out_emp_id": "",
	"order_type": "FXHRHH",
    "return_order_type": ""
}]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	否	响应说明
response_data	VARCHAR(32)	否	响应数据体[{......}]
id	VARCHAR(32)	是	单据ID
status	VARCHAR(1)	否	0：已删除，1：正常
creator_id	VARCHAR(32)	否	创建人id
creator_code	VARCHAR(100)	否	创建人编码
creator_name	VARCHAR(100)	否	创建人名称
creator_source_code	VARCHAR(32)	否	创建人对应外部数据id
create_time	TIMESTAMP	否	创建日期，yyyy-mm-dd hh24:mi格式
modifyier_id	VARCHAR(32)	否	修改人id
modify_code	VARCHAR(100)	否	修改人编码
modify_name	VARCHAR(100)	否	修改人名称
modify_source_code	VARCHAR(32)	否	修改人对应外部数据id
modify_time	TIMESTAMP	否	修改日期，yyyy-mm-dd hh24:mi格式
order_no	VARCHAR(100)	否	退货单编号
date	TIMESTAMP	否	单据业务日期，yyyy-mm-dd格式
emp_id	VARCHAR(32)	否	业务员id
emp_code	VARCHAR(100)	否	业务员编码
emp_name	VARCHAR(100)	否	业务员名称
emp_source_code	VARCHAR(32)	否	业务员对应外部数据id
cm_id	VARCHAR(32)	否	客户id
cm_code	VARCHAR(32)	否	客户编码
cm_name	VARCHAR(100)	否	客户名称
cm_source_code	VARCHAR(32)	否	客户对应外部数据id
cm_linkman_id	VARCHAR(32)	否	门店联系人ID
cm_linkman_name	VARCHAR(100)	否	门店联系人ID名称
sent_id	VARCHAR(32)	否	关联发货单id
sent_no	VARCHAR(100)	否	关联发货单编码
order_status	VARCHAR(32)	否	订单状态，DD_DSH：待收货，DD_YWC：已完成，DD_DQR：待确认，DD_YQX：已取消，DD_YQR：已确认
change_back_reason_id	VARCHAR(32)	否	退换货原因id
change_back_reason_name	VARCHAR(100)	否	退换货原因名称
supply_id	VARCHAR(32)	否	供货商id，默认值是-1,-1就是厂家
supply_code	VARCHAR(200)	否	供货商编码
supply_name	VARCHAR(200)	否	供货商名称
order_type	VARCHAR(32)	否	订单类型，FXGLTH:分销关联退货，FXSPTH:分销商品退货，FXHRHH:分销换入换货
order_source	varchar(100)	否	NBZHSJ:内部账号手机(业代手机)，NBZHWB:内部账号web（业代web），WBZHSJ:外部账号手机（客户手机），WBZHWB:外部账号web（客户web），MDWXXD:客户微信下单，JK:接口,DINGHUO365:(客户手机端)，GJBF：高级拜访(业代高级拜访)；
receive_name	VARCHAR(100)	否	收货人名称
receive_phone	VARCHAR(100)	否	收货人手机号码
receive_tel	VARCHAR(100)	否	收货人电话
receive_addr	VARCHAR(1000)	否	收货地址
remark	VARCHAR(4000)	否	备注
confirm_emp_id	VARCHAR(32)	否	确认人id
confirm_emp_code	VARCHAR(100)	否	确认人编码
confirm_emp_name	VARCHAR(100)	否	确认人名称
confirm_emp_source_code	VARCHAR(32)	否	确认人对应外部数据id
confirm_time	TIMESTAMP	否	确认时间，yyyy-mm-dd hh24:mi格式
confirm_reason	VARCHAR(4000)	否	审批意见
order_business_status	VRACHAR(100)	否	订单业务状态
under_out_time	TIMESTAMP	否	下游出库时间，yyyy-mm-dd hh24:mi格式
under_out_emp_id	VRACHAR(32)	否	下游出库操作人id
under_out_emp_name	VARCHAR(100)	否	下游出库操作人名称
under_out_time	TIMESTAMP	否	上游收货时间，yyyy-mm-dd hh24:mi格式
upper_shouhuo_emp_id	VARCHAR(32)	否	上游收货操作人id
upper_shouhuo_emp_name	VARCHAR(100)	否	上游收货操作人名称
under_out_time	TIMESTAMP	否	下游入账时间，yyyy-mm-dd hh24:mi格式
under_ruzhang_emp_id	VARCHAR(32)	否	下游入账操作人id
under_ruzhang_emp_name	VARCHAR(100)	否	下游入账操作人名称
supply_tenant_id	VARCHAR(32)	否	supply_tenant_id
cm_tenant_id	VARCHAR(32)	否	客户互联企业id
consignment_date	TIMESTAMP	否	交货日期，yyyy-mm-dd hh24:mi格式
product_count	NUMERIC(15)	否	品种数
change_order_id	VARCHAR(32)	否	换货单id
return_order_type	VARCHAR(32)	否	退货行类型，1：标准；2：签收
prods[].detail_id	VARCHAR(32)	是	退货子表id
prods[].product_id	VARCHAR(32)	否	商品id
prods[].product_name	VARCHAR(100)	否	商品名称
prods[].product_code	VARCHAR(100)	否	商品编码
prods[].sent_detail_id	VARCHAR(32)	否	关联发货单详情id
prods[].shenqing_price	NUMERIC(28,8)	否	申请价格
prods[].shenqing_count	numeric(28,8)	否	申请数量
prods[].shenqing_input_unit	VARCHAR(32)	否	申请单位id
prods[].shenqing_input_unit_name	VARCHAR(100)	否	申请单位名称
prods[].base_unit	VARCHAR(32)	否	商品的基本单位id
prods[].base_unit_name	VARCHAR(100)	否	商品的基本单位名称
prods[].shenqing_base_unit_count	NUMERIC(28,8)	否	申请数量转化成基本单位的数量
prods[].shenqing_amount	NUMERIC(20,2)	否	申请金额
prods[].confirm_count	NUMERIC(28,8)	否	确认数量
prods[].confirm_input_unit	VARCHAR(32)	否	确认单位id
prods[].confirm_input_unit_name	VARCHAR(100)	否	确认单位名称
prods[].confirm_amount	NUMERIC(20,2)	否	确认金额
prods[].confirm_base_unit_count	NUMERIC(28,8)	否	确认基本单位数量
prods[].outstock_count	NUMERIC(28,8)	否	出库数量
prods[].outstock_input_unit	VARCHAR(32)	否	出库单位id
prods[].outstock_input_unit_name	VARCHAR(100)	否	出库单位名称
prods[].outstock_base_unit_count	NUMERIC(28,8)	否	出库基本单位数量
prods[].shouhuo_count	NUMERIC(28,8)	否	收货数量
prods[].shouhuo_input_unit	VARCHAR(32)	否	收货单位id
prods[].shouhuo_input_unit_name	VARCHAR(100)	否	收货单位名称
prods[].shouhuo_base_unit_count	NUMERIC(28,8)	否	收货基本单位数量
prods[].shouhuo_amount	NUMERIC(20,2)	否	收货金额
prods[].ruzhang_count	NUMERIC(28,8)	否	入账数量
prods[].ruzhang_input_unit	VARCHAR(32)	否	入账单位id
prods[].ruzhang_input_unit_name	VARCHAR(100)	否	入账单位名称
prods[].ruzhang_base_unit_count	NUMERIC(28,8)	否	入账基本单位数量
prods[].remark	VARCHAR(4000)	否	备注
prods[].posnr	NUMERIC(20)	否	10,20,查询排序时候也可使用
prods[].product_type	VARCHAR(32)	否	销售类型，赠(Z)、兑(D)、返(F)
prods[].is_gift	VARCHAR(2)	否	是否是赠品Y:是 N：否
prods[].promotion_id	VARCHAR(32)	否	促销组ID，是促销组中的商品才会有促销组id(是-1就不是促销组中的商品信息)默认-1
prods[].promotion_name	VARCHAR(100)	否	促销组名称
prods[].superposition_promotion_id	VARCHAR(32)	否	叠加促销ID
prods[].superposition_promotion_name	VARCHAR(100)	否	叠加促销名称
prods[].return_order_detail_type	VARCHAR(32)	否	退货行类型，0：标准:1：破损:2：丢失
exts[].ext_key	varchar(4000)	否	退货单主信息扩展字段key值扩展字段需先在我方系统中创建。
exts[].ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接。

# 查询兑换券明细

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/coupondetail/v1/queryCouponDetail/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体：


{
    "page_number": 1,
    "page_length": 1000,
    "create_start": "2016-12-09",
    "create_end": "2016-12-09",
    "status": "1"
}

请求信息

参数	类型	必填	说明
page_number	INT	否	当前页数,不传默认为1
page_length	INT	否	每页条数,不传默认为1000
create_start	TIMESTAMP	否	创建时间之后，格式：“yyyy-MM-dd”
create_end	TIMESTAMP	否	创建时间之前，格式：“yyyy-MM-dd”
modify_start	TIMESTAMP	否	修改时间之后，格式：“yyyy-MM-dd”
modify_end	TIMESTAMP	否	修改时间之前，格式：“yyyy-MM-dd”
status	VARCHAR(1)	否	0：已删除，1：正常

返回结果：

{
    "return_code": '0', 
    "response_data": [
        {
            "id": "6692513571119135748",
            "status": "1" 
            "coupon_no": "00015684", 
            "create_time": "2019-12-05 13:25",
            "modify_time": "2019-12-05 14:25:35.143",
            "effect_date": "2019-11-05~2019-12-25",
            "format_status": "执行中",
            "doorsill_value": "20.00%",
            "recycle_sign_time": "10天",
            "deal_name": "测试协议名称",
            "deal_id": "6692513571119135748",
            "cm_id": "5012103144063463929", 
            "cm_name": "南京雨花二级经销商", 
            "cm_code": "0008106267", 
            "prod_id": "6692513571119135747", 
            "prod_code": "1HBSKLSD", 
            "prod_name": "测试商品1"
            "num": "10箱",
            "price": "25.00",
            "is_used": "已使用",
            "used_time": "2019-12-15 13:25",
            "order_no": "CK0076",
            "order_id": "6692513571119135747",
            "supply_code": "00123", 
            "supply_name": "1ed", 
            "is_back": "已回收", 
            "sign_num": "1箱",
            "sign_time": "2019-12-17 13:25" 
        },
        .......
    ]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	否	响应说明
response_data	VARCHAR(32)	否	响应数据
id	VARCHAR(32)	否	兑换券明细id
status	VARCHAR(1)	否	0：已删除，1：正常
coupon_no	VARCHAR(32)	否	兑换券编码
create_time	VARCHAR(32)	否	兑换券生成时间，格式“yyyy-MM-dd HH:mm”
modify_time	VARCHAR(32)	否	兑换券更新时间，格式“yyyy-MM-dd HH:mm:ss.us”
effect_date	VARCHAR(32)	否	兑换券有效期，格式“yyyy-mm-dd ~ yyyy-mm-dd”
format_status	VARCHAR(32)	否	兑换券状态，参考值：“待审批”、“被打回”、“未开始”、“执行中”、“已结束”
doorsill_value	VARCHAR(32)	否	兑换券使用门槛，“不限制”或具体百分比数据
recycle_sign_time	VARCHAR(32)	否	兑换券通路回收时间，“不限制”或具体天数
deal_name	VARCHAR(32)	否	兑换券协议名称
deal_id	VARCHAR(32)	否	兑换券协议id
cm_code	VARCHAR(100)	否	兑换券客户编码
cm_name	VARCHAR(100)	否	兑换券客户名称
cm_id	VARCHAR(32)	否	兑换券客户ID
prod_id	VARCHAR(32)	否	商品ID
prod_code	VARCHAR(100)	否	商品编码
prod_name	VARCHAR(100)	否	商品名称
num	VARCHAR(32)	否	商品数量
price	VARCHAR(32)	否	商品单价
is_used	VARCHAR(32)	否	兑换券使用状态，参考值：“未使用”、“已使用”、“已回收”
used_time	VARCHAR(32)	否	兑换券使用时间，格式“yyyy-MM-dd HH:mm”
order_no	VARCHAR(32)	否	订单编码
order_id	VARCHAR(32)	否	订单id
supply_code	VARCHAR(32)	否	供应商编码
supply_name	VARCHAR(32)	否	供应商名称
is_back	VARCHAR(32)	否	兑换券回收状态，参考值：“已回收”、“未回收”
sign_num	VARCHAR(32)	否	回收数量
sign_time	VARCHAR(32)	否	回收时间

# 新增兑换券

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/coupondetail/v1/addCoupon/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体：

{
    "coupon_no": "DH20200507000001",
    "deal_name": "2020-05-07-001",
    "cm_id": "6389893435290873348",
    "cm_code": "CM0001",
    "start_date": "2020-01-01",
    "end_date": "2020-12-01",
    "promotion_name": "",
    "recycle_date": "2020-12-01",
    "doorsill_percent": "80",
    "prods": [
        {
            "product_id": "7755038711664976249",
            "product_code": "PD001",
            "unit_name": "箱",
            "num": "10.00000000"
        }
    ]
}

请求信息

参数	类型	必填	说明
coupon_no	VARCHAR(100)	否	兑换券编码:如果传兑换券编码，则按传入的编码；如果不传，则按照365的兑换券生成规则自动生成
deal_name	VARCHAR(100)	是	兑换券协议名称
cm_id	VARCHAR(32)	是	兑换券客户id，客户id和客户编码必须传一个
cm_code	VARCHAR(100)	是	兑换券客户编码，客户id和客户编码必须传一个
start_date	VARCHAR(32)	是	兑换券有效期开始时间yyyy-mm-dd
end_date	VARCHAR(32)	是	兑换券有效期结束时间yyyy-mm-dd
promotion_name	VARCHAR(100)	否	关联促销方案
recycle_date	VARCHAR(32)	否	通路回收时间（兑换后天数）
doorsill_percent	VARCHAR(32)	否	兑换券使用门槛:百分比值，如80%，则传80；如果为空，则为不限制
prods[].product_id	VARCHAR(32)	是	商品id，商品id和商品编码必须传一个
prods[].product_code	VARCHAR(100)	是	商品编码，商品id和商品编码必须传一个
prods[].unit_name	VARCHAR(32)	是	商品单位
prods[].num	NUMERIC(18,8)	是	兑换数量

返回结果：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": "", 
    "response_data":[{
      "id": "8183666817447601554",
      "code": "DH20200507000001"
    }]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	否	响应说明
response_data	VARCHAR(32)	否	响应数据[{......}]
id	VARCHAR(32)	是	兑换券id
code	VARCHAR(100)	否	兑换券编码

# 审批兑换券

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/coupondetail/v1/approvalCoupon/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体：

{
    "coupon_no": "DH20200507000001",
    "coupon_status": "1",
    "confirm_emp": "张三"
}

请求信息

参数	类型	必填	说明
coupon_no	VARCHAR(100)	是	兑换券编码
coupon_status	VARCHAR(32)	是	审批意见:1是通过，2是打回
confirm_emp	VARCHAR(100)	是	审批人

返回结果：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	否	响应说明

# 直营订单业务状态同步接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmspurchase/v1/convertOrderStatus/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体：

				{
				    "order_id": "123456",
				    "order_no": "DDXXXXXXXXX",
				    "order_create_date": "2016-12-09",
				    "purchase_business_status": "XS_YWC"
				}

请求信息

参数	类型	必填	说明
order_id	INT	否	单据id（单据id或单据编号必传一个）
order_no	VARCHAR(32)	否	单据编号（单据id或单据编号必传一个）
order_create_date	VARCHAR(32)	否	单据创建日期，格式：“yyyy-MM-dd”
purchase_business_status	VARCHAR(32)	是	单据业务状态码

返回结果：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	否	响应说明

# 新增客户配额

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsquota/v1/addCmQuota/{openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体：


{
    "name": "指定范围全部配额",
    "start_date": "2020-06-28",
    "end_date": "2020-06-28",
    "trade_type": "1",
    "cus_range_type": "2",
    "dept_id": "7233365496260253510,8233198284131411873",
    "customer_level_id": "8715900737400193117,7287736961434231483",
    "district_id": "2,3,4",
    "products": [
          {
            "id": "9043401268045478811",
            "unit_name": "箱",
            "unit_id": "6362931419429812568",
            "num": "200"
        }
    ]
}

请求信息

参数	类型	必填	说明
name	VARCHAR(100)	是	配额名称
start_date	VARCHAR(32)	是	开始日期格式必须是yyyy-MM-dd
end_date	VARCHAR(32)	是	结束日期格式必须是yyyy-MM-dd
trade_type	VARCHAR(32)	是	客户对象 1全部 2 经销商 3 终端门店当cus_range_type传 2 必填
cus_range_type	VARCHAR (32)	是	客户范围 2 按客户属性设置范围 1 指定具体客户
dept_id	VARCHAR(32)	否	客户属性部门id 多个逗号分隔
dept_name	VARCHAR(100)	否	客户属性部门名称多个逗号分隔
dept_code	VARCHAR(100)	否	客户属性部门编码多个逗号分隔
dept_source_code	VARCHAR(100)	否	客户属性部门第三方系统的唯一标识多个逗号分隔
customer_level_id	VARCHAR(32)	否	客户属性客户级别id 多个逗号分隔
customer_level_source_code	VARCHAR(100)	否	客户属性客户级别第三方系统的唯一标识多个逗号分隔
customer_level_name	VARCHAR(100)	否	客户属性客户级别名称多个逗号分隔
type_id	VARCHAR(32)	否	客户属性类型id 多个逗号分隔
type_code	VARCHAR(100)	否	客户属性类型编码多个逗号分隔
type_name	VARCHAR(100)	否	客户属性类型名称多个逗号分隔
type_source_code	VARCHAR(100)	否	客户属性类型第三方系统的唯一标识多个逗号分隔
district_id	VARCHAR(32)	否	客户属性销售区域id 多个逗号分隔
district_code	VARCHAR(100)	否	客户属性销售区域编码多个逗号分隔
district_name	VARCHAR(100)	否	客户属性销售区域名称多个逗号分隔
district_source_code	VARCHAR(100)	否	客户属性销售区域第三方系统的唯一标识多个逗号分隔
cm_id	VARCHAR(32)	否	指定客户经销商id cus_range_type 为1 cm_id cm_code cm_name cm_source_code必传一个
cm_code	VARCHAR(32)	否	指定客户经销商编码 cus_range_type 为1 cm_id cm_code cm_name cm_source_code必传一个
cm_name	VARCHAR(32)	否	指定客户经销商名称 cus_range_type 为1 cm_id cm_code cm_name cm_source_code必传一个
cm_source_code	VARCHAR(32)	否	指定客户经销商第三方系统的唯一标识 cus_range_type 为1 cm_id cm_code cm_name cm_source_code必传一个
products[].id	VARCHAR(32)	否	商品id id code source_code 传一个
products[].code	VARCHAR(100)	否	商品编码 id code source_code传一个
products[].source_code	VARCHAR (100)	否	商品第三方系统的唯一标识 id code source_code 传一个
products[].unit_name	VARCHAR (32)	否	商品单位名称 unit_name unit_id传一个
products[].unit_id	VARCHAR(32)	否	商品单位id unit_name unit_id传一个
products[].num	VARCHAR(32)	是	数量

返回结果：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": "",
    "return_data": "{id:5932650281301050831}"
}

响应信息

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码，0-成功, 1-失败, 其他参照附件错误码
return_msg	String	响应说明
return_data	String	json格式的字符串
id	String	配额id

# 修改客户配额

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsquota/v1/modifyCmQuota/{openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体：


{
    "quota_id": "5932650281301050831",
    "products": [
          {
            "id": "9043401268045478811",
            "num": "200"
        }
    ]
}

请求信息

参数	类型	必填	说明
quota_id	VARCHAR(32)	是	配额id
products[].id	VARCHAR(32)	否	商品id id code source_code 传一个
products[].code	VARCHAR(100)	否	商品编码 id code source_code传一个
products[].source_code	VARCHAR (100)	否	商品第三方系统的唯一标识 id code source_code 传一个
products[].num	VARCHAR(32)	是	数量

返回结果：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

响应信息

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码，0-成功, 1-失败, 其他参照附件错误码
return_msg	String	响应说明

# 查询共享配额

**请求方式：**POST(HTTPS)
请求地址:https://openapi.waiqin365.com/api/dmscmquota/v1/queryCmQuota/{ openid }/{ timestamp }/{ digest }/{ msg_id }

请求包体:

{
  "id": "6225324992642325132",
  "name":"测试配额",
  "start_date": "2020-09-21",
  "end_date": "2020-10-21",
  "page_length": 1000,
  "page_number": 1
}

请求信息:

参数	类型	必填	说明
id	VARCHAR(32)	否	客户配额id
name	VARCHAR(32)	否	配额名称，模糊匹配
start_date	VARCHAR(32)	否	开始日期，格式yyyy-MM-dd
end_date	VARCHAR(32)	否	结束日期，格式yyyy-MM-dd
page_length	int	否	分页每页记录条数，默认1000
page_number	int	否	分页第几页，默认第1页

返回结果:

{
	"return_code": "0",
	"return_msg": null,
	"msg_id": "X0000000001",
	"response_data": [{
		"end_date": "2020-10-21 23:59:59",
        "name": "测试配额",
		"cus_range_type": "2",
		"customer_level": "8715900737400193117,7287736961434231483,8783574560179216331",
		"trade_type": "1",
		"id": "6225324992642325132",
		"district_id": "5880045821365020046,5151941004870826006",
		"dept_id": "8951924987151419703",
		"start_date": "2020-09-21 00:00:00",
        "type_id":"",
		"prods": [{
			"unit_name": "箱",
			"leave_num": "1.0",
			"use_num": "0.0",
			"pd_id": "6965466323694544792",
			"base_unit_num": "1.0",
			"ratio": 1.00000000
		}, {
			"unit_name": "瓶",
			"leave_num": "1.0",
			"use_num": "0.0",
			"pd_id": "5073938100193484331",
			"base_unit_num": "1.0",
			"ratio": 1.00000000
		}]
		
	}]
}

响应信息:

参数	类型	说明
msg_id	VARCHAR(32)	消息ID
return_code	VARCHAR(32)	响应编码：0成功 1失败
return_msg	VARCHAR(100)	响应说明
response_data	VARCHAR(32)	响应数据体[{......},{......}]
end_date	TIMESTAMP	结束日期
name	VARCHAR(32)	配额名称
cus_range_type	VARCHAR(1)	客户范围 2 按客户属性设置范围 1 指定具体客户
trade_type	VARCHAR(1)	客户对象 1全部 2 经销商 3 终端门店
id	VARCHAR(32)	配额id
district_id	VARCHAR(32)	客户属性销售区域id 多个逗号分隔
dept_id	VARCHAR(32)	客户属性部门id 多个逗号分隔
type_id	VARCHAR(32)	客户属性类型id 多个逗号分隔
customer_level	VARCHAR(32)	客户属性客户级别id 多个逗号分隔
prods[].unit_name	VARCHAR(32)	录入单位名称
prods[].leave_num	VARCHAR(32)	基本单位可用配额
prods[].use_num	VARCHAR(32)	基本单位已用配额
prods[].pd_id	VARCHAR(32)	商品id
prods[].base_unit_num	VARCHAR(32)	基本单位配额总量
prods[].ratio	VARCHAR(32)	单位换算率

# 经销商车辆查询接口

请求方式：POST（HTTPS）
请求地址：

https://openapi.waiqin365.com/api/dmsstore/v1/dealer/car/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体：

{
    "page_number": 1,
    "start_create_date": "2017-05-01",
    "end_create_date": "2017-05-31"
}

请求信息

参数	类型	必填	说明
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”
page_number	int	是	页码默认1，每页默认1000条
page_length	int	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整

返回结果：

{
	"msg_id": "X000001",
	"return_code": "0",
	"return_msg": "",
	"response_data": [
		{
			"car_id": "5629025084242505422",
			"car_code": "CK0830",
			"car_no": "CK0830",
			"supplier_id": "6803193180468604054",
			"supplier_code": "CM20190428051",
			"supplier_name": "苏果夫子庙店20190428051",
			"emp_id": "4952428432913340544",
			"emp_code": "xubing",
			"emp_name": "徐兵老板测试账号",
			"status": "1",
             "is_enable" "QY",
			"create_time": "2019-10-15",
			"modify_time": "2020-01-17"
		}
	]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	是	响应说明
response_data	VARCHAR(32)	是	响应数据体[{......}]
car_id	VARCHAR(32)	否	车辆ID
car_code	VARCHAR(32)	否	编码
car_no	VARCHAR(32)	否	车号
supplier_id	VARCHAR(32)	否	经销商ID
supplier_code	VARCHAR(32)	否	经销商编码
supplier_name	VARCHAR(100)	否	经销商名称
emp_id	VARCHAR(32)	否	业务员ID
emp_code	VARCHAR(32)	否	业务员代码
emp_name	VARCHAR(100)	否	业务员名称
status	VARCHAR(1)	否	状态：0、删除，1、未删除
is_enable	VARCHAR(10)	否	停用启用状态：QY:启用，TY:停用
create_time	TIMESTAMP	否	创建时间
modify_time	TIMESTAMP	否	修改时间

# 分销车销 - 调拨单查询接口

请求方式：POST（HTTPS）
请求地址：

https://openapi.waiqin365.com/api/dmsstore/v1/requisition/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体：

{
	"page_number": 1,
	"start_create_date": "2017-05-01",
	"end_create_date": "2017-05-31"
}

请求信息

参数	类型	必填	说明
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”
page_number	int	是	页码默认1，每页默认1000条
page_length	int	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整

返回结果：

{
	"msg_id": "X000001",
	"return_code": "0",
	"return_msg": "",
	"response_data": [
		{
			"bill_date": "2019-09-04 16:58:08",
             "requisition_id": "",
             "requisition_code": "",
			"creator_id": "4952428432913340544",
			"creator_code": "xubing",
			"creator_name": "徐兵老板测试账号",
			"emp_id": "4952428432913340544",
			"emp_code": "xubing",
			"emp_name": "徐兵老板测试账号",
			"from_storehouse_id": "3333",
			"from_storehouse_code": "CK0124",
			"from_storehouse_name": "经销商仓库",
			"to_storehouse_id": "4444",
			"to_storehouse_code": "CK0124",
			"to_storehouse_name": "车辆",
			"supplier_id": "8590605014384524975",
			"supplier_code": "CS000835",
			"supplier_name": "灭霸势力团伙",
			"from_storehouse_type": "CL",
			"to_storehouse_type": "CL",
			"remark": "备注",
			"approval_status": "待审批",
			"approval_time": "2019-09-11 13:35:11",
			"status": "1",
			"create_time": "2019-09-04 16:57:57",
			"modify_time": "2019-09-11 13:38:04",
			"prods": [
				{
					"prod_id": "5037862861364899019",
					"prod_code": "1010",
					"prod_name": "果粒橙",
					"out_cargo_space": "正常品库",
					"in_cargo_space": "正常品库",
					"basic_unit_cnt": "1",
					"requisition_unit_cnt": "1",
					"requisition_unit_id": "10",
					"requisition_unit_name": "1",
					"remark": ""
				}
			]
		}
	]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	是	响应说明
response_data	VARCHAR(32)	是	响应数据体[{......}]
bill_date	TIMESTAMP	否	单据日期，yyyy-mm-dd格式
requisition_id	VARCHAR(32)	否	调拨单主表id
requisition_code	VARCHAR(32)	否	调拨单号
creator_id	VARCHAR(32)	否	创建人Id
creator_code	VARCHAR(32)	否	创建人编码
creator_name	VARCHAR(100)	否	创建人名称
emp_id	VARCHAR(32)	否	经办人Id
emp_code	VARCHAR(32)	否	经办人编码
emp_name	VARCHAR(100)	否	经办人名称
from_storehouse_id	VARCHAR(32)	否	调出仓库/车库id
from_storehouse_code	VARCHAR(32)	否	调出仓库/车库编码
from_storehouse_name	VARCHAR(100)	否	调出仓库名称/车号
to_storehouse_id	VARCHAR(32)	否	调入仓库/车库id
to_storehouse_code	VARCHAR(32)	否	调入仓库/车库编码
to_storehouse_name	VARCHAR(100)	否	调入仓库/车号
supplier_id	VARCHAR(32)	否	经销商ID
supplier_code	VARCHAR(32)	否	经销商代码
supplier_name	VARCHAR(100)	否	经销商名称
from_storehouse_type	VARCHAR(32)	否	调出仓库类型：CL:车，JXSCK:经销商仓库
to_storehouse_type	VARCHAR(32)	否	调入仓库类型：CL:车，JXSCK:经销商仓库
remark	VARCHAR(300)	否	备注
approval_status	VARCHAR(1)	否	审批状态：0：待确认，1：已确认，2：作废
approval_time	TIMESTAMP	否	审批时间
status	VARCHAR(1)	否	删除状态：0、删除，1、未删除
create_time	TIMESTAMP	否	创建时间
modify_time	TIMESTAMP	否	修改时间
prods[].prod_id	VARCHAR(32)	否	商品id
prods[].prod_code	VARCHAR(32)	否	商品编码
prods[].prod_name	VARCHAR(100)	否	商品名称
prods[].out_cargo_space	VARCHAR(1)	否	调出货位1、正常品库， 2、报废品库，3、处理品库（不传认为是正常品库）
prods[].in_cargo_space	VARCHAR(1)	否	调入货位1、正常品库， 2、报废品库，3、处理品库（不传认为是正常品库）
prods[].basic_unit_cnt	numeric(28,8)	否	基本单位数量
prods[].requisition_unit_cnt	numeric(28,8)	否	调拨单位数量
prods[].requisition_unit_id	VARCHAR(32)	否	调拨单位id
prods[].requisition_unit_name	VARCHAR(100)	否	调拨单位名称
prods[].remark	VARCHAR(200)	否	行备注

# 分销车销 - 车销单查询接口

请求方式：POST（HTTPS）
请求地址：

https://openapi.waiqin365.com/api/dmsstore/v1/carsales/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体：

{
    "page_number": 1,
    "start_create_date": "2017-05-01",
    "end_create_date": "2017-05-31"
}

请求信息

参数	类型	必填	说明
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”
page_number	int	是	页码默认1，每页默认1000条
page_length	int	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整

返回结果：

{
	"msg_id": "X000001",
	"return_code": "0",
	"return_msg": "",
	"response_data": [
		{
			"car_sale_id": "8195117324252240294",
			"hc_status": "0",
			"supplier_id": "6479661642303758510",
			"supplier_code": "",
			"supplier_name": "",
			"car_id": "7231446725934251640",
			"car_no": "CK0001",
			"car_name": "张昊忱经销商",
			"car_sale_no": "CXD201909200014",
			"submit_time": "2019-09-20 15:27:16",
			"create_time": "2019-09-20 15:27:16",
			"emp_id": "6001765659012760985",
			"emp_code": "zuoxiao",
			"emp_name": "左潇",
			"emp_sourcecode": "",
			"cm_id": "7966827811826367011",
			"cm_code": "DD000201900573",
			"cm_name": "审批0902",
			"cm_sourcecode": "",
			"sale_amount": "45000.00",
			"discount_amount": "100.00",
			"total_amount": "50000.00",
			"return_amount": "200.00",
			"deal_amount": "45000.00",
			"remark": "bz",
             "status": "1",
			"prods": [
				{
					"car_sale_type": "销售",
					"sale_type_id": "123",
					"sale_type_name": "",
					"prod_id": "7849829512066200770",
					"prod_name": "6644",
					"prod_code": "6644",
					"prod_sourcecode": "",
					"input_cnt": "1",
					"input_unit_id": "7213508454850586085",
					"input_unit_name": "袋",
					"prod_basic_unit_id": "7213508454850586085",
					"prod_basic_unit_name": "袋",
					"prod_basic_unit_cnt": "1",
					"amount": "44.00",
					"input_unit_price": "100.00",
					"line_discount_amount": "44.00",
					"remark": "bz",
					"is_gift": "0",
				}
			]
		}
	]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	是	响应说明
response_data	VARCHAR(32)	是	响应数据体[{......}]
car_sale_id	VARCHAR(32)	否	车销单ID
hc_status	VARCHAR(1)	否	红冲状态 0：正常，1：被红冲，2：红冲
supplier_id	VARCHAR(32)	否	经销商ID
supplier_code	VARCHAR(32)	否	经销商代码
supplier_name	VARCHAR(100)	否	经销商名称
car_id	VARCHAR(32)	否	车辆id
car_no	VARCHAR(32)	否	车辆编号
car_name	VARCHAR(100)	否	车辆名称
car_sale_no	VARCHAR(32)	否	车销单编号
submit_time	TIMESTAMP	否	提交日期，yyyy-mm-dd hh24:mi:ss格式
create_time	TIMESTAMP	否	创建日期，yyyy-mm-dd hh24:mi:ss格式
emp_id	VARCHAR(32)	否	业务员id
emp_code	VARCHAR(32)	否	业务员编码
emp_name	VARCHAR(50)	否	业务员名称
emp_sourcecode	VARCHAR(32)	否	业务员sourcecode
cm_id	VARCHAR(32)	否	客户id
cm_code	VARCHAR(32)	否	客户编码
cm_name	VARCHAR(100)	否	客户名称
cm_sourcecode	VARCHAR(32)	否	客户sourcecode
sale_amount	numeric(20,2)	否	优惠前销售金额合计
discount_amount	numeric(20,2)	否	销售优惠金额
total_amount	numeric(20,2)	否	优惠后销售金额合计
return_amount	numeric(20,2)	否	退货金额合计
deal_amount	numeric(20,2)	否	成交金额
remark	VARCHAR(100)	否	备注
status	VARCHAR(1)	否	删除状态：0、删除，1、未删除
prods[].car_sale_type	VARCHAR(1)	否	车销类型：1、销售，2、退货
prods[].sale_type_id	VARCHAR(32)	否	销售类型id
prods[].sale_type_name	VARCHAR(100)	否	销售类型名称
prods[].prod_id	VARCHAR(32)	否	商品id
prods[].prod_name	VARCHAR(50)	否	商品名称
prods[].prod_code	VARCHAR(32)	否	商品编码
prods[].prod_sourcecode	VARCHAR(32)	否	商品对应sourcecode
prods[].input_cnt	numeric(28,8)	否	录入数量
prods[].input_unit_id	VARCHAR(32)	否	录入单位id
prods[].input_unit_name	VARCHAR(50)	否	录入单位名称
prods[].prod_basic_unit_id	VARCHAR(32)	否	商品基本单位id
prods[].prod_basic_unit_name	VARCHAR(50)	否	商品基本单位名称
prods[].prod_basic_unit_cnt	numeric(28,8)	否	基本单位数量
prods[].amount	numeric(20,2)	否	金额
prods[].input_unit_price	numeric(28,8)	否	录入单位单价
prods[].line_discount_amount	numeric(20,2)	否	行优惠金额
prods[].remark	VARCHAR(100)	否	子表行备注
prods[].is_gift	VARCHAR(1)	否	是否赠品1:是 0：否

# 经销商车辆库存查询接口

请求方式：POST（HTTPS）
请求地址：

https://openapi.waiqin365.com/api/dmsstore/v1/carstock/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体：

{
    "page_number": 1,
    "start_create_date": "2017-05-01",
    "end_create_date": "2017-05-31"
}

请求信息

参数	类型	必填	说明
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”
page_number	int	是	页码默认1，每页默认1000条
page_length	int	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整

返回结果：

{
	"msg_id": "X000001",
	"return_code": "0",
	"return_msg": "",
	"response_data": [
		{
			"car_id": "5629025084242505422",
             "car_no": "",
             "car_name": "",
			"supplier_id": "6803193180468604054",
			"supplier_code": "CS000835",
			"supplier_name": "灭霸势力团伙",
			"prod_id": "7849829512066200770",
             "prod_code": "",
             "prod_name": "",
             "prod_sourcecode": "",
			"basic_unit_id": "7213508454850586085",
             "basic_unit_name": "",
			"basic_unit_stock_cnt": "3",
			"status": "1",
			"create_time": "2019-10-15",
			"modify_time": "2020-01-17"
		}
	]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	是	响应说明
response_data	VARCHAR(32)	是	响应数据体[{......}]
car_id	VARCHAR(32)	否	车辆ID
car_no	VARCHAR(32)	否	车辆编码
car_name	VARCHAR(100)	否	车辆名称
supplier_id	VARCHAR(32)	否	经销商ID
supplier_code	VARCHAR(32)	否	经销商代码
supplier_name	VARCHAR(100)	否	经销商名称
prod_id	VARCHAR(32)	否	商品ID
prod_code	VARCHAR(32)	否	商品编码
prod_name	VARCHAR(100)	否	商品名称
prod_sourcecode	VARCHAR(32)	否	商品第三方id
basic_unit_id	VARCHAR(32)	否	基本单位ID
basic_unit_name	VARCHAR(100)	否	基本单位名称
basic_unit_stock_cnt	numeric(28,8)	否	基本单位库存数量
status	VARCHAR(1)	否	状态：0、删除，1、未删除
create_time	TIMESTAMP	否	创建时间
modify_time	TIMESTAMP	否	修改时间

# 分销订单发货单第三方签收数量写入接口

请求方式：POST （HTTPS）
请求地址：https://openapi.waiqin365.com/api/dmssent/v1/thirdSignNum/{openid}/{timestamp}/{digest}/{msgid}

请求包体：

{
    "sent_create_date":"",
    "order_sent_id":"",
    "prods":[
        {
            "order_sent_detail_id":"",
            "third_sign_num":""
        }
    ]
}

请求信息：

参数	类型	必须	说明
sent_create_date	VARCHAR(32)	是	发货单创建日期。格式yyyy-mm-dd
order_sent_id	VARCHAR(32)	是	发货单ID
prods[].order_sent_detail_id	VARCHAR(32)	是	发货单明细ID
prods[].third_sign_num	NUMERIC(20,8)	是	第三方基本单位签收数量

返回结果：

{
    "msg_id":"X000001",
    "return_code":0,
    "return_msg":""
}

响应信息：

参数类型必填说明

msg_id VARCHAR(32) 是消息ID

return_code VARCHAR(32) 是响应编码：0成功 1失败

return_msg VARCHAR(100) 是响应说明

# 直营订单退货订单新增接口

请求方式：POST（HTTPS）
请求地址：

https://openapi.waiqin365.com/api/dmspurchase/v1/returnOrder/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体：

{
    "operate_type": "",
    "order_no": "",
    "type": "",
    "erp_type": "",
    "erp_No": "",
    "sent_id": "",
    "rel_order_id": "",
    "cm_code": "",
    "cm_id": "",
    "date": "",
    "emp_id": "",
    "emp_code": "",
    "consignment_date": "",
    "receive_name": "",
    "receive_phone": "",
    "receive_tel": "",
    "receive_addr": "",
    "remark": "",
    "reason": "",
    "order_amount": "",
    "prods": [
		{
			"id": "",
			"code": ""
			"price": ""
			"num": ""
			"unit": ""
			"unit_name": ""
			"amount": ""
			"is_gift": ""
			"remark": ""
			"erp_detail_id": ""
            "dms_order_detail_id": ""
		}
	],
    "exts": [
        {
    		"ext_key": "自定义字段1",
    		"ext_value": "四星"
    	},
    	{
    		"ext_key": "自定义字段2",
    		"ext_value": "SO123123123"
    	},......
    ]
}

请求信息

参数	类型	必填	说明
operate_type	VARCHAR(32)	是	1：新增直营退货订单，2：编辑直营退货订单
order_no	VARCHAR(100)	是	新增的时候传递作为新订单的单号（不传系统自动生成），编辑的时候传递作为参数进行编辑订单
type	CHAR(1)	否	订单类型：1：退货订单；2：换入订单
erp_type	VARCHAR(10)	否	ERP订单类型，不传默认为“退货订单”
erp_No	VARCHAR(32)	是	ERP退货订单号
sent_id	VARCHAR(32)	否	退货发货单id
rel_order_id	VARCHAR(32)	否	关联订单ID
cm_code	VARCHAR(100)	是	客户编码，客户id和客户编码必须传一个
cm_id	VARCHAR(32)	是	客户id，客户id和客户编码必须传一个
date	VARCHAR(32)	否	业务日期yyyy-MM-dd HH:mm
emp_id	VARCHAR(32)	否	业务员Id，业务员id和业务员编码都不传，默认取其中一个客户经理的
emp_code	VARCHAR(100)	否	业务员编码，业务员id和业务员编码都不传，默认取其中一个客户经理的
consignment_date	VARCHAR(32)	否	要求交货日期yyyy-mm-dd
receive_name	VARCHAR(100)	否	收货人名称
receive_phone	VARCHAR(32)	否	收货人手机
receive_tel	VARCHAR(32)	否	收货人电话
receive_addr	VARCHAR(1000)	否	收货地址
remark	text	否	订单单据头备注
reason	VARCHAR(32)	否	退货原因
order_amount	VARCHAR(32)	否	退货金额，精度最高两位小数
prods[].id	VARCHAR(32)	是	商品id和商品编码必须传一个
prods[].code	VARCHAR(100)	是	商品id和商品编码必须传一个
prods[].price	numeric(18,8)	否	退货价不传就取客户价格，赠品价格为0
prods[].num	numeric(18,8)	是	退货数量
prods[].unit	VARCHAR(32)	否	退货单位id和退货单位名称传一个即可，不传使用基本单位
prods[].unit_name	VARCHAR(32)	否	退货单位id和退货单位名称传一个即可，不传使用基本单位
prods[].amount	numeric(18,2)	否	退货金额
prods[].is_gift	VARCHAR(10)	否	是否是赠品1:是 0：否，不传就是非赠品
prods[].remark	text	否	订单子表的备注
prods[].erp_detail_id	VARCHAR(32)	是	ERP退货明细行ID
prods[].dms_order_detail_id	VARCHAR(32)	是	关联订单详情id
exts[].ext_key	VARCHAR(4000)	否	退货订单主信息扩展字段key值扩展字段需先在我方系统中创建。
exts[].ext_value	VARCHAR(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接。

返回结果：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	是	响应说明

# 直营退货订单新增收货接口

**请求方式：**POST(HTTPS)
请求地址：https://openapi.waiqin365.com/api/dmschangeback/v1/newShouHuo/{ openid }/{ timestamp }/{ digest }/{ msg_id }

请求包体：

{
    "no":"",
    "order_no":"",
    "order_id":"",
    "date":"",
    "erp_stock_no":"",
    "prods":[
        {
            "id":"",
            "order_detail_id":"",
            "erp_stock_detail_id":"",
            "product_id":"",
            "product_code":"",
            "num":"",
            "unit":"",
            "unit_name":"",
            "amount":""
        }
    ]
}

请求信息：

参数	类型	必填	说明
no	VARCHAR(100)	否	有ERP入库单号则传ERP入库单号，不传自动生成
order_no	VARCHAR(100)	是	退货订单号，退货订单号和退货订单ID必须传一个
order_id	VARCHAR(32)	是	退货订单id，退货订单号和退货订单ID必须传一个
date	VARCHAR(32)	否	ERP入库日期yyyy-mm-dd
erp_stock_no	VARCHAR(32)	是	ERP入库单号
prods[].id	VARCHAR(32)	否	入库单明细行ID
prods[].order_detail_id	VARCHAR(32)	是	对应退货订单明细行ID
prods[].erp_stock_detail_id	VARCHAR(32)	是	ERP入库单明细行ID
prods[].product_id	VARCHAR(32)	是	商品id和商品编码必须传一个
prods[].product_code	VARCHAR(100)	是	商品id和商品编码必须传一个
prods[].num	NUMERIC(18,8)	是	入库数量
prods[].unit	VARCHAR(32)	否	入库单位和入库单位名称传一个即可，不传使用基本单位
prods[].unit_name	VARCHAR(32)	否	入库单位和入库单位名称传一个即可，不传使用基本单位
products[].amount	NUMERIC(18,2)	否	入库金额

返回结果：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

响应信息:

参数类型必填说明

msg_id VARCHAR(32) 是消息ID

return_code VARCHAR(32) 是响应编码：0成功 1失败

return_msg VARCHAR(100) 是响应说明

# 查询车辆盘点单

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmscarinventory/v1/queryDmsCarInventory/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体：


{
    "page_number": 1,
    "page_length": 100,
    "start_date": "2016-12-09",
    "end_date": "2016-12-09"
}

请求信息

参数	类型	必填	说明
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”
after_create_date	TIMESTAMP	否	创建时间之后，格式：“yyyy-MM-dd HH:mm:ss”
after_modify_date	TIMESTAMP	否	修改时间之后，格式：“yyyy-MM-dd HH:mm:ss”
page_number	int	是	页码默认1，每页默认1000条
page_length	int	否	每页记录条数，默认最大是1000条，可以根据数据的大小自行优化调整

返回结果：

{
    "return_code": true, 
    "response_data": [
        {
            "confirm_emp_code": null, 
            "inventory_type": "1", 
            "confirm_emp_source_code": null, 
            "confirm_emp_name": null, 
            "prods": [
                {
                    "goods_location": "1",
                    "actual_stock": 2137.145, 
                    "current_stock": 2137.145, 
                    "prod_source_code": null, 
                    "prod_id": "6692513571119135747", 
                    "detail_id": "5183969319998512131", 
                    "sequ": 0, 
                    "difference_stock": 0, 
                    "prod_code": "1HBSKLSD", 
                    "prod_name": "测试商品1"
                }, 
                ......
            ], 
            "inventory_status": "1", 
            "remarks": "", 
            "emp": "8724832689904775768", 
            "date": "2017-08-21", 
            "car": "8878885617773144765", 
            "id": "5183969319998512131", 
            "car_name": "1ed", 
            "car_code": "CK0076", 
            "supplier_id": "5012103144063463929", 
            "create_name": "张三",
            "create_emp_name": "王伟", 
            "create_emp_code": "wangwei", 
            "status": "1", 
            "emp_source_code": "wangwei", 
            "confirm_emp_id": null, 
            "emp_name": "员工1", 
            "confirm_time": null
        },
        .......
    ]
}

响应信息

参数	类型	必填	说明
msg_id	VARCHAR(32)	是	消息ID
return_code	VARCHAR(32)	是	响应编码：0成功 1失败
return_msg	VARCHAR(100)	否	响应说明
response_data	VARCHAR(32)	否	响应数据
id	INT8	是	盘点单ID
status	VARCHAR(32)	否	0：已删除，1：正常
inventory_status	VARCHAR(32)	否	盘点状态 0、未审核，1、已审核，2、已作废
inventory_type	VARCHAR(32)	否	盘点类型 1、全部盘点，2、部分盘点
date	VARCHAR(100)	否	盘点日期，yyyy-mm-dd格式
create_time	VARCHAR(100)	否	创建时间，yyyy-mm-dd HH:mm:ss格式
modify_time	VARCHAR(100)	否	修改时间，yyyy-mm-dd HH:mm:ss格式
emp	INT8	否	经办人ID
emp_code	VARCHAR(100)	否	经办人编码
emp_source_code	VARCHAR(100)	否	经办人源编码
emp_name	VARCHAR(100)	否	经办人名称
create_id	INT8	否	创建人ID
create_emp_code	VARCHAR(100)	否	创建人编码
create_emp_source_code	VARCHAR(100)	否	创建人源编码
create_emp_name	VARCHAR(100)	否	创建人名称
car	INT8	否	车辆ID
car_code	VARCHAR(100)	否	车辆编码
car_name	VARCHAR(100)	否	车辆名称
supplier_id	INT8	否	经销商id
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格式
prods[].detail_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[].goods_location	VARCHAR(32)	否	1、正常品库(可销库存)， 2、报废品库(退货库存)，3、处理品库(换货库存)

← 其他出库接口 DMS数据推送 →