API字典 / 海關報關 / 報關查詢API

報關查詢API

最新更新時間：2022.08.04 版本說明

商戶通過訂單號查詢提交的訂單附加信息及訂單報關狀態(tài)。

注意：

對于加密字段，請參照以下加密算法：

? 獲取微信支付平臺證書和對應的平臺證書序列號，本接口請求 http 頭的“Wechatpay-Serial”需要傳平臺證書序列號。

? 使用微信支付平臺證書的公鑰，對于需要加密的參數(shù)值進行 RSA 加密。填充方案使用 `RSAES-PKCS1-v1_5`。

? 加密后的密文，使用 base64 編碼后，作為請求中相應參數(shù)的值。

1. 接口說明

適用對象: 直連模式機構模式

請求URL: https://apihk.mch.weixin.qq.com/v3/global/customs/orders

請求方式: GET

Path指該參數(shù)為路徑參數(shù)

Query指該參數(shù)為URL參數(shù)

Body指該參數(shù)需在請求JSON傳參

2. 請求參數(shù)

參數(shù)名	變量	類型[長度限制]	必填	描述
機構APPID	appid	string[1,32]	是	Query 微信分配的公眾賬號ID 示例值：wxd678efh567hg6787
商戶號	mchid	string[1,32]	是	Query 微信支付分配的商戶號示例值：1230000109
訂單類型	order_type	string[1,16]	是	Query 4種訂單號類型，選擇一種 out_trade_no???商戶訂單號 transaction_id??微信支付訂單號 sub_order_no??商戶子訂單號 sub_order_id??微信子訂單號示例值：out_trade_no
訂單號	order_no	string[1,32]	是	Query 根據(jù)訂單號類型，傳入不同的訂單號碼示例值：20150806125346
海關	customs	string[1,32]	是	Query 海關代碼，枚舉值參見海關列表示例值：SHANGHAI_ZS
偏移量	offset	int	否	Query 非0整數(shù)，該次請求資源的起始位置，從0開始計數(shù)。調用方選填，默認為0 示例值：1
請求最大記錄條數(shù)	limit	int	否	Query 非0非負的整數(shù)，該次請求可返回的最大資源條數(shù)。調用方選填，默認值建議為20 示例值：20

請求示例

URL


https://apihk.mch.weixin.qq.com/v3/global/customs/orders?appid=wxd678efh567hg6787&mchid=1230000109&order_type=transaction_id&order_no=20150806125346&customs=SHANGHAI_ZS&offset=1&limit=20

{
    "appid": "wx2421b1c4370ec43b",
    "m",
      "device_id" : "013467007045764",
      "operator_id": "P001",
      "store_info" : {
        "id": "SZTX001"
      }
    }
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

3. 返回參數(shù)

正常返回

參數(shù)名

變量

類型[長度限制]

必填

描述

機構APPID

appid

string[1,32]

是

微信分配的公眾賬號ID
示例值：wxd678efh567hg6787

商戶號

mchid

string[1,32]

是

微信支付分配的商戶號
示例值：1230000109

微信訂單號

transaction_id

string[1,32]

是

微信支付返回的訂單號
示例值：1000320306201511078440737890

核驗機構

verify_department

string[1,16]

是

核驗機構代碼
UNIONPAY：銀聯(lián)
NETSUNION：網(wǎng)聯(lián)
OTHERS：其他
示例值：UNIONPAY

核驗機構流水號

verify_department_trade_id

string[1,64]

是

交易流水號，來自驗核機構，如銀聯(lián)記錄的交易流水號，供商戶報備海關
示例值：2018112288340107038204310100000

偏移量

offset

int

是

返回請求時設置的偏移值
示例值：0

請求最大記錄條數(shù)

limit

int

是

返回請求時設置的最大記錄數(shù)
示例值：20

查詢結果總條數(shù)

total_count

int

是

查詢結果總條數(shù)
示例值：1

報關數(shù)據(jù)包

data

array

是

報關單結果數(shù)組，具體內容參見下方描述

