調(diào)用【獲取發(fā)票下載信息】接口后,調(diào)用該接口下載發(fā)票文件。該接口不支持簽名和驗(yàn)簽
# 接口說明
適用對象: 普通服務(wù)商
請求URL: 通過【獲取發(fā)票下載信息】口獲取到“download_url”,URL有效期為30s,僅能下載ISSUED狀態(tài)的發(fā)票。
請求方式: GET
前置條件: 通過【獲取發(fā)票下載信息】口獲取到“download_url”
# 字段說明
# 請求參數(shù)
- token 必填 string(512)【獲取發(fā)票下載信息】download_url中的token字段,保留即可。不要刪除,也不用額外再添加一遍
- mchid 必填 string(32)商戶號
- sub_mchid 必填 string(32)子商戶號,服務(wù)商模式必須填寫
- openid 必填 string(32)通過查詢接口獲取的card_openid
- invoice_code 必填 string(12)發(fā)票代碼
- invoice_no 必填 string(8)發(fā)票號碼
- fapiao_id 必填 string(32)唯一標(biāo)識一張發(fā)票
Query 查詢參數(shù)
# 返回參數(shù)
無返回參數(shù)
當(dāng)獲取到賬單文件資源的下載地址信息后,如:
1{2 "fapiao_download_info_list": [3 {4 "download_url": "https://pay.wechatpay.cn/invoicing/fapiao/fapiao-file?token=xxxxxx",5 "fapiao_id": "fapiao-id-14",6 "status": "ISSUED"7 }8 ]9}
可以通過微信支付API v3標(biāo)準(zhǔn)對download_url進(jìn)行簽名,并發(fā)起請求,即可下載到賬單文件的數(shù)據(jù)流。
1https://pay.wechatpay.cn/invoicing/fapiao/fapiao-file?token=xxxxxx&mchid=1462377&OpenID=o3v4BuMFNejs-gAOfXgS&invoice_code=14403220&invoice_no=0923&fapiao_id=fapiao-id-14
正常情況下,會返回發(fā)票文件二進(jìn)制流,其中回包頭部有SM3-Digest字段用于校驗(yàn)文件完整性,如:
1SM3-Digest: 4395A01AA9BEDF3989E804581AD5F118EC4A23932F92F984108EBF08A89416E02Content-Type: application/octet-stream3Content-Disposition: attachment; filename="fapiao-id-12.pdf"4Request-ID: 08E491ED930610E20318AD80C4E00A200028F61E-056%PDF-1.57%8%<e2><e3><cf><d3>91 0 obj<</Nums[ 0 2 0 R]>>10endobj112 0 obj<</S/D>>12endobj133 0 obj<</Type/Pages/Count 1/Kids[ 8 0 R]>>14endobj15...
如果遇到異常,則會返回json格式的錯(cuò)誤信息,如:
1Content-Type: application/json; charset=utf-82Cache-Control: no-cache, must-revalidate3X-Content-Type-Options: nosniff4Request-ID: 08CCA5E89306102F18AD80C4E00A200028F81E-26847874756{"code":"INVALID_REQUEST","message":"鏈接已失效,請重新獲取"}
# 錯(cuò)誤碼
# 公共錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請根據(jù)錯(cuò)誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗(yàn)證不通過 | 請參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請稍后重試 | 請稍后重試 |
# 業(yè)務(wù)錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | INVALID_REQUEST | 參數(shù)錯(cuò)誤 | 請求參數(shù)與token不匹配 |
400 | INVALID_REQUEST | 參數(shù)錯(cuò)誤 | URL已過期 |
400 | INVALID_REQUEST | 參數(shù)錯(cuò)誤 | token無法解析 |