根据业务条件查询当前企业采集的发票

测试环境(除税控、数电和扫码开票外的接口）

https://api-dev.piaozone.com/test

POST

/m6/bill/invoice/query/v2

返回格式

返回数据中的data数组中每个对象格式，需结合文档做处理：发票数据规范

请求示例

请求参数

Query 参数

access_token

string

必需

访问token，获取方式请查阅《对接约定》

reqid

string

可选

当前13位毫秒级时间戳加3位随机数字(总共16位)

示例值:

1624601109096123

Body 参数application/json

pageNo

integer

页码

可选

pageSize

integer

可选

一页展示的条数-最大50

startTime

string

开票开始日期

必需

endTime

string

开票结束日期

必需

invoiceTypes

string

可选

发票类型：1.普通电子发票2.电子发票专票3.普通纸质发票4.专用纸质发票5.普通纸质卷票7.通用机打8.的士票9.火车票10.飞机票11.其他12.机动车.13.二手车14.定额发票15.通行费16.客运发票17.过路过桥费19.完税证明20.轮船票21.海关缴款书23.通用机打电子发票24.火车票退票凭证25.财政电子票据26.数电票（普通发票）27.数电票（增值税专用发票）28.数电票（航空运输电子客票行程单）29.数电票（铁路电子客票）

authenticateFlags

string

可选

认证标志：0未任何认证及勾选，1勾选，2勾选认证，3扫描认证

salerTaxNo

string

销方税号

可选

buyerTaxNo

string

购方税号

可选

invoiceStatus

string

可选

发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常

示例

{
    "pageNo": 0,
    "pageSize": 0,
    "startTime": "string",
    "endTime": "string",
    "invoiceTypes": "string",
    "authenticateFlags": "string",
    "salerTaxNo": "string",
    "buyerTaxNo": "string",
    "invoiceStatus": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-dev.piaozone.com/test/m6/bill/invoice/query/v2?access_token=&reqid=1624601109096123' \
--header 'Content-Type: application/json' \
--data-raw '{
    "pageNo": 0,
    "pageSize": 0,
    "startTime": "string",
    "endTime": "string",
    "invoiceTypes": "string",
    "authenticateFlags": "string",
    "salerTaxNo": "string",
    "buyerTaxNo": "string",
    "invoiceStatus": "string"
}'

返回响应

🟢200标准响应格式

application/json

Body

errcode

string

操作结果码

必需

成功时为0000, 失败时为非0000

description

string

操作描述

必需

描述，失败时可以根据这个字段进行提示

totalElement

number

总记录数

必需

totalPage

number

总页数

必需

currentPage

number

当前查询的页码

必需

pageSize

number

分页的大小

必需

data

array[string]

发票明细信息

必需

格式参考文档《发票数据规范》；data为空，表示数据已经取完

示例

{
    "errcode":"0000",
    "description":"success",
    "totalElement": 1, 
    "totalPage": 1, 
    "currentPage": 1, 
    "pageSize": 10, 
    "data": [{ //发票明细信息
    }]
}

修改于 2025-03-17 07:09:57

发票文件数据

根据代码号码查询当前企业采集的发票

根据业务条件查询当前企业采集的发票

返回格式#

请求示例#

请求参数

示例代码

返回响应

返回格式

请求示例