API开放平台

TIP

# 新增调拨单数据

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

{
    "emp_code": "8007172427642688873",
    "prods": [
        {
            "prod_id": 1
        }
    ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
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 List 列表
products.num numeric(10,2) 是 调拨数量
products.input_unit varchar(32) 否 单位id，id和名称必须传一个
products.input_unit_name varchar(32) 否 单位名称，id和名称必须传一个
products.prod_id VARCHAR(100) 否 商品id，商品id和商品编码、名称必须传一个
products.prod_code VARCHAR(100) 否 商品编码，商品id和商品编码、名称必须传一个
products.prod_name VARCHAR(100) 否 商品名称，商品id和商品编码、名称必须传一个
products.from_goods_location VARCHAR(100) 否 调出货位1、正常品库， 2、 报废品库，3、处理品库（不传认为是正常品库）
products.to_goods_location VARCHAR(100) 否 调入货位1、正常品库， 2、 报废品库，3、处理品库（不传认为是正常品库）
products.remark VARCHAR(4000) 是 备注

响应示例：

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

数据DATA示例:

[
    {
        "id":"6586695366524478985",
        "code":"GJ201611150001"
    }
]

参数说明：

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

# 审批调拨单数据

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

{
    "id": "8007172427642688873",
    "oldModifyTime": "",
    "approvalType": "1",
    "reason": ""
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
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) 是 单据确认人名称

响应示例：

{
    "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/esssStoreHouseChange/v1/queryEsssStoreHouseChange/{ 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
emp_id VARCHAR(32) 否 勤策员工唯一ID
code VARCHAR(32) 否 调拨单号
emp_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
start_confirm_time VARCHAR(32) 否 确认时间开始。格式：yyyy-MM-dd HH:mm:ss
end_confirm_time VARCHAR(32) 否 确认时间结束。格式：yyyy-MM-dd HH:mm:ss

响应示例：

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

数据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": "",
        		"product_name": "测试分析报表与库存查询",
        		"actual_price": 20,
        		"product_source_code": "",
        		"amount": 20,
        		"product_spec": "250ml[XXL,红,圆领,小]",
        		"base_unit_num": 1,
        		"cost_price": "",
        		"detail_id": 6148882224973254157,
        		"base_unit": 7699482609897460490,
        		"product_pictures": "8958085892090750662/product/201709/5fa8bc64cbef4deb9a990d6494236303.jpg",
        		"num": 1,
        		"base_unit_name": "瓶",
        		"product_code": "CS001",
        		"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": "老板"
    }
]

参数说明：

参数 类型 必填 说明
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 List 列表
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.from_goods_location VARCHAR(100) 否 调出货位。1：正常品库，2：报废品库，3：处理品库（不传认为是正常品库）
prods.to_goods_location VARCHAR(100) 否 调入货位。1：正常品库，2：报废品库，3：处理品库（不传认为是正常品库）

← 调拨数据推送 →