API开放平台

TIP

采购单(esss_stock)相关数据的同步
采购退货单(esss_return)相关数据的同步

# 采购单(esss_stock)相关数据的同步

请求方式： POST（HTTPS）
请求地址： 第三方服务接口URL
请求示例：

{
	"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"
}

参数说明：

参数	类型	必填	说明
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	List
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

响应示例：

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001"
}

参数说明：

参数	说明
return_code	响应编码
return_msg	响应消息内容
msg_id	消息ID

# 采购退货单(esss_return)相关数据的同步

请求方式： POST（HTTPS）
请求地址： 第三方服务接口URL
请求示例：

{
	"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": ""
}

参数说明：

参数	类型	必填	说明
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	List	是
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)	是	排序号

响应示例：

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001"
}

参数说明：

参数	说明
return_code	响应编码
return_msg	响应消息内容
msg_id	消息ID

← 采购管理接口订单接口 →