API开放平台

TIP

新增直营订单发货单
新增直营订单
关闭直营订单
DMS外部客户余额同步接口
查询直营采购订单
查询分销销售订单
查询分销或者直营发货单
查询分销或者直营签收单
查询盘点单
查询车铺单
查询实时库存
查询直营或分销退货单
查询兑货券明细
新增兑货券
审批兑货券
直营订单业务状态同步接口
新增客户配额
修改客户配额
查询共享配额
查询客户配额（限量）-按商品
查询客户配额（限量）-按商品组
经销商车辆查询接口
分销车销 - 调拨单查询接口
分销车销 - 车销单查询接口
经销商车辆库存查询接口
分销订单发货单第三方签收数量写入接口
直营订单退货订单新增接口
直营退货订单新增收货接口
查询车辆盘点单
直营订单发货单自动签收
直营订单自定义字段修改
新增直营订单发货单运输信息
新增收款单（收预存款）接口
新增收款单（收货款）接口
收款单查询接口
新增退款单（退预存款）接口
新增退款单（退货款）接口
退款单查询接口
退换货订单查询接口

# 新增直营订单发货单

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

{
    "sent_no": "FH201612100000001",
    "sent_date": "2020-12-10",
    "order_no": "DD201612090000001",
    "purchase_no": "CK20161209000001",
    "order_create_date": "2020-12-10",
    "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)	是	采购单号，销售订单号和采购单号必须传一个
order_create_date	VARCHAR(32)	否	订单创建日期。格式：yyyy-mm-dd
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表示厂家供货。如果供应商id和供应商编码（经销商的编码）都不传将根据客户的上级经销商来查询
supply_code	VARCHAR(100)	否	供应商编码（经销商的编码），-1表示厂家供货。如果供应商id和供应商编码（经销商的编码）都不传将根据客户的上级经销商来查询
sent_storehouse_id	VARCHAR(32)	否	供应商发货仓库id。如果供应商发货仓库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	List		列表
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	List		列表
costpooldetails.account	VARCHAR(32)	否	客户账户名称
costpooldetails.amount	NUMERIC(18,8)	否	核销金额
products.exts	List	否	发货单详情信息扩展字段列表
products.exts.ext_key	varchar(4000)	否	发货单详情信息扩展字段key值扩展字段需先在我方系统中创建
products.exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接
exts	List	否	发货单主信息扩展字段列表
exts.ext_key	varchar(4000)	否	发货单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接

接口说明：订货价order_price不传默认取客户价格，是否是赠品is_gift不传默认为非赠品。如果该商品是赠品，order_price传0，is_gift传Y。未免出错，这二个字段建议必填

响应示例：

{
    "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 } 在线调试
请求示例：

{
    "operate_type": "1",
    "order_no": "DD201612090000001",
    "order_create_date": "2016-12-09",
    "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)	是	新增的时候传递作为新订单的单号（不传系统自动生成），编辑的时候传递作为参数进行编辑订单
order_create_date	VARCHAR(32)	否	订单创建日期。格式：yyyy-MM-dd HH:mm
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	List	否	采购单主信息扩展字段列表
exts.ext_key	varchar(4000)	否	采购单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接
products	List		商品订购信息列表
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	List	否	采购单详情信息扩展字段列表
products.exts.ext_key	varchar(4000)	否	采购单详情信息扩展字段key值扩展字段需先在我方系统中创建
products.exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接

接口说明：订货价price不传默认取客户价格，是否是赠品is_gift不传默认为非赠品。如果该商品是赠品，price传0，is_gift传1。未免出错，这二个字段建议必填

响应示例：

{
    "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	List	自定义字段码列表
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	List	商品订购信息列表
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	List	商品自定义字段列表
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 } 在线调试
请求示例：

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
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 } 在线调试
请求示例：

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
data	List	是	列表
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} 在线调试
请求示例：

{
    "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	否	勤策（原外勤365）id
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
purchase_status	VARCHAR(100)	否	采购订单状态。CG_DFH：待发货，CG_DRK：待入库，CG_YWC：已完成，CG_DQR：待确认，CG_YQX：已取消，CG_FHZ：发货中。多状态用逗号分隔

响应示例：

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

数据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",
                "rebate_account_code": "40"
           }
        ],
        "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": 
        [
             {
                "product_id": "4843786111936788462",
                "product_name": "商品1",
                "product_code": "P0001",
                "allocated_amount": "10.00000000",
                "sale_cus_code": "CUS0001",
                "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":"",
                "sys_input_unit_price":"",
                "exts": 
                [
                    {
                        "ext_key": "级别",
                        "ext_value": "四星"
                    },
                    {
                        "ext_key": "主营商品",
                        "ext_value": "食品,电器,日化用品"
                    }
                ]
            }
        ]
        }
        ]
    }
]

参数说明：

参数	类型	必填	说明
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	List	否	列表
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)	否	费用池账户id
usedAmountPools.rebate_account_code	VARCHAR(32)	否	费用池账户编码
exts	List		采购单主信息扩展字段列表
exts.ext_key	varchar(4000)	否	采购单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接
prods	List		列表
prods.product_id	varchar(32)	否	商品id
prods.product_name	varchar(100)	否	商品名称
prods.product_code	varchar(100)	否	商品编码
prods.allocated_amount	varchar(32)	否	分摊后金额
prods.sale_cus_code	varchar(32)	否	分销客户
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.gift_amount	numeric(20,2)	否	赠品金额
prods.gift_price	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	List	否	采购单主信息扩展字段列表
prods.exts.ext_key	varchar(200)	否	采购单主信息扩展字段key值，扩展字段需先在我方系统中创建
prods.exts.ext_value	varchar(200)	否	扩展字段value值对多个选项值，以“,”分隔拼接
prods	List	否	列表
prods.posnr	numeric(15)	否	序号
prods.last_kh_price	varchar(32)	否	系统价
prods.addpd_pool_source_code	varchar(32)	否	赠品池sourcecode
prods.sys_input_unit_price	varchar(32)	否	标准价
prods.rebate_account_id	varchar(32)	否	费用池账户id
prods.rebate_account_code	varchar(32)	否	费用池账户编码

