API开放平台

TIP

新增兑换货物数据
审批兑换货物数据
查询兑换货物数据

# 新增兑换货物数据

请求方式： 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	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)	否	勤策中id
cm_id	VARCHAR(32)	否	勤策客户唯一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)	是	备注
visit_implement_id	INT8	是	高级拜访id
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值对多个选项值，以“,”分隔拼接
recycling_name	varchar1000	否	回收物料
recycling_unit	varchar1000	否	回收数量（含单位）
details	List	是	商品信息
details.product_id	int8	是	商品id
details.product_name	varchar(4000)	是	商品名称
details.product_code	varchar(4000)	是	商品编码
details.product_source_code	varchar(4000)	是	商品对应sourcecode
details.product_pictures	varchar(4000)	是	商品图片（多个用逗号分割）
details.product_spec	varchar(1000)	是	商品规格属性
details.cost_amount	numeric(10,8)	是	成本金额
details.cost_price	numeric(10,8)	是	成本单价
details.input_unit	INT8	是	录入单位id
details.input_unit_name	VARCHAR(100)	是	录入单位名称
details.base_unit	INT8	是	商品基本单位id
details.base_unit_name	VARCHAR(100)	是	商品基本单位名称
details.base_num	numeric(10,8)	是	数量转化成基本单位以后的数量
details.input_num	numeric(10,2)	是	录入单位数量
details.activity_id	int8	是	活动id
details.activity_name	varchar4000	是	活动名称

← 调拨数据推送兑换数据同步 →