开放接口API说明-采购单相关接口

参数名称 参数值
应用编码 esssPurchaseStock
应用版本 v1
接口名称 查询采购单
接口编码 queryEsssPurchaseStock
接口URL https://openapi.waiqin365.com/api/esssPurchaseStock/v1/queryEsssPurchaseStock/{openid}/{timestamp}/{digest}/{msg_id}
请求信息 参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
status CHAR(1) 记录状态:0 已删除 1 正常
code VARCHAR(32) 单据编码
emp_id VARCHAR(32) 外勤365经办人唯一ID
emp_code VARCHAR(32) 经办人编码,有效字符详见附录:编码类型参照表
create_date TIMESTAMP 创建日期,格式:“yyyy-MM-dd”
modify_date TIMESTAMP 修改日期,格式:“yyyy-MM-dd”
after_create_date TIMESTAMP 创建时间之后,格式:“yyyy-MM-dd HH:mm:ss”
after_modify_date TIMESTAMP 修改时间之后,格式:“yyyy-MM-dd HH:mm:ss”
start_create_date TIMESTAMP 开始创建时间,格式:“yyyy-MM-dd HH:mm:ss”
end_create_date TIMESTAMP 结束创建时间,格式:“yyyy-MM-dd HH:mm:ss”
start_modify_date TIMESTAMP 开始修改时间,格式:“yyyy-MM-dd HH:mm:ss”
end_modify_date 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:正常
code VARCHAR(100) 采购单编号
date VARCHAR(10) 业务日期,yyyy-mm-dd hh24:mi:ss格式
create_id int8 创建人id
create_code VARCHAR(100) 创建人编码
create_name VARCHAR(100) 创建人名称
create_source_code VARCHAR(100) 创建人sourcecode
emp_id INT8 经办人id
emp_code VARCHAR(100) 经办人编码
emp_name VARCHAR(100) 经办人名称
emp_source_code VARCHAR(100) 经办人sourcecode
confirm_status VARCHAR(2) 单据状态:0:待确认,1:已确认,2:打回
supplier INT8 供应商id
supplier_code VARCHAR(100) 供应商编码
supplier_name VARCHAR(100) 供应商名称
storehouse INT8 仓库id
storehouse_code VARCHAR(100) 仓库编码
storehouse_name VARCHAR(100) 仓库名称
total_amount numeric(20,2) 合计金额
discount_mount numeric(20,2) 优惠金额
actual_amount numeric(20,2) 优惠后金额
remark VARCHAR(4000) 备注
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) 打回或者审批通过的原因
write_off_status VARCHAR(2) 付款核销状态 0、未付款,1、已付款
write_off_amount NUMERIC(10,2) 核销付款金额
prod_num NUMERIC(15) 采购进货的商品的数量
total_num NUMERIC(20,8) 合计数量,所有商品采购数量的合计全部是基本单位合计
is_enable VARCHAR(2) 是否作废1、正常,0、作废
free_taxrate char(1) 是否免税1:免税 0:不免税
print_count VARCHAR(2) 打印次数
transfer_stock_id int8 转单id对应ic_esss_stock_bas中id
transfer_stock_code VARCHAR(200) 转单id对应ic_esss_stock_bas中code
stock_type VARCHAR(2) 采购单类型
prods[].product_id int8 商品id
prods[].product_name VARCHAR(4000) 商品名称
prods[].product_code VARCHAR(4000) 商品编码
prods[].product_source_code VARCHAR(4000) 商品对应sourcecode
prods[].price numeric(20,8) 商品原价
prods[].stock_price numeric(20,8) 商品进货价,不含税的单价小数位固定为6位
prods[].num numeric(20,8) 进货数量
prods[].amount numeric(20,2) 进货金额
prods[].tax_rate numeric(20,2) 税率
prods[].tax_amount numeric(20,2) 税额
prods[].total_amount numeric(20,2) 价税合计金额
prods[].remark VARCHAR(4000) 备注
prods[].write_off_status VARCHAR(2) 付款核销状态 0、未付款,1、已付款
prods[].write_off_amount NUMERIC(20,2) 核销付款金额
prods[].cost_price numeric(20,8) 商品成本价
prods[].stock_price_tax numeric(20,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(20,8) 进货数量转化成基本单位的数量
prods[].is_gift VARCHAR(2) 是否是赠品1:是 0:否
prods[].sequ numeric(20,2) 排序号
prods[].transfer_stock_detail_id int8 转单的子表id对应ic_esss_stock_detail的id

请求消息体示例:
{
    "page_number": 1,
    "code":"GJ201804230003",
	"status":"1",
	"create_date":"2018-04-23",
	"modify_date":"2018-04-23"
}

响应信息示例:
{
	"msg_id": "X000001",
	"return_code": "0",
	"return_msg": "",
	"response_data": [{
		"confirm_emp_code": "scklb",
		"supplier_code": "DMS",
		"reason": "",
		"confirm_emp_source_code": "",
		"remark": "",
		"confirm_emp_name": "孙传宽老板测试账号",
		"prods": [{
			"total_amount": "7.02",
			"stock_price": "0.000000",
			"product_id": 4772998148884105941,
			"cost_price": "0.0000000",
			"is_gift": "N",
			"remark": "",
			"product_name": "scklb测试商品",
			"base_unit": 6326746269969128715,
			"product_source_code": "",
			"amount": "0.00",
			"write_off_status": "",
			"num": "0.0000000",
			"price": "0.000",
			"stock_price_tax": "0.000",
			"base_unit_name": "盒",
			"product_code": "100066",
			"tax_amount": "0.00",
			"write_off_amount": "0.00",
			"sequ": 0,
			"input_unit": 6326746269969128715,
			"input_unit_name": "盒",
			"base_unit_num": "0.0000000",
			"tax_rate": 0.17,
			"transfer_stock_detail_id": ""
		}],
		"create_name": "孙传宽老板测试账号",
		"date": "2018-04-23 00:00:00",
		"storehouse": 8314762429437112830,
		"transfer_stock_id": "",
		"actual_amount": "7.02",
		"id": 5330928848218178297,
		"write_off_status": "0",
		"total_num": "1.0000000",
		"storehouse_name": "sck测试仓库",
		"write_off_amount": "0.00",
		"storehouse_code": "CK00066",
		"stock_type": "1",
		"create_source_code": "",
		"supplier": 6692513571099135446,
		"total_amount": "7.02",
		"emp_code": "scklb",
		"status": "1",
		"prod_num": 1,
		"emp_id": 6730634712774216679,
		"supplier_name": "dms",
		"print_count": "",
		"code": "GJ201804230003",
		"transfer_stock_code": "",
		"is_enable": "0",
		"creator_id": 6730634712774216679,
		"emp_source_code": "",
		"free_taxrate": "0",
		"confirm_emp_id": "6730634712774216679",
		"emp_name": "孙传宽老板测试账号",
		"discount_mount": "0.00",
		"create_time": "2018-04-23 10:52:06",
		"create_code": "scklb",
		"confirm_status": "0",
		"confirm_time": "2018-04-23 10:52:16"
	}]
}
                  
参数名称 参数值
应用编码 esssPurchaseReturn
应用版本 v1
接口名称 查询采购单
接口编码 queryEsssPurchaseReturn
接口URL https://openapi.waiqin365.com/api/esssPurchaseReturn/v1/queryEsssPurchaseReturn/{openid}/{timestamp}/{digest}/{msg_id}
请求信息 参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
status CHAR(1) 记录状态:0 已删除 1 正常
code VARCHAR(32) 单据编码
emp_id VARCHAR(32) 外勤365经办人唯一ID
emp_code VARCHAR(32) 经办人编码,有效字符详见附录:编码类型参照表
create_date TIMESTAMP 创建日期,格式:“yyyy-MM-dd”
modify_date TIMESTAMP 修改日期,格式:“yyyy-MM-dd”
after_create_date TIMESTAMP 创建时间之后,格式:“yyyy-MM-dd HH:mm:ss”
after_modify_date TIMESTAMP 修改时间之后,格式:“yyyy-MM-dd HH:mm:ss”
start_create_date TIMESTAMP 开始创建时间,格式:“yyyy-MM-dd HH:mm:ss”
end_create_date TIMESTAMP 结束创建时间,格式:“yyyy-MM-dd HH:mm:ss”
start_modify_date TIMESTAMP 开始修改时间,格式:“yyyy-MM-dd HH:mm:ss”
end_modify_date 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:正常
code VARCHAR(100) 采购单编号
date VARCHAR(10) 业务日期,yyyy-mm-dd hh24:mi:ss格式
create_id int8 创建人id
create_code VARCHAR(100) 创建人编码
create_name VARCHAR(100) 创建人名称
create_source_code VARCHAR(100) 创建人sourcecode
emp_id INT8 经办人id
emp_code VARCHAR(100) 经办人编码
emp_name VARCHAR(100) 经办人名称
emp_source_code VARCHAR(100) 经办人sourcecode
confirm_status VARCHAR(2) 单据状态:0:待确认,1:已确认,2:打回
supplier INT8 供应商id
supplier_code VARCHAR(100) 供应商编码
supplier_name VARCHAR(100) 供应商名称
storehouse INT8 仓库id
storehouse_code VARCHAR(100) 仓库编码
storehouse_name VARCHAR(100) 仓库名称
total_amount numeric(20,2) 合计金额
discount_mount numeric(20,2) 优惠金额
actual_amount numeric(20,2) 优惠后金额
remark VARCHAR(4000) 备注
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) 打回或者审批通过的原因
write_off_status VARCHAR(2) 付款核销状态 0、未付款,1、已付款
write_off_amount NUMERIC(10,2) 核销付款金额
prod_num NUMERIC(15) 采购进货的商品的数量
total_num NUMERIC(20,8) 合计数量,所有商品采购数量的合计全部是基本单位合计
is_enable VARCHAR(2) 是否作废1、正常,0、作废
free_taxrate char(1) 是否免税1:免税 0:不免税
print_count VARCHAR(2) 打印次数
prods[].product_id int8 商品id
prods[].product_name VARCHAR(4000) 商品名称
prods[].product_code VARCHAR(4000) 商品编码
prods[].product_source_code VARCHAR(4000) 商品对应sourcecode
prods[].price numeric(20,8) 商品原价
prods[].return_price numeric(20,8) 商品退货价,不含税的单价小数位固定为6位
prods[].num numeric(20,8) 进货数量
prods[].amount numeric(20,2) 进货金额
prods[].tax_rate numeric(20,2) 税率
prods[].tax_amount numeric(20,2) 税额
prods[].total_amount numeric(20,2) 价税合计金额
prods[].remark VARCHAR(4000) 备注
prods[].write_off_status VARCHAR(2) 付款核销状态 0、未付款,1、已付款
prods[].write_off_amount NUMERIC(20,2) 核销付款金额
prods[].cost_price numeric(20,8) 商品成本价
prods[].return_price_tax numeric(20,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(20,8) 进货数量转化成基本单位的数量
prods[].sequ numeric(20,2) 排序号

请求消息体示例:
{
    "page_number": 1,
    "code":"GT201804230005",
	"status":"1",
	"create_date":"2018-04-23",
	"modify_date":"2018-04-23"
}

响应信息示例:
{
	"msg_id": "X000001",
	"return_code": "0",
	"return_msg": "",
	"response_data": [{
		"confirm_emp_code": "",
		"supplier_code": "8888",
		"reason": "",
		"confirm_emp_source_code": "",
		"remark": "",
		"confirm_emp_name": "",
		"prods": [{
			"total_amount": "14.04",
			"product_id": 4772998148884105941,
			"cost_price": "0.0000000",
			"remark": "",
			"product_name": "scklb测试商品",
			"base_unit": 6326746269969128715,
			"product_source_code": "",
			"amount": "0.00",
			"write_off_status": "0",
			"num": "0.0000000",
			"price": "0.000",
			"base_unit_name": "盒",
			"product_code": "100066",
			"tax_amount": "0.00",
			"write_off_amount": "0.00",
			"return_price": "0.000000",
			"sequ": 0,
			"input_unit": 6326746269969128715,
			"input_unit_name": "盒",
			"base_unit_num": "0.0000000",
			"tax_rate": 17,
			"return_price_tax": "0.000"
		}],
		"create_name": "孙传宽老板测试账号",
		"date": "2018-04-23 00:00:00",
		"storehouse": 8264934338091035956,
		"actual_amount": "14.04",
		"id": 7823569520472976852,
		"write_off_status": "0",
		"total_num": "2.0000000",
		"storehouse_name": "scklb测试仓库",
		"write_off_amount": "0.00",
		"storehouse_code": "CK0006",
		"create_source_code": "",
		"supplier": 5339744943654285740,
		"total_amount": "14.04",
		"emp_code": "scklb",
		"status": "1",
		"prod_num": 1,
		"emp_id": 6730634712774216679,
		"supplier_name": "scklbtest",
		"print_count": "",
		"code": "GT201804230005",
		"is_enable": "1",
		"creator_id": 6730634712774216679,
		"emp_source_code": "",
		"free_taxrate": "0",
		"confirm_emp_id": "",
		"emp_name": "孙传宽老板测试账号",
		"discount_mount": "0.00",
		"create_time": "2018-04-23 10:53:55",
		"create_code": "scklb",
		"confirm_status": "0",
		"confirm_time": ""
	}]
}
                  
参数名称 参数值
应用编码 esssPurchaseStock
应用版本 v1
接口名称 新增采购单
接口编码 addEsssPurchaseStock
接口URL https://openapi.waiqin365.com/api/esssPurchaseStock/v1/addEsssPurchaseStock/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
emp_code VARCHAR(100) 经办人编码,经办人编码和经办人名称必须传一个
emp_name VARCHAR(100) 经办人名称,经办人编码和经办人名称必须传一个
supplier_code VARCHAR(32) 供应商编码,供应商编码和供应商名称必须传一个
supplier_name VARCHAR(32) 供应商名称,供应商编码和供应商名称必须传一个
storehouse_code VARCHAR(32) 仓库编码,仓库编码和仓库名称必须传一个
storehouse_name VARCHAR(32) 仓库名称,仓库编码和仓库名称必须传一个
remark VARCHAR(4000) 备注
free_taxrate char(1) 是否免税1:免税 0:不免税
total_amount VARCHAR(32) 合计金额
discount_amount VARCHAR(32) 优惠金额
actual_amount VARCHAR(32) 优惠后金额
date VARCHAR(10) 单据日期,格式:“yyyy-MM-dd”
products[].product_code VARCHAR(100) 商品编码,商品编码和商品名称必须传一个
products[].product_name VARCHAR(100) 商品名称,商品编码和商品名称必须传一个
products[].is_gift VARCHAR(10) 是否是赠品,1:是0:否,不传就是非赠品
products[].stock_price numeric(20,8) 商品进货价
products[].stock_price_tax numeric(20,8) 含税单价
products[].num numeric(20,8) 进货数量
products[].amount numeric(20,2) 进货金额
products[].tax_amount numeric(20,2) 税额
products[].total_amount numeric(20,2) 价税合计金额
products[].remark VARCHAR(4000) 采购单子表的备注
products[].input_unit_name VARCHAR(100) 录入单位名称
响应信息 参照表响应信息格式
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) 保存成功以后返回单据编号

