1.单机版纸电一体开票

1.1 使用要求：需要在同一台服务器上安装发票云组件、开票软件、插入税控设备，缺少任一都无法完成开票（开数电票除外）

1.2 测试参数

点击具体接口文档的“调试”按钮，在弹窗界面中做配置

1.3 接口简单讲解

1.3.1 读取税盘信息(1.01) 用户可以通过该接口获取当前税盘所在企业的基础信息以及税盘能开的票种的发票余量。

1.3.2 读取票种信息(1.02)

用户可以通过该接口获取指定票种的发票余量

1.3.3 发票开具(1.03)

用户可以通过该接口开具全票种(发票类型 0：专用发票 2：普通发票 41：卷式发票,51:电子发票,61:电子专票(税务ukey才能开具))的蓝票和红票，
红票包含全量红冲、局部红冲，可根据业务需要自行选择。文档中字段已标注必填和非必填，在对接接口时务必将必填字段填写，其余非必填字段则根据具体业务需要填写。

如果有开票场景不知如何填写参数可参考文档中的测试用例数据。

流水号字段(fpqqlsh,对应返回结果中的ddh字段)要求20位，如果不满20位或者未填写则由发票云系统生成，流水号可作为发票云中该发票信息的唯一标识。
另外还有一个订单号字段(ddh对应返回结果中的business_id字段)，推荐用户通过订单号字段来关联发票云返回结果和自身系统业务数据

关于金额的填写和红票的填写规范可参考API tab页中的“额外说明文档”

1.3.4 发票作废(1.04)

纸票当月作废，隔月红冲。用户可传入发票代码和发票号码来对发票进行作废。

1.3.5 发票查询(1.05)

用户传入发票种类以及发票代码和发票号码来查询发票的详细数据，包含用户上传的发票数据以及开票成功信息（发票代码、发票号码、如果是电票则还有PDF文件链接）

1.3.6 发票打印（1.06）

测试环境不支持发票打印，需要正式环境调试，正式环境打印设置可参考发票云产品邮件提供的解决方法，如果还不清楚可咨询发票云交付人员

1.3.7 专用发票申请红字信息表 (1.07)

测试环境由于测试税盘不支持，因此该接口没办法在测试环境测试，需要在正式环境测试。
纸质专票当月作废(调用发票作废(1.04))，隔月红冲，红冲的时候需要先申请红字信息表获取红字信息表编号，然后调用（1.03发票开具）接口开红票
电子专票的开具和红冲目前只有税务ukey才支持，红冲的时候需要先申请红字信息表获取红字信息表编号，然后调用（1.03发票开具）接口开红票

填写规则除了金额必须是负数之外，和开票接口保持一致

1.3.8 查询专用发票申请红字信息表(1.08)

用户通过改接口可以查询自己或者客户在选定时间内税号是本企业税号的所有红字信息表信息，包含申请成功的和未申请成功的，
当前如果未申请成功可关闭发票云组件打开开票软件找到红字信息表页面点击下载按钮从税局下载红字信息表数据并修正数据再提交，
切记不可通过发票云接口重复提交申请。如果不慎重复提交则需要在开票软件红字信息表页面撤销多余的并修改剩余的申请表数据并点击提交按钮。

1.3.9 批量打印（1.09）

测试环境不支持发票打印，需要正式环境调试，正式环境打印设置可参考发票云产品邮件提供的解决方法，如果还不清楚可咨询发票云交付人员

1.3.10 设置开票发票卷(1.10)

一般来说每个月初企业的税盘需要拿到税局对上个月的发票做清盘报税，同时税局会给税盘分配当月可开票的发票号码区间，
如果需要的发票数量较多则会分成多个发票卷，用户可根据自身业务需求设置当前开票的发票卷。

1.3.11 机动车销售统一发票开具（1.11）

测试环境由于测试税盘不支持，因此该接口没办法在测试环境测试，需要在正式环境测试。

流水号字段(orderid,对应返回结果中的ddh字段)要求20位，如果不满20位或者未填写则由发票云系统生成，流水号可作为发票云中该发票信息的唯一标识。
另外还有一个订单号字段(business_id对应返回结果中的business_id字段)，推荐用户通过订单号字段来关联发票云返回结果和自身系统业务数据

1.3.12 机动车销售统一发票查询（1.12）

测试环境由于测试税盘不支持，因此该接口没办法在测试环境测试，需要在正式环境测试。

用户通过发票代码、发票号码来查询发票的详细数据，包含用户上传的发票数据以及开票成功信息（发票代码、发票号码）

1.3.13 机动车销售统一发票红冲（1.13）

