增值税全电发票版式文件下载
使用说明
统一接口版本号 v2
八戒财税提供增值税全电发票版式文件下载,可下载以下类型的全电发票原件:
| 文件类型 |
|---|
| PDF 、ODF 、XML |
接口列表和资费
该接口为异步接口,下载文件需遵循以下两步流程(两步使用相同的入参):
- 创建任务:调用“创建下载任务”接口,发起文件下载请求。
- 获取地址:调用“获取下载地址”接口,领取生成的文件下载链接。
不同接口单次请求成功消耗的资源点数不同,具体如下
| 接口路径 | 消耗资源点 | 功能 | 描述 |
|---|---|---|---|
| /v2/invoice/createTask | 0 | 生成下载任务 | 生成下载任务 |
| /v2/invoice/downloadUrls | 4 | 获取下载链接 | 获取下载链接 |
创建下载任务
接口 URL: /v2/invoice/createTask
| 参数名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| fphm | String | 是 | 发票号码(20位纯数字的字符串) |
| kprq | String | 是 | 开票日期,建议格式YYYYMMDD |
| jshj | String | 是 | 价税合计 |
| fileTypes | String | 否 | 需要获取的文件类型,由英文逗号分隔的文件类型。如:"PDF, XML, OFD",不传获取全部类型 |
获取下载地址
接口 URL: /v2/invoice/downloadUrls
| 参数名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| fphm | String | 是 | 发票号码(20位纯数字的字符串) |
| kprq | String | 是 | 开票日期,建议格式YYYYMMDD |
| jshj | String | 是 | 价税合计 |
| fileTypes | String | 否 | 需要获取的文件类型,由英文逗号分隔的文件类型。如:"PDF, XML, OFD",不传获取全部类型 |
响应结果
创建下载任务
{
"success": true // '表示任务创建成功,后续调用获取下载地址即可'
}
获取下载地址
{
"urls": {
"xml_url": "xml文件下载地址",
"ofd_url": "ofd文件下载地址",
"pdf_url": "pdf文件下载地址"
}
}
错误码定义
参考错误码定义