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

参数名称 参数值
应用编码 esssStoreHouseChange
应用版本 v1
接口名称 新增调拨单
接口编码 addEsssStoreHouseChange
接口URL https://openapi.waiqin365.com/api/esssStoreHouseChange/v1/addEsssStoreHouseChange/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
date VARCHAR(32) 单据日期,yyyy-mm-dd格式
creator_id INT8 创建人Id
creator_code VARCHAR(32) 创建人编码
creator_name VARCHAR(32) 创建人名称
empid INT8 经办人Id
emp_code VARCHAR(32) 经办人编码
emp_name VARCHAR(32) 经办人名称
from_storehouse INT8 id,调出仓库id和编码、名称必须传一个
from_storehouse_code VARCHAR(32) 编码,调出仓库id和编码、名称必须传一个
from_storehouse_name VARCHAR(32) 名称,调出id和编码、名称必须传一个
to_storehouse INT8 id,调入仓库id和编码、名称必须传一个
to_storehouse_code VARCHAR(32) 编码,调入仓库id和编码、名称必须传一个
to_storehouse_name VARCHAR(32) 名称,调入id和编码、名称必须传一个
remark VARCHAR(32) 名称,调入id和编码、名称必须传一个
products[].num numeric(10,2) 调拨数量
products[].enable_num numeric(10,2) 正常调拨数量
products[].return_num numeric(10,2) 退货调拨数量
products[].change_num numeric(10,2) 换货调拨数量
products[].input_unit varchar(32) 单位id
products[].enable_input_unit varchar(32) 正常单位id
products[].return_input_unit varchar(32) 退货单位id
products[].change_input_unit varchar(32) 换货单位id
products[].input_unit_name varchar(32) 单位名称
products[].enable_unit_name varchar(32) 正常单位名称
products[].return_unit_name varchar(32) 退货单位名称
products[].change_unit_name varchar(32) 换货单位名称
products[].prod_id VARCHAR(100) 商品id,商品id和商品编码、名称必须传一个
products[].prod_code VARCHAR(100) 商品编码,商品id和商品编码、名称必须传一个
products[].prod_name VARCHAR(100) 商品名称,商品id和商品编码、名称必须传一个
prods[].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.code 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\",\"code\":\"GJ201611150001\"}"
}
                  
参数名称 参数值
应用编码 esssStoreHouseChange
应用版本 v1
接口名称 审批调拨单
接口编码 verifyEsssStoreHouseChange
接口URL https://openapi.waiqin365.com/api/esssStoreHouseChange/v1/verifyEsssStoreHouseChange/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
id VARCHAR(100) 调拨单id,多个逗号分割
approvalType VARCHAR(100) 审批类型 1:通过,2:作废
oldModifyTime 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",
    "oldModifyTime": "",
    "approvalType": "1",
    "reason": ""
}


响应信息示例:
{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "X000001"
}
                  
