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