请求消息体示例:
{
    "emp_code": "smj_lb",
    "date": "2018-04-21",
    "supplier_code": "DMS",
    "storehouse_code": "CK0006",
    "remark": "sssss",
    "free_taxrate": "false",
    "total_amount": "14.04",
    "discount_amount": "0",
    "actual_amount": "14.04",
    "prods": [
        {
            "product_code": "100066",
            "input_unit_name": "盒",
            "num": "2",
            "stock_price": "6",
            "stock_price_tax": "7.02",
            "amount": "12",
            "tax_amount": "2.04",
            "total_amount": "14.04",
            "tax_rate": "17",
            "is_gift": "0"
        }
    ]
}


响应信息示例:
{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "X000001",
    "response_data": "{\"id\":\"6586695366524478985\",\"code\":\"GJ201611150001\"}"
}
                  
参数名称 参数值
应用编码 esssPurchaseReturn
应用版本 v1
接口名称 新增采购单
接口编码 addEsssPurchaseReturn
接口URL https://openapi.waiqin365.com/api/esssPurchaseReturn/v1/addEsssPurchaseReturn/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
emp_code VARCHAR(100) 经办人编码,经办人编码和经办人名称必须传一个
emp_name VARCHAR(100) 经办人名称,经办人编码和经办人名称必须传一个
supplier_code VARCHAR(32) 供应商编码,供应商编码和供应商名称必须传一个
supplier_name VARCHAR(32) 供应商名称,供应商编码和供应商名称必须传一个
storehouse_code VARCHAR(32) 仓库编码,仓库编码和仓库名称必须传一个
storehouse_name VARCHAR(32) 仓库名称,仓库编码和仓库名称必须传一个
remark VARCHAR(4000) 备注
free_taxrate char(1) 是否免税1:免税 0:不免税
total_amount VARCHAR(32) 合计金额
discount_amount VARCHAR(32) 优惠金额
actual_amount VARCHAR(32) 优惠后金额
date VARCHAR(10) 单据日期,格式:“yyyy-MM-dd”
products[].product_code VARCHAR(100) 商品编码,商品编码和商品名称必须传一个
products[].product_name VARCHAR(100) 商品名称,商品编码和商品名称必须传一个
products[].return_price numeric(20,8) 商品退货价,不含税的单价小数位固定为6位
products[].return_price_tax numeric(20,8) 商品退货含税价
products[].num numeric(20,8) 进货数量
products[].amount numeric(20,2) 进货金额
products[].tax_amount numeric(20,2) 税额
products[].total_amount numeric(20,2) 价税合计金额
products[].remark VARCHAR(4000) 采购单子表的备注
products[].input_unit_name VARCHAR(100) 录入单位名称
响应信息 参照表响应信息格式
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) 保存成功以后返回单据编号

