API字典 / 海关报关 / 报关查询API

报关查询API

最新更新时间：2022.08.04 版本说明

商户通过订单号查询提交的订单附加信息及订单报关状态。

注意：

对于加密字段，请参照以下加密算法：

• 获取微信支付平台证书和对应的平台证书序列号，本接口请求 http 头的“Wechatpay-Serial”需要传平台证书序列号。

• 使用微信支付平台证书的公钥，对于需要加密的参数值进行 RSA 加密。填充方案使用 `RSAES-PKCS1-v1_5`。

• 加密后的密文，使用 base64 编码后，作为请求中相应参数的值。

1. 接口说明

适用对象: 直连模式机构模式

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

请求方式: GET

Path指该参数为路径参数

Query指该参数为URL参数

Body指该参数需在请求JSON传参

2. 请求参数

参数名	变量	类型[长度限制]	必填	描述
机构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 根据订单号类型，传入不同的订单号码示例值：20150806125346
海关	customs	string[1,32]	是	Query 海关代码，枚举值参见海关列表示例值：SHANGHAI_ZS
偏移量	offset	int	否	Query 非0整数，该次请求资源的起始位置，从0开始计数。调用方选填，默认为0 示例值：1
请求最大记录条数	limit	int	否	Query 非0非负的整数，该次请求可返回的最大资源条数。调用方选填，默认值建议为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. 返回参数

正常返回

参数名

变量

类型[长度限制]

必填

描述

机构APPID

appid

string[1,32]

是

微信分配的公众账号ID
示例值：wxd678efh567hg6787

商户号

mchid

string[1,32]

是

微信支付分配的商户号
示例值：1230000109

微信订单号

transaction_id

string[1,32]

是

微信支付返回的订单号
示例值：1000320306201511078440737890

核验机构

verify_department

string[1,16]

是

核验机构代码
UNIONPAY：银联
NETSUNION：网联
OTHERS：其他
示例值：UNIONPAY

核验机构流水号

verify_department_trade_id

string[1,64]

是

交易流水号，来自验核机构，如银联记录的交易流水号，供商户报备海关
示例值：2018112288340107038204310100000

偏移量

offset

int

是

返回请求时设置的偏移值
示例值：0

请求最大记录条数

limit

int

是

返回请求时设置的最大记录数
示例值：20

查询结果总条数

total_count

int

是

查询结果总条数
示例值：1

报关数据包

data

array

是

报关单结果数组，具体内容参见下方描述

参数名	变量	类型[长度限制]	必填	描述
商户子单号	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]	是	海关代码，详情参考章节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
报关状态	state	string[1,32]	是	申报结果状态码 PROCESSING：申报中 UNDECLARED：未申报 SUBMITTED：已修改未申报 SUCCESS：申报成功 FAIL：申报失败 EXCEPT：海关接口异常示例值：PROCESSING
报关结果说明	explanation	string[1,128]	否	申报结果说明，如果状态是失败或异常，显示失败原因示例值：支付单已存在并且为非退单状态
最后更新时间	modify_time	string[1,32]	是	最后更新时间，该时间取自微信服务器示例值：2015-09-01T10:00:00+08:00

收起

异常返回

参数名

变量

类型[长度限制]

必填

描述

返回状态码

code

string[1, 32]

是

错误码，枚举值见错误码列表
示例值：INVALID_REQUEST

返回信息

message

string[1, 256]

是

返回信息，如非空，为错误原因
示例值：参数格式校验错误

详细的错误描述

detail

object

否

当code为PARAM_ERROR时返回，详细说明见下

参数名	变量	类型[长度限制]	必填	描述
指示错误参数的位置	field	string[1, 256]	是	当错误参数位于请求body的JSON时，填写指向参数的JSON Pointer 当错误参数位于请求的url或者querystring时，填写参数的变量名示例值：#/properties/payer
错误参数的值	value	string[1, 256]	是	错误参数的值示例值：1346177081915535577
具体错误原因	issue	string[1, 256]	是	具体错误原因示例值：与ALLOF schema不符
错误参数的位置	location	string[1, 256]	否	body：错误参数位于请求body的JSON中 url：错误参数位于请求url中 query：错误参数位于请求的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": "支付单已存在并且为非退单状态",
		"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	未开通自助清关功能	请检查当前商户是否已开通自助清关功能，开通路径：微信支付商户平台-产品中心-自助清关中申请开通。
PARAM_ERROR	参数错误	参数错误，可能参数有误或参数遗漏，请检查接口参数是否按要求提交
SYSTEMERROR	系统错误	请重新报关，或联系微信支付小助手排查原因

页面导航

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付产品

资金类产品

其他产品

报关查询API

1. 接口说明

2. 请求参数

请求示例

3. 返回参数

正常返回

异常返回

返回示例

4. 错误码