16 用户地址修改确认(仅支有品配送)

场景

商家提供地址修改确认接口URL

当用户端发起地址修改请求时,有品系统会调用该商家系统接口询问是否可以修改。如果不能修改,则同步返回用户不能修改错误提示。

不能修改地址的常见场景有:

  1. 订单已经发货
  2. 修改后的地址不支持配送

解密

数据解密方式与加密相反,请参考 公共参数 加密部分

也可参考订单推送 解密部分

加密数据示例

{
    "data":"TkegDZlSkFtLQaxs0gkQnbMLVio0kBaL9TURvIyb4hRrMhAkeNU9183YGFecHaF7HVh4hrNXravNcwOTLBIci5aPxZQkYAFbK",
    "partnerId":"88",
    "sign":"60e481e612179eca3c495de21a7f0dd4",
    "timestamp":"1562134252"
}

请求

{
    "orderId": "4190000000000001", 
    "updateTime": "2018-06-10 15:30:07",
    "address": {
        "consignee":"先生",
        "country": {
            "id":"1",
            "name":"中国"
        },
        "province": {
            "id":"5",
            "name":"山西"
        },
        "city": {
            "id":"49",
            "name":"太原"
        },
        "district": {
            "id":"602",
            "name":"杏花岭区"
        },
        "area": {
            "id":"602008",
            "name":"三桥街道"
        },
        "address":"xxx小区x栋101",
        "tel":"18800000001"
    }
}

返回

允许修改地址:

{
  "code": 200, // 200 表示请求成功,非200请求失败 
  "response": 
    {
      "orderId": "4190000000000001", // 有品订单号, String, 必填 
      "status": "success", // 状态,String,必填
      "message": "" // 失败原因, String,选填
    }
}

不允许修改地址:

{
  "code": 200, 
  "response": 
    {
      "orderId": "4190000000000001", // 有品订单号, String, 必填 
      "status": "failure", // 状态,String,必填
      "message": "订单已经发货"  // 失败原因(失败原因不会原文返回给用户,只用做日志记录), String,选填
    }
}

联调测试和上线流程

发送邮件到 youpin-openapi@xiaomi.com(请使用公司邮箱发送)

联调测试
主题:申请有品openapi地址修改联调测试
环境:测试
商家公司名称:
商户ID:
计划联调时间:
推送地址:
版本: V2(只支持V2)
对接联系人:
电话:
邮箱:

上线
主题:申请有品openapi地址修改上线
环境:线上
商家公司名称:
商户ID:
计划上线时间:
推送地址:
版本: V2(只支持V2)

©xiaomiyoupin.com 苏B2-20180351 苏ICP备18025642号-1            该文件修订时间: 2023-04-26 01:54:18

results matching ""

    No results matching ""