43. 更新报关状态(跨境业务专用)

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

1. 接口

/mtop/aftersale/openapi/crossborder/orders/status/update

2. 接口参数

公共参数

公共参数

请求参数

字段 类型 是否必填 备注
deliveryInfos List<BaseDeliveryInfo> 订单信息列表

BaseDeliveryInfo 信息:

字段 类型 是否必填 备注
outPackageId String 第三方系统单号
clearCustomsDesc String 如果status=4时该字段必传 清关错误描述
status Integer 2开始清关 3清关成功4清关失败
merchantId Long 商户ID

3. 请求示例

data内容.

data:{
    "deliveryInfos": [{
        "outPackageId": "123456789", // 第三方包裹号, 必填, String
        "clearCustomsDesc": "身份信息不符,清关失败", // 清关错误描述,如果status=4时该字段必传, String
        "status": 2, // 2开始清关 3清关成功4清关失败, 必填, int,
        "merchantId": 315 // 商户ID,必填,Long
    }]
}

4. 返回结果

Result 信息:

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

UpdateCustomsStatusResp 信息:

字段 类型 备注
successOutPackageOids List<String> 更新成功的out_package_oid
failedOutPackageOids List<String> 更新失败的out_package_oid
updateStatusCodeMap 更新状态描述<包裹单号, 描述>

5. 返回示例

返回成功:

{
    "code": 0, // 响应码,0代表成功,其他代表失败
    "message": "ok", // 成功时返回ok,失败会返回相应信息
    "result": {
        "successOutPackageOids": [], // 同步成功outPackageId, List<string>
        "failedOutPackageOids": ["123456789"], // 同步失败outPackageId, List<string>
        "updateStatusCodeMap":{"123456789":"REPEAT_UPDATE_CLEAR_FAILED_RESULT"}
    }
}
©xiaomiyoupin.com 苏B2-20180351 苏ICP备18025642号-1            该文件修订时间: 2023-04-26 01:54:18

results matching ""

    No results matching ""