发票云(标准版)API文档
旗舰版标准版智能特性
旗舰版标准版智能特性
🤖 AI Support​​
  1. 发票助手PC端对接
  • 整体介绍
  • 对接约定
  • 授权
    • 获取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、获取税款所属期信息
      • 2、进项发票表头采集
      • 3、发票不抵扣勾选
      • 4、海关缴款书抵扣勾选（税盘模式不支持）
      • 5、海关缴款书不抵扣勾选（税盘模式不支持）
      • 6、海关缴款书表头采集（税盘模式不支持）
      • 7、全量发票查询
      • 8、当前统计查询
      • 9、历史统计查询
      • 10、生成统计表
      • 11、撤销统计表
      • 12、确认统计表
      • 13、获取当前已勾选或往期已认证发票（税盘模式不支持）
      • 14、当期已勾选或往期已认证缴款书（税盘模式不支持）
      • 15、发票抵扣勾选
    • 电子凭证解析
      • billTypeCode表
      • 解析 + 验签 指定文件的xbrl信息
      • xbrl字符串转json
      • json转xbrl字符串
    • 发票异步下载
      • 进项全量发票采集-异步申请
      • 进项全量发票采集-异步结果查询
    • 发票数据规范
  • 查验识别
    • 开发指南
    • 发票查验（单张）
    • 发票查验（多张异步）
    • 发票识别+查验（单张）
    • 发票识别（多张）
    • 发票识别+查验（多张）
    • 数电票文件识别+查验
    • 返回状态码
  • 报销
    • 发票助手移动端-h5对接
    • 发票助手移动端-小程序对接
    • 第三方发票报销查询
    • 发票助手PC端对接
      • 对接流程
      • JS建立连接通道
      • 采集发票
      • 后端建立通道
      • 查看发票
      • 编辑单张发票
      • 分录操作
      • 常见问题
      • 获取userKey
        POST
      • 获取linkKey
        POST
      • 缓存单据
        POST
      • 保存单据
        POST
      • 更新单据状态
        POST
      • 根据发票流水号获取发票详细数据
        POST
      • 根据userkey查询单据下所有发票列表
        POST
      • 删除单据
        POST
      • 再次查验
        POST
      • 回写入账信息
        POST
      • 删除入账信息
        POST
  • 影像
    • 开发指南
    • 对接约定
    • 影像系统对接
    • 授权
      • 获取AccessToken(影像系统)
  • 档案
    • 异构系统接口定义
    • 发票返结构体
  1. 发票助手PC端对接

对接流程

1
获取userKey
录入单据信息，获取接下来调用页面所需的授权，详见获取userKey
2
获取linkKey
用于接收发票信息的唯一key，详见获取linkKey
3
JS建立连接通道
打开发票云的采集发票、编辑发票页面，需要建立一个JS建立连接通道，通常是websocket的方式进行链接，用于回推发票云页面上的发票数据，当您处理单向交互网络等不便使用websocket的情况时，可以使用后端建立通道
4
对接采集发票页面
在您的系统里嵌入发票云的采集发票，在页面上可以进行发票、附件的采集，同时也带有合规性校验功能，会筛选过滤出合规的发票，在采集完毕之后，点击导入，发票数据会通过上一步的通道进行回推
提示
回推的数据为关键要素，如遇业务需要详细数据，可使用获取发票详细数据
5
同步单据与发票绑定关系
导入完毕之后，根据您的业务流程，选择 缓存单据或者 保存单据，这一步是告知发票云单据与发票的绑定关系
提示
在绑定之后，可以通过对接查看发票看到单据的具体情况
如遇发票需要编辑的情况，可对接编辑发票
6
更新单据状态
在业务系统流转到下一个节点之后，需更新单据状态到发票云，目前发票云单据状态分为未用（默认，状态1）、在用（状态30）、已用（状态60）、已入账（状态65）,发票状态随着单据状态同步变化
提示
1.
如因业务原因废弃单据，应调用删除单据接口，用于释放单据下发票
2.
单据状态未用时，单据下发票仍能被其他单据录入，且能通过重复报销校验，因为此刻发票状态也是未用
7
操作入账信息
此步骤一般为发票入账最后一步，在回写入账信息之后，单据和发票状态都会变更为已入账（状态65），删除入账信息则会回退到上一个状态
备注
我们会持续收集对接中遇到的各种问题并提出解决方案，例如跨域等等，具体可看常见问题
上一页
第三方发票报销查询
下一页
JS建立连接通道
Built with