# 查询分销销售订单

请求方式： 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：换出订单

响应示例：

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

数据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"
        }
     ]
    }
]

参数说明：

参数	类型	必填	说明
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	List	否	代金券列表
usedGiftCards.reduce_amount	VARCHAR(32)	否	代金券使用金额
usedGiftCards.card_id	VARCHAR(32)	否	代金券id
usedGiftCards.card_no	VARCHAR(32)	否	代金券号
usedAmountPools	List	否	费用池信息列表
usedAmountPools.rebate_account_amount	VARCHAR(32)	否	费用池使用金额
usedAmountPools.rebate_account_id	VARCHAR(32)	否	费用池账户
prods	List		列表
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.gift_amount	numeric(20,2)	否	赠品金额
prods.gift_price	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.superposition_promotion_code	varchar(200)	否	叠加促销编码
prods.superposition_promotion_name	varchar(200)	否	叠加促销名称
prods.superposition_promotion_type	varchar(200)	否	促销类型。BASE：基本策略，OVERLAP：叠加策略。默认值为BASE
prods.superposition_promotion_id	varchar(200)	否	叠加促销id
prods.amount_promotion_code	varchar(200)	否	金额促销编码
prods.amount_promotion_name	varchar(200)	否	金额促销名称
prods.amount_promotion_type	varchar(200)	否	促销类型。BASE：基本策略，OVERLAP：叠加策略。默认值为BASE
prods.amount_promotion_id	varchar(200)	否	金额促销id
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	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

响应示例：

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

数据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"
              }
       ]
    }
]

参数说明：

参数	类型	必填	说明
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	List		列表
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	List	否	列表
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	INT	否	页码默认1，每页默认1000条
page_length	INT	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整
s_status	CHAR(1)	否	记录状态。0：已删除，1：正常
s_sign_status	VARCHAR(32)	否	签收状态。FH_DQS：待签收，FH_YQS：已签收，FH_CLZ：处理中，FH_QSZ：签收中，FH_YJQ：已拒签。不传默认值为FH_YQS，多个值以","隔开
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

响应示例：

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

数据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": ""
              }
       ]
    }
]

参数说明：

参数	类型	必填	说明
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(4000)	否	偏差备注
sign_pictures	VARCHAR(4000)	否	签收照片，多张使用逗号分隔
sign_mode	varchar(32)	否	签收方式：ELECTRONIC_SEAL、电子签章，MESSAGES_SIGNATURE、短信签字，APPOWNER_SIGN、点击签收按钮签收（默认签收方式），SYSTEM_AUTO_SIGN、系统自动签收，OPENAPI_SIGN、外部接口签收，CMTENANT_SIGN、互联下游签收
sign_attachment	TEXT	否	当发货单状态为FH_YQS，为签收文件地址。当发货当状态为FH_YJQ时，为拒收文件地址。
sign_attachment_full_path	TEXT	否	sign_attachment的全路径地址
sign_reason	TEXT	否	当发货单状态为FH_YQS，为签收原因。当发货当状态为FH_YJQ时，为拒收原因。
review_position	VARCHAR(100)	否	评价定位地址
sign_status	varchar(32)	否	发货单状态。FH_DQS：待签收，FH_YQS：已签收，FH_CLZ：处理中，FH_QSZ：签收中，FH_YJQ：已拒签
logistics_dept_code	varchar(4000)	否	物流部门编码
prods	List		列表
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.gift_amount	numeric(20,2)	否	赠品金额
prods.gift_price	numeric(20,2)	否	赠品单价
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)	否	第三方签收数量
reviewInfos	timestamp	否	评价内容列表
reviewInfos.review_time	timestamp	否	评价时间。格式：yyyy-mm-dd hh24:mi:ss
reviewInfos.review_score	numeric(15,0)	否	服务评分
reviewInfos.review_content	VARCHAR(1000)	否	评价内容
reviewInfos.review_image	VARCHAR(1000)	否	评价照片

# 查询盘点单

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

说明：本示例仅供参考。

参数说明：

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

响应示例：

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

数据DATA示例:

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

参数说明：

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

# 查询车铺单

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

说明：本示例仅供参考。

参数说明：

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

响应示例：

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

数据DATA示例:

[
    {
        "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"
    }
]

参数说明：

参数	类型	必填	说明
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	List		列表
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)	否	序号
prods.is_gift	VARCHAR(32)	否	是否是商品促销策略里面的赠品。Y：是，N：否

# 查询实时库存

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

说明：本示例仅供参考。

请求信信息

参数	类型	必填	说明
page_number	INT	否	当前页数，不传默认为1
start_create_date	TIMESTAMP	否	创建时间开始。格式：yyyy-MM-dd
end_create_date	TIMESTAMP	否	创建时间结束。格式：yyyy-MM-dd
start_modify_date	TIMESTAMP	否	修改时间开始。格式：yyyy-MM-dd
end_modify_date	TIMESTAMP	否	修改时间结束。格式：yyyy-MM-dd

响应示例：

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

数据DATA示例:

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

参数说明：

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

# 查询直营或分销退货单

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

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
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

响应示例：

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

数据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": ""
    }
]

参数说明：

参数	类型	必填	说明
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	List		列表
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，表明这不是促销组中的商品信息
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	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", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据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" 
    }
]

参数说明：

参数	类型	必填	说明
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	List		列表
prods.product_id	VARCHAR(32)	是	商品id。商品id和商品编码不能同时为空
prods.product_code	VARCHAR(100)	是	商品编码，商品id和商品编码不能同时为空
prods.unit_name	VARCHAR(32)	是	商品单位
prods.num	NUMERIC(18,8)	是	兑换数量

响应示例：

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

数据DATA示例:

[
    {
        "id": "8183666817447601554",
        "code": "DH20200507000001"
    }
]

参数说明：

参数	类型	必填	说明
id	VARCHAR(32)	是	兑货券id
code	VARCHAR(100)	否	兑货券编码

# 审批兑货券

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

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
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	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	List		列表
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)	是	数量

响应示例：

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

数据DATA示例:

[
    {
       "id":"5932650281301050831"
    }
]

参数说明：

参数	类型	说明
id	String	配额id

