API开放平台

TIP

# 新增直营订单发货单

请求方式： 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 否 配送方式
sent_receive_id VARCHAR(32) 否 发货单收货方id
sent_receive_code VARCHAR(100) 否 发货单收货方编码
sent_receive_name VARCHAR(100) 否 发货单收货方名称
sent_receive_addr_id VARCHAR(32) 否 发货单收货地址id
sent_receive_addr VARCHAR(100) 否 发货单收货地址名称
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-失败, 其他详见附录错误码说明 (opens new window)
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-失败, 其他详见附录错误码说明 (opens new window)
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-失败, 其他详见附录错误码说明 (opens new window)
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-失败, 其他详见附录错误码说明 (opens new window)
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) 否 客户名称，唯一，有效字符详见附录：有效字符说明 (opens new window)
emp_code VARCHAR(32) 否 业务员编码，有效字符详见附录：有效字符说明 (opens new window)
emp_name VARCHAR(32) 否 业务员名称，唯一，有效字符详见附录：有效字符说明 (opens new window)
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",
                      	"last_kh_price":"1000.00",
                      	"addpd_pool_source_code":""
			        "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) 否 费用池使用金额
business_order_type_name VARCHAR(100) 否 业务类型名称
business_order_type_code VARCHAR(100) 否 业务类型编码
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) 否 序号
prods[].last_kh_price varchar(32) 否 系统价
prods[].addpd_pool_source_code varchar(32) 否 赠品池sourcecode

# 查询分销销售订单

请求方式： 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) 否 客户名称，唯一，有效字符详见附录：有效字符说明 (opens new window)
s_supplyCode VARCHAR(32) 否 供应商编码，有效字符详见附录：有效字符说明 (opens new window)
s_supplyName VARCHAR(32) 否 供应商名称，唯一，有效字符详见附录：有效字符说明 (opens new window)
emp_code VARCHAR(32) 否 业务员编码，有效字符详见附录：有效字符说明 (opens new window)
emp_name VARCHAR(32) 否 业务员名称，唯一，有效字符详见附录：有效字符说明 (opens new window)
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-失败, 其他详见附录错误码说明 (opens new window)
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：失败, 其他详见附录错误码说明 (opens new window)
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": ""
            "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[].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、处理品库(换货库存)

# 直营订单发货单自动签收

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

{
    "sent_no": "FH20201110000001"
}

请求信息

参数 类型 必填 说明
sent_no VARCHAR(100) 是 发货单号

返回结果：

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

响应信息

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

# 直营订单自定义字段修改

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

{
    "order_no": "FH20201110000001",
    "exts":[{
        "ext_key":"等级",
        "ext_value":"VIP"
    },.....],
    "products":[{
        "id":"20201110000001",
        "exts":[{
        	"ext_key":"商品等级",
        	"ext_value":"88VIP"
    	},.....]
    },....]
}

请求信息

参数 类型 必填 说明
order_no VARCHAR(100) 是 订单单号
exts[].ext_key VARCHAR(100) 是 订单主数据扩展字段名称
exts[].ext_value VARCHAR(100) 是 订单主数据扩展字段数据值
products[].id VARCHAR(100) 是 订单明细行id
products[].exts[].ext_key VARCHAR(100) 是 订单明细数据扩展字段名称
products[].exts[].ext_value VARCHAR(100) 是 订单明细数据扩展字段数据值

返回结果：

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

响应信息

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

← DMS数据推送 →