# 发票云(旗舰版)API文档

## Docs
- [整体介绍](http://open-ultimate.piaozone.com/doc-3626695.md): 
- [快速开始](http://open-ultimate.piaozone.com/doc-3655357.md): 
- [加解密](http://open-ultimate.piaozone.com/doc-3626887.md): 
- [文件预览&文件上传&文件下载](http://open-ultimate.piaozone.com/doc-3626944.md): 
- [发票数据结构](http://open-ultimate.piaozone.com/doc-3656826.md): 
- [错误码](http://open-ultimate.piaozone.com/doc-3656853.md): 
- [常见接口错误](http://open-ultimate.piaozone.com/doc-6490249.md): 
- 场景指引 [概述](http://open-ultimate.piaozone.com/doc-3739134.md): 
- 场景指引 [直接开票](http://open-ultimate.piaozone.com/doc-3679085.md): 
- 场景指引 [单据开票](http://open-ultimate.piaozone.com/doc-3679105.md): 
- 场景指引 [扫码开票](http://open-ultimate.piaozone.com/doc-3679153.md): 
- 开票 > 单据开票接口（税控+数电） [单据开票对接指引](http://open-ultimate.piaozone.com/doc-4484343.md): 
- 开票 > 单据开票接口（税控+数电） [开票申请单错误码列表](http://open-ultimate.piaozone.com/doc-3746910.md): 
- 开票 > 直接开票接口 > 数电开票 [接入指引（必看）](http://open-ultimate.piaozone.com/doc-3750584.md): 
- 开票 > 直接开票接口 > 数电开票 [返回编码说明](http://open-ultimate.piaozone.com/doc-3799582.md): 
- 开票 > 直接开票接口 > 数电开票 [FAQ](http://open-ultimate.piaozone.com/doc-5625609.md): 
- 收票 > 收票报销 [发票助手对接流程](http://open-ultimate.piaozone.com/doc-3579156.md): 
- 影像 [开发指南](http://open-ultimate.piaozone.com/doc-3579155.md): 
- 档案 [对接说明（电子档案云旗舰版）](http://open-ultimate.piaozone.com/doc-4885155.md): 
- 档案 [异构系统接口定义](http://open-ultimate.piaozone.com/doc-4928657.md): 

## API Docs
- 授权 [1.01.获取app_token](http://open-ultimate.piaozone.com/api-145421044.md): 发票云旗舰版，针对不同环境和不同租户有不同的访问地址，所以
- 授权 [1.02获取access_token](http://open-ultimate.piaozone.com/api-145421045.md): 发票云旗舰版，针对不同环境和不同租户有不同的访问地址，所以
- 开票 > 单据开票接口（税控+数电） [1.1.01 开票申请单生成及开票（支持拆分合并后，再开票）](http://open-ultimate.piaozone.com/api-146003727.md): 开红票，数量和金额都应该传负数，单价传正数
- 开票 > 单据开票接口（税控+数电） [1.1.02 开票申请单撤回（对接方主动撤回）](http://open-ultimate.piaozone.com/api-181393410.md): 
- 开票 > 单据开票接口（税控+数电） [1.1.03 开票申请单发票查询](http://open-ultimate.piaozone.com/api-146003729.md): 查询开票申请单下的发票数据
- 开票 > 单据开票接口（税控+数电） [1.1.04 开票申请单快速红冲（仅支持税控普票）](http://open-ultimate.piaozone.com/api-146003730.md): 
- 开票 > 单据开票接口（税控+数电） [1.1.05 开票申请单批量作废（作废单据的发票，仅支持税控纸票）](http://open-ultimate.piaozone.com/api-146003731.md): 
- 开票 > 单据开票接口（税控+数电） [1.1.06 开票申请单红冲单或作废单生成（星瀚发票云版本5.0.015支持，不支持数电票）](http://open-ultimate.piaozone.com/api-146003732.md): 
- 开票 > 单据开票接口（税控+数电） [1.1.07 开票申请单重开单生成（星瀚发票云版本5.0.015支持，不支持数电票）](http://open-ultimate.piaozone.com/api-146003733.md): 
- 开票 > 单据开票接口（税控+数电） [1.1.08 创建负数单匹配任务](http://open-ultimate.piaozone.com/api-194841116.md): 本接口为异步接口，需要结合1.1.09接口使用
- 开票 > 单据开票接口（税控+数电） [1.1.09 查询负数单匹配任务结果](http://open-ultimate.piaozone.com/api-194893206.md): 
- 开票 > 单据开票接口（税控+数电） [1.1.10 单据开票预览](http://open-ultimate.piaozone.com/api-205766529.md): 
- 开票 > 直接开票接口 > 数电开票 > 电子税局操作 [2.1.30 电子税局登录检测](http://open-ultimate.piaozone.com/api-146003700.md): 
- 开票 > 直接开票接口 > 数电开票 [2.1.01 数电票蓝字发票开具](http://open-ultimate.piaozone.com/api-149332334.md): 返回编码统一参考：[《返回编码说明》](doc-3799582)
- 开票 > 直接开票接口 > 数电开票 [2.1.02 数电票回调](http://open-ultimate.piaozone.com/api-146003694.md): 返回编码统一参考：[《返回编码说明》](doc-3799582)
- 开票 > 直接开票接口 > 数电开票 [2.1.03 红字确认单生成](http://open-ultimate.piaozone.com/api-146003697.md): 1、数电票红冲，税局规定必须先申请红字确认单，再根据红字确认单红冲。本接口仅支持申请红字确认单，申请成功，需再次调用开具红冲接口。
- 开票 > 直接开票接口 > 数电开票 [2.1.04 数电票红冲（直接红冲或通过红字确认单）](http://open-ultimate.piaozone.com/api-146003698.md): ### 接口说明
- 开票 > 直接开票接口 > 数电开票 [2.1.05 授信额度查询](http://open-ultimate.piaozone.com/api-146003699.md): 支持通过乐企、RPA查询授信额度
- 开票 > 直接开票接口 > 数电开票 [2.1.08 红字确认单撤销](http://open-ultimate.piaozone.com/api-146003702.md): 
- 开票 > 直接开票接口 > 数电开票 [2.1.09 红字确认单确认或拒绝](http://open-ultimate.piaozone.com/api-146003703.md): 
- 开票 > 直接开票接口 > 数电开票 [2.1.12 红字确认单下载](http://open-ultimate.piaozone.com/api-146003706.md): 
- 开票 > 直接开票接口 > 数电开票 [2.1.13 红字确认单编号查询](http://open-ultimate.piaozone.com/api-146003707.md): 
- 开票 > 直接开票接口 > 数电开票 [2.1.14 发票用途状态查询（发票云版本6.0.11支持，暂只支持乐企）](http://open-ultimate.piaozone.com/api-169226962.md): 税局最新规则，购方未勾选未入账等未使用蓝票的情形，支持进行部分红冲、全额红冲，红冲时，不需要对方确认。
- 开票 > 直接开票接口 > 税控开票 [2.2.01税控开票（直接开票，不支持拆分合并）](http://open-ultimate.piaozone.com/api-146003708.md): 0：成功
- 开票 > 直接开票接口 > 税控开票 [2.2.02税控发票快速红冲（仅支持全额红冲）](http://open-ultimate.piaozone.com/api-146003709.md): 
- 开票 > 直接开票接口 > 税控开票 [2.2.03税控发票作废](http://open-ultimate.piaozone.com/api-146003710.md): 
- 开票 > 直接开票接口 > 税控开票 [2.2.04税控红字信息表申请](http://open-ultimate.piaozone.com/api-146003711.md): 
- 开票 > 直接开票接口 > 税控开票 [2.2.05税控红字信息表下载](http://open-ultimate.piaozone.com/api-146003712.md): 
- 开票 > 直接开票接口 > 税控开票 [2.2.06税控发票库存查询](http://open-ultimate.piaozone.com/api-146003714.md): 
- 开票 > 直接开票接口 > 税控开票 [2.2.07税控开票设备查询](http://open-ultimate.piaozone.com/api-146003715.md): 
- 开票 > 直接开票接口 > 税控开票 [2.2.08税控发票打印发票打印（需安装套打打印组件，仅适用于局域网内的HTTP调用方式）](http://open-ultimate.piaozone.com/api-148963963.md): 状态码：
- 开票 > 直接开票接口 > 税控开票 [2.2.09税控发票打印（仅适用于组件开票，托管无法使用）](http://open-ultimate.piaozone.com/api-146003716.md): 
- 开票 > 直接开票接口 > 税控开票 [2.2.10邮件短信重发（数电票和税控发票都支持）](http://open-ultimate.piaozone.com/api-146003717.md): 
- 开票 > 直接开票接口 > 税控开票 [2.2.11税控机动车发票开具](http://open-ultimate.piaozone.com/api-146003718.md): 
- 开票 > 直接开票接口 > 税控开票 [2.2.12税控机动车发票作废](http://open-ultimate.piaozone.com/api-146003719.md): 
- 开票 > 直接开票接口 > 税控开票 [2.2.13税控机动车发票红冲](http://open-ultimate.piaozone.com/api-148963964.md): 
- 开票 > 直接开票接口 > 税控开票 [2.2.14税控机动车发票打印](http://open-ultimate.piaozone.com/api-148963965.md): 
- 开票 > 直接开票接口 > 税控开票 [2.2.15机动车信息查询（数电专用）](http://open-ultimate.piaozone.com/api-212114753.md): 
- 开票 > 发票查询接口 [4.1.01已开发票查询](http://open-ultimate.piaozone.com/api-146003723.md): 税控票或税控票+数电票共用时使用；纯数电票开票（比如直接开票-数电开票）请用4.1.04或4.1.03接口。
- 开票 > 发票查询接口 [4.1.02机动车发票查询（税控）](http://open-ultimate.piaozone.com/api-146003724.md): 
- 开票 > 发票查询接口 [4.1.03.数电票发票批量查询](http://open-ultimate.piaozone.com/api-146003725.md): 
- 开票 > 发票查询接口 [4.1.04.数电票发票单张查询](http://open-ultimate.piaozone.com/api-146003726.md): 
- 开票 > 回调接口（支持除数电票直接开票接口外的开票回调） [5.1.01开票申请单回退接口（星瀚发起退回开票申请单）](http://open-ultimate.piaozone.com/api-146003720.md): 
- 开票 > 回调接口（支持除数电票直接开票接口外的开票回调） [5.1.02回调接口-按票回调(一次回调一张发票信息)](http://open-ultimate.piaozone.com/api-146003721.md): 默认开票回调方式。每开一张发票就回调一次一个开票申请单如果拆分开具了N张发票，在发票开具成功后，根据发票张数，会回调N次。
- 开票 > 回调接口（支持除数电票直接开票接口外的开票回调） [5.1.03回调接口-按单回调（单据对应的所有发票开票完毕后一起回调（包含开票成功和开票失败），不支持合并又拆分的场景）](http://open-ultimate.piaozone.com/api-146003722.md): 一个开票申请单如果拆分开具了N张发票，在发票开具完毕后，只全部回调一次，开票成功失败的都会返回
- 开票 > 开票风控接口 [6.0.01 风控解除接口（星瀚发票云版本6.0.6支持）](http://open-ultimate.piaozone.com/api-146003734.md): 返回编码表：
- 开票 > 扫码开票接口（税控+数电） > 业务系统生成二维码链接模式 [3.1.01业务系统组装二维码链接格式](http://open-ultimate.piaozone.com/api-146003735.md): `测试环境参数`
- 开票 > 扫码开票接口（税控+数电） > 业务系统生成二维码链接模式 [3.1.02查询订单接口(由客户提供)](http://open-ultimate.piaozone.com/api-146003736.md): 扫码开票二维码规则：
- 开票 > 扫码开票接口（税控+数电） > 业务系统生成二维码链接模式 [3.1.03 扫码提交购方抬头规则](http://open-ultimate.piaozone.com/api-146003737.md): **1  规则说明**
- 开票 > 扫码开票接口（税控+数电） > 业务系统生成二维码链接模式 [3.1.04账单中心开票小程序短链接生成](http://open-ultimate.piaozone.com/api-201555744.md): 本接口用于开票账单中心生成微信二维码短链接，生成的url可作为app等非微信客户端打开微信小程序的请求地址
- 开票 > 扫码开票接口（税控+数电） > 推单星瀚生成二维码链接模式 [3.2.01上传销售单获取二维码链接](http://open-ultimate.piaozone.com/api-146003738.md): 
- 收票 > 全票池引入 [5.01全票池导入](http://open-ultimate.piaozone.com/api-145421046.md): :::warning[]
- 收票 > 收票报销 [3.01 打开发票采集页面获取eventCode](http://open-ultimate.piaozone.com/api-145421047.md): 
- 收票 > 收票报销 [3.02 查看发票获取eventCode](http://open-ultimate.piaozone.com/api-145421048.md): 
- 收票 > 收票报销 [3.03 保存单据](http://open-ultimate.piaozone.com/api-145421049.md): 
- 收票 > 收票报销 [3.04 删除单据](http://open-ultimate.piaozone.com/api-145421050.md): 
- 收票 > 收票报销 [3.05 保存凭证](http://open-ultimate.piaozone.com/api-145421051.md): 
- 收票 > 收票报销 [3.06 删除凭证](http://open-ultimate.piaozone.com/api-145421052.md): 
- 收票 > 收票报销 [3.07 长轮询获取发票信息](http://open-ultimate.piaozone.com/api-145421053.md): 
- 收票 > 收票报销 [3.08 发票验重](http://open-ultimate.piaozone.com/api-145421054.md): 
- 收票 > 查询全票池的发票 [1.01 发票查询](http://open-ultimate.piaozone.com/api-145421056.md): - 发票数据结构在文档：《[发票数据结构](doc-3656826)》有描述
- 收票 > 查询全票池的发票 [1.02 发票查询（按流水号查询）](http://open-ultimate.piaozone.com/api-145421057.md): - 发票数据结构在文档：《[发票数据结构](doc-3656826)》有描述
- 收票 > 查询全票池的发票 [1.03获取单据文件信息](http://open-ultimate.piaozone.com/api-145421058.md): - 发票数据结构在文档：《[发票数据结构](doc-3656826)》有描述
- 收票 > 查询全票池的发票 [1.04 删除全票池发票](http://open-ultimate.piaozone.com/api-145421059.md): 
- 收票 > 税局下载发票和勾选认证 [4.01 税局登录](http://open-ultimate.piaozone.com/api-145421060.md): 
- 收票 > 税局下载发票和勾选认证 [4.02 进项发票表头归集](http://open-ultimate.piaozone.com/api-145421061.md): 
- 收票 > 税局下载发票和勾选认证 [4.03 进项发票表头归集结果查询](http://open-ultimate.piaozone.com/api-145421062.md): 用异步模式调用接口：[4.02 进项发票表头归集](api-145421061)时，使用本接口查询任务结果
- 收票 > 税局下载发票和勾选认证 [4.04 获取税款所属期信息](http://open-ultimate.piaozone.com/api-145421063.md): 
- 收票 > 税局下载发票和勾选认证 [4.05 发票勾选&撤销勾选](http://open-ultimate.piaozone.com/api-145421064.md): 注意：若在星瀚基础资料-企业信息-收票通道设置为“新电子发票服务平台”，即RPA通道进行勾选，需要减少勾选的频率，尽量合并多张发票一起提交勾选，否则有可能触发税局安全机制，导致勾选失败
- 收票 > 税局下载发票和勾选认证 [4.06 发票勾选结果查询](http://open-ultimate.piaozone.com/api-145421065.md): 用异步模式调用接口：[4.05 发票勾选/撤销勾选](api-145421064)时，使用本接口查询异步任务结果。
- 收票 > 税局下载发票和勾选认证 [4.07 当前统计查询](http://open-ultimate.piaozone.com/api-145421066.md): 
- 收票 > 税局下载发票和勾选认证 [4.08 生成&撤销统计表](http://open-ultimate.piaozone.com/api-145421067.md): 
- 收票 > 税局下载发票和勾选认证 [4.09 生成&撤销统计表结果查询](http://open-ultimate.piaozone.com/api-145421068.md): 异步执行[4.08 生成/撤销统计表](api-145421067)时，用本接口查询结果。
- 收票 > 税局下载发票和勾选认证 [4.10 确认统计表](http://open-ultimate.piaozone.com/api-145421069.md): 
- 收票 > 税局下载发票和勾选认证 [4.11 确认统计表结果查询](http://open-ultimate.piaozone.com/api-145421070.md): 
- 收票 > 税局下载发票和勾选认证 [4.12 变更税款所属期](http://open-ultimate.piaozone.com/api-145421071.md): 
- 收票 > 税局下载发票和勾选认证 [4.13 发票预勾选](http://open-ultimate.piaozone.com/api-192132771.md): 注意：若在星瀚基础资料-企业信息-收票通道设置为“新电子发票服务平台”，即RPA通道进行勾选，需要减少勾选的频率，尽量合并多张发票一起提交勾选，否则有可能触发税局安全机制，导致勾选失败
- 收票 > 税局下载发票和勾选认证 [4.14 发票预勾选确认](http://open-ultimate.piaozone.com/api-192155101.md): 注意：本接口为异步接口，增值税抵扣预勾选的发票确认之后会变为"已勾选"，根据响应返回的“任务号”调用“预勾选确认结果查询”接口获取结果
- 收票 > 税局下载发票和勾选认证 [4.15 预勾选确认结果查询](http://open-ultimate.piaozone.com/api-192160841.md): 注意：本接口查询是分页查询，每次请求pageNo+1,返回结果success数量+fail数据小于pageSize时可以结束
- 收票 > 税局下载发票和勾选认证 [4.16 批量创建税局入账申请任务](http://open-ultimate.piaozone.com/api-258669364.md): 
- 收票 > 税局下载发票和勾选认证 [4.17 查询税局入账申请任务结果](http://open-ultimate.piaozone.com/api-258669778.md): 
- 收票 > 识别查验 [2.01 发票查验](http://open-ultimate.piaozone.com/api-145421072.md): 本接口返回的发票结构参见：[发票数据结构](doc-3656826)
- 收票 > 识别查验 [2.02 发票识别查验](http://open-ultimate.piaozone.com/api-145421073.md): 接口说明：
- 收票 > 识别查验 [2.03 文件上传](http://open-ultimate.piaozone.com/api-145421074.md): 
- 收票 > 识别查验 [2.04 发票编辑](http://open-ultimate.piaozone.com/api-145421075.md): 本接口返回的发票结构参见：[发票数据结构](doc-3656826)
- 页面类 > 基础设置页面 [基础设置相关页面](http://open-ultimate.piaozone.com/api-145421084.md): 
- 页面类 > 开票页面 [开票相关页面](http://open-ultimate.piaozone.com/api-145421085.md): 
- 页面类 > 收票页面 [PC端打开选择发票页面](http://open-ultimate.piaozone.com/api-145421087.md): 参照：[《快速开始》](doc-3655357#收票对接)的收票对接一节
- 页面类 > 收票页面 [PC端打开查看发票页面](http://open-ultimate.piaozone.com/api-145421086.md): 参照：[《快速开始》](doc-3655357#收票对接)的收票对接一节
- 页面类 > 收票页面 [移动端打开查看发票页面](http://open-ultimate.piaozone.com/api-145421088.md): 参照：[《快速开始》](doc-3655357#收票对接)的收票对接一节
- 页面类 > 收票页面 [移动端打开选择发票页面](http://open-ultimate.piaozone.com/api-145421089.md): 参照：[《快速开始》](doc-3655357#收票对接)的收票对接一节
- 页面类 > 数据统计页面 [销项发票统计页面](http://open-ultimate.piaozone.com/api-145421090.md): 
- 页面类 [2.1、退出登录API接口](http://open-ultimate.piaozone.com/api-145421083.md): 
- 影像 > 1.基础接口 [1.01获取eventCode](http://open-ultimate.piaozone.com/api-145421030.md): 
- 影像 > 1.基础接口 [1.02接收ERP单据推送接口](http://open-ultimate.piaozone.com/api-145421031.md): 
- 影像 > 2.影像页面 [2.01PC端影像调阅](http://open-ultimate.piaozone.com/api-145421032.md): 
- 影像 > 2.影像页面 [2.02移动端影像调阅](http://open-ultimate.piaozone.com/api-145421033.md): 
- 影像 > 2.影像页面 [2.03影像采集页面](http://open-ultimate.piaozone.com/api-145421034.md): 
- 影像 > 2.影像页面 [2.04影像匹配结果页面](http://open-ultimate.piaozone.com/api-145421035.md): 
- 影像 > 3.影像操作 [3.01影像退扫](http://open-ultimate.piaozone.com/api-145421036.md): 
- 影像 > 3.影像操作 [3.02影像取消退扫](http://open-ultimate.piaozone.com/api-145421037.md): 
- 影像 > 3.影像操作 [3.03影像删除](http://open-ultimate.piaozone.com/api-145421038.md): 
- 影像 > 3.影像操作 [3.04获取PC端影像调阅页面地址](http://open-ultimate.piaozone.com/api-145421039.md): 
- 影像 > 3.影像操作 [3.05获取移动端影像调阅页面地址](http://open-ultimate.piaozone.com/api-145421040.md): 
- 影像 > 3.影像操作 [3.06影像状态查询](http://open-ultimate.piaozone.com/api-145421041.md): 
- 影像 > 4.采集接口 [4.01影像文件采集](http://open-ultimate.piaozone.com/api-145421042.md): base64和fileDownUrl至少需要其中一个。
- 影像 > 4.采集接口 [4.02影像单据提交](http://open-ultimate.piaozone.com/api-145421043.md): base64和fileDownUrl至少需要其中一个。
- 设置类 [3.1、切换组织](http://open-ultimate.piaozone.com/api-145421078.md): 
- 设置类 [3.2、新增组织（星空ERP专用）](http://open-ultimate.piaozone.com/api-145421079.md): 1、星空新增星瀚组织，会同时对税号或税盘进行授权；
- 设置类 [3.3、新增租户组织下的员工](http://open-ultimate.piaozone.com/api-145421080.md): # 授权注册接口说明
- 设置类 [3.4、查询电子税局账号](http://open-ultimate.piaozone.com/api-201880993.md): 
- 订单 [1.01 产品订阅（平台服务商专用）](http://open-ultimate.piaozone.com/api-145421076.md): 
- 订单 [发票云创建组织](http://open-ultimate.piaozone.com/api-145421077.md):