文档中心 > API类目 > 天猫供应链

taobao.logistics.express.address.blacklist.tms.async (aoi地址能力同步/更新接口)

○ 快递->淘天,异步接口 ○ 服务商通过调用此接口通知淘天物流新增/更新aoi地址能力情况。每一次调用是按照一个围栏下所有的经度、纬度的全量同步更新。 ○ 接口类型:TOP ○ 调用方式:CP--->淘天

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
address_blacklist_request AddressBlacklistRequest 必须 上门取退可揽范围黑名
  • └ request_id
  • String
  • 必须
  • 1656674541000_001
  • 业务请求ID,用于做幂等
  • └ request_time
  • Number
  • 必须
  • 1656674541000
  • 时间戳(毫秒)
  • └ supplier_id
  • String
  • 必须
  • 10000000001
  • 服务商ID
  • └ delivery_code
  • String
  • 必须
  • STO-001
  • 配资源编码
  • └ site_code
  • String
  • 可选
  • site-001
  • 网点编码(仅一个)
  • └ site_name
  • String
  • 可选
  • 网点名
  • 网点名称(仅一个)
  • └ service_type
  • String
  • 必须
  • 1
  • 服务类型:1-上门取退
  • └ ability_type
  • String
  • 必须
  • 1
  • 能力:1-上门取退
  • └ service_scope_type
  • String
  • 必须
  • 2
  • 服务范围地址类型:1-行政地址;2-电子围栏
  • └ address_type
  • String
  • 可选
  • 1
  • 如果传入为行政地址,行政地址传入类型 1- 菜鸟地址库ID 传入 2- 中文地址传入
  • └ address_ids
  • String []
  • 可选
  • 行政地址id(菜鸟地址库id)
  • address_names
  • AddressNames []
  • 可选
  • 中文地址信息
  • └ province
  • String
  • 可选
  • 浙江省
  • 浙江省
  • └ city
  • String
  • 可选
  • 杭州市
  • └ area
  • String
  • 可选
  • 余杭区
  • └ town
  • String
  • 可选
  • 五常街道
  • 街道
  • └ region_code
  • String
  • 可选
  • region_code-003
  • 电子围栏外部ID(服务商配资源下必须全局唯一)
  • └ region_address_id
  • String
  • 可选
  • 330110005,330110004
  • 电子围栏内包含的三级地址id(菜鸟地址库ID),电子围栏内包含多个三级地址时,需传多个,以英文逗号分隔
  • region_ids
  • RegionIds []
  • 可选
  • 电子围栏(经纬度),电子围栏最多5000个点(数组)
  • └ longitude
  • String
  • 可选
  • 120.21201
  • 经度(高德)
  • └ latitude
  • String
  • 可选
  • 120.21201
  • 纬度(高德)
  • extend_message
  • ExtendMessage
  • 可选
  • 扩展信息
  • └ reason
  • String
  • 可选
  • COLLECTION_POINT
  • 地址黑名单原因枚举,仅允许传一种: NEED_SWIPE_CARD 有门禁(刷卡、刷脸、梯控等) SECURITY_REFUSE 保安/门卫不允许进入 UNIT 特殊地址-部队 FACTORY 特殊地址-厂区 URBAN_VILLAGE 特殊地址-城中村 VILLAGE 特殊地址-村镇/村庄 TRANSIT_ WAREHOUSE 特殊地址-转运仓 COLLECTION_POINT 特殊地址-代收点 SCHOOL 特殊地址-学校 OTHER 其他原因
  • └ detail_reason
  • String
  • 可选
  • 都是放到门卫处
  • 详细原因 条件必填,reason=OTHER时,需要填写eg:都是放到门卫处
  • └ ability_status
  • String
  • 可选
  • 1
  • 能力状态 1-无能力 2-有能力 未填写时默认1-无能力。当服务类型传3时,支持指定。
  • station_message
  • StationMessage
  • 可选
  • 站点信息
  • └ station_code
  • String
  • 可选
  • 12345
  • 站点编码
  • └ cp_list
  • String
  • 可选
  • SF,STO
  • 站点合作cplist,多个以逗号隔开

响应参数

名称 类型 示例值 描述
address_blacklist_response AddressBlacklistResponse 返回值
  • └ success
  • Boolean
  • true
  • 系统成功失败 true|false
  • └ code
  • String
  • 200
  • 响应码
  • └ message
  • String
  • SUCCESS
  • 响应信息
  • └ is_retry
  • Boolean
  • false
  • 是否可重试

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LogisticsExpressAddressBlacklistTmsAsyncRequest req = new LogisticsExpressAddressBlacklistTmsAsyncRequest();
LogisticsExpressAddressBlacklistTmsAsyncRequest.AddressBlacklistRequest obj1 = new LogisticsExpressAddressBlacklistTmsAsyncRequest.AddressBlacklistRequest();
obj1.setRequestId("1656674541000_001");
obj1.setRequestTime(1656674541000L);
obj1.setSupplierId("10000000001");
obj1.setDeliveryCode("STO-001");
obj1.setSiteCode("site-001");
obj1.setSiteName("网点名");
obj1.setServiceType("1");
obj1.setAbilityType("1");
obj1.setServiceScopeType("2");
obj1.setAddressType("1");
obj1.setAddressIds("");
List<LogisticsExpressAddressBlacklistTmsAsyncRequest.AddressNames> list3 = new ArrayList<LogisticsExpressAddressBlacklistTmsAsyncRequest.AddressNames>();
LogisticsExpressAddressBlacklistTmsAsyncRequest.AddressNames obj4 = new LogisticsExpressAddressBlacklistTmsAsyncRequest.AddressNames();
list3.add(obj4);
obj4.setProvince("浙江省");
obj4.setCity("杭州市");
obj4.setArea("余杭区");
obj4.setTown("五常街道");
obj1.setAddressNames(list3);
obj1.setRegionCode("region_code-003");
obj1.setRegionAddressId("330110005,330110004");
List<LogisticsExpressAddressBlacklistTmsAsyncRequest.RegionIds> list6 = new ArrayList<LogisticsExpressAddressBlacklistTmsAsyncRequest.RegionIds>();
LogisticsExpressAddressBlacklistTmsAsyncRequest.RegionIds obj7 = new LogisticsExpressAddressBlacklistTmsAsyncRequest.RegionIds();
list6.add(obj7);
obj7.setLongitude("120.21201");
obj7.setLatitude("120.21201");
obj1.setRegionIds(list6);
LogisticsExpressAddressBlacklistTmsAsyncRequest.ExtendMessage obj8 = new LogisticsExpressAddressBlacklistTmsAsyncRequest.ExtendMessage();
obj8.setReason("COLLECTION_POINT");
obj8.setDetailReason("都是放到门卫处");
obj1.setExtendMessage(obj8);
obj1.setAbilityStatus("1");
LogisticsExpressAddressBlacklistTmsAsyncRequest.StationMessage obj9 = new LogisticsExpressAddressBlacklistTmsAsyncRequest.StationMessage();
obj9.setStationCode("12345");
obj9.setCpList("SF,STO");
obj1.setStationMessage(obj9);
req.setAddressBlacklistRequest(obj1);
LogisticsExpressAddressBlacklistTmsAsyncResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<logistics_express_address_blacklist_tms_async_response>
    <address_blacklist_response>
        <success>true</success>
        <code>200</code>
        <message>SUCCESS</message>
        <is_retry>false</is_retry>
    </address_blacklist_response>
</logistics_express_address_blacklist_tms_async_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部