API文档

finance.settle.Purchase.search（采购结算单查询）

¥标准

1.接口说明

1.1 接口描述：获取ERP采购结算单信息

1.2 适用版本：客户端 V1.2.2.8及以上版本

1.3 增量获取：支持

2.调用场景

2.1 举例说明：财务系统、SAP、线下ERP、数据分析等系统的对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	http://47.92.239.46/openapi
正式环境	http://wdt.wangdian.cn/openapi

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	sid	String	是	卖家账号, 由旺店通分配
接口账号	key	String	是	由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里
盐	salt	String	是	由旺店通分配appsecret，是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称	method	String	是	调用的接口名称
版本号	v	String	是	1.0
秒级时间戳	timestamp	int	是	秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名	sign	String	是	签名
分页大小	page_size	int	否	分页大小，分页查询必传
分页编号	page_no	int	否	分页编号，分页查询必传，标准接口page_no从0开始
是否计算查询结果的总条数	calc_total	int	否	是否计算查询结果的总条数, 需要计算则1, 否则填0

3.3 业务请求参数

名称	字段	类型	长度	必须	描述
查询参数	params	Map<String, Object>		Y	查询参数
分页	pager	Pager		Y	分页

params

名称	字段	类型	长度	必须	描述
仓库编号	warehouse_no	String	40	N	仓库编号
供应商编号	provider_no	String	20	N	供应商编号
采购员姓名	purchaser_name	String	50	N	采购员姓名
结算单号	settle_no	String	64	N	结算单号
采购单号	purchase_no	String	20	N	采购单号
结算单状态	status	Int	4	N	10:编辑中,20:待审核,30:已审核,40 已取消.不传默认显示全部.
创建起始时间	create_from	String	40	N	创建起始时间
创建结束时间	create_to	String	40	N	创建结束时间
修改开始时间	modified_from	String	40	N	修改开始时间
修改结束时间	modified_to	String	40	N	修改结束时间

pager

名称	字段	类型	长度	必须	描述
分页大小	page_size	Int	4	N	分页大小
页号	page_no	Int	4	N	从0开始

4.响应参数

名称	字段	类型	必须	描述
状态码	status	Int	否	0表示调用成功,在调用错误时候不返回该值。
错误信息	message	String	是	无错误信息不返回
单据数据	data	List<Map<String, Object>>	否	单据数据

data

响应参数说明示例值或者格式、具体含义、使用方法及注意事项（如隐私数据淘系平台不返回，其他平台正常返回）

名称	字段	类型	长度	必须	描述
单据数据	order	List<Map<String, Object>>		是	单据数据
总条数	total_count	Int		是	总条数

order

名称	字段	类型	长度	必须	描述
总税额	tax_amount	Decimal(19,4)		Y	总税额
物流公司名称	logistics_type_name	String	40	Y	物流公司名称，参考附录物流对照表
审核员	checker_name	String	40	Y	审核员
运费	post_fee	Decimal(19,4)		Y	运费
总金额	total_cost	Decimal(19,4)		Y	总金额
总货款	goods_amount	Decimal(19,4)		Y	总货款
创建时间	created	string	40	Y	创建时间
审核时间	check_time	string	40	Y	审核时间
发票号码	invoice_no	String	100	Y	发票号码
备注	remark	String	255	Y	备注
含税总货款	tax_goods_amount	Decimal(19,4)		Y	含税总货款
标记名称	flag_name	String	32	Y	标记名称
结算单号	settle_no	String	40	Y	结算单号
仓库编号	warehouse_no	String	40	Y	仓库编号
物流单号	logistics_no_list	String	40	Y	物流单号
分摊运费	is_share_post_fee	bool	1	Y	是否分摊运费 true：是 false：否
分摊其他费用	is_share_other	bool	1	Y	是否分摊其他费用 true：是 false：否
发票类型	invoice_type	Int	4	Y	0:无,1: 普通发票,2: 增值税发票,3: 专用增值税发票
采购单号	purchase_no	String	255	Y	采购单号
货品总数	goods_count	Decimal(19,4)		Y	货品总数
其他费用	other_total	Decimal(19,4)		Y	其他费用
入库单号	stockin_no	String	100	Y	入库单号
状态	status	Int	4	Y	状态
供应商编号	provider_no	String		Y	供应商编号
结算员	settler_name	String		Y	结算员
结算单详情	detail_list	List<Map<String, Object>>		Y	结算单详情

detail_list