# 修改客户配额

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

说明：本示例仅供参考。该接口仅支持按商品设置的客户配额，不支持商品组。

参数说明：

参数	类型	必填	说明
quota_id	VARCHAR(32)	是	配额id
products	List		列表
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	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": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据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
        }]
    }
]

参数说明：

参数	类型	说明
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	List	列表
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/dmsquota/v1/queryCmQuotaByPds/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
cm_id	VARCHAR(32)	否	客户ID
cm_code	VARCHAR(100)	否	客户编码，模糊匹配
start_date	VARCHAR(32)	否	开始日期。格式：yyyy-MM-dd
end_date	VARCHAR(32)	否	结束日期。格式：yyyy-MM-dd
page_number	INT	否	页码默认1，每页默认1000条
page_length	INT	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整

响应示例：

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

数据DATA示例:

[
    {
      "end_date": "2021-11-30",
      "cm_code": "CUS000002",
      "cm_id": "8078723553496786531",
      "cm_name": "老杜的直营经销商",
      "id": "8877331564457593316",
      "start_date": "2021-10-18",
      "prods": [
        {
          "input_unit_name": "箱",
          "base_use_num": "96.00000000",
          "pd_name": "美年达1.5L",
          "input_unit": "5803442770927807830",
          "pd_id": "7143944694665909984",
          "pd_code": "baiyin_meinianda_015",
          "base_unit_num": "12000.00000000",
          "base_leave_num": "11904.00000000",
          "ratio": "12.00000000"
        },
        {
          "input_unit_name": "箱",
          "base_use_num": "206.00000000",
          "pd_name": "美年达1.8L",
          "input_unit": "7436738431149470274",
          "pd_id": "6594438290133846973",
          "pd_code": "baiyin_meinianda_0100",
          "base_unit_num": "12000.00000000",
          "base_leave_num": "11794.00000000",
          "ratio": "12.00000000"
        }
      ]
    }
]

参数说明：

参数	类型	说明
id	VARCHAR(32)	配额ID
cm_id	VARCHAR(32)	客户ID
cm_code	VARCHAR(100)	客户编码
cm_name	VARCHAR(100)	客户名称
start_date	VARCHAR(32)	开始日期。格式：yyyy-MM-dd
end_date	VARCHAR(32)	结束日期。格式：yyyy-MM-dd
prods	List	商品集合
prods.pd_id	VARCHAR(32)	商品ID
prods.pd_code	VARCHAR(100)	商品编码
prods.pd_name	VARCHAR(100)	商品名称
prods.input_unit	VARCHAR(32)	录入单位ID
prods.input_unit_name	VARCHAR(32)	录入单位名称
prods.base_leave_num	VARCHAR(32)	基本单位可用配额
prods.base_use_num	VARCHAR(32)	基本单位已用配额
prods.base_unit_num	VARCHAR(32)	基本单位配额总量
prods.ratio	VARCHAR(32)	单位换算率

# 查询客户配额（限量）-按商品组

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

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
cm_id	VARCHAR(32)	否	客户ID
cm_code	VARCHAR(100)	否	客户编码，模糊匹配
start_date	VARCHAR(32)	否	开始日期。格式：yyyy-MM-dd
end_date	VARCHAR(32)	否	结束日期。格式：yyyy-MM-dd
page_number	INT	否	页码默认1，每页默认1000条
page_length	INT	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整

响应示例：

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

数据DATA示例:

[
    {
      "end_date": "2022-02-18",
      "cm_code": "CUS010057",
      "start_date": "2022-01-29",
      "cm_id": "8261138874684328070",
      "cm_name": "经销商698",
      "set_type": "3",
      "id": 5182948809562810579,
      "pd_group": [
        {
          "prods": [
            {
              "pd_name": "徐福记鸡蛋味磨堡蛋糕开袋有礼袋装@4(5x190g) CN",
              "pd_id": "5649247804170269808",
              "pd_code": "12429127"
            },
            {
              "pd_name": "徐福记芝麻味磨堡蛋糕开袋有礼袋装@4(5x190g) CN",
              "pd_id": "6909802553692176330",
              "pd_code": "12429143"
            },
            {
              "pd_name": "奇欧比混合味皇冠巧伯礼桶巧克力代可可脂巧克力制品桶装@12x400gN1 CN",
              "pd_id": "5305586956782193565",
              "pd_code": "12429342"
            }
          ],
          "num": "1.00000000",
          "leave_num": "1.00000000",
          "id": "6286824530802957326",
          "use_num": "0.00000000"
        },
        {
          "prods": [
            {
              "pd_name": "徐福记沙琪玛蛋黄味礼箱装@4x1.258kg CN",
              "pd_id": "5519612291868405998",
              "pd_code": "12434809"
            },
            {
              "pd_name": "徐福记沙琪玛蛋黄味礼箱装@8x1.258kg CN",
              "pd_id": "6836469404668823760",
              "pd_code": "12434810"
            },
            {
              "pd_name": "徐福记混合口味颐和园综合礼盒@6x502gN1 CN",
              "pd_id": "5410301540946856948",
              "pd_code": "12437461"
            }
          ],
          "num": "1.00000000",
          "leave_num": "1.00000000",
          "id": "7260339783336677243",
          "use_num": "0.00000000"
        }
      ],
      "type_group": [
        {
              "types": [
                {
                  "type_name": "东东测试",
                  "type_id": "7457495518661131674"
                },
                {
                  "type_name": "科技",
                  "type_id": "5516029438444450722"
                }
              ],
              "num": "1.00000000",
              "leave_num": "1.00000000",
              "id": "7238401400236745981",
              "use_num": "0.00000000"
            }
      ]
    }
]

参数说明：

