增值税全电发票版式文件下载

使用说明

统一接口版本号 v2

八戒财税提供增值税全电发票版式文件下载,可下载以下类型的全电发票原件:

文件类型
PDF 、ODF 、XML

接口列表和资费

该接口为异步接口,下载文件需遵循以下两步流程(两步使用相同的入参):

  1. 创建任务:调用“创建下载任务”接口,发起文件下载请求。
  2. 获取地址:调用“获取下载地址”接口,领取生成的文件下载链接。

不同接口单次请求成功消耗的资源点数不同,具体如下

接口路径 消耗资源点 功能 描述
/v2/invoice/createTask 0 生成下载任务 生成下载任务
/v2/invoice/downloadUrls 4 获取下载链接 获取下载链接

创建下载任务

接口 URL: /v2/invoice/createTask

参数名称类型必选描述
fphmString发票号码(20位纯数字的字符串)
kprqString开票日期,建议格式YYYYMMDD
jshjString价税合计
fileTypesString需要获取的文件类型,由英文逗号分隔的文件类型。如:"PDF, XML, OFD",不传获取全部类型

获取下载地址

接口 URL: /v2/invoice/downloadUrls

参数名称类型必选描述
fphmString发票号码(20位纯数字的字符串)
kprqString开票日期,建议格式YYYYMMDD
jshjString价税合计
fileTypesString需要获取的文件类型,由英文逗号分隔的文件类型。如:"PDF, XML, OFD",不传获取全部类型

响应结果

创建下载任务

{
  "success": true // '表示任务创建成功,后续调用获取下载地址即可'
}

获取下载地址

{
  "urls": {
    "xml_url": "xml文件下载地址",
    "ofd_url": "ofd文件下载地址",
    "pdf_url": "pdf文件下载地址"
  }
}

错误码定义

参考错误码定义