文档中心 开票接口 根据外部交易号查询发票下载地址

根据外部交易号查询发票下载地址

1.功能说明

根据外部交易号查询发票下载地址

2.接口调用说明

请求URL

https://openapi.guanaitong.tech/invoice/getInvoiceUrl

正式环境和测试环境的域名请见通用协议

HTTPS请求方式

POST

输入参数说明

(1)公共参数

发送请求是必须传入公共参数,详见公共参数

(2)私有参数

参数名称 是否必须 参数类型 长度限制 描述
out_trade_no string   业务方号码(外部交易号),最长128
请求示例
POST /invoice/getInvoiceUrl HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

access_token=0701c0bc1ee62987678d3d1f3f4e5ce3&auth_code=3EE31DAF2B4934AACEE8DE5167D980CE&
timestamp=1505901939&version=1.0.0&sign=5fa02548600eb2607a40fef728ff29ba24ec67d2
					
返回参数说明
参数名称 描述
code 返回码。详见错误代码
msg 如果错误,返回错误信息。
data 如果没有错误,返回业务数据,此处返回发票下载地址,如果code=0,data为null,则说明发票还未生成,请稍后尝试。
注意返回的发票地址有效时间为1个小时,Expires为过期时间的时间戳,过期后可再次调用获取新的下载地址
正确返回示例
{
	"code": 0,
	"data": "http://gatbizfile.oss-cn-hangzhou.aliyuncs.com/einvoice/dev/1404/233738.zip?Expires=1571123456&OSSAccessKeyId=O7ZVL2kkrcQAQ6Xa&Signature=6slObgat%2FwtIRdtnZ%2FBllKathO0%3D",
	"msg": "OK"
}
					
错误返回示例
{"code":1000210002,"data":null,"msg":"sign check failed!"}