参数	类型	说明
id	VARCHAR(32)	配额ID
cm_id	VARCHAR(32)	客户ID
cm_code	VARCHAR(100)	客户编码
cm_name	VARCHAR(100)	客户名称
start_date	VARCHAR(32)	开始日期。格式：yyyy-MM-dd
end_date	VARCHAR(32)	结束日期。格式：yyyy-MM-dd
set_type	VARCHAR(1)	2商品组（类型） 3、商品组（商品）
pd_group	List	商品组（商品）集合 set_type=3
pd_group.num	VARCHAR(32)	配额总量
pd_group.use_num	VARCHAR(32)	已用配额
pd_group.leave_num	VARCHAR(32)	可用配额
pd_group.prods	List	商品集合
pd_group.prods.pd_id	VARCHAR(32)	商品ID
pd_group.prods.pd_code	VARCHAR(100)	商品编码
pd_group.prods.pd_name	VARCHAR(100)	商品名称
type_group	List	商品组（类型）集合 set_type=2
pd_group.num	VARCHAR(32)	配额总量
pd_group.use_num	VARCHAR(32)	已用配额
pd_group.leave_num	VARCHAR(32)	可用配额
pd_group.types	List	商品类型集合
pd_group.types.type_id	VARCHAR(32)	商品类型ID
pd_group.types.type_name	VARCHAR(100)	商品类型名称

# 经销商车辆查询接口

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

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
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条，可以根据业务数据的大小自行优化调整

响应示例：

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

数据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"
    }
]

参数说明：

参数	类型	必填	说明
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 } 在线调试
请求示例：

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
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条，可以根据业务数据的大小自行优化调整

响应示例：

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

数据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": ""
            }
        ]
    }
]

参数说明：

参数	类型	必填	说明
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	List	否	列表
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 } 在线调试
请求示例：

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
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条，可以根据业务数据的大小自行优化调整

响应示例：

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

数据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"
            }
        ]
    }
]

参数说明：

参数	类型	必填	说明
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	List	否	列表
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 } 在线调试
请求示例：

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
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条，可以根据业务数据的大小自行优化调整

响应示例：

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

数据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"
    }
]

参数说明：

参数	类型	必填	说明
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}/{msg_id} 在线调试
请求示例：

说明：本示例仅供参考。

参数说明：：

参数	类型	必须	说明
sent_create_date	VARCHAR(32)	是	发货单创建日期。格式yyyy-mm-dd
order_sent_id	VARCHAR(32)	是	发货单ID
prods	List	是	列表
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/dmschangeback/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	List		列表
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	List	否	退货订单主信息扩展字段列表
exts.ext_key	VARCHAR(4000)	否	退货订单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value	VARCHAR(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接

接口说明：退货价price不传默认取客户价格，是否是赠品is_gift不传默认为非赠品。如果该商品是赠品，price传0，is_gift传1。未免出错，这二个字段建议必填

响应示例：

{
    "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	List		列表
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)	否	入库单位和入库单位名称传一个即可，不传使用基本单位
prods.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 } 在线调试
请求示例：

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
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": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据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
    }
]

参数说明：

参数	类型	必填	说明
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	List		列表
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 } 在线调试
请求示例：

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
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 } 在线调试
请求示例：

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

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
order_no	VARCHAR(100)	是	订单单号
exts	List		列表
exts.ext_key	VARCHAR(100)	是	订单主数据扩展字段名称
exts.ext_value	VARCHAR(100)	是	订单主数据扩展字段数据值
products	List		列表
products.id	VARCHAR(100)	是	订单明细行id
products.exts	List		订单明细数据扩展字段列表
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	响应数据

# 新增直营订单发货单运输信息

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

{
    "bill_code": "FH20201110000001",
    "driver_name":"小杜呀",
    "driver_phone":"13675189390",
    "car_no":"che1",
    "delivery_date":"2020-12-27",
    "remark":"我这是备注",
    "logistics_url":"",
    "orderSents":[
        {
            "sent_id":"7817081791819132613",
            "sent_no":"FH20210118000003"
        }
    ]
}

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
bill_code	VARCHAR(100)	是	运单号
driver_name	VARCHAR(32)	否	司机名称
driver_phone	VARCHAR(32)	否	司机手机号
car_no	VARCHAR(32)	否	车牌号
delivery_date	TIMESTAMP	否	预计送达日期。格式：yyyy-MM-dd
remark	TEXT	否	备注
logistics_url	VARCHAR(100)	否	物流链接地址
orderSents	List	否	发货单列表
orderSents.sent_id	INT8	否	发货单id，接口传参至少要传一条发货单数据
orderSents.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/receivableHistory/v1/savePreDeposit/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
	"supply_id": "-1",
    "supply_code": "",
	"cm_code": "",
	"business_type": "",
	"capitalpool_code": "",
	"from_details": [
		{
			"settlement_name": "",
			"amount": ""
		}
	],
	"receive_date": "",
	"receiver": "",
	"remark": "",
	"main_exts": [
		{
			"ext_name": "",
			"ext_value": ""
		},
		{
			"ext_name": "",
			"ext_value": ""
		}
	]
}

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
supply_id	VARCHAR(32)	否	收款单位id。收款单位id和收款单位编码必须传一个。厂家/直接经销商传值为-1
supply_code	VARCHAR(100)	否	收款单位编码，收款单位id和收款单位编码必须传一个
cm_code	VARCHAR(100)	是	客户编码
business_type	VARCHAR(100)	是	收款类型。0：收欠款，1：收订金，2：退订金 3：收预存款
capitalpool_code	VARCHAR(100)	是	资金池编码
receive_date	TIMESTAMP	是	收款日期。格式：yyyy-MM-dd
receiver	VARCHAR(100)	是	收款人（编码）
remark	VARCHAR(300)	否	备注说明
from_details	List		列表
from_details.settlement_name	VARCHAR(100)	是	结算方式名称
from_details.amount	VARCHAR(100)	是	收款金额
main_exts	List		自定义字段列表
main_exts.ext_name	VARCHAR(100)	否	自定义字段名称
main_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	响应数据

# 新增收款单（收货款）接口

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