请求消息体示例:
{
    "emp_code": "smj_lb",
    "date": "2018-04-21",
    "supplier_code": "DMS",
    "storehouse_code": "CK0006",
    "remark": "sssss",
    "free_taxrate": "false",
    "total_amount": "14.04",
    "discount_amount": "0",
    "actual_amount": "14.04",
    "prods": [
        {
            "product_code": "100066",
            "input_unit_name": "盒",
            "num": "2",
            "return_price": "6",
            "return_price_tax": "7.02",
            "amount": "12",
            "tax_amount": "2.04",
            "total_amount": "14.04",
            "tax_rate": "17"
        }
    ]
}


响应信息示例:
{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "X000001",
    "response_data": "{\"id\":\"6586695366524478985\",\"code\":\"GJT201611150001\"}"
}
                  
参数名称 参数值
应用编码 esssPurchaseStock
应用版本 v1
接口名称 审批退货单
接口编码 verifyEsssPurchaseStock
接口URL https://openapi.waiqin365.com/api/esssPurchaseStock/v1/verifyEsssPurchaseStock/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
id int8 采购单id
modifyTime VARCHAR(100) 采购时间戳,格式:“yyyy-MM-dd HH:mm:ss”
reason VARCHAR(4000) 审批意见
响应信息 参照表响应信息格式
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码:0成功 1失败
return_msg VARCHAR(100) 响应说明

请求消息体示例:
{
    "id": "5330928848218178297",
    "modifyTime": "",
    "cancelRe": ""
}


响应信息示例:
{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "X000001"
}
                  
参数名称 参数值
应用编码 esssPurchaseReturn
应用版本 v1
接口名称 审批退货单
接口编码 verifyEsssPurchaseReturn
接口URL https://openapi.waiqin365.com/api/esssPurchaseReturn/v1/verifyEsssPurchaseReturn/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
id int8 采购退货单id
modifyTime VARCHAR(100) 采购退货时间戳,格式:“yyyy-MM-dd HH:mm:ss”
reason VARCHAR(4000) 审批意见
响应信息 参照表响应信息格式
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码:0成功 1失败
return_msg VARCHAR(100) 响应说明

请求消息体示例:
{
    "id": "7823569520472976852",
    "modifyTime": "",
    "cancelRe": ""
}


响应信息示例:
{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "X000001"
}