參數(shù)名	變量	類型[長度限制]	必填	描述
商戶子單號	sub_order_no	string[1,32]	否	商戶子訂單號注意：僅適用于機構模式示例值：20150806125346
微信子單號	sub_order_id	string[1,32]	否	微信子訂單號注意：僅適用于機構模式示例值：20150806125346
商戶海關備案號	mch_customs_no	string[1,32]	否	商戶在海關登記的備案號示例值：1234567
海關代碼	customs	string[1,32]	是	海關代碼，詳情參考章節(jié)3.5.10 示例值：SHANGHAI_ZS
幣種	fee_type	string[1,3]	否	固定值CNY 示例值：CNY
子單金額	order_fee	int	否	子單金額，以分為單位示例值：888
關稅	duty	int	否	關稅，以分為單位，非必填項，不會提交給海關示例值：888
物流費用	transport_fee	int	否	物流費用，以分為單位示例值：888
商品費用	product_fee	int	否	商品費用，以分為單位示例值：888
報關狀態(tài)	state	string[1,32]	是	申報結果狀態(tài)碼 PROCESSING：申報中 UNDECLARED：未申報 SUBMITTED：已修改未申報 SUCCESS：申報成功 FAIL：申報失敗 EXCEPT：海關接口異常示例值：PROCESSING
報關結果說明	explanation	string[1,128]	否	申報結果說明，如果狀態(tài)是失敗或異常，顯示失敗原因示例值：支付單已存在并且為非退單狀態(tài)
最后更新時間	modify_time	string[1,32]	是	最后更新時間，該時間取自微信服務器示例值：2015-09-01T10:00:00+08:00

收起

異常返回

參數(shù)名

變量

類型[長度限制]

必填

描述

返回狀態(tài)碼

code

string[1, 32]

是

錯誤碼，枚舉值見錯誤碼列表
示例值：INVALID_REQUEST

返回信息

message

string[1, 256]

是

返回信息，如非空，為錯誤原因
示例值：參數(shù)格式校驗錯誤

詳細的錯誤描述

detail

object

否

當code為PARAM_ERROR時返回，詳細說明見下

參數(shù)名	變量	類型[長度限制]	必填	描述
指示錯誤參數(shù)的位置	field	string[1, 256]	是	當錯誤參數(shù)位于請求body的JSON時，填寫指向參數(shù)的JSON Pointer 當錯誤參數(shù)位于請求的url或者querystring時，填寫參數(shù)的變量名示例值：#/properties/payer
錯誤參數(shù)的值	value	string[1, 256]	是	錯誤參數(shù)的值示例值：1346177081915535577
具體錯誤原因	issue	string[1, 256]	是	具體錯誤原因示例值：與ALLOF schema不符
錯誤參數(shù)的位置	location	string[1, 256]	否	body：錯誤參數(shù)位于請求body的JSON中 url：錯誤參數(shù)位于請求url中 query：錯誤參數(shù)位于請求的querystring中示例值：body

收起

返回示例

正常示例異常示例

{
	"appid": "wxd678efh567hg6787",
	"mchid": "1230000109",
	"transaction_id": "1000320306201511078440737890",
	"verify_department": "UNIONPAY",
	"verify_department_trade_id": "2018112288340107038204310100000",
	"offset": 0,
	"limit": 20,
	"total_count": 1,
	"data": [{
		"sub_order_no": "20150806125346",
		"sub_order_id": "20150806125346",
		"mch_customs_no": "1234567",
		"customs": "SHANGHAI_ZS",
		"fee_type": "CNY",
		"order_fee": 888,
		"duty": 888,
		"transport_fee": 888,
		"product_fee": 888,
		"state": "PROCESSING",
		"explanation": "支付單已存在并且為非退單狀態(tài)",
		"modify_time": "2015-09-01T10:00:00+08:00"
	}]
}

{
	"code": "INVALID_REQUEST",
	"message": "Parameter format verification error",
	"detail": {
		"field": "#/properties/payer",
		"value": "1346177081915535577",
		"issue": "與ALLOF schema不符",
		"location": "body"
	}
}

4. 錯誤碼

錯誤碼	描述	解決方案
INVALID_REQUEST	該訂單沒有申報	該訂單沒有申報，請申報后再查詢
	查詢指定記錄不存在，請重新選擇條件查詢	查詢記錄不存在，請按要求重新查詢
	海關配置未設置	報關接口需要商戶已配置過海關信息才可以訪問。請參照上文中的海關備案指引，進行海關信息報備
NOAUTH	商戶未在當前申報的海關進行備案	商戶未在申報的海關中備案，請商戶完成備案后重試；
NOAUTH	未開通自助清關功能	請檢查當前商戶是否已開通自助清關功能，開通路徑：微信支付商戶平臺-產(chǎn)品中心-自助清關中申請開通。
PARAM_ERROR	參數(shù)錯誤	參數(shù)錯誤，可能參數(shù)有誤或參數(shù)遺漏，請檢查接口參數(shù)是否按要求提交
SYSTEMERROR	系統(tǒng)錯誤	請重新報關，或聯(lián)系微信支付小助手排查原因

頁面導航

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付產(chǎn)品

資金類產(chǎn)品

其他產(chǎn)品

報關查詢API

1. 接口說明

2. 請求參數(shù)

請求示例

3. 返回參數(shù)

正常返回

異常返回

返回示例

4. 錯誤碼