{
	"supply_id": "-1",
	"supply_code": "",
	"cm_code": "",
	"business_type": "",
	"pool_details": [
		{
			"capitalpool_code": "",
			"use_amount": ""
		}
	],
	"from_details": [
		{
			"settlement_name": "",
			"amount": ""
		}
	],
	"receive_discount_amount": "",
	"receive_date": "",
	"receiver": "",
	"remark": "",
	"main_exts": [
		{
			"ext_name": "",
			"ext_value": ""
		},
		{
			"ext_name": "",
			"ext_value": ""
		}
	],
	"details": [
		{
			"bill_code": "TH20211109000005",
			"amount": "200",
			"bill_type": ""
		}
	]
}

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
supply_id	VARCHAR(32)	否	收款单位id。收款单位id和收款单位编码必须传一个。厂家/直接经销商传值为-1
supply_code	VARCHAR(100)	否	收款单位编码，收款单位id和收款单位编码必须传一个
cm_code	VARCHAR(100)	是	客户编码
business_type	VARCHAR(100)	是	收款类型。0：收欠款，1：收订金，2：退订金 3：收预存款
pool_details	List		列表
pool_details.capitalpool_code	VARCHAR(100)	否	使用预存款子表-资金池编码
pool_details.use_amount	VARCHAR(100)	否	使用预存款子表-使用金额
receive_date	TIMESTAMP	是	收款日期。格式：yyyy-MM-dd
receiver	VARCHAR(100)	是	收款人（编码）
remark	VARCHAR(300)	是	备注说明
receive_discount_amount	VARCHAR(100)	是	收款优惠
from_details	List		列表
from_details	List		列表
from_details.settlement_name	VARCHAR(100)	是	收款子表-结算方式名称
from_details.amount	VARCHAR(100)	是	收款子表-收款金额
details	List		列表
details.bill_code	VARCHAR(100)	是	关联单据-单据号
details.amount	VARCHAR(100)	是	关联单据-本单结算金额
details.bill_type	VARCHAR(100)	否	关联单据-单据类型。CXD：车销单，ZYFHD：直营发货单，FXFHD：分销发货单，CPD：车铺单，THD：退货单
main_exts	List		列表
main_exts.ext_name	VARCHAR(100)	否	自定义字段名称
main_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	响应数据

# 收款单查询接口

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

{
    "page_number": 1,
    "page_length": 100,
    "supply_id": -1,
    "cm_code": "USER001",
    "start_create_date": "2016-12-09",
    "end_create_date": "2016-12-19",
    "start_modify_date": "2017-12-09",
    "end_modify_date": "2017-12-09"
}

参数说明：

参数	类型	必填	说明
supply_id	VARCHAR(32)	否	收款单位ID。总部传-1。
cm_code	VARCHAR(100)	否	客户编码
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条，可以根据数据的大小自行优化调整

响应示例：

{
	"return_code": true,
	"response_data":"<<DATA>>"
}

数据DATA示例:

[
		{
			"id": "",
			"receive_no": "",
			"confirm_status": "",
			"confirm_status_name": "",
			"cm_id": "",
			"cm_code": "",
			"cm_name": "",
			"supply_id": "",
			"supply_code": "",
			"supply_name": "",
			"receive_type": "",
			"receive_type_name": "",
			"capitalpool_id": "",
			"capitalpool_code": "",
			"capitalpool_name": "",
			"small_amount": "",
			"receive_date": "",
			"emp_name": "",
			"remark": "",
             "details": [
				{
					"bill_id": "",
					"bill_code": "",
					"bill_type": "",
					"bill_type_name": "",
					"bill_amount": ""
				}
			],
			"pool_detail": [
				{
					"pool_detail_id": "",
					"pool_detail_code": "",
					"pool_detail_amount": ""
				}
			],
			"settlement_detail": [
				{
					"settlement_detail_id": "",
					"settlement_detail_name": "",
					"settlement_detail_amount": ""
				}
			],
			"ext_infos": [
				{
					"ext_code": "",
					"ext_name": "",
					"ext_value": ""
				}
			]
		}
]

参数说明：

参数	类型	必填	说明
id	INT8	否	收款单ID
receive_no	VARCHAR(32)	否	收款单号
confirm_status	VARCHAR(32)	否	状态。0：待审批，1：待入账，2：已作废，3：已入账
confirm_status_name	VARCHAR(100)	否	状态名称
cm_id	VARCHAR(100)	否	客户id
cm_code	VARCHAR(100)	否	客户编码
cm_name	VARCHAR(100)	否	客户名称
supply_id	INT8	否	收款单位id
supply_code	VARCHAR(100)	否	收款单位编码
supply_name	VARCHAR(100)	否	收款单位名称
receive_type	VARCHAR(32)	否	业务类型。0：收货款，2：退订金 3：收预存款
receive_type_name	VARCHAR(100)	否	收款类型名称
capitalpool_id	INT8	否	资金池id
capitalpool_code	VARCHAR(100)	否	资金池编码
capitalpool_name	VARCHAR(100)	否	资金池名称
small_amount	VARCHAR(100)	否	收款优惠
receive_date	VARCHAR(100)	否	收款日期
emp_name	VARCHAR(100)	否	收款人
remark	text	否	备注说明
details.bill_id	INT8	否	关联单据-单据id
details.bill_code	VARCHAR(100)	否	关联单据-单据号
details.bill_type	VARCHAR(100)	否	关联单据-单据类型。CXD：车销单，FHD：发货单，CPD：车铺单，THD：退货单
details.bill_type_name	VARCHAR(100)	否	关联单据-单据类型名称
details.bill_amount	VARCHAR(100)	否	关联单据-本单结算金额
pool_detail	List		使用预存款子表列表
pool_detail.pool_detail_id	INT8	否	使用预存款子表-资金池id
pool_detail.pool_detail_code	VARCHAR(100)	是	使用预存款子表-资金池编码
pool_detail.pool_detail_amount	VARCHAR(100)	否	使用预存款子表-使用金额
settlement_detail	List	否	收款子表列表
settlement_detail.settlement_detail_id	INT8	否	收款子表-结算方式id
settlement_detail.settlement_detail_name	VARCHAR(100)	否	收款子表-结算方式名称
settlement_detail.settlement_detail_amount	VARCHAR(100)	否	收款子表-收款金额
ext_infos	VARCHAR(100)	否	自定义字段列表
ext_infos.ext_code	VARCHAR(100)	否	自定义字段-编码
ext_infos.ext_name	VARCHAR(100)	否	自定义字段-名称
ext_infos.ext_value	VARCHAR(100)	否	自定义字段-值

