# 新增兑换货物数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/esssExChangeProduct/v1/addEsssExChangeProduct/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "cm_code": "8007172427642688873",
    "emp_code": "smj_lb",
    "return_date": "2017-08-25",
    "prods": [
        {
            "product_id": 1,
            "remark": "子表备注",
            "return_amount": "2",
            "product_code": "SMJ123",
            "return_price": "1",
            "sequ": "0",
            "return_count": "2",
            "input_unit": "7911475397642389622"
        },
        {
            "product_id": 1,
            "remark": "子表备注2",
            "return_amount": "3",
            "product_code": "SMJ123",
            "return_price": "1",
            "sequ": "0",
            "return_count": "3",
            "input_unit": "7911475397642389622"
        }
    ],
    "emp_id": "1",
    "cm_id": "8279858127296441724",
    "storehouse_code": "SMJ0001",
    "storehouse_id": "DD000201700290"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
cm_id INT8 客户id,客户id和客户编码、名称必须传一个
cm_code VARCHAR(100) 客户编码,客户id和客户编码、名称必须传一个
cm_name VARCHAR(100) 客户名称,客户id和客户编码、名称必须传一个
business_name INT8 业务名称
creator_id INT8 创建人Id
creator_code VARCHAR(32) 创建人编码
creator_name VARCHAR(32) 创建人名称
car_id INT8 车辆id,id和车辆编码、名称必须传一个
car_code VARCHAR(32) 车辆编码,id和车辆编码、名称必须传一个
car_name VARCHAR(32) 车辆名称,id和车辆编码、名称必须传一个
num numeric(10,2) 兑换数量
unit varchar(32) 单位id
unit_name varchar(32) 单位名称
exts List 扩展字段列表
exts.ext_key varchar(100) 扩展字段key值, 退货信息扩展字段需先在我方系统中创建
exts.ext_value VARCHAR(4000) 扩展字段value值对多个选项值,以“,”分隔拼接
prod_id VARCHAR(100) 商品id,商品id和商品编码、名称必须传一个
prod_code VARCHAR(100) 商品编码,商品id和商品编码、名称必须传一个
prod_name VARCHAR(100) 商品名称,商品id和商品编码、名称必须传一个
remark VARCHAR(4000) 备注

响应示例:

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

数据DATA示例:

