发票云(标准版)API文档
旗舰版标准版智能特性生态版
旗舰版标准版智能特性生态版
  1. 税盘&数电票下载
  • 整体介绍
  • 对接约定
  • 授权
    • 获取AccessToken
      POST
  • 开票
    • 产品介绍
    • 开发指南
    • 税控&数电同步开票
      • 业务场景下接口调用顺序
      • 1.01.读取税盘信息(czlx-7)
      • 1.02 .读取票种信息(czlx-30)
      • 1.03.发票开具(czlx-3)
      • 1.04.发票作废(czlx-6)
      • 1.05.发票查询(czlx-5)
      • 1.06.发票打印(czlx-4)
      • 1.07.专用发票申请红字信息表(czlx-20)
      • 1.08.查询专用发票申请红字信息表(czlx-18)
      • 1.09.批量打印(czlx-32)
      • 1.11.机动车销售统一发票开具(czlx-40)
      • 1.12.机动车销售统一发票查询(czlx-41)
      • 1.13.机动车销售统一发票红冲(czlx-42)
      • 1.15.核定票种查询(czlx-51)
      • 1.21.二手车-发票开具(czlx-43)
      • 1.22.二手车-发票查询(czlx-44)
      • 1.23.二手车-发票红冲(czlx-45)
      • 1.30 .查询授信额度接口(czlx-122)
      • 2.01.电子发票开具(czlx-110) ,【注】开数电票请对接:1.03.发票开具(czlx-3)
      • 2.02.电子发票信息查询(czlx-113)
      • 2.03.电子发票红冲 (只支持全额红冲)(czlx-114)
      • 2.04.刷新PDF(czlx-115)
      • 2.05.查询电子发票余量(czlx-116)
      • 3.01.查询税收分类编码信息(czlx-504)
      • 3.03.获取打印机列表(czlx-901)
    • 数电异步开票
      • 异步开票-v4
      • 查询异步开票结果-v4
    • 扫码开票
      • 上传销售单模式扫码开票
        • 接入指南
        • 1.token获取
        • 2.上传发票销售单接口
        • 3.回推接口地址
      • 自定义扫码开票
        • 接入指南
        • 1.对接方按规则组装二维码链接
        • 2.查询开票明细
        • 3.回推接口地址
    • 企业级-发票云销项查询
      • 根据业务条件查询当前企业的销项发票
  • 收票
    • 开发指南
    • 发票数据规范
    • 发票数据
      • 机动车发票数据
      • 火车票数据
      • 火车票退票凭证数据
      • 财政电子票据数据
      • 客运票/轮船票数据
      • 其他发票数据
      • 完税证明数据
      • 飞机票数据
      • 数电发票(专票/普票)数据
      • 数电发票(铁路电子客票)数据
      • 数电发票(航空运输电子客票行程单)数据
      • 数电发票(机动车销售统一发票)数据
      • 数电发票(二手车销售统一发票)数据
      • 的士票数据
      • 定额发票数据
      • 通用机打(纸质/电子)发票数据
      • 过路过桥费数据
      • 二手车票数据
      • 专票和普票数据
      • 通行费发票数据
      • 海关缴款书数据
      • 发票文件数据
      • 数电发票(通行费发票)数据
    • 企业级-发票云进项查询
      • 根据业务条件查询当前企业采集的发票
      • 根据代码号码查询当前企业采集的发票
      • 根据开票时间范围和采集时间范围查询当前企业采集的发票
      • 根据发票流水号或者发票代码号码查询当前企业采集的发票
      • 根据业务条件查询指定用户采集的发票
    • 税盘&数电票下载
      • 开发指南
      • 1、获取税款所属期信息
        POST
      • 2、进项发票表头采集
        POST
      • 3、发票不抵扣勾选
        POST
      • 4、海关缴款书抵扣勾选(税盘模式不支持)
        POST
      • 5、海关缴款书不抵扣勾选(税盘模式不支持)
        POST
      • 6、海关缴款书表头采集(税盘模式不支持)
        POST
      • 7、全量发票查询
        POST
      • 8、当前统计查询
        POST
      • 9、历史统计查询
        POST
      • 10、生成统计表
        POST
      • 11、撤销统计表
        POST
      • 12、确认统计表
        POST
      • 13、获取当前已勾选或往期已认证发票(税盘模式不支持)
        POST
      • 14、当期已勾选或往期已认证缴款书(税盘模式不支持)
        POST
      • 15、发票抵扣勾选
        POST
    • 电子凭证解析
      • billTypeCode表
      • 解析 + 验签 指定文件的xbrl信息
      • xbrl字符串转json
      • json转xbrl字符串
    • 税局电票平台发票异步下载
      • 进项全量发票采集-异步申请
      • 进项全量发票采集-异步结果查询
    • 发票数据规范
    • 税局电票平台发票异步入账
      • 入账状态查询-异步申请
      • 批量入账-异步申请
      • 入账状态查询-异步结果查询
      • 批量入账-异步结果查询
  • 查验识别
    • 开发指南
    • 发票查验(单张)
    • 发票查验(多张异步)
    • 发票识别+查验(单张)
    • 发票识别(多张)
    • 发票识别+查验(多张)
    • 返回状态码
  • 报销
    • 发票助手移动端-h5对接
    • 发票助手移动端-小程序对接
    • 第三方发票报销查询
    • 发票助手PC端对接
      • 1、对接流程
      • 2.1、前端JS建立连接通道
      • 2.2、后端建立连接通道
      • 2.3、推送数据格式
      • 3、采集发票
      • 4、查看发票
      • 5、编辑单张发票
      • 6、分录操作
      • 常见问题
      • 获取userKey
      • 获取linkKey
      • 缓存单据
      • 保存单据
      • 更新单据状态
      • 根据发票流水号获取发票详细数据
      • 根据userkey查询单据下所有发票列表
      • 删除单据
      • 再次查验
      • 回写入账信息
      • 删除入账信息
  • 影像
    • 开发指南
    • 对接约定
    • 影像系统对接
    • 授权
      • 获取AccessToken(影像系统)
  • 档案
    • 异构系统接口定义
    • 发票返结构体
  • 数据模型
    • 影像
      • 采集渠道
    • 收票
      • response_invoice_detail
      • 进项发票类型
      • 进项可查验的发票类型
      • invoiceType为1,2,3,4,5,26,27时的数据格式
      • 通行费全量发票数据字段
      • 机动车发票全量字段(待定)
      • 特定业务类型
      • 发票状态
      • 发票风险等级
      • 发票来源
      • 零税率标志
      • response_invoice_detail noPage
    • response
    • 统计表查询结果
  1. 税盘&数电票下载

