文档中心 > API类目 > 鸟潮物流API

alibaba.niaochao.logistics.trade.token.create (创建新可用令牌)

创建新可用令牌,该令牌创建需要提供物流服务的基本信息,并在令牌开始作业后关联在对应的物流订单上;

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
token_request CreateTcTokenRequest 必须 请求入参
  • contact_info
  • ContactInfo
  • 必须
  • 联系人信息
  • └ address
  • String
  • 必须
  • 浙江省杭州市余杭区五常街道xxx小区x栋x单元
  • 地址
  • └ lng_lat
  • String
  • 必须
  • 125.340298,43.873485
  • 经纬度
  • └ name
  • String
  • 必须
  • 张三
  • 姓名
  • └ phone
  • String
  • 必须
  • 18822223333
  • 手机
  • └ is_test
  • String
  • 必须
  • 1
  • 测试标
  • └ product_id
  • String
  • 必须
  • 001
  • 鸟潮服务产品ID
  • └ source_order_id
  • String
  • 必须
  • 02105161912140137
  • 商家订单ID
  • └ user_expect_time
  • String
  • 可选
  • 2021-01-11 09:00:00~2021-01-11 13:00:00
  • 用户期望送达时间。开始结束时间以逗号分隔,时间格式:yyyy-MM-dd HH:mm:ss
  • └ warehouse_code
  • String
  • 必须
  • code001
  • 仓code
  • └ work_condition
  • String
  • 可选
  • {"storageMode":"常温"}
  • 作业要求。json串存储
  • └ remark
  • String
  • 可选
  • 备注111
  • 备注
  • └ attribute
  • String
  • 可选
  • {"key":"value"}
  • 扩展属性

响应参数

名称 类型 示例值 描述
result CreateTcTokenResponse result 常见结果
  • └ code
  • String
  • SYSTEM_ERROR
  • 错误编码
  • data
  • CreateTcTokenResponse
  • data
  • 结果
  • └ aoi_name
  • String
  • 阿里巴巴西溪园区
  • aoi名称
  • └ delivery_merge_flag
  • String
  • 001
  • 末端合流标,用户同个订单拆分为多个包裹,配送端使用该标记进行合流
  • └ delivery_wave
  • String
  • 送达波次
  • └ logistics_order_id
  • String
  • 189339085721050643
  • 物流订单ID
  • └ route_area_code
  • String
  • 4431
  • 区块ID
  • └ route_name
  • String
  • CFC1-站点1
  • 路由名称
  • └ tc_warehosue_name
  • String
  • 大润发杭州大关店
  • 鸟潮仓名称
  • └ token_code
  • String
  • 201949070980029162
  • 同城令牌
  • └ user_expect_time
  • String
  • 2021-04-19 21:35:35~2021-04-19 22:40:34
  • 用户选择送达时间,用"~"间隔
  • └ message
  • String
  • 系统异常
  • 错误信息
  • └ success
  • Boolean
  • true
  • 请求是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaNiaochaoLogisticsTradeTokenCreateRequest req = new AlibabaNiaochaoLogisticsTradeTokenCreateRequest();
AlibabaNiaochaoLogisticsTradeTokenCreateRequest.CreateTcTokenRequest obj1 = new AlibabaNiaochaoLogisticsTradeTokenCreateRequest.CreateTcTokenRequest();
AlibabaNiaochaoLogisticsTradeTokenCreateRequest.ContactInfo obj2 = new AlibabaNiaochaoLogisticsTradeTokenCreateRequest.ContactInfo();
obj2.setAddress("浙江省杭州市余杭区五常街道xxx小区x栋x单元");
obj2.setLngLat("125.340298,43.873485");
obj2.setName("张三");
obj2.setPhone("18822223333");
obj1.setContactInfo(obj2);
obj1.setIsTest("1");
obj1.setProductId("001");
obj1.setSourceOrderId("02105161912140137");
obj1.setUserExpectTime("2021-01-11 09:00:00~2021-01-11 13:00:00");
obj1.setWarehouseCode("code001");
obj1.setWorkCondition("{\"storageMode\":\"常温\"}");
obj1.setRemark("备注111");
obj1.setAttribute("{\"key\":\"value\"}");
req.setTokenRequest(obj1);
AlibabaNiaochaoLogisticsTradeTokenCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_niaochao_logistics_trade_token_create_response>
    <result>
        <code>SYSTEM_ERROR</code>
        <data>
            <aoi_name>阿里巴巴西溪园区</aoi_name>
            <delivery_merge_flag>001</delivery_merge_flag>
            <delivery_wave>晚</delivery_wave>
            <logistics_order_id>189339085721050643</logistics_order_id>
            <route_area_code>4431</route_area_code>
            <route_name>CFC1-站点1</route_name>
            <tc_warehosue_name>大润发杭州大关店</tc_warehosue_name>
            <token_code>201949070980029162</token_code>
            <user_expect_time>2021-04-19 21:35:35~2021-04-19 22:40:34</user_expect_time>
        </data>
        <message>系统异常</message>
        <success>true</success>
    </result>
</alibaba_niaochao_logistics_trade_token_create_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

返回
顶部