[
    {
        "id":"6586695366524478985",
        "exchange_no":"DH201611150001"
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(100) 保存成功以后返回数据id
exchange_no VARCHAR(100) 保存成功以后返回单据编号

# 审批兑换货物数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/esssExChangeProduct/v1/verifyEsssExChangeProduct/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "id": "8007172427642688873",
    "modifyTimes": "",
    "verifyType": "1",
    "reason": ""
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
id VARCHAR(100) 兑换货物id,多个值用“,”分割
verifyType VARCHAR(100) 审批类型。1:通过,2:打回,3:作废,4:红冲
modifyTimes VARCHAR(100) 时间戳,多个逗号分割
reason VARCHAR(4000) 审批意见
confirm_emp_id INT8 单据确认人id
confirm_emp_code VARCHAR(100) 单据确认人编码
confirm_emp_name VARCHAR(100) 单据确认人名称

响应示例:

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

参数说明:

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

# 查询兑换货物数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/esssExChangeProduct/v1/queryEsssExChangeProduct/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
	"id":"7992869671049732483",
	"status":"1",
	"cm_id":"6563654583404943994",
	"cm_code":" DD000201700290",
	"create_date":"2017-08-16",
	"modify_date":"2017-08-16"
}

参数说明:

参数 类型 必填 说明
page_number INT8 页码默认1,每页默认1000条
status CHAR(1) 记录状态。0:已删除,1:正常
id VARCHAR(32) 勤策(原外勤365)中id
cm_id VARCHAR(32) 勤策(原外勤365)客户唯一ID
exchange_no VARCHAR(32) 兑换货物单号
cm_code VARCHAR(32) 客户编码,有效字符详见附录:有效字符说明 (opens new window)
create_date CHAR(10) 创建日期。格式:yyyy-MM-dd
modify_date CHAR(10) 修改日期。格式:yyyy-MM-dd
after_create_date CHAR(10) 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date CHAR(10) 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
start_create_date VARCHAR(32) 创建时间开始。格式:yyyy-MM-dd
end_create_date VARCHAR(32) 创建时间结束。格式:yyyy-MM-dd
start_modify_date VARCHAR(32) 修改时间开始。格式:yyyy-MM-dd
end_modify_date VARCHAR(32) 修改时间结束。格式:yyyy-MM-dd

响应示例:

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

数据DATA示例:

[
    {
       "confirm_emp_code": "zhaowei",
       	"reason": "",
       	"remark": "",
       	"prod_id": 6820193915171868116,
       	"confirm_emp_name": "赵伟测试",
       	"car_code": "不要该这个",
       	"prod_code": "50002",
       	"cm_source_code": "",
       	"prod_source_code": "",
       	"modifyier_name": "赵伟测试",
       	"modify_time": "2017-07-21 10:03:57",
       	"base_unit_num": "0.0000000",
       	"cm_name": "婆婆",
       	"prod_name": "探路者冲锋衣",
       	"activity_id": "",
       	"cost_price": "0.000",
       	"status": "1",
       	"activity_name": "",
       	"car_name": "苏A888888",
       	"modifyier_id": 8853149192864844220,
       	"is_enable": "0",
       	"creator_id": 5631794108288395727,
       	"base_unit": 6195869047750703128,
       	"ext_1609280009": "",
       	"hc_id": "",
       	"product_pictures": "",
       	"cost_amount": "0.00",
       	"confirm_emp_id": 8853149192864844220,
       	"base_unit_name": "杯",
       	"create_time": "2017-07-15 15:13:29",
       	"exchange_no": "DH201707150013",
       	"creator_name": "老板",
       	"creator_code": "cclb",
       	"input_unit": 6195869047750703128,
       	"input_unit_name": "杯",
       	"visit_implement_id": 8715578011064086034,
       	"car_id": 6334057575758944437,
       	"cm_id": 7546721366701522926,
       	"pictures": "",
       	"input_num": 1,
       	"cm_code": "DD000201707609",
       	"id": 6380514181463778338,
       	"hc_status": "",
       	"modifyier_code": "zhaowei",
       	"submit_dept_id": 8444424302574007122,
       	"business_id": 4,
       	"product_spec": "50001",
       	"submit_dept_name": "部门一",
       	"confirm_source_code": "",
       	"base_num": 1,
       	"business_name": "业务类型4",
       	"exts": [{
       		"ext_key": "流水号",
       		"ext_value": ""
       	}, {
       		"ext_key": "奖券数量",
       		"ext_value": "8"
       	}, {
       		"ext_key": "客户名称",
       		"ext_value": ""
       	}, {
       		"ext_key": "业务类型",
       		"ext_value": ""
       	}, {
       		"ext_key": "商品名称",
       		"ext_value": ""
       	}, {
       		"ext_key": "数瓶盖",
       		"ext_value": "123"
       	}, {
       		"ext_key": "兑换数量",
       		"ext_value": ""
       	}, {
       		"ext_key": "多行瓶盖",
       		"ext_value": "测多行"
       	}, {
       		"ext_key": "基本单位兑换数量",
       		"ext_value": ""
       	}, {
       		"ext_key": "报表单位兑换数量",
       		"ext_value": ""
       	}, {
       		"ext_key": "日期",
       		"ext_value": ""
       	}, {
       		"ext_key": "仓库",
       		"ext_value": ""
       	}, {
       		"ext_key": "红冲状态",
       		"ext_value": ""
       	}, {
       		"ext_key": "时间",
       		"ext_value": ""
       	}, {
       		"ext_key": "审批状态",
       		"ext_value": ""
       	}, {
       		"ext_key": "提交人",
       		"ext_value": "5631794108288395727"
       	}, {
       		"ext_key": "单选瓶盖",
       		"ext_value": "我"
       	}, {
       		"ext_key": "提交时间",
       		"ext_value": ""
       	}, {
       		"ext_key": "下拉选择框",
       		"ext_value": ""
       	}, {
       		"ext_key": "备注",
       		"ext_value": ""
       	}, {
       		"ext_key": "拍照",
       		"ext_value": ""
       	}, {
       		"ext_key": "人员单选",
       		"ext_value": ""
       	}, {
       		"ext_key": "客户单选",
       		"ext_value": ""
       	}, {
       		"ext_key": "商品单选框",
       		"ext_value": ""
       	}, {
       		"ext_key": "定位",
       		"ext_value": "{\"latlonType\":\"2\",\"latlon\":\"31.983671,118.7308\",\"addr\":\"江苏省南京市建邺区康文路康缘智汇港附近\",\"province\":\"江苏省\",\"city\":\"南京市\",\"area\":\"建邺区\",\"street\":\"康文路\",\"locateLie\":\"false\"}"
       	}, {
       		"ext_key": "日期时间",
       		"ext_value": "2017-07-15 15:12"
       	}],
       	"num": "0.0000000",
       	"dept_source_code": "",
       	"confirm_status": "0",
       	"submit_dept_code": "001",
       	"hc_no": "",
       	"submit_time": "2017-07-15 15:13:29"
    }
]

参数说明:

参数 类型 必填 说明
id INT8 兑换货物ID
status VARCHAR(1) 订单状态。0:已删除 1:正常
confirm_status VARCHAR(1) 审批状态。0:待确认,1:已确认,2:打回
is_enable VARCHAR(1) 是否作废。0:已作废,1:未作废
submit_time varchar(10) 提交时间。格式:yyyy-mm-dd hh24:mi:ss
submit_dept_id int8 业务员下单时候所在的部门id
submit_dept_code VARCHAR(100) 业务员下单时候所在的部门编码
submit_dept_name VARCHAR(100) 业务员下单时候所在的部门名称
dept_source_code VARCHAR(100) 部门sourcecode
creator_id INT8 创建人id
creator_code VARCHAR(100) 创建人编码
creator_name VARCHAR(100) 创建人名称
create_time VARCHAR(32) 创建时间。格式:yyyy-mm-dd hh24:mi:ss
modifyier_id INT8 修改人id
modifyier_code VARCHAR(100) 修改人编码
modifyier_name VARCHAR(100) 修改人名称
modify_time VARCHAR(32) 修改时间。格式:yyyy-mm-dd hh24:mi:ss
cm_id INT8 客户id
cm_code VARCHAR(100) 客户编码
cm_name VARCHAR(100) 客户名称
cm_source_code VARCHAR(100) 客户sourcecode
car_id Int8 车辆id
car_code VARCHAR(100) 车辆编号
car_name VARCHAR(100) 车辆名称
exchange_no VARCHAR(100) 流水号
business_id int8 业务类型id
business_name varchar(1000) 业务类型名称
confirm_emp_id INT8 单据确认人id
confirm_emp_code VARCHAR(100) 单据确认人编码
confirm_emp_name VARCHAR(100) 单据确认人名称
confirm_source_code VARCHAR(100) 单据确认人sourcecode
confirm_time VARCHAR(100) 确认时间。格式:yyyy-mm-dd hh24:mi:ss
reason varchar(4000) 原因
remark varchar(4000) 备注
activity_id int8 活动id
visit_implement_id INT8 高级拜访id
activity_name varchar4000 活动名称
print_count varchar(2) 打印次数
hc_status varchar(2) 0:未红冲,1:被红冲,2:红冲单
hc_id int8 对应红冲单id
hc_no varchar1000 对应红冲单号
exts List 兑换主信息扩展字段列表
exts.ext_key varchar(4000) 兑换主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接
product_id int8 商品id
product_name varchar(4000) 商品名称
product_code varchar(4000) 商品编码
product_source_code varchar(4000) 商品对应sourcecode
product_pictures varchar(4000) 商品图片(多个用逗号分割)
product_spec varchar(1000) 商品规格属性
cost_amount numeric(10,8) 成本金额
cost_price numeric(10,8) 成本单价
input_unit INT8 录入单位id
input_unit_name VARCHAR(100) 录入单位名称
base_unit INT8 商品基本单位id
base_unit_name VARCHAR(100) 商品基本单位名称
base_num numeric(10,8) 数量转化成基本单位以后的数量
input_num numeric(10,2) 录入单位数量