# 采购管理接口

# 查询采购单数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/esssPurchaseStock/v1/queryEsssPurchaseStock/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例:

{
    "page_number": 1,
    "code":"GJ201804230003",
	"status":"1",
	"create_date":"2018-04-23",
	"modify_date":"2018-04-23"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
status CHAR(1) 记录状态:0 已删除 1 正常
code VARCHAR(32) 单据编码
emp_id VARCHAR(32) 勤策(原外勤365)经办人唯一ID
emp_code VARCHAR(32) 经办人编码,有效字符详见附录:有效字符说明 (opens new window)
create_date VARCHAR(32) 创建日期。格式:yyyy-MM-dd
modify_date VARCHAR(32) 修改日期。格式:yyyy-MM-dd
after_create_date VARCHAR(32) 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date VARCHAR(32) 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
start_create_date VARCHAR(32) 开始创建时间。格式:yyyy-MM-dd HH:mm:ss
end_create_date VARCHAR(32) 结束创建时间。格式:yyyy-MM-dd HH:mm:ss
start_modify_date VARCHAR(32) 开始修改时间。格式:yyyy-MM-dd HH:mm:ss
end_modify_date VARCHAR(32) 结束修改时间。格式:yyyy-MM-dd HH:mm:ss

响应示例:

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

数据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",
       		"modifyTimeStr": "2022-01-06 20:00:54.849000"
    }
]

参数说明:

参数 类型 必填 说明
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格式
modifyTimeStr VARCHAR(100) 修改时间,yyyy-mm-dd hh24:mi:ss.us格式
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

# 查询采购退货单数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/esssPurchaseReturn/v1/queryEsssPurchaseReturn/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例:

{
    "page_number": 1,
    "code":"GT201804230005",
	"status":"1",
	"create_date":"2018-04-23",
	"modify_date":"2018-04-23"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
status CHAR(1) 记录状态。0:已删除,1:正常
code VARCHAR(32) 单据编码
emp_id VARCHAR(32) 勤策(原外勤365)经办人唯一ID
emp_code VARCHAR(32) 经办人编码,有效字符详见附录:有效字符说明 (opens new window)
create_date VARCHAR(32) 创建日期。格式:yyyy-MM-dd
modify_date VARCHAR(32) 修改日期。格式:yyyy-MM-dd
after_create_date VARCHAR(32) 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date VARCHAR(32) 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
start_create_date VARCHAR(32) 开始创建时间。格式:yyyy-MM-dd HH:mm:ss
end_create_date VARCHAR(32) 结束创建时间。格式:yyyy-MM-dd HH:mm:ss
start_modify_date VARCHAR(32) 开始修改时间。格式:yyyy-MM-dd HH:mm:ss
end_modify_date VARCHAR(32) 结束修改时间。格式:yyyy-MM-dd HH:mm:ss

响应示例:

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

数据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": "",
         		"modifyTimeStr": "2022-01-06 20:00:54.849000"

    }
]

参数说明:

参数 类型 必填 说明
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
modifyTimeStr VARCHAR(100) 修改时间,yyyy-mm-dd hh24:mi:ss.us格式
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) 排序号

# 新增采购单数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/esssPurchaseStock/v1/addEsssPurchaseStock/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "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"
        }
    ]
}
      
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
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 List 列表
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) 录入单位名称

接口说明:如果该商品是赠品,is_gift必须传1。未免出错,这个字段建议必填

响应示例:

{
    "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/esssPurchaseReturn/v1/addEsssPurchaseReturn/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "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"
        }
    ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
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 List 列表
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) 录入单位名称

响应示例:

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

数据DATA示例:

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

参数说明:

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

# 审批采购单数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/esssPurchaseStock/v1/verifyEsssPurchaseStock/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "id": "5330928848218178297",
    "modifyTime": "",
    "cancelRe": ""
} 
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
id int8 采购单id
modifyTime VARCHAR(100) 采购时间戳。格式:yyyy-MM-dd HH:mm:ss
reason VARCHAR(4000) 审批意见

响应示例:

{
    "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/esssPurchaseReturn/v1/verifyEsssPurchaseReturn/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "id": "7823569520472976852",
    "modifyTime": "",
    "cancelRe": ""
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
id int8 采购退货单id
modifyTime VARCHAR(100) 采购退货时间戳。格式:yyyy-MM-dd HH:mm:ss
reason VARCHAR(4000) 审批意见

响应示例:

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

参数说明:

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码。0:成功,1:失败
return_msg VARCHAR(100) 响应说明