42. 拉取清关报关号（跨境业务专用）

仅跨境订单可用该接口. 流程文档见：跨境业务接入技术文档

1. 接口

/mtop/aftersale/openapi/crossborder/orders/tradeno/get

2. 接口参数

公共参数

请求参数

字段	类型	是否必填	备注
outPackageIds	String	条件必填	三方订单号列表
oids	String	条件必填	订单号列表（如果入参有oids，则忽略outPackageIds）

oids和outPackageIds两者至少传一个,如果都传则以oids为准。

3. 请求示例

data内容.

data:{
    "oids": "4191234567890123,4191234567890121", // 有品订单号列表（如果入参有oids，则忽略outPackageIds）, 条件必填, string订单号用逗号分割
    "outPackageIds": "123456789,12222" // 第三方包裹号, 条件必填, String，包裹号用逗号分割
}

4. 返回结果

Result 信息:

字段	类型	备注
code	Integer	响应码，0代表成功，其他代表失败
message	String	成功时返回ok,失败会返回相应信息
data	PullDeptTradeNoResp	响应数据

PullDeptTradeNoResp 信息:

字段	类型	备注
deliveryInfoList	`List<ImportationDelivery>`	订单详情列表

ImportationDelivery 信息: 见返回示例

5. 返回示例

返回成功:

{
    "code": 0, // 响应码，0代表成功，其他代表失败
    "data": {
        "deliveryInfoList": [{
            "deliveryId": 419123456789012301, //  进口物流单号(有品平台拆分后的订单号), long
            "oid": 4191234567890123, // 有品订单号, long
            "status": 0, // 包裹状态 0待报关 1已报关 2开始清关 3清关成功 4清关失败, 5清关失败已建单, 6 彻底报关失败（两天报关11次，结果都是失败）, int
            "totalFee": 1500, // 包裹单商品总价(分), int
            "transportFee": 1000, // 包裹单物流费(分), int 
            "customsName": "SHANGHAI", // 报关的海关编号, String
            "outPackageId": "123456789", // 第三方包裹号, String
            "itemList": [   // 商品列表
                {
                    "pid": 1011,    // 有品商品id, int
                    "skuId": 3010032,   // 商品skuid, int
                    "count": 1  //购买数量, int
                }
            ],
            "deptTradeNo": "BGV125SAD4421SG32", // 交易唯一编号(核验机构交易流水号), String
            "expressName": "京东快递", // 物流公司名称, String
            "expressSn": "VA0122133131", // 物流单号, String
            "bizcode": "JD", // 快递公司编码, String
            "payDeclareNo": "41225551255", // 报关交易流水号, String 
            "customsPayDesc": "",  // 报关错误描述, String
            "certCheckResult": -1  // 订购人和支付人身份信息校验结果 -1 校验失败 1 订购人支付人信一致 2 订购人支付人信不一致  3 商户未上传订购人身份信息, int
        },
    "message": "ok", // 成功时返回ok,失败会返回相应信息
    ]
}

返回失败:

{
    "code": 301451, // 响应码，0代表成功，其他代表失败
    "message": "该订单不存在", // 成功时返回ok,失败会返回相应信息
    "result": {}
}

补充说明

customsPayDesc字段是报支付的结果描述。当报支付单成功时，customsPayDesc为OK；当报支付单失败时，customsPayDesc会有具体的错误说明。

常见错误及应对方法

错误信息	原因	应对方法
支付人信息异常或用户未实名认证	用户在支付平台注册信息有误导致的报关失败	这种错误有品平台无法处理，商家只能联系用户检查修正在支付平台填写的用户信息，若未及时修正（24小时）则会彻底报关失败，之后会自动退款
订购人和支付人身份不一致	支付身份和有品用户身份不一致导致的清关失败	商家要来用户真实身份信息去清关
商户未在当前申报的海关进行备案	有品平台未在该海关备案	联系有品运营找有品财务同事在该海关添加下微信和支付宝

若报关成功却仍拉取不到支付单信息时，请联系有品技术重推支付单

outPackageId是商家同步过来的，用于唯一标识某包裹

deliveryId是有品平台生成的，用于唯一标识某包裹

有品是用deliveryId去报支付单的，商家需要拿deliveryId和payDeclareNo（报支付单的流水号）去拉取支付单信息

42-拉取支付报关号(跨境业务)