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

1.01.读取税盘信息(czlx-7)

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

请求参数

Query 参数
name
string 
必需
clientsecret+税盘号
reqid
string 
必需
当前13位毫秒级时间戳加3位随机数字(总共16位)
Header 参数
Content-Type
string 
必需
示例值:
application/json
Body 参数application/json
sfrz
object 
必需
client_id
string 
由发票云分配的id
必需
czlx
enum<string> 
固定为:7
必需
枚举值:
7
示例
{
  "sfrz": {
    "client_id": "string"
  },
  "czlx": "7"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-dev.piaozone.com/test/?name=&reqid=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sfrz": {
        "client_id": "string"
    },
    "czlx": "7"
}'

返回响应

🟢200成功
application/json
Body
description
string 
描述
必需
errcode
string 
0:查询成功
必需
jyqyxx
object 
卷烟企业信息
必需
jzsj
string 
必需
截止时间(卷烟企业标志失效的截止时间)
qybz
string 
必需
企业标志 0:非卷烟企业 1:卷烟生产企业 2:卷烟批发企业
qysj
string 
必需
启用时间(卷烟企业标志生效的起始时间)
sjd
object 
数据对象
必需
csbz
string 
必需
抄税标志 0:未抄报税 1:已处理
djdpfpdm
string 
单机版电子发票代码
必需
djdpfphm
string 
单机版电子发票号码
必需
djdpfpkpxe
string 
单机版电子发票限额
必需
djdpfpsyfs
string 
必需
单机版电子发票剩余份数
djdpzyfpdm
string 
必需
单机版电子专用发票代码
djdpzyfphm
string 
必需
单机版电子专用发票号码
djdpzyfpkpxe
string 
必需
单机版电子专用发票限额
djdpzyfpsyfs
string 
必需
单机版电子专用发票分数
elec_special_volumn
array[string]
必需
单机版电子专用发票票卷信息(数组元素结构同纸质普通发票票卷信息)
elec_volumn
array [object {7}] 
必需
单机版电子普通发票票卷信息(数组元素结构同纸质普通发票票卷信息)
escfpdm
string 
二手车发票代码
必需
escfphm
string 
二手车发票号码
必需
escfpkpxe
string 
二手车发票限额
必需
escfpsyfs
string 
二手车发票剩余份数
必需
eschylx
string 
必需
二手车行业类型 0:非二手车企业 1:经营单位 2:拍卖单位 3:二手车市场
jdcfpdm
string 
必需
机动车统一销售发票代码
jdcfphm
string 
必需
机动车统一销售发票号码
jdcfpkpxe
string 
必需
机动车统一销售发票限额
jdcfpsyfs
string 
必需
机动车统一销售发票剩余份数
jsfpdm
string 
卷式纸质发票代码
必需
jsfphm
string 
卷式纸质发票号码
必需
jsfpkpxe
string 
卷式纸质发票限额
必需
jsfpsyfs
string 
必需
卷式纸质发票剩余份数
jsph
string 
金税盘号
必需
jspjh
string 
分机号
必需
normal_papery_volumn
array [object {7}] 
必需
纸质普通发票票卷信息
ptfpdm
string 
普通纸质发票代码
必需
ptfphm
string 
普通纸质发票号码
必需
ptfpkpxe
string 
普通纸质发票限额
必需
ptfpsyfs
string 
必需
普通纸质发票剩余份数
qydzdh
string 
企业地址电话
必需
qykhhjzh
string 
企业银行及账号
必需
qymc
string 
企业名称
必需
qynsrsbh
string 
税盘号
必需
roll_volumn
array [object {7}] 
必需
卷式发票票卷信息(数组元素结构同纸质普通发票票卷信息)
sksblx
string 
必需
纳税人性质 1:航信单机版, 2:百望单机版, 3:百望服务器版, 4:税务ukey
special_papery_volumn
array [object {7}] 
必需
专用纸质发票票卷信息(数组元素结构同纸质普通发票票卷信息)
ssbz
string 
必需
锁死标志 0:正常 1:已锁死
used_vehicle_volumn
array[string]
必需
used_vehicle_volumn
vehicle_volumn
array [object {7}] 
必需
机动车统一销售发票票卷信息(数组元素结构同纸质普通发票票卷信息)
zyfpdm
string 
专用纸质发票代码
必需
zyfphm
string 
专用纸质发票号码
必需
zyfpkpxe
string 
专用纸质发票限额
必需
zyfpsyfs
string 
必需
专用纸质发票剩余份数
示例
{
  "description": "操作成功",
  "errcode": "0",
  "jyqyxx": {
    "jzsj": "",
    "qybz": "",
    "qysj": ""
  },
  "sjd": {
    "csbz": "0",
    "djdpfpdm": "044031611112",
    "djdpfphm": "13514640",
    "djdpfpkpxe": "9999999.99",
    "djdpfpsyfs": "45361",
    "djdpzyfpdm": "",
    "djdpzyfphm": "00000000",
    "djdpzyfpkpxe": "0.00",
    "djdpzyfpsyfs": "0",
    "elec_special_volumn": [],
    "elec_volumn": [
      {
        "amount": 50000,
        "invoice_code": "044031611112",
        "invoice_num": "13510001",
        "purchase_date": "2020-03-03",
        "purchase_person": "",
        "remainder": 45361,
        "vol_no": "3"
      }
    ],
    "jsfpdm": "144030820001",
    "jsfphm": "13510002",
    "jsfpkpxe": "9999999.99",
    "jsfpsyfs": "49999",
    "jsph": "661532817749",
    "jspjh": "0",
    "normal_papery_volumn": [
      {
        "amount": 5000,
        "invoice_code": "044031800105",
        "invoice_num": "00409536",
        "purchase_date": "2019-05-29",
        "purchase_person": "",
        "remainder": 2101,
        "vol_no": "1"
      }
    ],
    "ptfpdm": "044031800105",
    "ptfphm": "00412435",
    "ptfpkpxe": "99999.99",
    "ptfpsyfs": "2101",
    "qydzdh": "",
    "qykhhjzh": "",
    "qymc": "航信培训企业",
    "qynsrsbh": "440301999999030",
    "roll_volumn": [
      {
        "amount": 50000,
        "invoice_code": "144030820001",
        "invoice_num": "13510001",
        "purchase_date": "2020-03-03",
        "purchase_person": "",
        "remainder": 49999,
        "vol_no": "2"
      }
    ],
    "special_papery_volumn": [
      {
        "amount": 5000,
        "invoice_code": "4403183130",
        "invoice_num": "19515045",
        "purchase_date": "2019-05-29",
        "purchase_person": "",
        "remainder": 175,
        "vol_no": "0"
      }
    ],
    "ssbz": "0",
    "zyfpdm": "4403183130",
    "zyfphm": "19519870",
    "zyfpkpxe": "99999.99",
    "zyfpsyfs": "175"
  }
}
上一页
业务场景下接口调用顺序
下一页
1.02 .读取票种信息(czlx-30)
Built with