报关重推

更新时间：2025.01.07

如果订单附加信息已请求报送海关，但电子口岸丢单，则可以使用报关重推接口重新向海关推送（订单附加信息的state必须为SUCCESS或者EXCEPT）。

注意：

重推时，需要带上支付时的商户订单号out_trade_no或微信支付订单号transaction_id。若有拆单，则需要带上商户子单号sub_order_no或微信子单号sub_order_id。

1. 接口说明

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

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

请求方式: POST

Path 指该参数为路径参数

Query 指该参数为URL参数

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

2. 请求参数

参数名	变量	类型[长度限制]	必填	描述
机构APPID	appid	string[1,32]	是	Body 微信分配的公众账号ID 示例值：wxd678efh567hg6787
商户号	mchid	string[1,32]	是	Body 微信支付分配的商户号示例值：1230000109
商户订单号	out_trade_no	string[1,32]	二选一	Body out_trade_no, transaction_id二选一传入示例值：20150806125346
微信订单号	transaction_id	string[1,32]	二选一	Body out_trade_no, transaction_id二选一传入示例值：1000320306201511078440737890
商户子单号	sub_order_no	string[1,32]	否	Body 没有拆单可不填，否则sub_order_no, sub_order_id二选一传入注意：仅适用于机构模式示例值：20150806125346
微信子单号	sub_order_id	string[1,32]	否	Body 没有拆单可不填，否则sub_order_no, sub_order_id二选一传入注意：仅适用于机构模式示例值：1000320306201511078440737891
海关编码	customs	string[1,32]	是	Body 海关编码，具体请参考海关列表示例值：SHANGHAI_ZS
商户海关备案号	merchant_customs_no	string[1,32]	是	Body 商户在海关登记的备案号示例值：123456

请求示例

JSON

1{
2  "appid": "wxd678efh567hg6787",
3  "mchid": "1230000109",
4  "out_trade_no": "20150806125346",
5  "transaction_id": "1000320306201511078440737890",
6  "sub_order_no": "20150806125346",
7  "sub_order_id": "1000320306201511078440737891",
8  "customs": "SHANGHAI_ZS",
9  "merchant_customs_no": "123456"
10}

3. 返回参数

正常返回

参数名	变量	类型[长度限制]	必填	描述
机构APPID	appid	string[1,32]	是	微信分配的公众账号ID 示例值：wxd678efh567hg6787
商户号	mchid	string[1,32]	是	微信支付分配的商户号示例值：1230000109
报关状态	state	string[1,32]	是	申报结果状态码 PROCESSING：申报中 UNDECLARED：未申报 SUBMITTED：已修改未申报 SUCCESS：申报成功 FAIL：申报失败 EXCEPT：海关接口异常示例值：PROCESSING
商户订单号	out_trade_no	string[1,32]	是	商户系统内部订单号，要求32个字符内，只能是数字、大小写字母_-\|*@ ，且在同一个商户号下唯一示例值：20150806125346
微信订单号	transaction_id	string[1,32]	是	微信支付返回的订单号示例值：1000320306201511078440737890
商户子订单号	sub_order_no	string[1,32]	否	商户子订单号，如有拆单则必传注意：仅适用于机构模式示例值：20150806125346
微信子订单号	sub_order_id	string[1,32]	否	微信子订单号注意：仅适用于机构模式示例值：20150806125346
最后更新时间	modify_time	string[1,32]	是	最后更新时间，该时间取自微信服务器示例值：2015-09-01T10:00:00+08:00
申报结果说明	explanation	string[1,128]	否	申报结果说明，如果状态是失败或异常，显示失败原因示例值：支付单已存在并且为非退单状态

异常返回

参数名

变量

类型[长度限制]

必填

描述

返回状态码

code

string[1, 32]

是

错误码，枚举值见错误码列表

示例值：INVALID_REQUEST

返回信息

message

string[1, 256]

是

返回信息，如非空，为错误原因

示例值：参数格式校验错误

详细的错误描述

detail

object

否

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

详细的错误描述

返回示例

正常示例

1{
2  "appid": "wxd678efh567hg6787",
3  "mchid": "1230000109",
4  "state": "PROCESSING",
5  "out_trade_no": "20150806125346",
6  "transaction_id": "1000320306201511078440737890",
7  "sub_order_no": "20150806125346",
8  "sub_order_id": "20150806125346",
9  "modify_time": "2015-09-01T10:00:00+08:00",
10  "explanation": "支付单已存在并且为非退单状态"
11}

异常示例

1{
2	"code": "INVALID_REQUEST",
3	"message": "Parameter format verification error",
4	"detail": {
5		"field": "#/properties/payer",
6		"value": "1346177081915535577",
7		"issue": "与ALLOF schema不符",
8		"location": "body"
9	}
10}

4. 错误码

错误码	描述	解决方案
INVALID_REQUEST	海关申报记录不存在	海关申报记录不存在，请重新申请或联系微信支付小助手排查原因
INVALID_REQUEST	海关配置未设置	报关接口需要商户已配置过海关信息才可以访问。请参照上文中的海关备案指引，进行海关信息报备
NOAUTH	商户未在当前申报的海关进行备案	商户未在申报的海关中备案，请商户完成备案后重试；
NOAUTH	未开通自助清关功能	请检查当前商户是否已开通自助清关功能，开通路径：微信支付商户平台-产品中心-自助清关中申请开通。
PARAM_ERROR	参数错误	参数错误，可能参数有误或参数遗漏，请检查接口参数是否按要求提交
SYSTEMERROR	系统错误	请重新报关，或联系微信支付小助手排查原因