参数名称 参数值
应用编码 esssStoreHouseChange
应用版本 v1
接口名称 查询调拨单
接口编码 queryEsssStoreHouseChange
接口URL https://openapi.waiqin365.com/api/esssStoreHouseChange/v1/queryEsssStoreHouseChange/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
page_number INT8 页码默认1,每页默认1000条
status CHAR(1) 记录状态:0 已删除 1 正常
id VARCHAR(32) 外勤365中id
emp_id VARCHAR(32) 外勤365员工唯一ID
code VARCHAR(32) 调拨单号
emp_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”
start_confirm_time TIMESTAMP 确认时间开始,格式:“yyyy-MM-dd HH:mm:ss”
end_confirm_time TIMESTAMP 确认时间结束,格式:“yyyy-MM-dd HH:mm:ss”
响应信息 参照表响应信息格式
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、未作废)
code VARCHAR(100) 调拨单编号
date 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
submit_emp_id INT8 单据上报人id
submit_emp_code VARCHAR(100) 单据上报人编码
submit_emp_name VARCHAR(100) 单据上报人名称
emp_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格式
prod_num numeric(10,2) 品种数
total_count numeric(10,2) 调拨总数量
total_amount numeric(10,2) 调拨总金额
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) 备注
from_storehouse INT8 调出仓库id
from_storehouse_code VARCHAR(100) 调出仓库编号
from_storehouse_name VARCHAR(100) 调出仓库名称
from_storehouse_type VARCHAR(2) 调出仓库类型:1:仓库,2:车辆
to_storehouse INT8 调入仓库id
to_storehouse_code VARCHAR(100) 调入仓库编号
to_storehouse_name VARCHAR(100) 调入仓库名称
to_storehouse_type VARCHAR(2) 调入仓库类型:1:仓库,2:车辆
print_count varchar(2) 打印次数
prods[].detail_id int8 订单子表id
prods[].product_id int8 商品id
prods[].product_name varchar(4000) 商品名称
prods[].product_code varchar(4000) 商品编码
prods[].product_source_code varchar(4000) 商品对应sourcecode
prods[].product_pictures varchar(4000) 商品图片(多个用逗号分割)
prods[].product_spec varchar(1000) 商品规格属性
prods[].actual_price numeric(10,8) 商品价格
prods[].cost_price numeric(10,8) 成本单价
prods[].amount numeric(10,8) 调拨金额
prods[].num numeric(10,8) 调拨录入数量
prods[].input_unit INT8 录入单位id
prods[].input_unit_name VARCHAR(100) 录入单位名称
prods[].base_unit INT8 商品基本单位id
prods[].base_unit_name VARCHAR(100) 商品基本单位名称
prods[].base_unit_num numeric(10,8) 数量转化成基本单位以后的数量
prods[].sequ varchar(2) 下单时的排序
prods[].remark varchar(4000) 备注
prods[].enable_num numeric(10,8) 调拨录入可销数量
prods[].enable_input_unit INT8 可销录入单位id
prods[].enable_input_unit_name VARCHAR(100) 可销录入单位名称
prods[].enable_base_unit_num numeric(10,8) 可销数量转化成基本单位以后的数量
prods[].return_num numeric(10,8) 调拨录入退货数量
prods[].return_input_unit INT8 退货录入单位id
prods[].return_input_unit_name VARCHAR(100) 退货录入单位名称
prods[].return_base_unit_num numeric(10,8) 退货数量转化成基本单位以后的数量
prods[].change_num numeric(10,8) 调拨录入换货数量
prods[].change_input_unit INT8 换货录入单位id
prods[].change_input_unit_name VARCHAR(100) 换货录入单位名称
prods[].change_base_unit_num numeric(10,8) 换货数量转化成基本单位以后的数量

请求消息体示例:
{
	"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": [{
	"submit_emp_code": "cclb",
	"from_storehouse_code": "CK0124",
	"reason": "",
	"remark": "ffgg",
	"date": "2016-10-28",
	"from_storehouse": 8882351500685229884,
	"id": 5708030531123690463,
	"to_storehouse_code": "不要该这个",
	"modifyier_code": "cclb",
	"submit_emp_id": 5631794108288395727,
	"modifyier_name": "老板",
	"prods": [{
		"product_id": 7699482609897460489,
		"remark": "",
		"return_input_unit_name": "瓶",
		"enable_num": 1,
		"product_name": "测试分析报表与库存查询",
		"return_num": 0E-8,
		"actual_price": 20,
		"product_source_code": "",
		"amount": 20,
		"enable_input_unit": 7699482609897460490,
		"return_input_unit": 7699482609897460490,
		"return_base_unit_num": 0E-8,
		"change_input_unit_name": "瓶",
		"product_spec": "250ml[XXL,红,圆领,小]",
		"enable_base_unit_num": 1,
		"change_input_unit": 7699482609897460490,
		"base_unit_num": 1,
		"cost_price": "",
		"detail_id": 6148882224973254157,
		"change_num": 0E-8,
		"enable_input_unit_name": "瓶",
		"base_unit": 7699482609897460490,
		"product_pictures": "8958085892090750662/product/201709/5fa8bc64cbef4deb9a990d6494236303.jpg",
		"num": 1,
		"base_unit_name": "瓶",
		"product_code": "CS001",
		"change_base_unit_num": 0E-8,
		"sequ": "",
		"input_unit": 7699482609897460490,
		"input_unit_name": "瓶"
	}],
	"modify_time": "2016-11-28 10:32:25",
	"total_amount": "20.00",
	"status": "1",
	"prod_num": 1,
	"from_storehouse_name": "测试可销库存2",
	"to_storehouse": 6334057575758944437,
	"modifyier_id": 5631794108288395727,
	"code": "DB201610280006",
	"is_enable": "0",
	"total_count": "1.0000000",
	"creator_id": 5631794108288395727,
	"emp_source_code": "",
	"to_storehouse_name": "苏A888888",
	"create_time": "2016-10-28 16:50:45",
	"creator_name": "老板",
	"confirm_status": "0",
	"creator_code": "cclb",
	"submit_emp_name": "老板"
}]
}