用票管理
  1. 概述
用票管理
  • 概述
    • 公共请求参数说明
  • 进项通道登录
    • 获取access_token
      POST
    • 企业账号登录
      POST
    • 虚拟手机号登录
      POST
  • 进项业务接口
    • 发票状态查询
      POST
    • 发票明细查询
      POST
    • 全量全电发票下载
      POST
    • 获取进销项发票详情
      POST
    • 进销项发票概要信息查询
      POST
    • 发票查验结果查询
      POST
    • 实时未认证发票查询
      POST
    • 实时已认证发票查询
      POST
    • 发票勾选
      POST
    • 企业实时确认签名
      POST
    • 出口退税查询
      POST
    • 出口退税统计发票明细查询
      POST
    • 出口退税勾选
      POST
    • 出口退税用途确认
      POST
    • 实时海关缴款书查询
      POST
    • 抵扣海关缴款书勾选
      POST
    • 海关缴款书不抵扣查询
      POST
    • 海关缴款书不抵扣勾选
      POST
    • 海关缴款书退税抵扣查询
      POST
    • 海关缴款书退税抵扣勾选
      POST
    • 海关缴款书历史统计数据查询
      POST
    • 海关缴款书采集查询
      POST
    • 海关缴款书手动录入
      POST
    • 发票入账标识查询
      POST
    • 发票入账提交
      POST
    • 发票入账调整
      POST
  1. 概述

公共请求参数说明

请求头参数#

字段类型名称必填注释
nsrsbhString纳税人识别号是接口调用方税号
fplxString是固定值“jxfp”
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:47
下一页
获取access_token
Built with