开放接口API说明-进销存相关接口

参数名称 参数值
应用编码 esssExChangeProduct
应用版本 v1
接口名称 新增兑换货物
接口编码 addEsssExChangeProduct
接口URL https://openapi.waiqin365.com/api/esssExChangeProduct/v1/addEsssExChangeProduct/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
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[].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) 备注
响应信息 参照表响应信息格式
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码:0成功 1失败
return_msg VARCHAR(100) 响应说明
response_data.id VARCHAR(100) 保存成功以后返回数据id
response_data.exchange_no VARCHAR(100) 保存成功以后返回单据编号

请求消息体示例:
{
    "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"
}


响应信息示例:
{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "X000001",
    "response_data": "{\"id\":\"6586695366524478985\",\"exchange_no\":\"DH201611150001\"}"
}
                  
参数名称 参数值
应用编码 esssExChangeProduct
应用版本 v1
接口名称 审批兑换货物
接口编码 verifyEsssExChangeProduct
接口URL 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) 单据确认人名称
响应信息 参照表响应信息格式
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码:0成功 1失败
return_msg VARCHAR(100) 响应说明

请求消息体示例:
{
    "id": "8007172427642688873",
    "modifyTimes": "",
    "verifyType": "1",
    "reason": ""
}


响应信息示例:
{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "X000001"
}
                  
参数名称 参数值
应用编码 esssExChangeProduct
应用版本 v1
接口名称 查询兑换货物
接口编码 queryEsssExChangeProduct
接口URL https://openapi.waiqin365.com/api/esssExChangeProduct/v1/queryEsssExChangeProduct/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
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) 客户编码,有效字符详见附录:编码类型参照表
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 TIMESTAMP 创建时间开始,格式:“yyyy-MM-dd”
end_create_date TIMESTAMP 创建时间结束,格式:“yyyy-MM-dd”
start_modify_date TIMESTAMP 修改时间开始,格式:“yyyy-MM-dd”
end_modify_date TIMESTAMP 修改时间结束,格式:“yyyy-MM-dd”
响应信息 参照表响应信息格式
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码:0成功 1失败
return_msg VARCHAR(100) 响应说明
response_data VARCHAR(32) 响应数据体[{......}]
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[].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) 录入单位数量

请求消息体示例:
{
	"id":"7992869671049732483",
	"status":"1",
	"cm_id":"6563654583404943994",
	"cm_code":" DD000201700290",
	"create_date":"2017-08-16",
	"modify_date":"2017-08-16"
}


响应信息示例:
{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "X000001",
    "response_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"
}]
}