應(yīng)用場(chǎng)景
下載當(dāng)天之前的按天成功和失敗數(shù)據(jù)，可用于核對(duì)；處理中狀態(tài)的數(shù)據(jù)不返回
接口鏈接
URL地址：https://api.mch.weixin.qq.com/cgi-bin/mch/customs/cgi-bin/billdownload
是否需要證書
否
請(qǐng)求參數(shù)
請(qǐng)求方式：post 數(shù)據(jù)格式：xml 簽名方式：MD5
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 說明 |
|---|---|---|---|---|---|
| 簽名類型 | sign_type | 否 | String(32) | MD5 | 暫只支持MD5 |
| 簽名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 簽名，詳見簽名生成算法 |
| 公眾賬號(hào)ID | appid | 是 | String(32) | wxd678efh567hg6787 | 微信分配的公眾賬號(hào)ID |
| 商戶號(hào) | mch_id | 是 | String(32) | 1230000109 | 微信支付分配的商戶號(hào) |
| 日期 | date | 是 | String（8） | 20110320 | 格式為yyyymmdd，如果20110320 |
應(yīng)答參數(shù)列表
數(shù)據(jù)按CSV的格式實(shí)時(shí)返回，標(biāo)準(zhǔn)的CSV格式
系統(tǒng)標(biāo)識(shí)（第一行）字段說明：
| 字段順序 | 字段名 | 必填 | 類型 | 說明 |
|---|---|---|---|---|
| 1 | 返回碼 | 是 | String(12) | 返回代碼，SUCCESS成功，F(xiàn)AIL失敗 |
| 2 | 返回信息 | 否 | String(255) | 返回信息，成功為SUCCESS，失敗為具體的失敗原因 |
| 3 | 簽名方式 | 否 | String(8) | 簽名類型，取值：MD5 |
| 4 | 接口版本 | 否 | String(8) | 版本號(hào)，1.0 |
| 5 | 字符集 | 否 | String(8) | 字符編碼,取值：UTF-8。 |
| 6 | 密鑰序號(hào) | 否 | int | 多密鑰支持的密鑰序號(hào)，默認(rèn)1 |
| 7 | 簽名 | 否 | String(32) |
簽名，失敗時(shí)不簽名。簽名計(jì)算方式如下： 1.把csv文件除去第一行的內(nèi)容,剩余的文件做MD5處理并轉(zhuǎn)換為大寫得到A 2.sign=MD5（A&key=xxxxx） |
| 8 | 總筆數(shù) | 否 | int | 總筆數(shù) |
| 9 | 成功筆數(shù) | 否 | int | 成功筆數(shù) |
| 10 | 失敗筆數(shù) | 否 | int | 失敗筆數(shù) |
正文字段說明：
第二行為字段名
第三行起為具體數(shù)據(jù)
| 字段順序 | 字段名 | 必填 | 類型 | 說明 |
|---|---|---|---|---|
| 1 | 商戶訂單號(hào) | 是 | String(32) | 商戶系統(tǒng)內(nèi)部的訂單號(hào) |
| 2 | 微信訂單號(hào) | 是 | String(28) | 微信訂單號(hào) |
| 3 | 商戶子訂單號(hào) | 否 | String(32) | 商戶子訂單號(hào) |
| 4 | 微信子訂單號(hào) | 否 | String(30) | 微信子訂單號(hào) |
| 5 | 商戶海關(guān)備案號(hào) | 否 | String(32) | 商戶在海關(guān)登記的備案號(hào) |
| 6 | 海關(guān) | 是 | String(32) |
NO 無需上報(bào)海關(guān) GUANGZHOU 廣州 HANGZHOU 杭州 NINGBO 寧波 ZHENGZHOU_BS 鄭州（保稅物流中心） CHONGQING 重慶 XIAN 西安 SHANGHAI 上海 ZHENGZHOU_ZH 鄭州（綜保區(qū)） |
| 7 | 證件類型 | 否 | String(32) | 暫只支持身份證：IDCARD |
| 8 | 證件號(hào)碼 | 否 | String(64) | 證件號(hào)碼 |
| 9 | 姓名 | 否 | String(64) | 姓名 |
| 10 | 幣種 | 否 | String(32) | 幣種 |
| 11 | 應(yīng)付金額 | 否 | int | 子單金額，以分為單位 |
| 12 | 關(guān)稅 | 否 | int | 關(guān)稅 |
| 13 | 物流費(fèi) | 否 | int | 物流費(fèi)用 |
| 14 | 商品費(fèi)用 | 否 | int | 商品費(fèi)用 |
| 15 | 狀態(tài)碼 | 是 | String(32) | 狀態(tài)碼 SUCCESS 海關(guān)受理成功 FAIL 海關(guān)受理失敗 |
| 16 | 最后更新時(shí)間 | 是 | String(14) | 最后更新時(shí)間，格式為yyyyMMddhhmmss，如2009年12月27日9點(diǎn)10分10秒表示為20091227091010。時(shí)區(qū)為GMT+8 beijing。該時(shí)間取自微信服務(wù)器 |
舉例：
第一行：
SUCCESS
第二行：
商戶訂單號(hào)，微信訂單號(hào)，商戶子訂單號(hào)，微信子訂單號(hào)，商戶海關(guān)備案號(hào)，海關(guān)，證件類型，證件號(hào)碼，姓名，幣種，應(yīng)付金額，關(guān)稅，物流費(fèi)，商品費(fèi)用，狀態(tài)碼，最后更新時(shí)間
第三行：
100675420，1004520048201510101149118378，0506，1004520048201510101149117898，gz678987，guangzhou，idcard，330821199909087890，david，USD，9.99，0.99，0.01，8.99，success，20151228091010