名称	字段	类型	长度	必须	描述
换算系数	unit_ratio	Decimal(19,4)		Y	采购单位与基本单位之间的换算系数
结算数量	settle_num	Decimal(19,4)		Y	结算数量
开票数量	invoice_num	Decimal(19,4)		Y	开票数量
单价	price	Decimal(19,4)		Y	单价
折扣	discount	Decimal(19,4)		Y	折扣
税前折扣价	dis_price	Decimal(19,4)		Y	税前折扣价
税率	tax_rate	Decimal(19,4)		Y	税率
含税单价	tax_price	Decimal(19,4)		Y	含税单价
税额	total_tax_amount	Decimal(19,4)		Y	税额
货款	total_amount	Decimal(19,4)		Y	货款
分摊运费	share_post_fee	Decimal(19,4)		Y	分摊运费
含税货款	tax_total_amount	Decimal(19,4)		Y	含税货款
采购单号	purchase_no	String	20	Y	采购单号
货品名称	goods_name	String	255	Y	货品名称
货品编号	goods_no	String	40	Y	货品编号
规格码	spec_code	String	40	Y	规格码
规格名称	spec_name	String	100	Y	规格名称
商家编码	spec_no	String	40	Y	商家编码
条码	barcode	String	50	Y	条码
供应商货号	provider_goods_no	String	64	Y	供应商货号
备注	remark	String	128	Y	备注
创建时间	created	String	40	Y	创建时间
基本单位	unit_name	String	20	Y	基本单位
采购单位名称	purchase_unit_name	String	20	Y	采购单位名称
品牌名称	brand_name	String	64	Y	品牌名称

5.请求示例

Json格式请求报文	[{"warehouse_no":"1001" }]
PHP	<?php header("Content-Type: text/html; charset=UTF-8"); require_once('wdtsdk.php'); $client = new WdtErpClient("url", "wdtapi3", "appkey", "secret"); $parMap = new stdClass(); $parMap->warehouse_no = "1001"; $pager = new Pager(1, 0, true); $data = $client->pageCall("finance.settle.Purchase.search", $pager, $parMap); $php_json = json_encode($data, JSON_UNESCAPED_UNICODE); echo $php_json; ?>
JAVA
C#

6.响应示例

6.1 正常响应示例

JSON

{
    "status":0,
    "data":{
        "total_count":392,
        "order":[
            {
                "tax_amount":3592.974,
                "purchase_no":"CG202006190001",
                "post_fee":555,
                "total_cost":16346.554,
                "detail_list":[
                    {
                        "unit_ratio":1,
                        "settle_num":3,
                        "invoice_num":3,
                        "price":1111,
                        "discount":0.98,
                        "dis_price":1088.78,
                        "tax_rate":1.1,
                        "tax_price":2286.438,
                        "total_tax_amount":3592.974,
                        "total_amount":3266.34,
                        "share_post_fee":244.5104,
                        "tax_total_amount":6859.314,
                        "purchase_no":"CG202006190001",
                        "goods_name":"赵阳的货品02 RPG",
                        "goods_no":"098812",
                        "spec_code":"",
                        "spec_name":"",
                        "spec_no":"088804",
                        "barcode":"",
                        "provider_goods_no":"",
                        "remark":"",
                        "created":1592794124000,
                        "unit_name":"个",
                        "purchase_unit_name":"无",
                        "brand_name":"无"
                    },
                    {
                        "unit_ratio":1,
                        "settle_num":4,
                        "invoice_num":4,
                        "price":2222,
                        "discount":0.98,
                        "dis_price":2177.56,
                        "tax_rate":0,
                        "tax_price":2177.56,
                        "total_tax_amount":0,
                        "total_amount":8710.24,
                        "share_post_fee":310.4896,
                        "tax_total_amount":8710.24,
                        "purchase_no":"CG202006190001",
                        "goods_name":"赵阳的货品01 M4A1",
                        "goods_no":"09811",
                        "spec_code":"",
                        "spec_name":"",
                        "spec_no":"088805",
                        "barcode":"",
                        "provider_goods_no":"",
                        "remark":"",
                        "created":1592794124000,
                        "unit_name":"个",
                        "purchase_unit_name":"无",
                        "brand_name":"赵阳品牌01"
                    }],
                "remark":"",
                "goods_count":7,
                "flag_name":"无",
                "settle_no":"JS202006220001",
                "is_share_other":true,
                "warehouse_no":"",
                "is_share_post_fee":true,
                "invoice_type":1,
                "other_total":222,
                "provider_no":"085400",
                "settler_name":"系统",
                "checker_name":"系统",
                "goods_amount":11976.58,
                "created":1592794124000,
                "invoice_no":"",
                "tax_goods_amount":15569.554,
                "stockin_no":"",
                "logistics_no_list":"",
                "logistics_type_name":"未知",
                "status":10
            }]
    }
}

6.2 异常响应示例

JSON	{ "status": 100, "message": "仓库不存在" }