8、当前统计查询

测试环境(除税控、数电和扫码开票外的接口)
https://api-dev.piaozone.com/test
测试环境(除税控、数电和扫码开票外的接口)
https://api-dev.piaozone.com/test
POST
/

请求参数

Query 参数

Body 参数application/json

示例
{
    "account": "string",
    "taxNo": "string",
    "request_path": "string"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api-dev.piaozone.com/test/?access_token=%E5%8F%91%E7%A5%A8%E4%BA%91%E7%A7%9F%E6%88%B7%E6%8E%88%E6%9D%83token&reqid=%E9%93%BE%E8%B7%AFid%EF%BC%8C%E7%94%A8%E4%BA%8E%E8%B7%9F%E8%B8%AA%E6%8E%92%E6%9F%A5%E9%97%AE%E9%A2%98%EF%BC%8C%E5%BB%BA%E8%AE%AE%E4%B8%8D%E5%B0%91%E4%BA%8E13%E4%BD%8D&taxNo=%E6%8E%88%E6%9D%83%E5%AF%B9%E5%BA%94%E7%9A%84%E4%BC%81%E4%B8%9A%E7%A8%8E%E5%8F%B7&name=%E6%95%B0%E7%94%B5%E6%A8%A1%E5%BC%8F%EF%BC%9A%E5%8F%AF%E4%B8%8D%E4%BC%A0%EF%BC%8C%E4%B9%9F%E5%8F%AF%E6%8C%87%E5%AE%9A%E9%95%BF%E9%93%BE%E6%8E%A5name%EF%BC%8C%E8%AF%B7%E6%B1%82%E5%B0%86%E7%94%B1%E4%B8%8Ename%E5%AF%B9%E5%BA%94%E7%9A%84%E5%AE%A2%E6%88%B7%E7%AB%AF%E5%90%91%E7%A8%8E%E5%B1%80%E5%8F%91%E9%80%81%E8%AF%B7%E6%B1%82%EF%BC%9B%E7%A8%8E%E7%9B%98%E6%A8%A1%E5%BC%8F%EF%BC%8C%E4%BD%BF%E7%94%A8%E5%AE%A2%E6%88%B7%E7%AB%AF%E7%94%9F%E6%88%90%E7%9A%84%E9%95%BF%E9%93%BE%E6%8E%A5name%E5%8D%B3%E5%8F%AF' \
--header 'Content-Type: application/json' \
--data '{
    "account": "string",
    "taxNo": "string",
    "request_path": "string"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "traceId": "string",
    "errcode": "string",
    "description": "string",
    "data": {
        "taxPeriod": "202401",
        "skssq": "201909;20191024;201910",
        "gxrqfw": "20170101-20250805",
        "updateTime": "2025-08-05 15:14:05",
        "createTjbbStatus": "01",
        "isAllowQxTj": true,
        "isAllowQrtj": true,
        "allowChangeSsqBySeason": true,
        "tjInfoArr": [
            {
                "invoiceType": "01",
                "deductibleNum": "string",
                "deductibleAmount": "string",
                "deductibleTax": "string",
                "unDeductibleNum": "string",
                "unDeductibleAmount": "string",
                "unDeductibleTax": "string"
            }
        ]
    }
}
修改于 2025-08-05 07:17:47
上一页
7、全量发票查询
下一页
9、历史统计查询
Built with