视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

上傳電子發(fā)票文件

更新時(shí)間：2024.08.14

調(diào)用【將電子發(fā)票插入微信用戶卡包】接口之前，需要先調(diào)用本接口上傳電子發(fā)票文件，獲取文件ID。上傳的發(fā)票文件會(huì)在三天后過期，因此上傳后請(qǐng)盡快調(diào)用【將電子發(fā)票插入微信用戶卡包】接口執(zhí)行插入微信用戶卡包的操作。

# 接口說明

支持商戶：
【普通商戶】
請(qǐng)求方式：
【POST】/v3/new-tax-control-fapiao/fapiao-applications/upload-fapiao-file
請(qǐng)求域名：
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點(diǎn)
【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點(diǎn) ，指引點(diǎn)擊查看

# 字段說明

# 請(qǐng)求參數(shù)

    Body 包體參數(shù)
  • file 必填 object
    電子發(fā)票文件二進(jìn)制數(shù)據(jù)流，只支持PDF和OFD格式，文件大小不能超過2M。需要在請(qǐng)求body中通過表單提交的方式上傳此二進(jìn)制內(nèi)容。
  • meta 必填 object
    電子發(fā)票文件元信息
    • 屬性

# 應(yīng)答字段

# 文件上傳步驟

1.創(chuàng)建一個(gè)POST的方法請(qǐng)求/upload URI:

例如： POST https://api.mch.weixin.qq.com/new-tax-control-fapiao/fapiao-applications/upload-fapiao-file (opens new window) HTTP/1.1

2.將文件的數(shù)據(jù)添加到請(qǐng)求主體:

2.1 文本文件file參數(shù)的獲取方式說明：

文本文件二進(jìn)制內(nèi)容，放在請(qǐng)求HTTP的body中。

2.2 電子發(fā)票文件元信息meta參數(shù)的獲取方式說明：
電子發(fā)票文件元信息，使用json表示，包含四個(gè)對(duì)象：sub_mchid、file_type、digest_algorithm、digest。

  • sub_mchid參數(shù)獲取方式說明： 微信支付分配的子商戶號(hào)，服務(wù)商模式下必傳

  • file_type參數(shù)獲取方式說明： 發(fā)票文件的類型為PDF - PDF文件類型，PDF文件類型

  • digest_algorithm參數(shù)獲取方式說明： 文件摘要算法，SM3 - 國(guó)密SM3算法，國(guó)密SM3摘要算法

  • digest參數(shù)獲取方式說明： 根據(jù)文件摘要算法對(duì)電子發(fā)票文件二進(jìn)制內(nèi)容計(jì)算出的文件摘要，結(jié)果為16進(jìn)制編碼

2.3 簽名計(jì)算說明：

簽名生成

參與簽名計(jì)算的請(qǐng)求主體為meta的json串：

1{ "file_type": "PDF","digest": "addca90a6a290b9642dbaccffdf01e8c22aa348940b2e96754169ba08c19e5db", "digest_algorithm": "SM3" }

# 請(qǐng)求示例

1{   
2 "file": {          
3 },   
4 "meta": {      
5   "digest": "addca90a6a290b9642dbaccffdf01e8c22aa348940b2e96754169ba08c19e5db",      
6   "digest_algorithm": "SM3",      
7   "file_type": "PDF"
8  }  
9}

# 應(yīng)答示例

1{
2  "fapiao_media_id": "ASNFZ4mrze/+3LqYdlQyEA=="
3}

待簽名串示例：

1POST
2/v3/new-tax-control-fapiao/fapiao-applications/upload-fapiao-file
31566987169           //時(shí)間戳
412ced2db6f0193dda91ba86224ea1cd8   //隨機(jī)數(shù)
5{ "file_type": "PDF","digest": "addca90a6a290b9642dbaccffdf01e8c22aa348940b2e96754169ba08c19e5db", "digest_algorithm": "SM3" }

添加HTTP頭：

1Content-Type：multipart/form-data.設(shè)置為要上載的對(duì)象的MIME媒體類型。
2Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900231671",
3nonce_str="PCHK6HSOEDTACETP6P3AL7DWPHTBKIAT",timestamp="1567067659",
4serial_no="1FB89742D19F2BD30B69948D16DECA0FCB4481EB",
5signature="PB6M7+3JL7TSCl5zqD1sdWVypOIEQsD4dgOU+vPiVM6GMRo2qYSWKf8u46i9ZJFhyZTBdZ7SFR+BjDZh6
689hFgN8LZL+QWTvq3cse/FEUFYyOLN7L/2IZX4GA4cWInuJ2MpOhZRMpm+emrcn42gTMKAPNQ7dBLO7ux6MoSuQp69
7PW+p1ogmkER68exTVUXYqA5P3vITlWNr++RDy2+ExvB7qVISOKW0vBkxUxN9e7hwUbDwGln170ZXomoO1KpQSbw3f1u
8WUCx/IlWJhJIun7rUMtVT+kfijNUqcILtSfE4hWKKVaZn9j5CX8M7aKbbDOFy3SvbSJ3WQgRnRbgog5w=="
9Content-Type: multipart/form-data;boundary=boundary

