API文档

finance.RawPayment.search（平台账单查询）

¥标准

1.接口说明

1.1 接口描述：获取ERP内平台账单信息

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

1.3 增量获取:

1.4 时间跨度：start_time和end_time最大跨度为30天

1.5注意事项：【权限校验】：店铺权限

为了达到保护用户隐私数据安全的目的，本接口不返回淘系及系统供销平台数据，相关平台规则点击这里，淘系及系统供销平台数据获取办法点击这里。

2.调用场景

2.1 举例说明：

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>		是	查询参数
分页	pager	pager		是	分页

名称

字段

类型

长度

必须

描述

查询参数

params

Map<String, Object>

是

查询参数

分页

pager

是

分页

params

名称	字段	类型	长度	必须	描述
店铺编号	shop_no	String	20	否	店铺编号
关联单号	order_no	String	40	否	关联单号
时间类型	time_type	Int		否	1：收付时间 2：下载时间默认按照收付时间进行获取
类型	type	Int	4	否	0：其他 1：收款 2：退款
时间起始	start_time	String	40	是	时间起始
时间结束	end_time	String	40	是	时间结束

pager

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

名称

字段

类型

长度

必须

描述

分页大小

page_size

Int

否

分页大小

页号

page_no

Int

否

从0开始

4.响应参数

名称	字段	类型	必须	描述
状态码	status	Int	Y	状态码,0表示正常
错误信息	message	String	N	无错误信息不返回
单据信息	data	Map<String, Object>	N	单据信息

名称

字段

类型

长度

必须

描述

状态码

status

Int

状态码,0表示正常

错误信息

message

String

无错误信息不返回

单据信息

data

Map<String, Object>

单据信息

data

名称	字段	类型	长度	必须	描述
明细信息	detail_list	List<Map<String, Object>>		Y	明细信息
总数	total_count	Int	11	N	查询单据总条数

名称

字段

类型

长度

必须

描述

明细信息

detail_list

List<Map<String, Object>>

明细信息

总数

total_count

Int

查询单据总条数

detail_list

名称	字段	类型	长度	必须	描述
唯一键	rec_id	Int	20	是	平台账单唯一键
平台ID	platform_id	Int	6	是	平台ID，对应关系请点击这里查看
店铺编号	shop_no	String	20	是	店铺编号
状态	status	Int	4	是	状态未确认：0 已确认：1 未关联：3 已对账：4
类型	type	Int	4	是	类型 0：其他 1：收款 2：退款
关联单号	order_no	String	40	是	关联单号
支付单号	pay_order_no	String	40	是	支付单号
收入	in_amount	Decimal(19,4)		是	收入
支出	out_amount	Decimal(19,4)		是	支出
数量	num	Decimal(19,4)		是	数量
余额	balance	Decimal(19,4)		是	余额
是否担保	is_guarantee	boolean	1	是	是否担保
备注	remark	String	255	是	备注
收付时间	create_time	String	40	是	收付时间（毫秒级时间戳，例如：1631861379000）
下载时间	created	String	40	是	下载时间（毫秒级时间戳，例如：1631861379000）
最后修改时间	modified	String	40	是	最后修改时间（毫秒级时间戳，例如：1631861379000）
业务类型	item	String	40	是	业务类型（该值来源于平台）
对方支付宝账号	opt_pay_account	String	128	是	对方支付宝账号（该值来源于平台）
业务描述	description	String	128	是	业务描述（该值来源于平台）
支付宝流水号	fa_order_no	String	40	是	支付宝流水号（奇门自定义不返回）
商品名称	goods_name	String	255	是	商品名称（奇门自定义不返回）
平台支付单号	platform_pay_order_no	String	40	是	平台支付单号（奇门自定义不返回）

5.请求示例

Json格式请求报文

[
{
"start_time":"2021-01-04 15:01:40",
"end_time":"2021-02-03 15:01:40"
}
]

PHP

< php
header("Content-Type: text/html; charset=UTF-8");
date_default_timezone_set("Asia/Shanghai");
 
$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret");
 
 
$pager = new Pager(1, 0, true);
 
$params=new stdClass();
 $params->start_time = '2020-07-20 17:43:50';
 $params->end_time = '2020-08-19 00:00:00';
 
 
$data = $client->pageCall("finance.RawPayment.search", $pager, $params);
 
?>

6.响应示例

6.1 正常响应示例

JSON

{
    "status": 0,
    "data": {
        "total_count": 1,
        "detail_list": [
            {
                "order_no": "QQQQ20211126003",
                "item": "",
                "pay_order_no": "QQQQQQQ222224",
                "create_time": 1638435635000,
                "created": 1638435635000,
                "num": 0.0000,
                "is_guarantee": false,
                "description": "",
                "remark": "",
                "rec_id": 11898,
                "type": 0,
                "in_amount": 0.0000,
                "balance": 0.0000,
                "platform_id": 127,
                "out_amount": 0.0000,
                "modified": 1638553832000,
                "opt_pay_account": "",
                "shop_no": "wdtapi3-test",
                "status": 4
            }
        ]
    }
}

6.2 异常响应示例

JSON	{ "status":100, "message":"您的查询时间过宽,查询时间不能大于30天" }