测试环境由于测试税盘不支持，因此该接口没办法在测试环境测试，需要在正式环境测试。

用户传入发票种类以及发票代码和发票号码进行红冲

1.3.14 寄送信息查询（1.14）

税务ukey才支持
查询纸票申领人的信息

1.3.15 核定票种查询（1.15）

税务ukey才支持
纳税人办理税务登记后需领用发票时，必须向主管税务机关申请办理票种核定，确认领用发票的种类、数量、开票限额等事项。用户可通过该接口查询自身的票种核定信息

1.3.16 发票申领（1.16）

支持百旺、ukey发票申领

1.3.17 发票申领结果查询（1.17）

税务ukey才支持

1.3.18 数据抄报（1.18）

航信 ukey才支持
申报增值税之前，必须先完成税盘抄报税

1.3.19 批量查询发票（1.19）

1.3.20 监控信息查询（1.20）

每个税盘都可以在税局申请离线开票金额，该接口可查询剩余可离线开票的金额

1.3.21 二手车-发票开具（1.21）

仅支持航天信息金税盘

1.3.22 二手车-发票查询（1.22）

仅支持航天信息金税盘

1.3.23 二手车-发票红冲（1.23）

仅支持航天信息金税盘

1.3.24 发票统计信息查询（1.24）

用户可通过该接口查询某个票种在某个月份申领、作废、红冲、正票、负票的统计金额以及数量

1.3.25 红字信息表撤销（1.25）

仅支持航信税盘和税务UKEY
航信税盘能开纸质专票
税务ukey能开纸质专票和电子专票
只有纸质专票和电子专票红冲才需要申请红字信息表，因此此接口也只适用于纸质专票、电子专票红冲场景

1.3.26 电子发票开具（2.01）

该接口只能开电子普通发票，对接细节同发票开具(1.03)

1.3.27 电子发票信息查询（2.02）

该接口可通过发票流水号(发票云发票唯一标识)查询电子发票信息，包含用户上传的发票信息以及开票成功的信息(发票代码、发票号码、PDF文件链接）)

1.3.28 电子发票红冲（2.03）

用户通过该接口既可以传入发票代码、号码也可以传入发票流水号进行全量红冲

1.3.29 刷新PDF（2.04）

该接口主要用于防止偶然情况的发生
如果开票成功，但是返回的PDF链接打不开(超过五分钟)或者发生损坏，在发票云对该发票进行修复之后，按照代码号码或者流水号对当前PDF未生成的电子发票进行重新签章
（只有当前未生成PDF的发票才会进行重签）

1.3.30 查询电子发票余量（2.05）

该接口可用于查询税盘中电子发票剩余可开的数量，通常用于告警用户及时去税局申请发票

1.3.31 查询税收分类编码信息（3.01）

通过传入税收分类编码可查询其对应的商品简称

1.3.32 获取打印机列表（3.03）

获取"金蝶发票管理应用程序"所在电脑的所有打印机连接信息

1.4 场景接口调用

1.4.1 给客户开的普通纸票，客户发生了退货行为

先用发票开具(1.03)接口开普通纸票--》客户退货--》调用发票作废(1.04)接口对发票进行作废
--》如果客户部分退货，对客户剩余未退货商品调用发票开具(1.03)接口重新开票，如果客户全部退货则不需要处理

1.4.2 给客户开的普通电票，客户发生了退货行为

先用电子发票开具（2.01）接口开具电票-》客户退货
--》如果是部分退货调用电子发票开具（2.01）接口开对应退货金额的红票，如果全部退货则调用电子发票红冲（2.03）接口进行全额红冲

1.4.3 给客户开的纸质专票，客户发生了退货行为

先用发票开具(1.03)接口开纸质专票-》客户如果当月退货，处理方式同上普通纸票退货；客户如果隔月退货，则需要调用专用发票申请红字信息表 (1.07)接口获取红字信息表编号--》如果此时客户取消了退货行为，则可以调用红字信息表撤销（1.25）接口来取消红冲，
如果仍需要退货则调用发票开具(1.03)接口开对应退货金额的红票（部分退货和全部退货都如此处理）

1.4.4 给客户开的电子专票，客户发生了退货行为(税务ukey)

先用发票开具(1.03)接口开电子专票--》客户退货--》调用专用发票申请红字信息表 (1.07)接口获取红字信息表编号
--》如果此时客户取消了退货行为，则可以调用红字信息表撤销（1.25）接口来取消红冲，
如果仍需要退货则调用发票开具(1.03)接口开对应退货金额的红票（部分退货和全部退货都如此处理）