添加body：

1// 以下為body的內(nèi)容
2--boundary  // boundary為商戶自定義的一個(gè)字符串
3Content-Disposition: form-data; name="meta";
4Content-Type: application/json
5//此處必須有一個(gè)空行
6{ "file_type": "PDF","digest": "addca90a6a290b9642dbaccffdf01e8c22aa348940b2e96754169ba08c19e5db", "digest_algorithm": "SM3" }
7--boundary
8Content-Disposition: form-data; name="file"; 
9Content-Type: pdf/plain
10//此處必須有一個(gè)空行
11--boundary--

說明：請(qǐng)求包體每行結(jié)尾都需要包含\r\n（空行也需要）。

發(fā)送請(qǐng)求：

1POST /v3/new-tax-control-fapiao/fapiao-applications/upload-fapiao-file HTTP/1.1
2Host: api.mch.weixin.qq.com
3Authorization: WECHATPAY2-SHA256-RSA2048 
4mchid="1900231671",nonce_str="PCHK6HSOEDTACETP6P3AL7DWPHTBKIAT",
5timestamp="1567067659",
6serial_no="1FB89742D19F2BD30B69948D16DECA0FCB4481EB",
7signature="PB6M7+3JL7TSCl5zqD1sdWVypOIEQsD4dgOU+vPiVM6GMRo2qYSWKf8u46i9ZJFhyZTBdZ7
8SFR+BjDZh689hFgN8LZL+QWTvq3cse/FEUFYyOLN7L/2IZX4GA4cWInuJ2MpOhZRMpm+emrcn42gTMKAPN
9Q7dBLO7ux6MoSuQp69PW+p1ogmkER68exTVUXYqA5P3vITlWNr++RDy2+ExvB7qVISOKW0vBkxUxN9e
107hwUbDwGln170ZXomoO1KpQSbw3f1uWUCx/IlWJhJIun7rUMtVT+kfijNUqcILtSfE4hWKKVaZn9j5CX8M
117aKbbDOFy3SvbSJ3WQgRnRbgog5w=="
12Content-Type: multipart/form-data;boundary=boundary
13
14--boundary  
15Content-Disposition: form-data; name="meta";
16Content-Type: application/json
17
18{ "file_type": "PDF","digest": "addca90a6a290b9642dbaccffdf01e8c22aa348940b2e96754169ba08c19e5db", "digest_algorithm": "SM3" }
19--boundary
20Content-Disposition: form-data; name="file"; 
21Content-Type: pdf/plain
22
23--boundary--

# 錯(cuò)誤碼

# 公共錯(cuò)誤碼

狀態(tài)碼 錯(cuò)誤碼 描述 解決方案
400 PARAM_ERROR 參數(shù)錯(cuò)誤 請(qǐng)根據(jù)錯(cuò)誤提示正確傳入?yún)?shù)
400 INVALID_REQUEST HTTP 請(qǐng)求不符合微信支付 APIv3 接口規(guī)則 請(qǐng)參閱 接口規(guī)則
401 SIGN_ERROR 驗(yàn)證不通過 請(qǐng)參閱 簽名常見問題
500 SYSTEM_ERROR 系統(tǒng)異常，請(qǐng)稍后重試 請(qǐng)稍后重試

# 業(yè)務(wù)錯(cuò)誤碼

狀態(tài)碼 錯(cuò)誤碼 描述 解決方案
429 FREQUENCY_LIMITED 頻率超限 請(qǐng)降低請(qǐng)求接口頻率
400 PARAM_ERROR 電子發(fā)票文件超過尺寸限制 請(qǐng)上傳2M以內(nèi)的電子發(fā)票文件
400 INVALID_REQUEST 請(qǐng)求參數(shù)符合參數(shù)格式，但不符合業(yè)務(wù)規(guī)則 請(qǐng)使用正確的參數(shù)重新調(diào)用
400 INVALID_REQUEST 電子發(fā)票文件與元信息中的摘要不匹配 請(qǐng)使用匹配的電子發(fā)票文件和摘要
401 SIGN_ERROR 簽名錯(cuò)誤或簽名信息不完整 請(qǐng)檢查簽名參數(shù)和方法是否都符合簽名算法要求
403 NO_AUTH 商戶無權(quán)限 請(qǐng)檢查是否已經(jīng)開通電子發(fā)票產(chǎn)品相關(guān)功能權(quán)限，若是服務(wù)商模式，還需確認(rèn)子商戶是否接受了服務(wù)商的邀請(qǐng)