进项全量发票采集-异步结果查询

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

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

POST

/m2/bill/v1/invoice/collector

注意：RPA下载发票不进入台账，后面单据使用了再进库:商户运营平台不显示，企业级进项发票查询无相关记录（20250506）

请求参数

Query 参数

access_token

string

必需

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

<= 256 字符

reqid

string

必需

当前13位毫秒级时间戳加3位随机数字(总共16位)，方便请求方跟踪异常

>= 16 字符<= 16 字符

示例值:

1624601109096123

Header 参数

Content-Type

string

必需

请求参数为json格式

示例值:

application/json

tid

string

必需

租户授权clientId

<= 30 字符

taxNo

string

当前企业税号

必需

<= 20 字符

method

string

必需

全量发票采集-异步结果查询，固定传值：full/query

示例值:

full/query

Body 参数application/json

batchNo

string

必需

<= 256 字符

currentPage

integer

页码

必需

默认1，分页数据查询有效

pageSize

integer

每页数量

必需

默认100，分页数据查询有效

示例

{
  "batchNo": "132yuyu4kdy17p5imr1h5495tar22sxi",
  "currentPage": 1,
  "pageSize": 50
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-dev.piaozone.com/test/m2/bill/v1/invoice/collector?access_token=&reqid=1624601109096123' \
--header 'tid;' \
--header 'taxNo;' \
--header 'method: full/query' \
--header 'Content-Type: application/json' \
--data-raw '{
    "batchNo": "132yuyu4kdy17p5imr1h5495tar22sxi",
    "currentPage": 1,
    "pageSize": 50
}'

返回响应

🟢200成功

application/json

Body

errcode

string

操作结果码

必需

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

<= 4 字符

description

string

操作描述

必需

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

totalElement

number

总记录数

必需

totalPage

number

总页数

必需

currentPage

number

当前查询的页码

必需

pageSize

number

分页的大小

必需

data

array [object {2}]

发票明细信息

必需

object

必需

object

必需

示例

{
  "errcode": "0000",
  "description": "操作成功",
  "totalElement": 3,
  "totalPage": 1,
  "currentPage": 1,
  "pageSize": 50,
  "data": [
    {
      "proxyMark": 1,
      "canBeDeduction": 1
    },
    {
      "proxyMark": 1,
      "canBeDeduction": 0
    },
    {
      "proxyMark": 1,
      "canBeDeduction": 0
    }
  ]
}

进项全量发票采集-异步申请

开发指南