注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 淘宝物流API

alibaba.ascp.logistics.instantsonline.calldelivery (同城配送在线下单正式下单呼叫运力)

同城配送在线下单正式下单呼叫运力

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
out_order_id String 必须 123456 ERP单号
biz_type String 必须 INSTANT_ONLINE 业务类型,INSTANT_ONLINE:同城配送-在线下单
tid Number 必须 3315117313009520746 淘宝订主单号
sender SenderTopDTO 必须 发货联系人
  • └ name
  • String
  • 必须
  • 测试发货人
  • 联系人姓名
  • └ phone
  • String
  • 必须
  • 15616161616
  • 联系人电话,支持手机、座机
  • └ address
  • String
  • 必须
  • 测试收地址
  • 地址门牌号
  • └ lat
  • String
  • 必须
  • 30.280072
  • 纬度(高德)
  • └ lng
  • String
  • 必须
  • 120.026851
  • 经度(高德)
receiver ReceiverTopDTO 可选 收货联系人
  • └ name
  • String
  • 必须
  • 测试收货人
  • 联系人姓名
  • └ phone
  • String
  • 必须
  • 15818181818
  • 联系人电话,支持手机、座机
  • └ address
  • String
  • 必须
  • 测试收货地址
  • 地址门牌号
  • └ lat
  • String
  • 必须
  • 30.275962
  • 纬度(高德)
  • └ lng
  • String
  • 必须
  • 120.027276
  • 经度(高德)
item_list ReceiverTopDTO [] 必须
  • 最大列表长度:20
  • 商品清单
    • └ item_name
    • String
    • 必须
    • 测试商品
    • 商品名称
    • └ item_value
    • Number
    • 必须
    • 100
    • 商品单价(原价)
    • └ item_quantity
    • Number
    • 必须
    • 1
    • 商品数量
    • └ item_id
    • Number
    • 必须
    • 705239667995
    • 商品ID
    total_item_value Number 可选 1000 商品总价(原价),单位分,默认:商品单价总和
    total_item_actual_value Number 必须 1000 商品实付总价(总价),单位分
    total_weight Number 必须 20 总重量,单位KG,不超过20KG
    default_trade_receiver Boolean 可选 true
  • 默认值:true
  • 是否默认使用订单收货人地址,默认:true可不填写收货联系人
    selected_resource SelectedResourceTopDTO 必须 选择的物流资源
    • └ resource_request_id
    • String
    • 必须
    • -
    • 下单凭证
    • └ resource_code
    • String
    • 必须
    • TMYP_fnlm_fengka
    • 资源CODE,用于发货
    • └ actual_fee
    • Number
    • 必须
    • 10000
    • 实付价格
    pickup_code String 可选 41234 指定取件码,不超过16位
    default_gen_pickup_code Boolean 可选 true
  • 默认值:false
  • 默认生成取件码
    gen_pickup_code_config GenPickupCodeConfigTopDTO 可选 生成取件码配置
    • └ group
    • String
    • 可选
    • A001
    • 取件码分组,分组下唯一

    响应参数

    名称 类型 示例值 描述
    result TopResult 返回值
    • └ success
    • Boolean
    • true
    • 执行结果
    • └ cw_order_id
    • String
    • CW001
    • 取号流水号
    • └ waybill_code
    • String
    • 123456
    • 物流单号
    • └ resource_code
    • String
    • TMYP_fnlm_fengka
    • 资源CODE
    • └ pickup_code
    • String
    • 取件码
    • 取件码
    • └ features
    • String
    • -
    • 扩展

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAscpLogisticsInstantsonlineCalldeliveryRequest req = new AlibabaAscpLogisticsInstantsonlineCalldeliveryRequest();
    req.setOutOrderId("123456");
    req.setBizType("INSTANT_ONLINE");
    req.setTid(3315117313009520746L);
    AlibabaAscpLogisticsInstantsonlineCalldeliveryRequest.SenderTopDTO obj1 = new AlibabaAscpLogisticsInstantsonlineCalldeliveryRequest.SenderTopDTO();
    obj1.setName("测试发货人");
    obj1.setPhone("15616161616");
    obj1.setAddress("测试收地址");
    obj1.setLat("30.280072");
    obj1.setLng("120.026851");
    req.setSender(obj1);
    AlibabaAscpLogisticsInstantsonlineCalldeliveryRequest.ReceiverTopDTO obj2 = new AlibabaAscpLogisticsInstantsonlineCalldeliveryRequest.ReceiverTopDTO();
    obj2.setName("测试收货人");
    obj2.setPhone("15818181818");
    obj2.setAddress("测试收货地址");
    obj2.setLat("30.275962");
    obj2.setLng("120.027276");
    req.setReceiver(obj2);
    List<AlibabaAscpLogisticsInstantsonlineCalldeliveryRequest.ReceiverTopDTO> list4 = new ArrayList<AlibabaAscpLogisticsInstantsonlineCalldeliveryRequest.ReceiverTopDTO>();
    AlibabaAscpLogisticsInstantsonlineCalldeliveryRequest.ReceiverTopDTO obj5 = new AlibabaAscpLogisticsInstantsonlineCalldeliveryRequest.ReceiverTopDTO();
    list4.add(obj5);
    obj5.setItemName("测试商品");
    obj5.setItemValue(100L);
    obj5.setItemQuantity(1L);
    obj5.setItemId(705239667995L);
    req.setItemList(list4);
    req.setTotalItemValue(1000L);
    req.setTotalItemActualValue(1000L);
    req.setTotalWeight(20L);
    req.setDefaultTradeReceiver(true);
    AlibabaAscpLogisticsInstantsonlineCalldeliveryRequest.SelectedResourceTopDTO obj6 = new AlibabaAscpLogisticsInstantsonlineCalldeliveryRequest.SelectedResourceTopDTO();
    obj6.setResourceRequestId("-");
    obj6.setResourceCode("TMYP_fnlm_fengka");
    obj6.setActualFee(10000L);
    req.setSelectedResource(obj6);
    req.setPickupCode("41234");
    req.setDefaultGenPickupCode(true);
    AlibabaAscpLogisticsInstantsonlineCalldeliveryRequest.GenPickupCodeConfigTopDTO obj7 = new AlibabaAscpLogisticsInstantsonlineCalldeliveryRequest.GenPickupCodeConfigTopDTO();
    obj7.setGroup("A001");
    req.setGenPickupCodeConfig(obj7);
    AlibabaAscpLogisticsInstantsonlineCalldeliveryResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_ascp_logistics_instantsonline_calldelivery_response>
        <result>
            <success>true</success>
            <cw_order_id>CW001</cw_order_id>
            <waybill_code>123456</waybill_code>
            <resource_code>TMYP_fnlm_fengka</resource_code>
            <pickup_code>取件码</pickup_code>
            <features>-</features>
        </result>
    </alibaba_ascp_logistics_instantsonline_calldelivery_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

    返回
    顶部