灵税宝AgentAPI
  1. 3.5 发票查询服务
灵税宝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 接口鉴权
    • 3.3 账户服务
      • 3.3.1 单位账户登录
      • 3.3.2 登录状态查询
    • 3.4 发票开具服务
      • 3.4.4 授信额度查询
      • 3.4.6 一般发票开具
    • 3.5 发票查询服务
      • 3.5.1 近十张发票查询接口
        POST
      • 3.5.6 发票下载
        POST
    • 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.5 发票查询服务

3.5.6 发票下载

POST
/agent/tax/v1/invoice/download

接口说明#

下载已开具成功的数电发票(包含红票和蓝票)

约束条件#

1.
调用 3.3.1 单位账户登录 接口成功

请求参数

Query 参数
appid
string 
必需
appid值，由平台提供
示例值:
Zu4PXFeyu7gX
timestamp
string 
Unix时间戳
必需
示例值:
1746979999
sign
string 
必需
hmac+sha256 加密
示例值:
d88b1f5c2ec5b8e016b8523edd5977e7549d6d73c3c01a0724410951c7be2b39
Body 参数application/json
reqid
string 
业务流水号
可选
guid值
nsrsbh
string 
纳税人识别号
必需
mobile
string 
电子税务局登录手机号
可选
fp_ hm
string 
发票号码
必需
20位的数电发票号码
kprq
string 
开票日期
必需
yyyymmddhhmmss
xzlx
string 
下载类型
必需
0:下载 PDF
1:下载 OFD
2:下载 XML
dqbm
string 
登录地区编码
可选
登录地区地区编码， 如果返回类型为1，地区编码不可为空。详情见3.6.23 登录地区编码
return_type
string 
返回类型
可选
不填默认按原逻辑返回，传1返回税局下载地址
online
string 
是否获取离线版式文件
可选
online 为0为获取税局版式文件； 为1时获取离线版式生成； 为2时离线下载税局文件
示例
{
    "reqid": "0196befe-f8f1-7000-bee5-9e7bf33e9c8f",
    "nsrsbh": "纳税人识别号",
    "mobile": "13097460590",
    "fp_hm": "发票号码",
    "kprq": "开票日期",
    "xzlx": "下载类型",
    "type": "返回类型",
    "dqbm": "地区编码",
    "return_type": "返回类型",
    "online": "是否获取离线版式文件"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://agentapi.lingshuibao.com/agent/tax/v1/invoice/download?appid=Zu4PXFeyu7gX&timestamp=1746979999&sign=d88b1f5c2ec5b8e016b8523edd5977e7549d6d73c3c01a0724410951c7be2b39' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reqid": "0196befe-f8f1-7000-bee5-9e7bf33e9c8f",
    "nsrsbh": "纳税人识别号",
    "mobile": "13097460590",
    "fp_hm": "发票号码",
    "kprq": "开票日期",
    "xzlx": "下载类型",
    "type": "返回类型",
    "dqbm": "地区编码",
    "return_type": "返回类型",
    "online": "是否获取离线版式文件"
}'

返回响应

🟢200成功
application/json
Body
code
integer 
错误码
可选
data
object 
schema.ResponseInvoiceDownload
必需
file_content_base64
string 
可选
Base64 文件流
ofd_url
string 
ofd 下载地址
可选
pdf_url
string 
pdf 下载地址
可选
xml_url
string 
xml 下载地址
可选
msg
string 
错误信息
可选
示例
{
    "code": 0,
    "data": {
        "file_content_base64": "文件内容太长，这里不显示,接口完整响应见invoice.josn文件......"
    },
    "msg": ""
}
🟠400请求有误
🔴500服务器错误
上一页
3.5.1 近十张发票查询接口
下一页
3.6.1 特定要素类型