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

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

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

POST

/m2/bill/v1/invoice/collector

最近更新：增加机动车、二手车、数电发票（航空运输电子客票行程单）和数电发票（铁路电子客票）数据结构
功能说明：
1、从电子税局下载到发票数据和版式文件后保存到发票云，保存到企业台账
2、任务申请后，请注意保持电子税局账号登录，可通过“金蝶发票云公众号”或ERP调用发票云的登录接口完成登录，或使用托管小号自动收验证码
3、版式文件下载可能比较慢，建议申请下载的一小时后取发票数据，然后用同个batchNo每小时轮询取版式文件结果，最多重试24小时（期间发票云自动重试下载，客户需要保持电子税局账号的登录在线），没有拿到可能是局端出问题，可以重新申请
4、建议参考下述规范使用RPA
https://jdpiaozone.yuque.com/nbklz3/dn5ehb/zvpcfdwluvdn59x3?singleDoc# 《RPA使用规范》

请求参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "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": "0000",
    "description": "操作成功",
    "totalElement": 3,
    "totalPage": 1,
    "currentPage": 1,
    "pageSize": 50,
    "data": [
        {
            "proxyMark": 1,
            "canBeDeduction": 1
        },
        {
            "proxyMark": 1,
            "canBeDeduction": 0
        },
        {
            "proxyMark": 1,
            "canBeDeduction": 0
        }
    ]
}

修改于 2025-10-23 06:04:32

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

入账状态查询-异步申请