灵税宝AgentAPI
  1. 3.2 接口协议说明
灵税宝AgentAPI
  • 灵税宝AI Agent开放平台
  • 1. 产品服务
    • 1.1 工商注册
    • 1.2 智能财税
      • 1.2.1 AI财税管理
      • 1.2.2 财税大模型
    • 1.3 即时结算
      • 1.3.1 即时结算管理
    • 1.4 风控预警
      • 1.4.1 大数据风控系统
  • 2. 解决方案
    • 2.1 即时配送解决方案
  • 3. 税务接口定义
    • 3.2 接口协议说明
      • 3.2.1 税务接口通信协议
      • 3.2.1 接口鉴权
        POST
    • 3.3 账户服务
      • 3.3.1 单位账户登录
      • 3.3.2 登录状态查询
    • 3.4 发票开具服务
      • 3.4.4 授信额度查询
      • 3.4.6 一般发票开具
    • 3.5 发票查询服务
      • 3.5.1 近十张发票查询接口
      • 3.5.6 发票下载
    • 3.6 附录
      • 3.6.1 特定要素类型
      • 3.6.2 申请状态
      • 3.6.3 增值税税率、征收率
      • 3.6.4 减按征收类型
      • 3.6.5 交通工具类型
      • 3.6.6 电子发票状态
      • 3.6.7 纳税人类型
      • 3.6.8 差额征收类型
      • 3.6.9 差额凭证类型
      • 3.6.10 发票票种
      • 3.6.11 身份证件类型
      • 3.6.17 发票状态
      • 3.6.18 发票类型
      • 3.6.19 发票来源
      • 3.6.20 发票来源与发票类型的对照关系
      • 3.6.21 冲红原因
      • 3.6.22 特定征税方式代码
      • 3.6.23 登录地区编码
      • 3.6.24 增值税特殊管理类型
      • 3.6.25 发票入账状态代码
      • 3.6.26 授信类别等级
      • 3.6.27 经办人国籍代码
      • 3.6.28 即征即退类型代码
      • 3.6.29 经办人身份类型
  • 4. 银行接口定义
    • 4.2 批量结算服务
      • 4.2.1 银行接口通信协议
      • 4.2.2 批量结算
      • 4.2.3 批量结算反馈
  1. 3.2 接口协议说明

3.2.1 税务接口通信协议

接口调用流程图#

税务接口-1.png
灵税宝AI Agent税务接口通信协议流程图
所有接口都使用 HTTPS 协议，JSON 数据格式和 UTF-8 编码。
接口使用 GET 和 POST 两种操作，其他类型操作（如 PUT）皆不会用到。

接口鉴权#

调用 3.2.1 接口鉴权函数，签发token数据。

参数加密#

所有数据的签名加密使用平台发放的密钥进行加密；
示例使用的用户名为 appid Zu4PXFeyu7g 密钥 appsecret 为 JA3UITZXGJKVMTCSLF3EONLJNNCXEOLNGQ3TSYI,密钥appsecret 只在加密计算中使用，不要在网络请求中传输。
加密算法为： HMAC + SHA256，加密流程如下：

1. 生成待加密数据#

对所有API请求参数（包括uri path,url参数与body参数，body需进行去除换行符的序列化(压缩转义JSON)。
签名数据伪代码如下

body举例#

body序列化后结果#

生成的待加密数据#

2. HMAC+SHA256加密结果#

3. HMAC+SHA256加密java示例代码#

请求接口模板#

Java示例代码#

教程#

Demo示例代码#

登录动态码Java代码#

golang示例代码#

golang版本签名核心代码#

golang版本平台登录动态码生成代码#

上一页
2.1 即时配送解决方案
下一页
3.2.1 接口鉴权