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"}
}
}