当前位置: API文档

finance.invoice.InvoiceOrder.search(发票信息查询)

¥基础   ¥增值  ¥定制 

1.接口说明

1.1 接口描述:获取发票信息
1.2 适用版本:客户端 V1.2.2.8及以上版本
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/

   3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
Y卖家账号, 由旺店通分配
接口账号keyString
Y由旺店通分配appkey, 在发送的数据中对应 key 字段
saltString
Y由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称methodString
Y调用的接口名称
版本号vString
Y1.0
秒级时间戳timestampint
Y秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名signString
Y签名
分页大小page_sizeint
N分页大小,分页查询必传
分页编号page_noint
N分页编号,分页查询必传
是否计算查询结果的总页数calc_totalint
N是否计算查询结果的总页数, 需要计算则1, 否则填0         

    3.3 业务请求参数

名称字段类型长度必须描述

查询参数

params

Map<String, Object>


Y

查询参数

分页

pager

Pager


Y

分页

params

名称字段类型长度必须描述

开始时间

start_time

Date

时间格式

N

开始时间(最后更新时间)

结束时间

end_time

Date

时间格式

N

结束时间(最后更新时间)

发票编号

invoice_order_no

String

40

N

发票编号

服务商类型

platform_typpe

int

4

N

1     阿里巴巴

201 金壬

pager

名称字段类型长度必须描述

分页大小

page_size

int

4

N

分页大小

页号

page_no

int

4

N

从0开始

4.响应参数

名称字段类型长度必须描述

状态码

status

Int


Y

返回0为正常

错误信息

message

String


N

无错误信息不返回

单据数据

data

Map<String, Object>


N

单据数据

data

名称字段类型长度必须描述

单据数据

order

List<Map<String,   Object>>


Y

单据数据

总数

total_count

int

11

Y

查询条件总单据数

order


名称字段类型长度必须描述

发票编号

invoice_order_no

String

40

Y

发票编号,系统内部生成

发票下载地址

file_url

String

255

Y

发票下载地址

接口反馈信息

error_info

String

100

Y

接口反馈信息

付款方email

payer_email

String

64

Y

付款方email

收款银行

payee_bank_name

String

255

Y

收款银行

收款账户

payee_bank_account

String

20

Y

收款账户

税前折扣金额

discount

Decimal(19,4)


Y

税前折扣金额

付款方联系电话

payer_phone

String

40

Y

付款方联系电话

收款人

payee_receiver

String

20

Y

收款人

开票金额

invoice_amount

Decimal(19,4)


Y

实际合计金额+实际合计税额

发票类型

is_red

int

1

0:蓝票

1:红票

付款方银行账号

payer_account

String

40

Y

付款方银行账号

开票人

payer_operator

String

20

Y

开票人

开票类型

business_type

int

4

Y

0:商家对于个人开具

1:商家对于企业开具

付款方税务登记号

payer_register_no

String

40

y

付款方税务登记号

开票服务商名称

provider_name

String

40

Y

开票服务商名称

付款方地址

payer_address

String

255

Y

付款方地址

实际开票金额

invoice_outer_amount

Decimal(19,4)


Y

实际开票金额

付款方银行

payer_bank

String

128

Y

付款方银行

收款方地址

payee_address

String

255

Y

收款方地址

货品合计金额

goods_amount

Decimal(19,4)


Y

货品合计金额

货品合计税额

goods_tax

Decimal(19,4)


Y

货品合计税额

创建时间

created

timestamp


Y

创建时间

发票备注

invoice_remark

String

200

Y

发票备注

折扣税率

discount_tax

Decimal(19,4)


Y

折扣税率

收款方联系电话

payee_telno

String

40

Y

收款方联系电话

开票方备注

payee_remark

String

255

Y

开票方备注

店铺编号

shop_no

String

20

Y

店铺编号

店铺名称

shop_name 

String

128

Y

店铺名称

实际合计税额

sum_tax

Decimal(19,4)


Y

货品合计税额-折扣税额

收款方公司名称

payee_name

String

64

Y

收款方公司名称

付款方名称

payer_name 

String

64

Y

对应发票抬头,付款方名称

复核人

payee_checker

String

20

Y

复核人

发票流水号

serial_no

String

50

Y

发票流水号

发票状态

status

int

4

Y

5:取消;10:编辑中;20:待审核;40:待开票;50:开票中;60:开票成功;70:开票申请失败;80:开票失败

实际合计金额

sum_price

Decimal(19,4)


Y

货品合计金额-税前折扣金额

明细信息

detail_list

List<Map<String,Object>>


Y

明细信息

detail_list


名称字段类型长度必须描述

发票项目名称

invoice_order_no

String

40

Y

发票编号,系统内部生成

发票项目编码

item_no

String

40

Y

发票项目编码

单位名称

unit_name

String

20

Y

单位名称

商品数量

num

Decimal(19,4)


Y

商品数量

税务编码

tax_code

String

32

Y

税务编码

税率

tax_rate

Decimal(19,4)


Y

税率

税前单价

price

Decimal(19,4)


Y

税前单价

税前总价

sum_price

Decimal(19,4)


Y

税前总价

税额

tax

Decimal(19,4)


Y

税额

总价

sum_amount

Decimal(19,4)


Y

总价

税前折扣金额

discount

Decimal(19,4)


Y

税前折扣金额

折扣税额

discount_tax

Decimal(19,4)


Y

折扣税额

电子发票明细备注

remark

String

100

Y

电子发票明细备注

5.请求示例

json格式请求报文

[{"start_time":"2019-03-01 11:00:00","end_time":"2019-03-01 19:26:31"}]


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->start_time = '2019-03-01 11:00:00';
$parMap->end_time = '2019-03-01 19:26:31';
 
$pager = new Pager(50, 0, true);
 
$data = $client->pageCall("finance.invoice.InvoiceOrder.search", $pager, $parMap);
$php_json = json_encode($data,JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
?>
JAVA
C#

6.响应示例

6.1正常响应示例

json

{
"status": 0,
"data": {
"total_count": 1,
"order": [{
"invoice_order_no": "FP201902120001",
"file_url": "",
"error_info": "",
"payer_email": "",
"detail_list": [{
"item_name": "",
"item_no": "green",
"unit_name": "只",
"num": 1,
"tax_code": "1010101010000000000",
"tax_rate": 0.13,
"price": 3.53,
"sum_price": 3.53,
"tax": 0.47,
"sum_amount": 4,
"discount": 0,
"discount_tax": 0,
"remark": ""
}],
"payee_bank_name": "",
"payee_bank_account": "",
"discount": 0,
"payer_phone": "18000000983",
"payee_receiver": "王小二",
"invoice_amount": 4,
"is_red": false,
"payer_account": "",
"payee_operator": "王小二",
"business_type": 0,
"payer_register_no": "",
"provider_name": "金壬普通发票",
"payer_address": "河北省 唐山市 古冶区 xxxxxxxxx生生世世事实上事实上事实上",
"shop_no": "msn001",
"invoice_outer_amount": 0,
"payer_bank": "",
"payee_address": "北京",
"goods_amount": 3.53,
"goods_tax": 0.47,
"created": 1549943699000,
"invoice_remark": "",
"discount_tax": 0,
"shop_name": "莫胜男的店铺",
"payee_telno": "15936892345",
"payee_remark": "",
"sum_tax": 0.47,
"payee_name": "百望",
"payer_name": "个人",
"payee_checker": "王小二",
"serial_no": "",
"status": 20,
"sum_price": 3.53
}]
}
}


6.2异常响应示例

json

{
"status": 100,
"message": "参数中必须包含起止时间"
}







常用工具