1. 认证与安全[RPA/NS共用]
发票云(生态版)API文档
  • 错误处理 & 错误编码
  • 认证与安全[RPA/NS共用]
    • 内容安全
    • 认证
      POST
  • 订单[RPA/NS共用]
    • 对接指引
    • 创建订单
      POST
    • 关闭订单
      POST
    • 查询订单列表
      GET
  • 基础资料[RPA/NS共用]
    • 对接指引
    • 新增常用开票项
      POST
    • 删除常用开票项
      POST
    • 查询常用开票项列表
      GET
    • 新增常用不动产租赁明细
      POST
    • 删除常用不动产租赁明细
      POST
    • 查询常用不动产租赁明细列表
      GET
    • 新增电子税局账号
      POST
    • 删除电子税局账号
      POST
    • 查询电子税局账号列表
      GET
  • 开票[RPA/NS共用]
    • 对接指引
    • 查询电子税局账号状态
      GET
    • 登录电子税局账号
      POST
    • 获取电子税局扫脸认证二维码信息
      POST
    • 获取扫脸认证结果
      GET
    • 查询企业授信额度
      GET
    • 创建发票开具任务
      POST
    • 修改发票的开具任务
      PATCH
    • 查询发票的开具任务结果
      GET
  • 乐企联用[NS专用]
    • 创建乐企联用申请
    • 查询乐企联用申请结果
  • 发票查验
    • 发票查验
  • 数据模型
    • 开票数据结构
      • 订单
      • 电子税局账号
      • 企业对象
      • InvoiceLineItem
      • 不动产租赁明细
      • 税局城市编码
      • 电子税局登录角色
      • 扫脸认证二维码信息
      • 两位小数金额的字符串
      • 开票数据
      • 乐企联用申请
    • 公用代码
      • 医疗机构类型
      • 证件类型
      • 零税率标识
      • 发票状态标识
      • 是否蓝字发票
      • 开具类型(代开标识)
    • 查验数据结构
      • 发票状态
      • 发票类型
      • 数字化电子发票-增值税发票数据
      • 增值税发票数据
      • 增值税普通发票(卷式)数据
      • 增值税普通发票(通行费)数据
      • 机动车销售统一发票数据
      • 二手车销售统一发票数据
      • 航空运输客票电子行程单数据
      • 铁路电子客票数据
      • 数字化电子发票-机动车销售统一发票数据
      • 数字化电子发票-二手车销售统一发票数据
      • 财政票据数据
    • 响应数据结构
      • 错误响应
      • 分页信息
      • 批量新增的返回
      • 批量删除的返回
  1. 认证与安全[RPA/NS共用]

内容安全

Body加解密说明#

基于请求内容的安全等级要求不同,请求可选择SM4加密方式进行传输Body,可通过请求头字段“X-Encryption-Mode”设置使用,如下介绍如何使用 Java 工具类,基于 国密 SM4 算法 + GCM 模式,实现安全的加密与解密。该类可作为一个轻量级 SDK 集成到你的项目中。
💡
只支持Method:post,Content-Type:application/json的请求Body,响应不加密。

一、功能简介#

✅ 自定义密钥对应于申请授权时的加密密钥(encrypt_key)
✅ 使用 SM4/GCM/NoPadding 模式进行加密和解密
✅ 自动生成安全随机 IV(12 字节,GCM 推荐长度)
✅ 使用 SM3 对字符串密钥进行摘要,派生出 SM4 密钥
✅ Base64 输出,便于网络传输和存储
✅ 使用 BouncyCastle 作为密码学提供者
✅ GCM 模式自带完整性校验(防篡改)

二、依赖环境#

1. JDK 版本#

JDK 8 及以上

2. Maven 依赖#

<dependencies>
    <!-- BouncyCastle 国密支持 -->
    <dependency>
        <groupId>org.bouncycastle</groupId>
        <artifactId>bcprov-jdk15on</artifactId>
        <version>1.79</version>
    </dependency>

    <!-- Apache Commons Codec(Base64) -->
    <dependency>
        <groupId>commons-codec</groupId>
        <artifactId>commons-codec</artifactId>
        <version>1.15</version>
    </dependency>

    <!-- Apache Commons Lang -->
    <dependency>
        <groupId>commons-lang</groupId>
        <artifactId>commons-lang</artifactId>
        <version>2.6</version>
    </dependency>
</dependencies>

3. 代码#

修改于 2026-04-24 06:36:19
上一页
错误处理 & 错误编码
下一页
认证
Built with