qimen.taobao.qianniu.cloudkefu.address.self.modify (自助修改地址接口)

在自动化任务核对地址卡片中,透出修改地址选择器,让用户自己选择要修改的地址,然后同步到商家后台ERP系统

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
sellerNick String 必须 苏宁易购官方旗舰店 店铺主账号
buyerNick String 必须 翔_ouyang 买家账号名
modifiedAddress ModifiedAddress 必须 要修改的地址信息
  • └ area
  • String
  • 必须
  • 余杭区
  • └ postCode
  • String
  • 可选
  • 311001
  • 邮编,非必须有可能为空
  • └ province
  • String
  • 必须
  • 浙江省
  • 省份、州等
  • └ phone
  • String
  • 可选
  • 15940970983
  • 收货人电话(可不填,无表示没有修改)
  • └ name
  • String
  • 可选
  • 易昊
  • 收货人姓名(可不填,无表示没有修改)
  • └ town
  • String
  • 必须
  • 五常街道
  • 乡、镇、街道信息
  • └ country
  • String
  • 可选
  • 中国
  • 默认值:中国
  • 可不填,不填的情况下默认中国
  • └ city
  • String
  • 必须
  • 杭州市
  • └ addressDetail
  • String
  • 可选
  • 文一西路969号 8号楼小邮局
  • 详细地址,不带town信息,非必须有可能为空
bizOrderId String 必须 30753531820144197 交易订单ID
originalAddress OriginalAddress 可选 订单原始收货地址信息
  • └ postCode
  • String
  • 可选
  • 311001
  • 邮编,非必须有可能为空
  • └ addressDetail
  • String
  • 可选
  • 文一西路969号 8号楼小邮局
  • 详细地址,不带town信息,非必须有可能为空
  • └ town
  • String
  • 可选
  • 五常街道
  • 乡、镇、街道信息
  • └ area
  • String
  • 可选
  • 余杭区
  • └ city
  • String
  • 可选
  • 杭州市
  • └ province
  • String
  • 可选
  • 浙江省
  • 省份、州等
  • └ country
  • String
  • 可选
  • 中国
  • 默认值:中国
  • 可不填,不填的情况下默认中国
  • └ phone
  • String
  • 可选
  • 17682312770
  • 原始收货人电话
  • └ name
  • String
  • 可选
  • 小明
  • 原始收货人姓名
oaid String 可选 123456 收件人ID,长度128之内
shopName String 可选 苏宁易购官方旗舰店 店铺名称

响应参数

名称 类型 示例值 描述
result ResultDO 修改地址返回结果
  • └ errorMsg
  • String
  • 不能修改.......
  • 错误详细描述信息
  • └ errorCode
  • String
  • modify-address-forbid
  • 错误码
  • └ success
  • Boolean
  • false
  • 地址是否更新成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
TaobaoQianniuCloudkefuAddressSelfModifyRequest req = new TaobaoQianniuCloudkefuAddressSelfModifyRequest();
req.setSellerNick("苏宁易购官方旗舰店");
req.setBuyerNick("翔_ouyang");
TaobaoQianniuCloudkefuAddressSelfModifyRequest.ModifiedAddress obj1 = new TaobaoQianniuCloudkefuAddressSelfModifyRequest.ModifiedAddress();
obj1.setArea("余杭区");
obj1.setPostCode("311001");
obj1.setProvince("浙江省");
obj1.setPhone("15940970983");
obj1.setName("易昊");
obj1.setTown("五常街道");
obj1.setCountry("中国");
obj1.setCity("杭州市");
obj1.setAddressDetail("文一西路969号 8号楼小邮局");
req.setModifiedAddress(obj1);
req.setBizOrderId("30753531820144197");
TaobaoQianniuCloudkefuAddressSelfModifyRequest.OriginalAddress obj2 = new TaobaoQianniuCloudkefuAddressSelfModifyRequest.OriginalAddress();
obj2.setPostCode("311001");
obj2.setAddressDetail("文一西路969号 8号楼小邮局");
obj2.setTown("五常街道");
obj2.setArea("余杭区");
obj2.setCity("杭州市");
obj2.setProvince("浙江省");
obj2.setCountry("中国");
obj2.setPhone("17682312770");
obj2.setName("小明");
req.setOriginalAddress(obj2);
req.setOaid("123456");
req.setShopName("苏宁易购官方旗舰店");
TaobaoQianniuCloudkefuAddressSelfModifyResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<result>
    <errorMsg>不能修改.......</errorMsg>
    <errorCode>modify-address-forbid</errorCode>
    <success>false</success>
</result>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
modify-address-forbid 业务上返回的修改地址失败错误码 这个是正常的返回

API工具

如何获得此API

FAQ

返回
顶部