业务场景下接口调用顺序

1.单机版纸电一体开票#

1.1 使用要求：需要在同一台服务器上安装发票云组件、开票软件、插入税控设备，缺少任一都无法完成开票（开数电票除外）#

1.2 测试参数#

1.3 接口简单讲解#

1.3.1 读取税盘信息(1.01) 用户可以通过该接口获取当前税盘所在企业的基础信息以及税盘能开的票种的发票余量。#

1.3.2 读取票种信息(1.02)#

1.3.3 发票开具(1.03)#

1.3.4 发票作废(1.04)#

1.3.5 发票查询(1.05)#

1.3.6 发票打印（1.06）#

1.3.7 专用发票申请红字信息表 (1.07)#

1.3.8 查询专用发票申请红字信息表(1.08)#

1.3.9 批量打印（1.09）#

1.3.10 设置开票发票卷(1.10)#

1.3.11 机动车销售统一发票开具（1.11）#

1.3.12 机动车销售统一发票查询（1.12）#

1.3.13 机动车销售统一发票红冲（1.13）#

1.3.14 寄送信息查询（1.14）#

1.3.15 核定票种查询（1.15）#

1.3.16 发票申领（1.16）#

1.3.17 发票申领结果查询（1.17）#

1.3.18 数据抄报（1.18）#

1.3.19 批量查询发票（1.19）#

1.3.20 监控信息查询（1.20）#

1.3.21 二手车-发票开具（1.21）#

1.3.22 二手车-发票查询（1.22）#

1.3.23 二手车-发票红冲（1.23）#

1.3.24 发票统计信息查询（1.24）#

1.3.25 红字信息表撤销（1.25）#

1.3.26 电子发票开具（2.01）#

1.3.27 电子发票信息查询（2.02）#

1.3.28 电子发票红冲（2.03）#

1.3.29 刷新PDF（2.04）#

1.3.30 查询电子发票余量（2.05）#

1.3.31 查询税收分类编码信息（3.01）#

1.3.32 获取打印机列表（3.03）#

1.4 场景接口调用#

1.4.1 给客户开的普通纸票，客户发生了退货行为#

1.4.2 给客户开的普通电票，客户发生了退货行为#

1.4.3 给客户开的纸质专票，客户发生了退货行为#

1.4.4 给客户开的电子专票，客户发生了退货行为(税务ukey)#

1.单机版纸电一体开票

1.1 使用要求：需要在同一台服务器上安装发票云组件、开票软件、插入税控设备，缺少任一都无法完成开票（开数电票除外）

1.2 测试参数

1.3 接口简单讲解

1.3.1 读取税盘信息(1.01) 用户可以通过该接口获取当前税盘所在企业的基础信息以及税盘能开的票种的发票余量。

1.3.2 读取票种信息(1.02)

1.3.3 发票开具(1.03)

1.3.4 发票作废(1.04)

1.3.5 发票查询(1.05)

1.3.6 发票打印（1.06）

1.3.7 专用发票申请红字信息表 (1.07)

1.3.8 查询专用发票申请红字信息表(1.08)

1.3.9 批量打印（1.09）

1.3.10 设置开票发票卷(1.10)

1.3.11 机动车销售统一发票开具（1.11）

1.3.12 机动车销售统一发票查询（1.12）

1.3.13 机动车销售统一发票红冲（1.13）

1.3.14 寄送信息查询（1.14）

1.3.15 核定票种查询（1.15）

1.3.16 发票申领（1.16）

1.3.17 发票申领结果查询（1.17）

1.3.18 数据抄报（1.18）

1.3.19 批量查询发票（1.19）

1.3.20 监控信息查询（1.20）

1.3.21 二手车-发票开具（1.21）

1.3.22 二手车-发票查询（1.22）

1.3.23 二手车-发票红冲（1.23）

1.3.24 发票统计信息查询（1.24）

1.3.25 红字信息表撤销（1.25）

1.3.26 电子发票开具（2.01）

1.3.27 电子发票信息查询（2.02）

1.3.28 电子发票红冲（2.03）

1.3.29 刷新PDF（2.04）

1.3.30 查询电子发票余量（2.05）

1.3.31 查询税收分类编码信息（3.01）

1.3.32 获取打印机列表（3.03）

1.4 场景接口调用

1.4.1 给客户开的普通纸票，客户发生了退货行为

1.4.2 给客户开的普通电票，客户发生了退货行为

1.4.3 给客户开的纸质专票，客户发生了退货行为

1.4.4 给客户开的电子专票，客户发生了退货行为(税务ukey)