# 新增退款单（退预存款）接口

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

{
	"supply_id": "-1",
    "supply_code": "",
	"cm_code": "",
	"business_type": "",
	"capitalpool_code": "",
	"from_details": [
		{
			"settlement_name": "",
			"amount": ""
		}
	],
	"receive_date": "",
	"receiver": "",
	"remark": "",
	"main_exts": [
		{
			"ext_name": "",
			"ext_value": ""
		},
		{
			"ext_name": "",
			"ext_value": ""
		}
	]
}

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
supply_id	VARCHAR(32)	否	退款单位id （退款单位id和退款单位编码必须传一个。总部传-1）
supply_code	VARCHAR(100)	否	退款单位编码，退款单位id和退款单位编码必须传一个
cm_code	VARCHAR(100)	是	客户编码
business_type	VARCHAR(100)	是	退款类型（4：退货款 5:退预存款）
capitalpool_code	VARCHAR(100)	是	资金池编码
receive_date	TIMESTAMP	是	退款日期。格式：yyyy-MM-dd
receiver	VARCHAR(100)	是	退款人（编码）
remark	VARCHAR(300)	否	备注说明
from_details	List		列表
from_details.settlement_name	VARCHAR(100)	是	结算方式名称
from_details.amount	VARCHAR(100)	是	退款金额
main_exts	List		列表
main_exts.ext_name	VARCHAR(100)	否	自定义字段名称
main_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	响应数据

# 新增退款单（退货款）接口

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

{
	"supply_id": "-1",
    "supply_code": "",
	"cm_code": "",
	"business_type": "",
	"pool_details": [
		{
			"capitalpool_code": "",
			"use_amount": ""
		}
	],
	"from_details": [
		{
			"settlement_name": "",
			"amount": ""
		}
	],
	"receive_date": "",
	"receiver": "",
	"remark": "",
	"main_exts": [
		{
			"ext_name": "",
			"ext_value": ""
		},
		{
			"ext_name": "",
			"ext_value": ""
		}
	],
	"details": [
		{
			"bill_code": "",
			"amount": "",
			"bill_type": ""
		}
	]
}

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
supply_id	VARCHAR(32)	否	退款单位id （退款单位id和退款单位编码必须传一个。总部传-1）
supply_code	VARCHAR(100)	否	退款单位编码，退款单位id和退款单位编码必须传一个
cm_code	VARCHAR(100)	是	客户编码
business_type	VARCHAR(100)	是	退款类型（4：退货款 5:退预存款）
pool_details	List		列表
pool_details.capitalpool_code	VARCHAR(100)	否	使用预存款子表.资金池编码
pool_details.use_amount	VARCHAR(100)	否	使用预存款子表.使用金额
receive_date	TIMESTAMP	是	退款日期。格式：yyyy-MM-dd
receiver	VARCHAR(100)	是	退款人（编码）
remark	VARCHAR(300)	是	备注说明
from_details	List		列表
from_details.settlement_name	VARCHAR(100)	是	退款子表-结算方式名称
from_details.amount	VARCHAR(100)	是	退款子表- 退款金额
details	List		列表
details.bill_code	VARCHAR(100)	是	关联单据.单据号
details.amount	VARCHAR(100)	是	关联单据.本单结算金额
details.bill_type	VARCHAR(100)	否	关联单据.单据类型（CXD:车销单, ZYFHD:直营发货单, FXFHD:分销发货单，CPD：车铺单，THD:退货单）
main_exts	List		列表
main_exts.ext_name	VARCHAR(100)	否	自定义字段名称
main_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	响应数据

# 退款单查询接口

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

{
    "page_number": 1,
    "page_length": 100,
    "start_create_date": "2016-12-09",
    "end_create_date": "2016-12-19",
    "start_modify_date": "2017-12-09",
    "end_modify_date": "2017-12-09"
}

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
supply_id	VARCHAR(32)	否	收款单位ID。总部传-1。
cm_code	VARCHAR(100)	否	客户编码
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条，可以根据数据的大小自行优化调整

响应示例：

{
	"return_code": true,
	"response_data":"<<DATA>>"
}

数据DATA示例:

[
		{
			"id": "",
			"receive_no": "",
			"confirm_status": "",
			"confirm_status_name": "",
			"cm_id": "",
			"cm_code": "",
			"cm_name": "",
			"supply_id": "",
			"supply_code": "",
			"supply_name": "",
			"receive_type": "",
			"receive_type_name": "",
			"capitalpool_id": "",
			"capitalpool_code": "",
			"capitalpool_name": "",
			"small_amount": "",
			"receive_date": "",
			"emp_name": "",
			"remark": "",
             "details": [
				{
					"bill_id": "",
					"bill_code": "",
					"bill_type": "",
					"bill_type_name": "",
					"bill_amount": ""
				}
			],
			"pool_detail": [
				{
					"pool_detail_id": "",
					"pool_detail_code": "",
					"pool_detail_amount": ""
				}
			],
			"settlement_detail": [
				{
					"settlement_detail_id": "",
					"settlement_detail_name": "",
					"settlement_detail_amount": ""
				}
			],
			"ext_infos": [
				{
					"ext_code": "",
					"ext_name": "",
					"ext_value": ""
				}
			]
		},
		{
			"id": "",
			"receive_no": "",
			"confirm_status": "",
			"confirm_status_name": "",
			"cm_id": "",
			"cm_code": "",
			"cm_name": "",
			"supply_id": "",
			"supply_code": "",
			"supply_name": "",
			"receive_type": "",
			"receive_type_name": "",
			"capitalpool_id": "",
			"capitalpool_code": "",
			"capitalpool_name": "",
			"receive_date": "",
			"emp_name": "",
			"remark": "",
            "details": [
				{
					"bill_id": "",
                      "bill_code": "",
                      "bill_type": "",
                      "bill_type_name": "",
                      "bill_amount": ""
				}
			],
			"pool_detail": [
				{
					"pool_detail_id": "",
					"pool_detail_code": "",
					"pool_detail_amount": ""
				}
			],
			"settlement_detail": [
				{
					"settlement_detail_id": "",
					"settlement_detail_name": "",
					"settlement_detail_amount": ""
				}
			],
			"ext_infos": [
				{
					"ext_code": "",
					"ext_name": "",
					"ext_value": ""
				}
			]
		}
]

