开票管理
  1. 概述
开票管理
  • 概述
    • 公共请求参数说明
    • 响应状态码
  • 账户服务
    • 获取access_token
      POST
    • 企业账户登录
      POST
  • 开票服务
    • 获取风险预警级别接口
      POST
    • 获取二维码
      POST
    • 二次认证状态查询接口
      POST
    • 直接发票开具接口（金四）
      POST
    • 货物运输直接发票开具接口（金四）
      POST
    • 申请查询蓝票订单结果（金四）
      POST
    • 获取蓝票订单申请的处理结果（金四）
      POST
    • 发票列表查询（蓝\红票）（金三+金四）
      POST
    • 单张发票查询（蓝\红票）（金四）
      POST
    • 发票下载（金四）
      POST
    • 红字确认单开具接口（金三+金四）
      POST
    • 红字确认单处理（金四）
      POST
    • 红字确认单详情查询（金四）
      POST
    • 红字确认单列表查询（金四）
      POST
    • 红字确认单下载
      POST
    • 发票冲红状态查询（蓝票对应红票状态查询 蓝\红票）（金四）
      POST
    • 发票用票信息状态查询（金四）
      POST
    • 查询发票明细接口（金三+金四）
      POST
  1. 概述

公共请求参数说明

请求头参数#

字段类型名称必填注释
nsrsbhString纳税人识别号是接口调用方税号
access_tokenStringaccess_token是通过“获取access_token”接口获取，除“获取access_token”接口外，其余接口访问均需携带此参数

请求体参数#

字段类型名称必填注释
signString签名串是用户请求参数的签名串
signTypeString加密类型是目前支持RSA
timestampString请求时间是yyyy-MM-dd HH:mm:ss
contentString业务报文是请求参数的集合，除公共参数外所有请求参数都必须放在这个参数中传递
servernameString调用端标识是传业务系统简称
后续接口文档中的报文格式会省略外层结构，仅展示content节点加密前的明文内容
请求中content节点密文生成规则：先对明文json对象转成字符串，再使用3DES密钥对其进行3DES加密。
encryptContent=encrypt3DES(pwd,明文)
请求中sign签名值生成规则：将属性按ASCII码排序后，将key=value形式用&拼接后，使用企业私钥用RSA算法进行签名
toSignStr=content=encryptContent&servername=业务系统简称&signType=RSA&timestamp=2025-01-01 12:00:00
sign=RSA.sign(toSignStr,company_private_key)
注意：每个nsrsbh都拥有唯一的RSA密钥及3DES密钥信息

响应体参数#

字段类型名称必填注释
codeString响应状态码是成功为0000，其余为失败
messageString提示信息是
contentObject响应内容是
signString签名串是服务端响应参数的签名串
signTypeString加密类型是目前支持RSA
响应中content解密规则：使用3DES密钥对其进行3DES解密，可得到明文content的json字符串
content=decrypt3DES(pwd,密文)
响应中sign签名值验证规则：将属性按ASCII码排序后，将key=value形式用&拼接后，使用公钥用RSA算法进行验签。
toVerifyStr=code=0000&content=密文&message=success&signType=RSA
verifyResult=RSA.verify(toVerityStr,sign,public_key)
若verifyResult=true则证明响应内容未受到篡改
修改于 2025-04-28 02:41:26
下一页
响应状态码
Built with