参数说明：

参数	类型	必填	说明
id	INT8	否	退款单ID
receive_no	VARCHAR(32)	否	退款单号
confirm_status	VARCHAR(32)	否	状态（0：待审批，1：待入账，2、已作废，3：已入账）
confirm_status_name	VARCHAR(100)	否	状态名称
cm_id	VARCHAR(100)	否	客户id
cm_code	VARCHAR(100)	否	客户编码
cm_name	VARCHAR(100)	否	客户名称
supply_id	INT8	否	退款单位id
supply_code	VARCHAR(100)	否	退款单位编码
supply_name	VARCHAR(100)	否	退款单位名称
receive_type	VARCHAR(32)	否	退款类型（4：退货款 5:退预存款）
receive_type_name	VARCHAR(100)	否	退款类型名称
capitalpool_id	INT8	否	资金池id
capitalpool_code	VARCHAR(100)	否	资金池编码
capitalpool_name	VARCHAR(100)	否	资金池名称
receive_date	VARCHAR(100)	否	退款日期
emp_name	VARCHAR(100)	否	退款人
remark	text	否	备注说明
details.bill_id	INT8	否	关联单据.单据id
details.bill_code	VARCHAR(100)	否	关联单据.单据号
details.bill_type	VARCHAR(100)	否	关联单据.单据类型（CXD:车销单,ZYFHD:直营发货单,FXFHD:分销发货单，CPD：车铺单，THD:退货单）
details.bill_type_name	VARCHAR(100)	否	关联单据.单据类型名称
details.bill_amount	VARCHAR(100)	否	关联单据.本单结算金额
pool_detail	List		列表
pool_detail.pool_detail_id	INT8	否	使用预存款子表.资金池id
pool_detail.pool_detail_code	VARCHAR(100)	是	使用预存款子表.资金池编码
pool_detail.pool_detail_amount	VARCHAR(100)	否	使用预存款子表.使用金额
settlement_detail	List		列表
settlement_detail.settlement_detail_id	INT8	否	退款子表.结算方式id
settlement_detail.settlement_detail_name	VARCHAR(100)	否	退款子表.结算方式名称
settlement_detail.settlement_detail_amount	VARCHAR(100)	否	退款子表.退款金额
ext_infos	List		列表
ext_infos.ext_code	VARCHAR(100)	否	自定义字段-编码
ext_infos.ext_name	VARCHAR(100)	否	自定义字段-名称
ext_infos.ext_value	VARCHAR(100)	否	自定义字段-值

# 退换货订单查询接口

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

{
    "rows": 1000,
    "page": 1,
    "supply_id": -1,
    "order_type": "1",
    "id": 5853717908000492197,
    "order_no": "TH20201012000003",
    "cm_code": "CUS010051",
    "after_create_date": "2021-11-23 10:57:24.487",
    "after_modify_date": "2021-11-23 10:57:24.487",
    "start_create_date": "2017-12-09",
    "end_create_date": "2017-12-09",
    "start_modify_date": "2017-12-09",
    "end_modify_date": "2017-12-09",
    "order_status": "DD_DSH",
    "status": "1"
}

说明：本示例仅供参考。

参数说明：

参数	类型	必填	说明
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
page	INT	否	页码默认1，每页默认1000条
rows	INT	否	每页记录条数，默认最大是1000条，可以根据数据的大小自行优化调整
supply_id	INT	否	供货商id。-1为直营退货订单，其他为分销退货订单
order_type	VARCHAR(32)	否	订单类型。1：退货订单，2：换入订单
id	INT8	否	退货订单ID
order_no	VARCHAR(32)	否	退货订单编号
cm_code	VARCHAR(32)	否	客户编码
order_status	VARCHAR(100)	否	DD_DSH、待收货，DD_YWC：已完成，DD_DQR：待确认，DD_YQX：已取消，DD_YQR：已确认 , 多状态用逗号分隔
status	VARCHAR(32)	否	记录状态。0：已删除，1：正常

响应示例：

{
	"return_code": "0",
	"response_data":"<<DATA>>"
}

数据DATA示例:

[
    {
        "order_no": "DD20210803000030",
        "date": "2021-08-03 14:03",
        "supply_id": -1,
        "emp_name": "系统服务器",
        "remark": "测试直营订单退货接口",
        "products": [
            {
                "shenqing_count": "2.00000000",
                "shenqing_amount": "42.00",
                "shenqing_price": "21.00000000",
                "rel_remark": "测试直营订单退货接口",
                "product_code": "662_MZ_Master_01",
                "confirm_count": "2.00000000",
                "product_name": "662_MZ_Master_01",
                "unit_name": "箱",
                "order_detail_id": "",
                "is_gift": "N",
                "shenqing_input_unit": "4862203401633905967",
                "product_id": "7421053210327994503",
                "confirm_amount": "42.00"
            }
        ],
        "cm_code": "CUS000002",
        "ext_infos": [
            {
                "code": "ext_2112240123",
                "value": ""
            }
        ],
        "supply_name": "",
        "order_status": "DD_DSH",
        "receive_phone": "18569854561",
        "receive_name": "张三",
        "receive_tel": "02578946932",
        "id": 6107524931439186956,
        "order_type": "ZYGLTH",
        "emp_code": "intfadmin",
        "create_time": "2021-08-12 10:26",
        "change_back_reason_id": -1,
        "visit_implement_id": -1,
        "receive_addr": "江苏省南京市康缘智汇港",
        "cm_id": "8078723553496786531",
        "back_reason": "",
        "cm_name": "老杜的直营经销商",
        "consignment_date": "2021-08-12",
        "supply_code": "",
        "order_id": "7948284691295991321",
        "status": "1"
    },
    {
        "order_no": "DD20210803000030",
        "date": "2021-08-03 14:03",
        "supply_id": -1,
        "emp_name": "系统服务器",
        "remark": "测试直营订单退货接口",
        "products": [
            {
                "shenqing_count": "2.00000000",
                "shenqing_amount": "21.00",
                "shenqing_price": "21.00000000",
                "rel_remark": "测试直营订单退货接口",
                "product_code": "662_MZ_Master_01",
                "confirm_count": "2.00000000",
                "product_name": "662_MZ_Master_01",
                "unit_name": "箱",
                "order_detail_id": "",
                "is_gift": "N",
                "shenqing_input_unit": "4862203401633905967",
                "product_id": "7421053210327994503",
                "confirm_amount": "21.00"
            }
        ],
        "cm_code": "CUS000002",
        "ext_infos": [
            {
                "code": "ext_2112240123",
                "value": ""
            }
        ],
        "supply_name": "",
        "order_status": "DD_DSH",
        "receive_phone": "18569854561",
        "receive_name": "张三",
        "receive_tel": "02578946932",
        "id": 5165826807846570430,
        "order_type": "ZYGLTH",
        "emp_code": "intfadmin",
        "create_time": "2021-08-12 10:31",
        "change_back_reason_id": -1,
        "visit_implement_id": -1,
        "receive_addr": "江苏省南京市康缘智汇港",
        "cm_id": "8078723553496786531",
        "back_reason": "",
        "cm_name": "老杜的直营经销商",
        "consignment_date": "2021-08-12",
        "supply_code": "",
        "order_id": "7948284691295991321",
        "status": "1"
    },
    {
        "order_no": "DD20210428000003",
        "date": "2021-04-28 14:21",
        "supply_id": -1,
        "emp_name": "系统服务器",
        "remark": "测试直营订单退货接口",
        "products": [
            {
                "shenqing_count": "1.00000000",
                "shenqing_amount": "3.00",
                "shenqing_price": "3.00000000",
                "rel_remark": "测试直营订单退货接口",
                "product_code": "baiyin_meinianda_026",
                "confirm_count": "1.00000000",
                "product_name": "百事_美年达_葡萄味_2.5L",
                "unit_name": "袋",
                "order_detail_id": "",
                "is_gift": "N",
                "shenqing_input_unit": "6936228840570112101",
                "product_id": "5130759210739014375",
                "confirm_amount": "3.00"
            },
            {
                "shenqing_count": "1.00000000",
                "shenqing_amount": "3.00",
                "shenqing_price": "3.00000000",
                "rel_remark": "测试直营订单退货接口",
                "product_code": "baiyin_meinianda_027",
                "confirm_count": "1.00000000",
                "product_name": "百事_美年达_蜜桃味_2.5L",
                "unit_name": "箱",
                "order_detail_id": "",
                "is_gift": "N",
                "shenqing_input_unit": "6362931419429812568",
                "product_id": "9043401268045478811",
                "confirm_amount": "3.00"
            }
        ],
        "cm_code": "CUS000002",
        "ext_infos": [
            {
                "code": "ext_2112240123",
                "value": ""
            }
        ],
        "supply_name": "",
        "order_status": "DD_DSH",
        "receive_phone": "18569854561",
        "receive_name": "老杜的直营经销商",
        "receive_tel": "02578946932",
        "id": 7102018506706606280,
        "order_type": "ZYGLTH",
        "emp_code": "intfadmin",
        "create_time": "2021-08-12 10:46",
        "change_back_reason_id": -1,
        "visit_implement_id": -1,
        "receive_addr": "江苏省南京市康缘智汇港",
        "cm_id": "8078723553496786531",
        "back_reason": "",
        "cm_name": "老杜的直营经销商",
        "consignment_date": "2021-08-12",
        "supply_code": "",
        "order_id": "5692740992502705111",
        "status": "1"
    }
]

参数说明：

参数	类型	必填	说明
id	INT8	否	退款单ID
status	VARCHAR(32)	否	0：已删除，1：正常
order_no	VARCHAR(32)	否	退货订单号
cm_code	VARCHAR(32)	否	客户编码
supply_code	VARCHAR(32)	否	供货商编码。直营退货订单供货商为空
supply_id	INT	否	供货商id。-1为直营退货订单，其他为分销退货订单
date	VARCHAR(32)	否	下单时间。格式：yyyy-mm-dd hh:mm
order_type	VARCHAR(32)	否	订单类型。1：退货订单，2：换入订单
order_status	VARCHAR(32)	否	订单状态。DD_DSH、待收货，DD_YWC：已完成，DD_DQR：待确认，DD_YQX：已取消，DD_YQR：已确认
order_id	VARCHAR(32)	否	关联订单ID
emp_code	VARCHAR(32)	否	业务员编码
consignment_date	VARCHAR(32)	否	交货日期。格式：yyyy-mm-dd
receive_name	VARCHAR(100)	否	收货人名称
receive_tel	VARCHAR(32)	否	收货人手机
receive_phone	VARCHAR(32)	否	收货人电话
receive_addr	VARCHAR(1000)	否	收货地址
remark	text	否	订单单据头备注
back_reason	VARCHAR(32)	否	退货原因名称
visit_implement_id	INT8	否	拜访ID
products.product_id	VARCHAR(32)	否	商品id
products.product_code	VARCHAR(100)	否	商品编码
products.shenqing_price	numeric(18,8)	否	退货单价
products.shenqing_count	numeric(18,8)	否	申请数量
products.confirm_count	numeric(18,8)	否	确认数量
products.shenqing_input_unit	VARCHAR(32)	是	退货单位id
products.unit_name	VARCHAR(32)	否	退货单位名称
products.shenqing_amount	numeric(18,2)	否	退货申请金额
products.confirm_amount	numeric(18,2)	否	退货确认金额
products.is_gift	VARCHAR(10)	否	是否是赠品。1：是，0：否。
products.rel_remark	text	否	订单子表的备注
products.order_detail_id	VARCHAR(32)	否	关联订单退货的订单明细id
ext_infos.code	VARCHAR(4000)	否	退货订单主信息扩展字段key值扩展字段需先在我方系统中创建
ext_infos.value	VARCHAR(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接
create_time	TIMESTAMP	否	单据提交时间。格式：yyyy-mm-dd hh24:mi:ss.us
modify_time	TIMESTAMP	否	单据最近一次变更时间。格式：yyyy-mm-dd hh24:mi:ss.us

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